diff options
author | Nick Mathewson <nickm@torproject.org> | 2021-08-27 10:46:46 -0400 |
---|---|---|
committer | Nick Mathewson <nickm@torproject.org> | 2021-08-27 10:46:46 -0400 |
commit | e226989eb19cdbcfa46c6ef9ec6ed866f453a871 (patch) | |
tree | efb5557aa64013469734bab73c00b9ec600135d6 /path-spec.txt | |
parent | 7a06c12fea6e65dd0bcb411000d968844335c22f (diff) | |
download | torspec-e226989eb19cdbcfa46c6ef9ec6ed866f453a871.tar.gz torspec-e226989eb19cdbcfa46c6ef9ec6ed866f453a871.zip |
Explain when circuits are torn down, and how they become dirty.
Diffstat (limited to 'path-spec.txt')
-rw-r--r-- | path-spec.txt | 15 |
1 files changed, 14 insertions, 1 deletions
diff --git a/path-spec.txt b/path-spec.txt index 65d56c4..235f64b 100644 --- a/path-spec.txt +++ b/path-spec.txt @@ -205,6 +205,11 @@ of their choices. might be supported by a pending or built circuit. For internal circuits, we pick an arbitrary acceptable path, repeating as needed. + Clients consider a circuit to become "dirty" as soon as a stream is + attached to it, or some other request is performed over the circuit. + If a circuit has been "dirty" for at least MaxCircuitDirtiness seconds, + new circuits may not be attached to it. + In some cases we can reuse an already established circuit if it's clean; see Section 2.3 (cannibalizing circuits) for details. @@ -242,8 +247,16 @@ of their choices. 2.1.6. When to tear down circuits - XXXX + Clients should tear down circuits (in general) only when those circuits + have no streams on them. Additionally, clients should tear-down + stream-less circuits only under one of the following conditions: + + - The circuit has never had a stream attached, and it was created too + long in the past (based on CircuitsAvailableTimeout or + cbtlearntimeout, depending on timeout estimate status). + - The circuit is dirty (has had a stream attached), and it has been + dirty for at least MaxCircuitDirtiness. 2.2. Path selection and constraints |