[image of Archer
Fish]

GDB: The GNU Project Debugger

[bugs] [committee] [contributing] [current cvs] [documentation] [download] [home] [links] [mailing lists] [news] [schedule] [song]

Bugs in GDB

Please report bugs!

GDB has a Bug Database. It is used to track bugs (Problem Reports or PRs) and enhancements (Change Requests or CRs). In addition to problems encountered when running GDB, bugs include: errors or missing documentation; missing test cases; web changes; work in progress; dummy reports for fixed but unreported bugs; entries of not-a-bugs; and even adminstrivia.

Please note that many companies now redistribute GDB, often as part of a GNU/Linux distribution. When you find bugs in GDB that you installed with a given GNU/Linux distribution, it is often useful to first try reporting the bug directly to the distributor, not to us. Sometimes, distributors have modified the GNU software (as they are free to do so!) or they are running older versions. Thus, they may be the best people to find a bug as it pertains to a particular distribution.

Before submitting a new PR/CR, try browsing the database to see if the problem has already been reported or even fixed.

It is also very helpful if you can try reproducing the problem with a current GDB snapshot (see current). Often bugs in the most recent release (see download) have already been fixed in the latest development sources. Regardless, be sure to fill in the Release field.

The Bug Report Form has a number of fields, the intended use of some of them are less than obvious, the below may help in filling in the form:

CC these people on PR status e-mail
A list of interested parties. If converting an e-mail posting into a bug report consider including the CC line.
Category
Set this to GDB.
Synopsis
Since this is used for key word searches, including the operating system (GNU/Linux, ...), compiler (GCC, xcc, ...) and language (C, C++, ...) can be helpful.
Confidential
Set this to no. GDB's bug tracking database is not confidential.
Severity
How disastrous is the bug? The following is a rule of thumb. critical: unusable (doesn't build, dumps core during startup, ...), testsuite regression; serious: most things (core dump, misleading behavour, ...); non-critical: obscure edge condition.
Priority
From the viewpoint of the GDB, how urgent is the bug fix? Select either medium or low. High is reserved.
Submitter-Id
Set this to net.
Release
It appears as the first line of the GDB startup text (GNU gdb 2002-03-01-cvs, GDB 4.17). The more recent the release the better.
Environment
Three pieces of information are useful:
How-To-Repeat
A sequence (compiler invocation, gdb commands, ...) that can be used to reproduce the problem. A new testcase would be briliant!
When the GDB developers receive a bug report, we usually try to fix the problem. While our bug fixes may seem like individual assistance, they are not; they are part of preparing a new improved version. We may send you a patch for a bug so that you can help us test the fix and ensure its quality. If your bug report does not evoke a solution from us, you may still get one from another user who reads our mailing lists. Otherwise, use the GNU Service Directory (a list of people who offer support and other consulting services).

If you're interested in participating in GDB's development (helping to fix bugs, write documentation, develop new code), see the mailing list and contribute web pages.

We welcome feedback and contributions.

[bugs] [committee] [contributing] [current cvs] [documentation] [download] [home] [links] [mailing lists] [news] [schedule] [song]

Please send FSF & GNU inquiries & questions to gnu@gnu.org. There are also other ways to contact the FSF.

This page is maintained by the GDB developers.

Copyright Free Software Foundation, Inc., 51 Franklin St - Fifth Floor, Boston, MA 02110-1301 USA.

Verbatim copying and distribution of this entire article is permitted in any medium, provided this notice is preserved.

Last modified 2006-01-20.