You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: README.md
+2-17Lines changed: 2 additions & 17 deletions
Original file line number
Diff line number
Diff line change
@@ -3,25 +3,13 @@ python-pin
3
3
4
4
Python bindings for pin.
5
5
6
-
# TODO
7
-
8
-
1. Finish current sub groups
9
-
2.~~Split into multiple files and master pin's makefile schema~~
10
-
3. Continue expanding Pin Python's functionality
11
-
4. Read Pythons reference counting information and implement into our Pin tool.
12
-
5. Unit tests! Every change has the potential to break other functionality in unexpected ways :{
13
6
14
7
# Build Instructions
15
8
16
9
Copy the entire directory into ~/pin/source/tools
17
10
18
-
Type make
19
-
20
-
When make completes run ../../../pin -t obj-intel64/Python_Pin.so -- /bin/ls and ensure the output is correct
21
-
22
-
Enjoy!
11
+
Type make and enjoy!
23
12
24
-
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.
25
13
26
14
# Using the Extension
27
15
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.
@@ -32,8 +20,5 @@ To run a specific python script, for example the strace script:
32
20
33
21
# Current Issues
34
22
35
-
1.~~Modifying the Makefile is a huge pain. It needs to be made easier for distribution.~~
36
-
-~~This means everything has to be in the single, huge cpp file for now. And it has to be named MyPinTool.cpp.~~
37
-
38
-
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)
23
+
1. 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)
0 commit comments