|
|
1.1 root 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: .\"
5: .\" @(#)as.1 6.3 (Berkeley) 5/8/86
6: .\"
7: .TH AS 1 "May 8, 1986"
8: .UC 4
9: .SH NAME
10: as \- VAX-11 assembler
11: .SH SYNOPSIS
12: .B as
13: [
14: .B \-a1-16
15: ] [
16: [
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
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
42: causes alignment on an eight byte boundary.
43: The default is
44: .B \-a2.
45: .TP
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
59: Use virtual memory for some intermediate storage,
60: rather than a temporary file.
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
90: /tmp/as\(** default temporary files
91: .br
92: a.out default resultant object file
93: .SH "SEE ALSO"
94: ld(1),
95: nm(1),
96: adb(1),
97: dbx(1),
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.
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.