as - assembler (Precision Architecture)
as [[option]... [file] ... ]...
The as command assembles source text from files or standard input and
produces a relocatable object file suitable for the link editor, ld
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
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
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.
as recognizes the following arguments.
file A text file contain assembler source code.
option An option described below in 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.
Hewlett-Packard Company - 1 - HP-UX Release 11i: November 2000
-l Write a listing of the program to standard
output after assembly. This listing shows the
offsets of instructions and actual values for
-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
-V Print the version number of the assembler
program to standard error before assembling the
-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.
The assembler uses the following precedence to
determine the target architecture.
1. Use the .LEVEL directive within the
assembly source file.
2. Use the +DA command-line specification.
3. Use the default architecture of
+z,+Z Both of these options are used in the building
of shared libraries. For a more complete
discussion regarding these options, see the
Hewlett-Packard Company - 2 - HP-UX Release 11i: November 2000
manual HP-UX Linker and Libraries User's Guide.
International Code Set Support
Single- and multibyte character code sets are supported.
When syntactic or semantic errors occur, a single-line diagnostic is
written to standard error, that includes the file name and the line
number where it occurred. The format is as follows:
as: "filename",line line: error error: message
source = source-line
as does not invoke cpp(1) or m4(1) to perform macro processing.
/usr/include/hard_reg.hr Hardware register definitions
/usr/include/soft_reg.h Software calling convention
/usr/include/std_space.h Standard space and subspace
/usr/lib/nls/msg/C/as.cat Assembler error message
/usr/lib/pcc_prefix.s Space, subspace and register
file.o Object file
adb(1), cc_bundled(1), ld(1), nm(1), crt0(3).
Assembly Language Reference Manual,
Precision Architecture and Instruction Reference Manual,
Procedure Calling Conventions Reference Manual.
Hewlett-Packard Company - 3 - HP-UX Release 11i: November 2000