This documentation is archived and is not being maintained.

/PDB (Use Program Database)



A user-specified name for the program database (PDB) that the linker creates. It replaces the default name.


By default, when /DEBUG is specified, the linker creates a program database (PDB) which holds debugging information. The default file name for the PDB has the base name of the program and the extension .pdb.

Use /PDB:filename to specify the name of the PDB file. If /DEBUG is not specified, the /PDB option is ignored.

Incremental linking is suppressed if /PDB is not selected.

A PDB file can be up to 2GB.

If you create the PDB file with the /Zi) compiler option, it will create a PDB with a 4K page size. The linker's /PDB option creates a PDB file with a 1K page file size.

For more information, see .pdb Files as Linker Input.

To set this linker option in the Visual Studio development environment

  1. Open the project's Property Pages dialog box. For details, see Setting Visual C++ Project Properties.
  2. Click the Linker folder.
  3. Click the Debug property page.
  4. Modify the Generate Program Database File property.

To set this linker option programmatically

See ProgramDatabaseFile Property.

See Also

Setting Linker Options | Linker Options