函数
PIN_CALLBACK LEVEL_PINCLIENT::INS_AddinstrumentFucntion(INS_INSTRUMENT_CALLBACK fun, VOID *val)
VOID LEVEL_PINCLIENT::INS_InsertPredictedCall(INS ins, IPOINT ipoint, AFUNPTR funptr, ...)
VOID LEVEL_PINCLIENT::INS_InsertCall(INS ins, IPOINT action, AFUNPTR funptr, ...)
VOID LEVEL_PINCLIENT::INS_InsertIfCall(INS ins, IPOINT action, AFUNPTR funptr, ...)
VOID LEVEL_PINCLIENT::INS_InsertThenCall(INS ins, IPOINT action, AFUNCPTR funptr, ...)
VOID LEVEL_PINCLIENT::INS_InsertIfPredicatedCall(INS ins, IPOINT action, AFUNCPTR funptr, ...)
VOID LEVEL_PINCLIENT::INS_InsertThenPredicatedCall(INS ins, IPOINT action, AFUNCPTR funptr, ...)
VOID LEVEL_PINCLIENT::INS_InsertFillBuffer(INS ins, IPOINT action, BUFFER_ID, ...)
VOID LEVEL_PINCLIENT::INS_InsertFillBufferPredicated(INS ins, IPOINT action, BUFFER_ID id, ...)
VOID LEVEL_PINCLIENT::INS_InsertFillBufferThen(INS ins, IPOINT action, BUFFER_ID id, ...)
详细描述
使用这些函数插桩指令
函数文档
PIN_CALLBACK LEVEL_PINCLIENT::INS_AddInstrumentFunction( INS_INSTRUMENT_CALLBACK fun, VOID *val )
// 添加一个在指令粒度上的函数
参数值：
fun 插桩使用的函数
val 插桩函数 fun 的参数
返回值：
PIN_CALLBACK 回调的句柄，可用于进一步修改此回调的属性
注：
在调用这个API 的时候会获得Pin客户端锁
可用性：
Mode：JIT
O/S： Linux，Windows，& macOS*
CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertCall( INS ins, IPOINT action, AFUNPTR funptr, ...)
// 插入相对于指令ins的funptr调用
参数值：
ins 被插桩的指令
action 指定插桩位置，之前，之后等
IPOINT_BEFORE 对所有指令始终有效
IPOINT_AFTER 当fall-through存在时有效，仅当INS_IsValidForIpointAfter(ins)为true的时候可用
IPOINT_TAKEN_BRANCH 对于非分支无效，仅当INS_Is_ValidForIpointTakenBranch为true时可用
funptr 插入一个funptr的调用
... funptr的参数列表,以IARG_END结尾，查看IARG_TYPE了解细节
注：
如果对于同一个指令插入了多个调用，顺序由IARG_CALL_ORDER决定，更多细节，查看CALL_ORDER
可用性：
Mode：JIT
O/S： Linux，Windows，& macOS*
CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertFillBuffer( INS ins, IPOINT action, BUFFER_ID id, ...)
// 每当程序指令执行时，插入分析代码（即自定义代码）以在跟踪缓冲区中填充一条记录
参数值：
[in] ins 应用指令
[in] action 指明记录是插桩在指令之前还是之后
[in] id 被填充缓冲区ID
[in] ... IARG_TYPE. 用于指定跟踪缓冲区字段的其他参数，这些附加参数的格式为：IARG_TYPE arg, [可选IARG参数]，size_t offset,...,IARG_END 其中arg 参数指定要写入跟踪记录字段的值，offset指定跟踪记录开始位置到当前字段的偏移量，如果arg需要其他参数，放置在offset之前
可用性：
Mode：JIT
O/S： Linux，Windows，& macOS*
CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertFillBufferPredicated( INS ins, IPOINT action, BUFFER_ID id, ...)
// 插入分析代码，以便在应用程序指令执行是，根据该指令的谓语在跟踪缓冲区中填充一条记录
参数值：
[in] ins 应用指令
[in] action 记录是在指令之前填写还是之后填写
[in] id 被填充缓冲区的ID
[in] ... IARG_TYPE. 用于指定跟踪缓冲区的其他参数
可用性：
Mode：JIT
O/S： Linux，Windows，& macOS*
CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertFillBufferThen( INS ins, IPOINT action, BUFFER_ID id, ...)
// 每当应用指令执行时，插入分析代码以在跟踪缓冲区中填充一条记录。仅当 前面的“if”语句分析调用返回值非零时才插入记录。
参数值：
[in] ins 应用指令
[in] action 记录是在指令之前填写还是之后填写
[in] id 被填充缓冲区的ID
[in] ... IARG_TYPE. 用于指定跟踪缓冲区的其他参数
可用性：
Mode：JIT
O/S： Linux，Windows，& macOS*
CPU： ALL
VOID LEVEL_PINCLIENT::INS_InsertIfCall( INS ins, IPOINT action, AFUNPTR funptr, ...)
// 插入相对于ins的funptr调用， 如果funptr返回一个非零ADDRINT，则执行紧接着的then分析调用。
参数值：
ins 被插桩指令
action 指定插桩位置，之前，之后等
IPOINT_BEFORE 对所有指令始终有效
IPOINT_AFTER 当fall-through存在时有效，仅当INS_IsValidForIpointAfter(ins)为true的时候可用
IPOINT_TAKEN_BRANCH 对于非分支无效，仅当INS_Is_ValidForIpointTakenBranch为true时可用
funptr 插入一个funptr的调用，这个函数的返回值必须时ADDRINT类型
... 传递给funptr的从那书列表，以IARG_END结尾，查看IARG_TYPE了解更多
注：
如果为同一个指令插入多个调用，则顺序有IARG_CALL_ORDER决定，有关详细信息清参阅CALL_ORDER。 注意，如果使用CALL_ORDER，“if”和“then”分析调用必须具有相同的顺序。
可用性：
Mode：JIT
O/S： Linux，Windows，& macOS*
CPU： ALL