From 8d2e10d0b9459cef019068eac3336d88cecf5efb Mon Sep 17 00:00:00 2001 From: Florent Thoumie Date: Wed, 7 Jun 2006 10:20:57 +0000 Subject: [PATCH] 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 --- share/man/man8/rc.subr.8 | 48 +++++++++++++++++++++++++++++++--------- 1 file changed, 37 insertions(+), 11 deletions(-) diff --git a/share/man/man8/rc.subr.8 b/share/man/man8/rc.subr.8 index 7fbab14affc..e9a3d0823c1 100644 --- a/share/man/man8/rc.subr.8 +++ b/share/man/man8/rc.subr.8 @@ -36,7 +36,7 @@ .\" .\" $FreeBSD$ .\" -.Dd April 4, 2006 +.Dd June 7, 2006 .Dt RC.SUBR 8 .Os .Sh NAME @@ -64,9 +64,9 @@ .It .Ic info Ar message .It -.Ic load_rc_config Ar command +.Ic load_rc_config Ar name .It -.Ic load_rc_config_var Ar command Ar var +.Ic load_rc_config_var Ar name Ar var .It .Ic mount_critical_filesystems Ar type .It @@ -312,28 +312,54 @@ turned on or off by the .Xr rc.conf 5 variable .Va rc_info . -.It Ic load_rc_config Ar command +.It Ic load_rc_config Ar name Source in the configuration files for -.Ar command . +.Ar name . First, +.Pa /etc/defaults/rc.conf +and .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, -.Pa /etc/rc.conf.d/ Ns Ar command -is sourced if it is an existing file. -The latter may also contain other variable assignments to override +.Va etcdir +is set to +.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 arguments defined by the calling script, to provide an easy mechanism for an administrator to override the behaviour of a given .Xr rc.d 8 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 .Xr rc.conf 5 variable .Ar var for -.Ar command +.Ar name and set in the current shell, using .Ic load_rc_config in a sub-shell to prevent unwanted side effects from other variable -- 2.45.2