Commit | Line | Data |
---|---|---|
24f6490f AL |
1 | <?xml version="1.0" encoding="utf-8" standalone="no"?> |
2 | <!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.2//EN" | |
3 | "http://www.oasis-open.org/docbook/xml/4.2/docbookx.dtd" [ | |
4 | ||
5 | <!ENTITY % aptent SYSTEM "apt.ent"> | |
6 | %aptent; | |
7 | ||
8 | ]> | |
9 | ||
10 | <refentry> | |
5e80de29 AL |
11 | |
12 | <refentryinfo> | |
13 | &apt-author.jgunthorpe; | |
14 | &apt-author.team; | |
be1b8568 EL |
15 | <author> |
16 | <firstname>Daniel</firstname> | |
17 | <surname>Burrows</surname> | |
18 | <contrib>Initial documentation of Debug::*.</contrib> | |
19 | <email>dburrows@debian.org</email> | |
20 | </author> | |
5e80de29 AL |
21 | &apt-email; |
22 | &apt-product; | |
23 | <!-- The last update date --> | |
d5081aee | 24 | <date>18 September 2009</date> |
5e80de29 | 25 | </refentryinfo> |
24f6490f AL |
26 | |
27 | <refmeta> | |
28 | <refentrytitle>apt.conf</refentrytitle> | |
29 | <manvolnum>5</manvolnum> | |
f0599b9c | 30 | <refmiscinfo class="manual">APT</refmiscinfo> |
24f6490f AL |
31 | </refmeta> |
32 | ||
33 | <!-- Man page title --> | |
34 | <refnamediv> | |
35 | <refname>apt.conf</refname> | |
36 | <refpurpose>Configuration file for APT</refpurpose> | |
37 | </refnamediv> | |
38 | ||
39 | <refsect1><title>Description</title> | |
40 | <para><filename>apt.conf</filename> is the main configuration file for the APT suite of | |
41 | tools, all tools make use of the configuration file and a common command line | |
42 | parser to provide a uniform environment. When an APT tool starts up it will | |
43 | read the configuration specified by the <envar>APT_CONFIG</envar> environment | |
44 | variable (if any) and then read the files in <literal>Dir::Etc::Parts</literal> | |
45 | then read the main configuration file specified by | |
46 | <literal>Dir::Etc::main</literal> then finally apply the | |
47 | command line options to override the configuration directives, possibly | |
48 | loading even more config files.</para> | |
49 | ||
50 | <para>The configuration file is organized in a tree with options organized into | |
5f4331c4 | 51 | functional groups. Option specification is given with a double colon |
24f6490f | 52 | notation, for instance <literal>APT::Get::Assume-Yes</literal> is an option within |
5f4331c4 | 53 | the APT tool group, for the Get tool. Options do not inherit from their |
24f6490f AL |
54 | parent groups.</para> |
55 | ||
e3a1f08d | 56 | <para>Syntactically the configuration language is modeled after what the ISC tools |
7f1bc985 EL |
57 | such as bind and dhcp use. Lines starting with |
58 | <literal>//</literal> are treated as comments (ignored), as well as all text | |
59 | between <literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments. | |
24f6490f | 60 | Each line is of the form |
5f4331c4 | 61 | <literal>APT::Get::Assume-Yes "true";</literal>. The trailing |
52f2e1da JAK |
62 | semicolon and the quotes are required. The value must be on one line, and |
63 | there is no kind of string concatenation. It must not include inside quotes. | |
64 | The behavior of the backslash "\" and escaped characters inside a value is | |
31f113db JAK |
65 | undefined and it should not be used. An option name may include |
66 | alphanumerical characters and the "/-:._+" characters. A new scope can | |
67 | be opened with curly braces, like:</para> | |
24f6490f AL |
68 | |
69 | <informalexample><programlisting> | |
70 | APT { | |
71 | Get { | |
72 | Assume-Yes "true"; | |
73 | Fix-Broken "true"; | |
74 | }; | |
75 | }; | |
76 | </programlisting></informalexample> | |
77 | ||
78 | <para>with newlines placed to make it more readable. Lists can be created by | |
d82cdf73 | 79 | opening a scope and including a single string enclosed in quotes followed by a |
24f6490f AL |
80 | semicolon. Multiple entries can be included, each separated by a semicolon.</para> |
81 | ||
82 | <informalexample><programlisting> | |
83 | DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; | |
84 | </programlisting></informalexample> | |
85 | ||
86 | <para>In general the sample configuration file in | |
87 | <filename>&docdir;examples/apt.conf</filename> &configureindex; | |
88 | is a good guide for how it should look.</para> | |
89 | ||
fb3b7ef0 LB |
90 | <para>The names of the configuration items are not case-sensitive. So in the previous example |
91 | you could use <literal>dpkg::pre-install-pkgs</literal>.</para> | |
92 | ||
63fc5550 DK |
93 | <para>Names for the configuration items are optional if a list is defined as it can be see in |
94 | the <literal>DPkg::Pre-Install-Pkgs</literal> example above. If you don't specify a name a | |
95 | new entry will simply add a new option to the list. If you specify a name you can override | |
96 | the option as every other option by reassigning a new value to the option.</para> | |
97 | ||
334459ab JAK |
98 | <para>Two specials are allowed, <literal>#include</literal> (which is deprecated |
99 | and not supported by alternative implementations) and <literal>#clear</literal>: | |
24f6490f AL |
100 | <literal>#include</literal> will include the given file, unless the filename |
101 | ends in a slash, then the whole directory is included. | |
d82cdf73 | 102 | <literal>#clear</literal> is used to erase a part of the configuration tree. The |
63fc5550 DK |
103 | specified element and all its descendants are erased. |
104 | (Note that these lines also need to end with a semicolon.)</para> | |
105 | ||
106 | <para>The #clear command is the only way to delete a list or a complete scope. | |
107 | Reopening a scope or the ::-style described below will <emphasis>not</emphasis> | |
a9564741 | 108 | override previously written entries. Only options can be overridden by addressing a new |
63fc5550 | 109 | value to it - lists and scopes can't be overridden, only cleared.</para> |
24f6490f AL |
110 | |
111 | <para>All of the APT tools take a -o option which allows an arbitrary configuration | |
112 | directive to be specified on the command line. The syntax is a full option | |
113 | name (<literal>APT::Get::Assume-Yes</literal> for instance) followed by an equals | |
114 | sign then the new value of the option. Lists can be appended too by adding | |
63fc5550 | 115 | a trailing :: to the list name. (As you might suspect: The scope syntax can't be used |
a9564741 | 116 | on the command line.)</para> |
63fc5550 DK |
117 | |
118 | <para>Note that you can use :: only for appending one item per line to a list and | |
119 | that you should not use it in combination with the scope syntax. | |
120 | (The scope syntax implicit insert ::) Using both syntaxes together will trigger a bug | |
121 | which some users unfortunately relay on: An option with the unusual name "<literal>::</literal>" | |
122 | which acts like every other option with a name. These introduces many problems | |
123 | including that a user who writes multiple lines in this <emphasis>wrong</emphasis> syntax in | |
124 | the hope to append to a list will gain the opposite as only the last assignment for this option | |
125 | "<literal>::</literal>" will be used. Upcoming APT versions will raise errors and | |
126 | will stop working if they encounter this misuse, so please correct such statements now | |
127 | as long as APT doesn't complain explicit about them.</para> | |
24f6490f AL |
128 | </refsect1> |
129 | ||
130 | <refsect1><title>The APT Group</title> | |
131 | <para>This group of options controls general APT behavior as well as holding the | |
132 | options for all of the tools.</para> | |
133 | ||
134 | <variablelist> | |
135 | <varlistentry><term>Architecture</term> | |
136 | <listitem><para>System Architecture; sets the architecture to use when fetching files and | |
137 | parsing package lists. The internal default is the architecture apt was | |
138 | compiled for.</para></listitem> | |
139 | </varlistentry> | |
140 | ||
60a8f9c0 EL |
141 | <varlistentry><term>Default-Release</term> |
142 | <listitem><para>Default release to install packages from if more than one | |
efc487fb | 143 | version available. Contains release name, codename or release version. Examples: 'stable', 'testing', 'unstable', 'lenny', 'squeeze', '4.0', '5.0*'. See also &apt-preferences;.</para></listitem> |
60a8f9c0 EL |
144 | </varlistentry> |
145 | ||
24f6490f AL |
146 | <varlistentry><term>Ignore-Hold</term> |
147 | <listitem><para>Ignore Held packages; This global option causes the problem resolver to | |
148 | ignore held packages in its decision making.</para></listitem> | |
149 | </varlistentry> | |
150 | ||
151 | <varlistentry><term>Clean-Installed</term> | |
152 | <listitem><para>Defaults to on. When turned on the autoclean feature will remove any packages | |
153 | which can no longer be downloaded from the cache. If turned off then | |
154 | packages that are locally installed are also excluded from cleaning - but | |
155 | note that APT provides no direct means to reinstall them.</para></listitem> | |
156 | </varlistentry> | |
157 | ||
158 | <varlistentry><term>Immediate-Configure</term> | |
f66a64c2 DK |
159 | <listitem><para>Defaults to on which will cause APT to install essential and important packages |
160 | as fast as possible in the install/upgrade operation. This is done to limit the effect of a failing | |
20382bad | 161 | &dpkg; call: If this option is disabled APT does treat an important package in the same way as |
f66a64c2 DK |
162 | an extra package: Between the unpacking of the important package A and his configuration can then |
163 | be many other unpack or configuration calls, e.g. for package B which has no relation to A, but | |
164 | causes the dpkg call to fail (e.g. because maintainer script of package B generates an error) which results | |
165 | in a system state in which package A is unpacked but unconfigured - each package depending on A is now no | |
166 | longer guaranteed to work as their dependency on A is not longer satisfied. The immediate configuration marker | |
167 | is also applied to all dependencies which can generate a problem if the dependencies e.g. form a circle | |
168 | as a dependency with the immediate flag is comparable with a Pre-Dependency. So in theory it is possible | |
169 | that APT encounters a situation in which it is unable to perform immediate configuration, error out and | |
170 | refers to this option so the user can deactivate the immediate configuration temporary to be able to perform | |
171 | an install/upgrade again. Note the use of the word "theory" here as this problem was only encountered by now | |
172 | in real world a few times in non-stable distribution versions and caused by wrong dependencies of the package | |
20382bad DK |
173 | in question or by a system in an already broken state, so you should not blindly disable this option as |
174 | the mentioned scenario above is not the only problem immediate configuration can help to prevent in the first place. | |
175 | Before a big operation like <literal>dist-upgrade</literal> is run with this option disabled it should be tried to | |
176 | explicitly <literal>install</literal> the package APT is unable to configure immediately, but please make sure to | |
177 | report your problem also to your distribution and to the APT team with the buglink below so they can work on | |
178 | improving or correcting the upgrade process.</para></listitem> | |
24f6490f AL |
179 | </varlistentry> |
180 | ||
181 | <varlistentry><term>Force-LoopBreak</term> | |
182 | <listitem><para>Never Enable this option unless you -really- know what you are doing. It | |
183 | permits APT to temporarily remove an essential package to break a | |
184 | Conflicts/Conflicts or Conflicts/Pre-Depend loop between two essential | |
185 | packages. SUCH A LOOP SHOULD NEVER EXIST AND IS A GRAVE BUG. This option | |
186 | will work if the essential packages are not tar, gzip, libc, dpkg, bash or | |
187 | anything that those packages depend on.</para></listitem> | |
188 | </varlistentry> | |
189 | ||
190 | <varlistentry><term>Cache-Limit</term> | |
191 | <listitem><para>APT uses a fixed size memory mapped cache file to store the 'available' | |
a04c23d7 | 192 | information. This sets the size of that cache (in bytes).</para></listitem> |
24f6490f AL |
193 | </varlistentry> |
194 | ||
195 | <varlistentry><term>Build-Essential</term> | |
196 | <listitem><para>Defines which package(s) are considered essential build dependencies.</para></listitem> | |
197 | </varlistentry> | |
198 | ||
199 | <varlistentry><term>Get</term> | |
200 | <listitem><para>The Get subsection controls the &apt-get; tool, please see its | |
201 | documentation for more information about the options here.</para></listitem> | |
202 | </varlistentry> | |
203 | ||
204 | <varlistentry><term>Cache</term> | |
205 | <listitem><para>The Cache subsection controls the &apt-cache; tool, please see its | |
206 | documentation for more information about the options here.</para></listitem> | |
207 | </varlistentry> | |
208 | ||
209 | <varlistentry><term>CDROM</term> | |
210 | <listitem><para>The CDROM subsection controls the &apt-cdrom; tool, please see its | |
211 | documentation for more information about the options here.</para></listitem> | |
212 | </varlistentry> | |
213 | </variablelist> | |
214 | </refsect1> | |
215 | ||
216 | <refsect1><title>The Acquire Group</title> | |
217 | <para>The <literal>Acquire</literal> group of options controls the download of packages | |
218 | and the URI handlers. | |
219 | ||
220 | <variablelist> | |
0d70b055 | 221 | <varlistentry><term>PDiffs</term> |
d82cdf73 | 222 | <listitem><para>Try to download deltas called <literal>PDiffs</literal> for |
0d70b055 EL |
223 | Packages or Sources files instead of downloading whole ones. True |
224 | by default.</para></listitem> | |
225 | </varlistentry> | |
226 | ||
24f6490f AL |
227 | <varlistentry><term>Queue-Mode</term> |
228 | <listitem><para>Queuing mode; <literal>Queue-Mode</literal> can be one of <literal>host</literal> or | |
229 | <literal>access</literal> which determines how APT parallelizes outgoing | |
230 | connections. <literal>host</literal> means that one connection per target host | |
231 | will be opened, <literal>access</literal> means that one connection per URI type | |
232 | will be opened.</para></listitem> | |
233 | </varlistentry> | |
234 | ||
235 | <varlistentry><term>Retries</term> | |
236 | <listitem><para>Number of retries to perform. If this is non-zero APT will retry failed | |
237 | files the given number of times.</para></listitem> | |
238 | </varlistentry> | |
239 | ||
240 | <varlistentry><term>Source-Symlinks</term> | |
241 | <listitem><para>Use symlinks for source archives. If set to true then source archives will | |
242 | be symlinked when possible instead of copying. True is the default.</para></listitem> | |
243 | </varlistentry> | |
244 | ||
245 | <varlistentry><term>http</term> | |
246 | <listitem><para>HTTP URIs; http::Proxy is the default http proxy to use. It is in the | |
247 | standard form of <literal>http://[[user][:pass]@]host[:port]/</literal>. Per | |
248 | host proxies can also be specified by using the form | |
249 | <literal>http::Proxy::<host></literal> with the special keyword <literal>DIRECT</literal> | |
788a8f42 EL |
250 | meaning to use no proxies. If no one of the above settings is specified, |
251 | <envar>http_proxy</envar> environment variable | |
252 | will be used.</para> | |
24f6490f AL |
253 | |
254 | <para>Three settings are provided for cache control with HTTP/1.1 compliant | |
255 | proxy caches. <literal>No-Cache</literal> tells the proxy to not use its cached | |
256 | response under any circumstances, <literal>Max-Age</literal> is sent only for | |
257 | index files and tells the cache to refresh its object if it is older than | |
258 | the given number of seconds. Debian updates its index files daily so the | |
259 | default is 1 day. <literal>No-Store</literal> specifies that the cache should never | |
260 | store this request, it is only set for archive files. This may be useful | |
261 | to prevent polluting a proxy cache with very large .deb files. Note: | |
262 | Squid 2.0.2 does not support any of these options.</para> | |
263 | ||
264 | <para>The option <literal>timeout</literal> sets the timeout timer used by the method, | |
265 | this applies to all things including connection timeout and data timeout.</para> | |
266 | ||
267 | <para>One setting is provided to control the pipeline depth in cases where the | |
5f4331c4 | 268 | remote server is not RFC conforming or buggy (such as Squid 2.0.2). |
24f6490f AL |
269 | <literal>Acquire::http::Pipeline-Depth</literal> can be a value from 0 to 5 |
270 | indicating how many outstanding requests APT should send. A value of | |
271 | zero MUST be specified if the remote host does not properly linger | |
272 | on TCP connections - otherwise data corruption will occur. Hosts which | |
5900bd8d DK |
273 | require this are in violation of RFC 2068.</para> |
274 | ||
275 | <para>The used bandwidth can be limited with <literal>Acquire::http::Dl-Limit</literal> | |
276 | which accepts integer values in kilobyte. The default value is 0 which deactivates | |
a9564741 | 277 | the limit and tries uses as much as possible of the bandwidth (Note that this option implicit |
4494239c DK |
278 | deactivates the download from multiple servers at the same time.)</para> |
279 | ||
280 | <para><literal>Acquire::http::User-Agent</literal> can be used to set a different | |
281 | User-Agent for the http download method as some proxies allow access for clients | |
282 | only if the client uses a known identifier.</para> | |
283 | </listitem> | |
24f6490f AL |
284 | </varlistentry> |
285 | ||
370ad5e1 EL |
286 | <varlistentry><term>https</term> |
287 | <listitem><para>HTTPS URIs. Cache-control and proxy options are the same as for | |
288 | <literal>http</literal> method. | |
289 | <literal>Pipeline-Depth</literal> option is not supported yet.</para> | |
290 | ||
291 | <para><literal>CaInfo</literal> suboption specifies place of file that | |
292 | holds info about trusted certificates. | |
293 | <literal><host>::CaInfo</literal> is corresponding per-host option. | |
294 | <literal>Verify-Peer</literal> boolean suboption determines whether verify | |
295 | server's host certificate against trusted certificates or not. | |
296 | <literal><host>::Verify-Peer</literal> is corresponding per-host option. | |
297 | <literal>Verify-Host</literal> boolean suboption determines whether verify | |
298 | server's hostname or not. | |
299 | <literal><host>::Verify-Host</literal> is corresponding per-host option. | |
300 | <literal>SslCert</literal> determines what certificate to use for client | |
301 | authentication. <literal><host>::SslCert</literal> is corresponding per-host option. | |
302 | <literal>SslKey</literal> determines what private key to use for client | |
303 | authentication. <literal><host>::SslKey</literal> is corresponding per-host option. | |
304 | <literal>SslForceVersion</literal> overrides default SSL version to use. | |
305 | Can contain 'TLSv1' or 'SSLv3' string. | |
306 | <literal><host>::SslForceVersion</literal> is corresponding per-host option. | |
307 | </para></listitem></varlistentry> | |
308 | ||
24f6490f | 309 | <varlistentry><term>ftp</term> |
788a8f42 EL |
310 | <listitem><para>FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the |
311 | standard form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per | |
312 | host proxies can also be specified by using the form | |
313 | <literal>ftp::Proxy::<host></literal> with the special keyword <literal>DIRECT</literal> | |
314 | meaning to use no proxies. If no one of the above settings is specified, | |
315 | <envar>ftp_proxy</envar> environment variable | |
316 | will be used. To use a ftp | |
24f6490f AL |
317 | proxy you will have to set the <literal>ftp::ProxyLogin</literal> script in the |
318 | configuration file. This entry specifies the commands to send to tell | |
319 | the proxy server what to connect to. Please see | |
320 | &configureindex; for an example of | |
e3a1f08d | 321 | how to do this. The substitution variables available are |
24f6490f AL |
322 | <literal>$(PROXY_USER)</literal> <literal>$(PROXY_PASS)</literal> <literal>$(SITE_USER)</literal> |
323 | <literal>$(SITE_PASS)</literal> <literal>$(SITE)</literal> and <literal>$(SITE_PORT)</literal> | |
324 | Each is taken from it's respective URI component.</para> | |
325 | ||
326 | <para>The option <literal>timeout</literal> sets the timeout timer used by the method, | |
327 | this applies to all things including connection timeout and data timeout.</para> | |
328 | ||
329 | <para>Several settings are provided to control passive mode. Generally it is | |
330 | safe to leave passive mode on, it works in nearly every environment. | |
331 | However some situations require that passive mode be disabled and port | |
332 | mode ftp used instead. This can be done globally, for connections that | |
333 | go through a proxy or for a specific host (See the sample config file | |
334 | for examples).</para> | |
335 | ||
336 | <para>It is possible to proxy FTP over HTTP by setting the <envar>ftp_proxy</envar> | |
337 | environment variable to a http url - see the discussion of the http method | |
338 | above for syntax. You cannot set this in the configuration file and it is | |
339 | not recommended to use FTP over HTTP due to its low efficiency.</para> | |
340 | ||
341 | <para>The setting <literal>ForceExtended</literal> controls the use of RFC2428 | |
e3a1f08d | 342 | <literal>EPSV</literal> and <literal>EPRT</literal> commands. The default is false, which means |
24f6490f AL |
343 | these commands are only used if the control connection is IPv6. Setting this |
344 | to true forces their use even on IPv4 connections. Note that most FTP servers | |
345 | do not support RFC2428.</para></listitem> | |
346 | </varlistentry> | |
347 | ||
348 | <varlistentry><term>cdrom</term> | |
349 | <listitem><para>CDROM URIs; the only setting for CDROM URIs is the mount point, | |
350 | <literal>cdrom::Mount</literal> which must be the mount point for the CDROM drive | |
351 | as specified in <filename>/etc/fstab</filename>. It is possible to provide | |
352 | alternate mount and unmount commands if your mount point cannot be listed | |
353 | in the fstab (such as an SMB mount and old mount packages). The syntax | |
31f113db | 354 | is to put <literallayout>/cdrom/::Mount "foo";</literallayout> within |
24f6490f AL |
355 | the cdrom block. It is important to have the trailing slash. Unmount |
356 | commands can be specified using UMount.</para></listitem> | |
357 | </varlistentry> | |
8a3642bd MV |
358 | |
359 | <varlistentry><term>gpgv</term> | |
360 | <listitem><para>GPGV URIs; the only option for GPGV URIs is the option to pass additional parameters to gpgv. | |
361 | <literal>gpgv::Options</literal> Additional options passed to gpgv. | |
362 | </para></listitem> | |
363 | </varlistentry> | |
364 | ||
e85b4cd5 DK |
365 | <varlistentry><term>CompressionTypes</term> |
366 | <listitem><para>List of compression types which are understood by the acquire methods. | |
367 | Files like <filename>Packages</filename> can be available in various compression formats. | |
8bd02d8b DK |
368 | Per default the acquire methods can decompress <command>bzip2</command>, <command>lzma</command> |
369 | and <command>gzip</command> compressed files, with this setting more formats can be added | |
370 | on the fly or the used method can be changed. The syntax for this is: | |
e85b4cd5 | 371 | <synopsis>Acquire::CompressionTypes::<replaceable>FileExtension</replaceable> "<replaceable>Methodname</replaceable>";</synopsis> |
8bd02d8b DK |
372 | </para><para>Also the <literal>Order</literal> subgroup can be used to define in which order |
373 | the acquire system will try to download the compressed files. The acquire system will try the first | |
374 | and proceed with the next compression type in this list on error, so to prefer one over the other type | |
375 | simple add the preferred type at first - not already added default types will be added at run time | |
376 | to the end of the list, so e.g. <synopsis>Acquire::CompressionTypes::Order:: "gz";</synopsis> can | |
377 | be used to prefer <command>gzip</command> compressed files over <command>bzip2</command> and <command>lzma</command>. | |
378 | If <command>lzma</command> should be preferred over <command>gzip</command> and <command>bzip2</command> the | |
379 | configure setting should look like this <synopsis>Acquire::CompressionTypes::Order { "lzma"; "gz"; };</synopsis> | |
380 | It is not needed to add <literal>bz2</literal> explicit to the list as it will be added automatic.</para> | |
381 | <para>Note that at run time the <literal>Dir::Bin::<replaceable>Methodname</replaceable></literal> will | |
e85b4cd5 | 382 | be checked: If this setting exists the method will only be used if this file exists, e.g. for |
8bd02d8b | 383 | the bzip2 method (the inbuilt) setting is <literallayout>Dir::Bin::bzip2 "/bin/bzip2";</literallayout> |
a9564741 | 384 | Note also that list entries specified on the command line will be added at the end of the list |
8bd02d8b DK |
385 | specified in the configuration files, but before the default entries. To prefer a type in this case |
386 | over the ones specified in in the configuration files you can set the option direct - not in list style. | |
387 | This will not override the defined list, it will only prefix the list with this type.</para> | |
388 | <para>While it is possible to add an empty compression type to the order list, but APT in its current | |
389 | version doesn't understand it correctly and will display many warnings about not downloaded files - | |
390 | these warnings are most of the time false negatives. Future versions will maybe include a way to | |
391 | really prefer uncompressed files to support the usage of local mirrors.</para></listitem> | |
e85b4cd5 | 392 | </varlistentry> |
24f6490f AL |
393 | </variablelist> |
394 | </para> | |
395 | </refsect1> | |
396 | ||
397 | <refsect1><title>Directories</title> | |
398 | ||
399 | <para>The <literal>Dir::State</literal> section has directories that pertain to local | |
400 | state information. <literal>lists</literal> is the directory to place downloaded | |
401 | package lists in and <literal>status</literal> is the name of the dpkg status file. | |
402 | <literal>preferences</literal> is the name of the APT preferences file. | |
403 | <literal>Dir::State</literal> contains the default directory to prefix on all sub | |
404 | items if they do not start with <filename>/</filename> or <filename>./</filename>.</para> | |
405 | ||
406 | <para><literal>Dir::Cache</literal> contains locations pertaining to local cache | |
407 | information, such as the two package caches <literal>srcpkgcache</literal> and | |
408 | <literal>pkgcache</literal> as well as the location to place downloaded archives, | |
409 | <literal>Dir::Cache::archives</literal>. Generation of caches can be turned off | |
410 | by setting their names to be blank. This will slow down startup but | |
e3a1f08d | 411 | save disk space. It is probably preferred to turn off the pkgcache rather |
24f6490f AL |
412 | than the srcpkgcache. Like <literal>Dir::State</literal> the default |
413 | directory is contained in <literal>Dir::Cache</literal></para> | |
414 | ||
415 | <para><literal>Dir::Etc</literal> contains the location of configuration files, | |
416 | <literal>sourcelist</literal> gives the location of the sourcelist and | |
417 | <literal>main</literal> is the default configuration file (setting has no effect, | |
418 | unless it is done from the config file specified by | |
13e8426f | 419 | <envar>APT_CONFIG</envar>).</para> |
24f6490f AL |
420 | |
421 | <para>The <literal>Dir::Parts</literal> setting reads in all the config fragments in | |
422 | lexical order from the directory specified. After this is done then the | |
423 | main config file is loaded.</para> | |
424 | ||
425 | <para>Binary programs are pointed to by <literal>Dir::Bin</literal>. <literal>Dir::Bin::Methods</literal> | |
426 | specifies the location of the method handlers and <literal>gzip</literal>, | |
e85b4cd5 | 427 | <literal>bzip2</literal>, <literal>lzma</literal>, |
24f6490f AL |
428 | <literal>dpkg</literal>, <literal>apt-get</literal> <literal>dpkg-source</literal> |
429 | <literal>dpkg-buildpackage</literal> and <literal>apt-cache</literal> specify the location | |
430 | of the respective programs.</para> | |
db2cca11 OS |
431 | |
432 | <para> | |
433 | The configuration item <literal>RootDir</literal> has a special | |
434 | meaning. If set, all paths in <literal>Dir::</literal> will be | |
435 | relative to <literal>RootDir</literal>, <emphasis>even paths that | |
436 | are specified absolutely</emphasis>. So, for instance, if | |
437 | <literal>RootDir</literal> is set to | |
438 | <filename>/tmp/staging</filename> and | |
439 | <literal>Dir::State::status</literal> is set to | |
440 | <filename>/var/lib/dpkg/status</filename>, then the status file | |
441 | will be looked up in | |
442 | <filename>/tmp/staging/var/lib/dpkg/status</filename>. | |
443 | </para> | |
24f6490f AL |
444 | </refsect1> |
445 | ||
446 | <refsect1><title>APT in DSelect</title> | |
447 | <para> | |
448 | When APT is used as a &dselect; method several configuration directives | |
449 | control the default behaviour. These are in the <literal>DSelect</literal> section.</para> | |
450 | ||
451 | <variablelist> | |
452 | <varlistentry><term>Clean</term> | |
453 | <listitem><para>Cache Clean mode; this value may be one of always, prompt, auto, | |
454 | pre-auto and never. always and prompt will remove all packages from | |
455 | the cache after upgrading, prompt (the default) does so conditionally. | |
456 | auto removes only those packages which are no longer downloadable | |
457 | (replaced with a new version for instance). pre-auto performs this | |
458 | action before downloading new packages.</para></listitem> | |
459 | </varlistentry> | |
460 | ||
461 | <varlistentry><term>options</term> | |
462 | <listitem><para>The contents of this variable is passed to &apt-get; as command line | |
463 | options when it is run for the install phase.</para></listitem> | |
464 | </varlistentry> | |
465 | ||
466 | <varlistentry><term>Updateoptions</term> | |
467 | <listitem><para>The contents of this variable is passed to &apt-get; as command line | |
468 | options when it is run for the update phase.</para></listitem> | |
469 | </varlistentry> | |
470 | ||
471 | <varlistentry><term>PromptAfterUpdate</term> | |
472 | <listitem><para>If true the [U]pdate operation in &dselect; will always prompt to continue. | |
473 | The default is to prompt only on error.</para></listitem> | |
474 | </varlistentry> | |
475 | </variablelist> | |
476 | </refsect1> | |
477 | ||
478 | <refsect1><title>How APT calls dpkg</title> | |
479 | <para>Several configuration directives control how APT invokes &dpkg;. These are | |
480 | in the <literal>DPkg</literal> section.</para> | |
481 | ||
482 | <variablelist> | |
483 | <varlistentry><term>options</term> | |
484 | <listitem><para>This is a list of options to pass to dpkg. The options must be specified | |
485 | using the list notation and each list item is passed as a single argument | |
486 | to &dpkg;.</para></listitem> | |
487 | </varlistentry> | |
488 | ||
489 | <varlistentry><term>Pre-Invoke</term><term>Post-Invoke</term> | |
490 | <listitem><para>This is a list of shell commands to run before/after invoking &dpkg;. | |
491 | Like <literal>options</literal> this must be specified in list notation. The | |
492 | commands are invoked in order using <filename>/bin/sh</filename>, should any | |
493 | fail APT will abort.</para></listitem> | |
494 | </varlistentry> | |
495 | ||
496 | <varlistentry><term>Pre-Install-Pkgs</term> | |
497 | <listitem><para>This is a list of shell commands to run before invoking dpkg. Like | |
498 | <literal>options</literal> this must be specified in list notation. The commands | |
499 | are invoked in order using <filename>/bin/sh</filename>, should any fail APT | |
500 | will abort. APT will pass to the commands on standard input the | |
501 | filenames of all .deb files it is going to install, one per line.</para> | |
502 | ||
503 | <para>Version 2 of this protocol dumps more information, including the | |
504 | protocol version, the APT configuration space and the packages, files | |
505 | and versions being changed. Version 2 is enabled by setting | |
506 | <literal>DPkg::Tools::options::cmd::Version</literal> to 2. <literal>cmd</literal> is a | |
507 | command given to <literal>Pre-Install-Pkgs</literal>.</para></listitem> | |
508 | </varlistentry> | |
509 | ||
510 | <varlistentry><term>Run-Directory</term> | |
511 | <listitem><para>APT chdirs to this directory before invoking dpkg, the default is | |
512 | <filename>/</filename>.</para></listitem> | |
513 | </varlistentry> | |
514 | ||
515 | <varlistentry><term>Build-options</term> | |
516 | <listitem><para>These options are passed to &dpkg-buildpackage; when compiling packages, | |
517 | the default is to disable signing and produce all binaries.</para></listitem> | |
518 | </varlistentry> | |
519 | </variablelist> | |
3e9c4f70 | 520 | |
5e312de7 | 521 | <refsect2><title>dpkg trigger usage (and related options)</title> |
3e9c4f70 DK |
522 | <para>APT can call dpkg in a way so it can make aggressive use of triggers over |
523 | multiply calls of dpkg. Without further options dpkg will use triggers only in between his | |
5e312de7 | 524 | own run. Activating these options can therefore decrease the time needed to perform the |
3e9c4f70 | 525 | install / upgrade. Note that it is intended to activate these options per default in the |
a9564741 | 526 | future, but as it changes the way APT calling dpkg drastically it needs a lot more testing. |
3e9c4f70 DK |
527 | <emphasis>These options are therefore currently experimental and should not be used in |
528 | productive environments.</emphasis> Also it breaks the progress reporting so all frontends will | |
529 | currently stay around half (or more) of the time in the 100% state while it actually configures | |
530 | all packages.</para> | |
a9564741 | 531 | <para>Note that it is not guaranteed that APT will support these options or that these options will |
5e312de7 DK |
532 | not cause (big) trouble in the future. If you have understand the current risks and problems with |
533 | these options, but are brave enough to help testing them create a new configuration file and test a | |
534 | combination of options. Please report any bugs, problems and improvements you encounter and make sure | |
535 | to note which options you have used in your reports. Asking dpkg for help could also be useful for | |
536 | debugging proposes, see e.g. <command>dpkg --audit</command>. A defensive option combination would be | |
3e9c4f70 | 537 | <literallayout>DPkg::NoTriggers "true"; |
5e312de7 DK |
538 | PackageManager::Configure "smart"; |
539 | DPkg::ConfigurePending "true"; | |
d5081aee | 540 | DPkg::TriggersPending "true";</literallayout></para> |
3e9c4f70 DK |
541 | |
542 | <variablelist> | |
5e312de7 | 543 | <varlistentry><term>DPkg::NoTriggers</term> |
5f4331c4 | 544 | <listitem><para>Add the no triggers flag to all dpkg calls (except the ConfigurePending call). |
3e9c4f70 | 545 | See &dpkg; if you are interested in what this actually means. In short: dpkg will not run the |
5f4331c4 | 546 | triggers when this flag is present unless it is explicitly called to do so in an extra call. |
3e9c4f70 DK |
547 | Note that this option exists (undocumented) also in older apt versions with a slightly different |
548 | meaning: Previously these option only append --no-triggers to the configure calls to dpkg - | |
549 | now apt will add these flag also to the unpack and remove calls.</para></listitem> | |
550 | </varlistentry> | |
5e312de7 DK |
551 | <varlistentry><term>PackageManager::Configure</term> |
552 | <listitem><para>Valid values are "<literal>all</literal>", "<literal>smart</literal>" and "<literal>no</literal>". | |
553 | "<literal>all</literal>" is the default value and causes APT to configure all packages explicit. | |
554 | The "<literal>smart</literal>" way is it to configure only packages which need to be configured before | |
555 | another package can be unpacked (Pre-Depends) and let the rest configure by dpkg with a call generated | |
556 | by the next option. "<literal>no</literal>" on the other hand will not configure anything and totally | |
5f4331c4 DK |
557 | rely on dpkg for configuration (which will at the moment fail if a Pre-Depends is encountered). |
558 | Setting this option to another than the all value will implicitly activate also the next option per | |
3e9c4f70 DK |
559 | default as otherwise the system could end in an unconfigured status which could be unbootable! |
560 | </para></listitem> | |
561 | </varlistentry> | |
5e312de7 | 562 | <varlistentry><term>DPkg::ConfigurePending</term> |
3e9c4f70 DK |
563 | <listitem><para>If this option is set apt will call <command>dpkg --configure --pending</command> |
564 | to let dpkg handle all required configurations and triggers. This option is activated automatic | |
5e312de7 | 565 | per default if the previous option is not set to <literal>all</literal>, but deactivating could be useful |
5f4331c4 | 566 | if you want to run APT multiple times in a row - e.g. in an installer. In these sceneries you could |
3e9c4f70 DK |
567 | deactivate this option in all but the last run.</para></listitem> |
568 | </varlistentry> | |
5e312de7 DK |
569 | <varlistentry><term>DPkg::TriggersPending</term> |
570 | <listitem><para>Useful for <literal>smart</literal> configuration as a package which has pending | |
571 | triggers is not considered as <literal>installed</literal> and dpkg treats them as <literal>unpacked</literal> | |
572 | currently which is a dealbreaker for Pre-Dependencies (see debbugs #526774). Note that this will | |
573 | process all triggers, not only the triggers needed to configure this package.</para></listitem> | |
574 | </varlistentry> | |
5e312de7 DK |
575 | <varlistentry><term>PackageManager::UnpackAll</term> |
576 | <listitem><para>As the configuration can be deferred to be done at the end by dpkg it can be | |
577 | tried to order the unpack series only by critical needs, e.g. by Pre-Depends. Default is true | |
a9564741 | 578 | and therefore the "old" method of ordering in various steps by everything. While both method |
5e312de7 DK |
579 | were present in earlier APT versions the <literal>OrderCritical</literal> method was unused, so |
580 | this method is very experimental and needs further improvements before becoming really useful. | |
581 | </para></listitem> | |
582 | </varlistentry> | |
583 | <varlistentry><term>OrderList::Score::Immediate</term> | |
584 | <listitem><para>Essential packages (and there dependencies) should be configured immediately | |
585 | after unpacking. It will be a good idea to do this quite early in the upgrade process as these | |
586 | these configure calls require currently also <literal>DPkg::TriggersPending</literal> which | |
587 | will run quite a few triggers (which maybe not needed). Essentials get per default a high score | |
a9564741 | 588 | but the immediate flag is relatively low (a package which has a Pre-Depends is higher rated). |
5e312de7 DK |
589 | These option and the others in the same group can be used to change the scoring. The following |
590 | example shows the settings with there default values. | |
591 | <literallayout>OrderList::Score { | |
592 | Delete 500; | |
593 | Essential 200; | |
594 | Immediate 10; | |
595 | PreDepends 50; | |
596 | };</literallayout> | |
597 | </para></listitem> | |
598 | </varlistentry> | |
3e9c4f70 DK |
599 | </variablelist> |
600 | </refsect2> | |
24f6490f AL |
601 | </refsect1> |
602 | ||
0224daf2 EL |
603 | <refsect1> |
604 | <title>Periodic and Archives options</title> | |
605 | <para><literal>APT::Periodic</literal> and <literal>APT::Archives</literal> | |
606 | groups of options configure behavior of apt periodic updates, which is | |
607 | done by <literal>/etc/cron.daily/apt</literal> script. See header of | |
608 | this script for the brief documentation of these options. | |
609 | </para> | |
610 | </refsect1> | |
611 | ||
be1b8568 EL |
612 | <refsect1> |
613 | <title>Debug options</title> | |
614 | <para> | |
615 | Enabling options in the <literal>Debug::</literal> section will | |
616 | cause debugging information to be sent to the standard error | |
617 | stream of the program utilizing the <literal>apt</literal> | |
618 | libraries, or enable special program modes that are primarily | |
619 | useful for debugging the behavior of <literal>apt</literal>. | |
620 | Most of these options are not interesting to a normal user, but a | |
621 | few may be: | |
622 | ||
623 | <itemizedlist> | |
624 | <listitem> | |
625 | <para> | |
626 | <literal>Debug::pkgProblemResolver</literal> enables output | |
627 | about the decisions made by | |
628 | <literal>dist-upgrade, upgrade, install, remove, purge</literal>. | |
629 | </para> | |
630 | </listitem> | |
631 | ||
632 | <listitem> | |
633 | <para> | |
634 | <literal>Debug::NoLocking</literal> disables all file | |
635 | locking. This can be used to run some operations (for | |
636 | instance, <literal>apt-get -s install</literal>) as a | |
637 | non-root user. | |
638 | </para> | |
639 | </listitem> | |
640 | ||
641 | <listitem> | |
642 | <para> | |
643 | <literal>Debug::pkgDPkgPM</literal> prints out the actual | |
644 | command line each time that <literal>apt</literal> invokes | |
645 | &dpkg;. | |
646 | </para> | |
647 | </listitem> | |
648 | ||
649 | <listitem> | |
650 | <para> | |
651 | <literal>Debug::IdentCdrom</literal> disables the inclusion | |
652 | of statfs data in CDROM IDs. <!-- TODO: provide a | |
653 | motivating example, except I haven't a clue why you'd want | |
654 | to do this. --> | |
655 | </para> | |
656 | </listitem> | |
657 | </itemizedlist> | |
8a3642bd | 658 | </para> |
be1b8568 EL |
659 | |
660 | <para> | |
661 | A full list of debugging options to apt follows. | |
662 | </para> | |
663 | ||
664 | <variablelist> | |
665 | <varlistentry> | |
666 | <term><literal>Debug::Acquire::cdrom</literal></term> | |
667 | ||
668 | <listitem> | |
669 | <para> | |
670 | Print information related to accessing | |
671 | <literal>cdrom://</literal> sources. | |
672 | </para> | |
673 | </listitem> | |
674 | </varlistentry> | |
675 | ||
676 | <varlistentry> | |
677 | <term><literal>Debug::Acquire::ftp</literal></term> | |
678 | ||
679 | <listitem> | |
680 | <para> | |
681 | Print information related to downloading packages using | |
682 | FTP. | |
683 | </para> | |
684 | </listitem> | |
685 | </varlistentry> | |
686 | ||
687 | <varlistentry> | |
688 | <term><literal>Debug::Acquire::http</literal></term> | |
689 | ||
690 | <listitem> | |
691 | <para> | |
692 | Print information related to downloading packages using | |
693 | HTTP. | |
694 | </para> | |
695 | </listitem> | |
696 | </varlistentry> | |
697 | ||
698 | <varlistentry> | |
699 | <term><literal>Debug::Acquire::https</literal></term> | |
700 | ||
701 | <listitem> | |
702 | <para> | |
703 | Print information related to downloading packages using | |
704 | HTTPS. | |
705 | </para> | |
706 | </listitem> | |
707 | </varlistentry> | |
708 | ||
709 | <varlistentry> | |
710 | <term><literal>Debug::Acquire::gpgv</literal></term> | |
711 | ||
712 | <listitem> | |
713 | <para> | |
714 | Print information related to verifying cryptographic | |
715 | signatures using <literal>gpg</literal>. | |
716 | </para> | |
717 | </listitem> | |
718 | </varlistentry> | |
719 | ||
720 | <varlistentry> | |
721 | <term><literal>Debug::aptcdrom</literal></term> | |
722 | ||
723 | <listitem> | |
724 | <para> | |
725 | Output information about the process of accessing | |
726 | collections of packages stored on CD-ROMs. | |
727 | </para> | |
728 | </listitem> | |
729 | </varlistentry> | |
730 | ||
731 | <varlistentry> | |
732 | <term><literal>Debug::BuildDeps</literal></term> | |
733 | <listitem> | |
734 | <para> | |
735 | Describes the process of resolving build-dependencies in | |
736 | &apt-get;. | |
737 | </para> | |
738 | </listitem> | |
739 | </varlistentry> | |
740 | ||
741 | <varlistentry> | |
742 | <term><literal>Debug::Hashes</literal></term> | |
743 | <listitem> | |
744 | <para> | |
745 | Output each cryptographic hash that is generated by the | |
746 | <literal>apt</literal> libraries. | |
747 | </para> | |
748 | </listitem> | |
749 | </varlistentry> | |
750 | ||
751 | <varlistentry> | |
752 | <term><literal>Debug::IdentCDROM</literal></term> | |
753 | <listitem> | |
754 | <para> | |
755 | Do not include information from <literal>statfs</literal>, | |
756 | namely the number of used and free blocks on the CD-ROM | |
757 | filesystem, when generating an ID for a CD-ROM. | |
758 | </para> | |
759 | </listitem> | |
760 | </varlistentry> | |
761 | ||
762 | <varlistentry> | |
763 | <term><literal>Debug::NoLocking</literal></term> | |
764 | <listitem> | |
765 | <para> | |
766 | Disable all file locking. For instance, this will allow | |
767 | two instances of <quote><literal>apt-get | |
768 | update</literal></quote> to run at the same time. | |
769 | </para> | |
770 | </listitem> | |
771 | </varlistentry> | |
772 | ||
773 | <varlistentry> | |
774 | <term><literal>Debug::pkgAcquire</literal></term> | |
775 | ||
776 | <listitem> | |
777 | <para> | |
778 | Log when items are added to or removed from the global | |
779 | download queue. | |
780 | </para> | |
781 | </listitem> | |
782 | </varlistentry> | |
783 | ||
784 | <varlistentry> | |
785 | <term><literal>Debug::pkgAcquire::Auth</literal></term> | |
786 | <listitem> | |
787 | <para> | |
788 | Output status messages and errors related to verifying | |
789 | checksums and cryptographic signatures of downloaded files. | |
790 | </para> | |
791 | </listitem> | |
792 | </varlistentry> | |
793 | ||
794 | <varlistentry> | |
795 | <term><literal>Debug::pkgAcquire::Diffs</literal></term> | |
796 | <listitem> | |
797 | <para> | |
798 | Output information about downloading and applying package | |
799 | index list diffs, and errors relating to package index list | |
800 | diffs. | |
801 | </para> | |
802 | </listitem> | |
803 | </varlistentry> | |
804 | ||
805 | <varlistentry> | |
806 | <term><literal>Debug::pkgAcquire::RRed</literal></term> | |
807 | ||
808 | <listitem> | |
809 | <para> | |
810 | Output information related to patching apt package lists | |
811 | when downloading index diffs instead of full indices. | |
812 | </para> | |
813 | </listitem> | |
814 | </varlistentry> | |
815 | ||
816 | <varlistentry> | |
817 | <term><literal>Debug::pkgAcquire::Worker</literal></term> | |
818 | ||
819 | <listitem> | |
820 | <para> | |
821 | Log all interactions with the sub-processes that actually | |
822 | perform downloads. | |
823 | </para> | |
824 | </listitem> | |
825 | </varlistentry> | |
826 | ||
827 | <varlistentry> | |
828 | <term><literal>Debug::pkgAutoRemove</literal></term> | |
829 | ||
830 | <listitem> | |
831 | <para> | |
832 | Log events related to the automatically-installed status of | |
833 | packages and to the removal of unused packages. | |
834 | </para> | |
835 | </listitem> | |
836 | </varlistentry> | |
837 | ||
838 | <varlistentry> | |
839 | <term><literal>Debug::pkgDepCache::AutoInstall</literal></term> | |
840 | <listitem> | |
841 | <para> | |
842 | Generate debug messages describing which packages are being | |
843 | automatically installed to resolve dependencies. This | |
844 | corresponds to the initial auto-install pass performed in, | |
845 | e.g., <literal>apt-get install</literal>, and not to the | |
846 | full <literal>apt</literal> dependency resolver; see | |
847 | <literal>Debug::pkgProblemResolver</literal> for that. | |
848 | </para> | |
849 | </listitem> | |
850 | </varlistentry> | |
851 | ||
af29ffb4 MV |
852 | <varlistentry> |
853 | <term><literal>Debug::pkgDepCache::Marker</literal></term> | |
854 | <listitem> | |
855 | <para> | |
856 | Generate debug messages describing which package is marked | |
857 | as keep/install/remove while the ProblemResolver does his work. | |
858 | Each addition or deletion may trigger additional actions; | |
859 | they are shown indented two additional space under the original entry. | |
860 | The format for each line is <literal>MarkKeep</literal>, | |
861 | <literal>MarkDelete</literal> or <literal>MarkInstall</literal> followed by | |
862 | <literal>package-name <a.b.c -> d.e.f | x.y.z> (section)</literal> | |
863 | where <literal>a.b.c</literal> is the current version of the package, | |
864 | <literal>d.e.f</literal> is the version considered for installation and | |
865 | <literal>x.y.z</literal> is a newer version, but not considered for installation | |
866 | (because of a low pin score). The later two can be omitted if there is none or if | |
867 | it is the same version as the installed. | |
868 | <literal>section</literal> is the name of the section the package appears in. | |
869 | </para> | |
870 | </listitem> | |
871 | </varlistentry> | |
872 | ||
be1b8568 EL |
873 | <!-- Question: why doesn't this do anything? The code says it should. --> |
874 | <varlistentry> | |
875 | <term><literal>Debug::pkgInitConfig</literal></term> | |
876 | <listitem> | |
877 | <para> | |
d82cdf73 | 878 | Dump the default configuration to standard error on |
be1b8568 EL |
879 | startup. |
880 | </para> | |
881 | </listitem> | |
882 | </varlistentry> | |
883 | ||
884 | <varlistentry> | |
885 | <term><literal>Debug::pkgDPkgPM</literal></term> | |
886 | <listitem> | |
887 | <para> | |
888 | When invoking &dpkg;, output the precise command line with | |
889 | which it is being invoked, with arguments separated by a | |
890 | single space character. | |
891 | </para> | |
892 | </listitem> | |
893 | </varlistentry> | |
894 | ||
895 | <varlistentry> | |
896 | <term><literal>Debug::pkgDPkgProgressReporting</literal></term> | |
897 | <listitem> | |
898 | <para> | |
899 | Output all the data received from &dpkg; on the status file | |
900 | descriptor and any errors encountered while parsing it. | |
901 | </para> | |
902 | </listitem> | |
903 | </varlistentry> | |
904 | ||
905 | <varlistentry> | |
906 | <term><literal>Debug::pkgOrderList</literal></term> | |
907 | ||
908 | <listitem> | |
909 | <para> | |
910 | Generate a trace of the algorithm that decides the order in | |
911 | which <literal>apt</literal> should pass packages to | |
912 | &dpkg;. | |
913 | </para> | |
914 | </listitem> | |
915 | </varlistentry> | |
916 | ||
917 | <varlistentry> | |
918 | <term><literal>Debug::pkgPackageManager</literal></term> | |
919 | ||
920 | <listitem> | |
921 | <para> | |
922 | Output status messages tracing the steps performed when | |
923 | invoking &dpkg;. | |
924 | </para> | |
925 | </listitem> | |
926 | </varlistentry> | |
927 | ||
928 | <varlistentry> | |
929 | <term><literal>Debug::pkgPolicy</literal></term> | |
930 | ||
931 | <listitem> | |
932 | <para> | |
933 | Output the priority of each package list on startup. | |
934 | </para> | |
935 | </listitem> | |
936 | </varlistentry> | |
937 | ||
938 | <varlistentry> | |
939 | <term><literal>Debug::pkgProblemResolver</literal></term> | |
940 | ||
941 | <listitem> | |
942 | <para> | |
943 | Trace the execution of the dependency resolver (this | |
944 | applies only to what happens when a complex dependency | |
945 | problem is encountered). | |
946 | </para> | |
947 | </listitem> | |
948 | </varlistentry> | |
949 | ||
8b4894fe MV |
950 | <varlistentry> |
951 | <term><literal>Debug::pkgProblemResolver::ShowScores</literal></term> | |
952 | <listitem> | |
953 | <para> | |
954 | Display a list of all installed packages with their calculated score | |
955 | used by the pkgProblemResolver. The description of the package | |
956 | is the same as described in <literal>Debug::pkgDepCache::Marker</literal> | |
957 | </para> | |
958 | </listitem> | |
959 | </varlistentry> | |
960 | ||
be1b8568 EL |
961 | <varlistentry> |
962 | <term><literal>Debug::sourceList</literal></term> | |
963 | ||
964 | <listitem> | |
965 | <para> | |
966 | Print information about the vendors read from | |
967 | <filename>/etc/apt/vendors.list</filename>. | |
968 | </para> | |
969 | </listitem> | |
970 | </varlistentry> | |
971 | ||
d82cdf73 MV |
972 | <!-- 2009/07/11 Currently used nowhere. The corresponding code |
973 | is commented. | |
be1b8568 EL |
974 | <varlistentry> |
975 | <term><literal>Debug::Vendor</literal></term> | |
976 | ||
977 | <listitem> | |
978 | <para> | |
979 | Print information about each vendor. | |
980 | </para> | |
981 | </listitem> | |
982 | </varlistentry> | |
d82cdf73 | 983 | --> |
be1b8568 | 984 | </variablelist> |
24f6490f AL |
985 | </refsect1> |
986 | ||
987 | <refsect1><title>Examples</title> | |
640c5d94 MZ |
988 | <para>&configureindex; is a |
989 | configuration file showing example values for all possible | |
24f6490f AL |
990 | options.</para> |
991 | </refsect1> | |
992 | ||
993 | <refsect1><title>Files</title> | |
6e2525a1 | 994 | <variablelist> |
1221c3a3 | 995 | &file-aptconf; |
6e2525a1 | 996 | </variablelist> |
24f6490f AL |
997 | </refsect1> |
998 | ||
999 | <refsect1><title>See Also</title> | |
1000 | <para>&apt-cache;, &apt-config;<!-- ? reading apt.conf -->, &apt-preferences;.</para> | |
1001 | </refsect1> | |
1002 | ||
1003 | &manbugs; | |
24f6490f AL |
1004 | |
1005 | </refentry> | |
1006 |