icinga2/tools/debug/gdb
Michael Friedrich 85af84c9fb Docs: Fix gdb pretty printers
fixes #8048
2014-12-15 11:26:22 +01:00
..
.gitignore Clean contrib/. 2013-10-03 20:36:44 +02:00
README.md Docs: Update troubleshooting with gdb debug printer install 2014-11-03 19:36:45 +01:00
gdbinit Docs: Fix gdb pretty printers 2014-12-15 11:26:22 +01:00
icingadbg.py Fix debug visualizer for the Value type 2014-12-12 15:22:37 +01:00

README.md

Pretty Printer Installation

Requirements:

  • icinga2 debug symbols
  • boost, gcc, etc debug symbols

Install the boost, python and icinga2 pretty printers. Absolute paths are required, so please make sure to update the installation paths accordingly (pwd).

Boost Pretty Printers:

$ mkdir ~/.gdb_printers && cd ~/.gdb_printers
$ git clone https://github.com/ruediger/Boost-Pretty-Printer.git && cd Boost-Pretty-Printer
$ pwd
/home/michi/.gdb_printers/Boost-Pretty-Printer

Python Pretty Printers:

$ cd ~/.gdb_printers
$ svn co svn://gcc.gnu.org/svn/gcc/trunk/libstdc++-v3/python

Icinga 2 Pretty Printers:

$ mkdir -p ~/.gdb_printers/icinga2 && ~/.gdb_printers/icinga2
$ wget https://raw.githubusercontent.com/Icinga/icinga2/master/tools/debug/gdb/icingadbg.py

Now you'll need to modify/setup your ~/.gdbinit configuration file. You can download the one from Icinga 2 and modify all paths.

Note

The path to the pthread library varies on distributions. Use find /usr/lib* -type f -name '*libpthread.so*' to get the proper path.

$ wget https://raw.githubusercontent.com/Icinga/icinga2/master/tools/debug/gdb/gdbinit -O ~/.gdbinit
$ vim ~/.gdbinit

More details in the troubleshooting debug documentation.