Intel® C++ Compiler Classic Developer Guide and Reference

ID 767249
Date 12/16/2022
Public

A newer version of this document is available. Customers should click here to go to the newest version.

Document Table of 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.

NOTE:

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.