aboutsummaryrefslogtreecommitdiff
path: root/spec/path-spec/when-we-build.md
diff options
context:
space:
mode:
Diffstat (limited to 'spec/path-spec/when-we-build.md')
-rw-r--r--spec/path-spec/when-we-build.md16
1 files changed, 8 insertions, 8 deletions
diff --git a/spec/path-spec/when-we-build.md b/spec/path-spec/when-we-build.md
index ca9b704..cbcf7da 100644
--- a/spec/path-spec/when-we-build.md
+++ b/spec/path-spec/when-we-build.md
@@ -1,10 +1,10 @@
<a id="path-spec.txt-2.1"></a>
-## When we build
+# When we build
<a id="path-spec.txt-2.1.0"></a>
-### We don't build circuits until we have enough directory info
+## We don't build circuits until we have enough directory info
There's a class of possible attacks where our directory servers
only give us information about the relays that they would like us
@@ -59,7 +59,7 @@ fraction of middle relays.
<a id="path-spec.txt-2.1.1"></a>
-### Clients build circuits preemptively
+## Clients build circuits preemptively
When running as a client, Tor tries to maintain at least a certain
number of clean circuits, so that new streams can be handled
@@ -94,7 +94,7 @@ persistent medium.
<a id="path-spec.txt-2.1.2"></a>
-### Clients build circuits on demand
+## Clients build circuits on demand
Additionally, when a client request exists that no circuit (built or
pending) might support, we create a new circuit to support the request.
@@ -114,7 +114,7 @@ clean; see Section 2.3 (cannibalizing circuits) for details.
<a id="path-spec.txt-2.1.3"></a>
-### Relays build circuits for testing reachability and bandwidth
+## Relays build circuits for testing reachability and bandwidth
Tor relays test reachability of their ORPort once they have
successfully built a circuit (on startup and whenever their IP address
@@ -137,13 +137,13 @@ this purpose.
<a id="path-spec.txt-2.1.4"></a>
-### Hidden-service circuits
+## Hidden-service circuits
See section 4 below.
<a id="path-spec.txt-2.1.5"></a>
-### Rate limiting of failed circuits
+## Rate limiting of failed circuits
If we fail to build a circuit N times in a X second period (see Section
2.3 for how this works), we stop building circuits until the X seconds
@@ -152,7 +152,7 @@ XXXX
<a id="path-spec.txt-2.1.6"></a>
-### When to tear down circuits
+## When to tear down circuits
Clients should tear down circuits (in general) only when those circuits
have no streams on them. Additionally, clients should tear-down