Initial revision

4 files changed, 172 insertions, 0 deletions

diff --git a/man/runit-halt.8 b/man/runit-halt.8
new file mode 100644
index 0000000..b99acf6
--- /dev/null
+++ b/man/runit-halt.8
@@ -0,0 +1,35 @@
+.TH runit-halt 8
+.SH NAME
+runit-halt \- stop the system
+.SH SYNOPSIS
+.B init
+0
+.br
+.B runit-halt
+.SH DESCRIPTION
+.B runit-halt
+causes the Unix process no 1
+.BR runit (8)
+to halt the system. Normally
+.B runit-halt
+is run by
+.BR runit-init (8)
+if called as
+.B init 0\fR.
+.P
+To signal
+.BR runit (8)
+the system halt request,
+.B runit-halt
+removes the /etc/runit/reboot file and touches /etc/runit/stopit. Then a CONT
+signal is sent to
+.BR runit (8).
+.SH EXIT CODES
+.B runit-halt
+always returns 0.
+.SH SEE ALSO
+runit-init(8),
+runit(8),
+runit-reboot(8)
+.SH AUTHOR
+Gerrit Pape <pape@smarden.org>
diff --git a/man/runit-init.8 b/man/runit-init.8
new file mode 100644
index 0000000..dd8ffe6
--- /dev/null
+++ b/man/runit-init.8
@@ -0,0 +1,38 @@
+.TH runit-init 8
+.SH NAME
+init \- the UNIX process no 1
+.SH SYNOPSIS
+.B init
+[ 0 | 6 ]
+.SH DESCRIPTION
+.B runit-init
+is the first process the kernel starts. If
+.B runit-init
+is started as process no 1, it runs and replaces itself with
+.BR runit (8).
+.P
+If
+.B runit-init
+is started while the system is up, it must be either called as
+.B init 0
+or
+.B init 6\fR:
+.TP
+.B init 0
+run
+.BR runit-halt (8)
+to halt the system.
+.TP
+.B init 6
+run
+.BR runit-reboot (8)
+to reboot the system.
+.SH EXIT CODES
+.B runit-init
+returns 111 on error, 0 in all other cases.
+.SH SEE ALSO
+runit(8),
+runit-halt(8),
+runit-reboot(8)
+.SH AUTHOR
+Gerrit Pape <pape@smarden.org>
diff --git a/man/runit-reboot.8 b/man/runit-reboot.8
new file mode 100644
index 0000000..d5ce1ea
--- /dev/null
+++ b/man/runit-reboot.8
@@ -0,0 +1,35 @@
+.TH runit-reboot 8
+.SH NAME
+runit-reboot \- reboot the system
+.SH SYNOPSIS
+.B init
+6
+.br
+.B runit-reboot
+.SH DESCRIPTION
+.B runit-reboot
+causes the Unix process no 1
+.BR runit (8)
+to reboot the system. Normally
+.B runit-reboot
+is run by
+.BR runit-init (8)
+if called as
+.B init 6\fR.
+.P
+To signal
+.BR runit (8)
+the system reboot request,
+.B runit-reboot
+touches the /etc/runit/reboot and /etc/runit/stopit files. Then a CONT
+signal is sent to
+.BR runit (8).
+.SH EXIT CODES
+.B runit-reboot
+always returns 0.
+.SH SEE ALSO
+runit-init(8),
+runit(8),
+runit-halt(8)
+.SH AUTHOR
+Gerrit Pape <pape@smarden.org>
diff --git a/man/runit.8 b/man/runit.8
new file mode 100644
index 0000000..e14786d
--- /dev/null
+++ b/man/runit.8
@@ -0,0 +1,64 @@
+.TH runit 8
+.SH NAME
+runit \- the UNIX process no 1
+.SH SYNOPSIS
+.B runit
+.SH DESCRIPTION
+.B runit
+must be run as Unix process no 1. It performs the system's
+booting, running and shutdown in three stages:
+.SH STAGE 1
+.B runit
+runs
+.I /etc/runit/1
+and waits for it to terminate. The system's one time tasks are done here.
+.SH STAGE 2
+.B runit
+runs
+.IR /etc/runit/2 ,
+which should not return until system shutdown. Normally
+.I /etc/runit/2
+starts
+.BR svscanboot (8).
+.B runit
+is able to handle the ctrl-alt-del keyboard request in stage 2, see below.
+.SH STAGE 3
+If
+.B runit
+is told to halt or reboot the system, or the Stage 2
+returns without errors, it terminates Stage 2 if it is running and runs
+.IR /etc/runit/3 .
+The systems tasks to shutdown and halt or reboot are done here.
+.SH CTRL-ALT-DEL
+If
+.B runit
+receives the ctrl-alt-del keyboard request and the file
+.I /etc/runit/ctrlaltdel
+exists,
+.B runit
+runs
+.IR /etc/runit/ctrlaltdel ,
+waits for it to terminate and then enters stage 3 for system shutdown.
+.SH SIGNALS
+.B runit
+only accepts signals in stage 2.
+.P
+If
+.B runit
+receives a CONT signal and the file
+.I /etc/runit/stopit
+exists,
+.B runit
+is told to shutdown the system.
+.P
+Normally in stage 3
+.I /etc/runit/3
+checks for the file
+.IR /etc/runit/reboot .
+If it exists, the system is rebooted, it is halted otherwise.
+.SH SEE ALSO
+init(8),
+runit-halt(8),
+runit-reboot(8)
+.SH AUTHOR
+Gerrit Pape <pape@smarden.org>