git: 027a3c5af6 - main - Status/2026Q3/sysconf.adoc: Use the filename macro
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Tue, 20 Oct 2026 16:39:02 UTC
The branch main has been updated by dteske:
URL: https://cgit.FreeBSD.org/doc/commit/?id=027a3c5af67035315839965ea38137120c5e9302
commit 027a3c5af67035315839965ea38137120c5e9302
Author: Devin Teske <dteske@FreeBSD.org>
AuthorDate: 2026-10-20 16:35:36 +0000
Commit: Devin Teske <dteske@FreeBSD.org>
CommitDate: 2026-10-20 16:35:36 +0000
Status/2026Q3/sysconf.adoc: Use the filename macro
Suggested by: salvadore
Approved by: salvadore
Reviewed by: salvadore
Differential Revision: https://reviews.freebsd.org/D60775
---
website/content/en/status/report-2026-07-2026-09/sysconf.adoc | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/website/content/en/status/report-2026-07-2026-09/sysconf.adoc b/website/content/en/status/report-2026-07-2026-09/sysconf.adoc
index b9facc2fa6..c48b4097fb 100644
--- a/website/content/en/status/report-2026-07-2026-09/sysconf.adoc
+++ b/website/content/en/status/report-2026-07-2026-09/sysconf.adoc
@@ -10,7 +10,7 @@ Contact: Faraz Vahedi <kfv@FreeBSD.org>
man:sysctl[8] speaks to the running kernel.
man:sysrc[8] speaks to man:rc.conf[5].
This quarter the set became three, and the new tool is a pleasure to use.
-man:sysconf[8] reads and writes the rest of the base configuration: man:loader.conf[5], man:sysctl.conf[5], and the man:make.conf[5] family (make.conf, src.conf, and src-env.conf).
+man:sysconf[8] reads and writes the rest of the base configuration: man:loader.conf[5], man:sysctl.conf[5], and the man:make.conf[5] family ([.filename]#make.conf#, [.filename]#src.conf#, and [.filename]#src-env.conf#).
The syntax is the one your fingers already know.
Given simply a name, reads back the value of the given name.
`name=value` writes, and the reply comes back in the familiar line: `name: old -> new`.
@@ -40,7 +40,7 @@ You name the format with the target.
`-f` names the path, so a loader-formatted file staged anywhere is still a loader file, and a `generic` target covers a file that matches no built-in.
Where the boot reads several files, sysconf reads those same files, in that same order.
-The loader target starts where the loader starts, at `/boot/defaults/loader.conf`, and follows `loader_conf_files`, `loader_conf_dirs`, and `local_loader_conf_files`, including a layout that points those lists somewhere else.
+The loader target starts where the loader starts, at [.filename]#/boot/defaults/loader.conf#, and follows `loader_conf_files`, `loader_conf_dirs`, and `local_loader_conf_files`, including a layout that points those lists somewhere else.
The value you read is the value that takes effect.
The value you write is stored where it will still take effect on the next boot.
A removal clears every file that lists the directive, so that an earlier setting does not simply get unmasked.
@@ -61,13 +61,13 @@ The sysctl target asks the running kernel before it stores anything.
An unknown OID, a read-only OID, a loader-only tunable, or a value outside the type's range is reported and skipped, and a loader-only tunable is pointed at the loader target, where a boot setting belongs.
Every other assignment in the same command still applies.
On make and src, `WITH_foo=no` is written and you are told at once to use `WITHOUT_foo=1` instead.
-That is the advice in `share/mk/bsd.mkopt.mk`, delivered at the keyboard, and repeated on a later read with the file and line so an old `WITH_*=no` stays in view.
+That is the advice in [.filename]#share/mk/bsd.mkopt.mk#, delivered at the keyboard, and repeated on a later read with the file and line so an old `WITH_*=no` stays in view.
`-j` and `-R` aim the same sentences at a jail or another root.
The introduction is in HEAD as of 3fe5961a0b70 (link:https://reviews.freebsd.org/D58066[D58066]), and man:sysconf[8] makes its first release in FreeBSD 16.0.
It has already grown since that commit.
-A unique prefix of a target is enough (`lo` is loader, `sy` is sysctl, `sr` is src), and a poudriere target carries the same verbs to `poudriere.conf` and the make overlays under `poudriere.d`.
+A unique prefix of a target is enough (`lo` is loader, `sy` is sysctl, `sr` is src), and a poudriere target carries the same verbs to [.filename]#poudriere.conf# and the make overlays under [.filename]#poudriere.d#.
Thanks to Robert Clausecker and Faraz Vahedi for review, and to Alexander Ziaee for the release notes.