Skip site navigation (1)Skip section navigation (2)
Date:      Sat, 25 Apr 2026 17:03:14 +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: 7bb347ccc774 - stable/15 - build.7: Explain packaging a custom kernel
Message-ID:  <69ecf3d2.4733b.40de1def@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=7bb347ccc7740938b40a2551d98bc3f703eac955

commit 7bb347ccc7740938b40a2551d98bc3f703eac955
Author:     Alexander Ziaee <ziaee@FreeBSD.org>
AuthorDate: 2026-04-22 17:26:45 +0000
Commit:     Alexander Ziaee <ziaee@FreeBSD.org>
CommitDate: 2026-04-25 17:02:56 +0000

    build.7: Explain packaging a custom kernel
    
    MFC after:              3 days (to 15 only)
    Requested by:           vermaden
    Discussed with:         emaste, ivy, Mark Millard <markmi_dsl-only.net>
    Differential Revision:  https://reviews.freebsd.org/D56217
    
    (cherry picked from commit 1bcd2e2f8311b737170e4bae8381dcb7de2c4413)
---
 share/man/man7/build.7 | 19 +++++++++++++++----
 1 file changed, 15 insertions(+), 4 deletions(-)

diff --git a/share/man/man7/build.7 b/share/man/man7/build.7
index d15b08d5a2ce..f2c8395f6669 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 6, 2026
+.Dd April 13, 2026
 .Dt BUILD 7
 .Os
 .Sh NAME
@@ -1018,7 +1018,7 @@ After testing the new system and verifying that your applications do not
 depend on them, delete the old libraries:
 .Pp
 .Dl make delete-old-libs
-.Ss Example 2: Build and upgrade a custom kernel in place
+.Ss Example 2: Build and upgrade a custom kernel
 Create a custom kernel configuration,
 .Va MYKERNEL ,
 by including an existing configuration and using
@@ -1036,7 +1036,7 @@ EOF
 .Ed
 .Pp
 After creating the new kernel configuration, build a fresh toolchain,
-build the kernel, and install it, moving the old kernel to
+build the kernel, and install it directly, moving the old kernel to
 .Pa /boot/kernel.old/ :
 .Bd -literal -offset indent
 make kernel-toolchain
@@ -1045,7 +1045,18 @@ make -DALWAYS_CHECK_MAKE installkernel KERNCONF=MYKERNEL
 shutdown -r now
 .Ed
 .Pp
-To build the kernel to an alternate location, use the
+To package the kernel into a
+.Xr freebsd-base 7
+package instead of installing it directly, use
+.Cm update-packages
+instead of
+.Cm installkernel :
+.Bd -literal -offset indent
+make buildworld buildkernel KERNCONF=MYKERNEL
+make update-packages KERNCONF=MYKERNEL
+.Ed
+.Pp
+To install the kernel directly to an alternate location, use the
 .Va INSTKERNNAME
 variable and boot it once to test via
 .Xr nextboot 8 :


home | help

Want to link to this message? Use this
URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?69ecf3d2.4733b.40de1def>