commit 3cc3b86299329f34e58c4e752b7af0b8aacb35a6 Author: Nick Mathewson <nickm@torproject.org> Date: Wed Aug 23 09:30:13 2017 -0400 14948: Document when GETINFO md/ and GETINFO ns/ exist --- control-spec.txt | 11 ++++++----- 1 file changed, 6 insertions(+), 5 deletions(-) diff --git a/control-spec.txt b/control-spec.txt index 50a59dd..12a559f 100644 --- a/control-spec.txt +++ b/control-spec.txt @@ -550,8 +550,9 @@ need to use "md" instead.) "md/id/<OR identity>" or "md/name/<OR nickname>" -- the latest - microdescriptor for a given OR. [First implemented in - 0.2.3.8-alpha.] + microdescriptor for a given OR. Empty if we have no microdescriptor for + that OR (because we haven't downloaded one, or it isn't in the + consensus). [First implemented in 0.2.3.8-alpha.] "desc/download-enabled" -- "1" if we try to download router descriptors; "0" otherwise. [First implemented in 0.3.2.1-alpha] @@ -573,8 +574,8 @@ "ns/id/<OR identity>" or "ns/name/<OR nickname>" -- the latest router 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 + info is as given in dir-spec.txt, and reflects the latest + consensus opinion about the router in question. Like directory clients, controllers MUST tolerate unrecognized flags and lines. The published date and descriptor digest are those believed to be best by this Tor, @@ -583,7 +584,7 @@ [In 0.2.0.9-alpha this switched from v2 directory style to v3] "ns/all" -- Router status info (v3 directory style) for all ORs we - have an opinion about, joined by newlines. + that the consensus has 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]