[tor-commits] [torspec/master] dir-spec: specify failure modes for the bandwdith file headers vote line

nickm at torproject.org nickm at torproject.org
Tue Jul 17 12:49:35 UTC 2018


commit 2cce07d59a5391f8b6d9e1c8805ce1889b15f127
Author: teor <teor2345 at gmail.com>
Date:   Mon Jul 16 13:24:35 2018 +1000

    dir-spec: specify failure modes for the bandwdith file headers vote line
    
    Closes 26799.
---
 dir-spec.txt | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/dir-spec.txt b/dir-spec.txt
index f2447c2..6408d87 100644
--- a/dir-spec.txt
+++ b/dir-spec.txt
@@ -2091,7 +2091,7 @@
 
         [At most once for votes; does not occur in consensuses.]
 
-        KeyValues ::= KeyValue | KeyValues SP KeyValue
+        KeyValues ::= "" | KeyValue | KeyValues SP KeyValue
         KeyValue ::= Keyword '=' Value
         Value ::= ArgumentCharValue+
         ArgumentCharValue ::= any printing ASCII character except NL and SP.
@@ -2099,6 +2099,12 @@
         The headers from the bandwidth file used to generate this vote.
         The bandwidth file headers are described in bandwidth-file-spec.txt.
 
+        If an authority is not configured with a V3BandwidthsFile, this line
+        SHOULD NOT appear in its vote.
+
+        If an authority is configured with a V3BandwidthsFile, but parsing
+        fails, this line SHOULD appear in its vote, but without any headers.
+
         Current Keywords:
         "timestamp" -- the Unix Epoch time in seconds of the most recent
         generator result.





More information about the tor-commits mailing list