s5u1c33000c Epson Electronics America, Inc., s5u1c33000c Datasheet - Page 194

• Manufacturer Part Number: s5u1c33000c
• Description: Cmos 32-bit Single Chip Microcomputer S5u1c33000c Manual
• Manufacturer: Epson Electronics America, Inc.

CHAPTER 11: ASSEMBLER
11.8.10 Debugging Pseudo-Instructions (.file, .endfile, .loc, .def)
.file, .endfile, .loc pseudo-instructions
Instruction formats
Function
.def pseudo-instruction
Instruction format
Function
Insertion of debugging information by C Compiler and Preprocessor
178
(1) .file
(2) .endfile
(3) .loc
These pseudo-instructions are used to add source information to the object file, and are generated by the C
Compiler gcc33 and the Preprocessor pp33.
The as33 outputs object files in srf33 format, including debugging information conforming to these
instructions. This debugging information is necessary to perform source level debugging by the Debugger
db33. Even when the -g option of the as33 is not specified, the debugging information will not be cut off.
The .file pseudo-instruction outputs information indicating the source file's start position. The code
following this pseudo-instruction is the content of the file specified by <file name>. It is inserted at the
beginning of the source file or an include file at a place where a file is changed.
The .endfile pseudo-instruction outputs information indicating the end position of the file. It is not inserted
at the end position of an include file.
The .loc pseudo-instruction outputs information indicating the line numbers of instructions in the source
file. It is not added to comments or anywhere other than instruction lines.
.def <Symbol name> [, <Parameter>, . . . <Parameter>], endef
This pseudo-instruction is used to add the C source's symbol information to the object file, and is generated
for each symbol by the gcc33. The pp33 does not generate this information.
When the -g option is specified, the as33 outputs the object file in srf33 format, including the debugging
information that conforms to this instruction. This debugging information is required when the Debugger
db33 symbolic-debugs the C source. If the -g option of the as33 is not specified, this debugging information
is cut.
<parameter> indicates such information as symbol type and storage class. For details, refer to Section 6.6,
"Debugging Information".
When the -g option is specified ([debug info] checked on the work bench) as a start option of the gcc33 and
pp33, the gcc33 and pp33 will insert debugging pseudo-instructions in the output file (assembly source file).
The pp33 does not insert the .def pseudo-instruction.
Therefore, you do not have to describe these pseudo-instructions in creating source files.
"<File name>"
<Line No.>
EPSON
(C COMPILER PACKAGE FOR S1C33 FAMILY) (Ver. 4)
S5U1C33000C MANUAL