/MAP (Generate Mapfile)

 

The latest version of this topic can be found at -MAP (Generate Mapfile).

MAP[:filename]

  
## Remarks  
 where:  
  
 *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](../Topic/-MAPINFO%20\(Include%20Information%20in%20Mapfile\).md) 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 [Setting Visual C++ Project Properties](../Topic/Working%20with%20Project%20Properties.md).  
  
2.  Click the **Linker** folder.  
  
3.  Click the **Debug** property page.  
  
4.  Modify the **Generate Map File** property.  
  
### To set this linker option programmatically  
  
1.  See [GenerateMapFile](assetId:///P:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.GenerateMapFile?qualifyHint=False&autoUpgrade=True) and [MapFileName](assetId:///P:Microsoft.VisualStudio.VCProjectEngine.VCLinkerTool.MapFileName?qualifyHint=False&autoUpgrade=True).  
  
## See Also  
 [Setting Linker Options](../Topic/Setting%20Linker%20Options.md)   
 [Linker Options](../Topic/Linker%20Options.md)