Museum

Home

Lab Overview

Retrotechnology Articles

Online Manuals

⇒ as(1) — AIX PS/2 1.2.1

Media Vault

Software Library

Restoration Projects

Artifacts Sought

Related Articles

following



AS(1,C)                     AIX Commands Reference                      AS(1,C)



-------------------------------------------------------------------------------
as



PURPOSE

Assembles a source file.

SYNTAX

For AIX/370:


      +----------------+   +--------+
as ---| +------------+ |---|        |---|
      +-| -C         |-+   +- file -+
        | -D         |
        | -ibuck     |
        | -llistfile |
        | -ofile     |
        | -sn        |
        | -t         |
        | -T addr    |
        | -V         |
        | -xa        |
        +------------+


For AIX PS/2:


      +----------------+   +----------+
as ---| +------------+ |---|          |---|
      +-| -a         |-+   +-- file --+
        | -dl        |
        | -iint      |
        | -llistfile |
        | -nbuck     |
        | -R         |
        | -s0        |
        | -s1        |
        | -s2        |
        +------------+





DESCRIPTION





Processed November 8, 1990          AS(1,C)                                   1





AS(1,C)                     AIX Commands Reference                      AS(1,C)



Note:  AIX assemblers are intended to support the compilers and may not have
       the full functionality of other assemblers specifically used for
       assembler language programming.  See AIX Programming Tools and
       Interfaces for AIX PS/2 and AIX/370 restrictions.

The as command reads and assembles the named file (conventionally this file
ends with a .s suffix).  If you do not specify a file, as reads and assembles
standard input.  It creates an object file ending with a .o suffix.

FLAGS

The following flags are common to both AIX/370 and PS/2:

-llistfile     Generates a source listing.  If the optional file is specified,
               the source listing is written to that file; otherwise it is
               written to standard output.  Do not leave a space between -l and
               the listfile.

-ofile         Sets the name of the output module to file.

-T addr        Sets the origin address to addr.

The following flags are used only with AIX/370:

-C             Fixed format inspection (for example, card format).

-D             Use different version of the line and bcall built-in macros.

-ibuck         Sets the number of buckets in the symbol table to buck.

-sn            Tab size used only with -C.

-t             Time the assembler.  Also counts and prints the number of lines
               processed and the number of lines expanded from macros.

-V             Prints the version number of the assembler on standard output.

-xa            Assemble module with XA/370 instruction.

The following flags are used only with PS/2:

-a             Does not automatically import any symbols that are referenced in
               the source code but are otherwise undefined.  Issues an error
               message for this case.

-dl            Remove line number entries from the symbol table.

-iint          Sets error interval to the specified integer.

-nbuck         Sets the number of buckets in the symbol table to buck.





Processed November 8, 1990          AS(1,C)                                   2





AS(1,C)                     AIX Commands Reference                      AS(1,C)



-R             Suppresses any data directives; all code is assembled in the
               text segment.

-s0            Generates the long form for all forward references and the short
               form, where possible, for backward references.

-s1            Runs one extra pass, in which most of the forward references are
               reduced to the shortest possible form.

-s2            Runs as many passes as are necessary to generate the short form
               for all qualifying forward references.

FILES

file.s              Assembler source file.
file.o              Object file.

RELATED INFORMATION

The following commands:  "cc,"  "ld."

The a.out file in AIX Operating System Technical Reference.

The discussion of as in the AIX Operating System Programming Tools and
Interfaces.






























Processed November 8, 1990          AS(1,C)                                   3



Typewritten Software • bear@typewritten.org • Edmonds, WA 98026