git: 0c2cdf496834 - stable/13 - rc(8): document how to reload rc's configuration

From: Graham Perrin <>
Date: Sat, 10 Jun 2023 18:33:11 UTC
The branch stable/13 has been updated by grahamperrin:


commit 0c2cdf496834490ab25b763ee7cae5d006d39729
Author:     Mina Galić <>
AuthorDate: 2023-06-02 18:01:03 +0000
Commit:     Graham Perrin <>
CommitDate: 2023-06-10 18:32:15 +0000

    rc(8): document how to reload rc's configuration
    The fact that rc(8) only reads its configuration once is in the man
    page, but how to trigger a reload is only in the code.
    Discovered while trying to make cloud-init disable and stop syslogd.
    Thanks to RhodiumToad for providing the words.
    Reviewed by:           debdrup, grahamperrin
    Approved by:           grahamperrin, imp
    Sponsored by:          The FreeBSD Foundation
    Differential revision:
    (cherry picked from commit 0981275c75d5678172eb9dd8fbc89ef61c05c979)
 share/man/man8/rc.8 | 18 ++++++++++++++----
 1 file changed, 14 insertions(+), 4 deletions(-)

diff --git a/share/man/man8/rc.8 b/share/man/man8/rc.8
index 8b6fc094b7db..14cc83d8e32d 100644
--- a/share/man/man8/rc.8
+++ b/share/man/man8/rc.8
@@ -31,7 +31,7 @@
 .\"     @(#)rc.8	8.2 (Berkeley) 12/11/93
 .\" $FreeBSD$
-.Dd July 4, 2022
+.Dd June 1, 2023
 .Dt RC 8
@@ -124,10 +124,9 @@ to load various
 .Xr rc.subr 8
 shell functions to use.
-Load the configuration files.
+Load the configuration files (see below for reloading).
-Determine if booting in a jail,
-and add
+Determine if booting in a jail, and add
 .Dq Li nojail
 (no jails allowed) or
 .Dq Li nojailvnet
@@ -371,6 +370,17 @@ the command name (see the
+The configuration files are normally read only once at the start of a boot
+sequence; if a script needs to
+.Cm enable
+.Cm disable
+any other script that would run later in the sequence, it must send a
+to the rc process (identified by
+.Ev $RC_PID )
+to have it re-read the files.
 The following key points apply to old-style scripts in
 .Pa /usr/local/etc/rc.d/ :
 .Bl -bullet