From nobody Thu Jun 30 14:22:32 2022 X-Original-To: dev-commits-src-all@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 6D08F87011E; Thu, 30 Jun 2022 14:22:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4LYgX82gqHz4rbD; Thu, 30 Jun 2022 14:22:32 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656598952; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=KZhG1/c20tU+ym4EkNE3++3kGRMhtDtAcBjYJE/6KSA=; b=l2+rN77Us+VAMLC3yxtdpV0/w72enx1Pofg42opfFxF0R558A0rJ5+r+tka3DGAIi5QfKC bwTzax6Hmx/R6lGECg0QHPrqAmo+/dJ3F6VqFacArJhcUnZy8duF/xfk786Zs/vPZlcWTm n7rREa9QDYWBOLi4eyf10m2C4RkRb3n9MQ/84ow+gFUCXl15WyiHCw2tIzdiDMu9ZhhPg1 0Ha2s58ni0nzu9llLosLKz6vsxBz1+StZXL/SE4MGTVHL9l+mNonLH0g32fNaI/fe8av5m Jcrs/vgwigjtsfTq14BjBGFcJ5HY8bqVo9McOS9HDYO2WEVA9eptdpgjQD9U8A== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id 3BA4F27FB2; Thu, 30 Jun 2022 14:22:32 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from gitrepo.freebsd.org ([127.0.1.44]) by gitrepo.freebsd.org (8.16.1/8.16.1) with ESMTP id 25UEMWDP064284; Thu, 30 Jun 2022 14:22:32 GMT (envelope-from git@gitrepo.freebsd.org) Received: (from git@localhost) by gitrepo.freebsd.org (8.16.1/8.16.1/Submit) id 25UEMWc5064283; Thu, 30 Jun 2022 14:22:32 GMT (envelope-from git) Date: Thu, 30 Jun 2022 14:22:32 GMT Message-Id: <202206301422.25UEMWc5064283@gitrepo.freebsd.org> To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-main@FreeBSD.org From: Mateusz Piotrowski <0mp@FreeBSD.org> Subject: git: 383ccaa4050e - main - sysctl.conf.5: Document rc.d/sysctl and rc.d/sysctl_lastload List-Id: Commit messages for all branches of the src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: Sender: owner-dev-commits-src-all@freebsd.org X-BeenThere: dev-commits-src-all@freebsd.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: 0mp X-Git-Repository: src X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 383ccaa4050e3cbbd8ce8163c8aebd07c3d94ab1 Auto-Submitted: auto-generated ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1656598952; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=KZhG1/c20tU+ym4EkNE3++3kGRMhtDtAcBjYJE/6KSA=; b=Wmd2W8jaOKEjjL5LE1zj2+eInlKTS1VhCaQehhKiFWAX+WEFtzt/I37rQkIRpqcwhgVwpx oYtGjJtvExGjA0/L/wAr+bBIIqDvvicKBWcxEgn5oLRK84jwqFm3jWr12sOp8NWRjeN1Cl LZNpBRf+5h6mVCnXmaLVUAZaC4ROnaayXZH74ZA1kBNx5QKFcfLp/CMTtM+3oY9QSDVlEY nyZ5ymMrG314/YqFITxaJHAZdumBNmENT/+kBngDxZ7dcduXhy6mfSjxm5uHnH7JI/aVmD +tbNsx0/VQkCFmZBAkaQXSWfvHhZF7SAWlvjaURYnH5zAw23TWsbAuFZoWr28A== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1656598952; a=rsa-sha256; cv=none; b=CQNnYdX6zc+R/8WhAkju9fOqF6lyVPOctbpNeZxWExWmAjbLO541xyYorfoY8myxFgUD7H fdTVQ6UPhJoyN0/2NHAsYgRtYZYxiUfxfwY/mOYVxJVfLGRWFvV5oXF/pKtkjec3YM01IA 9lDT5FvCtCBgVJvbfIDEaro1fEqquG4X3ccyCRYBkTUYsZ/Cn99YJsaRCm/0rR828aZ2RZ dklYzxGvbsHBcvNtkNyHYETD9qi9B7feM1bfkEi/QikqXX+ux4fdNqNOd6ChtGI7H8afWK 9Xvf64O9/3qvgXNbt+XEiMXqNUZlwyQkcdG57G8kzrnEC3QW8AOgwfWgwWyASA== ARC-Authentication-Results: i=1; mx1.freebsd.org; none X-ThisMailContainsUnwantedMimeParts: N The branch main has been updated by 0mp (doc, ports committer): URL: https://cgit.FreeBSD.org/src/commit/?id=383ccaa4050e3cbbd8ce8163c8aebd07c3d94ab1 commit 383ccaa4050e3cbbd8ce8163c8aebd07c3d94ab1 Author: Mateusz Piotrowski <0mp@FreeBSD.org> AuthorDate: 2022-06-30 13:27:21 +0000 Commit: Mateusz Piotrowski <0mp@FreeBSD.org> CommitDate: 2022-06-30 14:22:01 +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 --- 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.