nteseyes/pylane

An python vm injector with debug tools, based on gdb.

pylane

简体中文

Pylane is a python vm injector with debug tools, based on gdb and ptrace. Pylane uses gdb to trace python process, inject and run some code in its python vm.

Usage

use inject command to inject a python script in an process:

pylane inject <PID> <YOUR_PYTHON_FILE>

use shell command to inject an interactive shell:

pylane shell <PID>

Pylane shell features:

• use IPython as its interactive interface, support magic functions like ? and %
• support remote automatic completion
• provide debug toolkit functions, such as:
  • lookup class or instance by name
  • get source code of an object
  • print all threads' stack and locals

Install

pip install pylane

pylane should be installed in virtualenv the target process uses or in os python lib.

Compatibility

Support Linux and BSD

pylane's Issues

Got Segmentation fault when attach a running progress.

OS: Linux rqams 3.10.0-862.11.6.el7.x86_64 #1 SMP Tue Aug 14 21:49:04 UTC 2018 x86_64 x86_64 x86_64 GNU/Linux

GDB: GNU gdb (GDB) Red Hat Enterprise Linux 7.6.1-114.el7

Python version: 3.7.3

I tried to attach a running python progress, but the progress terminated with a Segmentation fault.

The IPython and click version in setup.py should not be fixed

Please merge pull requests of #7

And update pypi package

Fails to check PID in Mac OS

Can't use it in docker container.

root@Q01:/gw_re_processor# pylane shell 6

('ptrace is disabled, enable it by: echo 0 | sudo tee /proc/sys/kernel/yama/ptrace_scope',)

root@Q01:/gw_re_processor# echo 0 | tee /proc/sys/kernel/yama/ptrace_scope

tee: /proc/sys/kernel/yama/ptrace_scope: Read-only file system