Return to as.1 CVS log

Up to [Power 6/32 Unix Tahoe 4.2BSD] / cci / usr / src / man / man1

Annotation of cci/usr/src/man/man1/as.1, revision 1.1.1.1

1.1       root        1: .TH AS 1 TAHOE
                      2: .UC 4
                      3: .SH NAME
                      4: as \- assembler
                      5: .SH SYNOPSIS
                      6: .B as
                      7: [
                      8: .B \-d124
                      9: ] [
                     10: .B \-L
                     11: ] [
                     12: .B \-W
                     13: ] [
                     14: .B \-V
                     15: ] [
                     16: .B \-J
                     17: ] [
                     18: .B \-R
                     19: ] [
                     20: .B \-t
                     21: directory
                     22: ] [
                     23: .B \-P
                     24: ] [
                     25: .B \-o
                     26: objfile ] [ name ... ]
                     27: .SH DESCRIPTION
                     28: .I As
                     29: assembles the named files, or the standard input if no file name is specified.
                     30: The available flags are:
                     31: .TP
                     32: .B \-d
                     33: Specifies the number of bytes to be assembled for offsets
                     34: which involve forward or external references, and which have sizes unspecified
                     35: in the assembly language.
                     36: The default is 
                     37: .B \-d4.
                     38: .TP
                     39: .B \-L
                     40: Save defined labels beginning with a `L', which are normally discarded
                     41: to save space in the resultant symbol table.
                     42: The compilers generate such temporary labels.
                     43: .TP
                     44: .B \-V
                     45: Use virtual memory for intermediate storage, rather than a temporary file.
                     46: .TP
                     47: .B \-W
                     48: Do not complain about errors.
                     49: .TP
                     50: .B \-J
                     51: Use long branches to resolve jumps when byte-displacement branches are
                     52: insufficient.  This must be used when a compiler-generated assembly contains
                     53: branches of more than 32k bytes.
                     54: .TP
                     55: .B \-R
                     56: Make initialized data segments read-only, by concatenating them to
                     57: the text segments.
                     58: This obviates the need to run editor scripts on assembly
                     59: code to make initialized data read-only and shared.
                     60: .TP
                     61: .B \-t
                     62: Specifies a directory to receive the temporary file, other than
                     63: the default /tmp.
                     64: .TP
                     65: .B \-P
                     66: Creates the assembler printout on standard output; the 
                     67: format of the printout:                                                         
                     68: `line-number    pc    memory-layout        source-line`
                     69: If the source line is in a data segment, the 'pc' field will be 
                     70: followed by a '*'.
                     71: .PP
                     72: All undefined symbols in the assembly
                     73: are treated as global.
                     74: .PP
                     75: The output of the assembly is left on the file
                     76: .I objfile;
                     77: if that is omitted,
                     78: .I a.out
                     79: is used.
                     80: .SH FILES
                     81: .ta 1.5i
                     82: /tmp/as\(**    default temporary file
                     83: .br
                     84: a.out          default resultant object file
                     85: .SH "SEE ALSO"
                     86: ld(1),
                     87: nm(1),
                     88: adb(1),
                     89: sdb(1),
                     90: a.out(5)
                     91: .br
                     92: Auxiliary documentation
                     93: .I Assembler Reference Manual.
                     94: .SH AUTHORS
                     95: John F. Reiser
                     96: .br
                     97: Robert R. Henry
                     98: .SH BUGS
                     99: .B \-J
                    100: should be eliminated; the assembler should automatically choose among
                    101: byte, word and long branches.

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