Go to file
Victor Chan 26a18f1d70
Remove quotes from command option interpolation (#876)
There was a quoting bug as `INSTALLFLAGS` contains both the option key and value.
This causes the subsequent commands to look something like `python ... '--target foo'...`, causing
the command to treat the entire string `--target foo` as an option key rather than a key-value pair.
2021-01-03 08:51:50 +01:00
.github Unit test fix (#868) 2020-12-31 04:35:52 +01:00
caps Try heap (#744) 2020-04-27 14:02:09 +02:00
docs Remove travis (#816) 2020-08-15 20:56:08 +02:00
profiling Profiling and performance improvements (#421) 2018-02-24 22:45:14 +07:00
pwndbg Unit test fix (#868) 2020-12-31 04:35:52 +01:00
tests Unit test fix (#868) 2020-12-31 04:35:52 +01:00
.gitignore Unit test fix (#868) 2020-12-31 04:35:52 +01:00
.isort.cfg Py3k (#817) 2020-08-15 21:27:47 +02:00
.sublime-settings Add sublime-settings [skip ci] 2015-10-25 16:51:45 -04:00
DEVELOPING.md Py3k (#817) 2020-08-15 21:27:47 +02:00
Dockerfile Unit test fix (#868) 2020-12-31 04:35:52 +01:00
FEATURES.md Try heap (#744) 2020-04-27 14:02:09 +02:00
LICENSE.md license 2015-03-11 03:29:11 -07:00
README.md Py3k (#817) 2020-08-15 21:27:47 +02:00
gdbinit.py Py3k (#817) 2020-08-15 21:27:47 +02:00
ida_script.py Fix decompile error (#716) 2020-03-08 14:11:04 +01:00
mkdocs.yml Add mkdocs documentation (#639) 2019-05-10 19:37:41 +02:00
pytests_collect.py Py3k (#817) 2020-08-15 21:27:47 +02:00
pytests_launcher.py Py3k (#817) 2020-08-15 21:27:47 +02:00
requirements.txt fix for ubuntu 20.04 (#850) 2020-10-23 14:01:12 +02:00
setup-test-tools.sh Unit test fix (#868) 2020-12-31 04:35:52 +01:00
setup.cfg Add PEP8 configuration file for pep8 command-line and PyCharm 2016-12-13 16:36:54 -06:00
setup.sh Remove quotes from command option interpolation (#876) 2021-01-03 08:51:50 +01:00
tag_release.sh Merge stable to dev (#365) 2017-11-29 18:43:21 -06:00
tests.sh Unit test fix (#868) 2020-12-31 04:35:52 +01:00

README.md

pwndbg license IRC

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 2020 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 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 300KB 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.

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

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.

Contact

If you have any questions not worthy of a bug report, feel free to ping ebeip90 or disconnect3d at #pwndbg on Freenode and ask away. Click here to connect.