summaryrefslogtreecommitdiff
path: root/man/bootctl.xml
diff options
context:
space:
mode:
authorRene Hollander <mail@renehollander.at>2022-08-13 21:38:02 +0200
committerLennart Poettering <lennart@poettering.net>2022-08-19 14:55:31 +0200
commitd9bdb29bf575100b8fdb051a4aa67a353dd80a39 (patch)
tree7f1e1bff8269b1f1f1e7288e40e6a59f3484579f /man/bootctl.xml
parentbe06a84c8da848f8343660dcb727bb6848d5377e (diff)
downloadsystemd-d9bdb29bf575100b8fdb051a4aa67a353dd80a39.tar.gz
Add --efi-boot-option-description argument to bootctl to control the name of the boot
entry. By default an entry named "Linux Boot Manager" is created (which is the previous behavior). With the flag the name of the entry can be controlled, which is useful when installing systemd-boot to multiple ESP partitions and having uniquely named entries. Fixes #17044.
Diffstat (limited to 'man/bootctl.xml')
-rw-r--r--man/bootctl.xml13
1 files changed, 13 insertions, 0 deletions
diff --git a/man/bootctl.xml b/man/bootctl.xml
index 1664f68157..85820ff606 100644
--- a/man/bootctl.xml
+++ b/man/bootctl.xml
@@ -377,6 +377,19 @@
<listitem><para>Install binaries for all supported EFI architectures (this implies <option>--no-variables</option>).</para></listitem>
</varlistentry>
+ <varlistentry>
+ <term><option>--efi-boot-option-description=</option></term>
+ <listitem><para>Description of the entry added to the firmware's boot option list. Defaults to <literal>Linux
+ Boot Manager</literal>.</para>
+
+ <para>Using the default entry name <literal>Linux Boot Manager</literal> is generally preferable as only
+ one bootloader installed to a single ESP partition should be used to boot any number of OS installations
+ found on the various disks installed in the system. Specifically distributions should not use this flag
+ to install a branded entry in the boot option list. However in situations with multiple disks, each with
+ their own ESP partition, it can be beneficial to make it easier to identify the bootloader being used in
+ the firmware's boot option menu.</para></listitem>
+ </varlistentry>
+
<xi:include href="standard-options.xml" xpointer="no-pager"/>
<xi:include href="standard-options.xml" xpointer="json" />
<xi:include href="standard-options.xml" xpointer="help"/>