usr/man/cat1/as.0



AS(1)               UNIX Programmer's Manual                AS(1)


N\bNA\bAM\bME\bE
     as - VAX-11 assembler

S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
     a\bas\bs [ -\b-a\ba1\b1-\b-1\b16\b6 ] [ [ -\b-d\bd1\b12\b24\b4 ] [ -\b-L\bL ] [ -\b-W\bW ] [ -\b-V\bV ] [ -\b-J\bJ ] [ -\b-R\bR ]
     [ -\b-t\bt directory ] [ -\b-o\bo objfile ] [ name ... ]

D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
     _\bA_\bs assembles the named files, or the standard input if no
     file name is specified.  The available flags are:

     -\b-a\ba   Specifies the alignment of procedures and data blocks.
          It is given as a power of two; thus an alignment of 3
          causes alignment on an eight byte boundary.  The
          default is -\b-a\ba2\b2.\b.

     -\b-d\bd   Specifies the number of bytes to be assembled for
          offsets which involve forward or external references,
          and which have sizes unspecified in the assembly
          language.  The default is -\b-d\bd4\b4.\b.

     -\b-L\bL   Save defined labels beginning with a `L', which are
          normally discarded to save space in the resultant sym-
          bol table.  The compilers generate such temporary
          labels.

     -\b-V\bV   Use virtual memory for some intermediate storage,
          rather than a temporary file.

     -\b-W\bW   Do not complain about errors.

     -\b-J\bJ   Use long branches to resolve jumps when byte-
          displacement branches are insufficient.  This must be
          used when a compiler-generated assembly contains
          branches of more than 32k bytes.

     -\b-R\bR   Make initialized data segments read-only, by con-
          catenating them to the text segments.  This obviates
          the need to run editor scripts on assembly code to make
          initialized data read-only and shared.

     -\b-t\bt   Specifies a directory to receive the temporary file,
          other than the default /tmp.

     All undefined symbols in the assembly are treated as global.

     The output of the assembly is left on the file _\bo_\bb_\bj_\bf_\bi_\bl_\be; if
     that is omitted, _\ba._\bo_\bu_\bt is used.

F\bFI\bIL\bLE\bES\bS
     /tmp/as*       default temporary files
     a.out          default resultant object file


Printed 7/9/88             May 8, 1986                          1


AS(1)               UNIX Programmer's Manual                AS(1)


S\bSE\bEE\bE A\bAL\bLS\bSO\bO
     ld(1), nm(1), adb(1), dbx(1), a.out(5)
     Auxiliary documentation _\bA_\bs_\bs_\be_\bm_\bb_\bl_\be_\br _\bR_\be_\bf_\be_\br_\be_\bn_\bc_\be _\bM_\ba_\bn_\bu_\ba_\bl.

A\bAU\bUT\bTH\bHO\bOR\bRS\bS
     John F. Reiser
     Robert R. Henry

B\bBU\bUG\bGS\bS
     -\b-J\bJ should be eliminated; the assembler should automatically
     choose among byte, word and long branches.


Printed 7/9/88             May 8, 1986                          2