diff options
author | jgeboski <jgeboski@gmail.com> | 2015-06-27 08:10:08 +0300 |
---|---|---|
committer | jgeboski <jgeboski@gmail.com> | 2015-06-27 08:10:08 +0300 |
commit | a90c6e744714d391549ff1777593749e5caa88b2 (patch) | |
tree | 44f0cddb98cb3c3f56630b9b21ad3cd16fe34f71 /README | |
parent | 78b5e535654643e68c0ecd3cefe0f5d0b1d2cb60 (diff) |
README: added debugging information
Diffstat (limited to 'README')
-rw-r--r-- | README | 31 |
1 files changed, 31 insertions, 0 deletions
@@ -58,3 +58,34 @@ Compile the plugin: 4. Copy the downloaded `libfacebook.dll` to `C:\Program Files\Pidgin\plugins` Note: `Program Files` will be `Program Files (x86)` on 64-bit Windows. + +## Debugging + +Before debugging can begin, the plugin must be compiled with debugging +support. Once debugging support has been enabled, one of the two +supported environment variables can be defined to enable debugging +output. This can be used in unison with debuggers such as GDB, which +should enable easier tracing of bugs. + +When posting to the issue tracker, please ensure any sensitive +information has been stripped. + +Enable debugging support (enabled by default with Windows): + + $ ./autogen.sh --enable-debug + +Enable debugging output: + + $ export PURPLE_UNSAFE_DEBUG=1 PURPLE_VERBOSE_DEBUG=1 + $ pidgin --debug + OR + $ PURPLE_UNSAFE_DEBUG=1 PURPLE_VERBOSE_DEBUG=1 pidgin --debug + +Obtaining a GDB backtrace: + + $ PURPLE_UNSAFE_DEBUG=1 PURPLE_VERBOSE_DEBUG=1 gdb \ + -ex 'handle SIGPIPE nostop noprint pass' \ + -ex "set breakpoint pending on" \ + -ex "set pagination off" \ + -ex run -ex bt \ + --args pidgin --debug |