Tug

GDB frontend made with Dear ImGui

Tugboat captain is the GDB archer fish mascot https://sourceware.org/gdb/mascot/
Jamie Guinan's original archer fish logo and the vector versions by Andreas Arnez are licensed under CC BY-SA 3.0 US. https://creativecommons.org/licenses/by-sa/3.0/us/

Building the Project

Install gcc, gdb, and make
For X11 based systems, install additional packages
Debian, Ubuntu, Linux Mint: sudo apt-get install xorg-dev
Fedora, RHEL: sudo dnf install libXcursor-devel libXi-devel libXinerama-devel libXrandr-devel
FreeBSD: pkg install xorgproto
Run command "make DEBUG=0", output executable is ./build_release/tug

Debugging an Executable

NOTE: Tug defaults to the gdb filename returned by the command "which gdb"

run program from command line
tug --exe [program to debug filename] --gdb [gdb filename]

OR

run tug
click "Debug" menu button
fill in gdb filename and debug filename, args are optional
click "Start" button

Source Window

CTRL-F: open text search mode, N = next match, SHIFT-N = previous match, ESC to exit
CTRL-G: open goto line window, ENTER to jump to input line, ESC to exit
hover over any word to query its value, right click it to create a new watch within the control window
add/remove breakpoint by clicking the empty column to the left of the line number

Control Window

program execution buttons

"---" = jump to next executed line inside source window
"|>" = start/continue program
"||" = pause program
"-->" = step into
"/\>" = step over
"</\" = step out

GDB Console Command Line

repeat last command on hitting enter on an empty line (GDB emulation)
cycle command history by pressing up/down arrow while clicked on the box
hit tab while typing to see all the autocompletions, hit tab/shift tab to cycle through them

Resources

GDB Machine Interpreter:
https://sourceware.org/gdb/download/onlinedocs/gdb#GDB_002fMI

GLFW:
https://www.glfw.org/download.html
https://www.glfw.org/docs/latest/compile.html