os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Tweak a bit the description of `PROVIDE' rc.d keyword, to make it a bit

Browse source 
more clear that it is *required* for startup scripts.  An rc.d script
without a PROVIDE keyword is not run by our rc.subr (it is skipped by
the find_local_scripts_new() shell function of rc.subr).

Inspired by:	A post by Helmut Schneider, jumper99 at gmx.de,
		on news:comp.unix.bsd.freebsd.misc
Message-Id:	63aggbF26iusnU1@mid.individual.net
This commit is contained in:
Giorgos Keramidas 2008-03-06 16:29:21 +00:00
parent 272d5ae80a
commit 59cdab6e08
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=31621
1 changed files with 15 additions and 6 deletions

21
en_US.ISO8859-1/books/handbook/config/chapter.sgml
View file

@ -786,15 +786,23 @@ sshd is running as pid 433.</screen>
in the comments at the top of each startup script. The
&man.rcorder.8; program is then used to parse these comments
during system initialization to determine the order in which
system services should be invoked to satisfy the dependencies.
The following words may be included at the top of each startup
file:</para>
system services should be invoked to satisfy the dependencies.</para>
<para>The following words must be included in all startup scripts
(they are required by &man.rc.subr.8; to <quote>enable</quote> the
startup script):</para>
<itemizedlist>
<listitem>
<para><literal>PROVIDE</literal>: Specifies the services this file provides.</para>
</listitem>
</itemizedlist>
<para>The following words may be included at the top of each startup
file. They are not strictly necessary, but they are useful as
hints to &man.rcorder.8;:</para>
<itemizedlist>
<listitem>
<para><literal>REQUIRE</literal>: Lists services which are required for this
service. This file will run <emphasis>after</emphasis>
@ -808,9 +816,10 @@ sshd is running as pid 433.</screen>
</listitem>
</itemizedlist>
<para>By using this method, an administrator can easily control system
services without the hassle of <quote>runlevels</quote> like
some other &unix; operating systems.</para>
<para>By carefully setting these keywords for each startup script, an
administrator has a very fine-grained level of control of the startup
order of the scripts, without the hassle of <quote>runlevels</quote>
like some other &unix; operating systems.</para>
<para>Additional information about the
<filename>rc.d</filename> system can be found in the &man.rc.8;