1 |
6 |
jlechner |
@c Copyright 2000, 2003 Free Software Foundation, Inc.
|
2 |
|
|
@c This is part of the GAS manual.
|
3 |
|
|
@c For copying conditions, see the file as.texinfo.
|
4 |
|
|
@ifset GENERIC
|
5 |
|
|
@page
|
6 |
|
|
@node i860-Dependent
|
7 |
|
|
@chapter Intel i860 Dependent Features
|
8 |
|
|
@end ifset
|
9 |
|
|
@ifclear GENERIC
|
10 |
|
|
@node Machine Dependencies
|
11 |
|
|
@chapter Intel i860 Dependent Features
|
12 |
|
|
@end ifclear
|
13 |
|
|
|
14 |
|
|
@ignore
|
15 |
|
|
@c FIXME: This is basically a stub for i860. There is tons more information
|
16 |
|
|
that I will add later (jle@cygnus.com).
|
17 |
|
|
@end ignore
|
18 |
|
|
|
19 |
|
|
@cindex i860 support
|
20 |
|
|
@menu
|
21 |
|
|
* Notes-i860:: i860 Notes
|
22 |
|
|
* Options-i860:: i860 Command-line Options
|
23 |
|
|
* Directives-i860:: i860 Machine Directives
|
24 |
|
|
* Opcodes for i860:: i860 Opcodes
|
25 |
|
|
@end menu
|
26 |
|
|
|
27 |
|
|
@node Notes-i860
|
28 |
|
|
@section i860 Notes
|
29 |
|
|
This is a fairly complete i860 assembler which is compatible with the
|
30 |
|
|
UNIX System V/860 Release 4 assembler. However, it does not currently
|
31 |
|
|
support SVR4 PIC (i.e., @code{@@GOT, @@GOTOFF, @@PLT}).
|
32 |
|
|
|
33 |
|
|
Like the SVR4/860 assembler, the output object format is ELF32. Currently,
|
34 |
|
|
this is the only supported object format. If there is sufficient interest,
|
35 |
|
|
other formats such as COFF may be implemented.
|
36 |
|
|
|
37 |
|
|
Both the Intel and AT&T/SVR4 syntaxes are supported, with the latter
|
38 |
|
|
being the default. One difference is that AT&T syntax requires the '%'
|
39 |
|
|
prefix on register names while Intel syntax does not. Another difference
|
40 |
|
|
is in the specification of relocatable expressions. The Intel syntax
|
41 |
|
|
is @code{ha%expression} whereas the SVR4 syntax is @code{[expression]@@ha}
|
42 |
|
|
(and similarly for the "l" and "h" selectors).
|
43 |
|
|
@node Options-i860
|
44 |
|
|
@section i860 Command-line Options
|
45 |
|
|
@subsection SVR4 compatibility options
|
46 |
|
|
@table @code
|
47 |
|
|
@item -V
|
48 |
|
|
Print assembler version.
|
49 |
|
|
@item -Qy
|
50 |
|
|
Ignored.
|
51 |
|
|
@item -Qn
|
52 |
|
|
Ignored.
|
53 |
|
|
@end table
|
54 |
|
|
@subsection Other options
|
55 |
|
|
@table @code
|
56 |
|
|
@item -EL
|
57 |
|
|
Select little endian output (this is the default).
|
58 |
|
|
@item -EB
|
59 |
|
|
Select big endian output. Note that the i860 always reads instructions
|
60 |
|
|
as little endian data, so this option only effects data and not
|
61 |
|
|
instructions.
|
62 |
|
|
@item -mwarn-expand
|
63 |
|
|
Emit a warning message if any pseudo-instruction expansions occurred.
|
64 |
|
|
For example, a @code{or} instruction with an immediate larger than 16-bits
|
65 |
|
|
will be expanded into two instructions. This is a very undesirable feature to
|
66 |
|
|
rely on, so this flag can help detect any code where it happens. One
|
67 |
|
|
use of it, for instance, has been to find and eliminate any place
|
68 |
|
|
where @code{gcc} may emit these pseudo-instructions.
|
69 |
|
|
@item -mxp
|
70 |
|
|
Enable support for the i860XP instructions and control registers. By default,
|
71 |
|
|
this option is disabled so that only the base instruction set (i.e., i860XR)
|
72 |
|
|
is supported.
|
73 |
|
|
@item -mintel-syntax
|
74 |
|
|
The i860 assembler defaults to AT&T/SVR4 syntax. This option enables the
|
75 |
|
|
Intel syntax.
|
76 |
|
|
@end table
|
77 |
|
|
|
78 |
|
|
@node Directives-i860
|
79 |
|
|
@section i860 Machine Directives
|
80 |
|
|
|
81 |
|
|
@cindex machine directives, i860
|
82 |
|
|
@cindex i860 machine directives
|
83 |
|
|
|
84 |
|
|
@table @code
|
85 |
|
|
@cindex @code{dual} directive, i860
|
86 |
|
|
@item .dual
|
87 |
|
|
Enter dual instruction mode. While this directive is supported, the
|
88 |
|
|
preferred way to use dual instruction mode is to explicitly code
|
89 |
|
|
the dual bit with the @code{d.} prefix.
|
90 |
|
|
@end table
|
91 |
|
|
|
92 |
|
|
@table @code
|
93 |
|
|
@cindex @code{enddual} directive, i860
|
94 |
|
|
@item .enddual
|
95 |
|
|
Exit dual instruction mode. While this directive is supported, the
|
96 |
|
|
preferred way to use dual instruction mode is to explicitly code
|
97 |
|
|
the dual bit with the @code{d.} prefix.
|
98 |
|
|
@end table
|
99 |
|
|
|
100 |
|
|
@table @code
|
101 |
|
|
@cindex @code{atmp} directive, i860
|
102 |
|
|
@item .atmp
|
103 |
|
|
Change the temporary register used when expanding pseudo operations. The
|
104 |
|
|
default register is @code{r31}.
|
105 |
|
|
@end table
|
106 |
|
|
|
107 |
|
|
The @code{.dual}, @code{.enddual}, and @code{.atmp} directives are available only in the Intel syntax mode.
|
108 |
|
|
|
109 |
|
|
Both syntaxes allow for the standard @code{.align} directive. However,
|
110 |
|
|
the Intel syntax additionally allows keywords for the alignment
|
111 |
|
|
parameter: "@code{.align type}", where `type' is one of @code{.short}, @code{.long},
|
112 |
|
|
@code{.quad}, @code{.single}, @code{.double} representing alignments of 2, 4,
|
113 |
|
|
16, 4, and 8, respectively.
|
114 |
|
|
|
115 |
|
|
@node Opcodes for i860
|
116 |
|
|
@section i860 Opcodes
|
117 |
|
|
|
118 |
|
|
@cindex opcodes, i860
|
119 |
|
|
@cindex i860 opcodes
|
120 |
|
|
All of the Intel i860XR and i860XP machine instructions are supported. Please see
|
121 |
|
|
either @emph{i860 Microprocessor Programmer's Reference Manual} or @emph{i860 Microprocessor Architecture} for more information.
|
122 |
|
|
@subsection Other instruction support (pseudo-instructions)
|
123 |
|
|
For compatibility with some other i860 assemblers, a number of
|
124 |
|
|
pseudo-instructions are supported. While these are supported, they are
|
125 |
|
|
a very undesirable feature that should be avoided -- in particular, when
|
126 |
|
|
they result in an expansion to multiple actual i860 instructions. Below
|
127 |
|
|
are the pseudo-instructions that result in expansions.
|
128 |
|
|
@itemize @bullet
|
129 |
|
|
@item Load large immediate into general register:
|
130 |
|
|
|
131 |
|
|
The pseudo-instruction @code{mov imm,%rn} (where the immediate does
|
132 |
|
|
not fit within a signed 16-bit field) will be expanded into:
|
133 |
|
|
@smallexample
|
134 |
|
|
orh large_imm@@h,%r0,%rn
|
135 |
|
|
or large_imm@@l,%rn,%rn
|
136 |
|
|
@end smallexample
|
137 |
|
|
@item Load/store with relocatable address expression:
|
138 |
|
|
|
139 |
|
|
For example, the pseudo-instruction @code{ld.b addr_exp(%rx),%rn}
|
140 |
|
|
will be expanded into:
|
141 |
|
|
@smallexample
|
142 |
|
|
orh addr_exp@@ha,%rx,%r31
|
143 |
|
|
ld.l addr_exp@@l(%r31),%rn
|
144 |
|
|
@end smallexample
|
145 |
|
|
|
146 |
|
|
The analogous expansions apply to @code{ld.x, st.x, fld.x, pfld.x, fst.x}, and @code{pst.x} as well.
|
147 |
|
|
@item Signed large immediate with add/subtract:
|
148 |
|
|
|
149 |
|
|
If any of the arithmetic operations @code{adds, addu, subs, subu} are used
|
150 |
|
|
with an immediate larger than 16-bits (signed), then they will be expanded.
|
151 |
|
|
For instance, the pseudo-instruction @code{adds large_imm,%rx,%rn} expands to:
|
152 |
|
|
@smallexample
|
153 |
|
|
orh large_imm@@h,%r0,%r31
|
154 |
|
|
or large_imm@@l,%r31,%r31
|
155 |
|
|
adds %r31,%rx,%rn
|
156 |
|
|
@end smallexample
|
157 |
|
|
@item Unsigned large immediate with logical operations:
|
158 |
|
|
|
159 |
|
|
Logical operations (@code{or, andnot, or, xor}) also result in expansions.
|
160 |
|
|
The pseudo-instruction @code{or large_imm,%rx,%rn} results in:
|
161 |
|
|
@smallexample
|
162 |
|
|
orh large_imm@@h,%rx,%r31
|
163 |
|
|
or large_imm@@l,%r31,%rn
|
164 |
|
|
@end smallexample
|
165 |
|
|
|
166 |
|
|
Similarly for the others, except for @code{and} which expands to:
|
167 |
|
|
@smallexample
|
168 |
|
|
andnot (-1 - large_imm)@@h,%rx,%r31
|
169 |
|
|
andnot (-1 - large_imm)@@l,%r31,%rn
|
170 |
|
|
@end smallexample
|
171 |
|
|
@end itemize
|
172 |
|
|
|