Edit

Share via

/NATVIS (Add Natvis to PDB)

  • Article

Specifies a debugger visualization file (a Natvis file) to embed in the PDB file generated by the linker.

Syntax

/NATVIS:filename

Parameters

filename
The pathname for a Natvis file to add to the PDB file. It embeds the debugger visualizations in the Natvis file into the PDB.

Remarks

The /NATVIS linker option embeds the debugger visualizations defined in the Natvis file filename into the PDB file generated by LINK. A Natvis file has a .natvis extension. Embedding the information allows the debugger to display the visualizations independently of the Natvis file. You can use multiple /NATVIS options to embed more than one Natvis file in the generated PDB file. For more information on how to create and use Natvis files, see Create custom views of native objects in the Visual Studio debugger.

LINK ignores /NATVIS when a PDB file isn't created by using a /DEBUG option.

To set this linker option in the Visual Studio development environment

  1. Open the project's Property Pages dialog box. For more information, see Set compiler and build properties.

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

  3. Add the /NATVIS option to the Additional Options text box. Choose OK or Apply to save your changes.

To set this linker option programmatically

See also

MSVC linker reference
MSVC linker options