Pybag


Introduction
============

Pybag combines MS DebugEngine bindings with additional helper functions for a
powerful Windows debugging module.


Install
=======

Prerequisites must already be installed.  Paths might need to be
adjusted in __init__.py and setup.py

    
    python setup.py install

Or download a release package and install.

Requires
========

* Python 2.7
* Distorm3
* Windows Software Development Kit (SDK) for Windows 8.1
** Debugging Tools
** Headers and Libraries
* Visual Studio 9 (only if building from source)



Run
===

c:\>python 
>>> import pybag
>>> dbg = pybag.pywindbg.Userdbg()
>>> dbg.create('calc.exe')
>>> dbg.cmd('.symfix')
>>> dbg.cmd('.reload')
>>> dbg.go()
    
    *** hit contrl-c to break ***

>>> dbg.peb()
>>> help(dbg)




TODO
====

- Dynamically resolve install path for SDK
- Replace pefile
- Add some tests
- Kernel debugging
- Remote debugging using dbgsrv
- More helper functions
- Better examples