SYM: Symbol Object

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)
ADDRINT	LEVEL_PINCLIENT::SYM_Value (SYM x)
UINT32	LEVEL_PINCLIENT::SYM_Index (SYM x)

---

Detailed Description

SYMs are derived from ELF symbol records.

You must call PIN_InitSymbols to make symbols available.

Can be accessed at instrumentation time and analysis time.

Iteration idioms:

  // Forward pass over all symbols in an image
  for( SYM sym= IMG_RegsymHead(img); SYM_Valid(sym); sym = SYM_Next(sym) )

---

Function Documentation

BOOL LEVEL_PINCLIENT::SYM_Dynamic (  SYM  x  )

Returns: True if x is a dynamic symbol

UINT32 LEVEL_PINCLIENT::SYM_Index (  SYM  x  )

Returns: section index of a symbol

SYM LEVEL_PINCLIENT::SYM_Invalid (   )

Returns: Used to indicate no symbol

const string& LEVEL_PINCLIENT::SYM_Name (  SYM  x  )

Returns: Name of symbol

SYM LEVEL_PINCLIENT::SYM_Next (  SYM  x  )

Returns: Routine that follows x, or SYM_Invalid() if x is the last in the section

SYM LEVEL_PINCLIENT::SYM_Prev (  SYM  x  )

Returns: Routine that precedes x, or SYM_Invalid() if x is the first in the section

BOOL LEVEL_PINCLIENT::SYM_Valid (  SYM  x  )

Returns: True if x is not SYM_Invalid()

ADDRINT LEVEL_PINCLIENT::SYM_Value (  SYM  x  )

Returns: Value of symbol, usually an address relative to beginning of image

---