[tor-commits] [torspec/master] Describe revised TAKEOWNERSHIP shutdown behavior

[nickm at torproject.org]

commit faac8a4129af1226b8321f7b49450e27cbbc4a28
Author: Nick Mathewson <nickm at torproject.org>
Date:   Mon Feb 3 12:56:50 2014 -0500

    Describe revised TAKEOWNERSHIP shutdown behavior
---
 control-spec.txt |    8 ++++++--
 1 file changed, 6 insertions(+), 2 deletions(-)

diff --git a/control-spec.txt b/control-spec.txt
index 9d1df49..b94653a 100644
--- a/control-spec.txt
+++ b/control-spec.txt
@@ -1072,13 +1072,17 @@
   The syntax is:
     "TAKEOWNERSHIP" CRLF
 
-  This command instructs Tor to shut down (as if it had received
-  SIGINT or a "SIGNAL INT" controller command) when this control
+  This command instructs Tor to shut down when this control
   connection is closed.  This command affects each control connection
   that sends it independently; if multiple control connections send
   the TAKEOWNERSHIP command to a Tor instance, Tor will shut down when
   any of those connections closes.
 
+  (As of Tor 0.2.5.2-alpha, Tor does not wait a while for circuits to
+  close when shutting down because of an exiting controller.  If you
+  want to ensure a clean shutdown--and you should!--then send "SIGNAL
+  SHUTDOWN" and wait for the Tor process to close.)
+
   This command is intended to be used with the
   __OwningControllerProcess configuration option.  A controller that
   starts a Tor process which the user cannot easily control or stop