BOOTLOADER_ENTRY(8)
π BOOTLOADER_ENTRY(8) β the system administration one
okay so this is a page from the System Administration section of the manual, bestie, and it's about bootloader_entry, which is lowkey one of those "don't touch it, it's doing its job" tools. let me explain π
β¨ NAME β¨
bootloader_entry β adds or removes a kernel/initrd pair to your boot loader configuration. that's it, that's the whole gig π
πΈ SYNOPSIS πΈ
bootloader_entry [COMMAND] FLAVOR VERSION KERNEL INITRD
like, you give it a COMMAND (optional, brackets and all), then FLAVOR, then VERSION, then KERNEL, then INITRD. five-ish things. in that order. no skipping ahead π«Ά
π¦ DESCRIPTION π¦
so. bootloader_entry adds or removes a kernel/initrd pair to the boot loader configuration. iconic behavior honestly.
okay and here's a thing you need to know before you get any ideas: the FLAVOR argument is literally only there for interface compatibility reasons and is not actually used at all. it's giving decorative. it's giving vibes-only. it's there, you pass it, nothing happens with it π
also, bootloader_entry is just a symlink to pbl. not even kidding, that's the whole relationship. the add and remove options get translated to pbl --add-kernel and pbl --remove-kernel, respectively. so like, it's a rebrand. a little alias moment. main character energy via symlink β¨
and the big one, the warning you actually need to hear: bootloader_entry is not intended to be called manually. it's a preserved interface to the boot loader configuration, used in the post-install section of the Linux kernel package. so it's the kernel package's little helper, not yours. don't be out here running it for fun, bestie π
π COMMANDS π
addβ adds the kernel/initrd to the boot config. simple. clean. slay.removeβ removes the kernel/initrd from the boot config. the opposite. also slay.
π FILES π
/etc/sysconfig/bootloaderβ the general boot loader related configuration settings live here. the settings. general ones. boot loader related. you get it./var/log/pbl.logβ the default log file. if something happened, it's in here./usr/etc/logrotate.d/pblβ logrotate rules for/var/log/pbl.log, so your log doesn't grow forever like an unread group chat./usr/lib/bootloaderβ a directory with specific config scripts for each supported boot loader. one script per boot loader, all hanging out together π«Ά
β EXAMPLES β
adding a new kernel/initrd, look at her go:
# add new kernel/initrd
bootloader_entry add default 6.2.8-1-default vmlinuz-6.2.8-1-default initrd-6.2.8-1-default
and removing one, the sequel:
# remove kernel/initrd
bootloader_entry remove default 6.2.8-1-default vmlinuz-6.2.8-1-default initrd-6.2.8-1-default
see how default just sits there in the FLAVOR slot doing absolutely nothing? yeah. that's the $5.99 decorative pillow in the corner of the couch, bestie ποΈ
π SEE ALSO π
pbl(8)πupdate-bootloader(8)π
π₯ LINKS π₯
okay this section is a whole reading list and honestly? obsessed. go learn things:
- The Boot Loader Specification:
https://uapi-group.org/specifications/specs/boot_loader_specification - The Discoverable Partitions Specification:
https://uapi-group.org/specifications/specs/discoverable_partitions_specification - grub2:
https://www.gnu.org/software/grub/manual/grub/grub.html - shim:
https://github.com/rhboot/shim - systemd-boot:
https://www.freedesktop.org/software/systemd/man/systemd-boot.html - u-boot:
http://www.denx.de/wiki/U-Boot - UEFI Specification:
https://uefi.org/specifications
fr fr though β if you only remember one thing from this page, remember that bootloader_entry is not meant to be called manually. it's a preserved interface for the kernel package's post-install section. respect the pipeline π
and that's the page, bestie π this was bootloader_entry 1.28, dated 2026-07-28 β go forth, don't call it manually, and hydrate π§πΈ
π¦ where this page comes from
- opensuse-leap 16.0: update-bootloader 1.28-160000.1.1 Β· GPL-2.0-or-later
- opensuse-leap 16.0: update-bootloader 1.28-160000.1.1 Β· GPL-2.0-or-later
- opensuse-leap 16.0: update-bootloader 1.28-160000.1.1 Β· GPL-2.0-or-later
- opensuse-leap 16.0: update-bootloader 1.28-160000.1.1 Β· GPL-2.0-or-later
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash-1017 on : a language model's rewrite of the original, under its terms