summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorWesley Schwengle <wesleys@opperschaap.net>2024-01-24 13:16:52 -0400
committerWesley Schwengle <wesleys@opperschaap.net>2024-01-26 14:43:13 -0400
commit8808d81b4f3abfe9e5748ed56664019ef6b2a04d (patch)
treebb77bba4da081ef6d808ee8e30f0a9e80b2c2893
parenta6e30cc02eb24d5b2bbf2cb1b59c48c62d09658f (diff)
Add documentation of autoremove to apt.conf (5)
This commit adds documentation for: APT::Protect-Kernels, APT::NeverAutoRemove::*, APT::VersionedKernelPackages. This is to inform users about the newly introduced NeverAutoRemove::KernelCount feature. Signed-off-by: Wesley Schwengle <wesleys@opperschaap.net>
-rw-r--r--doc/apt.conf.5.xml55
1 files changed, 55 insertions, 0 deletions
diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index e815a58a1..df692bc40 100644
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -311,6 +311,61 @@ APT::Compressor::rev {
<listitem><para>The CDROM subsection controls the &apt-cdrom; tool; please see its
documentation for more information about the options here.</para></listitem>
</varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>NeverAutoRemove</option>
+ </term>
+ <listitem>
+ <para>
+ Never autoremove packages that match the regular expression(s).
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>Protect-Kernels</option>
+ </term>
+ <listitem>
+ <para>
+ This option tells apt autoremove that kernels are protected and
+ defaults to true. In case kernels are not protected they are
+ treated as any other package.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>VersionedKernelPackages</option>
+ </term>
+ <listitem>
+ <para>
+ Define the regular expression(s) for versioned kernel packages.
+ Based on these expressions a rule set is injected into apt
+ similar to APT::NeverAutoRemove regular expressions.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term>
+ <option>NeverAutoRemove::KernelCount</option>
+ </term>
+ <listitem>
+ <para>
+ Keep a custom amount of kernels when autoremoving and defaults
+ to 2, meaning two kernels are kept. Apt will always keep the
+ running kernel and the latest one. If the latest kernel is the
+ same as the running kernel, the second latest kernel is kept.
+ Because of this, any value lower than 2 will be ignored. If you
+ want only the latest kernel, you should set
+ APT::Protect-Kernels to false.
+ </para>
+ </listitem>
+ </varlistentry>
+
</variablelist>
</refsect1>