Epson S5U1C63000A Computer Accessories User Manual


 
CHAPTER 5: LINKER
S5U1C63000A MANUAL EPSON 91
(S1C63 FAMILY ASSEMBLER PACKAGE)
5.3 Starting Method
General form of command line
lk63
^
[Options]
^
[<Relocatable object files>]
^
[<Linker command file>]
^
<ICE parameter file>
^
denotes a space.
[ ] indicates the possibility to omit.
The order of options and file names can be arbitrary.
File names
Files are identified with their extensions. Therefore, an appropriate extension should be included in
each file name. However, the extension ".o" of the relocatable object file can be omitted.
Relocatable object files: <File name.o>
Linker command file: <File name.cm>
ICE parameter file: <File name.par>
When using a linker command file, options, relocatable object file names, an ICE parameter file name
and an output file name can be described in the linker command file. If all the items to be specified are
entered in a command line, the linker command file is not necessary.
When linking multiple relocatable object files from a command line, one or more spaces should be
placed between the file names.
For the output file name, specify an absolute object file name (.abs). The file name will be used for
other output files. If no absolute object file name is specified, the same name as that of the relocatable
object file to be linked first is used as the output file name.
The ICE parameter file cannot be omitted.
A long file name supported in Windows and a path name can be specified. When including spaces in
the file name, enclose the file name with double quotation marks (").
Options
The linker comes with the following options:
-d
Function: Disable full branch optimization
Explanation: Disables automatic insertion/deletion/correction of the extension codes (ldb
%ext, imm8) for branch instructions (jumps and calls).
Default: If this option is not specified, the branch optimization function will be enabled.
Note: In the previous version, omission of the -d option enables automatic insertion and
correction of the extension codes, note, however, that deletion of the extension
codes must be enabled using the -er option. The current version has no -er option
and the deletion function is enabled by default. Conversely, the -dr option must
be specified to disable the deletion function. Be aware of this difference when
using a project created in the previous version in particular.
-di
Function: Disable insertion of branch extension
Explanation: Disables extension code insertion when the branch optimization function (inser-
tion/deletion/correction) is enabled.
Default: If this option is not specified, necessary extension codes will be inserted when the
full branch optimization function is specified.
-dr
Function: Disable removal branch optimization
Explanation: Disables extension code deletion when the branch optimization function (inser-
tion/deletion/correction) is enabled. This will be needed when at least the
existing extension codes should not be removed.
Default: If this option is not specified, unnecessary extension codes will be removed when
the full branch optimization function is specified.