git: afd63daac3 - main - [hb][ports]: Briefly mention kmods repositories

Fernando Apesteguía <[email protected]>
Newsgroups gmane.os.freebsd.devel.cvs.doc
Message-ID <[email protected]>
The branch main has been updated by fernape:

URL: https://cgit.FreeBSD.org/doc/commit/?id=afd63daac31c57cdb117a95afa252a52a7658155

commit afd63daac31c57cdb117a95afa252a52a7658155
Author:     Fernando Apesteguía <[email protected]>
AuthorDate: 2025-05-20 15:47:05 +0000
Commit:     Fernando Apesteguía <[email protected]>
CommitDate: 2025-07-31 15:56:27 +0000

    [hb][ports]: Briefly mention kmods repositories
    
    Reviewed by:            bcr@
    Differential Revision:  https://reviews.freebsd.org/D51614
---
 .../content/en/books/handbook/ports/_index.adoc    | 46 ++++++++++++++++++++++
 1 file changed, 46 insertions(+)

diff --git a/documentation/content/en/books/handbook/ports/_index.adoc b/documentation/content/en/books/handbook/ports/_index.adoc
index ac4cf4ce70..fe7001ab82 100644
--- a/documentation/content/en/books/handbook/ports/_index.adoc
+++ b/documentation/content/en/books/handbook/ports/_index.adoc
@@ -211,6 +211,52 @@ Then run this command to update the local package repositories catalogues for th
 # pkg update -f
 ....
 
+[[kmod-repository]]
+=== Kernel modules repositories
+
+The kernel module repositories allow users to install ready to use kernel
+modules like the ones used for graphic drivers and specific hardware.
+Starting with FreeBSD 14.3, the FreeBSD Project provides kernel modules built
+for every supported version. To create such a repository configuration if it
+does not exist, add the following to [.filename]#/usr/local/etc/pkg/repos/kmods.conf#:
+[source,shell]
+....
+FreeBSD-kmods: {
+        url: "pkg+https://pkg.FreeBSD.org/${ABI}/KMODSFLAVOR",
+        mirror_type: "srv",
+        signature_type: "fingerprints",
+        fingerprints: "/usr/share/keys/pkg",
+        enabled: yes
+}
+....
+
+`KMODSFLAVOR` respects the following pattern: `kmods_PORTBRANCH_MINORRELEASE`.
+
+For instance:
+
+.Kmodsflavor
+
+[options="header", cols="1,1,1"]
+|===
+| FreeBSD Release | ports main | ports quarterly
+
+| FreeBSD 14.2-RELEASE
+| kmods_latest_2
+| kmods_quarterly_2
+
+| FreeBSD 14.3-RELEASE
+| kmods_latest_3
+| kmods_quarterly_3
+
+| FreeBSD 14.3-STABLE
+| kmods_latest
+| kmods_quarterly
+
+| FreeBSD 15.0-CURRENT
+| kmods_latest
+| 
+|===
+
 [[pkg-configuration]]
 === Configure pkg
lmpx.com only provides a reader for public news (NNTP) servers. It is not affiliated with the servers or forums shown here and is not responsible for the content of articles, which is written by their respective authors.