CSE 351: The Hardware/Software Interface
HomeCalendarCOVID Safety

GDB (Gnu DeBugger)

Overview

GDB is an immensely useful tool to help you debug your C and assembly programs.

It lets you insert breakpoints into your programs so that you can stop execution and examine the contents of memory and registers.
It supports single-stepping your program one line of source code or one line of assembly code at a time.
It leads to much more productive debugging than just using print statements (e.g., printf).

The time you spend getting familiar with GDB will be an excellent investment for this and future courses.

Resources
GDB cheat sheet: A handy dandy guide to the most commonly used GDB commands. Useful to have open while using GDB (and going through the other resources here).
Intro to GDB: This video shows you how to get started with GDB. This will be especially useful for Lab 2.
GDB Tutorial Assignment: An optional walkthrough assignment to give you some hands-on experience with GDB.
Examining Memory: Learn how to format your memory output in GDB. This will be especially useful for Lab 3.
Extensive tutorial: Looking for more details? Find them here thanks to Norman Matloff at UC Davis.
Examples

Here are some code samples for playing with GDB along with some example commands you can try:

Array example and typical GDB commands
Linked list example
Text User Interface

Text User Interface (TUI) mode of GDB can nicely show your code and the value of registers as you debug!Its use is entirely optional for 351, but we wanted you to be aware of it as it may help some of you.

More info on TUI commands

Opening TUI Mode

Most TUI commands will automatically start TUI mode, but you can also explicitly open GDB in TUI mode using:

[attu]$ gdb -tui <filename>

Layout Views

Of particular interest, you can bring up the disassembly and registers view using:

(gdb) layout asm (gdb) layout regs

Note that you want to do them in that order so that the registers window is on top. Then as you execute instructions (stepi or si for assembly instructions), the assembly view will highlight the next instruction (not executed yet) and the registers view will highlight any changed registers.

Formatting Issues

Unfortunately, there are some annoying formatting issues that sometimes pop up while using TUI mode. If things start to look weird, run the following command (or press Ctrl+L) to set things straight:

(gdb) refresh