mirror of
https://git.proxmox.com/git/systemd
synced 2025-05-29 11:49:14 +00:00
164 lines
4.7 KiB
Groff
164 lines
4.7 KiB
Groff
'\" t
|
|
.TH "KERNEL\-INSTALL" "8" "" "systemd 219" "kernel-install"
|
|
.\" -----------------------------------------------------------------
|
|
.\" * Define some portability stuff
|
|
.\" -----------------------------------------------------------------
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.\" http://bugs.debian.org/507673
|
|
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
|
|
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
|
|
.ie \n(.g .ds Aq \(aq
|
|
.el .ds Aq '
|
|
.\" -----------------------------------------------------------------
|
|
.\" * set default formatting
|
|
.\" -----------------------------------------------------------------
|
|
.\" disable hyphenation
|
|
.nh
|
|
.\" disable justification (adjust text to left margin only)
|
|
.ad l
|
|
.\" -----------------------------------------------------------------
|
|
.\" * MAIN CONTENT STARTS HERE *
|
|
.\" -----------------------------------------------------------------
|
|
.SH "NAME"
|
|
kernel-install \- Add and remove kernel and initramfs images to and from /boot
|
|
.SH "SYNOPSIS"
|
|
.HP \w'\fBkernel\-install\fR\ 'u
|
|
\fBkernel\-install\fR COMMAND \fIKERNEL\-VERSION\fR [\fIKERNEL\-IMAGE\fR]
|
|
.SH "DESCRIPTION"
|
|
.PP
|
|
\fBkernel\-install\fR
|
|
is used to install and remove kernel and initramfs images to and from
|
|
/boot\&.
|
|
.PP
|
|
\fBkernel\-install\fR
|
|
will execute the files located in the directory
|
|
/usr/lib/kernel/install\&.d/
|
|
and the local administration directory
|
|
/etc/kernel/install\&.d/\&. All files are collectively sorted and executed in lexical order, regardless of the directory in which they live\&. However, files with identical filenames replace each other\&. Files in
|
|
/etc/kernel/install\&.d/
|
|
take precedence over files with the same name in
|
|
/usr/lib/kernel/install\&.d/\&. This can be used to override a system\-supplied executables with a local file if needed; a symbolic link in
|
|
/etc/kernel/install\&.d/
|
|
with the same name as an executable in
|
|
/usr/lib/kernel/install\&.d/, pointing to /dev/null, disables the executable entirely\&. Executables must have the extension
|
|
"\&.install"; other extensions are ignored\&.
|
|
.SH "COMMANDS"
|
|
.PP
|
|
The following commands are understood:
|
|
.PP
|
|
\fBadd \fR\fB\fIKERNEL\-VERSION\fR\fR\fB \fR\fB\fIKERNEL\-IMAGE\fR\fR
|
|
.RS 4
|
|
\fBkernel\-install\fR
|
|
creates the directory
|
|
/boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/
|
|
and calls every executable
|
|
/usr/lib/kernel/install\&.d/*\&.install
|
|
and
|
|
/etc/kernel/install\&.d/*\&.install
|
|
with the arguments
|
|
.sp
|
|
.if n \{\
|
|
.RS 4
|
|
.\}
|
|
.nf
|
|
add \fIKERNEL\-VERSION\fR /boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/
|
|
.fi
|
|
.if n \{\
|
|
.RE
|
|
.\}
|
|
.sp
|
|
The kernel\-install plugin
|
|
50\-depmod\&.install
|
|
runs depmod for the
|
|
\fIKERNEL\-VERSION\fR\&.
|
|
.sp
|
|
The kernel\-install plugin
|
|
90\-loaderentry\&.install
|
|
copies
|
|
\fIKERNEL\-IMAGE\fR
|
|
to
|
|
/boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/linux\&. It also creates a boot loader entry according to the boot loader specification in
|
|
/boot/loader/entries/\fIMACHINE\-ID\fR\-\fIKERNEL\-VERSION\fR\&.conf\&. The title of the entry is the
|
|
\fIPRETTY_NAME\fR
|
|
parameter specified in
|
|
/etc/os\-release
|
|
or
|
|
/usr/lib/os\-release
|
|
(if the former is missing), or "Linux
|
|
\fIKERNEL\-VERSION\fR", if unset\&. If the file
|
|
initrd
|
|
is found next to the
|
|
linux
|
|
file, the initrd will be added to the configuration\&.
|
|
.RE
|
|
.PP
|
|
\fBremove \fR\fB\fIKERNEL\-VERSION\fR\fR
|
|
.RS 4
|
|
Calls every executable
|
|
/usr/lib/kernel/install\&.d/*\&.install
|
|
and
|
|
/etc/kernel/install\&.d/*\&.install
|
|
with the arguments
|
|
.sp
|
|
.if n \{\
|
|
.RS 4
|
|
.\}
|
|
.nf
|
|
remove \fIKERNEL\-VERSION\fR /boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/
|
|
.fi
|
|
.if n \{\
|
|
.RE
|
|
.\}
|
|
.sp
|
|
\fBkernel\-install\fR
|
|
removes the entire directory
|
|
/boot/\fIMACHINE\-ID\fR/\fIKERNEL\-VERSION\fR/
|
|
afterwards\&.
|
|
.sp
|
|
The kernel\-install plugin
|
|
90\-loaderentry\&.install
|
|
removes the file
|
|
/boot/loader/entries/\fIMACHINE\-ID\fR\-\fIKERNEL\-VERSION\fR\&.conf\&.
|
|
.RE
|
|
.SH "EXIT STATUS"
|
|
.PP
|
|
If every executable returns with 0, 0 is returned, a non\-zero failure code otherwise\&.
|
|
.SH "FILES"
|
|
.PP
|
|
/usr/lib/kernel/install\&.d/*\&.install /etc/kernel/install\&.d/*\&.install
|
|
.RS 4
|
|
Drop\-in files which are executed by kernel\-install\&.
|
|
.RE
|
|
.PP
|
|
/etc/kernel/cmdline /proc/cmdline
|
|
.RS 4
|
|
The content of the file
|
|
/etc/kernel/cmdline
|
|
specifies the kernel command line to use\&. If that file does not exist,
|
|
/proc/cmdline
|
|
is used\&.
|
|
.RE
|
|
.PP
|
|
/etc/machine\-id
|
|
.RS 4
|
|
The content of the file specifies the machine identification
|
|
\fIMACHINE\-ID\fR\&.
|
|
.RE
|
|
.PP
|
|
/etc/os\-release /usr/lib/os\-release
|
|
.RS 4
|
|
The content of the file specifies the operating system title
|
|
\fIPRETTY_NAME\fR\&.
|
|
.RE
|
|
.SH "SEE ALSO"
|
|
.PP
|
|
\fBmachine-id\fR(5),
|
|
\fBos-release\fR(5),
|
|
\m[blue]\fBBoot loader specification\fR\m[]\&\s-2\u[1]\d\s+2
|
|
.SH "NOTES"
|
|
.IP " 1." 4
|
|
Boot loader specification
|
|
.RS 4
|
|
\%http://www.freedesktop.org/wiki/Specifications/BootLoaderSpec
|
|
.RE
|