Manual Reference Pages - RUNIT (8)
runit - a UNIX process no 1
runit must be run as Unix process no 1.
It performs the systems booting, running, and shutdown in three stages:
/etc/runit/1 and waits for it to terminate.
The systems 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
/etc/runit/1 crashes, or exits 100,
runit will skip stage 2 and enter stage 3.
/etc/runit/2, which should not return until system shutdown; if it crashes, or exits 111,
it will be restarted.
runit is able to handle the ctrl-alt-del keyboard request in stage 2, see below.
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 reboot the system are
If stage 3 returns,
runit checks if the file
/etc/runit/reboot exists and has the execute by owner permission set.
If so, the system is rebooted, its halted otherwise.
runit receives the ctrl-alt-del keyboard request and the file
/etc/runit/ctrlaltdel exists and has the execute by owner permission set,
/etc/runit/ctrlaltdel, waits for it to terminate, and then sends itself a CONT signal.
runit only accepts signals in stage 2.
runit receives a CONT signal and the file
/etc/runit/stopit exists and has the execute by owner permission set,
runit is told to shutdown the system.
runit receives an INT signal, a ctrl-alt-del keyboard request is triggered.
Gerrit Pape <firstname.lastname@example.org>
Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.