prof-gen, Qprof-gen

Produces an instrumented object file that can be used in profile-guided optimization.

IDE Equivalent

Windows: General > Profile Guided Optimization

General > Code Coverage Build Options

Linux: None

Mac OS X: None

Architectures

IA-32, Intel® 64 architectures

Syntax

Linux and Mac OS X:

-prof-gen[=keyword]

-no-prof-gen

Windows:

/Qprof-gen[:keyword]

/Qprof-gen-

Arguments

keyword

Specifies details for the instrumented file. Possible values are:

default	Produces an instrumented object file. This is the same as specifying -prof-gen (Linux* and Mac OS* X) or /Qprof-gen (Windows*) with no keyword.
srcpos	Produces an instrumented object file that includes extra source position information. This option is the same as option -prof-genx (Linux* and Mac OS* X) or /Qprof-genx (Windows*), which are deprecated.
globdata	Produces an instrumented object file that includes information for global data layout.

Default

-no-prof-gen or /Qprof-gen-

Profile generation is disabled.

Description

This option produces an instrumented object file that can be used in profile-guided optimization. It gets the execution count of each basic block.

If you specify keyword srcpos or globdata, a static profile information file (.spi) is created. These settings may increase the time needed to do a parallel build using -prof-gen, because of contention writing the .spi file.

These options are used in phase 1 of the Profile Guided Optimizer (PGO) to instruct the compiler to produce instrumented code in your object files in preparation for instrumented execution.

Alternate Options

None