aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDavid Goulet <dgoulet@torproject.org>2022-03-14 15:37:24 -0400
committerDavid Goulet <dgoulet@torproject.org>2022-03-14 15:37:24 -0400
commit80761a861bc14cf852400cd7ee103f21087b9467 (patch)
treeb94d4b58fce874e778e0701a189688e870a1e008
parent48e063fa176a1160e91e24fe9c4203150d2fa574 (diff)
parent86bbf141aaa83a626ac3fb725142b11526ec0514 (diff)
downloadtorspec-80761a861bc14cf852400cd7ee103f21087b9467.tar.gz
torspec-80761a861bc14cf852400cd7ee103f21087b9467.zip
Merge branch 'tor-gitlab/mr/66'
-rw-r--r--control-spec.txt29
1 files changed, 28 insertions, 1 deletions
diff --git a/control-spec.txt b/control-spec.txt
index 0e2add3..af0368a 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -2425,6 +2425,14 @@ Table of Contents
"DETACHED" / ; Detached from circuit; still retriable
"CONTROLLER_WAIT" ; Waiting for controller to use ATTACHSTREAM
; (new in 0.4.5.1-alpha)
+ "XOFF_SENT" ; XOFF has been sent for this stream
+ ; (new in 0.4.7.5-alpha)
+ "XOFF_RECV" ; XOFF has been received for this stream
+ ; (new in 0.4.7.5-alpha)
+ "XON_SENT" ; XON has been sent for this stream
+ ; (new in 0.4.7.5-alpha)
+ "XON_RECV" ; XON has been received for this stream
+ ; (new in 0.4.7.5-alpha)
Target = TargetAddress ":" Port
Port = an integer from 0 to 65535 inclusive
@@ -3430,14 +3438,21 @@ Table of Contents
"WRITTEN=" BytesWritten SP "TIME=" Time SP
"DELIVERED_READ=" DeliveredBytesRead SP
"OVERHEAD_READ=" OverheadBytesRead SP
- "DELIVERED_WRITTEN=" DeliveredBytesWritten CRLF
+ "DELIVERED_WRITTEN=" DeliveredBytesWritten SP
"OVERHEAD_WRITTEN=" OverheadBytesWritten SP
+ "SS=" SlowStartState SP
+ "CWND=" CWNDCells SP
+ "RTT=" RTTMilliseconds SP
+ "MIN_RTT=" RTTMilliseconds CRLF
BytesRead = 1*DIGIT
BytesWritten = 1*DIGIT
OverheadBytesRead = 1*DIGIT
OverheadBytesWritten = 1*DIGIT
DeliveredBytesRead = 1*DIGIT
DeliveredBytesWritten = 1*DIGIT
+ SlowStartState = 0 or 1
+ CWNDCells = 1*DIGIT
+ RTTMilliseconds= 1*DIGIT
Time = ISOTime2Frac
BytesRead and BytesWritten are the number of bytes read and written
@@ -3465,6 +3480,16 @@ Table of Contents
The Time field is provided only in versions 0.3.2.1-alpha and later. It
records when Tor created the bandwidth event.
+ The SS, CWND, RTT, and MIN_RTT fields are present only if the circuit
+ has negotiated congestion control to an onion service or Exit hop (any
+ intermediate leaky pipe congestion control hops are not examined here).
+ SS provides an indication if the circuit is in slow start (1), or not (0).
+ CWND is the size of the congestion window in terms of number of cells.
+ RTT is the N_EWMA smoothed current RTT value, and MIN_RTT is the minimum
+ RTT value of the circuit. The SS and CWND fields apply only to the
+ upstream direction of the circuit. The slow start state and CWND values
+ of the other endpoint may be different.
+
These events are generated about once per second per circuit; no events
are generated for circuits that had no attached stream writing or
reading.
@@ -3474,6 +3499,8 @@ Table of Contents
[DELIVERED_READ, OVERHEAD_READ, DELIVERED_WRITTEN, and OVERHEAD_WRITTEN
were added in Tor 0.3.4.0-alpha]
+ [SS, CWND, RTT, and MIN_RTT were added in Tor 0.4.7.5-alpha]
+
4.1.23. Per-circuit cell stats
The syntax is: