[tor-commits] [torspec/master] Add bandwidth-file line to vote documents

[nickm at torproject.org]

commit 84591df1c20856d07411af7b487710e97d76a60e
Author: juga0 <juga at riseup.net>
Date:   Wed May 30 21:52:47 2018 +0000

    Add bandwidth-file line to vote documents
---
 dir-spec.txt | 25 +++++++++++++++++++++++++
 1 file changed, 25 insertions(+)

diff --git a/dir-spec.txt b/dir-spec.txt
index 5f2a713..2253ec6 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -2084,6 +2084,31 @@
         Value is the actual shared random value encoded in base64. NumReveals
         is the number of commits used to generate this SRV.
 
+    "bandwidth-file" SP KeyValues NL
+
+        [At most once]
+
+        Value ::= any printing ASCII character except NL and SP.
+        KeyValue ::= Keyword '=' Value
+        KeyValues ::= KeyValue | KeyValues SP KeyValue
+
+        The Bandwidth List headers KeyValue pairs of the Bandwidth List file
+        specified in bandwith-file-spec.txt, used to obtain the Bandwidth
+        RelayLines, also called bandwidth measurements.
+
+        Current Keywords:
+        "timestamp" -- the Unix Epoch time in seconds when the latest generator
+        result was obtained.
+        "version" -- the Bandwidth List format document specification version.
+        "software" -- the name of the software that created the document.
+        "software_version" -- the version of the software that created the
+        document.
+        "generator_started" -- the date and time timestamp in ISO 8601 format
+        and UTC time zone when the generator started.
+        "earliest_bandwidth" -- the date and time timestamp in ISO 8601 format
+        and UTC time zone when the first relay bandwidth was obtained.
+        First-appeared: Tor 0.3.5
+
    The authority section of a vote contains the following items, followed
    in turn by the authority's current key certificate: