
Motorola
Utilities
C-9
Table C-4. dsplnk Command Line Options
Option
Description
-B[<objfil>]
This option specifies a name for the object file generated by the linker. objfil can be any
legal operating system file name including an optional pathname. A hyphen may also be
used as an argument to indicate that the object file should be sent to the standard output.
If a pathname is not given, the file will be created in the current directory. If no file name is
supplied or if the -B option is not given, the linker will use the basename (file name without
extension) of the first file name encountered in the link input file list. The resulting output file
will have an extension of .cld. The -B option should be specified only once.
-F<argfil>
This option indicates that an external file should be read for further command arguments. It
is useful in host environments where the command line length is restricted.
argfil
must be
present on the command line but can be any legal operating system file name, including an
optional pathname.
The file may contain any legal command line options including the
-F
option itself. The
arguments need be separated only by white space (spaces, tabs, or newlines). A
semicolon (;) on a line following white space causes the rest of the line to be treated as a
comment.
-I
Under normal operation, the linker produces an absolute load file as output. If the -I option
appears on the command line, the linker combines the input files into a single relocatable
link file suitable for a subsequent linker pass. No absolute addresses are assigned and no
errors are issued for unresolved external references.
-L<library>
The linker ordinarily processes a list of link files which each contain a single relocatable
code module. If the
-L
option is encountered, the linker treats the accompanying pathname
as a library file, and searches the file for any outstanding unresolved references.
If a module is found in the library that resolves an outstanding external reference, the
module is read from the library and included in the load file output. The linker continues to
search a library until all external references are resolved or no more references can be
satisfied within the current library. The linker searches a library only once: when it is
encountered on the command line. Therefore, the position of the
-L
option on the command
line is significant.
-M[<mapfil>
This option specifies that a map file is to be created.
mapfil
can be any legal operating
system file name including an optional pathname.
If a pathname is not given, the file will be created 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. The resulting output file will have an extension of .map.
The linker will not generate a map file if the
-M
option is not specified. The
-M
option should
be specified only once.
-N
Indicates that the linker should ignore case in symbol names. Ordinarily the linker is
sensitive to upper and lower case letters in symbol names. If the -N option is supplied the
linker maps all symbol characters to lower case.
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.