runit(8) System Manager's Manual runit(8) NAME runit - a UNIX process no 1 SYNOPSIS runit DESCRIPTION runit must be run as Unix process no 1. It performs the system's booting, running, and shutdown in three stages: STAGE 1 runit runs /etc/runit/1 and waits for it to terminate. The system's one time tasks are done here. /etc/runit/1 has full control of /dev/console to be able to start an emergency shell if the one time initialization tasks fail. If /etc/runit/1 crashes, or exits 100, runit will skip stage 2 and enter stage 3. STAGE 2 runit runs /etc/runit/2, which should not return until system shutdown; if it crashes, or exits 111, it will be restarted. Normally /etc/runit/2 starts runsvdir(8). runit is able to handle the ctrl-alt-del keyboard request in stage 2, see below. STAGE 3 If runit is told to shutdown the system, or stage 2 returns, it terminates stage 2 if it is running, and runs /etc/runit/3. The systems tasks to shutdown and possibly halt or re- boot the system are done here. If stage 3 returns, runit checks if the file /run/runit.reboot exists and has the execute by owner permission set. If so, the system is rebooted, it's halted otherwise. If /etc/runit/nosync exists, runit doesn't invoke sync(). This is useful in vservers. CTRL-ALT-DEL If runit receives the ctrl-alt-del keyboard request and the file /etc/runit/ctrlaltdel ex- ists and has the execute by owner permission set, runit runs /etc/runit/ctrlaltdel, waits for it to terminate, and then sends itself a CONT signal. SIGNALS runit only accepts signals in stage 2. If runit receives a CONT signal and the file /run/runit.stopit exists and has the execute by owner permission set, runit is told to shutdown the system. If runit receives a PWR signal, runit is told to shutdown the system. if runit receives an INT signal, a ctrl-alt-del keyboard request is triggered. ENVIRONMENT When the runitdir=name variable is set and runit is init, runit will check if a directory named name exists in /etc/runit/runsvdir/ and then will use runsvchdir to change the di- rectory of runsvdir to name in place of the default. If runitdir is set to runitdir=solo runit will use the solo directory for runsvdir and it will also refrain from start any sysv service that is enabled in /etc/rc2.d/ This is in- tended for use with containers that need to start only some selected services. SEE ALSO runit-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8) http://smarden.org/runit/ AUTHOR Gerrit Pape <pape AT smarden.org> runit(8)
Generated by $Id: phpMan.php,v 4.55 2007/09/05 04:42:51 chedong Exp $ Author: Che Dong
On Apache
Under GNU General Public License
2025-01-15 04:44 @3.147.49.19 CrawledBy Mozilla/5.0 AppleWebKit/537.36 (KHTML, like Gecko; compatible; ClaudeBot/1.0; +claudebot@anthropic.com)