Miscellaneous functions

Defines
#define	PIN_PRODUCT_VERSION_MAJOR   2
#define	PIN_PRODUCT_VERSION_MINOR   6
#define	PIN_BUILD_NUMBER   27887
Functions
CHAR *	LEVEL_BASE::GetCmdArg (const CHAR *cmdPtr, BOOL isFile, CHAR *buf, size_t bufSize, size_t *pArgSize, const CHAR **pNextPtr)
CHAR *	LEVEL_BASE::GetAppCmdLine (const CHAR *pinCmdLine)
VOID	LEVEL_PINCLIENT::GetVmLock ()
VOID	LEVEL_PINCLIENT::ReleaseVmLock ()

---

Define Documentation

#define PIN_BUILD_NUMBER   27887

The Pin kit build number. This is unique for every Pin kit.

#define PIN_PRODUCT_VERSION_MAJOR   2

The Pin major version number. E.g. "2" if the kit is "2.6".

#define PIN_PRODUCT_VERSION_MINOR   6

The Pin minor version number. E.g. "6" if the kit is "2.6".

---

Function Documentation

CHAR* LEVEL_BASE::GetAppCmdLine (  const CHAR *  pinCmdLine  )

Given pin's command line, return substring containing application's command line. Parameters: [in]  pinCmdLine  command line of pin exe process. Returns: pointer to substring containing application's command line; NULL, if application's command line is not found

CHAR* LEVEL_BASE::GetCmdArg (  const CHAR *  cmdPtr, BOOL  isFile, CHAR *  buf, size_t  bufSize, size_t *  pArgSize, const CHAR **  pNextPtr )

Given a command line (sub)string, find and parse its first argument. Parsing rules (see MS CRT): File names =========== Quoted string -> non-quoted string (quotes are not copied) Regular argument ================ 2N backslashes + " -> N backslashes + begin/end quoted string (quote is not copied) 2N+1 backslashes + " -> N backslashes + literal " " + " in a quoted string -> single literal " all other combinations of symbols are copied as is Parameters: [in]  cmdPtr  pointer to the command line (sub)string [in]  isFile  TRUE - use parsing rules for file name FALSE - use parsing rules for regular argument [out]  buf  buffer that receives argument after parsing. If this parameter is NULL, the argument is not copied. If the buffer is too small, the terminating NULL is not copied into the buffer. [in]  bufSize  size of the buffer; ignored if <buf> is NULL. [out]  pArgSize  pointer to variable that receives size of the argument to be copied into the buffer, not including terminating NULL. If this parameter is NULL, the argument size is not returned. Otherwise, the size value is returned even if <buf> is NULL. [out]  pNextPtr  pointer to variable that receives pointer to the command line substring following the found attribute. If this parameter is NULL, the pointer is not returned. Returns: pointer to the first argument found in the specified command line (sub)string or NULL.

VOID LEVEL_PINCLIENT::GetVmLock (   )

Get the vm lock. Availability: Mode: JIT O/S: Linux, Windows & MacOS CPU: All

VOID LEVEL_PINCLIENT::ReleaseVmLock (   )

Release the vm lock. Availability: Mode: JIT O/S: Linux, Windows & MacOS CPU: All

---