Files
gdb-gui/README.md
2023-11-22 21:19:22 -07:00

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.