Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 10 Feb 2024 20:31:19 GMT
From:      "Simon J. Gerraty" <sjg@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org
Subject:   git: 41f9823eda94 - main - rc.subr.8 note when DebugOn will be called
Message-ID:  <202402102031.41AKVJ5J048358@gitrepo.freebsd.org>

next in thread | raw e-mail | index | archive | help
The branch main has been updated by sjg:

URL: https://cgit.FreeBSD.org/src/commit/?id=41f9823eda9424ebaa37ed00db4e8534f9e5561c

commit 41f9823eda9424ebaa37ed00db4e8534f9e5561c
Author:     Simon J. Gerraty <sjg@FreeBSD.org>
AuthorDate: 2024-02-10 20:30:53 +0000
Commit:     Simon J. Gerraty <sjg@FreeBSD.org>
CommitDate: 2024-02-10 20:31:10 +0000

    rc.subr.8 note when DebugOn will be called
---
 share/man/man8/rc.subr.8 | 24 ++++++++++++++++++++----
 1 file 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:



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?202402102031.41AKVJ5J048358>