beautypg.com

12 global declaration pseudo-instruction (.global), Error/warning messages, 1 errors – Epson S5U1C63000A User Manual

Page 95

background image

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 "", FileName
(2) .stabn 0, FileEnd
(3) .stabn , LineInfo

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.