Pyddd

Pyddd is a super-GDB debugger which could debug python scripts as the same way to debug c program line by line in the same inferior.

Download

You can also download a snapshot from the Git repository:

• as a .tar.gz file or
• as a .zip file

Installation

Since Pyddd is written in the Python language, you need to install Python (the required version is at least 2.6).

Linux

• Rebuild GDB with Python and reinstall it.

$ tar xzf gdb-7.8.1.tar.gz
$ cd gdb-7.8.1
$ ./configure --with-python=python --with-babeltrace=no \
  --enable-tui=no --enable-host-shared
$ make && make install

• Extract Pyddd package, copy libddd.py to gdb data directory.

$ cp libddd.py /usr/local/share/gdb/python

• Build pyddd-ipa.

$ gcc -g -fPIC -I/usr/include/python2.7 -Wl,-lpthread -shared -o \
  python-ipa.so ipa.c
$ cp python-ipa.so /usr/local/lib

Windows

• Install Cygwin.
• Rebuild GDB with Python in Cygwin and reinstall it.

$ tar xzf gdb-7.8.1.tar.gz
$ cd gdb-7.8.1
$ ./configure --with-python=python --with-babeltrace=no \
  --enable-tui=no --enable-host-shared
$ make && make install

• Unzip Pyddd package, copy libddd.py to gdb data directory.

$ cp libddd.py /usr/local/share/gdb/python

• Open Cygwin Terminal, build pyddd-ipa.

$ gcc -g -I/usr/include/python2.7 -Wl,-lpthread -shared -o \
  python-ipa.dll ipa.c
$ cp python-ipa.dll /usr/local/lib

Quick Start

After installation, invoke the command prompt, go to the directory including the debugged script foo.py and run those commands (assume pyddd is extracted at /usr/local/pyddd):

$ gdb -x /usr/local/pyddd/init.gdb
(gdb) py-exec-file python
(gdb) py-file foo.py
(gdb) py-start

For more, see pyddd.rst and rationale.rst.