Return to mc68as.1 CVS log

Up to [Research Unix] / researchv10dc / 630 / man / src / u_man / man1

Annotation of researchv10dc/630/man/src/u_man/man1/mc68as.1, revision 1.1.1.1

1.1       root        1: .TH MC68AS 1 "630 MTG"
                      2: .SH NAME
                      3: mc68as \- \*N MC68000 assembler
                      4: .SH SYNOPSIS
                      5: .BR mc68as
                      6: .RB "[" \-o " objfile]"
                      7: .if 'mc68'x86' .RB \-x
                      8: .if 'mc68'3b' .RB "[" \-Q "]"
                      9: .RB "[" \-n "]"
                     10: .RB "[" \-m "]"
                     11: .RB "[" \-R "]"
                     12: .RB "[" \-V "]"
                     13: file-name
                     14: .SH DESCRIPTION
                     15: The 
                     16: .I mc68as
                     17: command
                     18: assembles the named file.
                     19: .if 'mc68'b16' \{\
                     20: The output file is executable if no errors
                     21: occurred during the assembly, transfer vectors were not used,
                     22: and there are no unresolved external references.\}
                     23: The following flags
                     24: may be specified in any order:
                     25: .TP \w'\fB\-o\fP\ \fIobjfile\fP\ \ 'u
                     26: .BI \-o " objfile"
                     27: Puts the output of the assembly in
                     28: .IR objfile .
                     29: By default, the output file name is formed by
                     30: removing the 
                     31: .B .s
                     32: suffix, if there is one, from the input file name
                     33: and appending a 
                     34: .B .o
                     35: suffix.
                     36: .if 'mc68'x86' \{\
                     37: .TP
                     38: .B \-x
                     39: This
                     40: flag is
                     41: .I required
                     42: for all x86 files.
                     43: \}
                     44: .if 'mc68'3b' \{
                     45: .TP
                     46: .B \-Q
                     47: Warn the user if a transfer vector operand is used
                     48: in any context other than a "call" instruction.
                     49: \}
                     50: .TP
                     51: .B \-n
                     52: Turns off long/short address optimization.
                     53: By default, address optimization takes place.
                     54: .TP
                     55: .B \-m
                     56: Runs the 
                     57: .I m4
                     58: macro pre-processor
                     59: on the input to the assembler.
                     60: .TP
                     61: .B \-R
                     62: Removes (unlinks) the input file after assembly
                     63: is completed.
                     64: .TP
                     65: .B \-V
                     66: Writes the version number of the assembler being run
                     67: on the standard error output.
                     68: .SH FILES
                     69: .RI /tmp/mc68a[A-L]AAa XXXXXX
                     70: temporary files
                     71: .SH "SEE ALSO"
                     72: mc68ld(1),
                     73: mc68nm(1),
                     74: mc68strip(1).
                     75: .br
                     76: a.out(4) in the \f2UNIX System V Programmer's Reference
                     77: Manual\f1.
                     78: .br
                     79: m4(1) in the
                     80: \f2UNIX System V User's Reference Manual\f1.
                     81: .br
                     82: \f2UNIX Assembler User's Guide for the Motorola 68000\f1 in the
                     83: \f2630 MTG Software Development Guide\f1.
                     84: .SH WARNING
                     85: .if 'mc68'3b' \{
                     86: .PP
                     87: If the input file does not contain a 
                     88: .B .file
                     89: assembler directive and the
                     90: .B \-m
                     91: flag was not specified,
                     92: the file name given by the assembler when an
                     93: error occurs is one of the temporary files
                     94: .RB ( /usr/tmp/mc68as \s-1XXXXXX\s+1)
                     95: \}
                     96: .PP
                     97: If the 
                     98: .B \-m
                     99: .RI ( m4
                    100: macro pre-processor invocation) option is used,
                    101: keywords for
                    102: .I m4
                    103: .RI "[see " m4 (1)]
                    104: cannot be used as symbols (variables, functions, labels)
                    105: in the input file since
                    106: .I m4
                    107: cannot determine which are assembler symbols and 
                    108: which are real 
                    109: .I m4
                    110: macros.
                    111: .SH BUGS
                    112: The
                    113: .B even
                    114: assembler directive is not guaranteed to work
                    115: in the
                    116: .B .text
                    117: section when optimization is performed.
                    118: .PP
                    119: Arithmetic expressions may only have
                    120: one forward referenced symbol per expression.

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