Starting Method; Startup Format; Command-Line Options - Epson S5U1C17001C Manual

7.3 Starting Method

7.3.1

Startup Format

To invoke the ld linker, use the command shown below.
ld <options> <file names>
<options> See Section 7.3.2.
<file names> Specify one or more object file names and/or one ore more library file names.
Example: ld -o sample.elf sample.o ..\lib\24bit\libc.a ..\lib\24bit\libgcc.a
7.3.2

Command-line Options

The ld linker accepts the gnu linker standard options.
The following lists the principal options only. Refer to the gnu linker manual for more information.
-o <filename>
Specify output file name
Function:
Explanation: This option is used to specify the name of the object file output by the ld linker.
Default: The default output file name is a.out.
-T <linker script file name>
Function: Read linker script file
Explanation: Specify this option when loading relocate-information into the ld linker using a linker script file.
Default: The default linker script (see Section 7.4.1) is used.
-R <linker symbol file name>
Function: Read linker symbol file
Explanation: This option is used to specify the address corresponding to the symbol name using the linker symbol file.
Default: The linker symbol file is not read.
-M
-Map <filename>
Function: Output link map file
Explanation: The -M option outputs the link map information to stdio.
The -Map option outputs the link map information to a file.
Default: No link map information is output.
-N
Function: Disable data segment alignment check
Explanation: When the -N option is specified, the linker does not check the alignment of data segments.
Default: The linker checks the alignment of data segments.
--relax (gcc4 ld only)
Function: Optimize output code size
Explanation: Specifying the --relax option optimizes output code size by deleting the ext 0 instruction.
Default: The linker does not delete the ext 0 instruction.
When inputting options in the command line, one or more spaces are necessary before and after the option.
Example: ld -o sample.elf -T sample.lds -N boot.o sample.o ..\lib\24bit\libc.a
S5U1C17001C Manual
(Rev. 1.0)
Seiko Epson Corporation
7 Linker
7-3