TMS320C28x Assembly Language
Tools
v17.6.0.STS User's Guide
SPRU513N - REVISED JUNE 2017
10 Cross-Reference Lister Description
The TMS320C28x cross-reference lister is a debugging tool. This utility accepts linked object files as input and produces a cross-reference listing as output. This listing shows symbols, their definitions, and their references in the linked source files.
10.1 Producing a Cross-Reference Listing
Figure 10-1 illustrates the steps required to produce a cross-reference listing.
10.2 Invoking the Cross-Reference Lister
To use the cross-reference utility, the file must be assembled with the correct options and then linked into an executable file. Assemble the assembly language files with the --cross_reference option. This option creates a cross-reference listing and adds cross-reference information to the object file. By default, the assembler cross-references only global symbols, but if the assembler is invoked with the --output_all_syms option, local symbols are also added. Link the object files to obtain an executable file.
To invoke the cross-reference lister, enter the following:
| xref2000 [options] [input filename [output filename]] |
|
xref2000 |
is the command that invokes the cross-reference utility. | |
| options | identifies the cross-reference lister options you want to use. Options are not case sensitive and can appear anywhere on the command line following the command. | |
| -l | (lowercase L) specifies the number of lines per page for the output file. The format of the -l option is -lnum, where num is a decimal constant. For example, -l30 sets the number of lines per page in the output file to 30. The space between the option and the decimal constant is optional. The default is 60 lines per page. | |
| -q | suppresses the banner and all progress information (run quiet). | |
| input filename | is a linked object file. If you omit the input filename, the utility prompts for a filename. | |
| output filename | is the name of the cross-reference listing file. If you omit the output filename, the default filename is the input filename with an .xrf extension. | |
10.3 Cross-Reference Listing Example
These terms defined appear in the cross-reference listing in Example 10-1:
| Symbol | Name of the symbol listed | |
| Filename | Name of the file where the symbol appears | |
| RTYP | The symbol's reference type in this file. The possible reference types are: | |
| STAT | The symbol is defined in this file and is not declared as global. | |
| EDEF | The symbol is defined in this file and is declared as global. | |
| EREF | The symbol is not defined in this file but is referenced as global. | |
| UNDF | The symbol is not defined in this file and is not declared as global. | |
| AsmVal | This hexadecimal number is the value assigned to the symbol at assembly time. A value may also be preceded by a character that describes the symbol's attributes. Table 10-1 lists these characters and names. | |
| LnkVal | This hexadecimal number is the value assigned to the symbol after linking. | |
| DefLn | The statement number where the symbol is defined. | |
| RefLn | The line number where the symbol is referenced. If the line number is followed by an asterisk (*), then that reference can modify the contents of the object. A blank in this column indicates that the symbol was never used. | |
Table 10-1 Symbol Attributes in Cross-Reference Listing
| Character | Meaning |
|---|---|
| ' | Symbol defined in a .text section |
| " | Symbol defined in a .data section |
| + | Symbol defined in a .sect section |
| - | Symbol defined in a .usect section |
Example 10-1 is an example of cross-reference listing.
Example 10-1 Cross-Reference Listing
=============================================================================
Symbol: _SETUP
Filename RTYP AsmVal LnkVal DefLn RefLn RefLn RefLn
________ ____ ________ ________ ______ _______ _______ _______
demo.asm EDEF '00000018 00000018 18 13 20
=============================================================================
Symbol: _fill_tab
Filename RTYP AsmVal LnkVal DefLn RefLn RefLn RefLn
________ ____ ________ ________ ______ _______ _______ _______
ctrl.asm EDEF '00000000 00000040 10 5
=============================================================================
Symbol: _x42
Filename RTYP AsmVal LnkVal DefLn RefLn RefLn RefLn
________ ____ ________ ________ ______ _______ _______ _______
demo.asm EDEF '00000000 00000000 7 4 18
=============================================================================
Symbol: gvar
Filename RTYP AsmVal LnkVal DefLn RefLn RefLn RefLn
________ ____ ________ ________ ______ _______ _______ _______
tables.asm EDEF "00000000 08000000 11 10
=============================================================================
Copyright© 2017, Texas Instruments Incorporated. An IMPORTANT NOTICE for this document addresses availability, warranty, changes, use in safety-critical applications, intellectual property matters and other important disclaimers.