come a bit closer to describing reality

1 files changed, 53 insertions, 22 deletions

diff --git a/share/man/man8/rc.8 b/share/man/man8/rc.8
index c02fb0b7b3b..278f8a372d6 100644
--- a/share/man/man8/rc.8
+++ b/share/man/man8/rc.8
@@ -1,4 +1,4 @@
-.\"	$NetBSD: rc.8,v 1.3 1994/11/30 19:36:26 jtc Exp $
+.\"	$OpenBSD: rc.8,v 1.2 1998/06/26 03:30:14 millert Exp $
 .\"
 .\" Copyright (c) 1980, 1991, 1993
 .\"	The Regents of the University of California.  All rights reserved.
@@ -42,12 +42,25 @@
 .Sh SYNOPSIS
 .Nm rc
 .Nm rc.local
+.Nm rc.securelevel
+.Nm netstart
 .Sh DESCRIPTION
-.Nm Rc
-is the command script which controls the automatic reboot and
-.Nm rc.local
+.Nm rc
+is the command script that is invoked by
+.Xr init 8
+during an automatic reboot and after single user mode is exited;
+it performs system housekeeping chores and starts up system daemons.
+.Nm rc.local 
 is the script holding commands which are pertinent only
 to a specific site.
+.Nm rc.securelevel
+is the script which runs commands that must be run before the
+security level changes.
+.Nm netstart
+is the script which commands and daemons pertaining to the network.
+All of these are controlled in part by
+.Xr rc.conf 8
+which specifies which daemons and services are to be run.
 .Pp
 When an automatic reboot is in progress,
 .Nm rc
@@ -72,35 +85,53 @@ which is run after an auto-reboot succeeds and also if
 .Nm rc
 is invoked when a single user shell terminates (see
 .Xr init 8 ) ,
-starts all the daemons on the system, preserves editor files
-and clears the scratch directory
-.Pa /tmp .
-.Pp
-.Nm Rc.local
-is executed immediately before any other commands after a successful
-.Xr fsck .
-Normally, the first commands placed in the
-.Nm rc.local
-file define the machine's name, using
-.Xr hostname 1 ,
-and save any possible core image that might have been
+and then mounts filesystems, starts system daemons, preserves editor files,
+clears the scratch directory
+.Pa /tmp ,
+and saves any possible core image that might have been
 generated as a result of a system crash, with
 .Xr savecore 8 .
-The latter command is included in the
+.Pp
+.Nm netstart
+is executed by
+.Nm rc
+before the system daemons are run.
+.Nm netstart
+defines the machine's name, configures any network interfaces,
+initializes the routing table, and optionally, starts the ip filter
+daemon.
+.Pp
 .Nm rc.local
-file because the directory in which core dumps are saved
-is usually site specific.
+is executed towards the end of
+.Nm rc
+(it is not the very last as there are a few services that must be
+the started at the very end).
+Normally,
+.Nm rc.local
+contains commands and daemons that are not part of the
+stock installation.
 .Pp
-Following tradition, the startup files
+.Nm rc.securelevel
+is executable by
 .Nm rc
+to start daemons that must run before the security level changes.
+It then sets the security level to the values specified in
+.Xr rc.conf 8 .
+.Pp
+Following tradition, the startup files
+.Nm rc ,
+.Nm rc.local ,
+.Nm rc.securelevel ,
 and
-.Nm rc.local
+.Nm netstart
 reside in
 .Pa /etc .
 .Sh SEE ALSO
 .Xr init 8 ,
+.Xr rc.conf 8 ,
 .Xr reboot 8 ,
-.Xr savecore 8
+.Xr savecore 8 ,
+.Xr sysctl.conf 5
 .Sh HISTORY
 The
 .Nm