GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages
runit(8) FreeBSD System Manager's Manual runit(8)

runit - a UNIX process no 1

runit

runit must be run as Unix process no 1. It performs the system's booting, running, and shutdown in three stages:

runit runs /usr/local/etc/runit/1 and waits for it to terminate. The system's one time tasks are done here. /usr/local/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 /usr/local/etc/runit/1 crashes, or exits 100, runit will skip stage 2 and enter stage 3.

runit runs /usr/local/etc/runit/2, which should not return until system shutdown; if it crashes, or exits 111, it will be restarted. Normally /usr/local/etc/runit/2 starts runsvdir(8). runit is able to handle the ctrl-alt-del keyboard request in stage 2, see below.

If runit is told to shutdown the system, or stage 2 returns, it terminates stage 2 if it is running, and runs /usr/local/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 /usr/local/etc/runit/reboot exists and has the execute by owner permission set. If so, the system is rebooted, it's halted otherwise.

If runit receives the ctrl-alt-del keyboard request and the file /usr/local/etc/runit/ctrlaltdel exists and has the execute by owner permission set, runit runs /usr/local/etc/runit/ctrlaltdel, waits for it to terminate, and then sends itself a CONT signal.

runit only accepts signals in stage 2.

If runit receives a CONT signal and the file /usr/local/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.

runit-init(8), runsvdir(8), runsvchdir(8), sv(8), runsv(8), chpst(8), utmpset(8), svlogd(8)

http://smarden.org/runit/

Gerrit Pape <pape@smarden.org>

Search for    or go to Top of page |  Section 8 |  Main Index

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with ManDoc.