\input texinfo
@c $Id$
-@c @tex
-@c \special{twoside}
-@c @end tex
_if__(_GENERIC__)
@setfilename as.info
_fi__(_GENERIC__)
-_if__(_AMD29K__ && !_GENERIC__)
+_if__(_A29K__ && !_GENERIC__)
@setfilename as-29k.info
-_fi__(_AMD29K__ && !_GENERIC__)
+_fi__(_A29K__ && !_GENERIC__)
_if__(_I960__ && !_GENERIC__)
@setfilename as-960.info
_fi__(_I960__ && !_GENERIC__)
@settitle Using _AS__ (_HOST__)
_fi__(!_GENERIC__)
@titlepage
-@title{Using _AS__}
-@subtitle{The GNU Assembler}
+@title Using _AS__
+@subtitle The GNU Assembler
_if__(!_GENERIC__)
-@subtitle{for the _HOST__ family}
+@subtitle for the _HOST__ family
_fi__(!_GENERIC__)
@sp 1
@subtitle March 1991
distracting the boss while they got some work
done.
@sp 3
-@author{Dean Elsner, Jay Fenlason & friends}
+@author Dean Elsner, Jay Fenlason & friends
@c edited by: pesch@cygnus.com
@page
@tex
\def\$#1${{#1}} % Kluge: collect RCS revision info without $...$
\xdef\manvers{\$Revision$} % For use in headers, footers too
{\parskip=0pt
-\hfill edited by Roland Pesch\par
-\hfill for Cygnus Support\par
\hfill \manvers\par
\hfill \TeX{}info \texinfoversion\par
}
\gdef\ibox#1#2{\hbox to #1{#2\hfil}\kern8pt}% invisible box
@end tex
+Edited by Roland Pesch for Cygnus Support.
+
@vskip 0pt plus 1filll
Copyright @copyright{} 1991 Free Software Foundation, Inc.
Here is a brief summary of how to invoke @code{_AS__}. For details,
@pxref{Invoking,,Comand-Line Options}.
-@c We don't use @deffn and friends for the following because they seem
+@c We don't use deffn and friends for the following because they seem
@c to be limited to one line for the header.
@smallexample
_AS__ [ -D ] [ -f ] [ -I @var{path} ] [ -k ] [ -L ]
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
-_if__(_AMD29K__)
+_if__(_A29K__)
@c am29k has no machine-dependent assembler options
-_fi__(_AMD29K__)
+_fi__(_A29K__)
_if__(_I960__)
@c see md_parse_option in i960.c
[ -ACA | -ACA_A | -ACB | -ACC | -AKA | -AKB | -AKC | -AMC ]
Add @var{path} to the search list for @code{.include} directives
@item -k
-_if__((!_GENERIC__) && (_AMD29K__ || _I960__))
+_if__((!_GENERIC__) && (_A29K__ || _I960__))
This option is accepted but has no effect on the _HOST__ family.
-_fi__((!_GENERIC__) && (_AMD29K__ || _I960__))
+_fi__((!_GENERIC__) && (_A29K__ || _I960__))
_if__(_GENERIC__)
Issue warnings when difference tables altered for long displacements.
_fi__(_GENERIC__)
@item -R
Fold data segment into text segment
+@item -v
+Announce @code{as} version
+
@item -W
Suppress warning messages
@node Object Formats, Command Line, GNU Assembler, Overview
@section Object File Formats
The GNU assembler can be configured to produce several alternative
-object file formats.
+object file formats. For the most part, this does not affect how you
+write assembly language programs; but directives for debugging symbols
+are typically different in different file formats. @xref{Symbol
+Attributes,,Symbol Attributes}.
_if__(!_GENERIC__)
_if__(!_I960__)
-@code{_AS__} is configured to produce @code{a.out} format object
+On the _HOST__, @code{_AS__} is configured to produce @code{a.out} format object
files.@refill
_fi__(!_I960__)
_if__(_I960__)
-@code{_AS__} can be configured to produce either @code{b.out} or COFF
+On the _HOST__, @code{_AS__} can be configured to produce either @code{b.out} or COFF
format object files.
_fi__(_I960__)
_fi__(!_GENERIC__)
been given (@pxref{App-File,,@code{.app-file}}) it is used for the filename, otherwise the
name of the current input file is used. If a logical line number was
given
-_if__(!_AMD29K__)
+_if__(!_A29K__)
(@pxref{Line,,@code{.line}})
-_fi__(!_AMD29K__)
-_if__(_AMD29K__)
+_fi__(!_A29K__)
+_if__(_A29K__)
(@pxref{Ln,,@code{.ln}})
-_fi__(_AMD29K__)
+_fi__(_A29K__)
then it is used to calculate the number printed,
otherwise the actual line in the current source file is printed. The
message text is intended to be self explanatory (in the grand Unix
specified (left to right) on the command line.
@subsection Difference Tables: @code{-k}
-_if__((!_GENERIC__) && (_AMD29K__ || _I960__))
+_if__((!_GENERIC__) && (_A29K__ || _I960__))
On the _HOST__ family, this option is allowed, but has no effect. It is
permitted for compatibility with the GNU assembler on other platforms,
where it can be used to warn when the assembler alters the machine code
generated for @samp{.word} directives in difference tables. The _HOST__
family does not have the addressing limitations that sometimes lead to this
alteration on other platforms.
-_fi__((!_GENERIC__) && (_AMD29K__ || _I960__))
+_fi__((!_GENERIC__) && (_A29K__ || _I960__))
-_if__(_GENERIC__ || (! _AMD29K__ || _I960__ ))
+_if__(_GENERIC__ || (! _A29K__ || _I960__ ))
@code{_AS__} sometimes alters the code emitted for directives of the form
@samp{.word @var{sym1}-@var{sym2}}; @pxref{Word,,@code{.word}}.
You can use the @samp{-k} option if you want a warning issued when this
is done.
-_fi__(_GENERIC__ || (! _AMD29K__ || _I960__ ))
+_fi__(_GENERIC__ || (! _A29K__ || _I960__ ))
@subsection Include Local Labels: @code{-L}
Labels beginning with @samp{L} (upper case only) are called @dfn{local
data segment). We refrain from doing this simply for compatibility with
older versions of @code{_AS__}. In future, @code{-R} may work this way.
+@subsection Announce Version: @code{-v}
+You can find out what version of as is running by including the
+option @samp{-v} (which you can also spell as @samp{-version}) on the
+command line.
+
@subsection Suppress Warnings: @code{-W}
@code{_AS__} should never give a warning or error message when
assembling compiler output. But programs written by people often
_if__(_M680X0__)
@samp{|} on the 680x0;
_fi__(_M680X0__)
-_if__(_AMD29K__)
+_if__(_A29K__)
@samp{;} for the AMD 29K family;
-_fi__(_AMD29K__)
+_fi__(_A29K__)
@pxref{_MACH_DEP__}. @refill
@c FIXME: fill in SPARC line comment char
@node Statements, Constants, Symbol Intro, Syntax
@section Statements
-_if__(!_AMD29K__)
+_if__(!_A29K__)
A @dfn{statement} ends at a newline character (@samp{\n}) or at a
semicolon (@samp{;}). The newline or semicolon is considered part of
the preceding statement. Newlines and semicolons within character
constants are an exception: they don't end statements.
-_fi__(!_AMD29K__)
-_if__(_AMD29K__)
+_fi__(!_A29K__)
+_if__(_A29K__)
A @dfn{statement} ends at a newline character (@samp{\n}) or an ``at''
sign (@samp{@@}). The newline or at sign is considered part of the
preceding statement. Newlines and at signs within character constants
are an exception: they don't end statements.
-_fi__(_AMD29K__)
+_fi__(_A29K__)
It is an error to end any statement with end-of-file: the last
character of any input file should be a newline.@refill
must write @kbd{'\\} where the first @code{\} escapes the second
@code{\}. As you can see, the quote is an acute accent, not a
grave accent. A newline
-_if__(!_AMD29K__)
+_if__(!_A29K__)
(or semicolon @samp{;})
-_fi__(!_AMD29K__)
-_if__(_AMD29K__)
+_fi__(!_A29K__)
+_if__(_A29K__)
(or at sign @samp{@@})
-_fi__(_AMD29K__)
+_fi__(_A29K__)
immediately following an acute accent is taken as a literal character
and does not count as the end of a statement. The value of a character
constant in a numeric expression is the machine's byte-wide code for
to allow any of @samp{defghDEFGH}.)
@end ignore
_fi__(_GENERIC__)
-_if__(_AMD29K__)
+_if__(_A29K__)
_if__(_GENERIC__)
On the AMD 29K architecture, the letter must be:
_fi__(_GENERIC__)
One of the letters @samp{DFPRSX} (in upper or lower case), to tell
@code{_AS__} the rest of the number is a flonum.
-_fi__(_AMD29K__)
+_fi__(_A29K__)
_if__(_I960__)
_if__(_GENERIC__)
On the Intel 960 architecture, the letter must be:
An idealized example of the three relocatable segments follows. Memory
addresses are on the horizontal axis.
+@c TEXI2ROFF-KILL
@ifinfo
+@c END TEXI2ROFF-KILL
@smallexample
+-----+----+--+
partial program # 1: |ttttt|dddd|00|
addresses: 0 @dots{}
@end smallexample
+@c TEXI2ROFF-KILL
@end ifinfo
@tex
\line{0\dots\hfil}
@end tex
+@c END TEXI2ROFF-KILL
@node _AS__ Segments, Sub-Segments, _LD__ Segments, Segments
@section _AS__ Internal Segments
@c these paragraphs might need to vanish from this manual, and be
@c discussed in BFD chapter of binutils (or some such).
_fi__(_I960__)
-_if__(_AMD29K__)
+_if__(_A29K__)
On the AMD 29K family, no particular padding is added to segment sizes;
_AS__ forces no alignment on this platform.
-_fi__(_AMD29K__)
+_fi__(_A29K__)
Subsegments appear in your object file in numeric order, lowest numbered
to highest. (All this to be compatible with other people's assemblers.)
The object file contains no representation of subsegments; @code{_LD__} and
underscores and dollar signs. Case of letters is significant:
@code{foo} is a different symbol name than @code{Foo}.
-_if__(_AMD29K__)
+_if__(_A29K__)
For the AMD 29K family, @samp{?} is also allowed in the
body of a symbol name, though not at its beginning.
-_fi__(_AMD29K__)
+_fi__(_A29K__)
Each symbol has exactly one name. Each name in an assembly language
program refers to exactly one symbol. You may use that symbol name any
.long .} will cause @code{melvin} to contain its own address.
Assigning a value to @code{.} is treated the same as a @code{.org}
directive. Thus, the expression @samp{.=.+4} is the same as saying
-_if__(!_AMD29K__)
+_if__(!_A29K__)
@samp{.space 4}.
-_fi__(!_AMD29K__)
-_if__(_AMD29K__)
+_fi__(!_A29K__)
+_if__(_A29K__)
@samp{.block 4}.
-_fi__(_AMD29K__)
+_fi__(_A29K__)
@node Symbol Attributes, , Dot, Symbols
@section Symbol Attributes
* Endif:: @code{.endif}
* Equ:: @code{.equ @var{symbol}, @var{expression}}
* Extern:: @code{.extern}
-_if__(_GENERIC__||!_AMD29K__)
+_if__(_GENERIC__||!_A29K__)
* File:: @code{.app-file @var{string}}
-_fi__(_GENERIC__||!_AMD29K__)
+_fi__(_GENERIC__||!_A29K__)
* Fill:: @code{.fill @var{repeat} , @var{size} , @var{value}}
* Float:: @code{.float @var{flonums}}
* Global:: @code{.global @var{symbol}}, @code{.globl @var{symbol}}
* Include:: @code{.include "@var{file}"}
* Int:: @code{.int @var{expressions}}
* Lcomm:: @code{.lcomm @var{symbol} , @var{length}}
-_if__(_GENERIC__||!_AMD29K__)
+_if__(_GENERIC__||!_A29K__)
* Line:: @code{.line @var{line-number}}
-_fi__(_GENERIC__||!_AMD29K__)
+_fi__(_GENERIC__||!_A29K__)
* Ln:: @code{.ln @var{line-number}}
* List:: @code{.list} and related directives
* Long:: @code{.long @var{expressions}}
@node App-File, Ascii, Align, Pseudo Ops
@section @code{.app-file @var{string}}
@code{.app-file}
-_if__(!_AMD29K__)
+_if__(!_A29K__)
(which may also be spelled @samp{.file})
-_fi__(!_AMD29K__)
+_fi__(!_A29K__)
tells @code{_AS__} that we are about to start a new
logical file. @var{string} is the new file name. In general, the
filename is recognized whether or not it is surrounded by quotes @samp{"};
The exact kind of floating point numbers emitted depends on how
@code{_AS__} is configured. @xref{_MACH_DEP__}.
_fi__(_GENERIC__)
-_if__((!_GENERIC__) && (_AMD29K__ || _I960__))
+_if__((!_GENERIC__) && (_A29K__ || _I960__))
On the _HOST__ family @samp{.double} emits 64-bit floating-point numbers
in IEEE format.
-_fi__((!_GENERIC__) && (_AMD29K__ || _I960__))
+_fi__((!_GENERIC__) && (_A29K__ || _I960__))
_if__(_COFF__||_BOUT__)
@node Else, Endef, Double, Pseudo Ops
This directive sets the value of @var{symbol} to @var{expression}.
It is synonymous with @samp{.set}; @pxref{Set,,@code{.set}}.
-_if__(_GENERIC__||!_AMD29K__)
+_if__(_GENERIC__||!_A29K__)
@node Extern, File, Equ, Pseudo Ops
-_fi__(_GENERIC__||!_AMD29K__)
-_if__(_AMD29K__&&!_GENERIC__)
+_fi__(_GENERIC__||!_A29K__)
+_if__(_A29K__&&!_GENERIC__)
@node Extern, Fill, Equ, Pseudo Ops
-_fi__(_AMD29K__&&!_GENERIC__)
+_fi__(_A29K__&&!_GENERIC__)
@section @code{.extern}
@code{.extern} is accepted in the source program---for compatibility
with other assemblers---but it is ignored. @code{_AS__} treats
all undefined symbols as external.
-_if__(_GENERIC__||!_AMD29K__)
+_if__(_GENERIC__||!_A29K__)
@node File, Fill, Extern, Pseudo Ops
@section @code{.app-file @var{string}}
@code{.file} (which may also be spelled @samp{.app-file}) tells
you wish to specify an empty file name, you must give the
quotes--@code{""}. This statement may go away in future: it is only
recognized to be compatible with old @code{_AS__} programs.
-_if__(_AMD29K__)
+_if__(_A29K__)
In some configurations of @code{_AS__}, @code{.file} has already been
removed to avoid conflicts with other assemblers. @xref{_MACH_DEP__}.
-_fi__(_AMD29K__)
-_fi__(_GENERIC__||!_AMD29K__)
+_fi__(_A29K__)
+_fi__(_GENERIC__||!_A29K__)
-_if__(_GENERIC__||!_AMD29K__)
+_if__(_GENERIC__||!_A29K__)
@node Fill, Float, File, Pseudo Ops
-_fi__(_GENERIC__||!_AMD29K__)
-_if__(_AMD29K__&&!_GENERIC__)
+_fi__(_GENERIC__||!_A29K__)
+_if__(_A29K__&&!_GENERIC__)
@node Fill, Float, Extern, Pseudo Ops
-_fi__(_AMD29K__&&!_GENERIC__)
+_fi__(_A29K__&&!_GENERIC__)
@section @code{.fill @var{repeat} , @var{size} , @var{value}}
@var{result}, @var{size} and @var{value} are absolute expressions.
This emits @var{repeat} copies of @var{size} bytes. @var{Repeat}
@code{_AS__} is configured.
@xref{_MACH_DEP__}.
_fi__(_GENERIC__)
-_if__((!_GENERIC__) && (_AMD29K__ || _I960__))
+_if__((!_GENERIC__) && (_A29K__ || _I960__))
On the _HOST__ family, @code{.float} emits 32-bit floating point numbers
in IEEE format.
-_fi__((!_GENERIC__) && (_AMD29K__ || _I960__))
+_fi__((!_GENERIC__) && (_A29K__ || _I960__))
@node Global, hword, Float, Pseudo Ops
@section @code{.global @var{symbol}}, @code{.globl @var{symbol}}
This directive is a synonym for @samp{.short}; depending on the target
architecture, it may also be a synonym for @samp{.word}.
_fi__(_GENERIC__)
-_if__( (_AMD29K__ || _I960__) && !_GENERIC__ )
+_if__( (_A29K__ || _I960__) && !_GENERIC__ )
This directive is a synonym for @samp{.short}.
-_fi__( (_AMD29K__ || _I960__) && !_GENERIC__ )
+_fi__( (_A29K__ || _I960__) && !_GENERIC__ )
_if__(_AOUT__||_BOUT__||_COFF__)
@node Ident, If, hword, Pseudo Ops
time, be the value of that expression. The byte order of the
expression depends on what kind of computer will run the program.
-_if__(_GENERIC__||(!_AMD29K__))
+_if__(_GENERIC__||(!_A29K__))
@node Lcomm, Line, Int, Pseudo Ops
-_fi__(_GENERIC__||(!_AMD29K__))
-_if__((!_GENERIC__)&& _AMD29K__)
+_fi__(_GENERIC__||(!_A29K__))
+_if__((!_GENERIC__)&& _A29K__)
@node Lcomm, Ln, Int, Pseudo Ops
-_fi__((!_GENERIC__)&& _AMD29K__)
+_fi__((!_GENERIC__)&& _A29K__)
@section @code{.lcomm @var{symbol} , @var{length}}
Reserve @var{length} (an absolute expression) bytes for a local common
denoted by @var{symbol}. The segment and value of @var{symbol} are
is not declared global (@pxref{Global,,@code{.global}}), so is normally
not visible to @code{_LD__}.
-_if__(_GENERIC__ || !_AMD29K__)
+_if__(_GENERIC__ || !_A29K__)
@node Line, Ln, Lcomm, Pseudo Ops
@section @code{.line @var{line-number}}
-_fi__(_GENERIC__ || (!_AMD29K__))
-_if__(_AMD29K__ && (!_GENERIC__))
+_fi__(_GENERIC__ || (!_A29K__))
+_if__(_A29K__ && (!_GENERIC__))
@node Ln, List, Lcomm, Pseudo Ops
@section @code{.ln @var{line-number}}
-_fi__(_AMD29K__ && (!_GENERIC__))
+_fi__(_A29K__ && (!_GENERIC__))
_if__(_AOUT__||_BOUT__)
Tell @code{_AS__} to change the logical line number. @var{line-number} must be
an absolute expression. The next line will have that logical line
number. So any other statements on the current line (after a statement
separator character
-_if__(_AMD29K__&&(!_GENERIC__))
+_if__(_A29K__&&(!_GENERIC__))
@samp{@@})
-_fi__(_AMD29K__&&(!_GENERIC__))
-_if__(_GENERIC__ || (!_AMD29K__))
+_fi__(_A29K__&&(!_GENERIC__))
+_if__(_GENERIC__ || (!_A29K__))
@code{;})
-_fi__(_GENERIC__ || (!_AMD29K__))
+_fi__(_GENERIC__ || (!_A29K__))
will be reported as on logical line number
@var{line-number} @minus{} 1.
One day this directive will be unsupported: it is used only
for compatibility with existing assembler programs. @refill
-_if__(_GENERIC__ && _AMD29K__)
+_if__(_GENERIC__ && _A29K__)
@emph{Warning:} In the AMD29K configuration of _AS__, this command is
only available with the name @code{.ln}, rather than as either
@code{.line} or @code{.ln}. (Also, in that configuration the line
separator character is @samp{@@}).
-_fi__(_GENERIC__ && _AMD29K__)
+_fi__(_GENERIC__ && _A29K__)
_fi__(_AOUT__||_BOUT__)
_if__(_COFF__)
debugging.
_fi__(_COFF__)
-_if__(_AOUT__&&(_GENERIC__||!_AMD29K__))
+_if__(_AOUT__&&(_GENERIC__||!_A29K__))
@node Ln, List, Line, Pseudo Ops
@section @code{.ln @var{line-number}}
@samp{.ln} is a synonym for @samp{.line}.
-_fi__(_AOUT__&&(_GENERIC__||!_AMD29K__))
+_fi__(_AOUT__&&(_GENERIC__||!_A29K__))
_if__(_COFF__&&!_AOUT__)
@node Ln, List, Line, Pseudo Ops
@section @code{.ln @var{line-number}}
@node Short, Single, Set, Pseudo Ops
@section @code{.short @var{expressions}}
-_if__(_GENERIC__ || !(_SPARC__ || _AMD29K__ || _I960__))
+_if__(_GENERIC__ || !(_SPARC__ || _A29K__ || _I960__))
@code{.short} is the same as @samp{.word}. @xref{Word,,@code{.word}}.
-_if__(_SPARC__ || _AMD29K__ || _I960__)
+_if__(_SPARC__ || _A29K__ || _I960__)
In some configurations, however, @code{.short} and @code{.word} generate
numbers of different lengths; @pxref{_MACH_DEP__}.
-_fi__(_SPARC__ || _AMD29K__ || _I960__)
-_fi__(_GENERIC__|| !(_SPARC__ || _AMD29K__ || _I960__))
-_if__((!_GENERIC__) && (_SPARC__ || _AMD29K__ || _I960__))
+_fi__(_SPARC__ || _A29K__ || _I960__)
+_fi__(_GENERIC__|| !(_SPARC__ || _A29K__ || _I960__))
+_if__((!_GENERIC__) && (_SPARC__ || _A29K__ || _I960__))
This expects zero or more @var{expressions}, and emits
a 16 bit number for each.
-_fi__((!_GENERIC__) && (_SPARC__ || _AMD29K__ || _I960__))
+_fi__((!_GENERIC__) && (_SPARC__ || _A29K__ || _I960__))
_if__(_COFF__||_BOUT__)
@node Single, Size, Short, Pseudo Ops
_fi__(_COFF__||_BOUT__)
The exact kind of floating point numbers emitted depends on how
@code{_AS__} is configured. @xref{_MACH_DEP__}.
_fi__(_GENERIC__)
-_if__((!_GENERIC__) && (_AMD29K__ || _I960__ || _SPARC__))
+_if__((!_GENERIC__) && (_A29K__ || _I960__ || _SPARC__))
On the _HOST__ family, @code{.single} emits 32-bit floating point
numbers in IEEE format.
-_fi__((!_GENERIC__) && (_AMD29K__ || _I960__ || _SPARC__))
+_fi__((!_GENERIC__) && (_A29K__ || _I960__ || _SPARC__))
_if__(_COFF__||_BOUT__)
@node Size, Space, Single, Pseudo Ops
_if__(!(_COFF__||_BOUT__))
@node Space, Stab, Single, Pseudo Ops
_fi__(!(_COFF__||_BOUT__))
-_if__(_GENERIC__ || !_AMD29K__)
+_if__(_GENERIC__ || !_A29K__)
@section @code{.space @var{size} , @var{fill}}
This directive emits @var{size} bytes, each of value @var{fill}. Both
@var{size} and @var{fill} are absolute expressions. If the comma
and @var{fill} are omitted, @var{fill} is assumed to be zero.
-_fi__(_GENERIC__ || !_AMD29K__)
+_fi__(_GENERIC__ || !_A29K__)
-_if__(_AMD29K__)
+_if__(_A29K__)
On the AMD 29K, this directive is ignored; it is accepted for
compatibility with other AMD 29K assemblers.
@emph{Warning:} In other versions of the GNU assembler, the directive
@code{.space} has the effect of @code{.block} @xref{_MACH_DEP__}.
@end quotation
-_fi__(_AMD29K__)
+_fi__(_A29K__)
_if__(_AOUT__||_BOUT__||_COFF__)
_if__(_COFF__||_BOUT__)
@section @code{.word @var{expressions}}
This directive expects zero or more @var{expressions}, of any segment,
separated by commas.
-_if__((!_GENERIC__) && (_SPARC__ || _AMD29K__ || _I960__))
+_if__((!_GENERIC__) && (_SPARC__ || _A29K__ || _I960__))
For each expression, @code{_AS__} emits a 32-bit number.
-_fi__((!_GENERIC__) && (_SPARC__ || _AMD29K__ || _I960__))
-_if__((!_GENERIC__) && (! (_SPARC__ || _AMD29K__ || _I960__) ))
+_fi__((!_GENERIC__) && (_SPARC__ || _A29K__ || _I960__))
+_if__((!_GENERIC__) && (! (_SPARC__ || _A29K__ || _I960__) ))
For each expression, @code{_AS__} emits a 16-bit number.
-_fi__((!_GENERIC__) && (! (_SPARC__ || _AMD29K__ || _I960__) ))
+_fi__((!_GENERIC__) && (! (_SPARC__ || _A29K__ || _I960__) ))
_if__(_GENERIC__)
The size of the number emitted, and its byte order,
@c on amd29k, i960, sparc the "special treatment to support compilers" doesn't
@c happen---32-bit addressability, period; no long/short jumps.
-_if__(_GENERIC__ || (! (_AMD29K__ || _I960__) ))
+_if__(_GENERIC__ || (! (_A29K__ || _I960__) ))
@quotation
@emph{Warning: Special Treatment to support Compilers}
@end quotation
@samp{-DWORKING_DOT_WORD} option.} This feature is likely to confuse
assembly language programmers.
_fi__(_INTERNALS__)
-_fi__(_GENERIC__ || (! (_AMD29K__ || _I960__) ))
+_fi__(_GENERIC__ || (! (_A29K__ || _I960__) ))
@node Deprecated, , Word, Pseudo Ops
@section Deprecated Directives
_if__(_VAX__)
* Vax-Dependent:: VAX Dependent Features
_fi__(_VAX__)
-_if__(_AMD29K__)
+_if__(_A29K__)
* AMD29K-Dependent:: AMD 29K Dependent Features
-_fi__(_AMD29K__)
+_fi__(_A29K__)
_if__(_I960__)
* i960-Dependent:: Intel 80960 Dependent Features
_fi__(_I960__)
_fi__(_GENERIC__)
_if__(_VAX__)
-@c @group
_if__(_GENERIC__)
@node Vax-Dependent, AMD29K-Dependent, Machine Dependent, Machine Dependent
_fi__(_GENERIC__)
gives a warning message that the option was ignored and proceeds.
These options are for compatibility with scripts designed for other
people's assemblers.
-@c @end group
@table @asis
@item @kbd{-D} (Debug)
can add the required code if they really need it.
_fi__(_VAX__)
-_if__(_AMD29K__)
-@c @group
+_if__(_A29K__)
_if__(_GENERIC__)
@node AMD29K-Dependent, i960-Dependent, Vax-Dependent, Machine Dependent
_fi__(_GENERIC__)
_CHAPSEC__(1+_GENERIC__) Options
@code{_AS__} has no additional command-line options for the AMD
29K family.
-@c @end group
-@c @group
@node AMD29K Syntax, AMD29K Floating Point, AMD29K Options, AMD29K-Dependent
_CHAPSEC__(1+_GENERIC__) Syntax
@menu
The character @samp{?} is permitted in identifiers (but may not begin
an identifier).
-@c @end group
@node AMD29K-Regs, , AMD29K-Chars, AMD29K Syntax
_CHAPSEC__(2+_GENERIC__) Register Names
_CHAPSEC__(1+_GENERIC__) Floating Point
The AMD 29K family uses IEEE floating-point numbers.
-@c @group
@node AMD29K Directives, AMD29K Opcodes, AMD29K Floating Point, AMD29K-Dependent
_CHAPSEC__(1+_GENERIC__) AMD 29K Machine Directives
In other versions of the GNU assembler, this directive is called
@samp{.space}.
@end table
-@c @end group
@table @code
@item .cputype
For information on the 29K machine instruction set, see @cite{Am29000
User's Manual}, Advanced Micro Devices, Inc.
-_fi__(_AMD29K__)
+_fi__(_A29K__)
_if__(_I960__)
_if__(_GENERIC__)
@node i960-Dependent, M68K-Dependent, AMD29K-Dependent, Machine Dependent
entries in the table, which follow immediately: each is a word, pointing
to one of the labels illustrated above.
+@c TEXI2ROFF-KILL
@ifinfo
+@c END TEXI2ROFF-KILL
@example
+------------+------------+------------+ ... +------------+
| | | | | |
__BRANCH_TABLE__ layout
@end example
+@c TEXI2ROFF-KILL
@end ifinfo
@tex
\vskip 1pc
*BRLAB 1}\ibox{1cm}{\quad\dots}\boxit{2cm}{\tt *BRLAB \it N}\hfil}
\centerline{\it {\tt \_\_BRANCH\_TABLE\_\_} layout}
@end tex
+@c END TEXI2ROFF-KILL
The first word of the header is used to locate multiple branch tables,
since each object file may contain one. Normally the links are
@code{_AS__} generates IEEE floating-point numbers for the directives
@samp{.float}, @samp{.double}, @samp{extended}, and @samp{.single}.
-@c @group
@node Directives-i960, Opcodes for i960, Floating Point-i960, i960-Dependent
_CHAPSEC__(1+_GENERIC__) i960 Machine Directives
differs from @samp{.lcomm} only in that it permits you to specify
an alignment. @xref{Lcomm,,@code{.lcomm}}.
@end table
-@c @end group
@table @code
@item .extended @var{flonums}
necessary @emph{unless} you specify @code{-norelax}---in which case
@code{_AS__} gives an error instead.
-@c @group
These are the Compare-and-Branch instructions, their ``Jump'' variants,
and the instruction pairs they may expand into:
+@c TEXI2ROFF-KILL
@ifinfo
+@c END TEXI2ROFF-KILL
@example
Compare and
Branch Jump Expanded to
cmpoble cmpojle cmpo; ble
cmpobne cmpojne cmpo; bne
@end example
+@c TEXI2ROFF-KILL
@end ifinfo
@tex
\hskip\tableindent
cmpoble& cmpojle& cmpo; ble\cr
cmpobne& cmpojne& cmpo; bne\cr}
@end tex
-@c @end group
+@c END TEXI2ROFF-KILL
_fi__(_I960__)
-@c @group
_if__(_M680X0__)
_if__(_GENERIC__)
@c FIXME! node conds are only sufficient for m68k alone, all, and vintage
One shortens undefined references from 32 to 16 bits, while the
other is used to tell @code{_AS__} what kind of machine it is
assembling for.
-@c @end group
You can use the @kbd{-l} option to shorten the size of references to
undefined symbols. If the @kbd{-l} option is not given, references to
The 32x32 has no machine dependent directives.
_fi__(0)
-@c @group
_if__(_SPARC__)
_if__(_GENERIC__)
_if__(_I80386__&&_M680X0__)
_if__(_I80386__&&_I960__&&!_M680X0__)
@node Sparc-Dependent, i386-Dependent, i960-Dependent, Machine Dependent
_fi__(_I80386__&&_I960__&&!_M680X0__)
-_if__(_I80386__&&_AMD29K__&&(!_I960__)&&!_M680X0__)
+_if__(_I80386__&&_A29K__&&(!_I960__)&&!_M680X0__)
@node Sparc-Dependent, i386-Dependent, AMD29K-Dependent, Machine Dependent
-_fi__(_I80386__&&_AMD29K__&&(!_I960__)&&!_M680X0__)
-_if__(_I80386__&&_VAX__&&(!_AMD29K__)&&(!_I960__)&&!_M680X0__)
+_fi__(_I80386__&&_A29K__&&(!_I960__)&&!_M680X0__)
+_if__(_I80386__&&_VAX__&&(!_A29K__)&&(!_I960__)&&!_M680X0__)
@node Sparc-Dependent, i386-Dependent, Vax-Dependent, Machine Dependent
-_fi__(_I80386__&&_VAX__&&(!_AMD29K__)&&(!_I960__)&&!_M680X0__)
-_if__(_I80386__&&(!_VAX__)&&(!_AMD29K__)&&(!_I960__)&&!_M680X0__)
+_fi__(_I80386__&&_VAX__&&(!_A29K__)&&(!_I960__)&&!_M680X0__)
+_if__(_I80386__&&(!_VAX__)&&(!_A29K__)&&(!_I960__)&&!_M680X0__)
@node Sparc-Dependent, i386-Dependent, Machine Dependent, Machine Dependent
-_fi__(_I80386__&&(!_VAX__)&&(!_AMD29K__)&&(!_I960__)&&!_M680X0__)
+_fi__(_I80386__&&(!_VAX__)&&(!_A29K__)&&(!_I960__)&&!_M680X0__)
_if__((!_I80386__)&&_M680X0__)
@node Sparc-Dependent, , M68K-Dependent, Machine Dependent
_fi__((!_I80386__)&&_M680X0__)
_if__((!_I80386__)&&_I960__&&!_M680X0__)
@node Sparc-Dependent, , i960-Dependent, Machine Dependent
_fi__((!_I80386__)&&_I960__&&!_M680X0__)
-_if__((!_I80386__)&&_AMD29K__&&(!_I960__)&&!_M680X0__)
+_if__((!_I80386__)&&_A29K__&&(!_I960__)&&!_M680X0__)
@node Sparc-Dependent, , AMD29K-Dependent, Machine Dependent
-_fi__((!_I80386__)&&_AMD29K__&&(!_I960__)&&!_M680X0__)
-_if__((!_I80386__)&&_VAX__&&(!_AMD29K__)&&(!_I960__)&&!_M680X0__)
+_fi__((!_I80386__)&&_A29K__&&(!_I960__)&&!_M680X0__)
+_if__((!_I80386__)&&_VAX__&&(!_A29K__)&&(!_I960__)&&!_M680X0__)
@node Sparc-Dependent, , Vax-Dependent, Machine Dependent
-_fi__((!_I80386__)&&_VAX__&&(!_AMD29K__)&&(!_I960__)&&!_M680X0__)
-_if__((!_I80386__)&&(!_VAX__)&&(!_AMD29K__)&&(!_I960__)&&!_M680X0__)
+_fi__((!_I80386__)&&_VAX__&&(!_A29K__)&&(!_I960__)&&!_M680X0__)
+_if__((!_I80386__)&&(!_VAX__)&&(!_A29K__)&&(!_I960__)&&!_M680X0__)
@node Sparc-Dependent, , Machine Dependent, Machine Dependent
-_fi__((!_I80386__)&&(!_VAX__)&&(!_AMD29K__)&&(!_I960__)&&!_M680X0__)
+_fi__((!_I80386__)&&(!_VAX__)&&(!_A29K__)&&(!_I960__)&&!_M680X0__)
_fi__(_GENERIC__)
_CHAPSEC__(0+_GENERIC__) SPARC Dependent Features
@menu
@node Sparc-Opts, Sparc-Float, Sparc-Dependent, Sparc-Dependent
_CHAPSEC__(1+_GENERIC__) Options
The Sparc has no machine dependent options.
-@c @end group
@ignore
@c FIXME: (sparc) Fill in "syntax" section!
@item .word
On the Sparc, the .word directive produces 32 bit values,
-instead of the 16 bit values it produces on manyother machines.
+instead of the 16 bit values it produces on many other machines.
@end table
projects / binutils-gdb.git / commitdiff