commit 19ae66a1314f9b1b4fa5d8019908971169a06599 Author: Iain R. Learmonth irl@fsfe.org Date: Wed May 1 11:26:27 2019 +0100

PROTOCOL: Add bandwidth lists

See: #30217 --- src/main/resources/docs/PROTOCOL | 26 +++++++++++++++++++++++++- 1 file changed, 25 insertions(+), 1 deletion(-)

diff --git a/src/main/resources/docs/PROTOCOL b/src/main/resources/docs/PROTOCOL index 9f65e43..58ed4dc 100644 --- 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