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

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

View File

@ -303,7 +303,7 @@ $Id$
(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
"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:
@ -320,11 +320,17 @@ $Id$
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 ... 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.
@ -649,6 +655,11 @@ $Id$
the protocol described in this document. Implementations MUST
reject formats they don't understand.
"address" IP NL
[Once or more]
An IP:Port for this authority's directory port.
"fingerprint" fingerprint NL
[Exactly once.]
@ -738,6 +749,15 @@ $Id$
consensuses from votes. See section 3.4.1 for details. Method "1"
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
[Exactly once for votes; does not occur in consensuses.]