Go to the first, previous, next, last section, table of contents.

The Free Software Foundation Inc. thanks The Nice Computer Company of Australia for loaning Dean Elsner to write the first (Vax) version of as for Project GNU. The proprietors, management and staff of TNCCA thank FSF for distracting the boss while they got some work done.

Permission is granted to make and distribute verbatim copies of this manual provided the copyright notice and this permission notice are preserved on all copies.

Permission is granted to copy and distribute modified versions of this manual under the conditions for verbatim copying, provided that the entire resulting derived work is distributed under the terms of a permission notice identical to this one.

Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions.

Overview

This manual is a user guide to the GNU assembler . This version of the manual describes configured to generate code for architectures.

Here is a brief summary of how to invoke . For details, see section Command-Line Options.

 [ -a[cdhlns][=file] ] [ -D ]  [ --defsym sym=val ]
 [ -f ] [ --help ] [ -I dir ] [ -J ] [ -K ] [ -L ]
 [ -o objfile ] [ -R ] [ --statistics ] [ -v ] [ -version ]
 [ --version ] [ -W ] [ -w ] [ -x ] [ -Z ]

 [ -- | files ... ]

-a[dhlns]

Turn on listings, in any of a variety of ways:

-ad: omit debugging directives
-ah: include high-level source
-al: include assembly
-an: omit forms processing
-as: include symbols
=file: set the name of the listing file

You may combine these options; for example, use `-aln' for assembly listing without forms processing. The `=file' option, if used, must be the last one. By itself, `-a' defaults to `-ahls'---that is, all listings turned on.

-D

Ignored. This option is accepted for script compatibility with calls to other assemblers.

--defsym sym=value

Define the symbol sym to be value before assembling the input file. value must be an integer constant. As in C, a leading `0x' indicates a hexadecimal value, and a leading `0' indicates an octal value.

-f

"fast"---skip whitespace and comment preprocessing (assume source is compiler output).

--help

Print a summary of the command line options and exit.

-I dir

Add directory dir to the search list for .include directives.

-J

Don't warn about signed overflow.

-K

This option is accepted but has no effect on the family.

-L

Keep (in the symbol table) local symbols, starting with `L'.

-o objfile

Name the object-file output from objfile.

-R

Fold the data section into the text section.

--statistics

Print the maximum space (in bytes) and total time (in seconds) used by assembly.

-v

-version

Print the as version.

--version

Print the as version and exit.

-W

Suppress warning messages.

-w

Ignored.

-x

Ignored.

-Z

Generate an object file even after errors.

-- | files ...

Standard input, or source files to assemble.

Go to the first, previous, next, last section, table of contents.