G. Pape
runit

Name

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

Synopsis

runsvdir 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.

runsvdir starts a runsv(8) process for each subdirectory in dir, up to a limit of 1000 subdirectories. runsvdir skips subdirectory names starting with dots. runsv(8) must be in runsvdir's PATH.

At least every five seconds, runsvdir checks if dir has changed. If it sees a new subdirectory in dir, it starts a new runsv(8) process. If it sees an old sudirectory where a runsv(8) process has exited, it restarts the 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 readproctitle(8) 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.

Normally runsvdir is started by runit(8) in stage 2.

Signals

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

See Also

runit(8), runit-init(8), runsv(8), readproctitle(8), svscan(8)

http://smarden.org/runit/
http://cr.yp.to/daemontools.html

Author

Gerrit Pape <pape@smarden.org>


Table of Contents