« Previous - Version 2/5 (diff) - Next » - Current version
coder, 27/03/2012 17:19

Reporting Bugs

If you've found a bug in libavg, please report it on the bug tracking system. It can be reached in the toolbar above ('View Tickets' and 'New Ticket'). You need to click yourself a site account using the link at the top right of the page.

Please report ab bug if you hit a segmentation fault or an assertion, if make check fails on your machine, or if libavg is doing something else that it shouldn't be. If you think you might have found a bug but aren't sure, please ask on the mailing list first. Also, please check the installation guides if you can't get libavg running at all - most causes of installation failures are described in the wiki.

What to Include

To find out what is happening, we need to reproduce the bug. In the majority of cases, bug reports don't contain enough information for us to do this.

We always need to know:

  • The libavg version: Installer, tarball, svn checkout? If svn checkout: which version?
  • The exact program output.
  • If make check terminates without errors. If there are errors in make check, please sent the output of make check.

If it's a configuration-related bug (many are), we need to know:

  • What type of system you are running libavg on (OS and exact version, processor, graphics card, driver version).
  • Under Mac OS X, open the System Profiler (About This Mac -> More Info), then choose File -> Save As and RTF file format, or just tell us the version of Mac OS X as well as the model and graphics card of the computer.
  • Under linux, we need to know the distribution (incl. version) and the output of:
1$ uname -a
2$ glxinfo

Segmentation Faults

If you're running into a segmentation fault, we need a stack trace:

1 $ gdb python
2 (gdb) r Test.py
3 [...]
4 ./bin/bash: line 4:  4324 Segmentation fault      ${dir}$tst
5 (gdb) bt

Replace 'Test.py' with whatever libavg program is causing the segfault. If the segfault doesn't happen directly after the 'r Test.py' line, insert a 'c' command (for 'continue'). The 'b' command should then generate your stack trace.