a

as(1)

as(1)

NAME

as - assembler (Precision Architecture)

SYNOPSIS

as [ [option]... [®le] ... ]...

DESCRIPTION

The as command assembles source text from ®les or standard input and produces a relocatable object ®le suitable for the link editor, ld (see ld(1).

Source text is read from standard input only if no ®le argument is given. Standard input cannot be a device ®le, such as a terminal. The option and ®le arguments can be intermingled on the command line. Every speci®ed option applies to every speci®ed ®le, or standard input. The source ®les are concatenated to form a single input stream.

If the -oobj®le option is not speci®ed, the .s suf®x (if any) is stripped from the end of the last source ®le name and .o is appended to the name to form the name of the default object code output ®le.

as output is not optimized. as creates a relocatable object ®le 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 ®les together with /usr/lib/pcc_prefix.s, and subsequently invokes ld.

Arguments

as recognizes the following arguments.

file

A text ®le contain assembler source code.

option

An option described below in Options.

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.

-l

Write a listing of the program to standard output after assembly. This listing shows

 

the offsets of instructions and actual values for ®elds.

-oobjfile

Name the output object ®le obj®le instead of using the default .o suf®x on the ®le

 

name of the last ®le speci®ed.

-pnumber

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 ®le suf®x to .ss instead of .o. The ®le 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.

-vxrfile

Write cross-reference data to the ®le named xr®le.

-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 -wnumberoptions can be used to suppress

 

additional warning messages.

+DAarchitecture Assemble code for the architecture speci®ed. 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 ®le.

Section 1−24

− 1 −

HP-UX Release 11i: December 2000