aboutsummaryrefslogtreecommitdiff
path: root/bandwidth-file-spec.txt
diff options
context:
space:
mode:
authorjuga0 <juga@riseup.net>2019-05-05 06:28:26 +0000
committerNick Mathewson <nickm@torproject.org>2019-05-13 13:41:22 -0400
commitcfe12e6a0e19482c7f4c228875aa209c6d65eb30 (patch)
treee568d11d8fb55d1b1ff9de11e016f61aa0f21c5b /bandwidth-file-spec.txt
parente1ad77e2a1291b02ec099bfec89b1e9751e2ab95 (diff)
downloadtorspec-cfe12e6a0e19482c7f4c228875aa209c6d65eb30.tar.gz
torspec-cfe12e6a0e19482c7f4c228875aa209c6d65eb30.zip
bandwidth-file: Add HeaderLine non-terminal
To make more clear that header lines do not contain spaces and simplify parsers. This does not change the format. Closes: #30311
Diffstat (limited to 'bandwidth-file-spec.txt')
-rw-r--r--bandwidth-file-spec.txt9
1 files changed, 9 insertions, 0 deletions
diff --git a/bandwidth-file-spec.txt b/bandwidth-file-spec.txt
index 1c36558..2776fab 100644
--- a/bandwidth-file-spec.txt
+++ b/bandwidth-file-spec.txt
@@ -112,6 +112,7 @@
Line ::= ArgumentChar* NL
RelayLine ::= KeyValue (SP KeyValue)* NL
+ HeaderLine ::= KeyValue NL
KeyValue ::= Keyword "=" Value
Value ::= ArgumentCharValue+
ArgumentCharValue ::= any printing ASCII character except NL and SP.
@@ -141,6 +142,14 @@
2.2. Header List format
+ It consists of a Timestamp line and zero or more HeaderLines.
+
+ All the header lines MUST conform to the HeaderLine format, except
+ the first Timestamp line.
+
+ The Timestamp line is not a HeaderLine to keep compatibility with
+ the legacy Bandwidth File format.
+
Some header Lines MUST appear in specific positions, as documented
below. All other Lines can appear in any order.