debian man page for apt-listbugs

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
	      o -h, --help Print usage help and exit.

	      o -v, --version Print version number and exit.

	      o  -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.

	      o -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.

	      o -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,pend-
	      ing-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".

	      o  -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.

	      o -D, --show-downgrade Show bugs of downgraded packages. (apt mode only)

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

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

	      o -P <priority>, --pin-priority <priority> Specifies Pin-Priority value [1000].

	      o -E <title>, --title <title> Specifies the title of RSS output.

	      o -q, --quiet Don't display progress bar. This option is assumed if stdout is not a terminal or if /dev/tty cannot be opened.

	      o -C <apt.conf>, --aptconf <apt.conf> Specifies the apt configuration file to use.

	      o -y, --force-yes Assumes that you select yes for all questions.

	      o -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.

	      o -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  spe-
	      cial 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						   apt-listbugs(1)