143082Scael.\" Copyright (c) 1980, 1990 The Regents of the University of California. 243082Scael.\" All rights reserved. 319533Smckusick.\" 443082Scael.\" %sccs.include.redist.man% 519533Smckusick.\" 6*50833Scael.\" @(#)as.1 6.6 (Berkeley) 08/09/91 743082Scael.\" 843082Scael.Dd 943082Scael.Dt AS 1 1043082Scael.Os BSD 4 1143082Scael.Sh NAME 1243082Scael.Nm as 1343082Scael.Nd VAX-11 assembler 1443082Scael.Sh SYNOPSIS 1543082Scael.Nm as 1643082Scael.Op Fl \&a Ar val 1743082Scael.Op Fl \&d Ar bytes 1843082Scael.Op Fl \&L 1943082Scael.Op Fl \&W 2043082Scael.Op Fl \&V 2143082Scael.Op Fl \&J 2243082Scael.Op Fl \&R 2343082Scael.Op Fl \&t Ar directory 2443082Scael.Op Fl \&o Ar outfile 2544952Scael.Op Ar source_file ... 2643082Scael.Sh DESCRIPTION 2743082ScaelThe 2843082Scael.Nm as 2943082Scaelassembler produces an object file from the given source files 3043082Scaelor from the standard input. 31*50833Scael.Bl -tag -width flag 32*50833Scael.It Fl a 3343082ScaelSpecifies the alignment 3443082Scael.Ar value 3543082Scaelof procedures and data blocks. 3627705SmckusickIt is given as a power of two; thus an alignment of 3 3727893Sannecauses alignment on an eight byte boundary. 3827705SmckusickThe default is 39*50833Scael.Fl a Ns Li 2 , 4043082Scaelthe minumum value is 4143082Scael.Li 1 , 4243082Scaelthe maximum value 4343082Scael.Li 16 . 44*50833Scael.It Fl d 4543082ScaelDisplacement offset in bytes for displacement values 4643082Scaelnot defined in the first pass or unspecified in the assembly language. 4743082ScaelPossible values are 4843082Scael.Li 1 , 2 , 4943082Scaelor 5043082Scael.Li 4 . 5143082ScaelThe default is 52*50833Scael.Fl d Ns Li 4 , 5343082Scaelif 5443082Scael.Fl d 5543082Scaelis not given. 56*50833Scael.It Fl L 5743082ScaelSave defined labels beginning with a 5843082Scael\*(LqL\*(Rq, which are normally discarded 5919533Smckusickto save space in the resultant symbol table. 6019533SmckusickThe compilers generate such temporary labels. 61*50833Scael.It Fl V 6219537SmckusickUse virtual memory for some intermediate storage, 6319537Smckusickrather than a temporary file. 64*50833Scael.It Fl W 6519533SmckusickDo not complain about errors. 66*50833Scael.It Fl J 6719533SmckusickUse long branches to resolve jumps when byte-displacement branches are 6819533Smckusickinsufficient. This must be used when a compiler-generated assembly contains 6919533Smckusickbranches of more than 32k bytes. 70*50833Scael.It Fl R 7119533SmckusickMake initialized data segments read-only, by concatenating them to 7219533Smckusickthe text segments. 7319533SmckusickThis obviates the need to run editor scripts on assembly 7419533Smckusickcode to make initialized data read-only and shared. 75*50833Scael.It Fl t 7619533SmckusickSpecifies a directory to receive the temporary file, other than 7719533Smckusickthe default /tmp. 78*50833Scael.El 7943082Scael.Pp 8043082ScaelSymbols remaining undefined upon completion are assumed global 8143082Scael.Pp 8243082ScaelOutput is either placed in 8343082Scael.Ar outfile, 8443082Scaelif given, or sent 8543082Scaelplaced in 8643082Scael.Pa a.out . 8743082Scael.Sh FILES 88*50833Scael.Bl -tag -width /tmp/as* -compact 89*50833Scael.It Pa tmp/as\(** 90*50833ScaelDefault temporary files. 91*50833Scael.It Pa a.out 92*50833ScaelDefault resultant object file. 93*50833Scael.El 9443082Scael.Sh SEE ALSO 9543082Scael.Xr a.out 5 , 9643082Scael.Xr adb 1 , 9743082Scael.Xr dbx 1 , 9843082Scael.Xr ld 1 , 9943082Scael.Xr nm 1 100*50833Scael.Rs 101*50833Scael.%T "Assembler Reference Manual" . 102*50833Scael.Re 10343082Scael.Sh AUTHORS 10419533SmckusickJohn F. Reiser 10519533SmckusickRobert R. Henry 10643082Scael.Sh HISTORY 107*50833ScaelAn 108*50833Scael.Nm as 109*50833Scaelcommand appeared in 110*50833Scael.At v6 . 111*50833ScaelThe version described here is derived from the 112*50833Scael.At v7 11344952Scael.Nm as . 11443082Scael.Sh BUGS 115*50833ScaelThe flag 11643082Scael.Fl J 11719533Smckusickshould be eliminated; the assembler should automatically choose among 11819533Smckusickbyte, word and long branches. 119