mirror of
https://github.com/espressif/binutils-gdb.git
synced 2025-06-23 03:29:47 +08:00
Former -k option now -K to avoid conflict with Sun assembler.
(-K [nee -k] gives warning when difference tables altered by assembler)
This commit is contained in:
@ -4,8 +4,9 @@
|
|||||||
@setfilename as.info
|
@setfilename as.info
|
||||||
@settitle Using as
|
@settitle Using as
|
||||||
@setchapternewpage odd
|
@setchapternewpage odd
|
||||||
@c @smallbook
|
@input smpklug.texi
|
||||||
@c @cropmarks
|
@smallbook
|
||||||
|
@cropmarks
|
||||||
@c %**end of header
|
@c %**end of header
|
||||||
|
|
||||||
@ifinfo
|
@ifinfo
|
||||||
@ -137,7 +138,7 @@ Here is a brief summary of how to invoke @code{as}. For details,
|
|||||||
@c to be limited to one line for the header.
|
@c to be limited to one line for the header.
|
||||||
@smallexample
|
@smallexample
|
||||||
as [ -a | -al | -as ] [ -D ] [ -f ]
|
as [ -a | -al | -as ] [ -D ] [ -f ]
|
||||||
[ -I @var{path} ] [ -k ] [ -L ]
|
[ -I @var{path} ] [ -K ] [ -L ]
|
||||||
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
|
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
|
||||||
@c am29k has no machine-dependent assembler options
|
@c am29k has no machine-dependent assembler options
|
||||||
@c h8/300 has no machine-dependent assembler options
|
@c h8/300 has no machine-dependent assembler options
|
||||||
@ -163,7 +164,7 @@ other assemblers; it has no effect on @code{as}.
|
|||||||
@item -I @var{path}
|
@item -I @var{path}
|
||||||
Add @var{path} to the search list for @code{.include} directives
|
Add @var{path} to the search list for @code{.include} directives
|
||||||
|
|
||||||
@item -k
|
@item -K
|
||||||
Issue warnings when difference tables altered for long displacements.
|
Issue warnings when difference tables altered for long displacements.
|
||||||
|
|
||||||
@item -L
|
@item -L
|
||||||
@ -515,15 +516,15 @@ working directory is always searched first; after that, @code{as}
|
|||||||
searches any @samp{-I} directories in the same order as they were
|
searches any @samp{-I} directories in the same order as they were
|
||||||
specified (left to right) on the command line.
|
specified (left to right) on the command line.
|
||||||
|
|
||||||
@section Difference Tables: @code{-k}
|
@section Difference Tables: @code{-K}
|
||||||
|
|
||||||
@kindex -k
|
@kindex -K
|
||||||
|
|
||||||
@cindex difference tables, warning
|
@cindex difference tables, warning
|
||||||
@cindex warning for altered difference tables
|
@cindex warning for altered difference tables
|
||||||
@code{as} sometimes alters the code emitted for directives of the form
|
@code{as} sometimes alters the code emitted for directives of the form
|
||||||
@samp{.word @var{sym1}-@var{sym2}}; @pxref{Word,,@code{.word}}.
|
@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
|
You can use the @samp{-K} option if you want a warning issued when this
|
||||||
is done.
|
is done.
|
||||||
|
|
||||||
@section Include Local Labels: @code{-L}
|
@section Include Local Labels: @code{-L}
|
||||||
|
@ -12,10 +12,19 @@ _if__(!_GENERIC__)
|
|||||||
@settitle Using _AS__ (_HOST__)
|
@settitle Using _AS__ (_HOST__)
|
||||||
_fi__(!_GENERIC__)
|
_fi__(!_GENERIC__)
|
||||||
@setchapternewpage odd
|
@setchapternewpage odd
|
||||||
@c @smallbook
|
@input smpklug.texi
|
||||||
@c @cropmarks
|
@smallbook
|
||||||
|
@cropmarks
|
||||||
@c %**end of header
|
@c %**end of header
|
||||||
|
|
||||||
|
@ifinfo
|
||||||
|
@format
|
||||||
|
START-INFO-DIR-ENTRY
|
||||||
|
* As: (as). The GNU assembler.
|
||||||
|
END-INFO-DIR-ENTRY
|
||||||
|
@end format
|
||||||
|
@end ifinfo
|
||||||
|
|
||||||
@finalout
|
@finalout
|
||||||
@syncodeindex ky cp
|
@syncodeindex ky cp
|
||||||
|
|
||||||
@ -88,8 +97,9 @@ done.
|
|||||||
\def\$#1${{#1}} % Kluge: collect RCS revision info without $...$
|
\def\$#1${{#1}} % Kluge: collect RCS revision info without $...$
|
||||||
\xdef\manvers{\$Revision$} % For use in headers, footers too
|
\xdef\manvers{\$Revision$} % For use in headers, footers too
|
||||||
{\parskip=0pt
|
{\parskip=0pt
|
||||||
\hfill \manvers\par
|
\hfill {\it Using {\tt _AS__}} \manvers\par
|
||||||
\hfill \TeX{}info \texinfoversion\par
|
\hfill \TeX{}info \texinfoversion\par
|
||||||
|
\hfill Edited by Roland Pesch for Cygnus Support\par
|
||||||
}
|
}
|
||||||
%"boxit" macro for figures:
|
%"boxit" macro for figures:
|
||||||
%Modified from Knuth's ``boxit'' macro from TeXbook (answer to exercise 21.3)
|
%Modified from Knuth's ``boxit'' macro from TeXbook (answer to exercise 21.3)
|
||||||
@ -99,8 +109,6 @@ done.
|
|||||||
\gdef\ibox#1#2{\hbox to #1{#2\hfil}\kern8pt}% invisible box
|
\gdef\ibox#1#2{\hbox to #1{#2\hfil}\kern8pt}% invisible box
|
||||||
@end tex
|
@end tex
|
||||||
|
|
||||||
Edited by Roland Pesch for Cygnus Support.
|
|
||||||
|
|
||||||
@vskip 0pt plus 1filll
|
@vskip 0pt plus 1filll
|
||||||
Copyright @copyright{} 1991 Free Software Foundation, Inc.
|
Copyright @copyright{} 1991 Free Software Foundation, Inc.
|
||||||
|
|
||||||
@ -163,7 +171,7 @@ Here is a brief summary of how to invoke @code{_AS__}. For details,
|
|||||||
@c to be limited to one line for the header.
|
@c to be limited to one line for the header.
|
||||||
@smallexample
|
@smallexample
|
||||||
_AS__ [ -a | -al | -as ] [ -D ] [ -f ]
|
_AS__ [ -a | -al | -as ] [ -D ] [ -f ]
|
||||||
[ -I @var{path} ] [ -k ] [ -L ]
|
[ -I @var{path} ] [ -K ] [ -L ]
|
||||||
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
|
[ -o @var{objfile} ] [ -R ] [ -v ] [ -w ]
|
||||||
_if__(_A29K__)
|
_if__(_A29K__)
|
||||||
@c am29k has no machine-dependent assembler options
|
@c am29k has no machine-dependent assembler options
|
||||||
@ -197,7 +205,7 @@ other assemblers; it has no effect on @code{_AS__}.
|
|||||||
@item -I @var{path}
|
@item -I @var{path}
|
||||||
Add @var{path} to the search list for @code{.include} directives
|
Add @var{path} to the search list for @code{.include} directives
|
||||||
|
|
||||||
@item -k
|
@item -K
|
||||||
_if__((!_GENERIC__) && !_DIFFTABKLUG__)
|
_if__((!_GENERIC__) && !_DIFFTABKLUG__)
|
||||||
This option is accepted but has no effect on the _HOST__ family.
|
This option is accepted but has no effect on the _HOST__ family.
|
||||||
_fi__((!_GENERIC__) && !_DIFFTABKLUG__)
|
_fi__((!_GENERIC__) && !_DIFFTABKLUG__)
|
||||||
@ -568,7 +576,7 @@ _if__(_GENERIC__)
|
|||||||
to particular machine architectures.
|
to particular machine architectures.
|
||||||
_fi__(_GENERIC__)
|
_fi__(_GENERIC__)
|
||||||
|
|
||||||
@section @code{-a}, @code{-al}, @code{-as}
|
@section Enable Listings: @code{-a}, @code{-al}, @code{-as}
|
||||||
|
|
||||||
@kindex -a
|
@kindex -a
|
||||||
@kindex -al
|
@kindex -al
|
||||||
@ -625,9 +633,9 @@ working directory is always searched first; after that, @code{_AS__}
|
|||||||
searches any @samp{-I} directories in the same order as they were
|
searches any @samp{-I} directories in the same order as they were
|
||||||
specified (left to right) on the command line.
|
specified (left to right) on the command line.
|
||||||
|
|
||||||
@section Difference Tables: @code{-k}
|
@section Difference Tables: @code{-K}
|
||||||
|
|
||||||
@kindex -k
|
@kindex -K
|
||||||
_if__((!_GENERIC__) && (!_DIFFTABKLUG__))
|
_if__((!_GENERIC__) && (!_DIFFTABKLUG__))
|
||||||
On the _HOST__ family, this option is allowed, but has no effect. It is
|
On the _HOST__ family, this option is allowed, but has no effect. It is
|
||||||
permitted for compatibility with the GNU assembler on other platforms,
|
permitted for compatibility with the GNU assembler on other platforms,
|
||||||
@ -642,7 +650,7 @@ _if__(_GENERIC__ || _DIFFTABKLUG__ )
|
|||||||
@cindex warning for altered difference tables
|
@cindex warning for altered difference tables
|
||||||
@code{_AS__} sometimes alters the code emitted for directives of the form
|
@code{_AS__} sometimes alters the code emitted for directives of the form
|
||||||
@samp{.word @var{sym1}-@var{sym2}}; @pxref{Word,,@code{.word}}.
|
@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
|
You can use the @samp{-K} option if you want a warning issued when this
|
||||||
is done.
|
is done.
|
||||||
_fi__(_GENERIC__ || _DIFFTABKLUG__ )
|
_fi__(_GENERIC__ || _DIFFTABKLUG__ )
|
||||||
|
|
||||||
@ -863,7 +871,6 @@ of @code{_AS__}.
|
|||||||
@node Symbol Intro, Statements, Comments, Syntax
|
@node Symbol Intro, Statements, Comments, Syntax
|
||||||
@section Symbols
|
@section Symbols
|
||||||
|
|
||||||
@cindex symbols
|
|
||||||
@cindex characters used in symbols
|
@cindex characters used in symbols
|
||||||
A @dfn{symbol} is one or more characters chosen from the set of all
|
A @dfn{symbol} is one or more characters chosen from the set of all
|
||||||
letters (both upper and lower case), digits and
|
letters (both upper and lower case), digits and
|
||||||
@ -2366,8 +2373,6 @@ _fi__( _BOUT__ && (! _COFF__))
|
|||||||
@section @code{.align @var{abs-expr} , @var{abs-expr}}
|
@section @code{.align @var{abs-expr} , @var{abs-expr}}
|
||||||
|
|
||||||
@cindex padding the location counter
|
@cindex padding the location counter
|
||||||
@cindex advancing location counter
|
|
||||||
@cindex location counter, advancing
|
|
||||||
@cindex @code{align} directive
|
@cindex @code{align} directive
|
||||||
Pad the location counter (in the current subsection) to a particular
|
Pad the location counter (in the current subsection) to a particular
|
||||||
storage boundary. The first expression (which must be absolute) is the
|
storage boundary. The first expression (which must be absolute) is the
|
||||||
@ -3122,9 +3127,9 @@ Assemble the following code into end of subsection numbered
|
|||||||
|
|
||||||
@node Set, Short, Section, Pseudo Ops
|
@node Set, Short, Section, Pseudo Ops
|
||||||
_fi__(_COFF__)
|
_fi__(_COFF__)
|
||||||
_if__(_BOUT__)
|
_if__(_BOUT__&&!_COFF__)
|
||||||
@node Set, Short, Scl, Pseudo Ops
|
@node Set, Short, Scl, Pseudo Ops
|
||||||
_fi__(_BOUT__)
|
_fi__(_BOUT__&&!_COFF__)
|
||||||
_if__(!(_COFF__||_BOUT__))
|
_if__(!(_COFF__||_BOUT__))
|
||||||
@node Set, Short, Quad, Pseudo Ops
|
@node Set, Short, Quad, Pseudo Ops
|
||||||
_fi__(!(_COFF__||_BOUT__))
|
_fi__(!(_COFF__||_BOUT__))
|
||||||
@ -3198,17 +3203,17 @@ ignores it.
|
|||||||
_fi__(_BOUT__)
|
_fi__(_BOUT__)
|
||||||
_fi__(_COFF__||_BOUT__)
|
_fi__(_COFF__||_BOUT__)
|
||||||
|
|
||||||
_if__(_H8__)
|
_if__(_H8__&&!_GENERIC__)
|
||||||
@node Space, Tag, Size, Pseudo Ops
|
@node Space, Tag, Size, Pseudo Ops
|
||||||
_fi__(_H8__)
|
_fi__(_H8__&&!_GENERIC__)
|
||||||
_if__(!_H8__)
|
_if__(_GENERIC__||!_H8__)
|
||||||
_if__(_COFF__||_BOUT__)
|
_if__(_COFF__||_BOUT__)
|
||||||
@node Space, Stab, Size, Pseudo Ops
|
@node Space, Stab, Size, Pseudo Ops
|
||||||
_fi__(_COFF__||_BOUT__)
|
_fi__(_COFF__||_BOUT__)
|
||||||
_if__(!(_COFF__||_BOUT__))
|
_if__(!(_COFF__||_BOUT__))
|
||||||
@node Space, Stab, Single, Pseudo Ops
|
@node Space, Stab, Single, Pseudo Ops
|
||||||
_fi__(!(_COFF__||_BOUT__))
|
_fi__(!(_COFF__||_BOUT__))
|
||||||
_fi__(!_H8__)
|
_fi__(_GENERIC__||!_H8__)
|
||||||
_if__(_GENERIC__ || !_A29K__)
|
_if__(_GENERIC__ || !_A29K__)
|
||||||
@section @code{.space @var{size} , @var{fill}}
|
@section @code{.space @var{size} , @var{fill}}
|
||||||
|
|
||||||
@ -3220,9 +3225,10 @@ and @var{fill} are omitted, @var{fill} is assumed to be zero.
|
|||||||
_fi__(_GENERIC__ || !_A29K__)
|
_fi__(_GENERIC__ || !_A29K__)
|
||||||
|
|
||||||
_if__(_A29K__)
|
_if__(_A29K__)
|
||||||
|
_if__(!_GENERIC__)
|
||||||
@section @code{.space}
|
@section @code{.space}
|
||||||
|
|
||||||
@cindex @code{space} directive
|
@cindex @code{space} directive
|
||||||
|
_fi__(!_GENERIC__)
|
||||||
On the AMD 29K, this directive is ignored; it is accepted for
|
On the AMD 29K, this directive is ignored; it is accepted for
|
||||||
compatibility with other AMD 29K assemblers.
|
compatibility with other AMD 29K assemblers.
|
||||||
|
|
||||||
@ -3300,12 +3306,12 @@ _fi__(_AOUT__||_BOUT__||_COFF__)
|
|||||||
_fi__(_GENERIC__||!_H8__)
|
_fi__(_GENERIC__||!_H8__)
|
||||||
|
|
||||||
_if__(_COFF__||_BOUT__)
|
_if__(_COFF__||_BOUT__)
|
||||||
_if__(!_H8__)
|
_if__(_GENERIC__||!_H8__)
|
||||||
@node Tag, Text, Stab, Pseudo Ops
|
@node Tag, Text, Stab, Pseudo Ops
|
||||||
_fi__(!_H8__)
|
_fi__(_GENERIC__||!_H8__)
|
||||||
_if__(_H8__)
|
_if__(_H8__&&!_GENERIC__)
|
||||||
@node Tag, Text, Space, Pseudo Ops
|
@node Tag, Text, Space, Pseudo Ops
|
||||||
_fi__(_H8__)
|
_fi__(_H8__&&!_GENERIC__)
|
||||||
@section @code{.tag @var{structname}}
|
@section @code{.tag @var{structname}}
|
||||||
|
|
||||||
@cindex COFF structure debugging
|
@cindex COFF structure debugging
|
||||||
@ -3702,9 +3708,12 @@ Unconditional branch.
|
|||||||
@end table
|
@end table
|
||||||
@item j@var{COND}
|
@item j@var{COND}
|
||||||
@var{COND} may be any one of the conditional branches
|
@var{COND} may be any one of the conditional branches
|
||||||
@code{neq nequ eql eqlu gtr geq lss gtru lequ vc vs gequ cc lssu cs}.
|
@code{neq}, @code{nequ}, @code{eql}, @code{eqlu}, @code{gtr},
|
||||||
|
@code{geq}, @code{lss}, @code{gtru}, @code{lequ}, @code{vc}, @code{vs},
|
||||||
|
@code{gequ}, @code{cc}, @code{lssu}, @code{cs}.
|
||||||
@var{COND} may also be one of the bit tests
|
@var{COND} may also be one of the bit tests
|
||||||
@code{bs bc bss bcs bsc bcc bssi bcci lbs lbc}.
|
@code{bs}, @code{bc}, @code{bss}, @code{bcs}, @code{bsc}, @code{bcc},
|
||||||
|
@code{bssi}, @code{bcci}, @code{lbs}, @code{lbc}.
|
||||||
@var{NOTCOND} is the opposite condition to @var{COND}.
|
@var{NOTCOND} is the opposite condition to @var{COND}.
|
||||||
@table @asis
|
@table @asis
|
||||||
@item (byte displacement)
|
@item (byte displacement)
|
||||||
@ -4463,8 +4472,8 @@ for the linker to resolve.
|
|||||||
@node Compare-and-branch-i960, , callj-i960, Opcodes for i960
|
@node Compare-and-branch-i960, , callj-i960, Opcodes for i960
|
||||||
_CHAPSEC__(2+_GENERIC__) Compare-and-Branch
|
_CHAPSEC__(2+_GENERIC__) Compare-and-Branch
|
||||||
|
|
||||||
@cindex i960 compare and branch instructions
|
@cindex i960 compare/branch instructions
|
||||||
@cindex compare and branch instructions, i960
|
@cindex compare/branch instructions, i960
|
||||||
The 960 architectures provide combined Compare-and-Branch instructions
|
The 960 architectures provide combined Compare-and-Branch instructions
|
||||||
that permit you to store the branch target in the lower 13 bits of the
|
that permit you to store the branch target in the lower 13 bits of the
|
||||||
instruction word itself. However, if you specify a branch target far
|
instruction word itself. However, if you specify a branch target far
|
||||||
@ -4579,7 +4588,7 @@ bits). This may be useful if you want the object file to be as small as
|
|||||||
possible, and you know that the relevant symbols will be less than 17
|
possible, and you know that the relevant symbols will be less than 17
|
||||||
bits away.
|
bits away.
|
||||||
|
|
||||||
@cindex @code{-m68000} and related options, M680x0
|
@cindex @code{-m68000} and related options
|
||||||
@cindex architecture options, M680x0
|
@cindex architecture options, M680x0
|
||||||
@cindex M680x0 architecture options
|
@cindex M680x0 architecture options
|
||||||
The 680x0 version of @code{_AS__} is most frequently used to assemble
|
The 680x0 version of @code{_AS__} is most frequently used to assemble
|
||||||
@ -4759,10 +4768,10 @@ cases that are more fully described after the table:
|
|||||||
|
|
||||||
@smallexample
|
@smallexample
|
||||||
Displacement
|
Displacement
|
||||||
+---------------------------------------------------------
|
+-------------------------------------------------
|
||||||
| 68020 68000/10
|
| 68020 68000/10
|
||||||
Pseudo-Op |BYTE WORD LONG LONG non-PC relative
|
Pseudo-Op |BYTE WORD LONG LONG non-PC relative
|
||||||
+---------------------------------------------------------
|
+-------------------------------------------------
|
||||||
jbsr |bsrs bsr bsrl jsr jsr
|
jbsr |bsrs bsr bsrl jsr jsr
|
||||||
jra |bras bra bral jmp jmp
|
jra |bras bra bral jmp jmp
|
||||||
* jXX |bXXs bXX bXXl bNXs;jmpl bNXs;jmp
|
* jXX |bXXs bXX bXXl bNXs;jmpl bNXs;jmp
|
||||||
|
Reference in New Issue
Block a user