
Motorola
Utilities
C-3
Alternatively, two successive hyphens may be used to indicate the end of the option list:
asm56000 -b --
main io
In this case the assembler interprets
main
as a source file name and uses the default
naming conventions for the -B option. Table C-1 lists the different Command Line
Options that can be used with asm5600:
Table C-1. asm56000 Command Line Options
Option
Description
-A
indicates that the assembler should operate in absolute mode, creating a load file (.cld) if the
-B option is given. By default, the assembler produces a link file (.cln) which is subsequently
processed by the Motorola DSP linker.
-B[<objfil>]
This option specifies that an object file is to be created for assembler output.
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 path is not specified, the file will be created in the current directory. If no file name is
supplied, the assembler will use the basename (file name without extension) of the first file
name encountered in the source input file list. The resulting output file will have an extension
of .cln unless the
-A
option is given in which case the file will have a .cld extension. If the
-B
option is not given, then the assembler will not generate an object file. The -
B
option should
be specified only once.
-D<symbol>
<string>
This is equivalent to a source statement of the form:
DEFINE
<symbol> <string>
string
must be enclosed in quotes if it contains any embedded blanks. Note that if quotes are
used, they must be passed to the assembler intact, e.g. some host command interpreters will
strip quotes from around arguments. The
-D<symbol>
be repeated as often as desired.
<string>
sequence may
-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 in the file to be treated as a
comment.
-G
Send source file line number information to the object file. This option is valid only in
conjunction with -B command line option. The generated line number information can be
used by debuggers to provide source-level debugging.
-I<ipath>
When the assembler encounters include files, the current directory (or the directory specified
in the INCLUDE directive) is first searched for the file. If it is not found and the
-l
option is
supplied, the assembler prefixes the file name (and optional pathname) specified in the
INCLUDE directive with
ipath
and searches the newly formed directory pathname for the file.
The
-I<ipath>
sequence may be repeated as many times as desired. The directories will be
searched in the order given on the command line.
F
Freescale Semiconductor, Inc.
For More Information On This Product,
Go to: www.freescale.com
n
.