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 reboot the system are done here.  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, it's halted otherwise.

CTRL-ALT-DEL
       If runit receives the ctrl-alt-del keyboard request and the file /etc/runit/ctrlaltdel exists 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 /etc/runit/stopit exists and has the execute by owner permission set, runit is told to shut-
       down the system.

       if runit receives an INT signal, a ctrl-alt-del keyboard request is triggered.

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@smarden.org>

                                                                                                                                          runit(8)