The /MAP Option

Option

/M[[AP]][[:{maptype}]]

The /MAP option controls the information contained in the map file. The /MAP option causes a map file to be created even if you did not explicitly tell the linker to do so.

LINK creates a map file when a filename is specified in the mapfile field or when the default map-file name is accepted. (The /LINE option also forces creation of a map file.) For more information, see the description of mapfile on topic .

A map file by default contains only a list of segments. A map file created with /MAP contains public symbols sorted by name and by address, in addition to the segments list. Symbols in C++ appear in the form of decorated names. To add or omit information, specify /MAP followed by a colon (:) and a maptype qualifier:

[[ADDRESS]]

Omits the list of public symbols sorted by name.

[[FULL]]

Adds information about each object file's contribution to a segment. Adds undecorated names following the decorated names for C++ symbols in the listings by name and by address.

If you also want to add line numbers to the map file, use the /LINE option.

By default, the map file is given the same base name as the executable file with the extension .MAP. You can override the default name by specifying a new map filename in the mapfile field or in response to the List File prompt.

Under some circumstances, adding symbols slows the linking process. If this is a problem, do not use /MAP.