as(1) DG/UX 5.4.2 as(1)
NAME
as - MC88000 assembler
SYNOPSIS
as [ options ] file
DESCRIPTION
The as command performs assembly of 88000 instruction mnemonics into
object files. The assembler input language is described in Chapter 5
of the Supplement for Programmer's Guide: ANSI C and Programming
Support Tools. The as command may optionally invoke the m4(1) macro
processor and sifilter(1) before assembly. The as command reads
input from file; if file is `-', as reads from stdin.
as supports the following options:
-o objfile
Causes as to place its output in the specified objfile. If
this option is not present, as places output in a file whose
name is constructed from file by replacing a .s suffix, if
present, with .o, otherwise by appending .o. If as takes its
input from stdin, then the -o option must be supplied. The
output file must be a file on which as can perform fseek(3S).
-m Causes as to process its input with the m4 macro processor
before assembly.
-Y [md],dir
Normally, as will invoke m4 with a command line of the form:
/bin/m4 /lib/cm4defs file
The -Y option changes the directory from which m4 is invoked
and the directory in which cm4defs is found. Thus
-Y m,dir will invoke dir/m4 and include /lib/cm4defs;
-Y d,dir will invoke /bin/m4 and include dir/cm4defs;
-Y md,dir will invoke dir/m4 and include dir/cm4defs.
-M mach
This option specifies the model of M88000 processor for which
instructions are to be assembled. This option does not change
the instructions that are produced; it merely controls the
production of warnings relating to those instructions.
Possible values for mach and their meanings are as follows:
88000min
Warn about instructions that are not guaranteed to be
supported well by all M88000 processors in user mode.
This value is implied if no -M option is provided.
88100 Warn about instructions that are not supported well by
the MC88100 processor in user mode.
Licensed material--property of copyright holder(s) 1
as(1) DG/UX 5.4.2 as(1)
88100sup
Warn about instructions that are not supported well by
the MC88100 processor in supervisor mode.
88000max
Warn about instructions that are not supported well by
any M88000 processor in user mode.
88000maxsup
Warn about instructions that are not supported well by
any M88000 processor in supervisor mode.
-W s,sifilter-options
This option controls invocation of the silicon filter before
assembly. Arguments to this option include on, which will
unconditionally invoke sifilter with default options, and off,
which prevents invocation of sifilter; any other arguments are
passed as options to sifilter.
By default, as will not invoke sifilter.
-W c,legend-conversion-options
This option controls invocation of the legend converter after
assembly. All arguments are passed as options to the
appropriate legend converter, ctl(1) or dtl(1).
By default, as will invoke the legend converter if debugging
information is present.
FILES
/bin/ctl COFF-to-legend converter, ctl(1)
/bin/dtl DWARF-to-legend converter, dtl(1)
/bin/sifilter silicon filter, sifilter(1)
SEE ALSO
cc(1), ld(1), m4(1), nm(1), strip(1), ctl(1), dtl(1), sifilter(1),
tmpnam(3S), a.out(4).
NOTES
If the -m (m4 macro processor invocation) option is used, keywords
for m4 [see m4(1)] cannot be used as symbols (variables, functions,
labels) in the input file since m4 cannot determine which keywords
are assembler symbols and which keywords are real m4 macros.
Arithmetic expressions may have only one forward referenced symbol
per expression.
Whenever possible, you should access the assembler through a
compilation system interface program such as cc.
Licensed material--property of copyright holder(s) 2