HP-UX Reference (11i v1 05/09) - 1 User Commands A-M (vol 1)

a
as(1) as(1)
NAME
as - assembler (Precision Architecture)
SYNOPSIS
as [[option]... [file] ... ]...
DESCRIPTION
The
as command assembles source text from files or standard input and produces a relocatable object file
suitable for the link editor, ld (see ld(1).
Source text is read from standard input only if no file argument is given. Standard input cannot be a device
file, such as a terminal. The option and file arguments can be intermingled on the command line. Every
specified option applies to every specified file, or standard input. The source files are concatenated to form
a single input stream.
If the
-o objfile option is not specified, the
.s suffix (if any) is stripped from the end of the last source file
name and
.o is appended to the name to form the name of the default object code output file.
as output is not optimized. as creates a relocatable object file that must be processed by
ld before it can
be successfully executed (see ld(1)).
The
cc compiler normally runs the C preprocessor cpp (see cpp(1)), then invokes as to assemble the
.s
files together with /usr/lib/pcc_prefix.s
, and subsequently invokes ld.
Arguments
as recognizes the following arguments.
file A text file contain assembler source code.
option An option described below in Options.
Options
as recognizes the following values for the option argument.
-e Permit an unlimited number of errors to be tolerated before the assembly process is
abandoned. By default, one hundred errors are allowed before the assembler
aborts.
-f Set the default value for the .CALLINFO directive to CALLS, The normal default
value for a .CALLINFO that omits the CALLER, CALLS or NO_CALLS parameter
is NO_CALLS.
-l Write a listing of the program to standard output after assembly. This listing shows
the offsets of instructions and actual values for fields.
-o objfile Name the output object file objfile instead of using the default
.o suffix on the file
name of the last file specified.
-p number Set the default privilege level for an .EXPORT directive to number. By default, all
user-level procedures are exported at privilege level 3.
-s Set the output file suffix to .ss instead of .o. The file will have a format suitable
for conversion to the ROM burning programs.
-u Do not create unwind descriptors. To avoid the need for the .CALLINFO directive,
the .ENTER and .LEAVE directives must not have been used.
-v xrfile Write cross-reference data to the file named xrfile.
-V Print the version number of the assembler program to standard error before assem-
bling the source text.
-w[number] Either suppress all warning messages if no number is supplied or suppress just the
warning number provided. Multiple -wnumber options can be used to suppress
additional warning messages.
+DAarchitecture Assemble code for the architecture specified. The use of this option is discouraged.
The preferred method for selecting the architecture is to have a .LEVEL directive
contained within the assembly source file.
Section 1−−24 Hewlett-Packard Company − 1 − HP-UX 11i Version 1: September 2005