From nobody Sat Apr 25 17:03:14 2026 X-Original-To: dev-commits-src-branches@mlmmj.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mlmmj.nyi.freebsd.org (Postfix) with ESMTP id 4g2x3k6xj4z6bpqc for ; Sat, 25 Apr 2026 17:03:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "R13" (not verified)) by mx1.freebsd.org (Postfix) with ESMTPS id 4g2x3k48Mfz3HTw for ; Sat, 25 Apr 2026 17:03:14 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1777136594; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=5tFfzz9o23vokP4SAIVfubof8EC6QVOlOsIppr3uOLw=; b=IWdsfPoJTY/yxIniaXZTLsspqu80HammRc2CeRbW57aQbmOzvI0nPlQSdsb57dD7zdpSC4 ZVBnsdtuNaSk+GjH8pVC/yNux8FuEjVq8kSS10lvqZYnTPC54EuXJNN0HZoN8U9cnR+IiW sbTLFUpuzuS2vftQLbUH0zxvhHLw2BGgClX9RfvjjHn2RRVtprQ6ivZqMVpJQo0KjL9d8y 3jzkmhWuJr/3YuGgVN+nTGtzJJ5MZqkXN3TcUrHP2vURhdE97PPcyFbXhDQNrh9X5PyDGc dsbmbelqcDtH6BspNk91wkbeTMJ21tnOt6py/cFMZfXP/GQ9g5RowZfC8JzpFw== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1777136594; a=rsa-sha256; cv=none; b=aP7UKxYZoVXRKXAQi37EKsR0ECO+bkOgwuWMgDy1L6MLmgTVG4ynhEnb78gP8h9euw1gO5 kMbiC0QTPAh5o/EkMZXNKWMz+b251JmaON+t5+Gjbif/qvDAaVJtj88BYvMS5i5hpQbx/Y /PCsJn1V1tTesQH8+ErOR8O+GUtPsnhIG1JawkiJT5EeZJ8U8Y/m7dbLzjwmBbjAEICREv LHGhslzA6NgVabmGdqKls+oASDtEx7SggibvxgjPlcdj2auE3ek6S6oD9Gg8ajEZs9toZ2 Dhj++sWP6lQqR8L5wTqwrAt+QgrqQ8C+UuMJ50scU5sWHd8SSrGvhmiERnJgGg== ARC-Authentication-Results: i=1; mx1.freebsd.org; none ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1777136594; h=from:from:reply-to:subject:subject:date:date:message-id:message-id: to:to:cc:mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding; bh=5tFfzz9o23vokP4SAIVfubof8EC6QVOlOsIppr3uOLw=; b=qB1mqH+cRRfDUcLTemKpOU8LtQt1BZ0R0/KlwRaqX2wQuAI62//YAsgt4F0C2+K2/T89Od pJ2aiBOs1CDll+7FhfU2YhzmC5hAmIp/6EpeVA9upW8fZTZ3V1ejvAvZpwe6yTX+Ujc8jq 65afqVqhxDnfWs8cuRXL4zhT0ITJCYgwJsJ6bR62Nvt89Cn7djzxqQmbr2r3tMgDwrQkCg SP30yHqhMa+6XUi+o+Eu9Rc240wM642qOwpp+GVUELqUy5ZZknmVWXgPJ+NVOdM3DPfWGD 8H1nL+CqYKiGOonUGWmny50y3FeIR6lLRwxLPThEaRCTN8pFqpLSl77aK3/tLA== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4g2x3k3l7tzjqW for ; Sat, 25 Apr 2026 17:03:14 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 4733b by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Sat, 25 Apr 2026 17:03:14 +0000 To: src-committers@FreeBSD.org, dev-commits-src-all@FreeBSD.org, dev-commits-src-branches@FreeBSD.org From: Alexander Ziaee Subject: git: 7bb347ccc774 - stable/15 - build.7: Explain packaging a custom kernel List-Id: Commits to the stable branches of the FreeBSD src repository List-Archive: https://lists.freebsd.org/archives/dev-commits-src-branches List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-src-branches@freebsd.org Sender: owner-dev-commits-src-branches@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: ziaee X-Git-Repository: src X-Git-Refname: refs/heads/stable/15 X-Git-Reftype: branch X-Git-Commit: 7bb347ccc7740938b40a2551d98bc3f703eac955 Auto-Submitted: auto-generated Date: Sat, 25 Apr 2026 17:03:14 +0000 Message-Id: <69ecf3d2.4733b.40de1def@gitrepo.freebsd.org> The branch stable/15 has been updated by ziaee: URL: https://cgit.FreeBSD.org/src/commit/?id=7bb347ccc7740938b40a2551d98bc3f703eac955 commit 7bb347ccc7740938b40a2551d98bc3f703eac955 Author: Alexander Ziaee AuthorDate: 2026-04-22 17:26:45 +0000 Commit: Alexander Ziaee 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 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 :