|
|
|
@ -12,10 +12,16 @@ |
|
|
|
<refentryinfo> |
|
|
|
&apt-author.jgunthorpe; |
|
|
|
&apt-author.team; |
|
|
|
<author> |
|
|
|
<firstname>Daniel</firstname> |
|
|
|
<surname>Burrows</surname> |
|
|
|
<contrib>Initial documentation of Debug::*.</contrib> |
|
|
|
<email>dburrows@debian.org</email> |
|
|
|
</author> |
|
|
|
&apt-email; |
|
|
|
&apt-product; |
|
|
|
<!-- The last update date --> |
|
|
|
<date>29 February 2004</date> |
|
|
|
<date>06 December 2008</date> |
|
|
|
</refentryinfo> |
|
|
|
|
|
|
|
<refmeta> |
|
|
|
@ -423,16 +429,344 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";}; |
|
|
|
</variablelist> |
|
|
|
</refsect1> |
|
|
|
|
|
|
|
<refsect1><title>Debug options</title> |
|
|
|
<para>Most of the options in the <literal>debug</literal> section are not interesting to |
|
|
|
the normal user, however <literal>Debug::pkgProblemResolver</literal> shows |
|
|
|
interesting output about the decisions dist-upgrade makes. |
|
|
|
<literal>Debug::NoLocking</literal> disables file locking so APT can do some |
|
|
|
operations as non-root and <literal>Debug::pkgDPkgPM</literal> will print out the |
|
|
|
command line for each dpkg invokation. <literal>Debug::IdentCdrom</literal> will |
|
|
|
disable the inclusion of statfs data in CDROM IDs. |
|
|
|
<literal>Debug::Acquire::gpgv</literal> Debugging of the gpgv method. |
|
|
|
<refsect1> |
|
|
|
<title>Debug options</title> |
|
|
|
<para> |
|
|
|
Enabling options in the <literal>Debug::</literal> section will |
|
|
|
cause debugging information to be sent to the standard error |
|
|
|
stream of the program utilizing the <literal>apt</literal> |
|
|
|
libraries, or enable special program modes that are primarily |
|
|
|
useful for debugging the behavior of <literal>apt</literal>. |
|
|
|
Most of these options are not interesting to a normal user, but a |
|
|
|
few may be: |
|
|
|
|
|
|
|
<itemizedlist> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
<literal>Debug::pkgProblemResolver</literal> enables output |
|
|
|
about the decisions made by |
|
|
|
<literal>dist-upgrade, upgrade, install, remove, purge</literal>. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
<literal>Debug::NoLocking</literal> disables all file |
|
|
|
locking. This can be used to run some operations (for |
|
|
|
instance, <literal>apt-get -s install</literal>) as a |
|
|
|
non-root user. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
<literal>Debug::pkgDPkgPM</literal> prints out the actual |
|
|
|
command line each time that <literal>apt</literal> invokes |
|
|
|
&dpkg;. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
<literal>Debug::IdentCdrom</literal> disables the inclusion |
|
|
|
of statfs data in CDROM IDs. <!-- TODO: provide a |
|
|
|
motivating example, except I haven't a clue why you'd want |
|
|
|
to do this. --> |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</itemizedlist> |
|
|
|
</para> |
|
|
|
|
|
|
|
<para> |
|
|
|
A full list of debugging options to apt follows. |
|
|
|
</para> |
|
|
|
|
|
|
|
<variablelist> |
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::Acquire::cdrom</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Print information related to accessing |
|
|
|
<literal>cdrom://</literal> sources. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::Acquire::ftp</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Print information related to downloading packages using |
|
|
|
FTP. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::Acquire::http</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Print information related to downloading packages using |
|
|
|
HTTP. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::Acquire::https</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Print information related to downloading packages using |
|
|
|
HTTPS. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::Acquire::gpgv</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Print information related to verifying cryptographic |
|
|
|
signatures using <literal>gpg</literal>. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::aptcdrom</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Output information about the process of accessing |
|
|
|
collections of packages stored on CD-ROMs. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::BuildDeps</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Describes the process of resolving build-dependencies in |
|
|
|
&apt-get;. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::Hashes</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Output each cryptographic hash that is generated by the |
|
|
|
<literal>apt</literal> libraries. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::IdentCDROM</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Do not include information from <literal>statfs</literal>, |
|
|
|
namely the number of used and free blocks on the CD-ROM |
|
|
|
filesystem, when generating an ID for a CD-ROM. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::NoLocking</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Disable all file locking. For instance, this will allow |
|
|
|
two instances of <quote><literal>apt-get |
|
|
|
update</literal></quote> to run at the same time. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgAcquire</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Log when items are added to or removed from the global |
|
|
|
download queue. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgAcquire::Auth</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Output status messages and errors related to verifying |
|
|
|
checksums and cryptographic signatures of downloaded files. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgAcquire::Diffs</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Output information about downloading and applying package |
|
|
|
index list diffs, and errors relating to package index list |
|
|
|
diffs. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgAcquire::RRed</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Output information related to patching apt package lists |
|
|
|
when downloading index diffs instead of full indices. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgAcquire::Worker</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Log all interactions with the sub-processes that actually |
|
|
|
perform downloads. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgAutoRemove</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Log events related to the automatically-installed status of |
|
|
|
packages and to the removal of unused packages. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgDepCache::AutoInstall</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Generate debug messages describing which packages are being |
|
|
|
automatically installed to resolve dependencies. This |
|
|
|
corresponds to the initial auto-install pass performed in, |
|
|
|
e.g., <literal>apt-get install</literal>, and not to the |
|
|
|
full <literal>apt</literal> dependency resolver; see |
|
|
|
<literal>Debug::pkgProblemResolver</literal> for that. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<!-- Question: why doesn't this do anything? The code says it should. --> |
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgInitConfig</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Dump the default configuration to standard output on |
|
|
|
startup. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgDPkgPM</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
When invoking &dpkg;, output the precise command line with |
|
|
|
which it is being invoked, with arguments separated by a |
|
|
|
single space character. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgDPkgProgressReporting</literal></term> |
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Output all the data received from &dpkg; on the status file |
|
|
|
descriptor and any errors encountered while parsing it. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgOrderList</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Generate a trace of the algorithm that decides the order in |
|
|
|
which <literal>apt</literal> should pass packages to |
|
|
|
&dpkg;. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgPackageManager</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Output status messages tracing the steps performed when |
|
|
|
invoking &dpkg;. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgPolicy</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Output the priority of each package list on startup. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::pkgProblemResolver</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Trace the execution of the dependency resolver (this |
|
|
|
applies only to what happens when a complex dependency |
|
|
|
problem is encountered). |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::sourceList</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Print information about the vendors read from |
|
|
|
<filename>/etc/apt/vendors.list</filename>. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
|
|
|
|
<varlistentry> |
|
|
|
<term><literal>Debug::Vendor</literal></term> |
|
|
|
|
|
|
|
<listitem> |
|
|
|
<para> |
|
|
|
Print information about each vendor. |
|
|
|
</para> |
|
|
|
</listitem> |
|
|
|
</varlistentry> |
|
|
|
</variablelist> |
|
|
|
</refsect1> |
|
|
|
|
|
|
|
<refsect1><title>Examples</title> |
|
|
|
|
Eugene V. Lyubimkin
14 years ago