Documentation updates about how to use the overlay (quickstart coming soon)

This commit is contained in:
projectmoon 2023-03-01 07:42:34 +01:00
parent 9bd4dbae06
commit 59869deebb
1 changed files with 39 additions and 3 deletions

View File

@ -36,6 +36,7 @@ Individual packages can be unmasked (and added to
``` ```
sys-kernel/libre-kernel::projectmoon sys-kernel/libre-kernel::projectmoon
virtual/dist-kernel::projectmoon virtual/dist-kernel::projectmoon
sec-keys/openpgp-keys-linux-libre::projectmoon
``` ```
## The Linux-libre dist-kernel ## The Linux-libre dist-kernel
@ -58,6 +59,41 @@ package is not found at all, like normal dist-kernel ebuilds.
The kernel installed by this ebuild has the version suffix The kernel installed by this ebuild has the version suffix
`-gnu-dist`, making it easy to determine which kernel it is. `-gnu-dist`, making it easy to determine which kernel it is.
### Signature Verification
It is recommended to enable GPG signature verification of
`sys-kenrel/libre-kernel` by adding the USE flag to
`/etc/portage/package.use`:
```
sys-kernel/libre-kernel verify-sig
```
### Keeping the Linux-libre Kernel Installed
Portage will sometimes try to install `sys-kernel/gentoo-kernel` or
another dist-kernel if there is a newer stable version than
`sys-kernel/libre-kernel`. This happens because of a version bump to
`virtual/dist-kernel` before this overlay has updated its own copy of
`virtual/dist-kernel`.
To prevent portage from attempting to install another dist-kernel
instead of the Linux-libre kernel, you should mask other dist-kernels in
`/etc/portage/package.mask`:
```
# stay on libre kernel
sys-kernel/gentoo-kernel
sys-kernel/gentoo-kernel-bin
sys-kernel/vanilla-kernel
```
### Linux Firmware
*Note: If you are running the Linux-libre kernel, it is unlikely (though
not impossible) that you need to install `sys-kernel/linux-firmware`.*
To install only the Linux firmware that meets the [Free Software To install only the Linux firmware that meets the [Free Software
Definition][free-software], configure `/etc/portage/package.use` Definition][free-software], configure `/etc/portage/package.use`
accordingly: accordingly:
@ -87,9 +123,9 @@ This ebuild supports the `dist-kernel` USE flag, and the module will
automatically be rebuilt when installing a new dist-kernel if that automatically be rebuilt when installing a new dist-kernel if that
flag is enabled. flag is enabled.
If you are not using a dist-kernel, when upgrading or installing a new If you are not using a dist-kernel, you will need to do `emerge
kernel, you will need to do `emerge @modules-rebuild` to install the @modules-rebuild` to install the module after you upgrade or install a
module for the new kernel. new kernel,
### Librem Control and the Purism EC Tool ### Librem Control and the Purism EC Tool