[tor-commits] [torspec/master] Noting that GETINFO ns/* options provide v3 directory information

nickm at torproject.org nickm at torproject.org
Mon Jun 24 16:57:18 UTC 2013


commit d2b7ebb098c5cae9c40aaaf2bbc50efe67e1c91f
Author: Damian Johnson <atagar at torproject.org>
Date:   Thu Jun 20 07:52:00 2013 -0700

    Noting that GETINFO ns/* options provide v3 directory information
    
    Tor moved from v2 to v3 directory information in commit 3ad6dc0e. Prior to that
    Tor's 'GETINFO ns/*' options provided v2 information, but since then it's been
    v3. For more information see...
    
    https://trac.torproject.org/7953
    
    Technically this is a tor bug, but it happens to be a convenient one so simply
    updating our spec. In practice controller authors haven't noticed this
    discrepancy because v3 router status entries are a superset of the fields in
    v2.
---
 control-spec.txt |   16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/control-spec.txt b/control-spec.txt
index 325b33c..b5228c6 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -506,7 +506,7 @@
       documents.
 
     "ns/id/<OR identity>" or "ns/name/<OR nickname>" -- the latest router
-      status info (v2 directory style) for a given OR.  Router status
+      status info (v3 directory style) for a given OR.  Router status
       info is as given in
       dir-spec.txt, and reflects the current beliefs of this Tor about the
       router in question. Like directory clients, controllers MUST
@@ -514,14 +514,18 @@
       descriptor digest are those believed to be best by this Tor,
       not necessarily those for a descriptor that Tor currently has.
       [First implemented in 0.1.2.3-alpha.]
+      [In 0.2.0.9-alpha this switched from v2 directory style to v3]
 
-    "ns/all" -- Router status info (v2 directory style) for all ORs we
-      have an opinion about, joined by newlines. [First implemented
-      in 0.1.2.3-alpha.]
+    "ns/all" -- Router status info (v3 directory style) for all ORs we
+      have an opinion about, joined by newlines.
+      [First implemented in 0.1.2.3-alpha.]
+      [In 0.2.0.9-alpha this switched from v2 directory style to v3]
 
-    "ns/purpose/<purpose>" -- Router status info (v2 directory style)
+    "ns/purpose/<purpose>" -- Router status info (v3 directory style)
       for all ORs of this purpose. Mostly designed for /ns/purpose/bridge
-      queries. [First implemented in 0.2.0.13-alpha.]
+      queries.
+      [First implemented in 0.2.0.13-alpha.]
+      [In 0.2.0.9-alpha this switched from v2 directory style to v3]
 
     "desc/all-recent" -- the latest server descriptor for every router that
       Tor knows about.  (See note about desc/id/* and desc/name/* above.)



More information about the tor-commits mailing list