Date: Thu, 24 Jun 1999 17:50:03 +0200 From: Sheldon Hearn <sheldonh@uunet.co.za> To: freebsd-doc@freebsd.org Subject: Revising the rc.conf-related manpages Message-ID: <67678.930239403@axl.noc.iafrica.com>
next in thread | raw e-mail | index | archive | help
Hi folks, It doesn't look like our manual pages have been updated to reflect the use of /etc/defaults/rc.conf . I'm willing to work on it and want some guidance (or a quick message letting me know that someone else is taking care of this). So far, I've got a small diff for rc.conf(5) and wanted to know whether it's acceptable, if not what's wrong and what else would need to be updated to complete the revision. Please ensure that feedback comes to my address, as I don't subscribe to the list. Thanks, Sheldon. Index: rc.conf.5 =================================================================== RCS file: /home/ncvs/src/share/man/man5/rc.conf.5,v retrieving revision 1.30 diff -u -d -r1.30 rc.conf.5 --- rc.conf.5 1999/03/29 17:22:47 1.30 +++ rc.conf.5 1999/06/24 15:49:41 @@ -30,9 +30,6 @@ .Sh NAME .Nm rc.conf .Nd system configuration information. -.Pp -.Nm rc.conf.local -.Nd localized system configuration information. .Sh DESCRIPTION The file .Nm rc.conf @@ -43,16 +40,8 @@ file is generally initialized by the system installation utility: .Pa /stand/sysinstall . .Pp -The -.Nm rc.conf.local -file may be used to override variables set in rc.conf. The system -administrator typically uses the distribution-supplied -.Nm rc.conf -file and maintains local overrides/additions in -.Nm rc.conf.local. -.Pp The purpose of -.Nm rc.conf[.local] +.Nm rc.conf is not to run commands or perform system startup actions directly. Instead, it is included by the various generic startup scripts in @@ -60,6 +49,21 @@ which conditionalize their internal actions according to the settings found there. .Pp +The +.Pa /etc/rc.conf +file is included from the file +.Pa /etc/defaults/rc.conf , +which specifies the default settings for all the available options. Options +need only be specified in +.Pa /etc/rc.conf +when the system administrator wishes to override these defaults. The file +.Pa /etc/rc.conf.local +is used to override settings in +.Pa /etc/rc.conf +for historical reasons. See the +.Dq rc_conf_files +option below. +.Pp The following list provides a name and short description for each variable you can set in the .Nm @@ -196,6 +200,15 @@ .Ed Then note that alias4 would \fBnot\fR be added since the search would stop with the missing alias3 entry. +.It Ar rc_conf_files +(str) This option is used to specify a list of files that will override +the settings in +.Pa /etc/defaults/rc.conf . +The files will be read in the order in which they are specified and should +include the full path to the file. By default, the files specified are +.Pa /etc/rc.conf +and +.Pa /etc/rc.conf.local .It Ar syslogd_enable (bool) If set to .Ar YES , @@ -944,6 +957,10 @@ for the list of possible security levels and their effect on system operation. .Sh FILES +.Bl -tag -width /etc/defaults/rc.conf -compact +.It Pa /etc/defaults/rc.conf +.El +.Pp .Bl -tag -width /etc/rc.conf -compact .It Pa /etc/rc.conf .El To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-doc" in the body of the message
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?67678.930239403>