as_pa(1) as_pa(1)
For PA-RISC Systems
NAME [Toc] [Back]
as_pa: as - assembler for PA-RISC systems
SYNOPSIS [Toc] [Back]
as [-eflsuV] [-o objfile] [-p number] [-v xrfile] [-w[number]]...
[+DAarchitecture] [+z] [+Z] [file]...
DESCRIPTION [Toc] [Back]
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.
Options and Operands [Toc] [Back]
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.
Hewlett-Packard Company - 1 - HP-UX 11i Version 2: Sep 2004
as_pa(1) as_pa(1)
For PA-RISC Systems
-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 assembling 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.
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
PA_RISC_1.0.
+z,+Z Both of these options are used in the building of
shared libraries. For a more complete discussion
regarding these options, see the manual HP-UX
Linker and Libraries User's Guide.
EXTERNAL INFLUENCES [Toc] [Back]
Hewlett-Packard Company - 2 - HP-UX 11i Version 2: Sep 2004
as_pa(1) as_pa(1)
For PA-RISC Systems
International Code Set Support [Toc] [Back]
Single- and multibyte character code sets are supported.
DIAGNOSTICS [Toc] [Back]
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
WARNINGS [Toc] [Back]
as does not invoke cpp(1) or m4(1) to perform macro processing.
FILES [Toc] [Back]
/usr/include/hard_reg.h Hardware register definitions
/usr/include/soft_reg.h Software calling convention
register definitions
/usr/include/std_space.h Standard space and subspace
definition
/usr/lib/nls/msg/C/as.cat Assembler error message
catalog
/usr/lib/pcc_prefix.s Space, subspace and register
definitions
file.o Object file
SEE ALSO [Toc] [Back]
adb(1), cc_bundled(1), cpp(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 11i Version 2: Sep 2004 [ Back ] |
