Differences between revisions 38 and 39
Revision 38 as of 2019-10-20 13:32:46
Size: 3536
Editor: nodiscc
Comment: generic install instructions
Revision 39 as of 2019-10-20 13:38:03
Size: 2892
Editor: nodiscc
Comment: link back to BTS page, reorder, cleanup TOC, remove info that can be found on the package's page, link MTA, formattiing
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
<<TableOfContents()>>

== Introduction ==

'''DebPkg:reportbug''' is a tool designed to make the reporting of bugs in Debian and derived distributions relatively painless.

'''https://www.debian.org/Bugs/Reporting''' - How to report a bug in Debian using reportbug
'''DebPkg:reportbug''' is a tool designed to make the [[BTS|reporting of bugs in Debian]] and derived distributions relatively painless.
Line 16: Line 10:
reportbug 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.
Line 37: Line 23:
== Configuration ==

=== Using a custom SMTP server ===

reportbug is designed to be used on systems with an installed Mail Transport Agent ([[MTA]]), like exim or sendmail; however, you can edit the configuration file and send reports using any available mail server.

==== GMail ====

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:

 1. Run `reportbug --configure` as your normal user. This creates a `~/.reportbugrc` file that stores all the configurations.
 2. Follow the instructions and when asked `Do you have a 'mail transport agent' (MTA) configured`, choose `No`
 3. Then enter the SMTP host for gmail: `smtp.gmail.com:587`
 4. For the user name enter: `<username>@gmail.com`
 5. For the question `Does your SMTP host require TLS authentication?`, choose `Yes`

If you have set up Google's two-factor authentication for your GMail account, you can create an [[https://support.google.com/accounts/answer/185833?hl=en|application-specific password]] to use with reportbug.

== Troubleshooting ==

'''Warning: unsupported locale setting:''' This error relates to [[Locale]] configuration. To workaround this problem, invoke the program as `LANG=C reportbug`

Line 46: Line 55:

=== Using other SMTP servers ===

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.

==== GMail ====

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:

 1. Run {{{reportbug --configure}}} as your normal user. This creates a ~/.reportbugrc file that stores all the configurations.
 2. Follow the instructions and when asked "''Do you have a 'mail transport agent' (MTA) configured''", choose "''No''".
 3. Then enter the SMTP host for gmail: {{{smtp.gmail.com:587}}}
 4. For the user name enter: {{{<username>@gmail.com'}}}
 5. For the question "''Does your SMTP host require TLS authentication?''", choose "''Yes''"

If you have set up Google's two-factor authentication for your GMail account, you can create an [[https://support.google.com/accounts/answer/185833?hl=en|application-specific password]] to use with reportbug.

== Error Messages ==

=== 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 :
 {{{
LANG=C reportbug
}}}

Translation(s): English - Español - Français - Italiano


reportbug is a tool designed to make the reporting of bugs in Debian and derived distributions relatively painless.

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.

Installation

Install the reportbug package.

Usage

  • Report a bug: reportbug packagename

  • To view bugs for a package: querybts packagename

There is also a robot at control@bugs.debian.org that expects specially-crafted control messages for the bug tracking system.

Configuration

Using a custom SMTP server

reportbug is designed to be used on systems with an installed Mail Transport Agent (MTA), like exim or sendmail; however, you can edit the configuration file and send reports using any available mail server.

GMail

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:

  1. Run reportbug --configure as your normal user. This creates a ~/.reportbugrc file that stores all the configurations.

  2. Follow the instructions and when asked Do you have a 'mail transport agent' (MTA) configured, choose No

  3. Then enter the SMTP host for gmail: smtp.gmail.com:587

  4. For the user name enter: <username>@gmail.com

  5. For the question Does your SMTP host require TLS authentication?, choose Yes

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.

Troubleshooting

Warning: unsupported locale setting: This error relates to Locale configuration. To workaround this problem, invoke the program as LANG=C reportbug

See also