NAME
as — assembler (IA-64 Itanium Processor Family)
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.
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
WARNINGS
The assembler does not check dependencies.
Printable version
