Skip to content
New

DeepSeek V4.1 Flash free for 7 days: 10M tokens a day after a top-up of $10 or more. Until Nov 30.

How it works
aeondave/gdbReverse engineering and fuzzing

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/gdb

Writes to ⁦~/.notholy/skills⁩ after checking the signature and the SHA-256.

SignatureSigned, ed25519
KiOhrK6chV…vx/xVqAw==The CLI checks the SHA-256 and the signature before it writes a file.
Package27d0a8cd…038555fa
27d0a8cdb811…1ddf038555fa3 files · ⁦8.3 KB⁩
ScanLow1 finding
  • Links to outside domains
See the full scan
Sourcegithub.com/AeonDave/malskill/tree/main/offensive-tools/rev/gdb@21cd568

GNU debugger enhanced with pwndbg or GEF — the primary dynamic analysis tool for ELF binaries.

Installation

bash
# 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 ./binary

Quick Start

bash
# 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, backtrace

Essential Commands

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.

  1. Break at the exact call instruction, function entry, return instruction, and epilogue/pivot.
  2. At each stop, record rip, general registers, bt, mappings, and bounded memory windows around rsp, rbp, inputs, outputs, and write targets.
  3. Give each snapshot a stage and attempt ID; keep all stages from one PID together.
  4. Compare the pre-call and post-return snapshots byte-for-byte.
  5. Continue to the next consumer of the modified state. A correct write that is never consumed is not an exploitable chain.

Minimal command block:

gdb
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)

bash
# Most Linux malware uses ptrace(PTRACE_TRACEME) to detect debuggers
catch syscall ptrace
run
# When caught:
set $rax = 0           # Fake success
continue

Anti-debug bypass (/proc/self/status)

bash
# 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 result

Unpacking in memory

bash
# 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

bash
break connect
break send
break recv
break sendto
break getaddrinfo
run
# On hit:
bt                     # See call chain
x/s $rdi              # Examine args

Full execution trace (pwndbg)

bash
# Trace all calls with arguments
pwndbg> set logging on
pwndbg> break *entry_point
pwndbg> commands
> silent
> bt 1
> continue
> end
pwndbg> run

Python Scripting

python
# 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

Permissions

PermissionDeclaredFound by the scan
Reads filesYesYes
Writes filesYesYes
Runs shell commandsYesYes
Uses the networkYesYes
Uses connectorsNoNo
Drives a browserNoNo

Scan findings

Reviewed on Nov 13, 2026

  1. InfoLink · Links to outside domains

A clean scan lowers the risk but does not prove a package is safe. Read what you install.

VersionPublishedCommitSHA-256SignaturePermission change
v2026.11.13-21cd568Nov 13, 202621cd56827d0a8cdSigned–

Ask anything your scope allows.

Create an account, add credits and ask the first question in the chat or the terminal.

  1. 1/3

    Create the account

    Individual or company. You can switch to a company later without losing balance or keys.

    IndividualCompany
  2. 2/3

    Add credits

    By card. Pay per token, no subscription.

    $5.00minimum deposit
  3. 3/3

    Ask

    In the chat, or install the CLI and run notholy login in your terminal.

    $ notholy login