Metadata-Version: 2.0
Name: python-ptrace
Version: 0.7
Summary: python binding of ptrace
Home-page: http://bitbucket.org/haypo/python-ptrace/wiki/Home
Author: Victor Stinner
Author-email: UNKNOWN
License: GNU GPL v2
Download-URL: http://bitbucket.org/haypo/python-ptrace/wiki/Home
Platform: UNKNOWN
Classifier: Intended Audience :: Developers
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: License :: OSI Approved :: GNU General Public License (GPL)
Classifier: Operating System :: OS Independent
Classifier: Natural Language :: English
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3

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.

Changelog
=========

python-ptrace 0.7 (2013-03-05)
------------------------------

* Experimental support of Python 3.3 in the same code base
* Drop support of Python 2.5
* Remove the ptrace.compatibility module
* Fix Process.readStruct() and Process.readArray() on x86_64
* Experimental support of ARM architecture (Linux EAPI),
  strace.py has been tested on Raspberry Pi (armv6l)

python-ptrace 0.6.6 (2013-12-16)
--------------------------------

* Fix os_tools.RUNNING_LINUX for Python 2.x compiled on Linux kernel 3.x
* Support FreeBSD on x86_64
* Add missing prototype of the unlinkat() system call. Patch written by
  Matthew Fernandez.

python-ptrace 0.6.5 (2013-06-06)
--------------------------------

* syscall: fix parsing socketcall on Linux x86
* syscall: fix protoype of socket()

python-ptrace 0.6.4 (2012-02-26)
--------------------------------

* Convert all classes to new-style classes, patch written by teythoon
* Fix compilation on Apple, patch written by Anthony Gelibert
* Support GNU/kFreeBSD, patch written by Jakub Wilk
* Support sockaddr_in6 (IPv6 address)

python-ptrace 0.6.3 (2011-02-16)
--------------------------------

* Support distrom3
* Support Python 3
* Rename strace.py option --socketcall to --socket, and fix this option for
  FreeBSD and Linux/64 bits
* Add MANIFEST.in: include all files in source distribution (tests, cptrace
  module, ...)

python-ptrace 0.6.2 (2009-11-09)
--------------------------------

* Fix 64 bits sub registers (set mask for eax, ebx, ecx, edx)

python-ptrace 0.6.1 (2009-11-07)
--------------------------------

* Create follow, showfollow, resetfollow, xray commands in gdb.py. Patch
  written by Dimitris Glynos
* Project website moved to http://bitbucket.org/haypo/python-ptrace/
* Replace types (u)intXX_t by c_(u)intXX
* Create MemoryMapping.search() method and MemoryMapping now keeps a weak
  reference to the process

python-ptrace 0.6 (2009-02-13)
------------------------------

User visible changes:

* python-ptrace now depends on Python 2.5
* Invalid memory access: add fault address in the name
* Update Python 3.0 conversion patch
* Create -i (--show-ip) option to strace.py: show instruction pointer
* Add a new example (itrace.py) written by Mark Seaborn and based
  on strace.py

API changes:

* PtraceSyscall: store the instruction pointer at syscall enter (if the
  option instr_pointer=True, disabled by default)
* Remove PROC_DIRNAME and procFilename() from ptrace.linux_proc

Bugfixes:

* Fix locateProgram() for relative path
* Fix interpretation of memory fault on MOSVW instruction (source is ESI and
  destination is EDI, and not the inverse!)

python-ptrace 0.5 (2008-09-13)
------------------------------

Visible changes:

* Write an example (the most simple debugger) and begin to document the code
* gdb.py: create "dbginfo" command
* Parse socket syscalls on FreeBSD
* On invalid memory access (SIGSEGV), eval the dereference expression to get
  the fault address on OS without siginfo (eg. FreeBSD)
* Fixes to get minimal Windows support: fix imports, fix locateProgram()

Other changes:

* Break the API:
  - Rename PtraceDebugger.traceSysgood() to PtraceDebugger.enableSysgood()
  - Rename PtraceDebugger.trace_sysgood to PtraceDebugger.use_sysgood
  - Remove PtraceProcess.readCode()
* Create createChild() function which close all files except stdin,
  stdout and stderr
* On FreeBSD, on process exit recalls waitpid(pid) to avoid zombi process


python-ptrace 0.4.2 (2008-08-28)
--------------------------------

* BUGFIX: Fix typo in gdb.py (commands => command_str), it wasn't possible to
  write more than one command...
* BUGIFX: Fix typo in SignalInfo class (remove "self."). When a process
  received a signal SIGCHLD (because of a fork), the debugger exited because
  of this bug.
* BUGFIX: Debugger._wait() return abnormal process exit as a normal event,
  the event is not raised as an exception
* PtraceSignal: don't clear preformatted arguments (eg. arguments of execve)

python-ptrace 0.4.1 (2008-08-23)
--------------------------------

* The project has a new dedicated website: http://python-ptrace.hachoir.org/
* Create cptrace: optional Python binding of ptrace written in C (faster
  than ptrace, the Python binding written in Python with ctypes)
* Add name attribute to SignalInfo classes
* Fixes to help Python 3.0 compatibility: don't use sys.exc_clear()
  (was useless) in writeBacktrace()
* ProcessState: create utime, stime, starttime attributes

python-ptrace 0.4.0 (2008-08-19)
--------------------------------

Visible changes:

* Rename the project to "python-ptrace" (old name was "Ptrace)
* strace.py: create --ignore-regex option
* PtraceSignal: support SIGBUS, display the related registers and
  the instruction
* Support execve() syscall tracing

Developer changes:

* New API is incompatible with 0.3.2
* PtraceProcess.waitProcessEvent() accepts optional blocking=False argument
* PtraceProcess.getreg()/setreg() are able to read/write i386 and x86-64
  "sub-registers" like al or bx
* Remove iterProc() function, replaced by openProc() with explicit
  call to .close() to make sure that files are closed
* Create searchProcessesByName()
* Replace CPU_PPC constant by CPU_POWERPC and create CPU_PPC32 and CPU_PPC64
* Create MemoryMapping object, used by readMappings() and findStack() methods
  of PtraceProcess
* Always define all PtraceProcess methods but raise an error if the function
  is not implemented



