python-ptrace / README

python-ptrace is a Python binding of ptrace library.

The binding works on:

 * Linux version 2.6.20 on i386, x86_64, PPC (may works on Linux 2.4.x
   and 2.6.x)
 * Linux version 2.4 on PPC
 * FreeBSD version 7.0RC1 on i386 (may works on FreeBSD 5.x/6.x)
 * OpenBSD version 4.2 on i386

Features:

 * High level Python object API : !PtraceDebugger and !PtraceProcess
 * Able to control multiple processes: catch fork events on Linux
 * Read/write bytes to arbitrary address: take care of memory alignment and
   split bytes to cpu word
 * Execution step by step using ptrace_singlestep() or hardware interruption 3
 * Can use distorm (http://www.ragestorm.net/distorm/) disassembler
 * Dump registers, memory mappings, stack, etc.
 * Syscall tracer and parser (strace command)

Website: http://bitbucket.org/haypo/python-ptrace/wiki/Home


Installation
============

Read INSTALL documentation file.

Documentation
=============

Browse doc/ and examples/ directories.
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.