Lispln/nonguix
1
0
Fork 0
mirror of https://gitlab.com/nonguix/nonguix.git synced 2024-11-22 08:28:09 +01:00
Code Issues Projects Releases Packages Wiki Activity Actions

README.org: Illustrate use of 'microcode-initrd'.

Browse source 
Closes #14.

* README.org: Update example 'operating-system' definition to include
'microcode-initrd'.
This commit is contained in:
Alex Griffin 2020-01-08 12:46:32 -06:00
parent 1d7177a786
commit 6ece1a5da7
1 changed files with 36 additions and 1 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

37
README.org
View file

@ -61,10 +61,12 @@ the ~kernel~ and ~firmware~ fields of the ~operating-system~ definition in
#+BEGIN_SRC scheme #+BEGIN_SRC scheme
;; Import nonfree linux module. ;; Import nonfree linux module.
(use-modules (nongnu packages linux)) (use-modules (nongnu packages linux)
(nongnu system linux-initrd))
(operating-system (operating-system
(kernel linux) (kernel linux)
(initrd microcode-initrd)
(firmware (list linux-firmware)) (firmware (list linux-firmware))
... ...
) )
@ -91,6 +93,39 @@ nonfree Linux kernel and nonfree firmware with the following command:
guix system disk-image /path/to/this/channel/nongnu/system/install.scm guix system disk-image /path/to/this/channel/nongnu/system/install.scm
#+end_src #+end_src
** CPU Microcode
CPU microcode updates are nonfree blobs that apply directly to a processor to
patch its behavior, and are therefore not included in upstream GNU Guix.
However, running the latest microcode is important to avoid nasty CPU bugs and
hardware security vulnerabilities.
To enable early loading of CPU microcode, use the ~microcode-initrd~ function
to add the microcode to the Initial RAM Disk. Most users can simply import
~(nongnu system linux-initrd)~ and add ~(initrd microcode-initrd)~ to their
~operating-system~ definition, as illustrated above.
If you need to customize the ~initrd~ for some reason, you should first
understand the upstream documentation on
[[https://guix.gnu.org/manual/en/html_node/Initial-RAM-Disk.html][Initial RAM Disks]].
~microcode-initrd~ simply wraps another ~initrd~ function, which you can swap
out for your own. For example, this:
#+BEGIN_SRC scheme
(initrd microcode-initrd)
#+END_SRC
is exactly equivalent to:
#+BEGIN_SRC scheme
(initrd (lambda (file-systems . rest)
(apply microcode-initrd file-systems
#:initrd base-initrd
#:microcode-packages (list amd-microcode
intel-microcode)
rest)))
#+END_SRC
** Broadcom Wireless ** Broadcom Wireless
Some Broadcom wireless hardware requires a proprietary kernel module in Some Broadcom wireless hardware requires a proprietary kernel module in