nihilist/tor
1
0
Fork 0
mirror of https://gitlab.torproject.org/tpo/core/tor.git synced 2024-11-30 23:53:32 +01:00
Code Issues Packages Projects Releases Wiki Activity

r15938@catbus: nickm | 2007-10-18 22:04:59 -0400

Browse Source 
Misc clarifications and corrections in dir-spec.txt


svn:r12040
This commit is contained in:
Nick Mathewson 2007-10-19 02:15:43 +00:00
parent 829801c476
commit 90de3ca9ae
1 changed files with 23 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
doc/spec/dir-spec.txt
View File

@ -303,7 +303,7 @@ $Id$
(FU) time and a "valid-until" (VU) time. VA MUST precede FU, which MUST (FU) time and a "valid-until" (VU) time. VA MUST precede FU, which MUST
in turn precede VU. Times are chosen so that every consensus will be in turn precede VU. Times are chosen so that every consensus will be
"fresh" until the next consensus becomes valid, and "valid" for a while "fresh" until the next consensus becomes valid, and "valid" for a while
after. At least 2 or 3 consensuses should be valid at any given time. after. At least 3 consensuses should be valid at any given time.
The timeline for a given consensus is as follows: The timeline for a given consensus is as follows:
@ -320,11 +320,17 @@ $Id$
VA: All authorities have a multiply signed consensus. VA: All authorities have a multiply signed consensus.
VA ... FU: Caches download the consensus. VA ... FU: Caches download the consensus. (Note that since caches have
no way of telling what VA and FU are until they have downloaded
the consensus, they assume that the present descriptor's VA is
equal to the previous one's FU, and that its FU is one interval after
that.)
FU: The consensus is no long the freshest consensus. FU: The consensus is no long the freshest consensus.
FU ... VU: Clients download the consensus. FU ... (the current descriptors's VU): Clients download the consensus.
(See note above: clients guess that the next descriptor's FU will be
two intervals after the current VA.)
VU: The consensus is no longer valid. VU: The consensus is no longer valid.
@ -649,6 +655,11 @@ $Id$
the protocol described in this document. Implementations MUST the protocol described in this document. Implementations MUST
reject formats they don't understand. reject formats they don't understand.
"address" IP NL
[Once or more]
An IP:Port for this authority's directory port.
"fingerprint" fingerprint NL "fingerprint" fingerprint NL
[Exactly once.] [Exactly once.]
@ -738,6 +749,15 @@ $Id$
consensuses from votes. See section 3.4.1 for details. Method "1" consensuses from votes. See section 3.4.1 for details. Method "1"
MUST be included. MUST be included.
"consensus-method" SP Integer NL
[Exactly once for consensuses; does not occur in votes.]
See section 3.4.1 for details.
(Only included when the vote is generated with consensus-method 2 or
later.)
"published" SP YYYY-MM-DD SP HH:MM:SS NL "published" SP YYYY-MM-DD SP HH:MM:SS NL
[Exactly once for votes; does not occur in consensuses.] [Exactly once for votes; does not occur in consensuses.]