emo/sysvinit
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Improve nroff formatting of init(8) manual page.

Browse Source 
Based on patch from Bjarni Ingi Gislason in
<URL: https://bugs.debian.org/890041 >.
This commit is contained in:
Petter Reinholdtsen 2018-02-11 09:20:47 +00:00
parent d972463609
commit 959397cf9a
1 changed files with 32 additions and 28 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

56
man/init.8
View File

@ -68,8 +68,8 @@ is not really meant to be used directly, but more for the scripts that are
executed when entering runlevel 1. For more information on this, executed when entering runlevel 1. For more information on this,
see the manpages for \fBshutdown\fP(8) and \fBinittab\fP(5). see the manpages for \fBshutdown\fP(8) and \fBinittab\fP(5).
.PP .PP
Runlevels 7-9 are also valid, though not really documented. This is Runlevels 7\(en9 are also valid, though not really documented.
because "traditional" Unix variants don't use them. This is because "traditional" Unix variants don't use them.
In case you're curious, runlevels \fIS\fP and \fIs\fP are in fact the same. In case you're curious, runlevels \fIS\fP and \fIs\fP are in fact the same.
Internally they are aliases for the same runlevel. Internally they are aliases for the same runlevel.
.\"}}} .\"}}}
@ -160,18 +160,19 @@ tell \fBinit\fP to re-examine the \fB/etc/inittab\fP file.
.IP "\fBS\fP or \fBs\fP" .IP "\fBS\fP or \fBs\fP"
tell \fBinit\fP to switch to single user mode. tell \fBinit\fP to switch to single user mode.
.IP "\fBU\fP or \fBu\fP" .IP "\fBU\fP or \fBu\fP"
tell \fBinit\fP to re-execute itself (preserving the state). No re-examining of tell \fBinit\fP to re-execute itself (preserving the state).
\fB/etc/inittab\fP file happens. Run level should be one of No re-examining of
\fBSs0123456\fP \fB/etc/inittab\fP file happens.
otherwise request would be silently ignored. Run level should be one of \fBSs0123456\fP otherwise request would be
silently ignored.
.PP .PP
\fBtelinit\fP can tell \fBinit\fP how long it should wait \fBtelinit\fP can tell \fBinit\fP how long it should wait
between sending processes the SIGTERM and SIGKILL signals. The default between sending processes the SIGTERM and SIGKILL signals. The default
is 5 seconds, but this can be changed with the \fB-t\fP option. is 5 seconds, but this can be changed with the \fB\-t\fP option.
.PP .PP
\fBtelinit -e\fP tells \fBinit\fP to change the environment \fBtelinit \-e\fP tells \fBinit\fP to change the environment
for processes it spawns. for processes it spawns.
The argument of \fB-e\fP is either of the form \fIVAR\fP=\fIVAL\fP The argument of \fB\-e\fP is either of the form \fIVAR\fP=\fIVAL\fP
which sets variable \fIVAR\fP to value \fIVAL\fP, which sets variable \fIVAR\fP to value \fIVAL\fP,
or of the form \fIVAR\fP or of the form \fIVAR\fP
(without an equality sign) (without an equality sign)
@ -201,15 +202,16 @@ The system console. This is really inherited from the kernel; however
if it is not set \fBinit\fP will set it to \fB/dev/console\fP by default. if it is not set \fBinit\fP will set it to \fB/dev/console\fP by default.
.SH BOOTFLAGS .SH BOOTFLAGS
It is possible to pass a number of flags to \fBinit\fP from the It is possible to pass a number of flags to \fBinit\fP from the
boot monitor (eg. LILO). \fBInit\fP accepts the following flags: boot monitor (eg.\& LILO).
\fBInit\fP accepts the following flags:
.TP 0.5i .TP 0.5i
.B -s, S, single .B -s, S, single
Single user mode boot. In this mode \fI/etc/inittab\fP is Single user mode boot.
examined and the bootup rc scripts are usually run before In this mode \fI/etc/inittab\fP is examined and the bootup rc scripts
the single user mode shell is started. are usually run before the single user mode shell is started.
.PP .PP
.TP 0.5i .TP 0.5i
.B 1-5 .B 1\(en5
Runlevel to boot into. Runlevel to boot into.
.PP .PP
.TP 0.5i .TP 0.5i
@ -222,23 +224,25 @@ other startup scripts.
The LILO boot loader adds the word "auto" to the command line if it The LILO boot loader adds the word "auto" to the command line if it
booted the kernel with the default command line (without user intervention). booted the kernel with the default command line (without user intervention).
If this is found \fBinit\fP sets the "AUTOBOOT" environment If this is found \fBinit\fP sets the "AUTOBOOT" environment
variable to "yes". Note that you cannot use this for any security variable to "yes".
measures - of course the user could specify "auto" or \-a on the Note that you cannot use this for any security measures - of course
command line manually. the user could specify "auto" or \-a on the command line manually.
.PP .PP
.TP 0.5i .TP 0.5i
.BI "-z " xxx .BI "\-z " xxx
The argument to \fB-z\fP is ignored. You can use this to expand the command The argument to \fB\-z\fP is ignored.
line a bit, so that it takes some more space on the stack. \fBInit\fP You can use this to expand the command line a bit, so that it takes
can then manipulate the command line so that \fBps\fP(1) shows some more space on the stack.
the current runlevel. \fBInit\fP can then manipulate the command line so that \fBps\fP(1)
shows the current runlevel.
.PP .PP
.SH INTERFACE .SH INTERFACE
Init listens on a \fIfifo\fP in /dev, \fI/dev/initctl\fP, for messages. Init listens on a \fIfifo\fP in /dev, \fI/dev/initctl\fP, for messages.
\fBTelinit\fP uses this to communicate with init. The interface is not \fBTelinit\fP uses this to communicate with init.
very well documented or finished. Those interested should study the The interface is not very well documented or finished.
\fIinitreq.h\fP file in the \fIsrc/\fP subdirectory of the \fBinit\fP Those interested should study the \fIinitreq.h\fP file in the
source code tar archive. \fIsrc/\fP subdirectory of the \fBinit\fP source code tar archive.
.SH SIGNALS .SH SIGNALS
Init reacts to several signals: Init reacts to several signals:
.TP 0.5i .TP 0.5i