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

1. Install gcc, gdb, and make

2. 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

3. 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"

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

OR

1. run tug
2. click "Debug Program" menu button
3. fill in gdb filename and debug filename, args are optional
4. 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.html#GDB_002fMI

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