vagd 0.3.1

VirtuAlization GDb integrations in pwntools

VAGD

VirtuAlization GDb integrations in pwntools

Installation

pip install vagd pwntools

or

pip install .
pip install -r requirements.txt

Usage

use python -m vagd to generate a template

# run as process in VM
./exploit.py
# run as gdb server in VM requires tmux
./exploit.py GDB
# run on remote IP:PORT
./exploit.py REMOTE

I recommend using pwndbg.

Files

All created files ares stored in the local ./.vagd/ directory. Additional large files (e.g. cloudimages) are stored in the home directory ~/.vagd/ or handled by tools themselfs (e.g. Vagrant, Docker).

Documentation

Boxes

the following boxes were tested and work, box constants are inside vagd.box.Box

• Vagrant

  • UBUNTU_JAMMY64 = 'ubuntu/jammy64'
  • UBUNTU_FOCAL64 = 'ubuntu/focal64'
  • UBUNTU_BIONIC64 = 'ubuntu/bionic64'
  • UBUNTU_XENIAL64 = 'ubuntu/xenial64'

• QEMU (cached in ~/.vagd/qemu-imgs)

  • CLOUDIMAGE_JAMMY
  • CLOUDIMAGE_FOCAL
  • CLOUDIMAGE_BIONIC
  • CLOUDIMAGE_XENIAL

currently only distributions that use apt are supported

Future plans

pre configured Vagrant boxes / QEMU Images / Docker Image

created pre configured Vagrant boxes with preinstalled lib debug symbols and gdbserver to lower init runtime.

Docker integration

created a Docker integration that allows loading existing Dockerfiles, also add a feature that additionally virtualizes (Vagrant/Qemu) them to change the used kernel.

SSH integration

Add a ssh integration to allows specifying a remote machine with hostname, port, user and keyfile. ssh config integration would be nice.