Chapter 8. The Assembly Listing

The listing contains program assembly language statements together with line numbers and page numbers, error messages, and a list of the symbols used in the program.

The listing of assembly language statements that generate machine code includes the hexadecimal address of memory locations used for the statement and the contents of these locations. Relocatable addresses are shown as offsets from the start of the section. To the left of the instruction, an "R" indicates a relocatable argument in this instruction, "X" indicates an external argument, "C" indicates a complex argument and "+" indicates macro expansion.

The assembler listing optionally includes an alphabetical listing of all symbols used in the program together with their values, absolute or relocatable type, word or byte or null type, section memory type, and public or external type. Optionally, a cross-reference of all symbol usage by source line number is given; the defining line number is preceded by a "-" dash.

The total number of errors and warnings, if any, is printed with the listing. Errors and warnings associated with assembly language statements are flagged with descriptive messages on the appropriate statement lines.

The opcode checksum, opcode byte count, input file, output file, chip type (see directive .chip, Section 2.9.4), and memory model (see control model, Section 2.10.27) are shown at end of listing. Note that the opcode checksum does not reflect the final opcode checksum, if any relocatable opcodes exist.