summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2007-02-23 20:13:02 +0000
committerNick Mathewson <nickm@torproject.org>2007-02-23 20:13:02 +0000
commit55cbbdf9bfea465ecbfd5ef67dc7d37650a07018 (patch)
treeba4152a0d8c0ff21ad863d24cd42a35f52d4f50f /doc
parentf1d207b29a8b4e7b55ea5f95212428581e34306a (diff)
downloadtor-55cbbdf9bfea465ecbfd5ef67dc7d37650a07018.tar.gz
tor-55cbbdf9bfea465ecbfd5ef67dc7d37650a07018.zip
r11895@catbus: nickm | 2007-02-23 15:12:58 -0500
Make remap stream events have a souce; make them generated every time we get a successful connected or resolved cell. Also change reported stream target address to IP consistently when we get the IP from an exit node. svn:r9624
Diffstat (limited to 'doc')
-rw-r--r--doc/TODO4
-rw-r--r--doc/spec/control-spec.txt14
2 files changed, 12 insertions, 6 deletions
diff --git a/doc/TODO b/doc/TODO
index b6b60081ff..30d9046855 100644
--- a/doc/TODO
+++ b/doc/TODO
@@ -72,8 +72,8 @@ R - actually cause the directory.c functions to know about or_port
should abandon.
- update dir-spec with what we decided for each of these
-N - Controller fixes
- - Make REMAP stream events have a SOURCE (cache or exit), and make them
+ o Controller fixes
+ o Make REMAP stream events have a SOURCE (cache or exit), and make them
generated in every case where we get a connected or resolved cell.
N - Libevent fixes
diff --git a/doc/spec/control-spec.txt b/doc/spec/control-spec.txt
index 32deedf34d..17cef23df7 100644
--- a/doc/spec/control-spec.txt
+++ b/doc/spec/control-spec.txt
@@ -828,7 +828,8 @@ $Id$
The syntax is:
"650" SP "STREAM" SP StreamID SP StreamStatus SP CircID SP Target
- [SP "REASON=" Reason [ SP "REMOTE_REASON=" Reason ]] CRLF
+ [SP "REASON=" Reason [ SP "REMOTE_REASON=" Reason ]]
+ [SP "SOURCE=" Source] CRLF
StreamStatus =
"NEW" / ; New request to connect
@@ -858,12 +859,20 @@ $Id$
END (We received a RELAY_END cell from the other side of thise
stream.)
+ [XXXX document more.]
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.
+ "REMAP" events include a Source if extended events are enabled:
+ Source = "CACHE" / "EXIT"
+ Clients MUST accept sources not listed above. "CACHE" is given if
+ the Tor client decided to remap the address because of a cached
+ answer, and "EXIT" is given if the remote node we queried gave us
+ the new address as a response.
+
4.1.3. OR Connection status changed
The syntax is:
@@ -930,9 +939,6 @@ $Id$
[XXX We should rename this to ADDRESSMAP. -RD]
[Why? Surely it can't be worth the compatibility issues. -NM]
- [FFF We should add a SOURCE=%s argument for extended events,
- which specifies what exit node told us this addressmap. -RD]
-
4.1.8. Descriptors uploaded to us in our role as authoritative dirserver
Syntax: