git: bba78121411a - releng/15.0 - loader manuals: Clarify console and boot_serial
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sun, 23 Nov 2025 16:39:08 UTC
The branch releng/15.0 has been updated by cperciva:
URL: https://cgit.FreeBSD.org/src/commit/?id=bba78121411a6ffe04e30960f8e8072a60d788cf
commit bba78121411a6ffe04e30960f8e8072a60d788cf
Author: Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2025-11-14 14:41:57 +0000
Commit: Colin Percival <cperciva@FreeBSD.org>
CommitDate: 2025-11-23 16:38:41 +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.
Approved by: re (cperciva)
MFC after: 3 days
Differential Revision: https://reviews.freebsd.org/D53695
(cherry picked from commit 09ffaa4e07d749c83cc1db13829505f21b025f29)
(cherry picked from commit 3035855815c2fdbe27b65b9ec0374f4583ceb3f5)
---
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