Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 23 Feb 1998 20:10:57 -0500 (EST)
From:      sjr@home.net
To:        FreeBSD-gnats-submit@FreeBSD.ORG
Subject:   docs/5828: rc.8 manual page out of date
Message-ID:  <199802240110.UAA05146@istari.home.net>

next in thread | raw e-mail | index | archive | help

>Number:         5828
>Category:       docs
>Synopsis:       rc.8 manual page out of date
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          open
>Quarter:
>Keywords:
>Date-Required:
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Mon Feb 23 17:20:01 PST 1998
>Last-Modified:
>Originator:     Stephen J. Roznowski
>Organization:
>Release:        FreeBSD 3.0-CURRENT i386
>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
>Audit-Trail:
>Unformatted:

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-bugs" in the body of the message



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199802240110.UAA05146>