From 32a5a5e91bd78795f546e2a8b8b775f1e1989ed9 Mon Sep 17 00:00:00 2001 From: Eric Wong Date: Mon, 9 Mar 2009 15:29:59 -0700 Subject: Documentation updates Reformat README to avoid preformatted text. Document signal handling in SIGNALS. Split out DESIGN, it's probably not as useful to end-users Update CONTRIBUTORS LICENSE: copyright is for me (Eric Wong), not Zed since this is a Mongrel fork. --- SIGNALS | 34 ++++++++++++++++++++++++++++++++++ 1 file changed, 34 insertions(+) create mode 100644 SIGNALS (limited to 'SIGNALS') diff --git a/SIGNALS b/SIGNALS new file mode 100644 index 0000000..40f9c3d --- /dev/null +++ b/SIGNALS @@ -0,0 +1,34 @@ +== Signal handling + +In general, signals need only be sent to the master process. However, +the signals unicorn uses internally to communicate with the worker +processes are documented here as well. + +=== Master Process + + * HUP - reload config file and gracefully restart all workers + + * INT/TERM - quick shutdown, kills all workers immediately + + * QUIT - graceful shutdown, waits for workers to finish their + current request before finishing. + + * USR1 - reopen all logs owned by the master and all workers + See Unicorn::Util.reopen_logs for what is considered a log. + + * USR2 - reexecute the running binary. A separate QUIT + should be sent to the original process once the child is verified to + be up and running. + +=== Worker Processes + +Sending signals directly to the worker processes should not normally be +needed. If the master process is running, any exited worker will be +automatically respawned. + + * INT/TERM - quick shutdown, immediately exit + + * QUIT - gracefully exit after finishing the current request + + * USR1 - reopen all logs owned by the worker process + See Unicorn::Util.reopen_logs for what is considered a log. -- cgit v1.2.3-24-ge0c7