From sjr@home.net  Mon Feb 23 17:11:33 1998
Received: from istari.home.net (cc158233-a.catv1.md.home.com [24.3.25.17])
          by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id RAA06305
          for <FreeBSD-gnats-submit@freebsd.org>; Mon, 23 Feb 1998 17:11:30 -0800 (PST)
          (envelope-from sjr@home.net)
Received: (from sjr@localhost)
	by istari.home.net (8.8.8/8.8.6) id UAA05146;
	Mon, 23 Feb 1998 20:10:57 -0500 (EST)
Message-Id: <199802240110.UAA05146@istari.home.net>
Date: Mon, 23 Feb 1998 20:10:57 -0500 (EST)
From: sjr@home.net
Reply-To: sjr@home.net
To: FreeBSD-gnats-submit@freebsd.org
Subject: rc.8 manual page out of date
X-Send-Pr-Version: 3.2

>Number:         5828
>Category:       docs
>Synopsis:       rc.8 manual page out of date
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 23 17:20:01 PST 1998
>Closed-Date:    Wed Feb 25 18:45:29 PST 1998
>Last-Modified:  Wed Feb 25 18:45:38 PST 1998
>Originator:     Stephen J. Roznowski
>Release:        FreeBSD 3.0-CURRENT i386
>Organization:
>Environment:

	FreeBSD 3.0-CURRENT

>Description:

	The rc.8 manual page does not reflect the other rc files
	that currently exist. Further, none of them have separate
	pages.

	I've taken a first pass at updating the rc.8 page.

>How-To-Repeat:

	

>Fix:
	

--- share/man/man8/rc.8.old	Thu Mar  6 22:28:21 1997
+++ share/man/man8/rc.8	Mon Feb 23 19:14:41 1998
@@ -37,16 +37,34 @@
 .Os BSD 4
 .Sh NAME
 .Nm rc
-.Nd command script for auto\-reboot and daemons
+.Nd command scripts for auto\-reboot and daemon startup
 .Sh SYNOPSIS
 .Nm rc
+.Nm rc.conf
+.Nm rc.conf.local
+.Nm rc.serial
+.Nm rc.pccard
+.Nm rc.network
+.Nm rc.firewall
+.Nm rc.<arch>
 .Nm rc.local
+.Nm rc.shutdown
 .Sh DESCRIPTION
 .Nm Rc
-is the command script which controls the automatic reboot and
+is the command script which controls the automatic reboot
+(calling the other scripts) and
 .Nm rc.local
 is the script holding commands which are pertinent only
 to a specific site.
+.Nm Rc.conf
+contains the global system configuration information referenced
+by the rc files, while
+.Nm rc.conf.local
+contains the local system configuration.
+.Pp
+.Nm Rc.shutdown
+is the command script which contains any necessary commands
+to be executed as the system is shut down.
 .Pp
 When an automatic reboot is in progress,
 .Nm rc
@@ -75,28 +93,56 @@
 and clears the scratch directory
 .Pa /tmp .
 .Pp
-.Nm Rc.local
-is executed immediately before any other commands after a successful
-.Nm 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
-generated as a result of a system crash, with
-.Xr savecore 8 .
-The latter command is included in the
-.Nm rc.local
-file because the directory in which core dumps are saved
-is usually site specific.
+.Nm Rc.serial
+is used to set any special configurations for serial devices.
+.Pp
+.Nm Rc.pccard
+is used to enable PC-cards.
+.Pp
+.Nm Rc.network
+is used to start the network.
+The network is started in three passes.
+The first pass sets the hostname and domainname, configures the network
+interfaces, turns on any IP firewall rules, and starts routing.
+The second pass starts most of the network related daemons.
+The third pass starts NFS, amd, rwhod, Kerberos and
+the multicast routing daemon.
 .Pp
-Following tradition, the startup files
+.Nm Rc.firewall
+is used to configure rules for the kernel based firewall
+service. It has several possible options:
+.Pp
+.Bl -tag -width "fBfilename" -compact -offset indent
+.It open
+will allow anyone in.
+.It client
+will try to protect just this machine.
+.It simple
+will try to protect a whole network.
+.It closed
+totally disables IP services except via lo0 interface.
+.It UNKNOWN
+disables the loading of firewall rules.
+.It filename
+will load the rules in the given filename (full path required).
+.El
+.Pp
+.Nm Rc.<arch>
+runs architecture specific programs.
+.Pp
+.Nm Rc.local
+is executed after the scripts above, but before the rest of the
 .Nm rc
-and
+file is completed.
+Presently, all
 .Nm rc.local
-reside in
+does is to put version information in
+.Pa /etc/motd .
+.Pp
+Following tradition, the startup files reside in
 .Pa /etc .
 .Sh SEE ALSO
+.Xr rc.conf 5 ,
 .Xr init 8 ,
 .Xr reboot 8 ,
 .Xr savecore 8
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: jkh 
State-Changed-When: Wed Feb 25 18:45:29 PST 1998 
State-Changed-Why:  
Fix applied, thanks! 
>Unformatted:
