Annotation of 43BSDTahoe/man/man1/as.1, revision 1.1.1.1

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.

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.