Need help with ptracer?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

138 Stars 19 Forks Apache License 2.0 22 Commits 0 Opened issues


A library for ptrace-based tracing of Python programs

Services available


Need anything else?

Contributors list

ptracer -- a library for ptrace-based tracing of Python programs

Ptracer is a library providing on-demand system call tracing in Python programs.

Basic Usage

.. code-block:: python

import traceback
import ptracer

def callback(syscall): print('{}({}) -> {}'.format(, ', '.join(repr(arg.value) for arg in syscall.args), syscall.result.text)) print('Traceback: ') print(''.join(traceback.format_list(syscall.traceback)))

with ptracer.context(callback): open('/dev/null', 'wb')


Ptracer allows elaborate syscall filtering via the filter argument:

.. code-block:: python

flt = [
            lambda arg: arg.value & os.O_WRONLY
        result=lambda res: res.value > 0

with ptracer.context(callback, filter=flt): # traced code ...

In the above example, ptracer will invoke the callback only for successful attempts to open files in the "/tmp" directory for writing.


The documentation is available on 

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.