V7M/man/man1/as.1

.TH AS 1  PDP11
.SH NAME
as   \- assembler
.br
ovas \- overlay assembler
.SH SYNOPSIS
.B as
[
.B \-
] [
.B \-o
objfile
] file ...
.br
.B ovas
[
.B \-
] [
.B \-o
objfile
] file ...
.SH DESCRIPTION
.I As
assembles the concatenation of the named files.
If the optional first argument
.B \-
is used,
all undefined symbols in the assembly
are treated as global.
.PP
The output of the assembly is left on the file
.I objfile;
if that is omitted,
.B a.out
is used.
It is executable if no errors occurred
during the assembly,
and if there were no unresolved external references.
.PP
The overlay assembler is only
used for the generation of the overlay
text unix kernel.
.SH FILES
/lib/as2   	pass 2 of the assembler
.br
/lib/ovas2	pass 2 of the overlay assembler
.br
/tmp/atm[1-3]?	temporary
.br
a.out		object
.SH "SEE ALSO"
ld(1),
nm(1),
adb(1),
a.out(5)
.br
.I "UNIX Assembler 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:
.PP
.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
Syntax errors can cause incorrect line numbers
in following diagnostics.