mohitmishra786/low-level-dev-skills / skills/debuggers/gdb
gdb
VerifiedGDB debugger skill for C/C++ programs. Use when starting a GDB session, setting breakpoints, stepping through code, inspecting variables, debugging crashes, using reverse debugging (record/replay), remote debugging with gdbserver, or loading core dumps. Activates on queries about GDB commands, segfaults, hangs, watchpoints, conditional breakpoints, pretty-printers, Python GDB scripting, or multi-threaded debugging.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 6.2 KB |
| references/cheatsheet.md | markdown | 5.5 KB |
| references/scripting.md | markdown | 1.9 KB |
references/cheatsheet.md
View on GitHub# GDB Command Cheatsheet
Source: <https://sourceware.org/gdb/documentation/>
Source: <https://aaronbloomfield.github.io/pdr/docs/gdb_vs_lldb.html>
## Table of Contents
1. [Startup](#startup)
2. [Execution control](#execution-control)
3. [Breakpoints & watchpoints](#breakpoints--watchpoints)
4. [Inspection](#inspection)
5. [Stack](#stack)
6. [Memory](#memory)
7. [Threads](#threads)
8. [Reverse debugging](#reverse-debugging)
9. [Display formats](#display-formats)
---
## Startup
```gdb
gdb prog Load binary
gdb prog core Load with core
gdb -p PID Attach to process
gdb --args prog a b c Pass arguments
gdb -batch -ex 'run' -ex 'bt' Non-interactive
set args a b c Set args after load
```
---
## Execution control
```gdb
run / r [args] Start
continue / c Resume
next / n Step over (source)
step / s Step into (source)
nexti / ni Step over (instruction)
stepi / si Step into (instruction)
finish Run to end of function
until N Run to line N in current file
until file.c:N Run to specific line
advance foo Run to next call of foo
return [expr] Force return value
signal SIGUSR1 Deliver signal
kill Kill program
```
---
## Breakpoints & watchpoints
```gdb
break main Function
break file.c:42 Line
break *0x400abc Address
break foo if x > 0 Conditional
tbreak foo Temporary (once)
rbreak regex All matching functions
catch throw C++ exception thrown
catch syscall mmap Syscall breakpoint
watch var Write watchpoint
rwatch var Read watchpoint
awatch var Read/write watchpoint
watch *(int*)addr Memory watchpoint
info breakpoints / info watch List
delete N Remove breakpoint N
disable N / enable N Toggle
ignore N count Skip N times
commands N Run commands on hit
```
---
## Inspection
```gdb
print expr / p expr Print expression
print/x expr Print hex
print/t expr Print binary
print/f expr Print float
print/c expr Print char
print/d expr Print signed int
print/u expr Print unsigned int
print/a expr Print as address
print arr@N Print N elements
print *ptr Dereference
print *((int*)ptr) Cast and deref
display expr Print on every stop
undisplay N Remove auto-display
info display List
ptype var Print type of var
whatis var Brief type info
info locals All locals
info args Function arguments
info variables All global variables
```
---
## Stack
```gdb
backtrace / bt Call stack
bt N Top N frames
bt full Frames + locals
bt -N Bottom N frames
frame N / f N Select frame N
up / down Move in stack
info frame Frame info
info args Current frame args
info locals Current frame locals
```
---
## Memory
```gdb
x/Nuf addr Examine memory
N = count
u = unit: b(byte) h(half=2) w(word=4) g(giant=8)
f = format: x(hex) d(dec) u(uint) o(octal) t(bin) f(float) s(string) i(insn)
Examples:
x/10wx 0x7fff0000 10 words (hex)
x/4gx $rsp 4 giants at stack top
x/20i $rip 20 instructions from RIP
x/s 0x400abc String
x/b &var Single byte
set {int}0xaddr = 42 Write memory
set var = 42 Set variable
```
---
## Threads
```gdb
info threads List threads
thread N Switch to thread N
thread apply all bt Backtrace all
thread apply all bt full
thread apply 1 2 print x Apply to specific threads
set scheduler-locking on/off Lock/unlock other threads during step
```
---
## Reverse debugging
```gdb
record Start software record
record btrace Start hardware trace
record stop Stop recording
reverse-continue / rc Go backward to last event
reverse-next / rn Reverse step-over
reverse-step / rs Reverse step-into
reverse-finish Reverse finish
set exec-direction reverse Make n/s go backward
set exec-direction forward Restore
record instruction-history Show recorded instructions (btrace)
record function-call-history Show call history (btrace)
```
---
## Display formats
| Format | Code | Example |
|--------|------|---------|
| Hex | `/x` | `p/x var` |
| Decimal | `/d` | `p/d var` |
| Binary | `/t` | `p/t var` |
| Float | `/f` | `p/f var` |
| Char | `/c` | `p/c var` |
| String | `/s` | `x/s ptr` |
| Instruction | `/i` | `x/5i $pc` |
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |