diff options
Diffstat (limited to 'doc/runsvdir.8.html')
| -rw-r--r-- | doc/runsvdir.8.html | 56 |
1 files changed, 28 insertions, 28 deletions
diff --git a/doc/runsvdir.8.html b/doc/runsvdir.8.html index 624c89c..73c97c8 100644 --- a/doc/runsvdir.8.html +++ b/doc/runsvdir.8.html @@ -15,36 +15,36 @@ runsvdir - starts and monitors a collection of <i>runsv(8)</i> processes <i>dir</i> [ <i>log</i> ] <h2><a name='sect2'>Description</a></h2> <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. <p> -<b>runsvdir</b> -starts a <i><b>runsv</b>(8)</i> process for each subdirectory in <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. <p> -At least every five seconds, <b>runsvdir</b> -checks if <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 <i><b>readproctitle</b>(8)</i> 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. <p> -Normally <b>runsvdir</b> -is started by <i><b>runit</b>(8)</i> in stage 2. +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 <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. <p> +At least every five seconds, +<b>runsvdir</b> checks if <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 <i><b>readproctitle</b>(8)</i> 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. <p> +Normally <b>runsvdir</b> is started by <i><b>runit</b>(8)</i> in stage 2. <h2><a name='sect3'>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='sect4'>See Also</a></h2> -<i>runsvchdir(8)</i>, <i>runsv(8)</i>, <i>runsvctrl(8)</i>, <i>runsvstat(8)</i>, <i>runit(8)</i>, -<i>runit-init(8)</i>, <i>svlogd(8)</i>, <i>svwaitdown(8)</i>, <i>svwaitup(8)</i>, <p> -<i>http://smarden.org/runit/</i> - +<i>runsvchdir(8)</i>, <i>runsv(8)</i>, <i>runsvctrl(8)</i>, +<i>runsvstat(8)</i>, <i>runit(8)</i>, <i>runit-init(8)</i>, <i>svlogd(8)</i>, <i>svwaitdown(8)</i>, <i>svwaitup(8)</i>, +<p> +<i>http://smarden.org/runit/</i> <h2><a name='sect5'>Author</a></h2> Gerrit Pape <pape@smarden.org> <p> |