Fix a typo in ChangeLog
[official-gcc.git] / gcc / config / i386 / constraints.md
blob6cb53b8aafbc447066ecd6dea37f1ed8b1657b1f
1 ;; Constraint definitions for IA-32 and x86-64.
2 ;; Copyright (C) 2006-2013 Free Software Foundation, Inc.
3 ;;
4 ;; This file is part of GCC.
5 ;;
6 ;; GCC is free software; you can redistribute it and/or modify
7 ;; it under the terms of the GNU General Public License as published by
8 ;; the Free Software Foundation; either version 3, or (at your option)
9 ;; any later version.
11 ;; GCC is distributed in the hope that it will be useful,
12 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
13 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14 ;; GNU General Public License for more details.
16 ;; You should have received a copy of the GNU General Public License
17 ;; along with GCC; see the file COPYING3.  If not see
18 ;; <http://www.gnu.org/licenses/>.
20 ;;; Unused letters:
21 ;;;     B     H           T
22 ;;;           h jk          v
24 ;; Integer register constraints.
25 ;; It is not necessary to define 'r' here.
26 (define_register_constraint "R" "LEGACY_REGS"
27  "Legacy register---the eight integer registers available on all
28   i386 processors (@code{a}, @code{b}, @code{c}, @code{d},
29   @code{si}, @code{di}, @code{bp}, @code{sp}).")
31 (define_register_constraint "q" "TARGET_64BIT ? GENERAL_REGS : Q_REGS"
32  "Any register accessible as @code{@var{r}l}.  In 32-bit mode, @code{a},
33   @code{b}, @code{c}, and @code{d}; in 64-bit mode, any integer register.")
35 (define_register_constraint "Q" "Q_REGS"
36  "Any register accessible as @code{@var{r}h}: @code{a}, @code{b},
37   @code{c}, and @code{d}.")
39 (define_register_constraint "l" "INDEX_REGS"
40  "@internal Any register that can be used as the index in a base+index
41   memory access: that is, any general register except the stack pointer.")
43 (define_register_constraint "a" "AREG"
44  "The @code{a} register.")
46 (define_register_constraint "b" "BREG"
47  "The @code{b} register.")
49 (define_register_constraint "c" "CREG"
50  "The @code{c} register.")
52 (define_register_constraint "d" "DREG"
53  "The @code{d} register.")
55 (define_register_constraint "S" "SIREG"
56  "The @code{si} register.")
58 (define_register_constraint "D" "DIREG"
59  "The @code{di} register.")
61 (define_register_constraint "A" "AD_REGS"
62  "The @code{a} and @code{d} registers, as a pair (for instructions
63   that return half the result in one and half in the other).")
65 (define_register_constraint "U" "CLOBBERED_REGS"
66  "The call-clobbered integer registers.")
68 ;; Floating-point register constraints.
69 (define_register_constraint "f"
70  "TARGET_80387 || TARGET_FLOAT_RETURNS_IN_80387 ? FLOAT_REGS : NO_REGS"
71  "Any 80387 floating-point (stack) register.")
73 (define_register_constraint "t"
74  "TARGET_80387 || TARGET_FLOAT_RETURNS_IN_80387 ? FP_TOP_REG : NO_REGS"
75  "Top of 80387 floating-point stack (@code{%st(0)}).")
77 (define_register_constraint "u"
78  "TARGET_80387 || TARGET_FLOAT_RETURNS_IN_80387 ? FP_SECOND_REG : NO_REGS"
79  "Second from top of 80387 floating-point stack (@code{%st(1)}).")
81 ;; Vector registers (also used for plain floating point nowadays).
82 (define_register_constraint "y" "TARGET_MMX ? MMX_REGS : NO_REGS"
83  "Any MMX register.")
85 (define_register_constraint "x" "TARGET_SSE ? SSE_REGS : NO_REGS"
86  "Any SSE register.")
88 ;; We use the Y prefix to denote any number of conditional register sets:
89 ;;  z   First SSE register.
90 ;;  i   SSE2 inter-unit moves to SSE register enabled
91 ;;  j   SSE2 inter-unit moves from SSE register enabled
92 ;;  m   MMX inter-unit moves to MMX register enabled
93 ;;  n   MMX inter-unit moves from MMX register enabled
94 ;;  a   Integer register when zero extensions with AND are disabled
95 ;;  p   Integer register when TARGET_PARTIAL_REG_STALL is disabled
96 ;;  d   Integer register when integer DFmode moves are enabled
97 ;;  x   Integer register when integer XFmode moves are enabled
98 ;;  f   x87 register when 80387 floating point arithmetic is enabled
100 (define_register_constraint "Yz" "TARGET_SSE ? SSE_FIRST_REG : NO_REGS"
101  "First SSE register (@code{%xmm0}).")
103 (define_register_constraint "Yi"
104  "TARGET_SSE2 && TARGET_INTER_UNIT_MOVES_TO_VEC ? SSE_REGS : NO_REGS"
105  "@internal Any SSE register, when SSE2 and inter-unit moves to vector registers are enabled.")
107 (define_register_constraint "Yj"
108  "TARGET_SSE2 && TARGET_INTER_UNIT_MOVES_FROM_VEC ? SSE_REGS : NO_REGS"
109  "@internal Any SSE register, when SSE2 and inter-unit moves from vector registers are enabled.")
111 (define_register_constraint "Ym"
112  "TARGET_MMX && TARGET_INTER_UNIT_MOVES_TO_VEC ? MMX_REGS : NO_REGS"
113  "@internal Any MMX register, when inter-unit moves to vector registers are enabled.")
115 (define_register_constraint "Yn"
116  "TARGET_MMX && TARGET_INTER_UNIT_MOVES_FROM_VEC ? MMX_REGS : NO_REGS"
117  "@internal Any MMX register, when inter-unit moves from vector registers are enabled.")
119 (define_register_constraint "Yp"
120  "TARGET_PARTIAL_REG_STALL ? NO_REGS : GENERAL_REGS"
121  "@internal Any integer register when TARGET_PARTIAL_REG_STALL is disabled.")
123 (define_register_constraint "Ya"
124  "TARGET_ZERO_EXTEND_WITH_AND && optimize_function_for_speed_p (cfun)
125   ? NO_REGS : GENERAL_REGS"
126  "@internal Any integer register when zero extensions with AND are disabled.")
128 (define_register_constraint "Yd"
129  "TARGET_INTEGER_DFMODE_MOVES && optimize_function_for_speed_p (cfun)
130   ? GENERAL_REGS : NO_REGS"
131  "@internal Any integer register when integer DFmode moves are enabled.")
133 (define_register_constraint "Yx"
134  "optimize_function_for_speed_p (cfun) ? GENERAL_REGS : NO_REGS"
135  "@internal Any integer register when integer XFmode moves are enabled.")
137 (define_register_constraint "Yf"
138  "(ix86_fpmath & FPMATH_387) ? FLOAT_REGS : NO_REGS"
139  "@internal Any x87 register when 80387 FP arithmetic is enabled.")
141 (define_constraint "z"
142   "@internal Constant call address operand."
143   (match_operand 0 "constant_call_address_operand"))
145 (define_constraint "w"
146   "@internal Call memory operand."
147   (and (not (match_test "TARGET_X32"))
148        (match_operand 0 "memory_operand")))
150 ;; Integer constant constraints.
151 (define_constraint "I"
152   "Integer constant in the range 0 @dots{} 31, for 32-bit shifts."
153   (and (match_code "const_int")
154        (match_test "IN_RANGE (ival, 0, 31)")))
156 (define_constraint "J"
157   "Integer constant in the range 0 @dots{} 63, for 64-bit shifts."
158   (and (match_code "const_int")
159        (match_test "IN_RANGE (ival, 0, 63)")))
161 (define_constraint "K"
162   "Signed 8-bit integer constant."
163   (and (match_code "const_int")
164        (match_test "IN_RANGE (ival, -128, 127)")))
166 (define_constraint "L"
167   "@code{0xFF}, @code{0xFFFF} or @code{0xFFFFFFFF}
168    for AND as a zero-extending move."
169   (and (match_code "const_int")
170        (match_test "ival == 0xff || ival == 0xffff
171                     || ival == (HOST_WIDE_INT) 0xffffffff")))
173 (define_constraint "M"
174   "0, 1, 2, or 3 (shifts for the @code{lea} instruction)."
175   (and (match_code "const_int")
176        (match_test "IN_RANGE (ival, 0, 3)")))
178 (define_constraint "N"
179   "Unsigned 8-bit integer constant (for @code{in} and @code{out}
180    instructions)."
181   (and (match_code "const_int")
182        (match_test "IN_RANGE (ival, 0, 255)")))
184 (define_constraint "O"
185   "@internal Integer constant in the range 0 @dots{} 127, for 128-bit shifts."
186   (and (match_code "const_int")
187        (match_test "IN_RANGE (ival, 0, 127)")))
189 ;; Floating-point constant constraints.
190 ;; We allow constants even if TARGET_80387 isn't set, because the
191 ;; stack register converter may need to load 0.0 into the function
192 ;; value register (top of stack).
193 (define_constraint "G"
194   "Standard 80387 floating point constant."
195   (and (match_code "const_double")
196        (match_test "standard_80387_constant_p (op) > 0")))
198 ;; This can theoretically be any mode's CONST0_RTX.
199 (define_constraint "C"
200   "Standard SSE floating point constant."
201   (match_test "standard_sse_constant_p (op)"))
203 ;; Constant-or-symbol-reference constraints.
205 (define_constraint "e"
206   "32-bit signed integer constant, or a symbolic reference known
207    to fit that range (for immediate operands in sign-extending x86-64
208    instructions)."
209   (match_operand 0 "x86_64_immediate_operand"))
211 ;; We use W prefix to denote any number of
212 ;; constant-or-symbol-reference constraints
214 (define_constraint "Wz"
215   "32-bit unsigned integer constant, or a symbolic reference known
216    to fit that range (for zero-extending conversion operations that
217    require non-VOIDmode immediate operands)."
218   (and (match_operand 0 "x86_64_zext_immediate_operand")
219        (match_test "GET_MODE (op) != VOIDmode")))
221 (define_constraint "Z"
222   "32-bit unsigned integer constant, or a symbolic reference known
223    to fit that range (for immediate operands in zero-extending x86-64
224    instructions)."
225   (match_operand 0 "x86_64_zext_immediate_operand"))