KERNEL-BOOTCFG(1)

πŸŽ€ KERNEL-BOOTCFG(1) πŸŽ€

okay so this is the user commands corner of the manual, and the star of the show is kernel-bootcfg, version 26.10. she manages your UEFI boot entries and honestly? she's iconic for it πŸ’…

✨ NAME ✨

kernel-bootcfg β€” the manual page for kernel-bootcfg 26.10, no cap πŸ’–

πŸ¦‹ DESCRIPTION πŸ¦‹

okay so here's the whole vibe, bestie, the full invocation in all her glory:

usage: kernel-bootcfg [-h] [-l LEVEL] [--vars FILE] [--show] [-v]

[--add-uki FILE] [--update-uki FILE] [--remove-uki FILE]
       [--cleanup-uki] [--cmdline CMDLINE] [--boot-ok] [--update-csv]
       [--add-uri URI] [--remove-entry NNNN] [--once] [--boot-order POS]
       [--dry-run] [--title TITLE] [--shim FILE] [--print-loader]
       [--print-stub-info] [--print-stub-image]

and what does she do? she shows and manages UEFI boot entries. that's it, that's the whole personality ✨


🌸 options: 🌸

  • -h, --help β€” shows this help message and then dips, exit stage left 🫢
  • -l, --loglevel LEVEL β€” sets the loglevel to LEVEL
  • --vars FILE β€” reads the edk2 vars from FILE
  • --show β€” prints the boot configuration, like a little reveal πŸ‘‘
  • -v, --verbose β€” prints more details, because we love context πŸ’–

πŸ”₯ update unified kernel image (UKI) boot entries: πŸ”₯

  • --add-uki FILE β€” adds a boot entry for the UKI image FILE
  • --update-uki FILE β€” updates the boot entry for the UKI image FILE
  • --remove-uki FILE β€” removes the boot entry for the UKI image FILE
  • --cleanup-uki β€” removes stale UKI entries, she's literally doing spring cleaning 🧹✨
  • --cmdline CMDLINE β€” overrides the UKI's cmdline when adding a boot entry. heads up though: this is ignored when Secure Boot is enabled, so don't come for her if it does nothing 🫠
  • --boot-ok, --boot-successful β€” boot is successful, so add BootCurrent to BootOrder. slay, you made it πŸ’…
  • --update-csv β€” updates BOOT.CSV

πŸ’œ update other boot entries: πŸ’œ

  • --add-uri URI β€” adds a boot entry to the netboot URI
  • --remove-entry NNNN β€” "add remove entry NNNN". yes bestie, that's literally what it says, typo and all, i don't make the rules πŸ˜­πŸ™ˆ

⭐ options for boot entry updates: ⭐

  • --once, --boot-next β€” boots the added/updated entry once, using BootNext. one-time main character moment πŸŽ€
  • --boot-order POS β€” places the added/updated entry at POS in BootOrder (0 is first, so 0 is the front row πŸ‘‘)
  • --dry-run β€” does not actually update the configuration. look, don't touch, no cap πŸ™ˆ
  • --title TITLE β€” labels the entry with TITLE
  • --shim FILE β€” uses the shim binary FILE

  • --print-loader β€” prints the boot loader name
  • --print-stub-info β€” prints the efi stub info
  • --print-stub-image β€” prints the efi stub image

🫢 AUTHOR 🫢

Gerd Hoffmann <kraxel@redhat.com> β€” give her her flowers, she wrote all of this πŸ’


aaand that's the whole page, bestie πŸ’– this was kernel-bootcfg 26.10, dated October 2026, and it lives in the manual as KERNEL-BOOTCFG(1). go forth and boot correctly, periodt βœ¨πŸ’…πŸ¦‹

πŸ“¦ where this page comes from