aboutsummaryrefslogtreecommitdiff
path: root/doc/control-spec.txt
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2006-10-20 17:54:36 +0000
committerNick Mathewson <nickm@torproject.org>2006-10-20 17:54:36 +0000
commit12af87539b3380e97a9433930e4fa60cd825c157 (patch)
tree20117d0755a39f369a7c7bcc38a39d2c0c84ba1a /doc/control-spec.txt
parentc8c36dd227eec2454cfe3aaa74720cc5897864ac (diff)
downloadtor-12af87539b3380e97a9433930e4fa60cd825c157.tar.gz
tor-12af87539b3380e97a9433930e4fa60cd825c157.zip
r9303@Kushana: nickm | 2006-10-20 12:07:34 -0400
Start implementing reason extension for stream events to match the one one used by circuit events. (Not a complete implementation yet; actual reasons are not passed to control.c) svn:r8777
Diffstat (limited to 'doc/control-spec.txt')
-rw-r--r--doc/control-spec.txt19
1 files changed, 19 insertions, 0 deletions
diff --git a/doc/control-spec.txt b/doc/control-spec.txt
index b6638958d8..abf9de8dfe 100644
--- a/doc/control-spec.txt
+++ b/doc/control-spec.txt
@@ -835,6 +835,7 @@ $Id$
The syntax is:
"650" SP "STREAM" SP StreamID SP StreamStatus SP CircID SP Target
+ [SP "REASON=" Reason [ SP "REMOTE_REASON=" Reason ]] CRLF
StreamStatus =
"NEW" / ; New request to connect
@@ -851,6 +852,24 @@ $Id$
The circuit ID designates which circuit this stream is attached to. If
the stream is unattached, the circuit ID "0" is given.
+ Reason = "MISC" / "RESOLVEFAILED" / "CONNECTREFUSED" /
+ "EXITPOLICY" / "DESTROY" / "DONE" / "TIMEOUT" /
+ "HIBERNATING" / "INTERNAL"/ "RESOURCELIMIT" /
+ "CONNRESET" / "TORPROTOCOL" / "NOTDIRECTORY" / "END"
+
+ The "REASON" field is provided only for FAILED, CLOSED, and DETACHED
+ events, and only if extended events are enabled (see 3.19). Clients MUST
+ accept reasons not listed above. Reasons are as given in tor-spec.txt,
+ except for:
+
+ END (We received a RELAY_END cell from the other side of thise
+ stream.)
+
+ The "REMOTE_REASON" field is provided only when we receive a RELAY_END
+ cell, and only if extended events are enabled. It contains the actual
+ reason given by the remote OR for closing the stream. Clients MUST accept
+ reasons not listed above. Reasons are as listed in tor-spec.txt.
+
4.1.3. OR Connection status changed
The syntax is: