Convert text specifications to mdbook.

1 files changed, 20 insertions, 0 deletions

diff --git a/spec/tor-spec/handling-relay_early-cells.md b/spec/tor-spec/handling-relay_early-cells.md
new file mode 100644
index 0000000..e88c946
--- /dev/null
+++ b/spec/tor-spec/handling-relay_early-cells.md
@@ -0,0 +1,20 @@
+<a id="tor-spec.txt-5.6"></a>
+## Handling relay_early cells
+
+A RELAY_EARLY cell is designed to limit the length any circuit can reach.
+When an OR receives a RELAY_EARLY cell, and the next node in the circuit
+is speaking v2 of the link protocol or later, the OR relays the cell as a
+RELAY_EARLY cell.  Otherwise, older Tors will relay it as a RELAY cell.
+
+If a node ever receives more than 8 RELAY_EARLY cells on a given
+outbound circuit, it SHOULD close the circuit. If it receives any
+inbound RELAY_EARLY cells, it MUST close the circuit immediately.
+
+When speaking v2 of the link protocol or later, clients MUST only send
+EXTEND/EXTEND2 cells inside RELAY_EARLY cells.  Clients SHOULD send the first
+~8 RELAY cells that are not targeted at the first hop of any circuit as
+RELAY_EARLY cells too, in order to partially conceal the circuit length.
+
+[Starting with Tor 0.2.3.11-alpha, relays should reject any
+EXTEND/EXTEND2 cell not received in a RELAY_EARLY cell.]
+