aboutsummaryrefslogtreecommitdiff
path: root/control-spec.txt
diff options
context:
space:
mode:
authorNick Mathewson <nickm@torproject.org>2018-11-19 16:41:19 -0500
committerNick Mathewson <nickm@torproject.org>2018-11-19 16:41:19 -0500
commit4421149986369b4f746fc02a5d78c7337fe5d4ea (patch)
treee0ba63b003154ffb1a09e78d143b493cb19ef134 /control-spec.txt
parent43ad5143d46c68d0eff81393f6f8e55659eee902 (diff)
downloadtorspec-4421149986369b4f746fc02a5d78c7337fe5d4ea.tar.gz
torspec-4421149986369b4f746fc02a5d78c7337fe5d4ea.zip
Describe SIGNAL ACTIVE and SIGNAL DORMANT.
Diffstat (limited to 'control-spec.txt')
-rw-r--r--control-spec.txt10
1 files changed, 9 insertions, 1 deletions
diff --git a/control-spec.txt b/control-spec.txt
index 6a04b65..ae4a417 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -430,7 +430,7 @@
Signal = "RELOAD" / "SHUTDOWN" / "DUMP" / "DEBUG" / "HALT" /
"HUP" / "INT" / "USR1" / "USR2" / "TERM" / "NEWNYM" /
- "CLEARDNSCACHE" / "HEARTBEAT"
+ "CLEARDNSCACHE" / "HEARTBEAT" / "ACTIVE" / "DORMANT"
The meaning of the signals are:
@@ -448,6 +448,12 @@
the client-side DNS cache. (Tor MAY rate-limit its
response to this signal.)
HEARTBEAT -- Make Tor dump an unscheduled Heartbeat message to log.
+ DORMANT -- Tell Tor to become "dormant". A dormant Tor will
+ try to avoid CPU and network usage until it receives
+ user-initiated network request. (Don't use this
+ on relays or hidden services yet!)
+ ACTIVE -- Tell Tor to stop being "dormant", as if it had received
+ a user-initiated network request.
The server responds with "250 OK" if the signal is recognized (or simply
closes the socket if it was asked to close immediately), or "552
@@ -463,6 +469,8 @@
DUMP: USR1
DEBUG: USR2
+ [SIGNAL DORMANT and SIGNAL ACTIVE were added in 0.4.0.1-alpha.]
+
3.8. MAPADDRESS
Sent from the client to the server. The syntax is: