4.3BSD-Tahoe/usr/man/cat1/as.0

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



NNAAMMEE
     as - VAX-11 assembler

SSYYNNOOPPSSIISS
     aass [ --aa11--1166 ] [ [ --dd112244 ] [ --LL ] [ --WW ] [ --VV ] [ --JJ ] [ --RR ]
     [ --tt directory ] [ --oo objfile ] [ name ... ]

DDEESSCCRRIIPPTTIIOONN
     _A_s assembles the named files, or the standard input if no
     file name is specified.  The available flags are:

     --aa   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 --aa22..

     --dd   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 --dd44..

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

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

     --tt   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 _o_b_j_f_i_l_e; if
     that is omitted, _a._o_u_t is used.

FFIILLEESS
     /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)



SSEEEE AALLSSOO
     ld(1), nm(1), adb(1), dbx(1), a.out(5)
     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

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












































Printed 7/9/88		   May 8, 1986				2