[unix-history] / usr / src / old / as.vax / as.1

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)as.1	6.3 (Berkeley) %G%
.\"
.TH AS 1 ""
.UC 4
.SH NAME
as \- VAX-11 assembler
.SH SYNOPSIS
.B as
[
.B \-a1-16
] [
[
.B \-d124
] [
.B \-L
] [
.B \-W
] [
.B \-V
] [
.B \-J
] [
.B \-R
] [
.B \-t
directory
] [
.B \-o
objfile ] [ name ... ]
.SH DESCRIPTION
.I As
assembles the named files, or the standard input if no file name is specified.
The available flags are:
.TP
.B \-a
Specifies the alignment of procedures and data blocks.
It is given as a power of two; thus an alignment of 3
causes alignment on an eight byte boundary.
The default is
.B \-a2.
.TP
.B \-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 
.B \-d4.
.TP
.B \-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.
.TP
.B \-V
Use virtual memory for some intermediate storage,
rather than a temporary file.
.TP
.B \-W
Do not complain about errors.
.TP
.B \-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.
.TP
.B \-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.
.TP
.B \-t
Specifies a directory to receive the temporary file, other than
the default /tmp.
.PP
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,
.I a.out
is used.
.SH FILES
.ta 1.5i
/tmp/as\(**	default temporary files
.br
a.out		default resultant object file
.SH "SEE ALSO"
ld(1),
nm(1),
adb(1),
dbx(1),
a.out(5)
.br
Auxiliary documentation
.I Assembler Reference Manual.
.SH AUTHORS
John F. Reiser
.br
Robert R. Henry
.SH BUGS
.B \-J
should be eliminated; the assembler should automatically choose among
byte, word and long branches.
Commit	Line	Data
d8e69841 KM	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
71d59617	5	.\" @(#)as.1 6.3 (Berkeley) %G%
d8e69841	6	.\"
a04b42ee	7	.TH AS 1 ""
d8e69841 KM	8	.UC 4
d8e69841 KM	9	.SH NAME
ff126578	10	as \- VAX-11 assembler
d8e69841 KM	11	.SH SYNOPSIS
	12	.B as
	13	[
43917865 KM	14	.B \-a1-16
	15	] [
	16	[
d8e69841 KM	17	.B \-d124
	18	] [
	19	.B \-L
	20	] [
	21	.B \-W
	22	] [
	23	.B \-V
	24	] [
	25	.B \-J
	26	] [
	27	.B \-R
	28	] [
	29	.B \-t
	30	directory
	31	] [
	32	.B \-o
	33	objfile ] [ name ... ]
	34	.SH DESCRIPTION
	35	.I As
	36	assembles the named files, or the standard input if no file name is specified.
	37	The available flags are:
	38	.TP
43917865 KM	39	.B \-a
	40	Specifies the alignment of procedures and data blocks.
	41	It is given as a power of two; thus an alignment of 3
71d59617	42	causes alignment on an eight byte boundary.
43917865 KM	43	The default is
	44	.B \-a2.
	45	.TP
d8e69841 KM	46	.B \-d
	47	Specifies the number of bytes to be assembled for offsets
	48	which involve forward or external references, and which have sizes unspecified
	49	in the assembly language.
	50	The default is
	51	.B \-d4.
	52	.TP
	53	.B \-L
	54	Save defined labels beginning with a `L', which are normally discarded
	55	to save space in the resultant symbol table.
	56	The compilers generate such temporary labels.
	57	.TP
	58	.B \-V
ff126578 KM	59	Use virtual memory for some intermediate storage,
ff126578 KM	60	rather than a temporary file.
d8e69841 KM	61	.TP
	62	.B \-W
	63	Do not complain about errors.
	64	.TP
	65	.B \-J
	66	Use long branches to resolve jumps when byte-displacement branches are
	67	insufficient. This must be used when a compiler-generated assembly contains
	68	branches of more than 32k bytes.
	69	.TP
	70	.B \-R
	71	Make initialized data segments read-only, by concatenating them to
	72	the text segments.
	73	This obviates the need to run editor scripts on assembly
	74	code to make initialized data read-only and shared.
	75	.TP
	76	.B \-t
	77	Specifies a directory to receive the temporary file, other than
	78	the default /tmp.
	79	.PP
	80	All undefined symbols in the assembly
	81	are treated as global.
	82	.PP
	83	The output of the assembly is left on the file
	84	.I objfile;
	85	if that is omitted,
	86	.I a.out
	87	is used.
	88	.SH FILES
	89	.ta 1.5i
ff126578	90	/tmp/as\(** default temporary files
d8e69841 KM	91	.br
	92	a.out default resultant object file
	93	.SH "SEE ALSO"
	94	ld(1),
	95	nm(1),
	96	adb(1),
ff126578	97	dbx(1),
d8e69841 KM	98	a.out(5)
	99	.br
	100	Auxiliary documentation
	101	.I Assembler Reference Manual.
	102	.SH AUTHORS
	103	John F. Reiser
	104	.br
	105	Robert R. Henry
	106	.SH BUGS
	107	.B \-J
	108	should be eliminated; the assembler should automatically choose among
	109	byte, word and long branches.