aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSimon J. Gerraty <sjg@FreeBSD.org>2024-02-10 20:30:53 +0000
committerSimon J. Gerraty <sjg@FreeBSD.org>2024-02-10 20:31:10 +0000
commit41f9823eda9424ebaa37ed00db4e8534f9e5561c (patch)
tree3712fc8f53613c855762f56ad5e6fe298ce31159
parent621dae89f3c70b86bef255a621a76bf553f733ff (diff)
downloadsrc-41f9823eda9424ebaa37ed00db4e8534f9e5561c.tar.gz
src-41f9823eda9424ebaa37ed00db4e8534f9e5561c.zip
rc.subr.8 note when DebugOn will be called
-rw-r--r--share/man/man8/rc.subr.824
1 files changed, 20 insertions, 4 deletions
diff --git a/share/man/man8/rc.subr.8 b/share/man/man8/rc.subr.8
index 91ed5364bd6a..0906ecb2e787 100644
--- a/share/man/man8/rc.subr.8
+++ b/share/man/man8/rc.subr.8
@@ -27,7 +27,7 @@
.\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
.\" POSSIBILITY OF SUCH DAMAGE.
.\"
-.Dd January 31, 2024
+.Dd February 10, 2024
.Dt RC.SUBR 8
.Os
.Sh NAME
@@ -385,8 +385,10 @@ mechanism for an administrator to override the behaviour of a given
.Xr rc.d 8
script without requiring the editing of that script.
.Pp
-The function
-.Ic dot
+The function named by
+.Va load_rc_config_reader
+(default is
+.Ic dot )
is used to read configuration unless
.Ar flag
is:
@@ -404,6 +406,12 @@ use
.Ic vdot
to read in configuration only if it is verified.
.El
+.Pp
+.Ic DebugOn
+will be called with tags derived from
+.Ar name
+to enable tracing if any appear in
+.Va DEBUG_SH .
.It Ic load_rc_config_var Ar name Ar var
Read the
.Xr rc.conf 5
@@ -441,7 +449,7 @@ If the file is empty or does not contain
a value for
.Va RC_LEVEL ,
set it to
-Li 0 .
+.Li 0 .
.Pp
If
.Ar level
@@ -993,6 +1001,14 @@ However, if
.Ic is_verified Ar file
fails, just return.
.Pp
+.Ic DebugOn
+will be called with tags derrived from
+.Va name
+and
+.Va rc_arg
+to enable tracing if any of those tags appear in
+.Va DEBUG_SH .
+.Pp
The startup behaviour of
.Ar file
depends upon the following checks: