4.3BSD-Reno/share/man/cat1/as.0

AS(1)			    UNIX Reference Manual			 AS(1)

NNAAMMEE
     aass - VAX-11 assembler

SSYYNNOOPPSSIISS
     aass [--aa _v_a_l] [--dd _b_y_t_e_s] [--LL] [--WW] [--VV] [--JJ] [--RR] [--tt _d_i_r_e_c_t_o_r_y]
	[--oo _o_u_t_f_i_l_e] [_s_o_u_r_c_e__f_i_l_e ...]

DDEESSCCRRIIPPTTIIOONN
     The aass assembler produces an object file from the given source files or
     from the standard input.

     --aa        Specifies the alignment _v_a_l_u_e 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 --aa2, the
	       minumum value is 1, the maximum value 16.

     --dd        Displacement offset in bytes for displacement values not de-
	       fined in the first pass or unspecified in the assembly
	       language.  Possible values are 1, 2, or 4.  The default is --dd4,
	       if --dd is not given.

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

     --VV        Use virtual memory for some intermediate storage, rather than a
	       temporary file.

     --WW        Do not complain about errors.

     --JJ        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.

     --RR        Make initialized data segments read-only, by concatenating them
	       to the text segments.  This obviates the need to run editor
	       scripts on assembly code to make initialized data read-only and
	       shared.

     --tt        Specifies a directory to receive the temporary file, other than
	       the default /tmp.

     Symbols remaining undefined upon completion are assumed global

     Output is either placed in _o_u_t_f_i_l_e, if given, or sent placed in _a._o_u_t.

FFIILLEESS
     _t_m_p/_a_s*	default temporary files
     _a._o_u_t	default resultant object file


SSEEEE AALLSSOO
     a.out(5), adb(1), dbx(1), ld(1), nm(1)

     Auxiliary documentation _A_s_s_e_m_b_l_e_r _R_e_f_e_r_e_n_c_e _M_a_n_u_a_l.

AAUUTTHHOORRSS
     John F. Reiser
     Robert R. Henry

HHIISSTTOORRYY
     AAss appeared in Version 6 AT&T UNIX.  The version decsribed here is
     derived from Version 7 AT&T aass.

BBUUGGSS
     --JJ should be eliminated; the assembler should automatically choose among
     byte, word and long branches.