NAME

as − Sun-1, Sun-2 and Sun-3 assembler

SYNOPSIS

as [ −d2 ] [ −e ] [ −h ] [ −j ] [ −J ] [ −L ] [ −mc68010 ] [ −mc68020 ] [ −o objfile ] [ −O ]

[ −R ] filename

DESCRIPTION

as translates assembly code in the named filename into executable object code in the specified objfile.

All undefined symbols in the assembly are treated as global. 

The output of the assembly is left in the file objfile. 

OPTIONS

−d2Specifies that instruction offsets involving forward or external references and having sizes unspecified in the assembly language are two bytes long.  The default is four bytes. See also the −j option. 

−eAllows control sections to begin on any two-byte boundary, rather than only four-byte boundaries. 

−hSuppress span-dependent instruction calculations and force all branches to be of medium length, but all calls to take the most general form.  This is used when assembly must be minimized, while program size and run-time are unimportant.  This option results in a smaller and faster program than that produced by the −J option, but some very large programs may not be able to use it because of the limits of the medium-length branches. 

−jUse short (pc-relative) branches to resolve jump’s and jsr’s to externals.  This is for compact programs which cannot use the -d2 flag because of large program relocation. 

−JSuppress span-dependent instruction calculations and force all branches and calls to take the most general form.  This is used when assembly time must be minimized, but program size and run time are not important. 

−LSave defined labels beginning with an ‘L’, which are normally discarded to save space in the resultant symbol table.  The compilers generate such temporary labels. 

−mc68010
Accept only MC68010 instructions and addressing modes, and put the MC68010 machine-type tag in the object file. This is the default on Sun-2’s.

−mc68020
Accept the full MC68020, MC68881 and the Sun FPA instruction sets and addressing modes, and put the MC68020 machine-type tag in the object file. This is the default on Sun 3’s.

−oThe next argument is taken as the name of the object file to be produced.  If the −o flag isn’t used, the objfile is named a.out. 

−OPerform span-dependent instruction resolution over entire files rather than just over individual procedures. 

−RMake initialized data segments read-only by concatenating them to the text segments.  This eliminates the need to run editor scripts on assembly code to make initialized data read-only and shared. 

FILES

/tmp/as∗ default temporary file

SEE ALSO

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

Assembly Language Reference Manual

BUGS

The Pascal compiler, pc, qualifies a nested procedure name by chaining the names of the enclosing procedures.  This sometimes results in names long enough to abort the assembler, which currently limits identifiers to 512 characters. 

Sun Release 3.5  —  Last change: 20 March 1986