commit a67ac4db6b7493748cd3b8e913f2597ae057bb0b Author: Qingping Hou <dave2008713@gmail.com> Date: Tue Sep 10 14:54:01 2013 -0400 add hidden service descriptor asynchronous events --- control-spec.txt | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/control-spec.txt b/control-spec.txt index 73e2e31..9d1df49 100644 --- a/control-spec.txt +++ b/control-spec.txt @@ -1235,7 +1235,7 @@ These replies can be sent after a corresponding SETEVENTS command has been received. They will not be interleaved with other Reply elements, but they - can appear between a command and its corresponding reply. For example, + can not appear between a command and its corresponding reply. For example, this sequence is possible: C: SETEVENTS CIRC @@ -2423,6 +2423,28 @@ [First added in 0.2.5.2-alpha] +4.1.25. HiddenService descriptors + + The syntax is: + + "650" SP "HS_DESC" SP Action SP HSAddress SP AuthType SP HsDir [SP DescriptorID] + + Action = "REQUESTED" / "RECEIVED" / "IGNORE" / "FAILED" + HSAddress = 16*Base32Character + AuthType = "NO_AUTH" / "BASIC_AUTH" / "STEALTH_AUTH" / "UNKNOWN" + HsDir = LongName / Fingerprint + DescriptorID = 32*Base32Character + + These events will be triggerred when required HiddenService descriptor is + not found in the cache and a fetch from network is performed. + + If we already had the v0 descriptor, the newly fected v2 descriptor will be + ignored and a "HS_DESC" event with "IGNORE" action will be generated. + + For HsDir, LongName is always prefered. If HsDir cannot be found in node + list at the time event is sent, Fingerprint will be used instead. + + 5. Implementation notes 5.1. Authentication