KERNEL-INSTALL(8) kernel-install KERNEL-INSTALL(8) (NAME) kernel-install - initramfs (SYNOPSIS) kernel-install [OPTIONS...] add KERNEL-VERSION KERNEL-IMAGE [INITRD-FILE...] kernel-install [OPTIONS...] add-all kernel-install [OPTIONS...] remove KERNEL-VERSION kernel-install [OPTIONS...] inspect [KERNEL-VERSION] [KERNEL-IMAGE] [INITRD-FILE...] kernel-install [OPTIONS...] list (DESCRIPTION) kernel-install initrd [1] $BOOT . /boot/ /efi/ /boot/efi/ . kernel-install ( <<>>) /usr/lib/kernel/install.d/ /etc/kernel/install.d/ . (lexicographic) . . /etc/kernel/install.d/ /usr/lib/kernel/install.d/ . /etc/kernel/install.d/ /usr/lib/kernel/install.d/ /dev/null . ".install" . 0 . 77 ( ). (COMMANDS) : add [[[KERNEL-VERSION] KERNEL-IMAGE] [INITRD-FILE ...]] . "-" uname -r . "-" /usr/lib/modules/KERNEL_VERSION/vmlinuz . initrd ( ). /usr/lib/kernel/install.d/*.install /etc/kernel/install.d/*.install ( ) : add KERNEL-VERSION $BOOT/ENTRY-TOKEN/KERNEL-VERSION/ KERNEL-IMAGE [INITRD-FILE ...] initrd (#1) UAPI.1 Boot Loader Specification[2] (<< >> entry directory). (boot loader) . ENTRY-TOKEN (machine ID) . . kernel-install $BOOT/ENTRY-TOKEN/KERNEL-VERSION ( $KERNEL_INSTALL_LAYOUT ). : 50-depmod.install depmod(8) KERNEL-VERSION . 90-loaderentry.install KERNEL-IMAGE $BOOT/ENTRY-TOKEN/KERNEL-VERSION/linux . INITRD-FILE $BOOT/ENTRY-TOKEN/KERNEL_VERSION/INITRD-FILE . (microcode) initrd . UAPI.1 Boot Loader Specification[2] ( ) $BOOT/loader/entries/ENTRY-TOKEN-KERNEL-VERSION.conf . PRETTY_NAME /etc/os-release /usr/lib/os-release ( ) "Linux KERNEL-VERSION" . $KERNEL_INSTALL_LAYOUT "bls" . 90-uki-copy.install $KERNEL_INSTALL_STAGING_AREA/uki.efi $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi . $KERNEL_INSTALL_STAGING_AREA/uki.efi.extra.d"/ $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi.extra.d/ . $KERNEL_INSTALL_STAGING_AREA/uki.efi KERNEL-IMAGE ".efi" $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi . KERNEL-IMAGE.extra.d/ $KERNEL_INSTALL_STAGING_AREA/uki.efi.extra.d"/ $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi.extra.d/ . $KERNEL_INSTALL_LAYOUT "uki" . 198. add-all add ( ) /usr/lib/modules/ . /usr/lib/modules/KERNEL-VERSION/vmlinuz . 255. remove KERNEL-VERSION . /usr/lib/kernel/install.d/*.install /etc/kernel/install.d/*.install ( ) : remove KERNEL-VERSION $BOOT/ENTRY-TOKEN/KERNEL-VERSION/ kernel-install $BOOT/ENTRY-TOKEN/KERNEL-VERSION/ ( ) . : 50-depmod.install depmod . 90-loaderentry.install $BOOT/loader/entries/ENTRY-TOKEN-KERNEL-VERSION.conf . 90-uki-copy.install $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION.efi.extra.d/ . 198. inspect [[[KERNEL-VERSION] KERNEL-IMAGE] [INITRD-FILE ...]] add . . $KERNEL_INSTALL_* . --json JSON . 251. list . /usr/lib/modules/ . 255. (COMPATIBILITY WITH THE KERNEL BUILD SYSTEM) installkernel [OPTIONS...] VERSION VMLINUZ [MAP] [INSTALLATION-DIR] installkernel make install . VERSION VMLINUZ . (MAP INSTALLATION-DIR) . $BOOT (THE $BOOT PARTITION) UAPI.1 Boot Loader Specification[2] $BOOT . kernel-install /efi/ /boot/ /boot/efi/ . $BOOT/loader/entries/ $BOOT/ENTRY-TOKEN/ . (OPTIONS) : --esp-path= EFI ( ESP). /efi/ /boot/ /boot/efi/ . ESP /efi/ (mount) . --boot-path= (Extended Boot Loader partition) UAPI.1 Boot Loader Specification[2] . /boot/ . /boot/ . --make-entry-directory=yes|no|auto (#1) UAPI.1 Boot Loader Specification[2] initrd add remove . (entry token) . "auto" "bls" . "auto" . 254. --entry-type=type1|type2|all . . "type1" "type2" $KERNEL_INSTALL_BOOT_ENTRY_TYPE . "all" . "all" . 258. --entry-token= . "auto" "machine-id" "os-id" "os-image-id" "literal:" . 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 ( $KERNEL_INSTALL_CONF_ROOT/entry-token) . . IMAGE_ID= os-release . ID= os-release . . . : () $BOOT_ROOT . . ( ) . (installer) . 254. -v, --verbose . 242. --root=root . root . . 255. --image=image . . --root= . GPT UAPI.2 Discoverable Partitions Specification[3]. systemd-nspawn(1) . 255. -h, --help . --version . --no-pager (pager) . --json=MODE JSON . "short" ( ) "pretty" ( ) "off" ( JSON ) . --image-policy=policy systemd.image- policy(7). --image= . "*" . --no-legend (legend) . (ENVIRONMENT) (Environment variables exported for plugins) --verbose $KERNEL_INSTALL_VERBOSE=1 (export) . . $KERNEL_INSTALL_IMAGE_TYPE=uki|pe|unknown . uki (Unified Kernel Image). 254. pe PE. 254. unknown . 254. $KERNEL_INSTALL_MACHINE_ID . . /etc/machine-id $MACHINE_ID ( ). kernel-install . $KERNEL_INSTALL_ENTRY_TOKEN <<>> . $KERNEL_INSTALL_MACHINE_ID ID= IMAGE_ID= /etc/os-release. (Boot Loader Specification) (initial RAM disk) . $KERNEL_INSTALL_ENTRY_TOKEN $KERNEL_INSTALL_MACHINE_ID . /etc/kernel/entry-token . $BOOT . $KERNEL_INSTALL_MACHINE_ID (fallback) . $KERNEL_INSTALL_BOOT_ROOT ( mount point) . XBOOTLDR ESP ( EFI) $BOOT . $BOOT_ROOT ( ). $KERNEL_INSTALL_LAYOUT=auto|bls|uki|other|... . . layout= install.conf . : bls (#1) UAPI.1 Boot Loader Specification[2] systemd-boot(7): $BOOT/loader/entries/ENTRY-TOKEN-KERNEL-VERSION[+TRIES].conf initrd $BOOT/ENTRY-TOKEN/KERNEL-VERSION/ . 90-loaderentry.install. 250. uki (#2) UAPI.1 Boot Loader Specification[2] systemd-boot(7): $BOOT/EFI/Linux $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION[+TRIES].efi. 90-uki-copy.install. 253. other kernel-install . 250. auto . UKI uki . $BOOT/loader/entries.srel "type1" $BOOT/ENTRY-TOKEN bls other . . . 254. $KERNEL_INSTALL_INITRD_GENERATOR $KERNEL_INSTALL_UKI_GENERATOR initrd / UKI . initrd_generator= uki_generator= install.conf . $KERNEL_INSTALL_STAGING_AREA . : initrd* INITRD-FILE microcode* INITRD-FILE . kernel-install (Environment variables understood by kernel-install) $KERNEL_INSTALL_CONF_ROOT kernel-install . install.conf entry-token . --root=root . root . $KERNEL_INSTALL_PLUGINS kernel-install . (whitespace) . "KERNEL_INSTALL_PLUGINS=:" . $MACHINE_ID kernel-install $KERNEL_INSTALL_MACHINE_ID . $BOOT_ROOT kernel-install $KERNEL_INSTALL_BOOT_ROOT . install.conf . . (EXIT STATUS) 0 77 0 . (FILES) /etc/kernel/install.d/*.install, /usr/lib/kernel/install.d/*.install (Drop-in) kernel-install . 198. /etc/kernel/cmdline, /usr/lib/kernel/cmdline, /proc/cmdline (kernel command line) . . "#" . /proc/cmdline . $KERNEL_INSTALL_CONF_ROOT . 198. /etc/kernel/devicetree, /usr/lib/kernel/devicetree (device tree blob dtb) . . $KERNEL_INSTALL_CONF_ROOT . devicetree . /usr/lib/modules/KERNEL_VERSION/dtb/ dtb . "broadcom/bcm2711-rpi-4-b.dtb" devicetree Raspberry Pi 4 Model B /usr/lib/modules/KERNEL_VERSION/dtb/broadcom/bcm2711-rpi-4-b.dtb . 255. /etc/kernel/tries 90-loaderentry.install 90-uki-copy.install . UKI $BOOT/loader/entries/ENTRY-TOKEN-KERNEL-VERSION+TRIES.conf $BOOT/EFI/Linux/ENTRY-TOKEN-KERNEL-VERSION+TRIES.efi . systemd-boot(7) . $KERNEL_INSTALL_CONF_ROOT . 240. /etc/kernel/entry-token << >> . $KERNEL_INSTALL_ENTRY_TOKEN . $KERNEL_INSTALL_CONF_ROOT . 251. /etc/machine-id MACHINE-ID . 198. /etc/os-release, /usr/lib/os-release 90-loaderentry.install . PRETTY_NAME= . "Linux KERNEL-VERSION" . 198. /etc/kernel/install.conf, /run/kernel/install.conf, /usr/local/lib/kernel/install.conf, /usr/lib/kernel/install.conf, /etc/kernel/install.conf.d/*.conf, /run/kernel/install.conf.d/*.conf, /usr/local/lib/kernel/install.conf.d/*.conf, /usr/lib/kernel/install.conf.d/*.conf kernel-install KEY=VALUE os-release(5) . . $KERNEL_INSTALL_CONF_ROOT . (Drop-in) systemd.unit(5) . : MACHINE_ID= BOOT_ROOT= layout= initrd_generator= uki_generator=. . 250. /etc/kernel/uki.conf Ini ukify(1) $KERNEL_INSTALL_LAYOUT layout= install.conf uki $KERNEL_INSTALL_UKI_GENERATOR uki_generator= install.conf ukify . $KERNEL_INSTALL_CONF_ROOT . 255. /usr/lib/modules/KERNEL-VERSION/ . (uname -r) . 255. /usr/lib/modules/KERNEL-VERSION/vmlinuz . ( ) kernel-install add . 255. $KERNEL_INSTALL_CONF_ROOT . . . (SEE ALSO) machine-id(5), os-release(5), depmod(8), systemd-boot(7), ukify(1), UAPI.1 Boot Loader Specification[2] (NOTES) 1. "initrd" CPIO "initramfs" . bootup(7) . 2. UAPI.1 (UAPI.1 Boot Loader Specification) https://uapi- group.org/specifications/specs/boot_loader_specification 3. UAPI.2 (UAPI.2 Discoverable Partitions Specification) https://uapi- group.org/specifications/specs/discoverable_partitions_specification systemd 261.2 KERNEL-INSTALL(8)