diff options
Diffstat (limited to 'doc/runsvdir.8.html')
| -rw-r--r-- | doc/runsvdir.8.html | 54 |
1 files changed, 28 insertions, 26 deletions
diff --git a/doc/runsvdir.8.html b/doc/runsvdir.8.html index 14faa1e..f4053db 100644 --- a/doc/runsvdir.8.html +++ b/doc/runsvdir.8.html @@ -17,42 +17,44 @@ runsvdir - starts and monitors a collection of <i>runsv(8)</i> processes <i>dir</i> must be a directory. <i>log</i> is a space holder for a readproctitle log, and must be at least seven characters long or absent. <p> -<b>runsvdir</b> starts a <i><b>runsv</b>(8)</i> process for each subdirectory in the -services directory <i>dir</i>, up to a limit of 1000 subdirectories. <b>runsvdir</b> skips -subdirectory names starting with dots. <i><b>runsv</b>(8)</i> must be in <b>runsvdir</b>’s PATH. +<b>runsvdir</b> starts a <i><b>runsv</b>(8)</i> process for each subdirectory, or symlink +to a directory, in the services directory <i>dir</i>, up to a limit of 1000 subdirectories, +and restarts a <i><b>runsv</b>(8)</i> process if it terminates. <b>runsvdir</b> skips subdirectory +names starting with dots. <i><b>runsv</b>(8)</i> must be in <b>runsvdir</b>’s PATH. <p> +At least every +five seconds <b>runsvdir</b> checks whether the time of last modification, the +inode, or the device, of the services directory <i>dir</i> has changed. If so, +it re-scans the service directory, and if it sees a new subdirectory, or +new symlink to a directory, in <i>dir</i>, it starts a new <i><b>runsv</b>(8)</i> process; if +<b>runsvdir</b> sees a subdirectory being removed that was previously there, it +sends the corresponding <i><b>runsv</b>(8)</i> process a TERM signal, stops monitoring +this process, and so does not restart the <i><b>runsv</b>(8)</i> process if it exits. <p> -At least every five seconds <b>runsvdir</b> checks whether the services directory -<i>dir</i> has changed. If it sees a new subdirectory in <i>dir</i>, it starts a new <i><b>runsv</b>(8)</i> -process. If it sees an old sudirectory where a <i><b>runsv</b>(8)</i> process has exited, -it restarts the <i><b>runsv</b>(8)</i> process. If <b>runsvdir</b> sees a subdirectory being -removed that was previously there, it sends the corresponding <i><b>runsv</b>(8)</i> -process a TERM signal, stops monitoring this process, and so does not restart -the <i><b>runsv</b>(8)</i> process if it exits. <p> -If the <i>log</i> argument is given to <b>runsvdir</b>, -all output to standard error is redirected to this <i>log</i>, which is similar -to the daemontools’ <b>readproctitle</b> log. To see the most recent error messages, -use a process-listing tool such as <i><b>ps</b>(1)</i>. <b>runsvdir</b> writes a dot to the readproctitle -log every 15 minutes so that old error messages expire. +If the <i>log</i> argument is given to <b>runsvdir</b>, all output to standard error +is redirected to this <i>log</i>, which is similar to the daemontools’ <b>readproctitle</b> +log. To see the most recent error messages, use a process-listing tool such +as <i><b>ps</b>(1)</i>. <b>runsvdir</b> writes a dot to the readproctitle log every 15 minutes +so that old error messages expire. <h2><a name='sect3'>Options</a></h2> <dl> <dt><b>-P</b> </dt> -<dd>use <i><b>setsid</b>(2)</i> -to run each <i><b>runsv</b>(8)</i> process in a new session and separate process group. -</dd> +<dd>use <i><b>setsid</b>(2)</i> to run each <i><b>runsv</b>(8)</i> +process in a new session and separate process group. </dd> </dl> <h2><a name='sect4'>Signals</a></h2> -If <b>runsvdir</b> receives a TERM signal, it exits with 0 immediately. -<p> -If <b>runsvdir</b> receives a HUP signal, it sends a TERM signal to each <i><b>runsv</b>(8)</i> -process it is monitoring and then exits with 111. +If <b>runsvdir</b> +receives a TERM signal, it exits with 0 immediately. <p> +If <b>runsvdir</b> receives +a HUP signal, it sends a TERM signal to each <i><b>runsv</b>(8)</i> process it is monitoring +and then exits with 111. <h2><a name='sect5'>See Also</a></h2> -<i>sv(8)</i>, <i>runsv(8)</i>, -<i>runsvchdir(8)</i>, <i>runit(8)</i>, <i>runit-init(8)</i>, <i>chpst(8)</i>, <i>svlogd(8)</i>, <i>utmpset(8)</i>, -<i>setsid(2)</i> <p> -<i>http://smarden.org/runit/</i> +<i>sv(8)</i>, <i>runsv(8)</i>, <i>runsvchdir(8)</i>, <i>runit(8)</i>, +<i>runit-init(8)</i>, <i>chpst(8)</i>, <i>svlogd(8)</i>, <i>utmpset(8)</i>, <i>setsid(2)</i> <p> +<i>http://smarden.org/runit/</i> + <h2><a name='sect6'>Author</a></h2> Gerrit Pape <pape@smarden.org> <p> |