as_pa(1) General Commands Manual as_pa(1)
NAME
as_pa: as - assembler for PA-RISC systems
SYNOPSIS
[file]...
Remarks
This manpage describes on PA-RISC systems. For on Integrity systems, see as_ia(1).
DESCRIPTION
The command assembles source text from files or standard input and produces a relocatable object file suitable for the link editor, (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 option is not specified, the suffix (if any) is stripped from the end of the last source file name and is appended to the name to
form the name of the default object code output file.
output is not optimized. creates a relocatable object file that must be processed by before it can be successfully executed (see ld(1)).
The compiler normally runs the C preprocessor (see cpp(1)), then invokes to assemble the files together with and subsequently invokes
Options and Operands
recognizes the following options and operands:
file A text file containing assembler source code.
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.
Set the default value for the
directive to The normal default value for a that omits the or parameter is
Write a listing of the program to standard output after assembly.
This listing shows the offsets of instructions and actual values for fields.
Name the output object file
objfile instead of using the default suffix on the file name of the last file specified.
Set the default privilege level for an
directive to number. By default, all user-level procedures are exported at privilege level 3.
Set the output file suffix to
instead of The file will have a format suitable for conversion to the ROM burning programs.
Do not create unwind descriptors.
To avoid the need for the directive, the and directives must not have been used.
Write cross-reference data to the file named
xrfile.
Print the version number of the assembler program to standard error
before assembling the source text.
Either suppress all warning messages if no
number is supplied or suppress just the warning number provided. Multiple options can be used to suppress additional
warning messages.
Assemble code for the
architecture specified. The use of this option is discouraged. The preferred method for selecting the architecture
is to have a directive contained within the assembly source file.
The assembler uses the following precedence to determine the target architecture.
1. Use the directive within the assembly source file.
2. Use the command-line specification.
3. Use the default architecture of
Both of these options are used in the building of shared libraries.
For a more complete discussion regarding these options, see the manual
EXTERNAL INFLUENCES
International Code Set Support
Single- and multibyte character code sets are supported.
DIAGNOSTICS
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
does not invoke cpp(1) or m4(1) to perform macro processing.
FILES
Hardware register definitions
Software calling convention register definitions
Standard space and subspace definition
Assembler error message catalog
Space, subspace and register definitions
Object file
SEE ALSO
adb(1), cc_bundled(1), cpp(1), ld(1), nm(1), crt0(3).
PA-RISC Systems Only as_pa(1)
