Developer Guide and Reference

Contents

Resetting Profile Information

The
_PGOPTI_Prof_Reset_All()
function clears the profile information collected by the instrumented application. The prototype of the function call is listed below.
During a run of an instrumented executable, a segment is maintained for each routine executed during that run, storing the following information:
  • Number of times each basic block in the routine is executed
  • Specific values observed at each data point undergoing value-profiling
  • Number of times each of these values are observed
When the _PGOPTI_Prof_Reset() function is called, the basic block execution count for each basic block is set to 0, and the value-profiling information is reset to indicate that no values were observed at any data point.
Syntax
void _PGOPTI_Prof_Reset_All(void);
The older version of this function,
_PGOPTI_Prof_Reset()
, is deprecated.
When
_PGOPTI_Prof_Reset_All()
function is called, it insures that all the counters within the main application and all the instrumented shared libraries are cleared. All the counters for block execution counts and value profiling information is reset to 0.
For routines that were in progress when the reset call was made, the counts for portions of the routine that executed following the call to the reset function may have higher counts than portions of the routine that executed prior to the reset call.