AT&T UNIX™PC Unix System V Users Manual - tenox

AS ( l ) ( AT&T UNIX PC Only ) AS ( l )
NAME as - assembler
SYNOPSIS
a.s [-o objfile] [- n] [-j] [- m] [-R] [- r] [- bwi]
[-V] [- T] sourcefile
DESCRIPTION
The as command translates mc68010 or mc68020 assembly
language in sourcefile into object code. The result is a common
object file, suitable for input to the link editor. The following flags
may be specified in any order:
-o obJfile
Put the output of the assembly in objfile. By default,
the output file name is formed by removing the .s suffix,
if there is one, from the input file name and appending
a .o suffix.
-n Turn off long/short address optimization. By default,
address optimization takes place.
-j Invoke the long-jump assembler. The address optimization
algorithm chooses between long and short address
lengths, with short lengths chosen when possible.
Often, three distinct lengths are allowed by the machine
architecture; a choice must be made between two of
those lengths. When the two choices given to the
assembler exclude the largest length allowed, then some
addresses might be unrepresentable. The long-jump
assembler will always have the largest length as one of
its allowable choices. If the assembler is invoked
without this option, and the case arises where an
address is unrepresentable by either of the two allowed
choices, then the user will be informed of the error, and
advised to try again using the -j option.
- m Run the m..f. macro pre-processor on the input to the
assembler.
-R Remove (unlink) the input file after assembly is completed.
- r Place all assembled data (normally placed in the data.
section) into the text section. This option effectively
disables the .data. pseudo operation. This option is off
by default.
- [bw I] Create byte (b), halfword ( w) or long (I) displacements
for undefined symbols. (An undefined symbol is a reference
to a symbol whose definition is external to the
input file or a forward reference.) The default value for
this option is long (I) displacements.
-V Write the version number of the assembler being run on
the standard error output.
-T Truncate symbols to eight characters.
- 1 -