Skip to content

Latest commit

 

History

History
55 lines (34 loc) · 2.22 KB

map-generate-mapfile.md

File metadata and controls

55 lines (34 loc) · 2.22 KB
description title ms.date f1_keywords helpviewer_keywords ms.assetid
Learn more about: /MAP (Generate Mapfile)
/MAP (Generate Mapfile)
11/04/2016
/map
VC.Project.VCLinkerTool.MapFileName
VC.Project.VCLinkerTool.GenerateMapFile
mapfiles, creating linker
generate mapfile linker option
mapfile linker option
mapfiles, information about program being linked
MAP linker option
-MAP linker option
mapfiles, specifying file name
/MAP linker option
9ccce53d-4e36-43da-87b0-7603ddfdea63

/MAP (Generate Mapfile)

/MAP[:filename]

Arguments

filename
A user-specified name for the mapfile. It replaces the default name.

Remarks

The /MAP option tells the linker to create a mapfile.

By default, the linker names the mapfile with the base name of the program and the extension .map. The optional filename allows you to override the default name for a mapfile.

A mapfile is a text file that contains the following information about the program being linked:

  • The module name, which is the base name of the file

  • The timestamp from the program file header (not from the file system)

  • A list of groups in the program, with each group's start address (as section:offset), length, group name, and class

  • A list of public symbols, with each address (as section:offset), symbol name, flat address, and .obj file where the symbol is defined

  • The entry point (as section:offset)

The /MAPINFO option specifies additional information to be included in the mapfile.

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 > Debug property page.

  3. Modify the Generate Map File property.

To set this linker option programmatically

  1. See xref:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.GenerateMapFile%2A and xref:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.MapFileName%2A.

See also

MSVC linker reference
MSVC Linker Options