summaryrefslogtreecommitdiffstats
path: root/upstream/debian-unstable/man8/kernel-install.8
diff options
context:
space:
mode:
Diffstat (limited to 'upstream/debian-unstable/man8/kernel-install.8')
-rw-r--r--upstream/debian-unstable/man8/kernel-install.827
1 files changed, 16 insertions, 11 deletions
diff --git a/upstream/debian-unstable/man8/kernel-install.8 b/upstream/debian-unstable/man8/kernel-install.8
index 6c8d93d9..06b06a4e 100644
--- a/upstream/debian-unstable/man8/kernel-install.8
+++ b/upstream/debian-unstable/man8/kernel-install.8
@@ -1,5 +1,5 @@
'\" t
-.TH "KERNEL\-INSTALL" "8" "" "systemd 255" "kernel-install"
+.TH "KERNEL\-INSTALL" "8" "" "systemd 256~rc3" "kernel-install"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
@@ -25,6 +25,8 @@ kernel-install \- Add and remove kernel and initrd images to and from /boot
.HP \w'\fBkernel\-install\fR\ 'u
\fBkernel\-install\fR [OPTIONS...] add \fIKERNEL\-VERSION\fR \fIKERNEL\-IMAGE\fR [\fIINITRD\-FILE\fR...]
.HP \w'\fBkernel\-install\fR\ 'u
+\fBkernel\-install\fR [OPTIONS...] add\-all
+.HP \w'\fBkernel\-install\fR\ 'u
\fBkernel\-install\fR [OPTIONS...] remove \fIKERNEL\-VERSION\fR
.HP \w'\fBkernel\-install\fR\ 'u
\fBkernel\-install\fR [OPTIONS...] inspect [\fIKERNEL\-VERSION\fR] [\fIKERNEL\-IMAGE\fR] [\fIINITRD\-FILE\fR...]
@@ -454,7 +456,7 @@ Print a short version string and exit\&.
Do not pipe output into a pager\&.
.RE
.PP
-\fB\-\-json=\fR\fIMODE\fR
+\fB\-\-json=\fR\fB\fIMODE\fR\fR
.RS 4
Shows output formatted as JSON\&. Expects one of
"short"
@@ -634,7 +636,14 @@ will be prepended before
can be set to override the location of the configuration files read by
\fBkernel\-install\fR\&. When set,
install\&.conf,
-entry\-token, and other files will be read from this directory\&.
+entry\-token, and other files will be read from this directory only\&. Note that this path is relative to the host, and in particular
+\fIsymlinks in this directory are resolved relative to the host\fR, even if
+\fB\-\-root=\fR\fB\fIroot\fR\fR
+is used\&. This means that it is generally
+\fInot\fR
+correct to use this variable to specify a directory underneath
+\fIroot\fR
+if symlinks are used there\&.
.PP
\fI$KERNEL_INSTALL_PLUGINS\fR
can be set to override the list of plugins executed by
@@ -745,7 +754,7 @@ will be used\&.
Added in version 198\&.
.RE
.PP
-/etc/kernel/install\&.conf, /usr/lib/kernel/install\&.conf
+/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
.RS 4
Configuration file with options for
\fBkernel\-install\fR, as a series of
@@ -753,7 +762,8 @@ Configuration file with options for
assignments, compatible with shell syntax, following the same rules as described in
\fBos-release\fR(5)\&. The first of the files that is found will be used\&.
\fI$KERNEL_INSTALL_CONF_ROOT\fR
-may be used to override the search path; see below for details\&.
+may be used to override the search path; see below for details\&. Drop\-in files may also be used to extend the configuration with overrides, see
+\fBsystemd.unit\fR(5)\&.
.sp
Currently, the following keys are supported:
\fIMACHINE_ID=\fR,
@@ -814,12 +824,7 @@ environment variable is set, it will override the search path\&. The files will
from the directory specified by the environment variable\&. When the variable is not set, the listed paths are tried in turn, and the first file that exists is used\&.
.SH "SEE ALSO"
.PP
-\fBmachine-id\fR(5),
-\fBos-release\fR(5),
-\fBdepmod\fR(8),
-\fBsystemd-boot\fR(7),
-\fBukify\fR(1),
-\m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[2]\d\s+2
+\fBmachine-id\fR(5), \fBos-release\fR(5), \fBdepmod\fR(8), \fBsystemd-boot\fR(7), \fBukify\fR(1), \m[blue]\fBBoot Loader Specification\fR\m[]\&\s-2\u[2]\d\s+2
.SH "NOTES"
.IP " 1." 4
Nowadays actually CPIO archives used as an "initramfs", rather than "initrd". See