Motorola dsp assembler Reference Manual

Motorola DSP Assembler
Assembler Options
1-4
DSP ASSEMBLER REFERENCE MANUAL
MOTOROLA
-D  sequence can be repeated as often as desired. See
the DEFINE directive (Chapter 6) for more information.
Example: ASM96000  -D  POINTS  16  prog.asm
All occurrences of the symbol POINTS in the program PROG.ASM
will be replaced by the string ‘16’.
-EA 
-EW 
These options allow the standard error output file to be reassigned on hosts
that do not support error output redirection from the command line.
must be present as an argument, but can be any legal operating system file-
name, including an optional pathname.
The -EA option causes the standard error stream to be written to ; if
 exists, the output stream is appended to the end of the file. The -EW
option also writes the standard error stream to ; if  exists it is
rewound (truncated to zero), and the output stream is written from the be-
ginning of the file. Note that there must be white space separating either
option from the filename argument.
Example: ASM96000 -EWerrors prog.asm
Redirect the standard error output to the file ERRORS. If the file al-
ready exists, it will be overwritten.
-F
Indicates that the Assembler should read command line input from .
can be any legal operating system filename, including an optional
pathname.  is a text file containing further options, arguments, and
filenames to be passed to the Assembler. The arguments in the file need be
separated only by some form of white space (blank, tab, newline). A semi-
colon (;) on a line following white space makes the rest of the line a com-
ment.
The  -F option was introduced to circumvent the problem of limited line
lengths in some host system command interpreters. It may be used as often
as desired, including within the argument file itself. Command options may
also be supplied using the DSPASMOPT environment variable. See the dis-
cussion of DSPASMOPT under [options] at the beginning of this section.
Example: ASM96000  -Fopts.cmd
Invoke the Assembler and take command line options and source
filenames from the command file OPTS.CMD.

---

Motorola DSP Assembler
Assembler Options
MOTOROLA
DSP ASSEMBLER REFERENCE MANUAL
1-5
-G
Send source file line number information to the object file.  This option is val-
id only in conjunction with the -B command line option.  The generated line
number information can be used by debuggers to provide source-level de-
bugging.
Example: ASM56000  -B -G  myprog.asm
Assemble the file MYPROG.ASM and send source file line number
information to the resulting object file MYPROG.CLN.
-I
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 -I option is specified, the Assembler prefixes the file-
name (and optional pathname) specified in the INCLUDE directive with
 and searches the newly formed directory pathname for the file.
The pathname must be a legal operating system pathname.  The -I option
may be repeated as many times as desired.  The directories will be
searched in the order specified on the command line.
Example: ASM56000 -I\project\ testprog
This example uses IBM PC pathname conventions, and would cause
the Assembler to prefix any INCLUDE files not found in the current
directory with the \project\ pathname.  
-L
This option specifies that a listing file is to be created for Assembler output.
can be any legal operating system filename, including an optional
pathname.   A hyphen also may be used as an argument to indicate that the
listing file should be sent to the standard output, although the listing file is
routed to standard output by default.
If a pathname is not specified, the file will be created in the current directory.
If no filename is specified, the Assembler will use the basename (filename
without extension) of the first filename encountered in the source input file
list and append .LST to the basename. If the -L option is not specified, then
the Assembler will route listing output to the standard output (usually the
console or terminal screen) by default. The -L option should be specified

---

Motorola DSP Assembler
Assembler Options
1-6
DSP ASSEMBLER REFERENCE MANUAL
MOTOROLA
only once. If the file named in the -L option already exists, it will be
overwritten.
Example: ASM96000  -L  filter.asm  gauss.asm
In this example, the files FILTER.ASM and GAUSS.ASM are assem-
bled together to produce a listing file.  Because no filename was giv-
en with the -L option, the output file will be named using the
basename of the first source file, in this case FILTER.  The listing file
will be called FILTER.LST.
-M
This is equivalent to a source statement of the form:
MACLIB   
The pathname must be a legal operating system pathname. The -M option
may be repeated as many times as desired. The directories will be searched
in the order specified on the command line. See the MACLIB directive
(Chapter 6) for more information.
Example: ASM56000  -M fftlib/  trans.asm
This example uses UNIX pathname conventions, and would cause
the Assembler to look in the fftlib subdirectory of the current directory
for a file with the name of the currently invoked macro found in the
source file.
-O[,,...,]
This is equivalent to a source statement of the form:
OPT    [,,...,]
 can be any of the options that are available with the OPT directive
(see Chapter 6). If multiple options are specified, they must be separated by
commas. The -O sequence can be repeated for as many options as
desired.
Example: ASM96000  -OS,CRE  myprog.asm
This will activate the symbol table and cross reference listing options.
-P
Run the Assembler with the specified processor revision level enhance-
ments. This is for backward compatibility so that the Assembler will flag new
constructions as illegal.
 can be any of the processor identifiers given

---