as(1)                                                       as(1)



NAME
     as - assembles files by translating assembler  mnemonics  to
     object code

SYNOPSIS
     as [-A factor] [ -m ] [ -n ] [-o object-file] [ -R ] [ -V ]
     [ -68030 ] [ -68040 ] [ -68851 ] file

ARGUMENTS
     -A factor
          Specifies the expansion factor to be used to increase
          the size of the default symbol table.

     file Specifies the name of the file to be assembled. By
          convention, assembly-language filenames have the .s
          suffix.  If you specify more than one file argument, as
          assembles only the last-named file.

     -m   Causes as to run the m4 macro preprocessor on file and
          assemble the output of m4.

     -n   Turns off address optimization.  By default, as
          optimizes addresses by replacing, where possible, a
          reference to a long address with a reference to a short
          relative address.

     -o object-file
          Causes as to put its output in object-file.  If you do
          not use this option, as puts its output in a file whose
          name is formed by removal of the .s suffix, if there is
          one, from file and substitution of the .o suffix.

     -R   Causes as to remove file when assembly is completed.
          By default, this option is off.

     -V   Causes as to write its version number on the standard
          error.

     -68030
          Assemble for the MC68030 processor and MC68030 MMU.
          This option give you access to an enhanced feature set
          as compared to the default MC68020 assembly, but the
          code does not run on the original Macintosh II
          computer.

     -68040
          Assemble for the MC68040 processor and MC68040 MMU.
          This option give you access to an enhanced feature set
          as compared to the default MC68020 assembly, but the
          code does not run on the original Macintosh II
          computer.




January 1992                                                    1

as(1)                                                       as(1)



     -68851
          Assemble for the MC68851 Memory Management Unit (MMU).
          This command is on by default.

DESCRIPTION
     as assembles assembly-language files.  The C and Fortran
     compilers produce assembly-language files and automatically
     call as to assemble them.

WARNINGS
     If you use the -m option, file cannot use the names of m4
     built-in macros as names for variables, functions, or
     labels.  This is because m4 cannot distinguish between the
     use of the built-in macro names as macros and as assembler
     symbols (see m4(1)).

LIMITATIONS
     The as command cannot process arithmetic expressions that
     have more than one forward-referenced symbol per expression.

FILES
     /bin/as
          Executable file
     /usr/tmp/as[1-6]*
          Temporary storage files

SEE ALSO
     adb(1), ld(1), m4(1), nm(1), strip(1)

     a.out(4) in A/UX Programmer's Reference

     ``as Reference'' in A/UX Programming Languages and Tools,
     Volume 1






















2                                                    January 1992