Skip to content

Commit 3711b51

Browse files
installkernel.8: update for new changes
Signed-off-by: Nowa Ammerlaan <[email protected]>
1 parent ce12924 commit 3711b51

File tree

1 file changed

+46
-8
lines changed

1 file changed

+46
-8
lines changed

installkernel.8

Lines changed: 46 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22
.SH NAME
33
installkernel \- install a new kernel image
44
.SH SYNOPSIS
5-
.BI "installkernel " "version zImage System.map [directory]"
5+
.BI "installkernel " "version kernel System.map [directory] [--verbose] [--all] [--systemd|--no-systemd]"
66
.SH DESCRIPTION
77
.PP
88
.B installkernel
@@ -29,6 +29,8 @@ If the directory containing
2929
.I System.map
3030
contains
3131
.I .config
32+
or
33+
.I config
3234
file, it is also installed. If the directory containing the kernel image
3335
contains an
3436
.I initrd
@@ -39,17 +41,52 @@ Kernel installs are logged to
3941
in a tab separated file containing the columns:
4042
DATE, KI_VENDOR, VERSION, CONF_ROOT, LAYOUT, INITRD_GEN, UKI_GEN, BOOT_ROOT, KERNEL_REL_PATH, INITRD_REL_PATH and PLUGIN_OVERRIDE.
4143
.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
4260
If systemd's kernel-install is present on the system and the environment
4361
variable
4462
.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
4868
applicable. See the kernel-install manual for more information. Systemd's
4969
kernel-install supports various different layouts, the default "compat" layout
5070
is similar, but not identical, to the layout used by this installkernel. The
5171
locations of plugin scripts, as well as recognized environment variables, are
5272
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+
5390
.SH BUGS
5491
installkernel resides in /sbin only because the Linux kernel makefiles
5592
call it from there. It should really be in /usr/sbin. It isn't
@@ -83,11 +120,12 @@ initrd_generator
83120
.IP \(bu (bullet)
84121
uki_generator
85122
.RE
86-
are read from
87-
.IR /usr/lib/kernel/install.conf
88-
and/or
123+
are read from one of these locations
89124
.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
91129
as:
92130
.RS
93131
.IP \(bu (bullet)

0 commit comments

Comments
 (0)