asl.1

万能汇编工具

.TH asl 1

.SH NAME
.B asl \- cross assembler for microprocessors and -controllers

.SH SYNTAX
.B asl 
[ option(s) ] file(s) [ option(s) ] file(s) ...

.SH DESCRIPTION

AS is a cross assembler that can be used to write assembler programs
for a variety of different microprocessors and -controllers.
.B asl
is the UNIX/C implementation of AS.  A complete description of AS is
far beyond the scope of this manual page, which is only intended as
a quick reference for AS's command line interface.  For a more detailed
introduction into the usage of AS, see the user's manual.

.SH COMMAND-LINE PARAMETERS

Every argument that starts with a slash (/), plus (+) or minus (-) sign
is regarded as a command-line parameter.  Some command-line parameters
take an argument as additional parameter.  Every argument that is not
recognized as a command-line parameter is regarded as an assembler source
file to be assembled.  A source file name that does not have an extension
is automatically extended with the default extension '.asm'.
Options are turned on with a parameter starting with
a slash (/) or minus sign (-), whereas a parameter with a leading plus sign
(+) turns an option off.  In the following list, all options will be shown in
the form that is needed to change the default behaviour, which might be a 
plus or minus sign, depening on wether the option is on or off by default.

.B asl
accepts the following command-line parameters:
.TP
.B -A

Change the data structure that is internally used to store the symbol table.
By default, AS uses binary trees to store macro and symbol definitions.  Turning
this option on will change this to AVL-balanced trees.  Depending on the ratio
of symbol entries and lookups, this might speed up assembly.  Using AVL-balanced
trees helps also reducing the stack usage, which is however irrelevant for the C
version of AS.
.TP
.B -a

Instruct AS to write out the shared symbol definitions in a format suitable
for including into an AS assembler program.  The file's name is constructed by
replacing the source file's extension with '.inc'.  See the user manual for more
information about symbol sharing.
.TP
.B -cpu <name>
Set the target processor to <name>.  Use this option if the source file does
not contain a CPU statement.
.TP
.B -alias <new name=old name>
Define a CPU alias.  An alias is a name that can be used as an argument to the
CPU pseudo-instruction just like an intrinsic CPU type.  Its usage will set
the same target as the old name, however the predefined symbols MOMCPU and
MOMCPUNAME will be set to the new name.  This option is primarily useful for
adding a new member to a processor family that has the same core, but is 
different in its internal peripherals, thus allowing to distinguish between
them.
.TP
.B -C

Add a cross reference table to the assembler listing.  A cross reference
table lists all symbols that have been referenced at least once during assembly,
including the source line number(s) and count of every reference.  This option
only makes sense when the generation of an assembly listing has been turned on
via the
.B -L
or
.B -l
parameters.
.TP
.B -c

Instruct AS to write out the shared symbol definitions in a format suitable
for including into a C program.  The file's name is constructed by replacing
the source file's extension with '.h'. See the user manual for more information
about symbol sharing.
.TP
.B -D <name[=value]>[,...]
Pre-define symbols.  Predefined symbols are entered into the global symbol
table prior to assembly of the source file(s).  If no value is given for a
symbol, it is assigned the integer value 1.  Value expressions may contain
arithmetic expressions as described in the user manual, but they may not 
reference any other predefined or internal symbols.
.TP
.B -E [file]
Force AS to send warning and error messages to
.B file
rather than to the standard error output.  The file names !0 to !4 are used
to refer to the standard input, output, error, auxilliary, and printer channels
predefined by the operating system (on some systems, some of these handles
might not exist).  If the [file] specification is omitted, a name is constructed
by replacing the source file's extension with '.log'.
.TP
.B +G
Supress code generation, reducing the functionality of AS to macro
preprocessing.
.TP
.B -g [MAP|Atmel|NoICE]

Instruct AS to write an additional file containing debug information. This
information covers the symbol table and the relation between source line
numbers and machine addresses.  The argument specifies whether debug info
shall be written in AS's own MAP format, the object format for Atmel's AVR
tools, or a command file suitable for John Hartman's NoICE.  If no argument
is given, MAP will be chosen.  The file's name is constructed by replacing
the source file's extension with '.map', '.obj', or '.noi' respectively.
.TP
.B -gnuerrors

Output errors and their location in the source code in a format similar
to the GNU C compiler, thus making it easier to integrate AS into
environments designed for this format.  Note that in contrast to the
standard format used by AS, locations inside are not reported!
.TP
.B -h

Force AS to print all hexadecimal constants with lowercase letters, rather
than with uppercase letters A..F which is the default.
.TP
.B -i <path[:path...]>
Add new entries to the list of paths that are searched for include files.
New entries are prepended to the current include path list, so if multiple
paths are given with one command-line parameter, they will be entered into
the path list in reverse order.
.TP
.B -I

Add an include file list to the assembly listing.  An include file list contains
all files that have been included while assembling the source files, including
multiple and nested inclusion.  Nesting of inclusion is identified by different
indention.  This option only makes sense when the generation of an assembly
listing has been turned on via the
.B -L
or
.B -l
parameters.
.TP
.B -L

Turn on generation of an assembly listing and send it to a file whose name is
constructed by replacing the source file's extension with '.lst'.
.TP
.B -l

Turn on generation of an assembly listing and send it to the console.
.TP
.B -M

Turn on generation of a macro definition file.  A macro definition file is
a file that contains all macro definitions that have been detected during
assembly, in a format suitable for an inclusion into another file.  The macro
definition file's name is constructed by replacing the source file's
extension with '.mac'.
.TP
.B -n

Force AS to extend all error and warning messages with their internal error
resp. warning number.
.TP
.B -noicemask [mask]
By default, AS will only write symbols to the NoICE debug info that are
located in the code segment.  By changing this binary mask, more and/or 
different masks may be chosen.  The assignment is bit 1=code, 2=data, 
3=idata, 4=xdata, 5=ydata, 6=bitdata, 7=io, 8=reg, 9=romdata .  Negating
this option reverts the mask to code-only.
.TP
.B -o <name>
Tell AS to write the code output to a file <name>.  By default, the code
output file's name is constructed by replacing the source file's extension
with '.p'.  If multiple files are assembled with one command, this parameter
may also be given multiply.  If there are less output specifications than
source file names, AS will switch back to the default naming convention after 
all output specifications have been used up.
.TP
.B -olist <name>

Tell AS to write the assembly lsting to a file <name>, instead of a file
with the standard name in the source file's directory.  This option only
makes sense when an assembly listing has been requested via the '-L' option.
.TP
.B -shareout <name>

Tell AS to write shared symbol definitions to a file <name>, instead of
constructing the name from the source file's name. See the user manual for
more information about symbol sharing.
.TP
.B -P

Turn on generation of a macro output file.  A macro output file contains the
intermediate source code that remains after macro expansion and conditional assembly.
The macro output file's  name is constructed by replacing the source file's
extension with '.i'.
.TP