Go to file

Daniel Ebert 62df89e54c fix CI tests		4 years ago
.github	Unit test fix (#868 )	5 years ago
caps	Try heap (#744 )	6 years ago
docs	Remove travis (#816 )	5 years ago
profiling	chore(profile): extend test binary so unicorn engine shows more code flow	5 years ago
pwndbg	Update arguments.py	4 years ago
tests	fix CI tests	4 years ago
.gitignore	Make setup.sh work with Podman	4 years ago
.isort.cfg	Py3k (#817 )	5 years ago
.sublime-settings	Add sublime-settings [skip ci]	10 years ago
DEVELOPING.md	Py3k (#817 )	5 years ago
Dockerfile	Unit test fix (#868 )	5 years ago
FEATURES.md	Try heap (#744 )	6 years ago
LICENSE.md	license	11 years ago
README.md	Update links to use Discord	5 years ago
gdbinit.py	Py3k (#817 )	5 years ago
ida_script.py	Fix decompile error (#716 )	6 years ago
mkdocs.yml	Add mkdocs documentation (#639 )	7 years ago
pytests_collect.py	Py3k (#817 )	5 years ago
pytests_launcher.py	Py3k (#817 )	5 years ago
requirements.txt	Bump Unicorn Version	4 years ago
setup-test-tools.sh	Make setup.sh work with Podman	4 years ago
setup.cfg	Add PEP8 configuration file for pep8 command-line and PyCharm	9 years ago
setup.sh	Make setup.sh work with Podman	4 years ago
tag_release.sh	Merge stable to dev (#365 )	8 years ago
tests.sh	Unit test fix (#868 )	5 years ago

README.md

pwndbg

pwndbg (/poʊndbæg/) is a GDB plug-in that makes debugging with GDB suck less, with a focus on features needed by low-level software developers, hardware hackers, reverse-engineers and exploit developers.

It has a boatload of features, see FEATURES.md.

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 2021 and GDB still lacks a real 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 present (e.g. GEF) exist to fill some these gaps. Each provides an excellent experience and great features -- but they're difficult to extend (some are unmaintained, and all are a single 100KB, 200KB, or 363KB file (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. It also comes batteries-included, so all of its features are available if you run setup.sh.

How?

Installation is straightforward. Pwndbg is best supported on Ubuntu 18.04 with GDB 7.11, and Ubuntu 20.04 with GDB 8.1.

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

Other Linux distributions are also supported via setup.sh, including:

Debian-based OSes (via apt-get)
Fedora and Red Hat (via dnf)
Clear (via swiped)
OpenSUSE LEAP (via zypper)
Arch and Manjaro (via community AUR packages)
Void (via xbps)
Gentoo (via emerge)

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

What can I do with that?

For further info about features/functionalities, see FEATURES.

Who?

Pwndbg is an open-source project, written and maintained by many contributors!

Want to help with development? Read CONTRIBUTING or join our Discord server!

Contact

If you have any questions not worthy of a bug report, feel free to ping anybody on Discord and ask away.