as(1)                          DG/UX R4.11MU05                         as(1)


NAME
       as - assembler

SYNOPSIS
       as [ options ] file

DESCRIPTION
       The as command performs assembly of instruction mnemonics into object
       files.  The as command may optionally invoke the m4(1) macro
       processor 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 pertains to 88K machines only.  It specifies the
              model of MC88000 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.

              88100sup
                     Warn about instructions that are not supported well by
                     the MC88100 processor in supervisor mode.

              88110  Warn about instructions that are not supported well by
                     the MC88110 processor in user mode.

              88110sup
                     Warn about instructions that are not supported well by
                     the MC88110 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 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.  Invocation of the legend converter
              can be suppressed by invoking the assembler with the -Wc,off
              option.

FILES
       /bin/ctl       COFF-to-legend converter, ctl(1)
       /bin/dtl       DWARF-to-legend converter, dtl(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)