177 lines
4.8 KiB
HTML
177 lines
4.8 KiB
HTML
|
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
|
<HTML><HEAD><TITLE>Man page of LINUX-UPDATE-SYMLINKS</TITLE>
|
|
</HEAD><BODY>
|
|
<H1>LINUX-UPDATE-SYMLINKS</H1>
|
|
Section: User Commands (1)<BR>Updated: 5 June 2016<BR><A HREF="#index">Index</A>
|
|
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
|
|
|
|
<A NAME="lbAB"> </A>
|
|
<H2>NAME</H2>
|
|
|
|
linux-update-symlinks - maintain symlinks to default kernel and initramfs
|
|
<P>
|
|
<A NAME="lbAC"> </A>
|
|
<H2>SYNOPSIS</H2>
|
|
|
|
<DL COMPACT>
|
|
<DT id="1">
|
|
<B>linux-update-symlinks</B> {<B>install</B>|<B>upgrade</B>|<B>remove</B>}
|
|
|
|
<I>VERSION IMAGE-PATH</I>
|
|
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAD"> </A>
|
|
<H2>DESCRIPTION</H2>
|
|
|
|
<B>linux-update-symlinks</B> is intended to be called from the
|
|
<DD>postinst and postrm maintainer scripts of Linux kernel packages. The
|
|
postinst script must pass the first argument <B>install</B> or
|
|
<B>upgrade</B> depending on whether a fresh installation or an upgrade
|
|
has taken place.
|
|
<P>
|
|
|
|
The <I>VERSION</I> argument must be the kernel version string as shown by
|
|
<B>uname -r</B> and used in filenames.
|
|
<P>
|
|
|
|
The <I>IMAGE-PATH</I> argument must be the absolute filename of the
|
|
kernel image.
|
|
<P>
|
|
|
|
By default, this command maintains symlinks in the root directory.
|
|
This behaviour can be modified by settings in
|
|
<I>/etc/kernel-img.conf</I>:
|
|
<DL COMPACT>
|
|
<DT id="2">
|
|
<DD>
|
|
<B>image_dest</B>
|
|
|
|
Specifies the directory in which to maintain symlinks
|
|
<DT id="3"><B>link_in_boot</B>
|
|
|
|
<DD>
|
|
If set to a true value, specifies that the directory is <I>/boot</I>
|
|
<DT id="4"><B>no_symlinks</B>
|
|
|
|
<DD>
|
|
If set to a false value, disables maintenance of symlinks
|
|
|
|
</DL>
|
|
<P>
|
|
|
|
The symlinks for the primary default kernel version are named
|
|
<I>vmlinuz</I> or <I>vmlinux</I> (depending on whether the architecture
|
|
normally uses compressed kernel images) and <I>initrd.img</I> (if it
|
|
uses an initramfs). The symlinks for the secondary default have the
|
|
same names with the suffix <I>.old</I>.
|
|
<P>
|
|
|
|
If symlink maintenance is disabled, <B>linux-update-symlinks</B> does
|
|
nothing, successfully. Otherwise it makes a list of kernel versions
|
|
in decreasing order of priority:
|
|
<DL COMPACT>
|
|
<DT id="5">•<DD>
|
|
The given <I>VERSION</I>, if the first argument is <B>install</B>
|
|
<DT id="6">•<DD>
|
|
The current primary default version, if it exists and is not already
|
|
listed
|
|
<DT id="7">•<DD>
|
|
The current secondary default version, if it exists and is not already
|
|
listed
|
|
<DT id="8">•<DD>
|
|
All other versions whose files are installed, excluding the specified
|
|
<I>VERSION</I> if the first argument is <B>remove</B>, in decreasing
|
|
version order
|
|
</DL>
|
|
<P>
|
|
|
|
The top two entries on the list are the new primary and secondary
|
|
default versions, and it updates the symlinks accordingly. In case
|
|
there is only one entry, this is both the primary and secondary
|
|
default version. If there are no entries, there are no default
|
|
versions and it removes the default symlinks.
|
|
<P>
|
|
<A NAME="lbAE"> </A>
|
|
<H2>ENVIRONMENT VARIABLES</H2>
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="9"><I>INITRD</I>
|
|
|
|
<DD>
|
|
When the first argument is <B>install</B> or <B>upgrade</B>,
|
|
<B>linux-update-symlinks</B> assumes that the given <I>VERSION</I>
|
|
will use an initramfs unless this variable is set to <B>No</B>.
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAF"> </A>
|
|
<H2>FILES</H2>
|
|
|
|
|
|
<DL COMPACT>
|
|
<DT id="10"><I>/boot/initrd.img-</I>*
|
|
|
|
<DD>
|
|
Installed initramfs images
|
|
<DT id="11"><I>/boot/vmlinuz-</I>* | <I>/boot/vmlinux-</I>*
|
|
|
|
<DD>
|
|
Installed kernel images
|
|
<DT id="12"><I>/etc/kernel-img.conf</I>
|
|
|
|
<DD>
|
|
Configuration file specifying whether and where to create symlinks
|
|
<DT id="13"><I>/initrd.img</I>
|
|
|
|
<DD>
|
|
Symlink to the initramfs image for the primary default version
|
|
<DT id="14"><I>/initrd.img.old</I>
|
|
|
|
<DD>
|
|
Symlink to the initramfs image for the secondary default version
|
|
<DT id="15"><I>/vmlinuz</I> | <I>/vmlinux</I>
|
|
|
|
<DD>
|
|
Symlink to the kernel image for the primary default version
|
|
<DT id="16"><I>/vmlinuz.old</I> | <I>/vmlinux.old</I>
|
|
|
|
<DD>
|
|
Symlink to the kernel image for the secondary default version
|
|
<P>
|
|
</DL>
|
|
<A NAME="lbAG"> </A>
|
|
<H2>AUTHOR</H2>
|
|
|
|
<B>linux-update-symlinks</B> and this manual page were written by Ben
|
|
Hutchings as part of the Debian <B>linux-base</B> package.
|
|
<P>
|
|
<A NAME="lbAH"> </A>
|
|
<H2>SEE ALSO</H2>
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?5+kernel-img.conf">kernel-img.conf</A></I>(5),
|
|
|
|
<I><A HREF="/cgi-bin/man/man2html?1+linux-version">linux-version</A></I>(1).
|
|
|
|
<P>
|
|
|
|
<HR>
|
|
<A NAME="index"> </A><H2>Index</H2>
|
|
<DL>
|
|
<DT id="17"><A HREF="#lbAB">NAME</A><DD>
|
|
<DT id="18"><A HREF="#lbAC">SYNOPSIS</A><DD>
|
|
<DT id="19"><A HREF="#lbAD">DESCRIPTION</A><DD>
|
|
<DT id="20"><A HREF="#lbAE">ENVIRONMENT VARIABLES</A><DD>
|
|
<DT id="21"><A HREF="#lbAF">FILES</A><DD>
|
|
<DT id="22"><A HREF="#lbAG">AUTHOR</A><DD>
|
|
<DT id="23"><A HREF="#lbAH">SEE ALSO</A><DD>
|
|
</DL>
|
|
<HR>
|
|
This document was created by
|
|
<A HREF="/cgi-bin/man/man2html">man2html</A>,
|
|
using the manual pages.<BR>
|
|
Time: 00:05:18 GMT, March 31, 2021
|
|
</BODY>
|
|
</HTML>
|