BOOTCTL(1) bootctl BOOTCTL(1) (NAME) bootctl - EFI (SYNOPSIS) bootctl [...] {COMMAND} (DESCRIPTION) bootctl EFI systemd-boot(7) . EFI (GENERIC EFI FIRMWARE/BOOT LOADER COMMANDS) EFI . status ESP . . . 239. reboot-to-firmware [BOOL] <> EFI . . . systemctl reboot --firmware-setup . : systemctl reboot --firmware-setup . systemctl(1) . 251. (BOOT LOADER SPECIFICATION COMMANDS) UAPI.1 Boot Loader Specification[1] systemd-boot . list UAPI.1 Boot Loader Specification[1] Boot Loader Interface[2] . JSON --json= . . 239. unlink [ID] . glob . initrd (sysexts) (confexts) . ID --oldest ( ). 253. link KERNEL Type #1 UKI . (Unified Kernel Image UKI) . UKI ESP ( XBOOTLDR ) Boot Loader Specification[1] Type #1 ( UKI ). --entry-title= --entry-version= --entry-commit= --tries-left= . ( ) UKI --extra= . ESP/XBOOTLDR ( ). . . ESP/XBOOTLDR --keep-free= . 261. cleanup ESP XBOOTLDR . 253. (BOOT LOADER INTERFACE COMMANDS) UAPI.1 Boot Loader Specification[1] Boot Loader Interface[2] systemd-boot . set-preferred ID, set-default ID, set-oneshot ID, set-sysfail ID . glob . set-oneshot set-default set-preferred set-default (tries-left) . set-sysfail . (SysFail) EFI . bootctl list . : @default @oneshot @current . EFI : LoaderEntryDefault LoaderEntrySysFail LoaderEntryOneShot LoaderEntrySelected UAPI.1 Boot Loader Specification[1] . . @saved EFI . ("") EFI (unset) . : systemctl reboot --boot-loader-entry=ID systemctl reboot --boot-loader-menu=timeout . systemctl(1) . 240. set-timeout TIMEOUT, set-timeout-oneshot TIMEOUT () . set-timeout-oneshot . systemd.time(7) . menu-disabled menu-hidden 0 menu-force . ("") . 250. SYSTEMD-BOOT (SYSTEMD-BOOT COMMANDS) EFI systemd-boot . install systemd-boot EFI . systemd-boot / EFI ESP/EFI/BOOT/BOOT*.EFI . . 239. update systemd-boot(7) EFI . / EFI ESP/EFI/BOOT/BOOT*.EFI . . 239. remove systemd-boot EFI . 239. is-installed systemd-boot ESP . ESP systemd-boot ( ) -- EFI . 243. random-seed () EFI (ESP) systemd-boot . ESP . << >> EFI . ESP EFI ESP . . : systemd-boot-random-seed.service(8). Random Seeds[3] . 243. (KERNEL IMAGE COMMANDS) kernel-identify KERNEL-IMAGE . . "uki" "addon" "pe" "unknown" . 253. kernel-inspect KERNEL-IMAGE . . 253. (OPTIONS) : --esp-path= EFI (ESP). /efi/ /boot/ /boot/efi/ . ESP /efi/ (mount) . --boot-path= Extended Boot Loader UAPI.1 Boot Loader Specification[1] . /boot/ . Extended Boot Loader /boot/ . --root=root . root . 252. --image=image . . --root= . GPT UAPI.2 Discoverable Partitions Specification[4]. systemd- nspawn(1) . 252. --image-policy=policy systemd.image-policy(7) . --image= ( ) . "*" . --install-source= --root= --image= . "auto" () "image" "host" . "auto" . "image" "host" . 252. -p, --print-esp-path status . EFI (ESP) . 236. -x, --print-boot-path status . Extended Boot Loader ESP . Extended Boot Loader ESP . Boot Loader Specification Type #1 "$(bootctl -x)/loader/entries/" . . Boot Loader Specification Type #2 "$(bootctl -x)/EFI/Linux/" . ( --print-esp-path ) systemd-boot. 242. --print-loader-path status : EFI . . 257. --print-stub-path status : EFI UKI/stub . . 257. -R, --print-root-device . /dev/nvme0n1p5 . dm-crypt/LUKS dm-verity . ( btrfs ) . ( -RR) ( /dev/nvme0n1). "tmpfs" ( ) /usr/ . ( NFS CIFS) . 254. --print-efi-architecture EFI . bootx64.efi . 261. --variables=yes|no|auto EFI EFI . auto EFI . yes . 258. --random-seed=yes|no install () ESP . . 257. --graceful EFI EFI . is-installed update random-seed install . v258 chroot . 244. -q, --quiet ESP . 251. --make-entry-directory=yes|no Type #1 UAPI.1 Boot Loader Specification[1] initrd install remove . ( --entry-token= ) $BOOT ( --print-boot-path ). "no" . 251. --entry-token= . install "auto" "machine-id" "os-id" "os-image-id" "literal:" . machine-id (machine ID) ( "b0e793a9baf14b5fa13ecbe84ff637ac"). machine-id(5) . os-id ID= os-release(5) ( "fedora"). os-image-id IMAGE_ID= os-release ( "vendorx-cashier-system"). auto () /etc/kernel/entry-token . . IMAGE_ID= os-release ( ) . ID= os-release ( ) . "machine-id" --make-entry-directory=yes /etc/kernel/entry-token . kernel- install(8) . . : () $BOOT . . ( ) . . 251. --all-architectures EFI ( --variables=no ). 252. --efi-boot-option-description= . "Linux Boot Manager" . "Linux Boot Manager" ESP . . ESP . 252. --efi-boot-option-description-with-device= false . ( --efi-boot-option-description= ) . . . 260. --dry-run unlink cleanup. unlink cleanup . 253. --oldest unlink ( ). . . 261. --keep-free=BYTES link ( ) (ESP XBOOTLDR) . . (K M G ) . . . 261. --entry-title=TITLE link ( "title" Type #1). UKI . 261. --entry-version=VERSION link ( "version" Type #1). UKI . . 261. --entry-commit=NR link . 261. --extra=PATH, -X PATH link (sidecar) UKI . (*.sysext.raw) (*.confext.raw) (*.cred) . ESP/XBOOTLDR UKI initrd . . . 261. --tries-left=NR link "tries-left" . Automatic Boot Assessment[5] (bad) . . 261. --secure-boot-auto-enroll=yes|no, --private-key=PATH/URI, --private-key-source=TYPE[:NAME], --certificate=PATH, --certificate-source=TYPE[:NAME] install ESP (secure boot auto-enrollment) . . . bootctl "PK" "KEK" "db" ESP "DER" . setup systemd-boot . --certificate= --private-key= . --certificate= X.509 PEM URI OpenSSL --certificate-source "file" "provider" "provider:pkcs11". --private-key= URI OpenSSL --private-key-source= "type:name" "engine:pkcs11". OpenSSL EFI . 257. --no-pager (pager) . --json=MODE JSON . "short" ( ) "pretty" ( ) "off" ( JSON ) . -h, --help . --version . .EFI (SIGNED .EFI FILES) bootctl install update systemd-boot ".efi.signed" ".efi" . UEFI (UEFI SecureBoot) . (EXIT STATUS) . bootctl --print-root-device . (ENVIRONMENT) $SYSTEMD_RELAX_ESP_CHECKS=1 ESP --esp-path= . $SYSTEMD_RELAX_XBOOTLDR_CHECKS=1 Extended Boot Loader . (EXAMPLES) . status 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 systemd-boot or another boot loader Product: systemd-boot version implementing the Boot Loader Interface[2] 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 \/ Menu can be disabled 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 "(default)" "(selected)" ( ). (SEE ALSO) systemd-boot(7), UAPI.1 Boot Loader Specification[1], Boot Loader Interface[2], systemd-boot-random-seed.service(8) (NOTES) 1. UAPI.1 Boot Loader Specification https://uapi- group.org/specifications/specs/boot_loader_specification 2. Boot Loader Interface https://systemd.io/BOOT_LOADER_INTERFACE 3. Random Seeds https://systemd.io/RANDOM_SEEDS 4. UAPI.2 Discoverable Partitions Specification https://uapi- group.org/specifications/specs/discoverable_partitions_specification 5. Automatic Boot Assessment https://systemd.io/AUTOMATIC_BOOT_ASSESSMENT systemd 261.2 BOOTCTL(1)