as_pa.1 (2010 09)

a
as_pa(1) PA-RISC Systems Only
as_pa(1)
NAME
as_pa: as - assembler for PA-RISC systems
SYNOPSIS
as [-eflsuV][-o
objfile][-p number][-v xrfile][
-w[number] ]... [+DAarchitecture ][+z][
+Z]
[file]...
Remarks
This manpage describes as on PA-RISC systems. For
as on Integrity systems, see as_ia (1).
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 dev-
ice 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.
Options and Operands
as recognizes the following options and operands:
file A text file containing assembler source code.
-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.
+DA architecture
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.
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1