PROTOCOL: Add bandwidth lists

See: #30217

PROTOCOL: Add bandwidth lists
19ae66a1 · Iain R. Learmonth · 7eeec86f · 19ae66a1
Commit 19ae66a1 authored May 1, 2019 by Iain R. Learmonth
--- a/src/main/resources/docs/PROTOCOL
+++ b/src/main/resources/docs/PROTOCOL
@@ -89,6 +89,7 @@

   'relay-descriptors' contains  the following substructure:

+   * bandwidths
   * consensuses
   * extra-infos
   * microdescs
@@ -111,7 +112,9 @@

   * for consensuses, microdescs, and votes from the valid-after dates,
   * for extra-infos, server-descriptors, statuses, and tor from the
-     published dates.
+     published dates,
+   * for bandwidths, from the file_created value if available, otherwise the
+     timestamp.

 3.0 Index Files

@@ -181,6 +184,7 @@

   'relay-descriptors' contains  the following substructure:

+   * bandwidths
   * consensuses
   * extra-infos
   * microdescs
@@ -236,6 +240,15 @@
   are derived from the valid-after dates of the referencing microdesc
   consensus.

+4.3.6
+   'bandwidths' contains documents named:
+
+   year DASH month DASH day DASH hour DASH minute DASH second
+   DASH BANDWIDTH DASH DIGEST
+
+   Where DIGEST is the uppercase-hex encoded SHA256 digest of the bandwidth
+   file and BANDWIDTH is the string "bandwidth".
+
 4.4 'webstats' below 'recent'

   'webstats' contains compressed log files named according to
@@ -331,6 +344,7 @@

   'relay-descriptors' contains  the following substructure:

+   * bandwidth
   * certs
   * consensus
   * extra-info
@@ -387,6 +401,16 @@

   and below the subdirectories of 'micro' and 'consensus-microdescs'.

+5.3.5
+   'bandwidth' contains the subdirectory structure
+
+   year SEP month SEP day
+
+   Where the time related values are taken from the file_created value where
+   available, otherwise the timestamp.
+
+   The files are named according to the structure in 4.3.6.
+
 5.4 'webstats' below 'out'

   'webstats' contains compressed log files structured and named according