apt-listbugs

Langue: en

Version: May 2009 (debian - 07/07/09)

Section: 1 (Commandes utilisateur)

Sommaire

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>] [-B <bugs>] [-D] [-H <hostname>] [-p <port>] <command> [arguments]

OPTIONS

• -h | --help Print usage help and exit
• -v | --version Print version number and exit
• -s <severities> | --severity <severities> Severities you want to see separated by comma, possible values are critical, grave, serious, important, normal, minor and wishlist. Default: [critical,grave,serious] You can specify '--severity all' to specify all severities.
• -T <tags> | --tag <tags> Tags you want to see separated by comma.
• -S <stats> | --stats <stats> Status you want to see separated by comma. Default: [forwarded,done,pending,pending-fixed,] Note that 'pending' does not mean 'tagged pending', but 'still open, pending to be fixed'.
• -B <bug#> | --bugs <bug#> By default, apt-listbugs will consider all bugs. This option adds a restriction to the bug numbers you want to see separated by commas (e.g. 123456,567890,135792). If this option is specified, all other bugs will be ignored.
• -D | --show-downgrade Shows bugs of downgraded packages. (apt mode only)
• -d Give extra debug output, important for debugging problems. Please include -d when reporting problems.
• -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].
• -P | --pin-priority Specifies Pin-Priority value [1000].
• --title Specifies the title of rss output.
• -q | --quiet Don't display progress bar. This option is assumed if stdout is not a terminal.
• -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[/version]> <package2[/version]>...] Reads package names from the arguments and simply lists bugs of these packages. Package versions may be specified with a slash, for example, like apt/1.0
• 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 <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 <frx@firenze.linux.it> in 2008.

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)