 |
Index for
Section 1 |
|
 |
Alphabetical
listing for A |
|
 |
Bottom of
page |
|
as(1)
NAME
as - assembler
SYNOPSIS
as [option]... file
OPTIONS
The following options are interpreted by as and have the same meaning in
cc(1).
-g0 Produce no symbol table information for symbolic debugging. This is
the default.
-g1 Produce additional symbol table information for accurate but limited
symbolic debugging of partially optimized code.
-g or -g2
Produce additional symbol table information for full symbolic debugging
and not do optimizations that limit full symbolic debugging.
-g3 Produce additional symbol table information for full symbolic debugging
for fully optimized code. This option makes the debugger inaccurate.
-compress
Produce a compressed object as output.
-O0 Performs no optimization.
-O1 Runs the instruction scheduler and peepholes.
-w Suppress warning messages.
-P Run only the C macro preprocessor and put the result in a file with the
suffix of the source file changed to .i or if the file has no suffix
then a i is added to the source file name. The .i file has no # lines
in it. This sets the -cpp option.
-E Run only the C macro preprocessor on the file and send the result to
the standard output. This sets the -cpp option.
-C or -M or -Q
These three options are passed directly to cpp(1). Please see cpp(1)
for details.
-eflag number
Set the default exception handling runtime procedure descriptor flags
(see <pdsc.h>) to the number specified. If you provide a .eflag
directive in a procedure in your source code, the -eflag option is
ignored for that procedure.
-o output
Name the final output file output. If this option is used, the file
a.out is undisturbed.
-Dname=def
"-Dname" Define the name to the C macro preprocessor, as if by #define.
If no definition is given, the name is defined as "1".
-Uname
Remove any initial definition of name.
-I dir
The #include files whose names do not begin with `/' are always sought
first in the directory of the file argument, then in directories
specified in -I options, and finally in the standard directory
(/usr/include).
-I This option will cause #include files never to be searched for in the
standard directory (/usr/include).
-v Print the passes as they execute with their arguments and their input
and output files.
-V Print the version of the driver and the versions of all passes. This
is done with the what(1) command.
-cpp
Run the C macro preprocessor on assembly source files before compiling.
This is the default for as.
-nocpp
Do not run the C macro preprocessor on assembly source files before
compiling.
-tune option
Select processor-specific instruction tuning for a specific
implementation of the Alpha architecture. Tuning for a specific
implementation can provide improvements in run-time performance.
Regardless of the setting of the -tune option, the generated code will
run correctly on all implementations of the Alpha architecture. Note
that code tuned for a specific target may run more slowly on another
target than generically-tuned code.
The option keyword can be one of the following:
generic
Selects instruction tuning that is appropriate for all
implementations of the Alpha architecture. This option is the
default.
host
Selects instruction tuning that is appropriate for the machine on
which the code is being compiled.
ev4 Selects instruction tuning for the 21064, 21064A, 21066, and 21068
implementations of the Alpha architecture.
ev5 Selects instruction tuning for the 21164 implementation of the
Alpha architecture.
The following options are specific for as:
-m[md],directory
Apply the M4 preprocessor to the source file before assembling it.
-Y Specifies the location of the m4 preprocessor (when the modifier is m)
or cm4defs, the file of predefined macros (when the modifier is d), as
the directory directory. The default location for the predefined macros
is /usr/opt/svr4/usr/ccs/lib/cm4defs.
The options described below primarily aid compiler development and are not
generally used:
-Hc Halt compiling after the pass specified by the character c, producing
an intermediate file for the next pass. The c can be a. It selects the
assembler pass in the same way as the -t option. If this option is
specified, the symbol table file produced and used by the passes is the
last component of the source file with the suffix changed to .T, or a T
is added if the source file has no suffix. This file is not removed.
-K Build and use intermediate file names with the last component of the
source file's name replacing its suffix with the conventional suffix
for the type of file (for example G file for binary assembly language).
If the source file has no suffix, the conventional suffix is added to
the source file name. These intermediate files are never removed even
when a pass encounters a fatal error.
-Wc[c...],arg1,[arg2...]
Pass the argument[s] argi to the compiler pass[es] c[c..]. The c can
be one of [ pab]. The c selects the compiler pass in the same way as
the -t option.
The options -t[ hpab], -h path, and -Bstring select a name to use for a
particular pass. These arguments are processed from left to right so their
order is significant. When the -B option is encountered, the selection of
names takes place using the last -h and -t options. Therefore, the -B
option is always required when using -h or -t. Sets of these options can be
used to select any combination of names.
-t[ hpab]
Select the names. The names selected are those designated by the
characters following the -t option according to the following table:
______________________________________
Name Character
______________________________________
include h (see note following table)
cpp p
as0 a
as1 b
______________________________________
If the character `h' is in the -t argument, a directory is added to the
list of directories to be used in searching for #include files. This
directory name has the form COMP_TARGET_ROOT/usr/includestring. This
directory is to contain the include files for the string release of the
compiler. The standard directory is still searched.
-hpath
Use path rather than the directory where the name is normally found.
-Bstring
Append string to all names specified by the -t option. If no -t option
has been processed before the -B, the -t option is assumed to be
"hpab". This list designates all names.
Invoking the assembler with a name of the form asstring has the same effect
as using a -Bstring option on the command line.
If the environment variable COMP_HOST_ROOT is set, the value is used as the
root directory for all paths to the pass names other than the default root
directory ( /). If the environment variable COMP_TARGET_ROOT is set, the
value is used as the root directory for the #include files other than the
default root directory (/).
If the environment variable ROOTDIR is set, the value is used as the root
directory for all names rather than the default /usr/. This also affects
the standard directory for #include files, /usr/include.
If the environment variable TMPDIR is set, the value is used as the
directory to place any temporary files rather than the default /tmp/.
Other arguments are ignored.
DESCRIPTION
The assembler, as, produces files in the following formats: object code in
extended coff format (the normal result) and binary assembly language. The
as command never runs the link editor (ld(1)). The as command accepts one
type of argument.
The argument file is assumed to be a symbolic assembly language source
program. It is assembled, producing an object file.
The assembler always defines the C preprocessor macros unix, and
LANGUAGE_ASSEMBLY to the C macro preprocessor. To see a list of predefined
macros, use the -v option.
ERRORS
The diagnostics produced by the assembler are intended to be self-
explanatory.
FILES
file.o
object file
a.out
assembler output
/tmp/ctm?
temporary
/usr/lib/cpp
C macro preprocessor
/usr/lib/cmplrs/cc/as0
symbolic to binary assembly language translator
/usr/lib/cmplrs/cc/as1
binary assembly language assembler and reorganizer
/usr/include
standard directory for #include files
SEE ALSO
Commands: cc(1), what(1)
Programmer's Guide, Assembly Language Programmer's Guide
|
Index for
Section 1 |
|
|
Alphabetical
listing for A |
|
 |
Top of
page |
|