aboutsummaryrefslogtreecommitdiff
path: root/spec/tor-spec/create-created-cells.md
diff options
context:
space:
mode:
Diffstat (limited to 'spec/tor-spec/create-created-cells.md')
-rw-r--r--spec/tor-spec/create-created-cells.md9
1 files changed, 8 insertions, 1 deletions
diff --git a/spec/tor-spec/create-created-cells.md b/spec/tor-spec/create-created-cells.md
index a6d36a9..56134e4 100644
--- a/spec/tor-spec/create-created-cells.md
+++ b/spec/tor-spec/create-created-cells.md
@@ -1,4 +1,5 @@
<a id="tor-spec.txt-5.1"></a>
+
## CREATE and CREATED cells
Users set up circuits incrementally, one hop at a time. To create a
@@ -69,6 +70,7 @@ DESTROY cell to tear down the circuit.
[CREATE2 is handled by Tor 0.2.4.7-alpha and later.]
<a id="tor-spec.txt-5.1.1"></a>
+
### Choosing circuit IDs in create cells
The CircID for a CREATE/CREATE2 cell is a nonzero integer, selected
@@ -102,6 +104,7 @@ attempting to build new circuits on a channel, if a certain number of
randomly chosen CircID values are all in use (today's Tor stops after 64).
<a id="tor-spec.txt-5.1.2"></a>
+
### EXTEND and EXTENDED cells
To extend an existing circuit, the client sends an EXTEND or EXTEND2
@@ -202,6 +205,7 @@ When encoding a non-TAP handshake in an EXTEND cell, clients SHOULD
use the format with 'client handshake type tag'.
<a id="tor-spec.txt-5.1.3"></a>
+
### The "TAP" handshake
This handshake uses Diffie-Hellman in Z_p and RSA to compute a set of
@@ -255,6 +259,7 @@ Once both parties have g^xy, they derive their shared circuit keys
and 'derivative key data' value via the KDF-TOR function in 5.2.1.
<a id="tor-spec.txt-5.1.4"></a>
+
### The "ntor" handshake
This handshake uses a set of DH handshakes to compute a set of
@@ -333,6 +338,7 @@ into the keys needed for the Tor relay protocol, using the KDF
described in 5.2.2 and the tag m_expand.
<a id="tor-spec.txt-5.1.4.1"></a>
+
#### The "ntor-v3" handshake
This handshake extends the ntor handshake to include support
@@ -488,6 +494,7 @@ Now both parties share the same KEYSTREAM, and can use it to generate
their circuit keys.
<a id="tor-spec.txt-5.1.5"></a>
+
### CREATE_FAST/CREATED_FAST cells
When initializing the first hop of a circuit, the OP has already
@@ -521,6 +528,7 @@ networkstatus parameter as described in dir-spec.txt.
[Tor 0.3.1.1-alpha and later disable CREATE_FAST by default.]
<a id="tor-spec.txt-5.1.6"></a>
+
### Additional data in CREATE/CREATED cells
Some handshakes (currently ntor-v3 defined above) allow the client or the
@@ -571,4 +579,3 @@ format:
sendme_inc [1 byte]
```
-