The Profile Information Generation Support (Profile IGS) enables you to control the generation of profile information during the instrumented execution phase of profile-guided optimizations.
Normally, profile information is generated by an instrumented application when it terminates by calling the standard exit() function.
To ensure that profile information is generated, the functions described in this section may be necessary or useful in the following situations:
The instrumented application exits using a non-standard exit routine.
The instrumented application is a non-terminating application: exit() is never called.
The application requires control of when the profile information is generated.
A set of functions and an environment variable comprise the Profile IGS.
The Profile IGS functions are available to your application by inserting a header file at the top of any source file where the functions may be used.
#include "pgouser.h"
The Profile IGS functions are written in C language. Fortran applications need to call C functions.
The rest of the topics in this section describe the Profile IGS functions.
Without instrumentation, the Profile IGS functions cannot provide PGO API support.
The environment variable for Profile IGS is PROF_DUMP_INTERVAL. This environment variable may be used to initiate Interval Profile Dumping in an instrumented user application. See the recommended usage of _PGOPTI_Set_Interval_Prof_Dump() for more information.