Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 25 Apr 2026 17:03:15 +0000
From:      Alexander Ziaee <ziaee@FreeBSD.org>
To:        src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org
Subject:   git: e6b2a404fa82 - stable/15 - build.7: Explain specifying multiple KERNCONFs
Message-ID:  <69ecf3d3.18490.5897fe42@gitrepo.freebsd.org>

index | next in thread | raw e-mail

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.


home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?69ecf3d3.18490.5897fe42>