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 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
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 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
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
as
does not invoke
cpp(1)
or
m4(1)
to perform macro processing.
FILES
- /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
Printable version
