git: fffc757d0fb3 - stable/12 - sysctl.conf.5: Document rc.d/sysctl and rc.d/sysctl_lastload

From: Mateusz Piotrowski <0mp_at_FreeBSD.org>
Date: Fri, 22 Jul 2022 00:28:01 UTC
The branch stable/12 has been updated by 0mp (doc, ports committer):

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

commit fffc757d0fb38fd7a2b95b1fe632e67f867d7022
Author:     Mateusz Piotrowski <0mp@FreeBSD.org>
AuthorDate: 2022-06-30 13:27:21 +0000
Commit:     Mateusz Piotrowski <0mp@FreeBSD.org>
CommitDate: 2022-07-22 00:27:21 +0000

    sysctl.conf.5: Document rc.d/sysctl and rc.d/sysctl_lastload
    
    Also, update the BUGS section. The example describes an issue, which is
    not true anymore thanks to sysctl_lastload. Point readers to rcorder(8)
    instead.
    
    MFC after:      2 weeks
    
    (cherry picked from commit 383ccaa4050e3cbbd8ce8163c8aebd07c3d94ab1)
---
 share/man/man5/sysctl.conf.5 | 29 ++++++++++++++++++-----------
 1 file changed, 18 insertions(+), 11 deletions(-)

diff --git a/share/man/man5/sysctl.conf.5 b/share/man/man5/sysctl.conf.5
index 99df8b794d83..f21aac6e726b 100644
--- a/share/man/man5/sysctl.conf.5
+++ b/share/man/man5/sysctl.conf.5
@@ -24,7 +24,7 @@
 .\"
 .\" $FreeBSD$
 .\"
-.Dd April 8, 2021
+.Dd June 30, 2022
 .Dt SYSCTL.CONF 5
 .Os
 .Sh NAME
@@ -50,9 +50,19 @@ at the beginning of a line.
 Comments can also exist at the end of a line,
 as seen in the
 .Sx EXAMPLES
-section, below.
+section.
 .Sh FILES
-.Bl -tag -width /etc/sysctl.conf.local -compact
+.Bl -tag -width /etc/rc.d/sysctl_lastload -compact
+.It Pa /etc/rc.d/sysctl
+.Xr rc 8
+script which processes
+.Nm
+early on in the process of transitioning to multi-user mode.
+.It Pa /etc/rc.d/sysctl_lastload
+.Xr rc 8
+script which processes
+.Nm
+shortly before the system reaches the multi-user mode.
 .It Pa /etc/sysctl.conf
 Initial settings for
 .Xr sysctl 8 .
@@ -81,11 +91,8 @@ If loadable kernel modules are used to introduce additional kernel
 functionality and sysctls to manage that functionality,
 .Nm
 may be processed too early in the boot process to set those sysctls.
-For example, sysctls to manage the Linux compatibility layer
-.Po
-.Xr linux 4
-.Pc
-cannot be set in
-.Nm
-if the Linux compatibility layer is loaded as a module rather than
-compiled into the kernel.
+Please consult
+.Xr rcorder 8
+to learn more about the ordering of
+.Xr rc 8
+scripts.