[src/netbsd-1-5]: src/share/man/man8 pull up rev 1.12:

[lukem <lukem%NetBSD.org@localhost>]

details:   https://anonhg.NetBSD.org/src/rev/b599c8a042aa
branches:  netbsd-1-5
changeset: 489225:b599c8a042aa
user:      lukem <lukem%NetBSD.org@localhost>
date:      Wed Aug 23 12:38:26 2000 +0000

description:
pull up rev 1.12:
- document `nostart' support for /etc/rc
- use bootconf.sh instead of fsck.sh as the `foo.sh' example
- add information how a normal script can stop the boot with kill -TERM $$
- update history

approved: thorpej

diffstat:

 share/man/man8/rc.8 |  34 +++++++++++++++++++++++++++-------
 1 files changed, 27 insertions(+), 7 deletions(-)

diffs (67 lines):

diff -r 7730154678f4 -r b599c8a042aa share/man/man8/rc.8
--- a/share/man/man8/rc.8       Wed Aug 23 12:36:28 2000 +0000
+++ b/share/man/man8/rc.8       Wed Aug 23 12:38:26 2000 +0000
@@ -1,4 +1,4 @@
-.\"    $NetBSD: rc.8,v 1.8.4.1 2000/08/09 19:16:58 lukem Exp $
+.\"    $NetBSD: rc.8,v 1.8.4.2 2000/08/23 12:38:26 lukem Exp $
 .\"
 .\" Copyright (c) 2000 The NetBSD Foundation, Inc.
 .\" All rights reserved.
@@ -34,7 +34,7 @@
 .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
 .\" POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd July 26, 2000
+.Dd August 16, 2000
 .Dt RC 8
 .Os
 .Sh NAME
@@ -97,6 +97,12 @@
 .Xr rcorder 8
 to order the files in
 .Pa /etc/rc.d/
+that do not have a
+.Dq nostart
+keyword (refer to
+.Xr rcorder 8 's
+.Fl s 
+flag),
 and assigns the result to a variable.
 .It
 Calls each script in turn using run_rc_script() (from
@@ -166,10 +172,23 @@
 Scripts that are to be sourced into the current shell rather than a subshell.
 Extreme care must be taken in using this, as the startup sequence will
 terminate if the script does.
-.Pa rc.d/fsck.sh
-uses this behaviour to terminate the boot in case of a failed disk check.
-.It foo
+.Pa /etc/rc.d/bootconf.sh
+uses this behaviour to allow the user to select a different
+configuration (including
+.Pa /etc/rc.conf )
+early in the boot.
+.It bar
 Scripts that are sourced in a subshell.
+These can stop the boot if necessary with the following shell
+commands:
+.Bd -literal -offset
+       if [ "$autoboot" = yes ]; then
+               kill -TERM $$
+       fi
+       exit 1
+.Ed
+.Pp
+Note that this should be used sparingly!
 .El
 .Pp
 The scripts are expected to support at least the following arguments:
@@ -230,5 +249,6 @@
 .Bx 4.0 .
 The
 .Pa /etc/rc.d
-support appeared in
-.Nx 1.5 .
+support was implemented in
+.Nx 1.5
+by Luke Mewburn <lukem%netbsd.org@localhost>.