aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorJohn Brooks <john.brooks@dereferenced.net>2010-11-14 14:33:55 -0800
committerNick Mathewson <nickm@torproject.org>2010-11-19 15:49:54 -0500
commit7441999738e7c1b0ea94a39dd6e1f8a48043ff7d (patch)
tree7dc6314277e4f9cd412de4946663a3e259c56bca /doc
parent4f66bf4fe7ec4c52ba97a81c40cf824a8ccb6cbb (diff)
downloadtor-7441999738e7c1b0ea94a39dd6e1f8a48043ff7d.tar.gz
tor-7441999738e7c1b0ea94a39dd6e1f8a48043ff7d.zip
Add a SIGNAL event for control connections
Implements ticket #1955
Diffstat (limited to 'doc')
-rw-r--r--doc/spec/control-spec.txt19
1 files changed, 18 insertions, 1 deletions
diff --git a/doc/spec/control-spec.txt b/doc/spec/control-spec.txt
index 2bbcfaec4c..2b1b9d4e0e 100644
--- a/doc/spec/control-spec.txt
+++ b/doc/spec/control-spec.txt
@@ -228,7 +228,7 @@
"INFO" / "NOTICE" / "WARN" / "ERR" / "NEWDESC" / "ADDRMAP" /
"AUTHDIR_NEWDESCS" / "DESCCHANGED" / "STATUS_GENERAL" /
"STATUS_CLIENT" / "STATUS_SERVER" / "GUARD" / "NS" / "STREAM_BW" /
- "CLIENTS_SEEN" / "NEWCONSENSUS" / "BUILDTIMEOUT_SET"
+ "CLIENTS_SEEN" / "NEWCONSENSUS" / "BUILDTIMEOUT_SET" / "SIGNAL"
Any events *not* listed in the SETEVENTS line are turned off; thus, sending
SETEVENTS with an empty body turns off all event reporting.
@@ -1708,6 +1708,23 @@
[First added in 0.2.2.7-alpha]
+4.1.17. Signal received
+
+ The syntax is:
+ "650" SP "SIGNAL" SP Signal CRLF
+
+ Signal = "RELOAD" / "DUMP" / "DEBUG" / "NEWNYM" / "CLEARDNSCACHE"
+
+ A signal has been received and actions taken by Tor. The meaning of each
+ signal, and the mapping to Unix signals, is as defined in section 3.7.
+ If Tor chose to ignore a signal (such as NEWNYM), this event will not be
+ sent.
+
+ Note that the HALT (SIGTERM) and SHUTDOWN (SIGINT) signals do not currently
+ generate any event.
+
+ [First added in X.X.X.X-alpha]
+
5. Implementation notes
5.1. Authentication