From 83e95a849add833c726c14543a5beaaf1f266a00 Mon Sep 17 00:00:00 2001 From: Eric Naim Date: Fri, 16 Aug 2024 21:01:11 +0700 Subject: [PATCH 1/3] docs: Rename boot loader -> boot manager When talking about UEFI systems, the correct term to refer to systemd-boot, rEFInd and even GRUB is boot manager. Boot manager is not the same as a boot loader. A boot loader handles the task of loading an OS kernel into memory, often along with support files such as a Linux initial RAM disk (initrd) file, and starting the kernel running. On the other hand, a boot manager presents a menu of options to boot into, along with some other way to control the boot process. After the user selects an option, the boot manager will hand off control of booting to the OS. --- astro.config.mjs | 8 ++++---- src/content/docs/cachyos_basic/why_cachyos.md | 2 +- ..._configuration.md => boot_manager_configuration.md} | 8 ++++---- src/content/docs/configuration/secure_boot_setup.mdx | 10 +++++----- .../installation/{bootloaders.md => boot_managers.md} | 0 .../installation/{bootloaders.md => boot_managers.md} | 4 ++-- .../docs/installation/installation_handheld.mdx | 2 +- .../installation/{bootloaders.md => boot_managers.md} | 0 8 files changed, 17 insertions(+), 17 deletions(-) rename src/content/docs/configuration/{bootloader_configuration.md => boot_manager_configuration.md} (88%) rename src/content/docs/cs/installation/{bootloaders.md => boot_managers.md} (100%) rename src/content/docs/installation/{bootloaders.md => boot_managers.md} (98%) rename src/content/docs/sk/installation/{bootloaders.md => boot_managers.md} (100%) diff --git a/astro.config.mjs b/astro.config.mjs index b6a73676..355662df 100644 --- a/astro.config.mjs +++ b/astro.config.mjs @@ -117,12 +117,12 @@ export default defineConfig({ link: 'installation/installation_prepare', }, { - label: 'Bootloaders', + label: 'Boot Managers', translations: { sk: 'Boot manažéry', cs: 'Boot manažeři', }, - link: 'installation/bootloaders', + link: 'installation/boot_managers', }, { label: 'Filesystem', @@ -226,8 +226,8 @@ export default defineConfig({ link: 'configuration/post_install_setup', }, { - label: 'Bootloader Configuration', - link: 'configuration/bootloader_configuration', + label: 'Boot Manager Configuration', + link: 'configuration/boot_manager_configuration', }, { label: 'Dual GPU Laptops (NVIDIA + iGPU)', diff --git a/src/content/docs/cachyos_basic/why_cachyos.md b/src/content/docs/cachyos_basic/why_cachyos.md index 90c76f25..40f871c0 100644 --- a/src/content/docs/cachyos_basic/why_cachyos.md +++ b/src/content/docs/cachyos_basic/why_cachyos.md @@ -5,7 +5,7 @@ description: Why CachyOS may be better for you CachyOS offers a polished Arch experience, complete with a user-friendly installer, pre-configured desktops, performance optimizations without compromising the user experience. -Besides performance changes, we provide a ready to go setup for NVIDIA GPUs, ZFS which is built into some of our kernels and miscellaneous tools +Besides performance changes, we provide a ready to go setup for NVIDIA GPUs, ZFS which is built into some of our kernels and miscellaneous tools ## Optimized Packages and Repositories CachyOS maintains its own repositories with optimized packages, especially for your hardware. diff --git a/src/content/docs/configuration/bootloader_configuration.md b/src/content/docs/configuration/boot_manager_configuration.md similarity index 88% rename from src/content/docs/configuration/bootloader_configuration.md rename to src/content/docs/configuration/boot_manager_configuration.md index b0e742bc..d6cf78f9 100644 --- a/src/content/docs/configuration/bootloader_configuration.md +++ b/src/content/docs/configuration/boot_manager_configuration.md @@ -1,6 +1,6 @@ --- -title: Bootloader Configuration -description: Configure bootloader settings and pass kernel parameters to the command line +title: Boot Manager Configuration +description: Configure boot manager settings and pass kernel parameters to the command line --- ## systemd-boot @@ -40,7 +40,7 @@ After making changes, regenerate all systemd-boot entries with the following com ## rEFInd -Like [systemd-boot](/configuration/bootloader_configuration#systemd-boot), rEFInd has two configuration files. `refind.conf` located in +Like [systemd-boot](/configuration/boot_manager_configuration#systemd-boot), rEFInd has two configuration files. `refind.conf` located in `boot/efi/EFI/refind` is mainly for changing how rEFind behaves while `/boot/refind_linux.conf` is for managing your boot options. `refind.conf` contains extensive comments explaining all its options. @@ -61,7 +61,7 @@ Learn more: ## GRUB -Unlike [systemd-boot](/configuration/bootloader_configuration#systemd-boot) and [rEFInd](/configuration/bootloader_configuration#refind), +Unlike [systemd-boot](/configuration/boot_manager_configuration#systemd-boot) and [rEFInd](/configuration/boot_manager_configuration#refind), GRUB only has one configuration file located in `/etc/default/grub`. There is pretty good documentation in this file that explains what each option does. diff --git a/src/content/docs/configuration/secure_boot_setup.mdx b/src/content/docs/configuration/secure_boot_setup.mdx index 3c51cc89..c4723744 100644 --- a/src/content/docs/configuration/secure_boot_setup.mdx +++ b/src/content/docs/configuration/secure_boot_setup.mdx @@ -18,7 +18,7 @@ offers key management capabilities and keeps track of files that needs to be sig ## Pre-setup -### GRUB Bootloader +### GRUB Boot Manager If you are using GRUB, run the following command to enable secure boot support on GRUB using CA Keys. @@ -27,7 +27,7 @@ If you are using GRUB, run the following command to enable secure boot support o ``` :::note -Loading unnecessary modules in your bootloader has the potential to present a security risk. +Loading unnecessary modules in your boot manager has the potential to present a security risk. Only run this command if you actually need secure boot. ::: @@ -63,7 +63,7 @@ Enrolling keys to EFI variables...✔ Enrolled keys to the EFI variables! ❯ sudo sbctl status -# sbctl should now be installed and we can proceed to signing the kernel images and boot loader +# sbctl should now be installed and we can proceed to signing the kernel images and boot manager Installed: ✔ sbctl is installed Owner GUID: a9fbbdb7-a05f-48d5-b63a-08c5df45ee70 Setup Mode: ✔ Disabled @@ -71,7 +71,7 @@ Secure Boot ✘ Disabled Vendor Keys: microsoft ``` -## Signing the Kernel Image and Boot Loader +## Signing the Kernel Image and Boot Manager CachyOS provides a script [`sbctl-batch-sign`](https://github.com/CachyOS/CachyOS-Settings/blob/master/usr/bin/sbctl-batch-sign) that takes the list of files needed to be signed from `sudo sbctl verify` and signs them all. @@ -106,7 +106,7 @@ multiple kernel versions installed. Now that all the files are signed, we can reboot back to UEFI settings and enable secure boot. Note that this is a one-time process as signing files with `-s` flag will save those files to `sbctl`'s database. `sbctl` ships with a [pacman hook](https://wiki.archlinux.org/title/Pacman_hook) meaning it will automatically -sign all new files upon a kernel or boot loader update. +sign all new files upon a kernel or boot manager update. ## Verify that Secure Boot is Enabled diff --git a/src/content/docs/cs/installation/bootloaders.md b/src/content/docs/cs/installation/boot_managers.md similarity index 100% rename from src/content/docs/cs/installation/bootloaders.md rename to src/content/docs/cs/installation/boot_managers.md diff --git a/src/content/docs/installation/bootloaders.md b/src/content/docs/installation/boot_managers.md similarity index 98% rename from src/content/docs/installation/bootloaders.md rename to src/content/docs/installation/boot_managers.md index 9928cdcd..d6a8266d 100644 --- a/src/content/docs/installation/bootloaders.md +++ b/src/content/docs/installation/boot_managers.md @@ -1,9 +1,9 @@ --- -title: Offered Boot managers +title: Offered Boot Managers description: Description and recommendations for the currently offered boot managers --- -# CachyOS Boot managers +# CachyOS Boot Managers To offer the best experience across a range of devices, CachyOS currently offers the following boot managers: systemd-boot, rEFInd and Grub. This wiki article will describe the featuresets of each boot manager and also includes our recommendations for when choosing them. diff --git a/src/content/docs/installation/installation_handheld.mdx b/src/content/docs/installation/installation_handheld.mdx index 45516ebe..2d7d428c 100644 --- a/src/content/docs/installation/installation_handheld.mdx +++ b/src/content/docs/installation/installation_handheld.mdx @@ -9,7 +9,7 @@ CachyOS provides an Edition for handheld devices, like the Steam Deck, ROG Ally, The Handheld Edition employs the LAVD scheduler as the default CPU scheduler, optimized for handheld devices. This results in improved frame rates and battery life during gaming. -The Handheld Edition uses `systemd-boot` as boot loader. Boot loader selection is not available +The Handheld Edition uses `systemd-boot` as the boot manager. Boot manager selection is not available as opposed to the default CachyOS ISO. This is intended to simplify the installation process. ## Installation on Root diff --git a/src/content/docs/sk/installation/bootloaders.md b/src/content/docs/sk/installation/boot_managers.md similarity index 100% rename from src/content/docs/sk/installation/bootloaders.md rename to src/content/docs/sk/installation/boot_managers.md From 38ac20faa72c12801b7659c1c8affb74d4776d63 Mon Sep 17 00:00:00 2001 From: Eric Naim Date: Fri, 16 Aug 2024 21:08:53 +0700 Subject: [PATCH 2/3] boot_managers: Remove filesystem support note This note here seems redundant because the base expectation is that everything is supported. If a boot manager doesn't support a filesystem somehow, this should be stated in the respected boot manager subsection or even in the aforementioned filesystem's subsection. --- src/content/docs/installation/boot_managers.md | 7 ------- 1 file changed, 7 deletions(-) diff --git a/src/content/docs/installation/boot_managers.md b/src/content/docs/installation/boot_managers.md index d6a8266d..bbd1f64a 100644 --- a/src/content/docs/installation/boot_managers.md +++ b/src/content/docs/installation/boot_managers.md @@ -3,16 +3,9 @@ title: Offered Boot Managers description: Description and recommendations for the currently offered boot managers --- -# CachyOS Boot Managers - To offer the best experience across a range of devices, CachyOS currently offers the following boot managers: systemd-boot, rEFInd and Grub. This wiki article will describe the featuresets of each boot manager and also includes our recommendations for when choosing them. -:::note -All the boot managers we offer support all the available filesystem choices and full root encryption. -::: - - ## systemd-boot Part of systemd family, systemd-boot was created to be as simple as possible, therefore it only has support for UEFI based systems. This simple yet efficient design ensures it is reliable and fast. However this comes at the cost of advanced features supported by other boot managers. From a2392a81b5b40bed7402eb35770b0c40aacb9139 Mon Sep 17 00:00:00 2001 From: Eric Naim Date: Fri, 16 Aug 2024 21:17:15 +0700 Subject: [PATCH 3/3] boot_managers: Add preambule to distinct boot managers and boot loaders --- src/content/docs/installation/boot_managers.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/src/content/docs/installation/boot_managers.md b/src/content/docs/installation/boot_managers.md index bbd1f64a..237b7d8c 100644 --- a/src/content/docs/installation/boot_managers.md +++ b/src/content/docs/installation/boot_managers.md @@ -6,6 +6,17 @@ description: Description and recommendations for the currently offered boot mana To offer the best experience across a range of devices, CachyOS currently offers the following boot managers: systemd-boot, rEFInd and Grub. This wiki article will describe the featuresets of each boot manager and also includes our recommendations for when choosing them. +## Preambule: Boot Manager != Boot Loader + +When talking about UEFI systems, the correct term when referring to the boot menu presented by systemd-boot, rEFInd and even GRUB is +**boot manager**. + +As a simplified explanation, a boot manager only presents boot options and hands off control of the boot process to the OS while a boot loader +handles the task of loading an OS kernel into memory, often along with support files such as a Linux initial RAM disk file, and starting the kernel running. + +For a more detailed explanation and the reason both terms are often used interchangeably, +please see "[Managing EFI Boot Loaders for Linux: Basic Principles](https://www.rodsbooks.com/efi-bootloaders/principles.html)" by Rod Smith. + ## systemd-boot Part of systemd family, systemd-boot was created to be as simple as possible, therefore it only has support for UEFI based systems. This simple yet efficient design ensures it is reliable and fast. However this comes at the cost of advanced features supported by other boot managers.