Epson S5U1C63000A - Manual (Page 109)

CHAPTER 5: LINKER
S5U1C63000A MANUAL EPSON 95
(S1C63 FAMILY ASSEMBLER PACKAGE)
5.5 Linker Command File
To simplify the keystroke in the command line at the time of start up, execute the link processing through
the linker by inputting a linker command file (.cm) that holds the necessary specifications (any options
and file names) described.
Sample linker command file
-e ; Generate error file
-g ; Add debug information
-code 0x0100 ; Fix CODE section start address
-rcode test2.o = 0x0110 ; Fix CODE section start position of test2.o
-data 0x8000 ; Fix DATA section start address
-bss 0x00e0 ; Fix BSS section start address
-defsym IO = 0xFF00 ; Set global symbol
-o test.abs ; Specify output file name
test1.o ; Specify input file 1
test2.o ; Specify input file 2
Create the linker command file with the following rules:
File format
The linker command file is a general text format as shown above.
".cm" should be used for the file name extension.
Option description
All options should begin with a hyphen (-). Each individual option needs to be delineated with more
than one space, tab, or line feed. For better visibility, it is recommended to describe each option in a
separate line.
Notes: • A numeric value to specify an address should be described in the hexadecimal format (0xnnnn).
Decimal and binary notations will not be accepted.
• When an option that is only permitted in single setting is specified in a duplicated manner, the
last entered option will be effective.
Example: -code 0x0000
-code 0x0100 ... -code 0x0100 is effective.
Input file specification
Describe the relocatable object file names at the end of the link command file. The mapping by linking
takes place in described order, unless otherwise specified.
The extension (.o) of the relocatable object files can be omitted.
Comment
A comment can be described in the linker command file.
As in the source file, the character string from a semicolon (;) to the end of the line is regarded as a
comment.
Blank line
A blank line carrying only blank characters and a line feed will be ignored. It need not be converted to
a comment using a semicolon.