[Pkg-sysvinit-commits] r237 - sysvinit/trunk/debian/patches

[Thomas Hood]

Author: jdthood-guest
Date: 2005-11-24 13:19:34 +0000 (Thu, 24 Nov 2005)
New Revision: 237

Modified:
   sysvinit/trunk/debian/patches/10_doc_manuals.dpatch
Log:
Improvements to init.8 are now in 10_doc_manuals.dpatch

Modified: sysvinit/trunk/debian/patches/10_doc_manuals.dpatch
===================================================================
--- sysvinit/trunk/debian/patches/10_doc_manuals.dpatch	2005-11-24 13:13:39 UTC (rev 236)
+++ sysvinit/trunk/debian/patches/10_doc_manuals.dpatch	2005-11-24 13:19:34 UTC (rev 237)
@@ -4,8 +4,82 @@
 ## All lines beginning with `## DP:' are a description of the patch.
 ## DP: Misc patches to manual pages found in version 2.86.ds1-1.1.
 ## DP: Typo reported in bug #326408 is fixed in this patch.
+## DP: init.8: Mention that entering runlevel 1 kills all processes (Closes: #238861)
 
 @DPATCH@
+--- sysvinit-2.86.ds1.orig/man/init.8	2005-11-24 15:13:27.000000000 +0100
++++ sysvinit-2.86.ds1/man/init.8	2005-11-24 15:15:02.000000000 +0100
+@@ -36,21 +36,34 @@
+ only a selected group of processes to exist.  The processes spawned by
+ \fBinit\fP for each of these runlevels are defined in the
+ \fB/etc/inittab\fP file.  \fBInit\fP can be in one of eight runlevels:
+-\fB0\(en6\fP and \fBS\fP or \fBs\fP.  The runlevel is
++\fB0\(en6\fP and \fBS\fP (a.k.a. \fBs\fP).  The runlevel is
+ changed by having a privileged user run \fBtelinit\fP, which sends
+ appropriate signals to \fBinit\fP, telling it which runlevel to change
+ to.
+ .PP
+-Runlevels \fB0\fP, \fB1\fP, and \fB6\fP are reserved. Runlevel 0 is used to
+-halt the system, runlevel 6 is used to reboot the system, and runlevel
+-1 is used to get the system down into single user mode. Runlevel \fBS\fP
+-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,
++Runlevels \fBS\fP, \fB0\fP, \fB1\fP, and \fB6\fP are reserved.
++Runlevel S is used to initialize the system on boot.
++When starting runlevel S (on boot)
++or runlevel 1 (switching from a multi-user runlevel)
++the system is entering ``single-user mode'', after which the
++current runlevel is S.
++Runlevel 0 is used to halt the system;
++runlevel 6 is used to reboot the system.
++.PP
++After booting through S the system automatically enters one of
++the multi-user runlevels 2 through 5, unless there was some
++problem that needs to be fixed by the administrator in
++single-user mode.
++Normally after entering single-user mode
++the administrator performs maintenance and then reboots the system.
++.PP
++For more information,
+ see the manpages for \fBshutdown\fP(8) and \fBinittab\fP(5).
+ .PP
+ Runlevels 7-9 are also valid, though not really documented. 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.
++.PP
++Runlevels \fIS\fP and \fIs\fP are the same.
+ Internally they are aliases for the same runlevel.
+ .\"}}}
+ .PP
+@@ -62,9 +75,10 @@
+ entry (or no \fB/etc/inittab\fP at all), a runlevel must be
+ entered at the system console.
+ .PP
+-Runlevel \fBS\fP or \fBs\fP bring the system to single user mode
+-and do not require an \fB/etc/inittab\fP file.  In single user mode,
+-\fB/sbin/sulogin\fP is invoked on \fB/dev/console\fP.
++Runlevel \fBS\fP or \fBs\fP initialize the system
++and do not require an \fB/etc/inittab\fP file.
++.PP
++In single user mode, \fB/sbin/sulogin\fP is invoked on \fB/dev/console\fP.
+ .PP
+ When entering single user mode, \fBinit\fP initializes the consoles
+ \fBstty\fP settings to sane values. Clocal mode is set. Hardware
+@@ -254,6 +268,14 @@
+ for them.  If the processes change their group, \fBinit\fP can't
+ kill them and you may end up with two processes reading from one
+ terminal line.
++.PP
++On a Debian system, entering runlevel 1 causes all processes
++to be killed except for kernel threads and the script that does
++the killing and other processes in its session.
++As a consequence of this, it isn't safe to return from runlevel 1
++to a multi-user runlevel: daemons that were started in runlevel S
++and are needed for normal operation are no longer running.
++The system should be rebooted.
+ .\"}}}
+ .\"{{{  Diagnostics
+ .SH DIAGNOSTICS
 --- sysvinit-2.86.ds1.orig/man/last.1
 +++ sysvinit-2.86.ds1/man/last.1
 @@ -51,6 +51,8 @@