summary refs log tree commit diff
path: root/doc/runit.8.html
diff options
context:
space:
mode:
authorGerrit Pape <pape@smarden.org>2002-01-29 18:56:36 +0000
committerGerrit Pape <pape@smarden.org>2002-01-29 18:56:36 +0000
commitfe39ac56e1cedc88828ffaacab18cdc747d04626 (patch)
tree807a4e2325b9307155911a85515a33d8e29d3bb2 /doc/runit.8.html
parent586824b9a97781004b8d5f5beaa81a156c5148d7 (diff)
downloadrunit-fe39ac56e1cedc88828ffaacab18cdc747d04626.tar.gz
runit-fe39ac56e1cedc88828ffaacab18cdc747d04626.tar.xz
runit-fe39ac56e1cedc88828ffaacab18cdc747d04626.zip
0.3.0.
many changes, see package/CHANGES.
Diffstat (limited to 'doc/runit.8.html')
-rw-r--r--doc/runit.8.html45
1 files changed, 24 insertions, 21 deletions
diff --git a/doc/runit.8.html b/doc/runit.8.html
index 92596b1..8eed895 100644
--- a/doc/runit.8.html
+++ b/doc/runit.8.html
@@ -18,31 +18,34 @@ as Unix process no 1. It performs the system's booting, running, and shutdown
 in three Stages: 
 <H2><A NAME="sect3">Stage 1</A></H2>
 <B>runit</B> runs <I>/etc/runit/1</I> and waits for it to terminate.
-The system's one time tasks are done here. 
+The system's one time tasks are done here. <I>/etc/runit/1</I> has full control
+of <I>/dev/console</I> to be able to start an emergency shell if the one time
+initialization tasks fail. If <I>/etc/runit/1</I> itself crashes, <B>runit</B> will skip
+stage 2 and enter stage 3. 
 <H2><A NAME="sect4">Stage 2</A></H2>
-<B>runit</B> runs <I>/etc/runit/2</I>,
-which should not return until system shutdown; if it crashes, it will be
-restarted. Normally <I>/etc/runit/2</I> starts <B><I>svscanboot</B>(8)</I>. <B>runit</B> is able to handle
-the ctrl-alt-del keyboard request in Stage 2, see below. 
+<B>runit</B> runs <I>/etc/runit/2</I>, which should
+not return until system shutdown; if it crashes, it will be restarted. Normally
+<I>/etc/runit/2</I> starts <B><I>svscanboot</B>(8)</I>. <B>runit</B> is able to handle the ctrl-alt-del
+keyboard request in Stage 2, see below. 
 <H2><A NAME="sect5">Stage 3</A></H2>
-If <B>runit</B> is
-told to shutdown the system, or the Stage 2 returns without errors, it
-terminates Stage 2 if it is running, and runs <I>/etc/runit/3</I>. The systems
-tasks to shutdown and halt or reboot are done here. Normally in Stage 3
-<I>/etc/runit/3</I> checks for the file <I>/etc/runit/reboot</I>. If it exists, the system
-is rebooted, it is halted otherwise. 
+If <B>runit</B> is told to shutdown
+the system, or the Stage 2 returns without errors, it terminates Stage
+2 if it is running, and runs <I>/etc/runit/3</I>. The systems tasks to shutdown
+and halt or reboot are done here. Normally in Stage 3 <I>/etc/runit/3</I> checks
+for the file <I>/etc/runit/reboot</I>. If it exists, the system is rebooted, it
+is halted otherwise. 
 <H2><A NAME="sect6">Ctrl-alt-del</A></H2>
-If <B>runit</B> receives the ctrl-alt-del
-keyboard request and the file <I>/etc/runit/ctrlaltdel</I> exists, <B>runit</B> runs
-<I>/etc/runit/ctrlaltdel</I>, waits for it to terminate and then sends itself
-a CONT signal. 
+If <B>runit</B> receives the ctrl-alt-del keyboard
+request and the file <I>/etc/runit/ctrlaltdel</I> exists, <B>runit</B> runs <I>/etc/runit/ctrlaltdel</I>,
+waits for it to terminate and then sends itself a CONT signal. 
 <H2><A NAME="sect7">Signals</A></H2>
-<B>runit</B> only accepts signals in Stage 2. <P>
-If <B>runit</B> receives
-a CONT signal and the file <I>/etc/runit/stopit</I> exists, <B>runit</B> is told to shutdown
-the system. <P>
-if <B>runit</B> receives an INT signal, a ctrl-alt-del keyboard request
-is triggered. 
+<B>runit</B>
+only accepts signals in Stage 2. <P>
+If <B>runit</B> receives a CONT signal and the
+file <I>/etc/runit/stopit</I> exists, <B>runit</B> is told to shutdown the system. <P>
+if
+<B>runit</B> receives an INT signal, a ctrl-alt-del keyboard request is triggered.
+
 <H2><A NAME="sect8">See Also</A></H2>
 <I>runit-init(8)</I>, <I>svwaitdown(8)</I>, <I>svwaitup(8)</I> <P>
 <I>http://smarden.org/runit/</I>