aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorRoger Dingledine <arma@torproject.org>2007-01-22 06:11:56 +0000
committerRoger Dingledine <arma@torproject.org>2007-01-22 06:11:56 +0000
commitd634e5b9af38541fed4b684a9ed1ba8ed35e4326 (patch)
treedbff22170de58842f321ec60b65a0ab25b29d175 /doc
parentab838bddb89fa3f37eeada29e8c10d16873b5e86 (diff)
downloadtor-d634e5b9af38541fed4b684a9ed1ba8ed35e4326.tar
tor-d634e5b9af38541fed4b684a9ed1ba8ed35e4326.tar.gz
minor cleanups on the controller spec. specify a wishlist
item for BW events. svn:r9383
Diffstat (limited to 'doc')
-rw-r--r--doc/control-spec.txt17
1 files changed, 11 insertions, 6 deletions
diff --git a/doc/control-spec.txt b/doc/control-spec.txt
index f07251ec1..07fac942f 100644
--- a/doc/control-spec.txt
+++ b/doc/control-spec.txt
@@ -774,14 +774,13 @@ $Id$
expected, and MUST tolerate more lines in an asynchronous reply than
expected. For instance, a client that expects a CIRC message like:
650 CIRC 1000 EXTENDED moria1,moria2
- should tolerate:
+ must tolerate:
650-CIRC 1000 EXTENDED moria1,moria2 0xBEEF
650-EXTRAMAGIC=99
650 ANONYMITY=high
If clients ask for extended events, then each event line as specified below
- will be followed by additional extensions. Clients that do so MUST
- tolerate additional arguments and lines. Additional lines will be of the
+ will be followed by additional extensions. Additional lines will be of the
form
"650" ("-"/" ") KEYWORD ["=" ARGUMENTS] CRLF
Additional arguments will be of the form
@@ -866,7 +865,7 @@ $Id$
4.1.3. OR Connection status changed
The syntax is:
- "650" SP "ORCONN" SP (ServerID / Target) SP ORStatus [ SP "REASON="
+ "650" SP "ORCONN" SP (ServerID / Target) SP ORStatus [ SP "REASON="
Reason ] [ SP "NCIRCS=" NumCircuits ]
ORStatus = "NEW" / "LAUNCHED" / "CONNECTED" / "FAILED" / "CLOSED"
@@ -894,9 +893,15 @@ $Id$
4.1.4. Bandwidth used in the last second
The syntax is:
- "650" SP "BW" SP BytesRead SP BytesWritten
+ "650" SP "BW" SP BytesRead SP BytesWritten *(SP Type "=" Num)
BytesRead = 1*DIGIT
BytesWritten = 1*DIGIT
+ Type = "DIR" / "OR" / "EXIT" / "APP" / ...
+ Num = 1*DIGIT
+
+ BytesRead and BytesWritten are the totals. In Tor 0.1.x.y-alpha
+ and later, we also include a breakdown of the connection types
+ that used bandwidth this second (not implemented yet).
4.1.5. Log messages
@@ -916,7 +921,7 @@ $Id$
Syntax:
"650" SP "ADDRMAP" SP Address SP Address SP Expiry
- Expiry = DQOUTE ISOTime DQUOTE / "NEVER"
+ Expiry = DQUOTE ISOTime DQUOTE / "NEVER"
Expiry is expressed as the local time (rather than GMT).