xref: /original-bsd/old/as.vax/PSD.doc/as.man.1 (revision 817cfbae)
Copyright (c) 1982 The Regents of the University of California.
All rights reserved.

%sccs.include.redist.roff%

@(#)as.man.1 5.1 (Berkeley) 04/17/91

AS 1 ""
C 4
NAME
as - VAX-11 assembler
SYNOPSIS
as [ -d124 ] [ -L ] [ -W ] [ -V ] [ -J ] [ -R ] [ -t directory ] [ -o objfile ] [ name ... ]
DESCRIPTION
As assembles the named files, or the standard input if no file name is specified. The available flags are:

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

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

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

-W Do not complain about errors.

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

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

-t 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 objfile; if that is omitted, a.out is used.

FILES
/tmp/as\(** default temporary files

a.out default resultant object file

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

Auxiliary documentation Assembler Reference Manual.

AUTHORS
John F. Reiser

Robert R. Henry

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