You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Go to file
Zach Riggle e595f58fb5
Only CI pushes for master branch (#65)
10 years ago
caps Mo caps 11 years ago
capstone@4d36deb1b6 Update installation instructions 10 years ago
pwndbg Add configurable color points (#63) 10 years ago
tests Added .travis.yml (#55) 10 years ago
unicorn@4b3bbe4759 Update installation instructions 10 years ago
.gitignore lots of WIP stuff 11 years ago
.gitmodules Update installation instructions 10 years ago
.sublime-settings Add sublime-settings [skip ci] 10 years ago
.travis.yml Only CI pushes for master branch (#65) 10 years ago
LICENSE.md license 11 years ago
README.md Move badges back onto title line (#62) 10 years ago
gdbinit.py Add print_function to everything 10 years ago
ida_script.py Add autoWait to ida_script 10 years ago
requirements.txt Update requirements 10 years ago
setup.sh Enable caching on Travis (#59) 10 years ago

README.md

pwndbg Build Status license

/poʊndbæg/

noun

  1. a collection of python that makes debugging with gdb suck less
  2. a PEDA replacement

Why?

Vanilla GDB is terrible to use for reverse engineering and exploit development. Typing x/g30x $esp is not fun, and does not confer much information. The year is 2016 and GDB still lacks a hexdump command. GDB's syntax is arcane and difficult to approach. Windbg users are completely lost when they occasionally need to bump into GDB.

What?

Pwndbg is a Python module which is loaded directly into GDB, and provides a suite of utilities and crutches to hack around all of the cruft that is GDB and smooth out the rough edges.

Many other projects from the past (e.g., gdbinit, PEDA) and presesnt (e.g. GEF) exist to fill some these gaps. Unfortunately, they're all either unmaintained, unmaintainable, or not well suited to easily navigating the code to hack in new features (respectively).

Pwndbg exists not only to replace all of its predecessors, but also to have a clean implementation that runs quickly and is resilient against all the weird corner cases that come up.

How?

Installation is straightforward. Pwndbg is best supported on Ubuntu 14.04 with GDB 7.7, and Ubuntu 16.04 with GDB 7.11.

git clone https://github.com/pwndbg/pwndbg
cd pwndbg
sudo ./setup.sh

If you use any other Linux distribution, we recommend using the latest available GDB built from source. Be sure to pass --with-python=/path/to/python to configure.

Who?

Most of Pwndbg was written by Zach Riggle, with many other contributors offering up patches via Pull Requests.