as(CP)                         6 January 1993                         as(CP)


 Name

    as - common assembler

 Syntax

    as [-dl] [-m] [-n] [-o objfile] [-R] [-V] [-Y  [md],dir] filename

 Description

    The as command assembles the named file.  The following flags may be
    specified in any order:

    -dl Do not produce line number information in the object file.

    -m  Run the m4 macro processor on the input to the assembler.

    -n  Turn off long/short address optimization.  By default, address optim-
        ization takes place.

    -o objfile
        Put the output of the assembly in objfile.  By default, the output
        file name is formed by removing the .s suffix, if there is one, from
        the input file name and appending a .o suffix.

    -R  Remove (unlink) the input file after assembly is completed.

    -V  Write the version number of the assembler being run on the standard
        error output.

    -Y  [md],dir
        Find the m4 preprocessor (m) and/or the file of predefined macros (d)
        in directory dir instead of in the customary place.  There must be a
        space between the -Y flag and its options.

 Files


    TMPDIR/*    temporary files

                TMPDIR is usually /usr/tmp but can be redefined by setting
                the environment variable TMPDIR (see tempnam() in tmpnam(S)).

 Warning

    If the -m (m4 macro processor invocation) option is used, keywords for m4
    cannot be used as symbols (variables, functions, labels) in the input
    file since m4 cannot determine which are assembler symbols and which are
    real m4 macros.

 Notes

    The .align assembler directive may not work in the .text section when
    optimization is performed.

    Arithmetic expressions may only have one forward referenced symbol per
    expression.

    Wherever possible, the assembler should be accessed through a compilation
    system interface program such as cc(CP) or rcc(CP).

 See also

    a.out(FP), cc(CP), ld(CP), m4(CP), nm(CP), strip(CP), tmpnam(S)

 Standards conformance

    as is conformant with:
    AT&T SVID Issue 2.