prof-use, Qprof-use

Enables the use of profiling information during optimization.

IDE Equivalent

Windows: General > Profile Guided Optimization

Linux: None

Mac OS X: None

Architectures

IA-32, Intel® 64, IA-64 architectures

Syntax

Linux and Mac OS X:

-prof-use[=arg]

-no-prof-use

Windows:

/Qprof-use[:arg]

/Qprof-use-

Arguments

arg

Specifies additional instructions. Possible values are:

weighted	Tells the profmerge utility to apply a weighting to the .dyn file values when creating the .dpi file to normalize the data counts when the training runs have differentexecution durations. This argument only has an effect when the compiler invokes the profmerge utility to create the .dpi file. This argument does not have an effect if the .dpi file was previously created without weighting.
[no]merge	Enables or disables automatic invocation of the profmerge utility. The default is merge. Note that you cannot specify both weighted and nomerge. If you try to specify both values, a warning will be displayed and nomerge takes precedence.
default	Enables the use of profiling information during optimization. The profmerge utility is invoked by default. This value is the same as specifying -prof-use (Linux and Mac OS X) or /Qprof-use (Windows) with no argument.

Default

-no-prof-use or /Qprof-use-

Profiling information is not used during optimization.

Description

This option enables the use of profiling information (including function splitting and function grouping) during optimization. It enables option -fnsplit (Linux) or /Qfnsplit (Windows).

This option instructs the compiler to produce a profile-optimized executable and it merges available profiling output files into a pgopti.dpi file.

Note that there is no way to turn off function grouping if you enable it using this option.

To set the hotness threshold for function grouping and function ordering, use option -prof-hotness-threshold (Linux) or /Qprof-hotness-threshold (Windows).

Alternate Options

None