dnrops
/
pwndbg
mirror of https://github.com/pwndbg/pwndbg
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
455 Commits 7 Branches 19 Tags 43 MiB
Python 97.2%
Shell 1.1%
C 0.9%
Nix 0.4%
Makefile 0.2%
Other 0.1%
Go to file
Gulshan Singh 26f7321c60 Fixed arrow direction (#116) 2016-09-23 16:11:55 -07:00
caps Restore ida_function.png to original size 2016-06-29 22:43:32 +02:00
capstone@03ff67a0e0 Update submodules 2016-09-12 21:51:58 -04:00
pwndbg Fixed arrow direction (#116) 2016-09-23 16:11:55 -07:00
tests Add shebang and encoding to each file 2016-09-12 19:35:46 -07:00
unicorn@d59081b073 Update submodules 2016-09-12 21:51:58 -04:00
.gitignore lots of WIP stuff 2015-05-09 15:25:24 -04:00
.gitmodules Update installation instructions 2016-05-11 19:36:26 -07:00
.isort.cfg Add isort, config, and pre-CI hook 2016-06-14 12:31:56 -07:00
.sublime-settings Add sublime-settings [skip ci] 2015-10-25 16:51:45 -04:00
.travis.yml Remove unused file, fix unicode error, add syntax checking for all files 2016-08-11 14:52:53 -07:00
FEATURES.md Add screenshots 2016-06-29 22:43:32 +02:00
LICENSE.md license 2015-03-11 03:29:11 -07:00
README.md Do not use sudo for the setup.sh since this sets up the submodule files to be owned by root 2016-09-08 14:40:25 -07:00
gdbinit.py Add shebang and encoding to each file 2016-09-12 19:35:46 -07:00
ida_script.py Add shebang and encoding to each file 2016-09-12 19:35:46 -07:00
requirements.txt Use six module for types 2016-06-14 12:32:22 -07:00
setup.sh Do not use sudo for the setup.sh since this sets up the submodule files to be owned by root 2016-09-08 14:40:25 -07:00
tag_release.sh Fix script 2016-09-22 14:45:13 -07:00

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

[Pwndbg]

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

Contact

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