git: 09ffaa4e07d7 - main - loader manuals: Clarify console and boot_serial
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Fri, 14 Nov 2025 14:48:30 UTC
The branch main has been updated by ziaee:
URL: https://cgit.FreeBSD.org/src/commit/?id=09ffaa4e07d749c83cc1db13829505f21b025f29
commit 09ffaa4e07d749c83cc1db13829505f21b025f29
Author: Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-14 14:41:57 +0000
Commit: Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2025-11-14 14:45:14 +0000
loader manuals: Clarify console and boot_serial
console=comconsole is for the loader and boot_serial is for the kernel.
I think we should centralize documentation on the loader settings in one
manual, such a loader.8. The current proliferation is not obvious where
to find the documentation. To the user, these are all set in loader.conf
or at the loader prompt.
MFC after: 3 days
Differential Revision: https://reviews.freebsd.org/D53695
---
stand/defaults/loader.conf.5 | 3 +++
stand/man/loader_simp.8 | 4 ++--
2 files changed, 5 insertions(+), 2 deletions(-)
diff --git a/stand/defaults/loader.conf.5 b/stand/defaults/loader.conf.5
index b1661e8c1101..8c43bb62a135 100644
--- a/stand/defaults/loader.conf.5
+++ b/stand/defaults/loader.conf.5
@@ -343,6 +343,9 @@ selects the video console which prevents any input and hides all output
replacing it with
.Dq spinning
character (useful for embedded products and such).
+This setting is for the
+.Xr loader 8
+only and does not set the kernel output.
.It Va screen.font
Set font size for framebuffer mode.
The default font size is selected based on screen resolution.
diff --git a/stand/man/loader_simp.8 b/stand/man/loader_simp.8
index 683ca8b2da5d..52cb598fdd89 100644
--- a/stand/man/loader_simp.8
+++ b/stand/man/loader_simp.8
@@ -358,8 +358,8 @@ in
.Xr kenv 1 ,
not for any particular value.
.It Va boot_serial
-Force the use of a serial console even when an internal console
-is present.
+Force the use of a serial console for the kernel
+even when an internal console is present.
.It Va boot_single
Prevents the kernel from initiating a multi-user startup; instead,
a single-user mode will be entered when the kernel has finished