apt-listbugs(1) apt-listbugs(1)

NAME
apt-listbugs - Lists critical bugs before each apt upgrade/installation

SYNOPSIS
apt-listbugs [options] <command> [arguments]

DESCRIPTION
apt-listbugs is a tool which retrieves bug reports from the Debian Bug Tracking System and lists them. Especially, it is intended to be invoked
before each upgrade by apt in order to check whether the upgrade/installation is safe.

USAGE
apt-listbugs [-h] [-s <severities>] [-S <stats>] [-l] [-g] [-D] [-H <hostname>] [-p <port>] [-R] [-f] [-c <dir>] [-t <minutes>] <command> [argu-
ments]

OPTIONS
· -h | --help Print usage help and exit

· -s <severities> | --severity <severities> Severities you want to see separeted by comma, possible values are critical, grave, serious,
important, normal, minor and wishlist. [critical,grave,serious]

· -T <tags> | --tag <tags> Tags you want to see separeted by comma.

· -S <stats> | --stats <stats> Status you want to see separated by comma [forwarded,done,pending,]

· -D | --show-downgrade Shows bugs of downgraded packages.

· -H <hostname> | --hostname <hostname> Specifies the hostname of Debian Bug Tracking System [bugs.debian.org].

· -p <port> | --port <port> Specifies the port number of the web interface of Debian Bug Tracking System [80].

· -X | --indexdir Specifies indexdir [/indices/].

· -P | --pin-priority Specifies Pin-Priority value [1000].

· --title Specifies the title of rss output.

· -f | --force-download Ignores the stored local cache and retrieve fresh bugs.

· -q | --quiet Don't display progress bar. This option is assumed if stdout is not a terminal.

· -c <cache_dir> | --cache-dir <cache_dir> Specifies the directory of the local cache [/var/cache/apt-listbugs/].

· -t <minutes> | --timer <minutes> Specifies the expire timer of the cache [60].

· -C <apt.conf> | --aptconf <apt.conf> Specifies the apt configuration file to use.

· -y | --force-yes Assumes that you select yes for all questions.

· -n | --force-no Assumes that you select no for all questions. This option is assumed if stdout is not a terminal.

COMMANDS
· apt Reads filenames from standard input (typically provided by apt).

· list [<package1> <package2>...] Reads package names from the arguments and simply lists bugs of these packages.

· rss [<package1> <package2>...] Reads package names from the arguments and lists bugs of these packages in rss format.
ENVIRONMENT VARIABLES
· APT_LISTBUGS_FRONTEND If this variable is set to "none" apt-listbugs will not execute at all, this might be useful if you would like to
script the use of a program that calls apt-listbugs.

· http_proxy, soap_use_proxy=on If HTTP_PROXY is set and SOAP_USE_PROXY is set, the value is used for HTTP Proxy. The default is to use
the same value set for apt.

CONFIGURATION FILE
apt-listbugs understands APT configuration file (see apt.conf). The notable configuration options are

· Acquire::HTTP::Proxy The default HTTP Proxy setting. Special keyword 'DIRECT' will disable proxy configuration.

· Acquire::HTTP::Proxy::bugs.debian.org HTTP Proxy setting, overrides the default HTTP Proxy setting. Useful for setting HTTP proxy for
apt-listbugs.

OUTPUT EXAMPLE
[bug severity] bugs of [package] ([current version] -> [package version to be installed]) <[status of bug report]>
[bug #] - [bug title] [(Fixed: fixed version, if it's fixed in a future version)]

e.g.

Reading package fields... Done
Reading package status... Done
Retrieving bug reports... Done
Parsing Found/Fixed information... Done
important bugs of apt-listbugs (0.0.57 -> ) <pending>
#332442 - apt-listbugs: Apt-listbugs doesn't actually download any bug reports
#389903 - apt-listbugs: Does not offer to exit if timeout occurs fetching reports
Summary:
apt-listbugs(2 bugs)

EXIT CODE
· 0 Success

· 1 When something is wrong.

· 10 To warn APT not to proceed.

BUGS
Note that apt-listbugs can't probe all the critical bug reports that really applies to the package of the version. This means that some bugs are
listed because of a conservative reason even if the bugs don't actually apply to the version. You need to review the bug.

AUTHORS
apt-listbugs was originally written by Masato Taruishi <[email protected]>, and rewritten by Junichi Uekawa <[email protected]> in 2006 to handle
BTS Versioning features and the new SOAP interface.

Latest source-code is available from http://git.debian.org/?p=apt-listbugs/apt-listbugs.git