dnrops
/
pwndbg
mirror of https://github.com/pwndbg/pwndbg
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity
1,501 Commits 6 Branches 19 Tags 40 MiB
Python 97.1%
Shell 1.1%
C 0.9%
Nix 0.5%
Makefile 0.2%
Other 0.1%
Go to file
Cycatz 80fbb375a7
Improve installation process (#1620) 
Now the installation process contains the following steps:
1. Check for any line with source <gdbinit.py> before installation
2. If any, ask the user if they want to proceed
3. After the installation, comment out old source <gdbinit.py> lines if any and add a new source <gdbinit.py> line.

A check for presence of the line set debuginfod enabled on is also added to avoid being appended repeatedly.
 		2023-03-15 20:30:24 +01:00
.devcontainer Updated permissions for Docker container 2021-12-05 00:41:56 +01:00
.github Add qemu tests to CI 2023-01-25 03:32:17 -08:00
caps Try heap (#744) 2020-04-27 14:02:09 +02:00
docs GPT-3 Command for Pwndbg (#1589) 2023-02-23 10:31:17 +01:00
gdb-pt-dump@ebdc24573a Bump gdb pt dump (#1205) 2022-12-07 04:47:37 +01:00
profiling Add support for performance profiling (#1413) 2022-12-05 17:49:00 +01:00
pwndbg Correct largebin size lookups on i386 (#1623) 2023-03-15 20:29:55 +01:00
tests Add print all chunks in vis_heap_chunks (#1604) 2023-03-07 22:58:39 +01:00
.gitignore ai tool now uses ChatGPT model (#1614) 2023-03-09 02:32:34 +01:00
.gitmodules hack-pt-dump 2022-07-28 04:10:07 +02:00
DEVELOPING.md TLS related enhancements (#1536) 2023-01-25 06:19:39 +01:00
Dockerfile Fix plt and gotplt commands (#1576) 2023-02-20 18:49:44 +01:00
Dockerfile.arch Support Arch Linux docker test (#1378) 2022-11-22 19:21:40 +01:00
FEATURES.md Add Documentation for Rizin 2023-02-15 16:14:51 +00:00
LICENSE.md license 2015-03-11 03:29:11 -07:00
README.md Add CI badge (#1396) 2022-11-27 16:25:09 -08:00
dev-requirements.txt Add rich into dev-requirements.txt 2023-02-16 03:27:25 +00:00
docker-compose.yml Support Arch Linux docker test (#1378) 2022-11-22 19:21:40 +01:00
gdbinit.py Fix plt and gotplt commands (#1576) 2023-02-20 18:49:44 +01:00
ida_script.py Linting/formatting improvements (#1138) 2022-09-09 04:46:46 +02:00
lint.sh lint.sh: vermin -vvv instead of -vvvv (#1556) 2023-01-30 21:46:38 +01:00
mkdocs.yml GPT-3 Command for Pwndbg (#1589) 2023-02-23 10:31:17 +01:00
pyproject.toml Ignore missing `rich` module for mypy 2023-02-16 03:27:25 +00:00
requirements.txt GPT-3 Command for Pwndbg (#1589) 2023-02-23 10:31:17 +01:00
setup-dev.sh Add qemu tests to CI 2023-01-25 03:32:17 -08:00
setup.cfg Add flake8-builtins to linters (#1254) 2022-10-09 00:03:22 +02:00
setup.sh Improve installation process (#1620) 2023-03-15 20:30:24 +01:00
tests.sh tests.sh: check for parallel_env requirement (closes #1606) (#1607) 2023-03-06 03:04:11 +01:00

README.md

pwndbg

license Unit tests Discord

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 2022 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:

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

Pwndbg is supported on Ubuntu 18.04, 20.04, and 22.04 with GDB 8.1 and later. We do not test on any older versions of Ubuntu, so pwndbg may not work on these versions. We may accept pull requests fixing issues in older versions on a case by case basis, please discuss this with us on Discord first. You can also always checkout an older version of pwndbg from around the time the Ubuntu version you're interested in was still supported by Canonical, or you can attempt to build a newer version of GDB from source.

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. You can build it as:

cd <gdb-sources-dir>
mkdir build
cd build
../configure --disable-nls --disable-werror --with-system-readline --with-python=`which python3` --with-system-gdbinit=/etc/gdb/gdbinit --enable-targets=all
make -j7

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!

How to develop?

To run tests locally you can do this in docker image, after cloning repo run simply

docker-compose run main ./tests.sh

Disclaimer - this won't work on apple silicon macs.

Contact

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