From nobody Fri Feb 13 18:34:06 2026 X-Original-To: dev-commits-doc-all@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 4fCLRS0Zynz6RYVk for ; Fri, 13 Feb 2026 18:34:12 +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" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4fCLRR72y9z45rc for ; Fri, 13 Feb 2026 18:34:11 +0000 (UTC) (envelope-from git@FreeBSD.org) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=freebsd.org; s=dkim; t=1771007652; 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=1wBCH4eLlgbZMl8n4/FShHZcxDHUcTbBGbl0W3XPd30=; b=ap4OVwrxLlJCVDVwin+TuN6eNfnCSVOfH1Yra1KZbOiPuOnPB//5VueAS6xqd7sfltUZvk cCI6fEEHUf2bJIRYG8vMNyQnI58ipd/JFeBRXipcrRXfiJtZjwYr9x2RiHyEJ19dDf7Mwu UiHeqDruGbtjjnvQrBoY4Q71DwDhmZ9k7e7IFtkikeL0VGsOwFq0XuHu5ez8NwuKhloghW Kn58x5eDvde23HCuOksJG0IBUq219lAEIOye1D8La49UW6OXDPgnAvtY3b1ltuCcZF4tiW TKeTpNbE8tlB7Vmr/eVfxBefQItnrW33Nek+clKBChp4AG+5jSq6rnAXoO6h8w== ARC-Seal: i=1; s=dkim; d=freebsd.org; t=1771007652; a=rsa-sha256; cv=none; b=PMUlX37s00W4sL99lhx+RSw7A7youQXgmE47E0IxkGQYF7l75CPGNN8pt4JqY5iT8kIvxa LuAUxrTGvHGcYLYAVC7QXSqcjUkRycZwHajshvI0wwjjV0/bMSqQYxdCrA3IlJnni6Rl8N xkdo4TMQRboc2qX8qoJ2hjRwEJ4Xy0q3FZi1pceIdCDuApiN3yXcQmkNbazJgxTHYzZloj 7TevfIhBskC+nUCHRnohPlZNloGY0dCj9Zb7KTd3fzFHCCEvokUTgem9jJy2dL30RYZQlK WJZcb9yML5flQkaXtpkik6s+kDoAOuKrAAT/k78rq/4Gjrop8cpwpPb2EGHrJw== 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=1771007652; 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=1wBCH4eLlgbZMl8n4/FShHZcxDHUcTbBGbl0W3XPd30=; b=mgCKkxxKUOLl9SlEFSerHgmnVRdHcTgiWxzBtY6FNGBxNnrfKOyaXFt4dNbINwP4mdfupq Ly2RlQz3PTMffqP4l3cnPeIRUKW8MMw16rSq3KnT4NShBCVnAIaYGjufFEkHqhwxtmeUkV ZRlZBoCRpb+84BnUhGqsqgoP9P44BUTpVA9e30Vfv55wWZ6rT+mCY2mPFu7i6ZPHyZxYHl b7jWBAfsquRevLYDXfiyA3aOH9ZpQffinWqRIKl1RkZdf4vCnmMd+mFghoLQS/dngcK2Q3 PkKtDYbotysbj8rPE6ljmK8MvjGnyit8tda9KoV9y5T0ffcHC4xhMMwDKxJUTg== Received: from gitrepo.freebsd.org (gitrepo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:5]) by mxrelay.nyi.freebsd.org (Postfix) with ESMTP id 4fCLRR6Xx8zYqq for ; Fri, 13 Feb 2026 18:34:11 +0000 (UTC) (envelope-from git@FreeBSD.org) Received: from git (uid 1279) (envelope-from git@FreeBSD.org) id 3937c by gitrepo.freebsd.org (DragonFly Mail Agent v0.13+ on gitrepo.freebsd.org); Fri, 13 Feb 2026 18:34:06 +0000 To: doc-committers@FreeBSD.org, dev-commits-doc-all@FreeBSD.org From: Sergio Carlavilla Delgado Subject: git: 1556932a72 - main - Handbook - Kernelconfig: Restore PORTS_MODULES section List-Id: Commit messages for all branches of the doc repository List-Archive: https://lists.freebsd.org/archives/dev-commits-doc-all List-Help: List-Post: List-Subscribe: List-Unsubscribe: X-BeenThere: dev-commits-doc-all@freebsd.org Sender: owner-dev-commits-doc-all@FreeBSD.org MIME-Version: 1.0 Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: 8bit X-Git-Committer: carlavilla X-Git-Repository: doc X-Git-Refname: refs/heads/main X-Git-Reftype: branch X-Git-Commit: 1556932a7258a8d0090a0e85440fd0c9753e59ab Auto-Submitted: auto-generated Date: Fri, 13 Feb 2026 18:34:06 +0000 Message-Id: <698f6e9e.3937c.6ce70ddf@gitrepo.freebsd.org> The branch main has been updated by carlavilla: URL: https://cgit.FreeBSD.org/doc/commit/?id=1556932a7258a8d0090a0e85440fd0c9753e59ab commit 1556932a7258a8d0090a0e85440fd0c9753e59ab Author: Sergio Carlavilla Delgado AuthorDate: 2026-02-13 18:33:15 +0000 Commit: Sergio Carlavilla Delgado CommitDate: 2026-02-13 18:33:15 +0000 Handbook - Kernelconfig: Restore PORTS_MODULES section Reported by: des@ --- .../en/books/handbook/kernelconfig/_index.adoc | 21 +++++++++++++++++++-- 1 file changed, 19 insertions(+), 2 deletions(-) diff --git a/documentation/content/en/books/handbook/kernelconfig/_index.adoc b/documentation/content/en/books/handbook/kernelconfig/_index.adoc index 9769a57018..aa8e845f14 100644 --- a/documentation/content/en/books/handbook/kernelconfig/_index.adoc +++ b/documentation/content/en/books/handbook/kernelconfig/_index.adoc @@ -292,8 +292,7 @@ Once the edits to the custom configuration file have been saved, the source code # make installkernel KERNCONF=MYKERNEL .... + -. Shutdown the system and reboot into the new kernel. If something goes wrong, - refer to crossref:kernelconfig[kernelconfig-noboot, The kernel does not boot]. +. Shutdown the system and reboot into the new kernel. If something goes wrong, refer to crossref:kernelconfig[kernelconfig-noboot, The kernel does not boot]. ==== By default, when a custom kernel is compiled, all kernel modules are rebuilt. @@ -313,6 +312,24 @@ Alternately, this variable lists which modules to exclude from the build process WITHOUT_MODULES = linux acpi sound .... +This variable instructs the build to skip kernel modules and compile only the kernel itself: + +[.programlisting] +.... +NO_MODULES = yes +.... + +The Ports Framework includes drivers and other modules that depend on kernel interfaces, such as package:graphics/drm-kmod[] or package:emulators/virtualbox-ose-kmod[]. +With the `PORTS_MODULES` variable, every time the kernel is built, the ports containing kernel modules are re‑built against the updated sources. +This ensures the kernel module stays in‑sync with the kernel itself. +The kernel and ports trees should be updated together for maximum compatibility. +`PORTS_MODULES` can be added to [.filename]#/etc/make.conf# to ensure all kernels you build also rebuild these modules. + +[.programlisting] +.... +PORTS_MODULES = drm-kmod virtualbox-ose-kmod +.... + Additional variables are available. Refer to man:make.conf[5] for details.