From 0326966428338218af7df5a32560d27e666c5f4b Mon Sep 17 00:00:00 2001 From: Andrew Ammerlaan Date: Tue, 20 Feb 2024 09:44:41 +0100 Subject: 2024-01-18-installkernel-merge: further clarifications - explicitly mention rEFInd - put instructions for UKI under its own header - update for new layout=compat so instructions here are again on the same page with the instructions in the next news item about the introduction of USE=systemd-boot. https://forums.gentoo.org/viewtopic-t-1167432-highlight-installkernel.html Signed-off-by: Andrew Ammerlaan --- .../2024-01-18-installkernel-merge.en.txt | 53 ++++++++++++++++++---- 1 file changed, 43 insertions(+), 10 deletions(-) diff --git a/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt b/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt index 96ff934..5af1ad1 100644 --- a/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt +++ b/2024-01-18-installkernel-merge/2024-01-18-installkernel-merge.en.txt @@ -1,7 +1,7 @@ Title: Merging of installkernel-gentoo and installkernel-systemd Author: Andrew Ammerlaan Posted: 2024-01-18 -Revision: 6 +Revision: 7 News-Item-Format: 2.0 Display-If-Installed: sys-kernel/installkernel Display-If-Installed: sys-kernel/installkernel-gentoo @@ -77,6 +77,31 @@ emerge --noreplace sys-kernel/installkernel emerge --depclean sys-kernel/installkernel-systemd +User Action Required (rEFInd users) +==================== + +Previously sys-kernel/installkernel-gentoo provided kernel installation +automation for users of rEFInd. The new sys-kernel/installkernel provides the +same functionality, which now works with both the traditional installkernel and +systemd's kernel-install. + +Users of rEFInd should: +- ensure that the "systemd-boot" and "grub" USE flags are NOT enabled when +upgrading to >=sys-kernel/installkernel-20. + +Additionally, users of rEFInd may want to +- enable the "refind" USE flag to +install an icon file alongside the installed kernel image which rEFInd will +pick up at runtime. + +Users of rEFInd may wish to explicitly choose either the traditional +installkernel or systemd's kernel-install, in which case they may do so +via USE=-/+systemd. + +sys-kernel/installkernel is renamed from sys-kernel/installkernel-gentoo, +therefore no further user action is required to upgrade to the new package. + + User Action Required (users of other bootloaders and custom scripts) ==================== @@ -85,16 +110,24 @@ plugins should either ensure that the same kernel installation method will be used after upgrading to >=sys-kernel/installkernel-14 (via USE=+/-systemd) or migrate these custom plugins (details are on the wiki [1]). -Users of bootloaders other than GRUB or systemd-boot may want to retain the -traditional /boot layout. They may do so by either: -- disabling the "systemd" USE flag, or -- when the "systemd" USE flag is enabled, enabling the "grub" USE flag as well. -- when the "systemd" USE flag is enabled, setting "layout=grub" in -/etc/kernel/install.conf +Users of bootloaders other than GRUB, systemd-boot or refind may want to retain +the traditional /boot layout. They may do so by: +- ensuring that the "systemd-boot", "grub" and "refind" USE flags are disabled. + + +Optional: Unified Kernel Images (all users) +==================== + +Users who wish to use Unified Kernel Images[2] (e.g. for EFI stub booting) may +do so by +- enabling the "ukify" and "uki" USE flags. +Which will automatically install a bootable EFI executable to the EFI system +partition. + +The UEFI firmware, as well as, Systemd-boot, GRUB and rEFInd are capable of +loading Unified Kernel Images. For more details see the wiki page on Unified +Kernel Images[2] -Users who wish to use EFI stub booting may be interested in building an -Unified Kernel Image[2] by enabling the "ukify" and "uki" USE flags. This will -automatically install a bootable EFI executable to the EFI system partition. [1] https://wiki.gentoo.org/wiki/Installkernel [2] https://wiki.gentoo.org/wiki/Unified_kernel_image -- cgit v1.2.3-65-gdbad