Merge branch 'master' of ssh://pumpa.branchable.com
[larjonas-pumpa.git] / doc / debug_mode.mdwn
blob3fbf5fce923d7135a43b7d10fa1ef3a149fff1a6
1 If you experience crashes it may be useful to run Pumpa in debug
2 mode.  Right now you'll need to recompile it for that with the
3 following steps:
5     cd pumpa
6     make clean
7     qmake CONFIG+=debug
8     make
9     
10 In addition to adding debugger support to the executable, using debug mode will also cause Pumpa
11 to display a lot more output to the terminal (stdout), e.g. when it is making HTTP requests, 
12 and other information potentially useful when debugging.
14 To run Pumpa in the debugger (you need to have `gdb` installed) type:
16     gdb ./pumpa
18 Inside gdb you then start Pumpa with the command `run`. If it has
19 crashed you'll be thrown back to the debugger, then type `where`,
20 which will tell you where it crashed. This information can be very
21 useful (in particular the first 10-20 lines), please include it if you
22 report a bug.