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/
-
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
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 Program" menu button
- fill in gdb filename and debug filename, args are optional
- click "Start" button
- 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
program execution buttons
- "---" = jump to next executed line inside source window
- "|>" = start/continue program
- "||" = pause program
- "-->" = step into
- "/\>" = step over
- "</\" = step out
- 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
GDB Machine Interpreter:
https://sourceware.org/gdb/download/onlinedocs/gdb/GDB_002fMI.html#GDB_002fMI
GLFW:
https://www.glfw.org/download.html
https://www.glfw.org/docs/latest/compile.html