X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/9fcbe2047293f8ef703439264ed3d35701f51638..b508453a93fb26354b3f7f9fd828216d1cf4636d:/doc/apt.conf.5.xml?ds=sidebyside
diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index c138502b7..e37456d73 100644
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -150,10 +150,11 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
Default-Release
- Default release to install packages from if more than one
- version available. Contains release name, codename or release version. Examples: 'stable', 'testing', 'unstable', 'lenny', 'squeeze', '4.0', '5.0*'. See also &apt-preferences;.
+ Default release to install packages from if more than one
+ version available. Contains release name, codename or release version. Examples: 'stable', 'testing',
+ 'unstable', '&stable-codename;', '&testing-codename;', '4.0', '5.0*'. See also &apt-preferences;.
-
+
Ignore-Hold
Ignore Held packages; This global option causes the problem resolver to
ignore held packages in its decision making.
@@ -198,9 +199,20 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
anything that those packages depend on.
- Cache-Limit
- APT uses a fixed size memory mapped cache file to store the 'available'
- information. This sets the size of that cache (in bytes).
+ Cache-Start, Cache-Grow and Cache-Limit
+ APT uses since version 0.7.26 a resizable memory mapped cache file to store the 'available'
+ information. Cache-Start acts as a hint to which size the Cache will grow
+ and is therefore the amount of memory APT will request at startup. The default value is
+ 20971520 bytes (~20 MB). Note that these amount of space need to be available for APT
+ otherwise it will likely fail ungracefully, so for memory restricted devices these value should
+ be lowered while on systems with a lot of configured sources this might be increased.
+ Cache-Grow defines in byte with the default of 1048576 (~1 MB) how much
+ the Cache size will be increased in the event the space defined by Cache-Start
+ is not enough. These value will be applied again and again until either the cache is big
+ enough to store all information or the size of the cache reaches the Cache-Limit.
+ The default of Cache-Limit is 0 which stands for no limit.
+ If Cache-Grow is set to 0 the automatic grow of the cache is disabled.
+
Build-Essential
@@ -229,6 +241,30 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
and the URI handlers.
+ Check-Valid-Until
+ Security related option defaulting to true as an
+ expiring validation for a Release file prevents longtime replay attacks
+ and can e.g. also help users to identify no longer updated mirrors -
+ but the feature depends on the correctness of the time on the user system.
+ Archive maintainers are encouraged to create Release files with the
+ Valid-Until header, but if they don't or a stricter value
+ is volitional the following Max-ValidTime option can be used.
+
+
+
+ Max-ValidTime
+ Seconds the Release file should be considered valid after
+ it was created. The default is "for ever" (0) if the Release file of the
+ archive doesn't include a Valid-Until header.
+ If it does then this date is the default. The date from the Release file or
+ the date specified by the creation time of the Release file
+ (Date header) plus the seconds specified with this
+ options are used to check if the validation of a file has expired by using
+ the earlier date of the two. Archive specific settings can be made by
+ appending the label of the archive to the option name.
+
+
+
PDiffs
Try to download deltas called PDiffs for
Packages or Sources files instead of downloading whole ones. True
@@ -410,6 +446,36 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
these warnings are most of the time false negatives. Future versions will maybe include a way to
really prefer uncompressed files to support the usage of local mirrors.
+
+ GzipIndexes
+
+ When downloading gzip compressed indexes (Packages, Sources, or
+ Translations), keep them gzip compressed locally instead of unpacking
+ them. This saves quite a lot of disk space at the expense of more CPU
+ requirements when building the local package caches. False by default.
+
+
+
+ Languages
+ The Languages subsection controls which Translation files are downloaded
+ and in which order APT tries to display the Description-Translations. APT will try to display the first
+ available Description in the Language which is listed at first. Languages can be defined with their
+ short or long Languagecodes. Note that not all archives provide Translation
+ files for every Language - especially the long Languagecodes are rare, so please
+ inform you which ones are available before you set here impossible values.
+ The default list includes "environment" and "en". "environment" has a special meaning here:
+ It will be replaced at runtime with the languagecodes extracted from the LC_MESSAGES environment variable.
+ It will also ensure that these codes are not included twice in the list. If LC_MESSAGES
+ is set to "C" only the Translation-en file (if available) will be used.
+ To force apt to use no Translation file use the setting Acquire::Languages=none. "none"
+ is another special meaning code which will stop the search for a fitting Translation file.
+ This can be used by the system administrator to let APT know that it should download also this files without
+ actually use them if the environment doesn't specify this languages. So the following example configuration will
+ result in the order "en, de" in an english and in "de, en" in a german localization. Note that "fr" is downloaded,
+ but not used if APT is not used in a french localization, in such an environment the order would be "fr, de, en".
+ Acquire::Languages { "environment"; "de"; "en"; "none"; "fr"; };
+
+
@@ -461,6 +527,15 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
will be looked up in
/tmp/staging/var/lib/dpkg/status.
+
+
+ The Ignore-Files-Silently list can be used to specify
+ which files APT should silently ignore while parsing the files in the
+ fragment directories. Per default a file which end with .disabled,
+ ~, .bak or .dpkg-[a-z]+
+ is silently ignored. As seen in the last default value these patterns can use regular
+ expression syntax.
+
APT in DSelect
@@ -1001,6 +1076,7 @@ is commented.
-->
+