diff options
Diffstat (limited to 'doc/runsv.8.html')
-rw-r--r-- | doc/runsv.8.html | 20 |
1 files changed, 17 insertions, 3 deletions
diff --git a/doc/runsv.8.html b/doc/runsv.8.html index d27deeb..04f299e 100644 --- a/doc/runsv.8.html +++ b/doc/runsv.8.html @@ -115,15 +115,29 @@ to send a TERM signal to the socklog-unix service, either do # sv term <i><b>printf</b>(1)</i> usually blocks if no <b>runsv</b> process is running in the service directory. <h2><a name='sect4'>Customize Control</a></h2> -For each control character <i>c</i> sent to the control +For each control character <i>c</i> except "d" and "x" sent to the control pipe, <b>runsv</b> first checks if <i>service</i>/control/<i>c</i> exists and is executable. If so, it starts <i>service</i>/control/<i>c</i> and waits for it to terminate, before interpreting the command. If the program exits with return code 0, <b>runsv</b> refrains from sending the service the corresponding signal. The command <i>o</i> is always considered as command <i>u</i>. On command <i>d</i> first <i>service</i>/control/<i>t</i> is checked, and then <i>service</i>/control/<i>d</i>. On command <i>x</i> first <i>service</i>/control/<i>t</i> -is checked, and then <i>service</i>/control/<i>x</i>. The control of the optional log -service cannot be customized. +is checked, and then <i>service</i>/control/<i>x</i>. Specifically:<br> +<p> +<dt><b>1.</b> </dt> +<dd><b>runsv</b> checks whether <i>service</i>/control/<i>t</i> exists and is executable and runs it if yes.</dd> + +<dt><b>2.</b> </dt> +<dd>If <i>service</i>/control/<i>t</i> exits nonzero, or is not executable or doesn't exist, <b>runsv</b> sends + the service a TERM signal.</dd> + +<dt><b>3.</b> </dt> +<dd><b>runsv</b> sends the service a CONT signal, disregarding <i>service</i>/control/<i>c</i> even if it exists and is executable.</dd> + +<dt><b>4.</b> </dt> +<dd><b>runsv</b> checks whether <i>service</i>/control/<i>d</i> (or control/<i>x</i>) exists and is executable and runs it if yes. Its exit status is ignored.</dd> +<p> +The control of the optional log service cannot be customized. <h2><a name='sect5'>Signals</a></h2> If <b>runsv</b> receives a TERM signal, it acts as if the character x was written to the control pipe. |