#Intel Pin Tools basic usage
下載 Intel Pin Tools
解壓縮就可以使用 不用另外安裝
將解壓縮出來的資料夾 加入 $PATH
pin 是 intel 開發的一個 binary analysis framework
支援 x86/x64 & windows/linux/mac
pin 提供許多分析 binary 用的 api
使用者可以用 C/C++ 呼叫 api 來撰寫自己的 pintool
source/tools 是 pintools 的預設路徑
底下已經有一些現成 pintools 可以使用
根據 README 的步驟來操作:
cd source/tools/SimpleExamples
make obj-ia32/opcodemix.so
// 編完的 pintool 是一個 share object 存在 obj-ia32 底下
pin -t obj-ia32/opcodemix.so -- /bin/ls
// 用 pintool 分析 /bin/ls
分析結果在 opcodemix.out
複製 source/tools/MyPinTool 稍作修改
MyPinTool.cpp: 主要的程式碼 撰寫自己要對 binary 做的分析行為
makefile: 理論上不需要更改到 makefile
makefile.rule: 覆寫編譯時的設定 客製化自己的需求
簡單介紹一下 sample code 用到的 function
Knob
: 這個類別指的是執行 pin 指令時的參數, 可以自訂一些預設值
PIN_init()
: 將執行參數傳遞給 pin tool
INS
: INS 類別代表 asm 指令
INS_AddInstrumentFunction
: 定義分析 INS 的 callback
TRACE
: TRACE 類別是 JIT 時分析定義的一種指令區塊 有一個進入點和數個離開點
TRACE_AddInstrumentFunction
: 定義 TRACE 的 callback
PIN_AddThreadStartFunction
: 定義偵測到有另一個 thread start 的 callback
PIN_AddFiniFunction
: 定義程式結束的 callback
PIN_StartProgram
: 程式開始
PIN 的詳細文件可以參考: Pin 2.14 User Guide