Subject: [bug#55231] [PATCH v5 2/3] doc: ‘initrd-modules’ will search ‘kernel-loadable-modules’.

From: Morgan Arnold <[email-masked]>
Date: Tue, 11 Feb 2025 14:56:30 +0000

From: Brian Cully <[email-masked]>

---
 doc/guix.texi | 15 +++++++++++++++
 1 file changed, 15 insertions(+)

diff --git a/doc/guix.texi b/doc/guix.texi
index bb5f29277f..2ca8bbda51 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -43252,6 +43252,21 @@ Initial RAM Disk
   (initrd-modules (cons "megaraid_sas" %base-initrd-modules)))
 @end lisp
 
+If a module listed in @code{initrd-modules} is not included in the
+Linux-libre kernel, then the location to it must be added to the
+@code{kernel-loadable-modules} list.
+
+For example, if you need the driver for a Realtek RTL8821CE wireless
+network adapter for mounting the root filesystem over NFS, your
+configuration might include the following:
+
+@lisp
+(operating-system
+  ;; @dots{}
+  (initrd-modules (cons "8821ce" %base-initrd-modules))
+  (kernel-loadable-modules (list (list rtl8821ce-linux-module "module"))))
+@end lisp
+
 @defvar %base-initrd-modules
 This is the list of kernel modules included in the initrd by default.
 @end defvar
-- 
2.47.1