On-demand system call tracing for Python programs.
Project description
Ptracer is a library providing on-demand system call tracing in Python programs.
Basic Usage
import traceback
import ptracer
def callback(syscall):
print('{}({}) -> {}'.format(
syscall.name,
', '.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')
Filtering
Ptracer allows elaborate syscall filtering via the filter argument:
flt = [
ptracer.SysCallPattern(
name='open',
args=[
re.compile(b'/tmp/.*'),
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.
Documentation
The documentation is available on ptracer.readthedocs.io.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
ptracer-0.6.1.tar.gz
(33.5 kB
view hashes)
Built Distribution
Close
Hashes for ptracer-0.6.1-cp39-cp39-macosx_12_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | bd71f235bb4bb842984eced02efb3baf9bf33911fadd015c13b253d407d9c725 |
|
MD5 | cfb9a718082d0e31b9e90c51ba662c4d |
|
BLAKE2b-256 | 2e479bf3edb27e36bf6aa739e98c2e8301e8c0108a4fa3bf9b211a7023f1d7af |