Skip to content

ancat/python-pin

Folders and files

NameName
Last commit message
Last commit date

Latest commit

author
OMAR
Jan 17, 2015
c2b3a59 · Jan 17, 2015

History

71 Commits
Jan 17, 2015
Oct 5, 2014
Aug 28, 2014
Oct 4, 2014
Oct 4, 2014
Jan 15, 2015
Nov 9, 2014
Nov 10, 2014
Oct 9, 2014
Nov 10, 2014
Nov 10, 2014
Jan 15, 2015
Oct 6, 2014
Aug 25, 2014
Aug 25, 2014
Aug 27, 2014
Aug 26, 2014
Aug 25, 2014
Nov 10, 2014
Nov 25, 2014
Nov 14, 2014

Repository files navigation

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)