[unix-history] / usr / man / man1 / as.1

.TH AS 1  PDP11
.SH NAME
as \- assembler
.SH SYNOPSIS
.B as
[
.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.
.SH FILES
/lib/as2   	pass 2 of the 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.
Commit	Line	Data
8791aa5e DR	1	.TH AS 1 PDP11
	2	.SH NAME
	3	as \- assembler
	4	.SH SYNOPSIS
	5	.B as
	6	[
	7	.B \-
	8	] [
	9	.B \-o
	10	objfile
	11	] file ...
	12	.SH DESCRIPTION
	13	.I As
	14	assembles the concatenation of the named files.
	15	If the optional first argument
	16	.B \-
	17	is used,
	18	all undefined symbols in the assembly
	19	are treated as global.
	20	.PP
	21	The output of the assembly is left on the file
	22	.I objfile;
	23	if that is omitted,
	24	.B a.out
	25	is used.
	26	It is executable if no errors occurred
	27	during the assembly,
	28	and if there were no unresolved external references.
	29	.SH FILES
	30	/lib/as2 pass 2 of the assembler
	31	.br
	32	/tmp/atm[1-3]? temporary
	33	.br
	34	a.out object
	35	.SH "SEE ALSO"
	36	ld(1),
	37	nm(1),
	38	adb(1),
	39	a.out(5)
	40	.br
	41	.I "UNIX Assembler Manual"
	42	by D. M. Ritchie
	43	.SH DIAGNOSTICS
	44	When
	45	an input file cannot be read, its name
	46	followed by a question mark is typed and assembly
	47	ceases.
	48	When syntactic or semantic errors occur, a single-character diagnostic is typed out
	49	together with the line number and the file name in which it
	50	occurred.
	51	Errors in pass 1 cause cancellation of pass 2.
	52	The possible errors are:
	53	.PP
	54	.ta 3
	55	) Parentheses error
	56	.br
	57	] Parentheses error
	58	.br
	59	< String not terminated properly
	60	.br
	61	* Indirection used illegally
	62	.br
	63	.li
	64	\fB.\fR Illegal assignment to `\fB.\fR'
65	.br
66	a Error in address
67	.br
68	b Branch instruction is odd or too remote
69	.br
70	e Error in expression
71	.br
72	f Error in local (`f' or `b') type symbol
73	.br
74	g Garbage (unknown) character
75	.br
76	i End of file inside an if
77	.br
78	m Multiply defined symbol as label
79	.br
80	o Word quantity assembled at odd address
81	.br
82	p `\fB.\fR' different in pass 1 and 2
83	.br
84	r Relocation error
85	.br
86	u Undefined symbol
87	.br
88	x Syntax error
89	.br
90	.SH BUGS
91	Syntax errors can cause incorrect line numbers
92	in following diagnostics.