diff options
author | Damian Johnson <atagar@torproject.org> | 2013-06-20 07:52:00 -0700 |
---|---|---|
committer | Damian Johnson <atagar@torproject.org> | 2013-06-20 07:52:00 -0700 |
commit | d2b7ebb098c5cae9c40aaaf2bbc50efe67e1c91f (patch) | |
tree | e74c04e2e48f3dc97eb7bf07c62dd9bbb3bbb2f9 | |
parent | 1e074bfe15908069f1b61d4f9d95a3168e997a57 (diff) | |
download | torspec-d2b7ebb098c5cae9c40aaaf2bbc50efe67e1c91f.tar.gz torspec-d2b7ebb098c5cae9c40aaaf2bbc50efe67e1c91f.zip |
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.
-rw-r--r-- | control-spec.txt | 16 |
1 files 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.) |