Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: Address the Differences Between Boot Loaders and Boot Manager #53

Merged
merged 3 commits into from
Aug 17, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions astro.config.mjs
Original file line number Diff line number Diff line change
Expand Up @@ -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',
Expand Down Expand Up @@ -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)',
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/cachyos_basic/why_cachyos.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
Original file line number Diff line number Diff line change
@@ -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
Expand Down Expand Up @@ -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.

Expand All @@ -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.

Expand Down
10 changes: 5 additions & 5 deletions src/content/docs/configuration/secure_boot_setup.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand All @@ -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.
:::

Expand Down Expand Up @@ -63,15 +63,15 @@ 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
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.
Expand Down Expand Up @@ -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

Expand Down
Original file line number Diff line number Diff line change
@@ -1,17 +1,21 @@
---
title: Offered Boot managers
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.
:::
## 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.
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/installation/installation_handheld.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down