1KERNEL-INSTALL(8)               kernel-install               KERNEL-INSTALL(8)
2
3
4

NAME

6       kernel-install - Add and remove kernel and initramfs images to and from
7       /boot
8

SYNOPSIS

10       kernel-install COMMAND KERNEL-VERSION [KERNEL-IMAGE]
11

DESCRIPTION

13       kernel-install is used to install and remove kernel and initramfs
14       images to and from /boot.
15
16       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

COMMANDS

30       The following commands are understood:
31
32       add KERNEL-VERSION KERNEL-IMAGE
33           kernel-install creates the directory
34           /boot/MACHINE-ID/KERNEL-VERSION/ and calls every executable
35           /usr/lib/kernel/install.d/*.install and
36           /etc/kernel/install.d/*.install with the arguments
37
38               add KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/
39
40           The kernel-install plugin 50-depmod.install runs depmod for the
41           KERNEL-VERSION.
42
43           The kernel-install plugin 90-loaderentry.install copies
44           KERNEL-IMAGE to /boot/MACHINE-ID/KERNEL-VERSION/linux. It also
45           creates a boot loader entry according to the boot loader
46           specification in
47           /boot/loader/entries/MACHINE-ID-KERNEL-VERSION.conf. The title of
48           the entry is the PRETTY_NAME parameter specified in /etc/os-release
49           or /usr/lib/os-release (if the former is missing), or "Linux
50           KERNEL-VERSION", if unset. If the file initrd is found next to the
51           linux file, the initrd will be added to the configuration.
52
53       remove KERNEL-VERSION
54           Calls every executable /usr/lib/kernel/install.d/*.install and
55           /etc/kernel/install.d/*.install with the arguments
56
57               remove KERNEL-VERSION /boot/MACHINE-ID/KERNEL-VERSION/
58
59           kernel-install removes the entire directory
60           /boot/MACHINE-ID/KERNEL-VERSION/ afterwards.
61
62           The kernel-install plugin 90-loaderentry.install removes the file
63           /boot/loader/entries/MACHINE-ID-KERNEL-VERSION.conf.
64

EXIT STATUS

66       If every executable returns with 0, 0 is returned, a non-zero failure
67       code otherwise.
68

FILES

70       /usr/lib/kernel/install.d/*.install /etc/kernel/install.d/*.install
71           Drop-in files which are executed by kernel-install.
72
73       /etc/kernel/cmdline /proc/cmdline
74           The content of the file /etc/kernel/cmdline specifies the kernel
75           command line to use. If that file does not exist, /proc/cmdline is
76           used.
77
78       /etc/machine-id
79           The content of the file specifies the machine identification
80           MACHINE-ID.
81
82       /etc/os-release /usr/lib/os-release
83           The content of the file specifies the operating system title
84           PRETTY_NAME.
85

SEE ALSO

87       machine-id(5), os-release(5), Boot loader specification[1]
88

NOTES

90        1. Boot loader specification
91           http://www.freedesktop.org/wiki/Specifications/BootLoaderSpec
92
93
94
95systemd 219                                                  KERNEL-INSTALL(8)
Impressum