From d29d9ada0bf86167edc647285534b8d75890a593 Mon Sep 17 00:00:00 2001 From: teor Date: Mon, 16 Jul 2018 10:16:18 +1000 Subject: bandwidth: edit bandwidth URL dir-spec and proposal * dir-spec: don't post bandwidth files to other authorities * dir-spec: add URL for current bandwidth file * dir-spec: clean up the consensus and vote "current" publication schedule Closes ticket #21377. --- dir-spec.txt | 26 +++++++++++++------------- 1 file changed, 13 insertions(+), 13 deletions(-) (limited to 'dir-spec.txt') diff --git a/dir-spec.txt b/dir-spec.txt index 388ad04..df74ca8 100644 --- a/dir-spec.txt +++ b/dir-spec.txt @@ -2607,19 +2607,19 @@ http:///tor/status-vote/next/bandwidth.z at the start of each voting period. + + It MUST NOT attempt to send its bandwidth list file in a HTTP POST to + other authorities and it SHOULD NOT make bandwidth list files from other + authorities available. + If an authority makes this file available, it MUST be the bandwidth file used to create the vote document available at http:///tor/status-vote/next/authority.z - Once the voting period starts, the bandwidth list file SHOULD be available - at + The bandwidth list format is described in bandwidth-file-spec.txt. - http:///tor/status-vote/next/bandwidth.z - - The bandwidth list file is described in bandwidth-file-spec.txt. - - First-appeared in Tor 0.3.5. + The standard URLs for bandwidth list files first-appeared in Tor 0.3.5. 3.5. Downloading missing certificates from other directory authorities @@ -3343,16 +3343,14 @@ 3.11. Publishing the signed consensus - Once there are enough signatures, or once the voting period starts, - these documents are available at + The voting period ends at the valid-after time. If the consensus has + been signed by a majority of authorities, these documents are made + available at http:///tor/status-vote/current/consensus.z and http:///tor/status-vote/current/consensus-signatures.z [XXX current/consensus-signatures is not currently implemented, as it is not used in the voting protocol.] - [XXX It's actually false that the first document is available as soon - as there are enough signatures. It's only available as soon as the - voting period starts. -KL] [XXX possible future features include support for downloading old consensuses.] @@ -3361,13 +3359,15 @@ http:///tor/status-vote/current/authority.z http:///tor/status-vote/current/.z http:///tor/status-vote/current/d/.z - once the consensus is complete. + http:///tor/status-vote/current/bandwidth.z + once the voting period ends, regardless of the number of signatures. The authorities serve another consensus of each flavor "F" from the locations /tor/status-vote/(current|next)/consensus-F.z. and /tor/status-vote/(current|next)/consensus-F/+....z. + The standard URLs for bandwidth list files first-appeared in Tor 0.3.5. 4. Directory cache operation -- cgit v1.2.3-54-g00ecf