2
2
.SH NAME
3
3
installkernel \- install a new kernel image
4
4
.SH SYNOPSIS
5
- .BI " installkernel " " version zImage System.map [directory]"
5
+ .BI " installkernel " " version kernel System.map [directory] [--verbose] [--all] [--systemd|--no-systemd ]"
6
6
.SH DESCRIPTION
7
7
.PP
8
8
.B installkernel
@@ -29,6 +29,8 @@ If the directory containing
29
29
.I System.map
30
30
contains
31
31
.I .config
32
+ or
33
+ .I config
32
34
file, it is also installed. If the directory containing the kernel image
33
35
contains an
34
36
.I initrd
@@ -39,17 +41,52 @@ Kernel installs are logged to
39
41
in a tab separated file containing the columns:
40
42
DATE, KI_VENDOR, VERSION, CONF_ROOT, LAYOUT, INITRD_GEN, UKI_GEN, BOOT_ROOT, KERNEL_REL_PATH, INITRD_REL_PATH and PLUGIN_OVERRIDE.
41
43
.P
44
+ When the
45
+ .I version,
46
+ .I kernel,
47
+ and/or
48
+ .I System.map
49
+ positional arguments are not
50
+ given then these values default to the currently running kernel. Meaning
51
+ that version defaults to the value of
52
+ .I uname -r
53
+ and the kernel image defaults to
54
+ .I /lib/modules/$(uname -r)/vmlinuz
55
+ and the System.map defaults to
56
+ .I /lib/modules/$(uname -r)/System.map.
57
+ The fourth positional argument for the installation directory defaults to
58
+ .I /boot.
59
+ .P
42
60
If systemd's kernel-install is present on the system and the environment
43
61
variable
44
62
.B SYSTEMD_KERNEL_INSTALL
45
- is set to 1, then it is called to install the kernel. The default setting
46
- for this environment variable is controlled by the installkernel ebuild. When
47
- kernel installation is delegated to systemd's kernel-install this manual is not
63
+ is set to 1 or the --systemd argument is given, then kernel-install is called
64
+ to install the kernel instead of this script. Any extra arguments given to
65
+ installkernel are passed on to kernel-install. The default setting for this
66
+ environment variable is controlled by the installkernel ebuild. When kernel
67
+ installation is delegated to systemd's kernel-install this manual is not
48
68
applicable. See the kernel-install manual for more information. Systemd's
49
69
kernel-install supports various different layouts, the default "compat" layout
50
70
is similar, but not identical, to the layout used by this installkernel. The
51
71
locations of plugin scripts, as well as recognized environment variables, are
52
72
also different.
73
+ .P
74
+ The
75
+ .I --all
76
+ argument may be used to iteratively install all kernel versions found
77
+ under
78
+ .I /lib/modules.
79
+ When
80
+ .I --all
81
+ is combined with
82
+ .I --systemd
83
+ then systemd's kernel-install is called with the
84
+ .I add-all
85
+ operator instead of the
86
+ .I
87
+ add
88
+ operator.
89
+
53
90
.SH BUGS
54
91
installkernel resides in /sbin only because the Linux kernel makefiles
55
92
call it from there. It should really be in /usr/sbin. It isn't
@@ -83,11 +120,12 @@ initrd_generator
83
120
.IP \(bu (bullet)
84
121
uki_generator
85
122
.RE
86
- are read from
87
- .IR /usr/lib/kernel/install.conf
88
- and/or
123
+ are read from one of these locations
89
124
.IR /etc/kernel/install.conf
90
- , where the latter takes precedence over the former. And exposed to the plugins
125
+ .IR /run/kernel/install.conf
126
+ .IR /usr/local/lib/kernel/install.conf
127
+ .IR /usr/lib/kernel/install.conf
128
+ , where the first available file is used. And exposed to the plugins
91
129
as:
92
130
.RS
93
131
.IP \(bu (bullet)
0 commit comments