2.4.3 Listing File

The assembler has the capability to produce an assembler list file. Since the list file is produced before the linker has executed, not all the addresses that appear in the list file will be absolute. Many will be relative to a section.

By default, the list file is displayed on the standard output. Specify the -a=file option (see 3 Assembler Command-Line Options) on the command line to send the output to a list file with the specified name.

A list file produced by the assembler is composed of the elements discussed below. Sample Assembler Listing File shows a sample listing file.