[tor-commits] [torspec/master] prop281: Clarification based on comments from teor

[nickm@xxxxxxxxxxxxxx]

commit ed88a5d4d930928d687f82ee3d47d96e6ee11c30
Author: Nick Mathewson <nickm@xxxxxxxxxxxxxx>
Date:   Mon Aug 28 11:32:28 2017 -0400

    prop281: Clarification based on comments from teor
---
 proposals/281-bulk-md-download.txt | 20 +++++++++++++++-----
 1 file changed, 15 insertions(+), 5 deletions(-)

diff --git a/proposals/281-bulk-md-download.txt b/proposals/281-bulk-md-download.txt
index 9b1d669..38c0a20 100644
--- a/proposals/281-bulk-md-download.txt
+++ b/proposals/281-bulk-md-download.txt
@@ -36,7 +36,9 @@ Status: Draft
   If answering, caches MUST reply with all of the
   microdescriptors that the cache holds that were listed by
   consensus X, and MUST omit all the microdescriptors that were
-  omitted listed in consensus Y.
+  not listed in consensus Y.  (For the purposes of this proposal,
+  microdescriptors are "the same" if they are textually identical
+  and have the same digest.)
 
 2.2. By consensus:
 
@@ -52,10 +54,18 @@ Status: Draft
 
 2.3. When to make these requests
 
-  Clients should decide to use this format in preference to the
-  old download-by-digest format if the consensus X lists their
-  preferred directory cache as using a new DirCache subprotocol
-  version. (See 5 below.)
+  Clients should decide to use this format in preference to the old
+  download-by-digest format if the consensus X lists their preferred
+  directory cache as using a new DirCache subprotocol version. (See
+  5 below.)
+
+  When a client has some preferred directory caches that support
+  this subprotocol and some that do not, it chooses one at random,
+  and uses these requests if that one supports this subprotocol.
+
+  (A client always has a consensus when it requests
+  microdescriptors, so it will know whether any given cache supports
+  these requests.)
 
 3. Performance analysis
 

_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits