aboutsummaryrefslogtreecommitdiff
path: root/spec/bandwidth-file-spec
diff options
context:
space:
mode:
authorjuga0 <juga@riseup.net>2023-11-18 15:00:58 +0000
committerjuga0 <juga@riseup.net>2023-11-20 10:01:00 +0000
commitf998a7212435a5ce7f9ca0cdfc515e1712e44107 (patch)
tree44bcd709bb869abcf5be3048a714dbd01195726c /spec/bandwidth-file-spec
parent2609c0b4b33a4822fb258453d3f1e74952eaeb29 (diff)
downloadtorspec-f998a7212435a5ce7f9ca0cdfc515e1712e44107.tar.gz
torspec-f998a7212435a5ce7f9ca0cdfc515e1712e44107.zip
bandwidth-file-spec: Add dirauth_nickname KeyValue
to the BandwidthFile header with the dirauth's nickname that publish the BandwidthFile in order to easier database queries to the past parsed BandwidthFiles. Closes #240
Diffstat (limited to 'spec/bandwidth-file-spec')
-rw-r--r--spec/bandwidth-file-spec/header-list-format.md8
-rw-r--r--spec/bandwidth-file-spec/scope-preliminaries.md1
2 files changed, 9 insertions, 0 deletions
diff --git a/spec/bandwidth-file-spec/header-list-format.md b/spec/bandwidth-file-spec/header-list-format.md
index 6b7f9df..206ff0c 100644
--- a/spec/bandwidth-file-spec/header-list-format.md
+++ b/spec/bandwidth-file-spec/header-list-format.md
@@ -377,6 +377,14 @@ KeyValue NL
\[Zero or more times.\]
+"dirauth_nickname" NL
+
+\[Zero or one time.\]
+
+The dirauth's nickname which publishes this V3BandwidthsFile.
+
+This Line was added in version 1.8.0 of this specification.
+
There MUST NOT be multiple KeyValue header Lines with the same key.
If there are, the parser SHOULD choose an arbitrary Line.
diff --git a/spec/bandwidth-file-spec/scope-preliminaries.md b/spec/bandwidth-file-spec/scope-preliminaries.md
index 0215514..6951d3d 100644
--- a/spec/bandwidth-file-spec/scope-preliminaries.md
+++ b/spec/bandwidth-file-spec/scope-preliminaries.md
@@ -66,6 +66,7 @@ as bandwidth scanners.
1.6.0 - Adds congestion control stream events KeyValues.
1.7.0 - Adds ratios KeyValues to the relay lines and network averages
KeyValues to the header.
+ 1.8.0 - Adds "dirauth_nickname" KeyValue to the header.
All Tor versions can consume format version 1.0.0.
```