summaryrefslogtreecommitdiff
path: root/man/bootctl.xml
diff options
context:
space:
mode:
authorДамјан Георгиевски <gdamjan@gmail.com>2020-10-13 12:25:59 +0200
committerLennart Poettering <lennart@poettering.net>2020-10-20 15:02:58 +0200
commitc4b843473a75fb38ed5bf54e9d3cfb1cb3719efa (patch)
tree5cf4efd0077c38593b21b39b03e9b02be9670bb0 /man/bootctl.xml
parent558e5654a51ddd32c47fd80d6f8fefb55d611c83 (diff)
downloadsystemd-c4b843473a75fb38ed5bf54e9d3cfb1cb3719efa.tar.gz
bootctl: add @current/@oneshot/@default targets to set-default/set-oneshot
Using `bootctl set-default @current` will set the default loader entry to the currently booted entry as read from the `LoaderEntrySelected` EFI variable. Also `bootctl set-oneshot @current` will set the oneshot loader entry to the current booted entry. Correspondingly `@default` and `@oneshot` can be used to read from the LoaderEntryDefault and LoaderEntryOneshot EFI variables.
Diffstat (limited to 'man/bootctl.xml')
-rw-r--r--man/bootctl.xml11
1 files changed, 11 insertions, 0 deletions
diff --git a/man/bootctl.xml b/man/bootctl.xml
index d908d52d97..479cbb5d92 100644
--- a/man/bootctl.xml
+++ b/man/bootctl.xml
@@ -102,6 +102,17 @@
<listitem><para>Sets the default boot loader entry. Takes a single boot loader entry ID string as
argument. The <option>set-oneshot</option> command will set the default entry only for the next boot,
the <option>set-default</option> will set it persistently for all future boots.</para></listitem>
+
+ <listitem><para>Optionally, the boot loader entry ID may be specified as one of: <option>@default</option>,
+ <option>@oneshot</option> or <option>@current</option>, which correspond to the current default boot loader
+ entry for all future boots, the current default boot loader entry for the next boot, and the currently booted
+ boot loader entry. These special IDs are resolved to the current values of the EFI variables
+ <varname>LoaderEntryDefault</varname>, <varname>LoaderEntryOneShot</varname> and <varname>LoaderEntrySelected</varname>,
+ see <ulink url="https://systemd.io/BOOT_LOADER_SPECIFICATION">Boot Loader Specification</ulink> for details.
+ These special IDs are primarily useful as a quick way to persistently make the currently booted boot loader
+ entry the default choice, or to upgrade the default boot loader entry for the next boot to the default boot
+ loader entry for all future boots, but may be used for other operations too.
+ </para></listitem>
</varlistentry>
</variablelist>