[or-cvs] r14448: Document conditional consensus urls in dirspec (tor/trunk/doc/spec)

[weasel at seul.org]

Author: weasel
Date: 2008-04-24 11:39:03 -0400 (Thu, 24 Apr 2008)
New Revision: 14448

Modified:
   tor/trunk/doc/spec/dir-spec.txt
Log:
Document conditional consensus urls in dirspec


Modified: tor/trunk/doc/spec/dir-spec.txt
===================================================================
--- tor/trunk/doc/spec/dir-spec.txt	2008-04-24 15:39:01 UTC (rev 14447)
+++ tor/trunk/doc/spec/dir-spec.txt	2008-04-24 15:39:03 UTC (rev 14448)
@@ -1390,6 +1390,23 @@
    The most recent v3 consensus should be available at:
       http://<hostname>/tor/status-vote/current/consensus.z
 
+   Starting with Tor version 0.2.1.1-alpha is also available at:
+      http://<hostname>/tor/status-vote/current/consensus/<F1>+<F2>+<F3>.z
+
+   Where F1, F2, etc. are authority identity fingerprints the client trusts.
+   Servers will only return a consensus if more than half of the requested
+   authorities have signed the document, otherwise a 404 error will be sent
+   back.  The fingerprints can be shortened to a length of any multiple of
+   two, using only the leftmost part of the encoded fingerprint.  Tor uses
+   3 bytes (6 hex characters) of the fingerprint.
+
+   Clients SHOULD sort the fingerprints in ascending order.  Server MUST
+   accept any order.
+
+   Clients SHOULD use this format when requesting consensus documents from
+   directory authority servers and from caches running a version of Tor
+   that is known to support this URL format.
+
    A concatenated set of all the current key certificates should be available
    at:
       http://<hostname>/tor/keys/all.z