From 898cf2c4be20daa0d1cabd47732e4da8104c9d24 Mon Sep 17 00:00:00 2001 From: Nick Mathewson Date: Sat, 14 Apr 2007 21:30:25 +0000 Subject: r12366@catbus: nickm | 2007-04-14 17:30:12 -0400 Clarify some points in proposal 104, mostly based on mail from arma on or-dev. svn:r9955 --- proposals/104-short-descriptors.txt | 22 +++++++++++++++------- 1 file changed, 15 insertions(+), 7 deletions(-) (limited to 'proposals/104-short-descriptors.txt') diff --git a/proposals/104-short-descriptors.txt b/proposals/104-short-descriptors.txt index ac8e3d6..6e960f2 100644 --- a/proposals/104-short-descriptors.txt +++ b/proposals/104-short-descriptors.txt @@ -62,8 +62,8 @@ Specification: Fingerprint is encoded in hex (using upper-case letters), with no spaces. - "published" - As currently documented in dir-spec.txt. + "published" As currently documented in dir-spec.txt. It MUST match the + "published" field of the descriptor published at the same time. "read-history" "write-history" @@ -101,10 +101,14 @@ Specification: Present if this router is a directory cache that provides extra-info documents. + (Since implementations before 0.1.2.5-alpha required that "opt" keyword + precede any unrecognized entry with "opt", these keys MUST be preceded + with "opt" until 0.1.2.5-alpha is obsolete.) + 3. New communications rules - Clients SHOULD generate and upload an extra-info document after each - descriptor they generate and upload; no more, no less. Clients MUST + Servers SHOULD generate and upload an extra-info document after each + descriptor they generate and upload; no more, no less. Servers MUST upload the new descriptor before they upload the new extra-info. Authorities receiving an extra-info document SHOULD verify all of the @@ -115,6 +119,7 @@ Specification: document. * The extra-info-digest field in the router descriptor matches the digest of the extra-info document. + * The published fields in the two documents match. Authorities SHOULD try to fetch extra-info documents from one another if they do not have one matching the digest declared in a router @@ -150,7 +155,7 @@ Migration: For extra info approach: * First: * Authorities should accept extra info, and support serving it. - * Routers should upload bandwidth info once authorities accept it. + * Routers should upload extra info once authorities accept it. * Caches should support an option to download and cache it, once authorities serve it. * Tools should be updated to use locally cached information. @@ -160,7 +165,10 @@ Migration: https://nighteffect.us/tns/ for its graphs and check with or-talk for the rest, once it's time. - * Once tools that want bandwidth info support fetching it: + * Set a cutoff time for including bandwidth in router descriptors, so + that tools that use bandwidth info know that they will need to fetch + extra info documents. + + * Once tools that want bandwidth info support fetching extra info: * Have routers stop including bandwidth info in their router descriptors. - -- cgit v1.2.3-54-g00ecf