NAME
as_ia: as — assembler for Integrity systems
SYNOPSIS
as
[-eVw]
[+A32]
[+A64]
[+E32]
[-elf32]
[-elf64]
-H lvl[=what[,what]...]
[-o
outfile]
-W num[,num]...
-We num[,num]...
[file]
Remarks
This manpage describes
as
on Integrity systems.
For
as
on PA-RISC systems, see
as_pa(1).
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.
- -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.
- +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).
- +E64
Specify that the object file should be 64-bit ELF (see also
+A64).
- -elf32
See
+E32.
- -elf64
See
+E64.
- -H lvl[=what[,what]...]
Set dependency checking.
lvl
must be one of the following:
off,
warn,
or
err.
what
must be one of the following:
data,
impl,
or
inst.
- -o outfile
Produce an output object file with the name
outfile
instead of constructing a default name.
- -V
Print the version information to stderr before assembling the input.
- -W num[,num]...
Suppress the specified warning messages.
- -We num[,num]...
Promote the specified warning messages to errors.
- -w
Suppress all warning messages.
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
Printable version
