Pin
|
Enumerations | |
enum | LEVEL_PINCLIENT::UNDECORATION { LEVEL_PINCLIENT::UNDECORATION_COMPLETE, LEVEL_PINCLIENT::UNDECORATION_NAME_ONLY } |
Functions | |
SYM | LEVEL_PINCLIENT::SYM_Next (SYM x) |
SYM | LEVEL_PINCLIENT::SYM_Prev (SYM x) |
const string & | LEVEL_PINCLIENT::SYM_Name (SYM x) |
SYM | LEVEL_PINCLIENT::SYM_Invalid () |
BOOL | LEVEL_PINCLIENT::SYM_Valid (SYM x) |
BOOL | LEVEL_PINCLIENT::SYM_Dynamic (SYM x) |
BOOL | LEVEL_PINCLIENT::SYM_GeneratedByPin (SYM x) |
BOOL | LEVEL_PINCLIENT::SYM_IFuncImplementation (SYM x) |
BOOL | LEVEL_PINCLIENT::SYM_IFuncResolver (SYM x) |
ADDRINT | LEVEL_PINCLIENT::SYM_Value (SYM x) |
UINT32 | LEVEL_PINCLIENT::SYM_Index (SYM x) |
ADDRINT | LEVEL_PINCLIENT::SYM_Address (SYM x) |
string | LEVEL_PINCLIENT::PIN_UndecorateSymbolName (const string &symbolName, UNDECORATION style) |
Symbol objects provide information about function symbols in the application. See Symbols for more information.
You must call PIN_InitSymbols to make symbols available.
Can be accessed at instrumentation time and analysis time.
APIs from this group are available in any thread, including any internal thread spawned by the tool.
Iteration idioms:
// Forward pass over all symbols in an image for( SYM sym= IMG_RegsymHead(img); SYM_Valid(sym); sym = SYM_Next(sym) )
List of supported symbol name undecoration styles. Used in PIN_UndecorateSymbolName()
string LEVEL_PINCLIENT::PIN_UndecorateSymbolName | ( | const string & | symbolName, |
UNDECORATION | style | ||
) |
Undecorate symbol name.
Provides undecoration of C++ names and decorated C names. The behavior of this function
is compiler and OS specific.
The C++ mangled name is undecorated either to its full signature (UNDECORATION_COMPLETE style)
or to [scope::]name form (UNDECORATION_NAME_ONLY style).
Example of undecoration of symbol generated by Microsoft compiler in Windows:
Style Original name Undecorated name ===================== ================== ====================================== UNDECORATION_COMPLETE ?foo@ccc@@QAEPADH@Z public: char * __thiscall ccc::foo(int) UNDECORATION_NAME_ONLY ccc::foo
Symbol name decorated according to Windows IA32 C calling conventions is undecorated as follows:
_foo -> foo (__cdecl convention) _foo@4 -> foo (__stdcall convention) @foo@12 -> foo (__fastcall convention)
Example of undecoration of symbol generated by GCC compiler on Linux:
Style Original name Undecorated name ===================== ================== ====================================== UNDECORATION_COMPLETE _ZN1A7method1ERKSt6vectorIiSaIiEE A::method1(std::vector<int, std::allocator<int> > const&) UNDECORATION_NAME_ONLY A::method1
You should be careful if using this function, since some of the undecorated names it generates for symbols generated by the compiler may not be valid C++ symbol names. For example on Linux demangling can give names like construction vtable for std::istream-in-std::iostream
, or non-virtual thunk to std::strstream::~strstream()
, which are not valid C++ names.
[in] | symbolName | Decorated name |
[in] | style | Undecoration style, relevant only to C++ undecoration Values: UNDECORATION_COMPLETE undecorate to full signature UNDECORATION_NAME_ONLY undecorate to [scope::]name |
ADDRINT LEVEL_PINCLIENT::SYM_Address | ( | SYM | x | ) |
BOOL LEVEL_PINCLIENT::SYM_Dynamic | ( | SYM | x | ) |
BOOL LEVEL_PINCLIENT::SYM_GeneratedByPin | ( | SYM | x | ) |
BOOL LEVEL_PINCLIENT::SYM_IFuncImplementation | ( | SYM | x | ) |
BOOL LEVEL_PINCLIENT::SYM_IFuncResolver | ( | SYM | x | ) |
UINT32 LEVEL_PINCLIENT::SYM_Index | ( | SYM | x | ) |
SYM LEVEL_PINCLIENT::SYM_Invalid | ( | ) |
const string& LEVEL_PINCLIENT::SYM_Name | ( | SYM | x | ) |
SYM LEVEL_PINCLIENT::SYM_Next | ( | SYM | x | ) |
SYM LEVEL_PINCLIENT::SYM_Prev | ( | SYM | x | ) |
BOOL LEVEL_PINCLIENT::SYM_Valid | ( | SYM | x | ) |
ADDRINT LEVEL_PINCLIENT::SYM_Value | ( | SYM | x | ) |