BL51 User's Guide

Generating a Listing File

The linker generates a listing file that provides information about each step in the link and locate process. This file contains information about the symbols and segments involved as well as:

• Filenames and other parameters specified on the command line.
• Filenames and module names of all processed modules.
• A memory allocation table which contains the location of the segments, the segment type, the location method, and the segment name. This table may be suppressed by specifying the NOMAP directive.
• The overlay map which shows the structure of the finished program and lists address information for the local data and bit segments of a function. The overlay map also lists all code segments for which overlayable segments exist. You may suppress the overlay map by specifying the NOMAP directive.
• A list of all PUBLIC symbols within a program.
• A list of all errors in segments and symbols. The error causes are listed at the end of the listing file.
• A list of all unresolved external symbols. An external symbol is unresolved if no corresponding public symbol exists in another input file. Each reference to an unresolved external symbol is listed in an error message at the end of the listing file.
• A symbol table which contains the symbol information from the input files. This information consists of the names of the MODULES, SYMBOLS, PUBLICS, and LINES. You may selectively suppress the symbolic information with linker controls.
• An alphabetically sorted cross reference report of all PUBLIC and EXTERN symbols in which the memory type and the module names that contain a reference to that symbol are displayed.
• Errors detected during the execution of the linker/locator are displayed on the screen as well as at the end of the listing file. Refer to Error Messages for a summary of the linker/locator errors and causes.

The following table describes all BL51 Linker directives that affect the listing file.