[tor-commits] [torspec/master] Document TIME_CREATED field of CIRC/CIRC2 events

[nickm at torproject.org]

commit ca3f983039a69583684cde056d8a4d075a859f23
Author: Robert Ransom <rransom.8774 at 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 =