update-kernel/update-kernel.8
Vitaly Chikunov 22813da0c1 update-kernel: Clarify help about flavour used for '-r'
Signed-off-by: Vitaly Chikunov <vt@altlinux.org>
2024-03-02 01:56:27 +03:00

78 lines
2.0 KiB
Groff

.TH update-kernel 8 "May 15, 2023" "update-kernel 8"
.SH NAME
update-kernel \- Linux kernel update tool
.SH SYNOPSIS
.B update-kernel
[options]
.SH DESCRIPTION
update\-kernel \- script to conveniently update kernel and modules.
.PP
It works by installing a new package set along with existing kernel,
old kernel is kept so that you don\'t end up without a kernel guaranteed
to boot (your good old one); by default, it will look for the most recent
package of the same flavour (e.g. "std\-def") and try to install all the
same modules as already installed for that.
.SH OPTIONS
.TP
\-l, \-\-list
list available kernels
.TP
\-a, \-\-all
install all kernel modules
.TP
\-i, \-\-interactive
interactive modules install
.TP
\-H, \-\-headers
add kernel headers to install
.TP
\-A modulename
include (add) external module (by a short name)
.TP
\-D modulename
exclude (del) external module from install
.TP
\-f, \-y, \-\-force
force kernel upgrade (without confirmation dialog)
.TP
\-t, \-\-type
install kernel with specified flavour (un-def, std\-def, etc)
.TP
\-r, \-\-release
desired kernel release for the current or selected above flavour
(allowed formats by example:
old format: alt1, 5.7.19\-alt1
classic kernel release: 5.7.19\-std\-def\-alt1
package name: [kernel\-image\-]std\-def\-5.7.19\-alt1)
.TP
\-n, \-\-dry-run
perform a simulation of events that would occur but
do not actually change the system
.TP
\-d, \-\-download\-only
download packages but don't install
.TP
\-h, \-\-help
show this text and exit
.PP
Run
.B remove-old-kernels
to uninstall unused kernels.
.SH EXAMPLES
.TP
Download and install latest un-def kernel:
.B update-kernel -t un-def
.PP
.TP
Download and install specific kernel version (Note: it should exist in
repository):
.B update-kernel -r 5.15.70-un-def-alt1
.PP
.SH EXIT STATUS
update-kernel returns a zero exit status if it succeeds.
Non zero is returned in case of failure.
.SH AUTHOR
Man page by Anton Shevtsov (shevtsov.anton (at) gmail.com)
.SH SEE ALSO
apt-get(8)