C-10
Motorola DSP56000 Family Optimizing C Compiler User’s Manual
For More Information On This Product,
Go to: www.freescale.com
Motorola
-O<mem>[<ctr>][<
map>]:<origin>
By default, the linker generates instructions and data for the load file beginning at absolute
location zero for all DSP memory spaces. This option allows the programmer to redefine
the start address for any memory space and associated location counter.
mem
is one of the
single-character memory space identifiers (X, Y, L, and P). The letter may be upper or
lower case. The optional
ctr
is a letter indicating the high (H) or low (L) location counters. If
no counter is specified, the default counter is used.
map
is also optional and signifies the
desired physical mapping for all relocatable code in the given memory space. It may be I for
internal memory, E for external memory, or B for bootstrap memory (valid only in P program
memory space). If
map
is not supplied, then no explicit mapping is presumed.The
origin
is
a hexadecimal number signifying the new relocation address for the given memory space.
The
-O
option may be specified as many times as needed on the command line.
-P<lpath>
When the linker encounters a library specification on the command line, the current
directory (or the directory given in the library specification) is first searched for the library
file. If it is not found and the
-P
option is supplied, the linker prefixes the file name (and
optional pathname) provided in the library specification with lpath and searches the newly
formed directory pathname for the file. The directories will be searched in the order given
on the command line.
-R[<ctlfil>]
This option indicates that a memory control file is to be read to determine the absolute
placement of sections in DSP memory.
ctlfil
can be any legal operating system file name
including an optional pathname.If a pathname is not given, an attempt will be made to open
the file in the current directory. If no file name is supplied, the linker will use the basename
(file name without extension) of the first file name encountered in the link input file list,
appending an extension of .ctl If the
-R
option is not specified, then the linker will not use a
memory map file. The
-R
option should be specified only once.
-U<symbol>
Causes symbolto be entered into the unresolved external reference table. This is useful
when the initial or only link file is a library. Since there are no external references when the
linker is invoked, the
-U
option may be used to force inclusion of a library module that
resolves the undefined reference. The
-U
option may be specified as often as desired.
-V
Indicates that the linker should be verbose during processing, displaying a progress report
as it links the input files. The linker will show the beginning of each pass and when files are
opened and closed. The information is sent to the standard error output stream.
-X<opt>[,<opt>,...,
<opt>]
The -X option directs the linker to perform a little bit of different operation than standard
operation of the linker.The options are described below with their different operations
performed. All options may be preceded by NO to reverse their meaning. The -X<opt>
sequence can be repeated for as many options as desired.
Option
XC
RSV
AEC
RO
ESO
ASC
Meaning
Relative terms from different sections used in an expression cause an error
Reserve special target processor memory areas (e.g. DSP96000 DMA)
Check form of address expressions
Allow region overlap
Do not allocate memory below ordered sections
Enable absolute section bounds checking
-Z
The linker strips source file line number and symbol information from the input file. Symbol
information normally is retained for debugging purposes. This options has no effect if
incremental linking is being done (see the -l option).
Table C-4. dsplnk Command Line Options
Option
Description
F
Freescale Semiconductor, Inc.
n
.