commit ca3f983039a69583684cde056d8a4d075a859f23 Author: Robert Ransom rransom.8774@gmail.com Date: Mon Jun 27 15:44:32 2011 -0700

Document TIME_CREATED field of CIRC/CIRC2 events --- control-spec.txt | 11 +++++++++++ 1 files changed, 11 insertions(+), 0 deletions(-)

diff --git a/control-spec.txt b/control-spec.txt index 664ff0c..36b6816 100644 --- a/control-spec.txt +++ b/control-spec.txt @@ -1084,6 +1084,7 @@ "650" SP "CIRC" SP CircuitID SP CircStatus [SP Path] [SP "BUILD_FLAGS=" BuildFlags] [SP "PURPOSE=" Purpose] [SP "HS_STATE=" HSState] [SP "REND_QUERY=" HSAddress] + [SP "TIME_CREATED=" TimeCreated] [SP "REASON=" Reason [SP "REMOTE_REASON=" Reason]] CRLF

CircStatus = @@ -1116,6 +1117,10 @@ HSAddress = 16*Base32Character Base32Character = ALPHA / "2" / "3" / "4" / "5" / "6" / "7"

+ TimeCreated = Seconds "," MicroSeconds + Seconds = 1*DIGIT + Microseconds = 1*DIGIT + Reason = "NONE" / "TORPROTOCOL" / "INTERNAL" / "REQUESTED" / "HIBERNATING" / "RESOURCELIMIT" / "CONNECTFAILED" / "OR_IDENTITY" / "OR_CONN_CLOSED" / "TIMEOUT" / @@ -1176,6 +1181,11 @@ MUST accept hidden service addresses in formats other than that specified above.

+ The "TIME_CREATED" field is provided only in versions 0.2.3.2-alpha + and later. Seconds is the tv_sec field of a 'struct timeval'; + Microseconds is the tv_usec field. TIME_CREATED is the time at + which the circuit was created or cannibalized. + The "REASON" field is provided only for FAILED and CLOSED 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: @@ -1916,6 +1926,7 @@ "650" SP "CIRC2" SP CircuitID SP CircEvent [SP Path] [SP "BUILD_FLAGS=" BuildFlags] [SP "PURPOSE=" Purpose] [SP "HS_STATE=" HSState] [SP "REND_QUERY=" HSAddress] + [SP "TIME_CREATED=" TimeCreated] [SP "OLD_PURPOSE=" Purpose [SP "OLD_HS_STATE=" HSState]] CRLF

CircEvent =