Texas Instruments TMS320C2x, User Manual

Page: 97 / 250

Linker Options
4-6
4.4 Linker Options
All command-line input following the − z shell option is passed to the linker as
parameters and options. The following are options that control the linker along
with detailed descriptions of their effects.
− a Produces an absolute, executable module. This is the
default; if neither
− a nor − r is specified, the linker acts as
if − a is specified.
− ar Produces a relocatable, executable object module
− b Disables merging of symbolic debugging information
− c Autoinitializes variables at runtime. See section 6.8.4 on
page 6-34, for more information.
− cr Initializes variables at load time. See section 6.8.5 on
page 6-35, for more information.
− e global_symbol Defines a global_symbol that specifies the primary entry
point for the output module
− f fill_value Sets the default fill value for holes within output sections;
fill_value is a 16-bit constant
− g global_symbol Defines global_symbol as global even if the global sym-
bol has been made static with the − h linker option
− h Makes all global symbols static
− heap size Sets heap size (for dynamic memory allocation) to size
words and defines a global symbol that specifies the
heap size. Default is 1K words.
− i directory Alters the library-search algorithm to look in directory be-
fore looking in the default location. This option must ap-
pear before the
− l linker option. The directory must follow
operating system conventions.
− l libraryname (lower case L) Names an archive library file or linker com-
mand filename as linker input. The
libraryname is an ar-
chive library name and must follow operating system
conventions.
− m filename Produces a map or listing of the input and output sec-
tions, including holes, and places the listing in
filename.
The filename must follow operating system conventions.
− n Ignores all fill specifications in memory directives. Use
this option in the development stage of a project to avoid
generating large .out files, which can result from using
memory directive fill specifications.