[tor-commits] [torspec/master] add hidden service descriptor asynchronous events

[nickm at torproject.org]

commit a67ac4db6b7493748cd3b8e913f2597ae057bb0b
Author: Qingping Hou <dave2008713 at 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