https://github.com/ancat/python-pin

Python bindings for pin.
https://github.com/ancat/python-pin

c-plus-plus pintool python-pin reverse-engineering

Last synced: about 1 month ago
JSON representation

Python bindings for pin.

• Host: GitHub
• URL: https://github.com/ancat/python-pin
• Owner: ancat
• Created: 2014-08-21T05:35:52.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2015-01-17T18:40:18.000Z (almost 10 years ago)
• Last Synced: 2023-08-07T02:37:36.383Z (over 1 year ago)
• Topics: c-plus-plus, pintool, python-pin, reverse-engineering
• Language: C++
• Size: 461 KB
• Stars: 4
• Watchers: 3
• Forks: 2
• Open Issues: 0
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
python-pin

==========

Python bindings for pin.

# TODO

1. Finish current sub groups

2. ~~Split into multiple files and master pin's makefile schema~~

3. Continue expanding Pin Python's functionality

4. Read Pythons reference counting information and implement into our Pin tool.

5. Unit tests! Every change has the potential to break other functionality in unexpected ways :{

# Build Instructions

Copy the entire directory into ~/pin/source/tools

Type make 

When make completes run ../../../pin -t obj-intel64/Python_Pin.so -- /bin/ls and ensure the output is correct

Enjoy!

Protip: `while [ 1 == 1 ]; do inotifywait -e close_write *.cpp *.h; make; done` Leave running in another tmux pane. Whenever any file is modified, the pintool is automatically recompiled. Run `touch *.cpp *.h` and everything will be recompiled.

# Using the Extension

Most of pin's functionality is exposed via the `pin` module, internal to the pintool. Its implementation is very similar to the way gdb handles python extensions.

To run a specific python script, for example the strace script:

`../../../pin -t obj-intel64/Python_Pin.so -m examples/strace.py -- /bin/ls`

# Current Issues

1. ~~Modifying the Makefile is a huge pain. It needs to be made easier for distribution.~~

    - ~~This means everything has to be in the single, huge cpp file for now. And it has to be named MyPinTool.cpp.~~

    

2. Some Python modules are compiled as shared objects without symbols. These modules can't be loaded from within the python pin tool. (solution is to either not use those modules, or have a custom build of python alongside the pintool)