info > runsvdir(8)

man perldoc info pydoc3 ri search

📘 NAME

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

🚀 Quick Reference

Use Case	Command	Description
🚀 Start service supervision	runsvdir /service	Start monitoring all services in /service directory
🔄 Start with process isolation	runsvdir -P /service	Run each service in a separate session/process group
📋 Start with readproctitle log	runsvdir -P /service log	Redirect stderr to a named log (7+ chars)
🔁 Reload after config change	kill -HUP $(pidof runsvdir)	Send HUP to terminate all services and exit with 111

📝 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 AT smarden.org>

📘 NAME 🚀 Quick Reference 📝 SYNOPSIS 📖 DESCRIPTION ⚙️ OPTIONS 📡 SIGNALS 📚 SEE ALSO 👤 AUTHOR