diff options
| author | Lennart Poettering <lennart@poettering.net> | 2023-01-20 18:36:31 +0100 |
|---|---|---|
| committer | Lennart Poettering <lennart@poettering.net> | 2023-01-20 18:42:25 +0100 |
| commit | eab7061898bcd1f2db77bc0a732003bbb2abc67b (patch) | |
| tree | 6fa13c0bcc3e8251953dd298d46b9331294bab74 /man/bootctl.xml | |
| parent | 5bbf72bb9ed57db851abaae7265b926497ca41ca (diff) | |
| download | systemd-eab7061898bcd1f2db77bc0a732003bbb2abc67b.tar.gz | |
bootctl: split out boot loader spec + boot loader interface commands in --help text
grub (at least on fedora) nowadays implements the boot loader spec, but
not the boot loader interface. Hence let's split out the commands
specific to each in two groups in the --help text. This way the first
group just covers boot lodaer spec stuff (i.e. stuff on disk in the
ESP/XBOOTLDR partition). And the other covers talking to the boot loader
via EFI var.
Diffstat (limited to 'man/bootctl.xml')
| -rw-r--r-- | man/bootctl.xml | 48 |
1 files changed, 30 insertions, 18 deletions
diff --git a/man/bootctl.xml b/man/bootctl.xml index a5a3e6b307..52c9179cd0 100644 --- a/man/bootctl.xml +++ b/man/bootctl.xml @@ -85,9 +85,10 @@ <refsect1> <title>Boot Loader Specification Commands</title> - <para>These commands are available for all boot loaders that implement the <ulink - url="https://uapi-group.org/specifications/specs/boot_loader_specification">Boot Loader Specification</ulink> and/or the <ulink - url="https://systemd.io/BOOT_LOADER_INTERFACE">Boot Loader Interface</ulink>, such as + <para>These commands are available for all boot loaders that + implement the <ulink + url="https://uapi-group.org/specifications/specs/boot_loader_specification">Boot + Loader Specification</ulink>, such as <command>systemd-boot</command>.</para> <variablelist> @@ -105,6 +106,32 @@ </varlistentry> <varlistentry> + <term><option>unlink</option> <replaceable>ID</replaceable></term> + + <listitem><para>Removes a boot loader entry including the files it refers to. Takes a single boot + loader entry ID string or a glob pattern as argument. Referenced files such as kernel or initrd are + only removed if no other entry refers to them.</para></listitem> + </varlistentry> + + <varlistentry> + <term><option>cleanup</option></term> + + <listitem><para>Removes files from the ESP and XBOOTLDR partitions that belong to the entry token but + are not referenced in any boot loader entries.</para></listitem> + </varlistentry> + </variablelist> + </refsect1> + + <refsect1> + <title>Boot Loader Interface Commands</title> + + <para>These commands are available for all boot loaders that implement the <ulink + url="https://uapi-group.org/specifications/specs/boot_loader_specification">Boot Loader Specification</ulink> and the <ulink + url="https://systemd.io/BOOT_LOADER_INTERFACE">Boot Loader Interface</ulink>, such as + <command>systemd-boot</command>.</para> + + <variablelist> + <varlistentry> <term><option>set-default</option> <replaceable>ID</replaceable></term> <term><option>set-oneshot</option> <replaceable>ID</replaceable></term> @@ -153,21 +180,6 @@ disables the timeout while always showing the menu. When an empty string ("") is specified the bootloader will revert to its default menu timeout.</para></listitem> </varlistentry> - - <varlistentry> - <term><option>unlink</option> <replaceable>ID</replaceable></term> - - <listitem><para>Removes a boot loader entry including the files it refers to. Takes a single boot - loader entry ID string or a glob pattern as argument. Referenced files such as kernel or initrd are - only removed if no other entry refers to them.</para></listitem> - </varlistentry> - - <varlistentry> - <term><option>cleanup</option></term> - - <listitem><para>Removes files from the ESP and XBOOTLDR partitions that belong to the entry token but - are not referenced in any boot loader entries.</para></listitem> - </varlistentry> </variablelist> </refsect1> |