GDB Graphical Interface for GNU Emacs

This package provides a graphical interface to the GDB debugger. It is intended to be fast and intuitive.

It was made as a drop-in replacement for the builtin package gdb-mi (check this question for the reason behind rewriting the entire package from scratch).

Features

Fast: Instead of parsing the GDB/MI output in Elisp, I’ve created a dynamic module in C, which makes it run fast like a bullet!
Easy to use: The keybindings, which were inspired by Visual Studio and Qt Creator, were chosen to be easy to memorize and to provide the best interaction possible without much putting much strain on your fingers.
Does what you meant: Each command tries its best to infer what you meant when you run them.
Organized: You can change which buffer is displayed in each window, and even pop buffers to their own separate frames!
Simultaneous sessions: You can debug multiple programs at the same time, with different GDB sessions; each session creates its own frame.
Debug remotely: You may debug programs remotely over TRAMP!

List of special buffers

Threads
Stack frames
Breakpoints
Automatic variables
Watchers
Registers
Disassembly (of the selected stack frame)
Inferior I/O
GDB command shell (please read this question before going crazy!)

Interested? Here’s the quick-start guide!

Dependencies

GCC or Clang to compile the dynamic module
- The module is automatically compiled as soon as possible
GDB (surprise, surprise) is needed to debug programs; I’ve only tested version 8.2, but will probably work on older ones
Emacs package Hydra is needed for the buffer switcher

Package installation

This package intentionally uses the name gdb-mi in order to shadow the builtin package, as it could be confusing to have two packages with the same purpose installed.

The easiest way to install it is by using Quelpa, which builds the packages for you from any source you want.

In order to install, give Quelpa the following package recipe:

'(gdb-mi :fetcher git
         :url "https://github.com/weirdNox/emacs-gdb.git"
         :files ("*.el" "*.c" "*.h" "Makefile"))

It is highly recommended that you delete the autoloaded definitions from the builtin package in order to prevent confusion:

(fmakunbound 'gdb)
(fmakunbound 'gdb-enable-debug)

Here is an example configuration using use-package:

(use-package gdb-mi :quelpa (gdb-mi :fetcher git
                                    :url "https://github.com/weirdNox/emacs-gdb.git"
                                    :files ("*.el" "*.c" "*.h" "Makefile"))
  :init
  (fmakunbound 'gdb)
  (fmakunbound 'gdb-enable-debug))

You may also do everything manually or use another package manager that supports Git repos. Example for straight.el:

(use-package gdb-mi
  :straight (:host github :repo "weirdNox/emacs-gdb" :files ("*.el" "*.c" "*.h" "Makefile"))
  :init
  (fmakunbound 'gdb)
  (fmakunbound 'gdb-enable-debug))

Smash those bugs!

After the installation is complete, you may start a debugging session.

If you want to debug an executable, run gdb-executable. You may also use this command to change the executable being debugged.

If you want another type of target, you may try running gdb-create-session and then inserting the commands manually in the shell buffer. I’ve not tested this, so I don’t know how well it works.

Default keybindings

The main way to interact with this package is by using the global minor mode gdb-keys-mode, which enables the usual keybindings you expect in a debugger, inspired by Visual Studio and Qt Creator:

Keybinding	Description
`F5`	Run or continue
`C-F5`	(Re)Start and break at main
`S-F5`	Kill inferior
`F6`	Stop
`F8`	Create watcher
`C-F8`	Evaluate expression once
`F9`	Create or delete breakpoint
`F10`	Step over (instruction wise with `M-`)
`C-F10`	Run until cursor
`F11`	Step into (instruction wise with `M-`)
`C-F11`	Advance to cursor
`S-F11`	Step out
`F12`	Switch buffer or pop to frame

Nevertheless, even without the global minor mode, every buffer has some keybindings associated with it:

Threads buffer

Keybinding	Description
`SPC`	Select thread
`c`	Continue thread
`s`	Stop thread

Stack frames buffer

Keybinding	Description
`SPC`	Select frame
`c`	Continue thread

Breakpoints buffer

Keybinding	Description
`d` or `⌫` or `DEL`	Delete breakpoint
`SPC`	Enable/disable breakpoint

Automatic variables buffer

Keybinding	Description
`SPC`	Create watcher (prompt with `Shift` )
`RET`	Create watcher and select window (prompt with `Shift` )

Watchers buffer

Keybinding	Description
`a`	Add new expression
`RET`	Assign to expression
`e`	Edit expression under cursor
`f`	Change format
`d`	Duplicate
`h`	Toggle frame holding
`t`	Toggle access specifiers
`SPC` or `TAB`	Toggle children
`⌫` or `DEL`	Delete watcher

Registers buffer

Keybinding	Description
`f`	Change format
`SPC`	Create watcher (prompt with `Shift` )
`RET`	Create watcher and select window (prompt with `Shift` )

Disassembly buffer

Keybinding	Description
`f`	Change format
`F`	Change flavor

FAQ

Why rewrite the already existing package that comes with Emacs?

There are many things that led to my decision of rewriting gdb-mi:

When I wanted to use it, I ended up having to modify and rewrite many functions in order to have predictable functionality
In some cases, the parsing would be so slow that I could not use it at all (when disassembling a big function and then stepping, for example)
It felt weird that it changed all my windows instead of opening in a new frame
Other reasons I’ve forgotten
I like C, Elisp, and a good challenge: I couldn’t find a package that used dynamic modules and it seemed like the perfect chance to do something I would use, as I couldn’t find a debugger for Linux that I could say I liked.

Why use this interface instead of [insert Linux graphical debugger here]?

Well, if you use Emacs, both this and the builtin package are great because you never need to leave the environment you use the rest of the day.

If you don’t use Emacs (but are willing to try it) and you can’t find a good graphical debugger for Linux, this could be it!

If you are already happy with what you have, then there isn’t much to see here. ☺

May I send custom GDB commands?

You may send any GDB command you want.

However, keep in mind that if:

the command does not use the background form (eg. continue&), it will block GDB until it finishes what it is doing, so you won’t be able to interact with it! If you want to interrupt it, run comint-interrupt-subjob in the command shell buffer (bound to C-c C-c ).
the command does not cause GDB to notify the interface of the changes it made, the interface may become out of sync and start giving errors

Other information

This package uses the library GDBWIRE for parsing the GDB/MI output.
The original Emacs GDB interface was my main inspiration, so thanks Nick Roberts!

yochju/emacs-gdb