Poster of Linux kernelThe best gift for a Linux geek
runit

runit

Section: Maintenance Commands (8)
Local index Up
 

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 shutdown 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>


 

Index

NAME
SYNOPSIS
DESCRIPTION
STAGE 1
STAGE 2
STAGE 3
CTRL-ALT-DEL
SIGNALS
SEE ALSO
AUTHOR

This document was created by man2html, using the manual pages.
Time: 22:02:17 GMT, April 16, 2011