Skip to content

Latest commit

 

History

History
54 lines (33 loc) · 3.05 KB

useprofile.md

File metadata and controls

54 lines (33 loc) · 3.05 KB
descriptiontitlems.datef1_keywords
Learn more about: /USEPROFILE (Run PGO in thread safe mode)
/USEPROFILE (Use PGO data with LTCG)
03/24/2025
USEPROFILE

/USEPROFILE (Run PGO in thread safe mode)

This linker option together with /LTCG (Link-time code generation tells the linker to build by using profile-guided optimization (PGO) training data.

Syntax

/USEPROFILE[:{AGGRESSIVE|PGD=filename}]

Arguments

AGGRESSIVE
This optional argument specifies that aggressive speed optimizations should be used during optimized code generation.

PGD=filename
Specifies a base filename for the .pgd file. By default, the linker uses the base executable filename with a .pgd extension. When expanded, the fully qualified filename must not exceed MAX_PATH (260 characters).

Remarks

The /USEPROFILE linker option is used together with /LTCG to generate or update an optimized build based on PGO training data. It is the equivalent of the deprecated /LTCG:PGUPDATE and /LTCG:PGOPTIMIZE options.

The optional AGGRESSIVE argument disables size-related heuristics to attempt to optimize for speed. This may result in optimizations that substantially increase the size of your executable, and may not increase the resulting speed. You should profile and compare the results of using and not using AGGRESSIVE. This argument must be specified explicitly; it is not enabled by default.

The PGD argument specifies an optional name for the training data .pgd file to use, the same as in /GENPROFILE or /FASTGENPROFILE. It is the equivalent of the deprecated /PGD switch. By default, or if no filename is specified, a .pgd file that has the same base name as the executable is used.

The /USEPROFILE linker option is new in Visual Studio 2015.

To set this linker option in the Visual Studio development environment

  1. Open the project's Property Pages dialog box. For details, see Set C++ compiler and build properties in Visual Studio.

  2. Select the Configuration Properties > Linker > Optimization property page.

  3. In the Link Time Code Generation property, choose Use Link Time Code Generation (/LTCG).

  4. Select the Configuration Properties > Linker > Command Line property page.

  5. Enter the /USEPROFILE option and optional arguments into the Additional Options box. Choose OK to save your changes.

To set this linker option programmatically

  • See xref:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.AdditionalOptions%2A.

See also

/GENPROFILE and /FASTGENPROFILE
/LTCG
Profile-Guided Optimizations
Environment Variables for Profile-Guided Optimizations

close