diff options
| author | Nick Mathewson <nickm@torproject.org> | 2007-10-19 02:15:43 +0000 |
|---|---|---|
| committer | Nick Mathewson <nickm@torproject.org> | 2007-10-19 02:15:43 +0000 |
| commit | 90de3ca9aeaddbbad092255f7e599a45ea503f24 (patch) | |
| tree | 6ea2ab60aff02dd6f20eb13607dcad23558997b1 /doc | |
| parent | 829801c476c942617588c5432ca2933ff7025178 (diff) | |
| download | tor-90de3ca9aeaddbbad092255f7e599a45ea503f24.tar tor-90de3ca9aeaddbbad092255f7e599a45ea503f24.tar.gz | |
r15938@catbus: nickm | 2007-10-18 22:04:59 -0400
Misc clarifications and corrections in dir-spec.txt
svn:r12040
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/spec/dir-spec.txt | 26 |
1 files changed, 23 insertions, 3 deletions
diff --git a/doc/spec/dir-spec.txt b/doc/spec/dir-spec.txt index 6e3099ffa..42200c156 100644 --- a/doc/spec/dir-spec.txt +++ b/doc/spec/dir-spec.txt @@ -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.] |