Reporting bugs in Debian
Note: this page is not maintained by reportbug maintainers, so the information in here might be outdated or no longer correct.
reportbug is a tool designed to make the reporting of bugs in Debian and derived distributions relatively painless. Its features include:
- Access to outstanding bug reports to make it easier to identify whether problems have already been reported.
- Automatic checking for newer versions of packages.
- Optional automatic verification of integrity of packages via debsums.
- Support for following-up on outstanding reports.
- Integration with the mutt, af, and mh/nmh e-mail readers.
- Optional PGP/GnuPG integration.
This package provides access to the Debian Bug Tracking System, which can be used for both reporting and researching bugs, by a number of interfaces, including email, web, and command-line utilities.
- To report a bug: 'reportbug packagename'
- To view bugs for a package: 'querybts packagename'
apt-get install reportbug
reportbug is designed to be used on systems with an installed mail transport agent, like exim or sendmail; however, you can edit the configuration file and send reports using any available mail server.
If your system's users use locales with character sets other than UTF-8 and ISO-8859-*, one of either python2.3-cjkcodecs or python2.3-iconvcodec is required for proper operation. For Asian locales, the use of python2.3-cjkcodecs is preferred over the more limited python2.3-iconvcodec.
Debian FAQ : 11.5 How do I report a bug in Debian ?
debian BTS interface :
How to report a bug in Debian : mostly tell how to do things without reportbug.
Also available in : /usr/share/doc/debian/bug-reporting.txt
How to Report Bugs Effectively : generic recommendations for bug reporter
the reportbug project page
an example of the "formal letter" send to some of our Xfree users
Using GMail's SMTP Server
It is sometimes easier to configure reportbug to use GMail to send bug reports rather than the existing sendmail program installed by default in Debian. The following outlines the steps to accomplish this:
- Run 'reportbug --configure' as your normal user. This creates a ~/.reportbugrc file that stores all the configurations.
Follow the instructions and when asked "Do you have a 'mail transport agent' (MTA) configured", choose 'No'.
- Then enter the SMTP host for gmail: 'smtp.gmail.com:587'
For the user name enter: '<username>@gmail.com'
For the question "Does your SMTP host require TLS authentication?", choose 'Yes' (If you are on a release < squeeze, reportbug will not ask this question.)
If you have set up Google's two-factor authentication for your GMail account, you can create an application-specific password to use with reportbug.
Warning: unsupported locale setting
This warning may appear on the screen as reportbug is invoked. The error relates to Locale configuration.
- Workaround : type LANG=C before the command. for example :