SLAU131V October 2004 – February 2020
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:
| xref430[options] [input filename [output filename]] |
|
xref430 |
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. | |