commit faac8a4129af1226b8321f7b49450e27cbbc4a28 Author: Nick Mathewson <nickm@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