Extend rc_scripts documentation.

prodded by espie@
ok jmc@ (with tweaks), ok miod@

3 files changed, 38 insertions, 8 deletions

diff --git a/share/man/man8/rc.conf.8 b/share/man/man8/rc.conf.8
index 25c88374a4b..f97131f1cd7 100644
--- a/share/man/man8/rc.conf.8
+++ b/share/man/man8/rc.conf.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: rc.conf.8,v 1.16 2008/05/07 12:05:35 claudio Exp $
+.\"	$OpenBSD: rc.conf.8,v 1.17 2011/02/12 11:22:31 ajacoutot Exp $
 .\"
 .\" Copyright (c) 1997 Ian F. Darwin
 .\" All rights reserved.
@@ -27,7 +27,7 @@
 .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
 .\" SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: May 7 2008 $
+.Dd $Mdocdate: February 12 2011 $
 .Dt RC.CONF 8
 .Os
 .Sh NAME
@@ -51,7 +51,7 @@ file.
 Variables set in this file will override variables previously set in
 .Pa /etc/rc.conf .
 .Pp
-There are three sections in this file.
+There are four sections in this file.
 The first is used to turn features on or off.
 For example, whether the system runs the
 .Nm dhcpd
@@ -100,6 +100,26 @@ This particular line instructs
 .Xr nfsd 8
 to start four copies of the server.
 On a busy file server, 8 (or more) copies are recommended.
+.Pp
+The fourth section contains the
+.Va rc_scripts
+variable, responsible for starting and stopping
+.Xr rc.d 8
+scripts in the specified order.
+For example, the following line
+.Bd -literal -offset indent
+rc_scripts="dbus_daemon cupsd"
+.Ed
+.Pp
+will run
+.Pa /etc/rc.d/dbus_daemon
+then
+.Pa /etc/rc.d/cupsd
+with the
+.Va start
+argument at boot time and in reverse order with the
+.Va stop
+argument at shutdown.
 .Sh SEE ALSO
 .Xr init 8 ,
 .Xr intro 8 ,
diff --git a/share/man/man8/rc.shutdown.8 b/share/man/man8/rc.shutdown.8
index 0e2378a49ed..3aa28fd5213 100644
--- a/share/man/man8/rc.shutdown.8
+++ b/share/man/man8/rc.shutdown.8
@@ -1,4 +1,4 @@
-.\"	$OpenBSD: rc.shutdown.8,v 1.9 2011/01/16 14:20:54 robert Exp $
+.\"	$OpenBSD: rc.shutdown.8,v 1.10 2011/02/12 11:22:31 ajacoutot Exp $
 .\"
 .\" Copyright (c) 1999 Aaron Campbell
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: January 16 2011 $
+.Dd $Mdocdate: February 12 2011 $
 .Dt RC.SHUTDOWN 8
 .Os
 .Sh NAME
@@ -46,7 +46,11 @@ This script, like
 .Xr rc.local 8 ,
 executes the
 .Xr rc.d 8
-scripts specified by the rc_scripts variable in a reversed order.
+scripts specified by the
+.Va rc_scripts
+variable defined in
+.Xr rc.conf 8
+in a reverse order.
 .Pa /etc/rc.shutdown
 is also for commands added by the system administrator.
 .Pp
@@ -68,5 +72,6 @@ will attempt to power down the machine after it has halted.
 .Xr halt 8 ,
 .Xr init 8 ,
 .Xr rc 8 ,
+.Xr rc.conf 8 ,
 .Xr rc.d 8 ,
 .Xr reboot 8
diff --git a/share/man/man8/rc.subr.8 b/share/man/man8/rc.subr.8
index 2564e04efbd..a3c2b9966c6 100644
--- a/share/man/man8/rc.subr.8
+++ b/share/man/man8/rc.subr.8
@@ -1,4 +1,4 @@
-.\" 	$OpenBSD: rc.subr.8,v 1.5 2011/01/16 23:31:12 schwarze Exp $
+.\" 	$OpenBSD: rc.subr.8,v 1.6 2011/02/12 11:22:31 ajacoutot Exp $
 .\"
 .\" Copyright (c) 2011 Robert Nagy, Antoine Jacoutot, Ingo Schwarze
 .\" All rights reserved.
@@ -24,7 +24,7 @@
 .\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
 .\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 .\"
-.Dd $Mdocdate: January 16 2011 $
+.Dd $Mdocdate: February 12 2011 $
 .Dt RC.SUBR 8
 .Os
 .Sh NAME
@@ -47,6 +47,11 @@ It is currently used for daemons installed from
 only, not for daemons contained in the
 .Ox
 base system.
+The order in which scripts are started and stopped at boot time and
+shutdown is defined by the
+.Va rc_scripts
+variable in
+.Xr rc.conf 8 .
 .Pp
 The
 .Nm