mirror of
https://github.com/tromey/gdb-gui.git
synced 2025-07-21 04:51:20 +02:00
59 lines
1.7 KiB
Markdown
59 lines
1.7 KiB
Markdown
## 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.
|