The RTEMS Linker is a single tool that lets you create applications. It is a special kind of linker and does not perform all the functions found in a normal linker. RAP format output performs a partial increment link.

Command

rtems-ld [options] objects

Options

Help (-h –help):
Print the command line help then exit.

Version (-V –version):
Print the linker's version then exit.

Verbose (-v –verbose):
Control the trace output level. The RTEMS linker is always built with trace logic. The more times this appears on the command the more detailed the output becomes. The amount of output can be large at higher levels.

Warnings (-w –warn):
Print warnings.

Map (-M –map):
Generate map output to stdout.

Output (-o –output):
Set the output file name.

Output Format (-O –out-format):
Set the output format. The valid formats are:

Format	Description
rap	RTEMS application (LZ77, single image)
elf	ELF application (script, ELF files)
script	Script format (list of object files)
archive	Archive format (collection of ELF files)

Library Path (-L –lib-path):
Add a library path. More than one path can be added with multiple library path options.

Library (-l –lib):
Add a library. More than one library can be added with multiple library paths.

No Standard Libraries (-n –no-stdlibs):
Do not search the standard libraries. The linker uses the architecture C compiler to locate the installed standard libraries and these are automatically searched. If this option is used the C compiler is not called and the libraries are not added to the search list.

Entry Point (-e –entry):
Set the entry point. This is used with the RAP format and defaults to rtems. The entry point is called when a RAP file is loaded by the target RAP loader.

Define Symbol (-d –define):
Add a symbol to the symbol table. More than one symbol can be added with multiple define options.

Undefined Symbol (-u –undefined):
Add an undefined symbol to the undefined symbol list. More than one undefined symbol can be added with multiple undefined options. This options will pull specific code into the output image.

RTEMS Kernel (-b –base):
Set the RTEMS kernel image. This is the ELF file of the RTEMS kernel that will load the output from the linker. The RTEMS kernel is the base module or image. The linker does not pull the symbol from a library if the symbol is found in the base module. The kernel will load the target symbol table with these symbols so they can be resolved at runtime.

Architecture C Compiler (-C –cc):
Set the architecture's C compiler. This is used to find the standard libraries.

Tool Prefix (-E –exec-prefix):
Set the tool prefix. The tool prefix is the architecture and this is normally automatically set by inspecting the first object file loaded. This option allows the automatic detection to be overridden.

Machine Architecture (-a –march):
Set the machine architecture.

Machine CPU (-c –mcpu):
Set the machine architecture's CPU.