summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSergio Pastor Pérez <sergio.pastor-perez@inria.fr>2026-07-20 10:21:51 +0200
committerVagrant Cascadian <vagrant@debian.org>2026-08-27 00:05:04 -0700
commit7b017250d937e08137dcb33dd67c97d6332534b7 (patch)
treeda5164c56a7697f40219dba65b52d5f9346d54c7 /doc
parent38a7797012907bc8e0ec5f6d4e76aede9666e38a (diff)
gnu: linux: Use package properties to modularize initrd build.
* doc/guix.texi (operating-system Reference): Document initrd-modules change. (Initial RAM Disk): Inform about deprecation of '%base-initrd-modules' and document 'base-initrd-modules'. * gnu/packages/linux.scm (make-linux*): New argument 'produced-modules'. Handle GEXP in 'defconfig' arguments. (virtio-modules, default-linux-libre-initrd-modules): New variable. (make-linux-libre*): Adjust to instruct 'make-linux*' which modules a Debian configuration will produce. * gnu/system.scm (<operating-system>): Compute default operating systems initrd modules with 'base-initrd-modules'. * gnu/system/linux-initrd.scm (default-initrd-modules): Remove in favor of 'base-initrd-modules' which takes a mandatory kernel argument from which to extract the initrd-modules from the package properties. (base-initrd-modules): New procedure. (%base-initrd-modules): Deprecate in favor of 'base-initrd-modules'.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi19
1 files changed, 14 insertions, 5 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 49ae745d83e..19be19c6d20 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -19080,7 +19080,7 @@ Window}, for information on how to specify the keyboard layout used by the X
19080Window System. 19080Window System.
19081@end quotation 19081@end quotation
19082 19082
19083@item @code{initrd-modules} (default: @code{%base-initrd-modules}) 19083@item @code{initrd-modules} (default: @code{(base-initrd-modules (operating-system-kernel this-operating-system))})
19084@cindex initrd 19084@cindex initrd
19085@cindex initial RAM disk 19085@cindex initial RAM disk
19086The list of Linux kernel modules that need to be available in the 19086The list of Linux kernel modules that need to be available in the
@@ -49834,16 +49834,25 @@ file system, you would write:
49834@lisp 49834@lisp
49835(operating-system 49835(operating-system
49836 ;; @dots{} 49836 ;; @dots{}
49837 (initrd-modules (cons "megaraid_sas" %base-initrd-modules))) 49837 (initrd-modules (cons "megaraid_sas"
49838 (base-initrd-modules (operating-system-kernel
49839 this-operating-system)))))
49838@end lisp 49840@end lisp
49839 49841
49840Other useful kernel modules include those necessary for a 49842Other useful kernel modules include those necessary for a
49841@code{raid-device-mapping}, e.g. @code{raid1}, @code{raid456} and 49843@code{raid-device-mapping}, e.g. @code{raid1}, @code{raid456} and
49842@code{raid10} (@pxref{Mapped Devices}). 49844@code{raid10} (@pxref{Mapped Devices}).
49843 49845
49844@defvar %base-initrd-modules 49846@vindex %base-initrd-modules
49845This is the list of kernel modules included in the initrd by default. 49847@deffn {Procedure} base-initrd-modules kernel [system]
49846@end defvar 49848Return a list of modules tailored to @var{kernel} for @var{system} to
49849include in the initrd by default.
49850@end deffn
49851
49852@quotation Deprecation notice
49853This was formerly known as @var{%base-initrd-modules}. It is recommended
49854that you switch to using @code{(base-initrd-modules linux-libre)}.
49855@end quotation
49847 49856
49848Furthermore, if you need lower-level customization, the @code{initrd} 49857Furthermore, if you need lower-level customization, the @code{initrd}
49849field of an @code{operating-system} declaration allows 49858field of an @code{operating-system} declaration allows