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

                                                                                         runit(8)