BSD 4_3_Net_2 release

[unix-history] / usr / src / share / man / man8 / rc.8

diff --git a/usr/src/share/man/man8/rc.8 b/usr/src/share/man/man8/rc.8
index 94fe516..fdd85ca 100644 (file)
--- a/usr/src/share/man/man8/rc.8
+++ b/usr/src/share/man/man8/rc.8
@@ -1,64 +1,106 @@
-.\" Copyright (c) 1980 Regents of the University of California.
-.\" All rights reserved.  The Berkeley software License Agreement
-.\" specifies the terms and conditions for redistribution.
+.\" Copyright (c) 1980, 1991 Regents of the University of California.
+.\" All rights reserved.

 .\"
 .\"

-.\"    @(#)rc.8        6.1 (Berkeley) 4/27/85
+.\" Redistribution and use in source and binary forms, with or without
+.\" modification, are permitted provided that the following conditions
+.\" are met:
+.\" 1. Redistributions of source code must retain the above copyright
+.\"    notice, this list of conditions and the following disclaimer.
+.\" 2. Redistributions in binary form must reproduce the above copyright
+.\"    notice, this list of conditions and the following disclaimer in the
+.\"    documentation and/or other materials provided with the distribution.
+.\" 3. All advertising materials mentioning features or use of this software
+.\"    must display the following acknowledgement:
+.\"    This product includes software developed by the University of
+.\"    California, Berkeley and its contributors.
+.\" 4. Neither the name of the University nor the names of its contributors
+.\"    may be used to endorse or promote products derived from this software
+.\"    without specific prior written permission.

 .\"
 .\"

-.TH RC 8 "April 27, 1985"
-.UC 4
-.SH NAME
-rc \- command script for auto-reboot and daemons
-.SH SYNOPSIS
-.B /etc/rc
-.br
-.B /etc/rc.local
-.SH DESCRIPTION
-.I Rc
+.\" THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
+.\" ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+.\" IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+.\" ARE DISCLAIMED.  IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
+.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
+.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
+.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
+.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
+.\" SUCH DAMAGE.
+.\"
+.\"     @(#)rc.8       6.2 (Berkeley) 3/16/91
+.\"
+.Dd March 16, 1991
+.Dt RC 8
+.Os BSD 4
+.Sh NAME
+.Nm rc
+.Nd command script for auto\-reboot and daemons
+.Sh SYNOPSIS
+.Nm rc
+.Nm rc.local
+.Sh DESCRIPTION
+.Nm Rc

 is the command script which controls the automatic reboot and
 is the command script which controls the automatic reboot and

-.I rc.local
+.Nm rc.local

 is the script holding commands which are pertinent only
 to a specific site.
 is the script holding commands which are pertinent only
 to a specific site.

-.PP
+.Pp

 When an automatic reboot is in progress,
 When an automatic reboot is in progress,

-.I rc
+.Nm rc

 is invoked with the argument
 is invoked with the argument

-.I autoboot
-and runs a
-.I fsck
+.Em autoboot .
+The first portion of
+.Nm rc
+runs an
+.Xr fsck 8

 with option
 with option

-.B \-p
+.Fl p

 to ``preen'' all the disks of minor inconsistencies resulting
 from the last system shutdown and to check for serious inconsistencies
 caused by hardware or software failure.
 If this auto-check and repair succeeds, then the second part of
 to ``preen'' all the disks of minor inconsistencies resulting
 from the last system shutdown and to check for serious inconsistencies
 caused by hardware or software failure.
 If this auto-check and repair succeeds, then the second part of

-.I rc
+.Nm rc

 is run.
 is run.

-.PP
+.Pp

 The second part of
 The second part of

-.I rc,
+.Nm rc ,

 which is run after a auto-reboot succeeds and also if
 which is run after a auto-reboot succeeds and also if

-.I rc
+.Nm rc

 is invoked when a single user shell terminates (see
 is invoked when a single user shell terminates (see

-.IR init (8)),
+.Xr init 8 ) ,

 starts all the daemons on the system, preserves editor files
 and clears the scratch directory
 starts all the daemons on the system, preserves editor files
 and clears the scratch directory

-.B /tmp.
-.I Rc.local
+.Pa /tmp .
+.Pp
+.Nm Rc.local

 is executed immediately before any other commands after a successful
 is executed immediately before any other commands after a successful

-.IR fsck .
+.Xr fsck .

 Normally, the first commands placed in the
 Normally, the first commands placed in the

-.I rc.local
+.Nm rc.local

 file define the machine's name, using
 file define the machine's name, using

-.IR hostname (1),
+.Xr hostname 1 ,

 and save any possible core image that might have been
 and save any possible core image that might have been

-generated as a result of a system crash,
-.IR savecore (8).
+generated as a result of a system crash, with
+.Xr savecore 8 .

 The latter command is included in the
 The latter command is included in the

-.I rc.local
+.Nm rc.local

 file because the directory in which core dumps are saved
 is usually site specific.
 file because the directory in which core dumps are saved
 is usually site specific.

-.SH SEE ALSO
-init(8),
-reboot(8),
-savecore(8)
-.SH BUGS
+.Pp
+Following tradition, the startup files
+.Nm rc
+and
+.Nm rc.local
+reside in
+.Pa /etc .
+.Sh SEE ALSO
+.Xr init 8 ,
+.Xr reboot 8 ,
+.Xr savecore 8
+.Sh HISTORY
+The
+.Nm
+command appeared in
+.Bx 4.0 .