Differences between revisions 38 and 54 (spanning 16 versions)
Revision 38 as of 2019-10-20 13:32:46
Size: 3536
Editor: nodiscc
Comment: generic install instructions
Revision 54 as of 2021-09-21 06:38:39
Size: 3071
Comment: make pagename already correct for including this specific transaltion header
Deletions are marked like this. Additions are marked like this.
Line 2: Line 2:
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English - [[es/reportbug|Español]] - [[fr/reportbug|Français]] - [[it/reportbug|Italiano]] -~ ##For Translators - to have a constantly up to date translation header in you page, you can just add a line like the following
## <<Include(reportbug, ,from="^##TAG:TRANSLATION-HEADER-START",to="^##TAG:TRANSLATION-HEADER-END")>>
##TAG:TRANSLATION-HEADER-START
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: [[reportbug|English]] - [[es/reportbug|Español]] - [[fr/reportbug|Français]] - [[it/reportbug|Italiano]] - [[pt_BR/reportbug|Português (Brasil)]] - [[uk/reportbug|Українська]]-~
##TAG:TRANSLATION-HEADER-END
Line 4: Line 8:
Line 8: Line 11:
== Introduction == '''DebPkg:reportbug''' is a tool designed to make the [[BTS|reporting of bug(s) in Debian]] and its derived distributions, relatively painless.
Line 10: Line 13:
'''DebPkg: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.
Line 12: Line 15:
'''https://www.debian.org/Bugs/Reporting''' - How to report a bug in Debian using reportbug

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.

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 35: Line 26:
There is also a robot at {{{control@bugs.debian.org}}} that expects specially-crafted control messages for the [[BTS|bug tracking system]]. There is also a robot at {{{control@bugs.debian.org}}} that expects specially-crafted control messages for the Debian 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. Here, is an example using a GMail account:

 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.

'''Warning:''' The submit@bugs.debian.org procmail has a rule that silently discards emails from postmaster@<domain>. Combined with the fact that Google G-Suite changes the MAIL FROM address to postmaster@<domain> when the original MAIL FROM is from outside your domain makes your bugs to be silently discarded.

== Troubleshooting ==

'''Warning: unsupported locale setting:''' This error relates to [[Locale]] configuration. To workaround this problem, invoke the program as `LANG=C reportbug`
Line 39: Line 51:
 * https://www.debian.org/doc/manuals/debian-faq/ch-support.html#s-bugreport - Debian FAQ : How do I report a bug in Debian?
 * https://www.debian.org/Bugs/ - Debian Bug Tracking System (BTS)
 * https://www.debian.org/Bugs/Reporting - How to report a bug in Debian (do things without reportbug) ({{{/usr/share/doc/debian/bug-reporting.txt}}})
 * https://www.chiark.greenend.org.uk/~sgtatham/bugs.html - How to Report Bugs Effectively : generic recommendations for bug reporter
 * https://salsa.debian.org/reportbug-team/reportbug - the reportbug project page
 * BugTriage
 * [[BTS/BugTag]]
 * [[BTS]]
Line 47: Line 53:
=== Using other SMTP servers === == External Links ==
 * [[DebianMan:reportbug|reportbug manual page]]
 * [[https://salsa.debian.org/reportbug-team/reportbug|reportbug project page]] on [[Salsa]]
Line 49: Line 57:
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.
Line 51: Line 58:
==== GMail ==== ----
Line 53: Line 60:
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
}}}
CategoryBugs | CategorySoftware

Translation(s): English - Español - Français - Italiano - Português (Brasil) - Українська


reportbug is a tool designed to make the reporting of bug(s) in Debian and its 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 Debian 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. Here, is an example using a GMail account:

  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.

Warning: The submit@bugs.debian.org procmail has a rule that silently discards emails from postmaster@<domain>. Combined with the fact that Google G-Suite changes the MAIL FROM address to postmaster@<domain> when the original MAIL FROM is from outside your domain makes your bugs to be silently discarded.

Troubleshooting

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

See also


CategoryBugs | CategorySoftware