diff --git a/man/bootctl.xml b/man/bootctl.xml
index c8e774d4394..4aab53ece10 100644
--- a/man/bootctl.xml
+++ b/man/bootctl.xml
@@ -49,7 +49,10 @@
Shows brief information about the system firmware, the boot loader that was used to
boot the system, the boot loaders currently available in the ESP, the boot loaders listed in the
firmware's list of boot loaders and the current default boot loader entry. If no command is
- specified, this is the implied default.
+ specified, this is the implied default.
+
+ See the example below for details of the output.
+
@@ -89,10 +92,10 @@
Shows all available boot loader entries implementing the Boot Loader Specification, as well as any
other entries discovered or automatically generated by a boot loader implementing the Boot Loader
- Interface.
+ url="https://systemd.io/BOOT_LOADER_INTERFACE">Boot Loader Interface.
+ JSON output may be requested with .
- JSON output may be requested with .
+ See the example below for details of the output.
@@ -344,6 +347,111 @@
the Extended Boot Loader partition.
+
+ Examples
+
+
+ Output from status and list
+
+ $ bootctl status
+System:
+ Firmware: UEFI 2.40 (firmware-version) ← firmware vendor and version
+ Secure Boot: disabled (setup) ← secure boot status
+ TPM2 Support: yes
+ Boot into FW: supported ← does the firmware support booting into itself
+
+Current Boot Loader: ← details about sd-boot or another boot loader
+ Product: systemd-boot version implementing the Boot Loader Interface
+ Features: ✓ Boot counting
+ ✓ Menu timeout control
+ ✓ One-shot menu timeout control
+ ✓ Default entry control
+ ✓ One-shot entry control
+ ✓ Support for XBOOTLDR partition
+ ✓ Support for passing random seed to OS
+ ✓ Load drop-in drivers
+ ✓ Boot loader sets ESP information
+ ESP: /dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000
+ File: └─/EFI/systemd/systemd-bootx64.efi
+
+Random Seed: ← random seed used for entropy in early boot
+ Passed to OS: yes
+ System Token: set
+ Exists: yes
+
+Available Boot Loaders on ESP:
+ ESP: /boot/efi (/dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000)
+ File: └─/EFI/systemd/systemd-bootx64.efi (systemd-boot 251
+ File: └─/EFI/BOOT/BOOTX64.EFI (systemd-boot 251
+
+Boot Loaders Listed in EFI Variables:
+ Title: Linux Boot Manager
+ ID: 0x0001
+ Status: active, boot-order
+ Partition: /dev/disk/by-partuuid/…
+ File: └─/EFI/systemd/systemd-bootx64.efi
+
+ Title: Fedora
+ ID: 0x0000
+ Status: active, boot-order
+ Partition: /dev/disk/by-partuuid/…
+ File: └─/EFI/fedora/shimx64.efi
+
+ Title: Linux-Firmware-Updater
+ ID: 0x0002
+ Status: active, boot-order
+ Partition: /dev/disk/by-partuuid/…
+ File: └─/EFI/fedora/fwupdx64.efi
+
+Boot Loader Entries:
+ $BOOT: /boot/efi (/dev/disk/by-partuuid/01234567-89ab-cdef-dead-beef00000000)
+
+Default Boot Loader Entry:
+ type: Boot Loader Specification Type #1 (.conf)
+ title: Fedora Linux 36 (Workstation Edition)
+ id: …
+ source: /boot/efi/loader/entries/entry-token-kernel-version.conf
+ version: kernel-version
+ machine-id: …
+ linux: /entry-token/kernel-version/linux
+ initrd: /entry-token/kernel-version/initrd
+ options: root=…
+
+
+ $ bootctl list
+Boot Loader Entries:
+ type: Boot Loader Specification Type #1 (.conf)
+ title: Fedora Linux 36 (Workstation Edition) (default) (selected)
+ id: …
+ source: /boot/efi/loader/entries/entry-token-kernel-version.conf
+ version: kernel-version
+ machine-id: …
+ linux: /entry-token/kernel-version/linux
+ initrd: /entry-token/kernel-version/initrd
+ options: root=…
+
+ type: Boot Loader Specification Type #2 (.efi)
+ title: Fedora Linux 35 (Workstation Edition)
+ id: …
+ source: /boot/efi/EFI/Linux/fedora-kernel-version.efi
+ version: kernel-version
+ machine-id: …
+ linux: /EFI/Linux/fedora-kernel-version.efi
+ options: root=…
+
+ type: Automatic
+ title: Reboot Into Firmware Interface
+ id: auto-reboot-to-firmware-setup
+ source: /sys/firmware/efi/efivars/LoaderEntries-4a67b082-0a4c-41cf-b6c7-440b29bb8c4f
+
+
+ In the listing, (default) specifies the entry that will be
+ used by default, and (selected) specifies the entry that was
+ selected the last time (i.e. is currently running).
+
+
+
See Also