bionic (8) runsvdir.8.gz

Provided by: runit_2.1.2-9.2ubuntu1_amd64 bug

NAME

       runsvdir - starts and monitors a collection of runsv(8) processes

SYNOPSIS

       runsvdir [-P] dir [ log ]

DESCRIPTION

       dir  must  be  a  directory.   log  is a space holder for a readproctitle log, and must be at least seven
       characters long or absent.

       runsvdir starts a runsv(8) process for each subdirectory, or symlink to  a  directory,  in  the  services
       directory  dir,  up  to a limit of 1000 subdirectories, and restarts a runsv(8) process if it terminates.
       runsvdir skips subdirectory names starting with dots.  runsv(8) must be in runsvdir's PATH.

       At least every five seconds runsvdir checks whether the time of last  modification,  the  inode,  or  the
       device,  of  the services directory dir has changed.  If so, it re-scans the service directory, and if it
       sees a new subdirectory, or new symlink to a directory, in dir, it starts  a  new  runsv(8)  process;  if
       runsvdir sees a subdirectory being removed that was previously there, it sends the corresponding runsv(8)
       process a TERM signal, stops monitoring this process, and so does not restart the runsv(8) process if  it
       exits.

       If  the  log argument is given to runsvdir, all output to standard error is redirected to this log, which
       is similar to the daemontools' readproctitle log.  To see the most recent error messages, use a  process-
       listing  tool such as ps(1).  runsvdir writes a dot to the readproctitle log every 15 minutes so that old
       error messages expire.

OPTIONS

       -P     use setsid(2) to run each runsv(8) process in a new session and separate process group.

SIGNALS

       If runsvdir receives a TERM signal, it exits with 0 immediately.

       If runsvdir receives a HUP signal, it sends a TERM signal to each runsv(8) process it is  monitoring  and
       then exits with 111.

SEE ALSO

       sv(8), runsv(8), runsvchdir(8), runit(8), runit-init(8), chpst(8), svlogd(8), utmpset(8), setsid(2)

       http://smarden.org/runit/

AUTHOR

       Gerrit Pape <pape@smarden.org>

                                                                                                     runsvdir(8)