Scroll to navigation

apt-listbugs(1) General Commands Manual 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. In particular, it is intended to be invoked before each upgrade by apt, or other similar package managers, in order to check whether the upgrade/installation is safe.

USAGE

apt-listbugs [-h] [-v] [-s <severities>] [-T <tags>] [-S <states>] [-B <bug#>] [-D] [-H <hostname>] [-p <port>] [-P <priority>] [-E <title>] [-q] [-C <apt.conf>] [-y] [-n] [-d] <command> [arguments]

OPTIONS

• -h, --help Print usage help and exit.
• -v, --version Print version number and exit.
• -s <severities>, --severity <severities> Filter bugs by severity, showing only the bugs matching a specified value. List the bug severities that you want to see, separated by commas. Default: [critical,grave,serious]. Possible values are "critical", "grave", "serious", "important", "normal", "minor", "wishlist", or the special value "all" to disable filtering.
• -T <tags>, --tag <tags> Filter bugs by tags, showing only the bugs matching _all_ specified values. List the tags that you want to see, separated by commas. Default: no filter. Possible values include "confirmed,l10n" to show only bugs that have both these tags.
• -S <states>, --stats <states> Filter (and sort) bugs by pending-state, showing only the bugs matching specified values. List the pending-state categories that you want to see, separated by commas and in the desired order. Default: [forwarded,done,pending,pending-fixed]. Possible values are: 
    pending = open bug
    forwarded = marked as "forwarded"
    pending-fixed = tagged as "pending"
    fixed = tagged as "fixed"
    absent = not found in this distribution/architecture
    done = resolved in some version for this
           distribution/architecture
Note that a bug can only match one such state (when multiple conditions on this list match, the later one takes priority), and that "pending" does not mean "tagged as pending".
• -B <bug#>, --bugs <bug#> Filter bugs by number, showing only the bugs directly specified. List the bug numbers that you want to see, separated by commas (e.g. "123456,567890,135792"). Default: no filter.
• -D, --show-downgrade Show bugs of downgraded packages. (apt mode only)
• -H <hostname>, --hostname <hostname> Specifies the hostname of the Debian Bug Tracking System [bugs.debian.org].
• -p <port>, --port <port> Specifies the port number of the web interface of the Debian Bug Tracking System [80].
• -P <priority>, --pin-priority <priority> Specifies Pin-Priority value [1000].
• -E <title>, --title <title> Specifies the title of RSS output.
• -q, --quiet Don't display progress bar. This option is assumed if stdout is not a terminal or if /dev/tty cannot be opened.
• -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 or if /dev/tty cannot be opened.
• -d, --debug Give extra debug output, important for debugging problems. Please include -d when reporting problems.

COMMANDS


apt
Reads package actions from standard input (typically provided by apt or other compatible package manager; Pre-Install-Pkgs hook info protocol version 2 is expected - see apt.conf(5) for more details).

list [<package1[/version]> <package2[/version]>...]
Reads package names from the arguments and simply lists bugs of these packages. Package versions may be specified with a slash, as in apt/1.0 for example.

rss [<package1[/version]> <package2[/version]>...]
Reads package names from the arguments and lists bugs of these packages in RSS format. Again, package versions may be specified with a slash.

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
If http_proxy is set, the value is used for HTTP Proxy, unless proxy settings are found in APT configuration (see below).

CONFIGURATION FILE

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

Acquire::HTTP::Proxy
Default HTTP Proxy setting (overrides any http_proxy environment variable value). An empty string or the special keyword 'DIRECT' will disable proxy.

Acquire::HTTP::Proxy::bugs.debian.org
Specific HTTP Proxy setting (overrides the default HTTP Proxy setting). Useful for setting HTTP proxy for apt-listbugs. The special keyword 'DIRECT' will disable proxy.

AptListbugs::IgnoreRegexp
Bugs to ignore when in apt mode. I would suggest setting this to "FTBFS" since those bugs tend to not affect the user, but this defaults to nothing. This will be evaluated using Ruby regular expressions.

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.
    
    
    Retrieving bug reports... Done
    Parsing Found/Fixed information... Done
    important bugs of apt-listbugs (0.0.47 -> 0.0.49) <unfixed>
     #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.

130
When a SIGINT was received (for instance because the user pressed [Ctrl+C]).

AUTHORS

apt-listbugs was originally written by Masato Taruishi <taru@debian.org>, and rewritten by Junichi Uekawa <dancer@debian.org> in 2006 to handle BTS Versioning features and the SOAP interface. The --bugs option was added by Francesco Poli <invernomuto@paranoici.org> in 2008. During 2009-2010, apt-listbugs was maintained by Francesco Poli and Ryan Niebur <ryan@debian.org>. It is currently maintained by Francesco Poli and Thomas Mueller <thomas.mueller@tmit.eu>.
Latest source-code is available from http://git.debian.org/?p=apt-listbugs/apt-listbugs.git

SEE ALSO

apt.conf(5), sensible-browser(1), www-browser(1), querybts(1)
 
December 2013