PWB1/usr/man/man1/as.1

.th AS I 5/31/77
.sh NAME
as \*- assembler
.sh SYNOPSIS
.bd as
[
.bd \*-
] [
.bd \*-o
objfil
] name...
.sh DESCRIPTION
.it As
assembles the concatenation of the named files.
If the optional first argument
.bd \*-
is used,
all undefined symbols in the assembly
are treated as global.
.s3
The output of the assembly is left on the file
.it objfil;
if that is omitted,
.bd a.out
is used.
It is executable if no errors occurred
during the assembly,
and if there were no unresolved external references.
.sh FILES
/lib/as2   	\ pass 2 of the assembler
.br
/tmp/atm[1-3]?	\ temporary
.br
a.out		\ object
.sh "SEE ALSO"
ld(I),
nm(I),
db(I),
a.out(V),
.it "UNIX Assembler Reference Manual"
by D. M. Ritchie.
.sh DIAGNOSTICS
When
an input file cannot be read, its name
followed by a question mark is typed and assembly
ceases.
When syntactic or semantic errors occur, a single-character diagnostic is typed out
together with the line number and the file name in which it
occurred.
Errors in pass 1 cause cancellation of pass 2.
The possible errors are:
.s3
.ta 3
)	Parentheses error
.br
]	Parentheses error
.br
<	String not terminated properly
.br
*	Indirection used illegally
.br
.li
\fB.\fR	Illegal assignment to `\fB.\fR'
.br
A	Error in address
.br
B	Branch instruction is odd or too remote
.br
E	Error in expression
.br
F	Error in local (`f' or `b') type symbol
.br
G	Garbage (unknown) character
.br
I	End of file inside an if
.br
M	Multiply defined symbol as label
.br
O	Word quantity assembled at odd address
.br
P	`\fB.\fR' different in pass 1 and 2
.br
R	Relocation error
.br
U	Undefined symbol
.br
X	Syntax error
.br
.sh BUGS
Symbol table overflow is not checked.
\fBx\fR errors can cause incorrect line numbers
in following diagnostics.