Reflect latest changes in rc.subr wrt prefix/etcdir variables being set

automatically by load_rc_config.

With help from:	ru (mdoc-fu)
Reviewed by:	brueffer
Approved by:	cperciva
This commit is contained in:
flz 2006-06-07 10:20:57 +00:00
parent 5a9f20b064
commit dc95de3e71

View File

@ -36,7 +36,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd April 4, 2006 .Dd June 7, 2006
.Dt RC.SUBR 8 .Dt RC.SUBR 8
.Os .Os
.Sh NAME .Sh NAME
@ -64,9 +64,9 @@
.It .It
.Ic info Ar message .Ic info Ar message
.It .It
.Ic load_rc_config Ar command .Ic load_rc_config Ar name
.It .It
.Ic load_rc_config_var Ar command Ar var .Ic load_rc_config_var Ar name Ar var
.It .It
.Ic mount_critical_filesystems Ar type .Ic mount_critical_filesystems Ar type
.It .It
@ -312,28 +312,54 @@ turned on or off by the
.Xr rc.conf 5 .Xr rc.conf 5
variable variable
.Va rc_info . .Va rc_info .
.It Ic load_rc_config Ar command .It Ic load_rc_config Ar name
Source in the configuration files for Source in the configuration files for
.Ar command . .Ar name .
First, First,
.Pa /etc/defaults/rc.conf
and
.Pa /etc/rc.conf .Pa /etc/rc.conf
is sourced if it has not yet been read in. are sourced if they have not yet been read in.
Then, Then,
.Pa /etc/rc.conf.d/ Ns Ar command .Va etcdir
is sourced if it is an existing file. is set to
The latter may also contain other variable assignments to override .Pa /etc
if
.Va command Ap s
prefix (or
.Va ${name} Ns Va _program Ap s
if it is defined) is
.Pa /
or
.Pa /usr ,
otherwise
.Va etcdir
is set to
.Pa ${prefix} Ns Pa /etc .
Once those variables are set accordingly,
.Pa /etc/rc.conf.d/ Ns Va ${name}
is sourced if the file exists (but it is deprecated if
.Va etcdir
is different than
.Pa /etc )
and then
.Pa ${etcdir} Ns Pa /defaults/ Ns Va ${name}
and
.Va ${etcdir} Ns Pa /rc.conf.d/ Ns Va ${name}
are sourced if these files exist.
All these files may also contain other variable assignments to override
.Ic run_rc_command .Ic run_rc_command
arguments defined by the calling script, to provide an easy arguments defined by the calling script, to provide an easy
mechanism for an administrator to override the behaviour of a given mechanism for an administrator to override the behaviour of a given
.Xr rc.d 8 .Xr rc.d 8
script without requiring the editing of that script. script without requiring the editing of that script.
.It Ic load_rc_config_var Ar command Ar var .It Ic load_rc_config_var Ar name Ar var
Read the Read the
.Xr rc.conf 5 .Xr rc.conf 5
variable variable
.Ar var .Ar var
for for
.Ar command .Ar name
and set in the current shell, using and set in the current shell, using
.Ic load_rc_config .Ic load_rc_config
in a sub-shell to prevent unwanted side effects from other variable in a sub-shell to prevent unwanted side effects from other variable