summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMike Perry <mikeperry-git@fscked.org>2009-12-29 04:17:12 +0100
committerMike Perry <mikeperry-git@fscked.org>2010-02-18 09:08:31 -0800
commitac68704f07c2b70321b72e3b8665cb6d12da7e6b (patch)
tree2c8d329bd53f299e710a16eee4bb5662a0dd6c16 /doc
parent8512e337734a1eb8746df8500ec0f1f8b1fdc5e8 (diff)
downloadtor-ac68704f07c2b70321b72e3b8665cb6d12da7e6b.tar.gz
tor-ac68704f07c2b70321b72e3b8665cb6d12da7e6b.zip
Allow "EXTENDCIRCUIT 0" to omit a path.
Diffstat (limited to 'doc')
-rw-r--r--doc/spec/control-spec.txt19
1 files changed, 12 insertions, 7 deletions
diff --git a/doc/spec/control-spec.txt b/doc/spec/control-spec.txt
index 4057ffa741..7d3312a5a8 100644
--- a/doc/spec/control-spec.txt
+++ b/doc/spec/control-spec.txt
@@ -606,15 +606,20 @@
3.10. EXTENDCIRCUIT
Sent from the client to the server. The format is:
- "EXTENDCIRCUIT" SP CircuitID SP
- ServerSpec *("," ServerSpec)
- [SP "purpose=" Purpose] CRLF
+ "EXTENDCIRCUIT" SP CircuitID
+ [SP ServerSpec *("," ServerSpec)
+ SP "purpose=" Purpose] CRLF
This request takes one of two forms: either the CircuitID is zero, in
- which case it is a request for the server to build a new circuit according
- to the specified path, or the CircuitID is nonzero, in which case it is a
- request for the server to extend an existing circuit with that ID according
- to the specified path.
+ which case it is a request for the server to build a new circuit,
+ or the CircuitID is nonzero, in which case it is a request for the
+ server to extend an existing circuit with that ID according to the
+ specified path.
+
+ If the CircuitID is 0, the controller has the option of providing
+ a path for Tor to use to build the circuit. If it does not provide
+ a path, Tor will select one automatically from high capacity nodes
+ according to path-spec.txt.
If CircuitID is 0 and "purpose=" is specified, then the circuit's
purpose is set. Two choices are recognized: "general" and