summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorRoger Dingledine <arma@torproject.org>2007-10-12 07:57:29 +0000
committerRoger Dingledine <arma@torproject.org>2007-10-12 07:57:29 +0000
commit3977ccbc804fdeab5f6f8d680aeec7d038bf9cbb (patch)
tree01580d9fc881ee06d1c7428a386ee02f07f1b551 /doc
parentad8757fbeb564b7d15edf9f016c634b89f017584 (diff)
downloadtor-3977ccbc804fdeab5f6f8d680aeec7d038bf9cbb.tar.gz
tor-3977ccbc804fdeab5f6f8d680aeec7d038bf9cbb.zip
Controllers should now specify cache=no or cache=yes when using
the +POSTDESCRIPTOR command. svn:r11892
Diffstat (limited to 'doc')
-rw-r--r--doc/spec/control-spec.txt8
1 files changed, 7 insertions, 1 deletions
diff --git a/doc/spec/control-spec.txt b/doc/spec/control-spec.txt
index b57de5583c..69f72818b6 100644
--- a/doc/spec/control-spec.txt
+++ b/doc/spec/control-spec.txt
@@ -635,12 +635,18 @@ $Id$
3.14. POSTDESCRIPTOR
Sent from the client to the server. The syntax is:
- "+POSTDESCRIPTOR" [SP "purpose=" Purpose] CRLF Descriptor CRLF "." CRLF
+ "+POSTDESCRIPTOR" [SP "purpose=" Purpose] [SP "cache=" Cache]
+ CRLF Descriptor CRLF "." CRLF
This message informs the server about a new descriptor. If Purpose is
specified, it must be either "general" or "controller", else we
return a 552 error.
+ If Cache is specified, it must be either "no" or "yes", else we
+ return a 552 error. If Cache is not specified, Tor will decide for
+ itself whether it wants to cache the descriptor, and controllers
+ must not rely on its choice.
+
The descriptor, when parsed, must contain a number of well-specified
fields, including fields for its nickname and identity.