diff options
| author | Sergio Pastor Pérez <sergio.pastor-perez@inria.fr> | 2026-07-20 10:21:51 +0200 |
|---|---|---|
| committer | Vagrant Cascadian <vagrant@debian.org> | 2026-08-27 00:05:04 -0700 |
| commit | 7b017250d937e08137dcb33dd67c97d6332534b7 (patch) | |
| tree | da5164c56a7697f40219dba65b52d5f9346d54c7 /doc | |
| parent | 38a7797012907bc8e0ec5f6d4e76aede9666e38a (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.texi | 19 |
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 | |||
| 19080 | Window System. | 19080 | Window 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 |
| 19086 | The list of Linux kernel modules that need to be available in the | 19086 | The 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 | ||
| 49840 | Other useful kernel modules include those necessary for a | 49842 | Other 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 |
| 49845 | This is the list of kernel modules included in the initrd by default. | 49847 | @deffn {Procedure} base-initrd-modules kernel [system] |
| 49846 | @end defvar | 49848 | Return a list of modules tailored to @var{kernel} for @var{system} to |
| 49849 | include in the initrd by default. | ||
| 49850 | @end deffn | ||
| 49851 | |||
| 49852 | @quotation Deprecation notice | ||
| 49853 | This was formerly known as @var{%base-initrd-modules}. It is recommended | ||
| 49854 | that you switch to using @code{(base-initrd-modules linux-libre)}. | ||
| 49855 | @end quotation | ||
| 49847 | 49856 | ||
| 49848 | Furthermore, if you need lower-level customization, the @code{initrd} | 49857 | Furthermore, if you need lower-level customization, the @code{initrd} |
| 49849 | field of an @code{operating-system} declaration allows | 49858 | field of an @code{operating-system} declaration allows |
