Dumping Profile Information
_PGOPTI_Prof_Dump_All()function dumps the profile information collected by the instrumented application. The prototype of the function call is listed below.
An older version of this function,
_PGOPTI_Prof_Dump(), is deprecated and no longer used.
The new function,
_PGOPTI_Prof_Dump_All(), operates much like the deprecated function, except on Linux* operating systems, when it is used in connection with shared libraries (.so). When
_PGOPTI_Prof_Dump_All()is called, it insures that a .dyn file is created for all shared libraries needing to create a .dyn file. Use
_PGOPTI_Prof_Dump_All()on Linux OS to insure portability and correct functionality.
The profile information is generated in a
.dynfile (generated in phase 2 of PGO).
The environment variables that affect the
, and COV_DPI. Set the
COV_DIRenvironment variable to specify the directory to which the .dyn file must be stored. Alternately, you can use the
–[Q]prof_dircompiler option, when building with
-[Q]prof-gen, to specify this directory without setting the
COV_DIRvariable. Set the
COV_DPIenvironment variables to specify an alternative .dpi filename. The default filename is
pgopti.dpi.You can also use the
–prof_dpiprofmerge tool option, when merging the .dyn files, to specify the filename for the summary .dpi file.
If your application does not use a standard exit() call, insert a single call to this function in the body of the function that terminates the user application. Normally,
_PGOPTI_Prof_Dump_All()should be called just once.