git: e6b2a404fa82 - stable/15 - build.7: Explain specifying multiple KERNCONFs
- Go to: [ bottom of page ] [ top of archives ] [ this month ]
Date: Sat, 25 Apr 2026 17:03:15 UTC
The branch stable/15 has been updated by ziaee:
URL: https://cgit.FreeBSD.org/src/commit/?id=e6b2a404fa82f2124d4fd453ae51e4db3281c360
commit e6b2a404fa82f2124d4fd453ae51e4db3281c360
Author: Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-22 17:31:04 +0000
Commit: Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-04-25 17:02:56 +0000
build.7: Explain specifying multiple KERNCONFs
MFC after: 3 days
Reviewed by: ivy, mhorne
Differential Revision: https://reviews.freebsd.org/D56281
(cherry picked from commit b183dae4a9934ed9bb91763b5f9d9d4e4d4120a2)
---
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 f2c8395f6669..6d040b6f8f02 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
@@ -564,11 +564,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.