git: b183dae4a993 - main - build.7: Explain specifying multiple KERNCONFs
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Wed, 22 Apr 2026 17:32:02 UTC
The branch main has been updated by ziaee:
URL: https://cgit.FreeBSD.org/src/commit/?id=b183dae4a9934ed9bb91763b5f9d9d4e4d4120a2
commit b183dae4a9934ed9bb91763b5f9d9d4e4d4120a2
Author: Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-22 17:31:04 +0000
Commit: Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-04-22 17:31:04 +0000
build.7: Explain specifying multiple KERNCONFs
MFC after: 3 days
Reviewed by: ivy, mhorne
Differential Revision: https://reviews.freebsd.org/D56281
---
share/man/man7/build.7 | 19 ++++++++++++++-----
1 file changed, 14 insertions(+), 5 deletions(-)
diff --git a/share/man/man7/build.7 b/share/man/man7/build.7
index 7d1cb31fea1f..ef4e2c94a82f 100644
--- a/share/man/man7/build.7
+++ b/share/man/man7/build.7
@@ -25,7 +25,7 @@
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
.\" SUCH DAMAGE.
.\"
-.Dd April 13, 2026
+.Dd April 22, 2026
.Dt BUILD 7
.Os
.Sh NAME
@@ -578,11 +578,20 @@ name ${MACHINE_ARCH}-gcc<major version>.
.It Va INSTKERNNAME
If set, specify an alternative name to build and install for the various
kernel make targets.
+Defaults to
+.Dq Li kernel .
.It Va KERNCONF
-Overrides which kernel to build and install for the various kernel
-make targets.
-It defaults to
-.Cm GENERIC .
+Specify one or more space-separated kernels to build and install for the
+various kernel make targets.
+If multiple kernels are specified, the first listed kernel installs to
+.Pa /boot/${INSTKERNNAME} ,
+and subsequent kernels install to
+.Pa /boot/${INSTKERNNAME}.NAME .
+.Pp
+If unset, it defaults to GENERIC,
+except on POWER architectures,
+where it defaults to GENERIC64 for powerpc64,
+and GENERIC64LE for powerpc64le.
.It Va KERNBUILDDIR
Overrides the default directory to get all the opt_*.h files for
building a kernel module.