wiki:WikiStart
Last modified 3 years ago Last modified on 09/13/11 13:45:32

Btparser

Btparser is a backtrace parser and analyzer, which works with backtraces produced by the GNU Project Debugger. It can parse a text file with a backtrace to a tree of C structures, allowing to analyze the threads and frames of the backtrace and work with them.

Btparser also contains some backtrace manipulation and extraction routines:

  • it can find a frame in the crash-time backtrace where the program most likely crashed (a chance is that the function described in that frame is buggy)
  • it can produce a duplication hash of the backtrace, which helps to discover that two crash-time backtraces are duplicates, triggered by the same flaw of the code
  • it can "rate" the backtrace quality, which depends on the number of frames with and without the function name known (missing function name is caused by missing debugging symbols)

Btparser also implements metrics allowing to compute a "distance" or "similarity" between backtraces.

Btparser is used by Automatic Bug Reporting Tool (ABRT) for obtaining informations from backtraces.

Obtaining

The source code of released versions can be downloaded from https://fedorahosted.org/released/btparser. The NEWS file documents what is new in a particular release.

Contributing

The source code repository with the latest development code and history is publicly available via Git.

To get the source code of the development version, run:

$ git clone git://git.fedorahosted.org/git/btparser.git

To browse the source code online, visit the Trac interface to Git or the Gitweb interface.

Open a new ticket in Trac to submit new features, bug fixes, documentation, suggestions etc. You might want to discuss and refine your ideas via email before implementing something.

Support

To ask for help with Btparser, write to kklic at redhat.com.

Licensing

Btparser is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

Authors

  • Karel Klíč <kklic at redhat.com>
  • Jan Šmejda