Python Other
Clone or download
disconnect3d Fixes piebase and breakrva on remote debugging (#502)
Fixes the issue caught by ecx86 in:
#500 (comment)

The commands broke when we debugged a remote target which was
hosted on a remote gdbserver (NOT a local one).

This is because we used `pwndbg.proc.exe` (changed in previous commit)
which is a local path to the binary which was then used to filter out
memory pages belonging to the binary.

To fix the issue, the AUXV's AT_EXECFN is used first which was used
before previous commit but the returned path is now normalized
(as in previous version it didn't work because if it returned path './a.out'
it couldn't match it with binary's Page.objfile which was e.g. '/blabla/a.out').
Latest commit 0f5b028 Jul 12, 2018
Permalink
Failed to load latest commit information.
.github Add developer notes (#405) Jan 18, 2018
caps Added fake_fast_chunks command (#204) Apr 4, 2017
docs Fixes #391 - kills compat.py module (#452) May 3, 2018
profiling Profiling and performance improvements (#421) Feb 24, 2018
pwndbg Fixes piebase and breakrva on remote debugging (#502) Jul 12, 2018
tests Fix nearpc following jumps when used w/o emulation (#499) Jul 8, 2018
.gitignore Run each test in a separate GDB session (#498) Jul 8, 2018
.isort.cfg Promote GDB to a third-party utility Oct 3, 2016
.sublime-settings Add sublime-settings [skip ci] Nov 24, 2015
.travis.yml Fix nearpc following jumps when used w/o emulation (#499) Jul 8, 2018
DEVELOPING.md Improve behavior without IDA Pro (#442) Apr 24, 2018
FEATURES.md Added fake_fast_chunks command (#204) Apr 4, 2017
LICENSE.md license Mar 11, 2015
README.md Change README about GEF / GDBINIT / PWNDBG (#413) Feb 1, 2018
gdbinit.py Sort inputs Feb 10, 2017
ida_script.py Change IDA xmlrpc default port (#462) May 11, 2018
pytests_collect.py Run each test in a separate GDB session (#498) Jul 8, 2018
pytests_launcher.py Run each test in a separate GDB session (#498) Jul 8, 2018
requirements.txt Tests framework (#375) Apr 4, 2018
setup.cfg Add PEP8 configuration file for pep8 command-line and PyCharm Dec 13, 2016
setup.sh Use "pip" versions of Capstone and Unicorn (#176) Apr 6, 2017
tag_release.sh Merge stable to dev (#365) Nov 30, 2017
tests.sh Fix nearpc following jumps when used w/o emulation (#499) Jul 8, 2018

README.md

pwndbg Build Status license Py2&3 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 2017 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?

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

Want to help with development? Read CONTRIBUTING.

Contact

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