gdb
Auth/lab ref: GDB with pwndbg/GEF for dynamic binary analysis, malware debugging, exploitability research, and reverse engineering on Linux/WSL.
v2026.11.13-21cd5683 installs+3 in 7 days39 StarsMITsynced 11 hours ago
Install
No NotHoly CLI yet? Install it first.
$ curl -fsSL https://notholy.com/install.sh | sh$ notholy skills install aeondave/gdbWrites to ~/.notholy/skills after checking the signature and the SHA-256.
SignatureSigned, ed25519
Package27d0a8cd…038555fa
27d0a8cdb811…1ddf038555fa3 files · 8.3 KBScanLow1 finding
- Links to outside domains
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/rev/gdb@21cd568
On this page
GNU debugger enhanced with pwndbg or GEF — the primary dynamic analysis tool for ELF binaries.
Installation
# GDB
sudo apt-get install -y gdb
# pwndbg (recommended for RE/malware)
git clone https://github.com/pwndbg/pwndbg ~/pwndbg
cd ~/pwndbg && ./setup.sh
# OR GEF (lighter)
bash -c "$(curl -fsSL https://gef.blah.cat/sh)"
# OR portable pwndbg tarball (no git needed)
# Download from https://github.com/pwndbg/pwndbg/releases
tar -xf pwndbg_*.tar.xz
./pwndbg/bin/pwndbg ./binaryQuick Start
# Open binary
gdb -q ./binary
# With pwndbg:
pwndbg> start # Run to main
pwndbg> disass main # Disassemble main
pwndbg> info functions # List all functions
pwndbg> context # Show registers, code, stack, backtraceEssential Commands
Navigation and Execution
| Command | Purpose |
|---|---|
start |
Start and break at main |
starti |
Start and break at first instruction |
run [args] |
Run with arguments |
continue / c |
Continue execution |
nexti / ni |
Step over (instruction level) |
stepi / si |
Step into (instruction level) |
next / n |
Step over (source level) |
finish |
Run until current function returns |
until *ADDR |
Run until address |
Breakpoints
| Command | Purpose |
|---|---|
break main |
Break at function |
break *0x401234 |
Break at address |
break connect |
Break on libc call |
rbreak regex |
Break on all functions matching regex |
catch syscall ptrace |
Catch specific syscall |
watch *0xADDR |
Hardware watchpoint (data bp) |
info breakpoints |
List breakpoints |
delete N |
Delete breakpoint N |
condition N expr |
Conditional breakpoint |
Inspection
| Command | Purpose |
|---|---|
info registers / regs |
All registers |
x/20gx $rsp |
Examine 20 qwords at RSP |
x/s $rdi |
Print string at RDI |
x/10i $pc |
Disassemble 10 instructions at PC |
telescope $rsp 30 |
pwndbg: smart stack dump |
vmmap |
pwndbg: memory map |
hexdump $rsp 0x80 |
pwndbg: hex dump |
search --string "http" |
pwndbg: search memory |
bt |
Backtrace (call stack) |
info proc mappings |
Process memory layout |
Memory and Data
| Command | Purpose |
|---|---|
set {int}0xADDR = VALUE |
Write to memory |
set $rax = 0 |
Modify register |
dump binary memory out.bin ADDR1 ADDR2 |
Dump memory range to file |
find /b ADDR1, ADDR2, 0x4d, 0x5a |
Find byte pattern |
Breakpoint snapshot campaign
Use snapshots when exploitability depends on runtime frame layout, allocator history, or a library call's internal path.
- Break at the exact call instruction, function entry, return instruction, and epilogue/pivot.
- At each stop, record
rip, general registers,bt, mappings, and bounded memory windows aroundrsp,rbp, inputs, outputs, and write targets. - Give each snapshot a stage and attempt ID; keep all stages from one PID together.
- Compare the pre-call and post-return snapshots byte-for-byte.
- Continue to the next consumer of the modified state. A correct write that is never consumed is not an exploitable chain.
Minimal command block:
set pagination off
set logging file snapshot.log
set logging overwrite off
set logging enabled on
printf "\n=== attempt-03 stage-trigger-pre ===\n"
info inferior
info registers
bt
info proc mappings
x/32gx $rsp
x/16gx $rbp-0x40
x/64bx <input-address>
x/64bx <target-address>Use a watchpoint on the exact target after the first snapshot. Re-capture registers, backtrace, and both memory windows on every write. Snapshot the real final call site; a smaller test case may select a different algorithm or stack frame.
For allocator integrity failures, stop at the comparison that rejects the list instead of recording only malloc_printerr or SIGABRT. Dump the victim, fd, bk, bin sentinel, tcache entry, and normalized request size. Step backward through the last allocation/free transition to identify which automatic metadata write broke reciprocity.
When a clean-process trigger works but the full exploit fails, run the complete payload and break before every helper allocation introduced by the trigger. Compare arena and tcache state against the clean trigger; this is the composability gate.
Malware Analysis Workflows
Anti-debug bypass (ptrace)
# Most Linux malware uses ptrace(PTRACE_TRACEME) to detect debuggers
catch syscall ptrace
run
# When caught:
set $rax = 0 # Fake success
continueAnti-debug bypass (/proc/self/status)
# Malware reads TracerPid from /proc/self/status
catch syscall openat
run
# When openat for /proc/self/status is caught, let it proceed
# and break on read to patch the resultUnpacking in memory
# Break when malware changes memory permissions (RWX = unpacked code)
catch syscall mprotect
run
# When hit: check arguments
x/s $rdi # address
p/x $rsi # length
p/x $rdx # prot flags (7 = RWX)
# After mprotect returns, dump the unpacked region:
dump binary memory unpacked.bin $rdi ($rdi + $rsi)Network activity tracing
break connect
break send
break recv
break sendto
break getaddrinfo
run
# On hit:
bt # See call chain
x/s $rdi # Examine argsFull execution trace (pwndbg)
# Trace all calls with arguments
pwndbg> set logging on
pwndbg> break *entry_point
pwndbg> commands
> silent
> bt 1
> continue
> end
pwndbg> runPython Scripting
# GDB Python API — run with: gdb -q -x script.py ./binary
import gdb
class MalwareTracer(gdb.Breakpoint):
def __init__(self, func):
super().__init__(func, gdb.BP_BREAKPOINT)
self.func = func
self.silent = True
def stop(self):
frame = gdb.selected_frame()
rdi = int(frame.read_register("rdi"))
rsi = int(frame.read_register("rsi"))
print(f"[TRACE] {self.func}(rdi=0x{rdi:x}, rsi=0x{rsi:x})")
return False # Don't stop, just log
for f in ["connect", "send", "recv", "write", "execve", "mprotect"]:
try:
MalwareTracer(f)
except Exception:
pass
gdb.execute("run")pwndbg-specific Commands
| Command | Purpose |
|---|---|
context |
Show full context (regs, code, stack, bt) |
telescope ADDR N |
Dereference pointer chains |
vmmap |
Virtual memory map with permissions |
procinfo |
Process details |
got |
GOT table entries |
plt |
PLT entries |
canary |
Show stack canary value |
retaddr |
Return addresses on stack |
search --string STR |
Search memory for string |
search --qword VAL |
Search memory for value |
patch ADDR 'nop; nop' |
Patch instructions |
heap |
Heap chunk listing (glibc) |
bins |
Arena bin contents |
vis_heap_chunks |
Visual heap layout |
xinfo ADDR |
Offset info for address |
cymbol |
Define custom C structs |
entry |
Run to entry point |
GEF-specific Commands
| Command | Purpose |
|---|---|
gef config |
Configure GEF |
checksec |
Binary security features |
elf-info |
ELF header details |
xfiles |
List all loaded libraries |
scan |
Search for patterns |
format-string-helper |
Format string exploit aid |
pattern create N |
De Bruijn pattern for offset finding |
pattern offset VAL |
Find offset from pattern value |
Resources
| File | When to load |
|---|---|
| references/malware-debugging.md | Step-by-step malware debugging workflows |
| references/scripting.md | Load when automating repeated breakpoint snapshots, call/return tracing, watchpoints, or structured event logs with the GDB Python API |
Files in this version
references/215.4 KB
- malware-debugging.md7.5 KB
- scripting.md7.9 KB
- SKILL.md7.9 KB
Permissions
| Permission | Declared | Found by the scan |
|---|---|---|
| Reads files | Yes | Yes |
| Writes files | Yes | Yes |
| Runs shell commands | Yes | Yes |
| Uses the network | Yes | Yes |
| Uses connectors | No | No |
| Drives a browser | No | No |
Scan findings
Reviewed on Nov 13, 2026
- InfoLink · Links to outside domains
A clean scan lowers the risk but does not prove a package is safe. Read what you install.
| Version | Published | Commit | SHA-256 | Signature | Permission change |
|---|---|---|---|---|---|
| v2026.11.13-21cd568 | Nov 13, 2026 | 21cd568 | 27d0a8cd | Signed | – |
More from AeonDave
All from this publisherMore in Reverse engineering and fuzzing
See the categoryAsk anything your scope allows.
Create an account, add credits and ask the first question in the chat or the terminal.
- 1/3
Create the account
Individual or company. You can switch to a company later without losing balance or keys.
IndividualCompany - 2/3
Add credits
By card. Pay per token, no subscription.
$5.00minimum deposit - 3/3
Ask
In the chat, or install the CLI and run notholy login in your terminal.
$ notholy login