/LINKREPRO (Link repro directory name)

Tells the linker or library tool to generate a link repro in a specified directory.

Syntax

/LINKREPRO:directory-name

Arguments

/LINKREPRO:directory-name
The user-specified directory to store the link repro in. Directory names that include spaces must be enclosed in double quotes.

Remarks

The /LINKREPRO option is used to create a link repro. It's a set of build artifacts that allow Microsoft to reproduce a problem that occurs at link time, or during library operations. It's useful for problems such as a backend crash involving Link-Time Code Generation (LTCG), an LNK1000 linker error, or a linker crash. The tool produces a link repro when you specify the /LINKREPRO linker option, or when you set the link_repro environment variable in your command-line build environment. For more information, see the Link repros section of How to report a problem with the Microsoft C++ toolset.

Both the /LINKREPRO linker option and the link_repro environment variable require you to specify an output directory for the link repro. On the command line or in the IDE, specify the directory by using a /LINKREPRO:directory-name option. The directory-name you specify may be an absolute or relative path, but the directory must exist. The command-line option overrides any directory value set in the link_repro environment variable.

For information on how to limit link repro generation to a specific target file name, see the /LINKREPROTARGET option. This option can be used to specify a specific target to generate a link repro for. It's useful in complex builds that invoke the linker or library tool more than once.

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 > Command Line property page.

  3. Enter the /LINKREPRO:directory-name option in the Additional Options box. The directory-name value you specify must exist. Choose OK to apply the change.

Once you've generated the link repro, open this property page again to remove the /LINKREPRO option from your builds.

To set this linker option programmatically

See also

MSVC linker reference
MSVC linker options
/LINKREPROTARGET