HP-UX Reference (11i v2 03/08) - 1 User Commands A-M (vol 1)

a
as(1) as(1)
(Itanium(R)-based System Only)
NAME
as - assembler (Itanium Processor Family)
SYNOPSIS
as [ option ...] [ file ]
DESCRIPTION
as assembles the named source file file, or the standard input if file is not specified. The output of the
assembler is an ELF relocatable object file that must be processed by
ld before it can be executed.
Assembler output is stored in file outfile. If the
-o outfile option is not specified, the assembler constructs
a default name. If no source file is specified, outfile will be
a.out; otherwise the .s suffix (if present) is
stripped from the name of the source file and
.o is appended to it. Any directory names are removed
from the name so that the object file is always written to the current directory.
as does not not perform any macro processing. Standard C preprocessor constructs can be used if the
assembler is invoked through the C compiler.
Options
as recognizes the following options.
+A32 Specify that the source file contains 32-bit ABI targeted code. This option is overridden by
the .psr abi64 assembler directive in the source file. The object file is a 32-bit ELF file
by default.
+A64 Specify that the source file contains 64-bit ABI targeted code. This option is overridden by
the .psr abi32 assembler directive in the source file. The object file is a 64-bit ELF file
by default.
+E32 Specify that the object file should be 32-bit ELF. This is the default (see also
+A32). Note
that it is valid to write 64-bit ABI targeted code to a 32-bit ELF file. All 32-bit addresses in
the object file are zero-extended to 64-bit upon loading. Zero-extension, however, may
invalidate any negative addresses (such as with relocations).
-elf32 See +E32.
+E64 Specify that the object file should be 64-bit ELF (see also +A64).
-elf64 See +E64.
-o outfile Produce an output object file with the name outfile instead of constructing a default name.
EXTERNAL INFLUENCES
Environment Variables
NLSPATH determines the location of the message catalog for the processing of LC_MESSAGES.
SDKROOT controls which assembler to invoke and enables support for multiple (cross-) development kits.
The SDKROOT variable points to the root of a specific SDK. No provision has been made to validate the
value of the variable or the suitability of the assembler that’s being invoked.
International Code Set Support
Single- and multi-byte character code sets are supported.
WARNINGS
The assembler does not check dependencies.
DIAGNOSTICS
When syntactic or semantic errors occur, a single-line diagnostic is displayed on standard error, together
with the line number and the file name in which it occurred.
FILES
/usr/lib/nls/C/as.cat assembler error message catalog
a.out default assembler output file
SEE ALSO
cc(1), elf(3E), ld(1).
HP-UX 11i Version 2: August 2003 − 1 − Hewlett-Packard Company Section 1−−29