Skip to content

Latest commit

 

History

History
58 lines (39 loc) · 1.67 KB

README.md

File metadata and controls

58 lines (39 loc) · 1.67 KB
Raw

Overview

This is gdb-gui, a GUI for gdb. This GUI differs from existing gdb GUIs in a few ways:

  • It runs in-process.

  • It is written in Python.

  • It is intended to interoperate well with the CLI. You can pick and choose which windows you want to see, and you can still do whatever you like in the terminal.

  • It is totally incomplete.

Installing

To get started, install the prerequisites. This requires GDB 14, because it uses a new feature there that helps with starting new Python threads in gdb.

You'll need a Python-enabled gdb, PyGObject, and PyGktSourceView. (And maybe more -- if you trip across something, let me know.)

On Fedora I think this suffices:

sudo yum install gdb python-devel gtksourceview3 pygobject3

Now type make to build the needed shared library.

The simplest way to make the GUI always be available is to then use:

make hack-gdbinit

This will edit your ~/.gdbinit to source the appropriate file. If you don't want to do this, you can just source the gdb-gui.py file from gdb at any time.

Using the GUI

This package adds a new gui command and various subcommands to gdb. It also adds some new set gui parameters.

A simple command to try is gui source, which pops up a source window. The source window will automatically track your progress when debugging. You can make multiple source windows; they will be reused in an LRU fashion. You can set the theme, font, and title format of source windows using the appropriate set gui commands.

Hacking

If you want to hack on this, you will need Glade to edit the UI elements. For Fedora 18, you'll need a special hack to make the gtksourceview widget visible to Glade.