LNK56000(1)LNK56000(1)NAMElnk56000 - Motorola DSP56000 Cross Linker
SYNOPSISlnk56000 [ -B[<lodfil>] ] [ -D ] [ -L[<library>] ]
[ -M<mapfil> ] [ -O<mem>[<ctr>][<map>]:<origin> ]
[ -R<memfil> ] <files...>
DESCRIPTIONlnk56000 is a program that processes relocatable link files produced by
the DSP56000 Macro Assembler, generating an absolute load file which
can be loaded directly into the DSP56000 Simulator or converted to
Motorola S-record format for PROM burning.
files is a list of operating system compatible filenames (including
optional pathnames) separated by blanks. If no extension is supplied
for a given file, the linker will automatically append .lnk to the
filename. If no pathname is specified for a given file, the linker
will look for that file in the current directory. The list of files
will be processed sequentially in the order given and all files will be
used to generate the load file and map listing.
OPTIONS
Any of the following command line options may be specified. These can
be in any order, but must precede the list of link filenames (except
for the -L option). Option letters may be specified in either upper or
lower case.
-B[<lodfil>]
This option specifies a name for the load file generated by the
linker. lodfil can be any legal operating system filename,
including an optional pathname. Note that there can be no
intervening spaces between the -B and the optional filename.
If a pathname is not specified, the file will be created in the
current directory. If no filename is specified, or if the -B
option is not given, the linker will use the basename (filename
without extension) of the first filename encountered in the link
input file list. The resulting output file will have an
extension of .lod. The -B option should be specified only once.
-D This option directs the linker to pass debug information such as
line number and symbol values through to the load file for use
by a source level debug program. It is currently a no-op.
-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 following pathname as a
library file, and searches the file for any outstanding
unresolved references. Note that there can be no intervening
spaces between the -L and the library name.
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 filename, including an
optional pathname. Note that there can be no intervening spaces
between the -M and the optional filename.
If a pathname is not specified, the file will be created in the
current directory. If no filename is specified, the linker will
use the basename (filename without extension) of the first
filename encountered in the link input file list. The resulting
output file will have an extension of .map. If the -M option is
not specified, then the linker will not generate a map file. The
-M option should be specified only once.
-O<mem>[<ctr>][<map>]:<origin>
By default the linker generates instructions and data for the
load file beginning at absolute location zero for all DSP56000
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, 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 four-digit hexadecimal number in the range
0-FFFF 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. Note that there can be no
intervening spaces between the -O and the memory space
specifier.
-R<memfil>
This option indicates that a memory map file is to be read to
determine the absolute placement of sections in DSP56000 memory.
memfil can be any legal operating system filename, including an
optional pathname. Note that there can be no intervening spaces
between the -R and the optional filename.
If a pathname is not specified, an attempt will be made to open
the file in the current directory. If no filename is specified,
the linker will use the basename (filename without extension) of
the first filename encountered in the link input file list,
appending an extension of .mem. 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.
SEE ALSO
Motorola DSP56000 Cross Linker Reference Manual, Motorola Inc., 1987.
asm56000(1),lib56000(1)Motorola Inc. 1 June 1987 LNK56000(1)