12 global declaration pseudo-instruction (.global), Error/warning messages, 1 errors – Epson S5U1C63000A User Manual
Page 95
CHAPTER 4: ASSEMBLER
S5U1C63000A MANUAL
EPSON
81
(S1C63 FAMILY ASSEMBLER PACKAGE)
4.7.12 Global Declaration Pseudo-Instruction (.global)
Instruction format
.global
Symbol to be defined in the current file, or symbol already defined in other module
• One or more spaces or tabs are necessary between the instruction and the symbol.
Sample description:
.global GENERAL_SUB1
Function
Makes global declaration of a symbol. The declaration made in a file with a symbol defined converts
that symbol to a global symbol which can be referred to from other modules. Prior to making refer-
ence, declaration has to be made by this instruction on the side of the file that is going to make the
reference.
4.7.13 List Control Pseudo-Instructions (.list, .nolist)
Instruction format
.list
.nolist
Function
Controls output to the relocatable list file.
The .nolist pseudo-instruction stops output to the relocatable list file after it is issued.
The .list pseudo-instruction resumes from there the output which was stopped by the .nolist pseudo-
instruction.
Precaution
The assembler delivers relocatable list files only when it is started up with the -l option specified.
Therefore, these instructions are invalid, if the -l option was not specified.
4.7.14 Source Debugging Information Pseudo-Instructions (.stabs, .stabn)
Instruction formats
(1) .stabs "
(2) .stabn 0, FileEnd
(3) .stabn
Function
The assembler outputs object files in IEEE-695 format, including source debugging information
conforming to these instructions. This debugging information is necessary to perform debugging by
Debugger db63, with the assembly source displayed.
Format (1) delivers information on the start position of a file.
Format (2) delivers information on the end position of a file.
Format (3) delivers information on the line No. of an instruction in a source file.
Insertion of debugging information
When the -g option is specified as a start option, the preprocess stage of the assembler will insert
debugging pseudo-instructions in the preprocessed file. Therefore, you do not have to describe these
pseudo-instructions in creating source files.