[bootloader] Document Debian GRUB

This commit is contained in:
Adriaan de Groot 2022-04-12 12:38:20 +02:00
parent 913b7c8809
commit baf8ef2c33

View File

@ -4,6 +4,10 @@
# Bootloader configuration. The bootloader is installed to allow # Bootloader configuration. The bootloader is installed to allow
# the system to start (and pick one of the installed operating # the system to start (and pick one of the installed operating
# systems to run). # systems to run).
#
# Take note that Debian-derivatives that use unmodified GRUB EFI packages
# should specifically set *efiBootloaderId* to "debian" because that is
# hard-coded in `grubx64.efi`.
--- ---
# Define which bootloader you want to use for EFI installations # Define which bootloader you want to use for EFI installations
# Possible options are 'grub', 'sb-shim' and 'systemd-boot'. # Possible options are 'grub', 'sb-shim' and 'systemd-boot'.
@ -52,10 +56,14 @@ efiBootMgr: "efibootmgr"
# @@RANDOM@@ can be used to obtain a unique 4-digit hex suffix # @@RANDOM@@ can be used to obtain a unique 4-digit hex suffix
# @@PHRASE@@ can be used to obtain a unique 1-to-3-word suffix # @@PHRASE@@ can be used to obtain a unique 1-to-3-word suffix
# from a dictionary of space-themed words # from a dictionary of space-themed words
# Note that these must be at the **end** of the *efiBootloaderId* value. # These words must be at the **end** of the *efiBootloaderId* value.
# There must also be at most one of them. If there is none, no suffix- # There must also be at most one of them. If there is none, no suffix-
# processing is done and the *efiBootloaderId* is used unchanged. # processing is done and the *efiBootloaderId* is used unchanged.
# #
# NOTE: Debian derivatives that use the unmodified Debian GRUB EFI
# packages may need to set this to "debian" because that is
# hard-coded in `grubx64.efi`.
#
# efiBootloaderId: "dirname" # efiBootloaderId: "dirname"
# Optionally install a copy of the GRUB EFI bootloader as the EFI # Optionally install a copy of the GRUB EFI bootloader as the EFI