1KERNEL-INSTALL(8) kernel-install KERNEL-INSTALL(8)
2
6 kernel-install - Add and remove kernel and initramfs images to and from
7 /boot
8
10 kernel-install COMMAND KERNEL-VERSION [KERNEL-IMAGE]
11
13 kernel-install is used to install and remove kernel and initramfs
14 images to and from /boot.
15 kernel-install will execute the files located in the directory
17 /usr/lib/kernel/install.d/ and the local administration directory
18 /etc/kernel/install.d/. All files are collectively sorted and executed
19 in lexical order, regardless of the directory in which they live.
20 However, files with identical filenames replace each other. Files in
21 /etc/kernel/install.d/ take precedence over files with the same name in
22 /usr/lib/kernel/install.d/. This can be used to override a
23 system-supplied executables with a local file if needed; a symbolic
24 link in /etc/kernel/install.d/ with the same name as an executable in
25 /usr/lib/kernel/install.d/, pointing to /dev/null, disables the
26 executable entirely. Executables must have the extension ".install";
27 other extensions are ignored.
28 An executable should return 0 on success. It may also return 77 to
30 cause the whole operation to terminate (executables later in lexical
31 order will be skipped).
32
34 The following commands are understood:
35 add KERNEL-VERSION KERNEL-IMAGE
37 kernel-install creates the directory
38 /boot/MACHINE-ID/KERNEL-VERSION/ and calls executables from
39 /usr/lib/kernel/install.d/*.install and
40 /etc/kernel/install.d/*.install with the arguments
41 add KERNEL-VERSION \
43 /boot/MACHINE-ID/KERNEL-VERSION/ KERNEL-IMAGE
44 The kernel-install plugin 50-depmod.install runs depmod for the
46 KERNEL-VERSION.
47 The kernel-install plugin 90-loaderentry.install copies
49 KERNEL-IMAGE to /boot/MACHINE-ID/KERNEL-VERSION/linux. It also
50 creates a boot loader entry according to the boot loader
51 specification in
52 /boot/loader/entries/MACHINE-ID-KERNEL-VERSION.conf. The title of
53 the entry is the PRETTY_NAME parameter specified in /etc/os-release
54 or /usr/lib/os-release (if the former is missing), or "Linux
55 KERNEL-VERSION", if unset. If the file initrd is found next to the
56 linux file, the initrd will be added to the configuration.
57 remove KERNEL-VERSION
59 Calls executables from /usr/lib/kernel/install.d/*.install and
60 /etc/kernel/install.d/*.install with the arguments
61 remove KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/
63 kernel-install removes the entire directory
65 /boot/MACHINE-ID/KERNEL-VERSION/ afterwards.
66 The kernel-install plugin 90-loaderentry.install removes the file
68 /boot/loader/entries/MACHINE-ID-KERNEL-VERSION.conf.
69
71 If every executable returns 0 or 77, 0 is returned, and a non-zero
72 failure code otherwise.
73
75 /usr/lib/kernel/install.d/*.install /etc/kernel/install.d/*.install
76 Drop-in files which are executed by kernel-install.
77 /etc/kernel/cmdline /proc/cmdline
79 The content of the file /etc/kernel/cmdline specifies the kernel
80 command line to use. If that file does not exist, /proc/cmdline is
81 used.
82 /etc/machine-id
84 The content of the file specifies the machine identification
85 MACHINE-ID.
86 /etc/os-release /usr/lib/os-release
88 The content of the file specifies the operating system title
89 PRETTY_NAME.
90
92 machine-id(5), os-release(5), Boot Loader Specification[1]
93
95 1. Boot Loader Specification
96 https://github.com/systemd/systemd/blob/master/doc/BOOT_LOADER_SPECIFICATION.md
97systemd 239 KERNEL-INSTALL(8)