]> gcc.gnu.org Git - gcc.git/blame - gcc/rtl.def
arm.c (arm_override_options): Error on iWMMXt and hardware floating point.
[gcc.git] / gcc / rtl.def
CommitLineData
1af1688b
RK
1/* This file contains the definitions and documentation for the
2 Register Transfer Expressions (rtx's) that make up the
3 Register Transfer Language (rtl) used in the Back End of the GNU compiler.
ad616de1 4 Copyright (C) 1987, 1988, 1992, 1994, 1995, 1997, 1998, 1999, 2000, 2004,
c7ec5472 5 2005, 2006
c5c76735 6 Free Software Foundation, Inc.
1af1688b 7
1322177d 8This file is part of GCC.
1af1688b 9
1322177d
LB
10GCC is free software; you can redistribute it and/or modify it under
11the terms of the GNU General Public License as published by the Free
12Software Foundation; either version 2, or (at your option) any later
13version.
1af1688b 14
1322177d
LB
15GCC is distributed in the hope that it will be useful, but WITHOUT ANY
16WARRANTY; without even the implied warranty of MERCHANTABILITY or
17FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
18for more details.
1af1688b
RK
19
20You should have received a copy of the GNU General Public License
1322177d 21along with GCC; see the file COPYING. If not, write to the Free
366ccddb
KC
22Software Foundation, 51 Franklin Street, Fifth Floor, Boston, MA
2302110-1301, USA. */
1af1688b
RK
24
25
26/* Expression definitions and descriptions for all targets are in this file.
27 Some will not be used for some targets.
28
29 The fields in the cpp macro call "DEF_RTL_EXPR()"
30 are used to create declarations in the C source of the compiler.
31
32 The fields are:
33
34 1. The internal name of the rtx used in the C source.
35 It is a tag in the enumeration "enum rtx_code" defined in "rtl.h".
36 By convention these are in UPPER_CASE.
37
38 2. The name of the rtx in the external ASCII format read by
39 read_rtx(), and printed by print_rtx().
40 These names are stored in rtx_name[].
41 By convention these are the internal (field 1) names in lower_case.
42
e1de1560 43 3. The print format, and type of each rtx->u.fld[] (field) in this rtx.
1af1688b
RK
44 These formats are stored in rtx_format[].
45 The meaning of the formats is documented in front of this array in rtl.c
46
47 4. The class of the rtx. These are stored in rtx_class and are accessed
48 via the GET_RTX_CLASS macro. They are defined as follows:
49
ec8e098d
PB
50 RTX_CONST_OBJ
51 an rtx code that can be used to represent a constant object
52 (e.g, CONST_INT)
53 RTX_OBJ
54 an rtx code that can be used to represent an object (e.g, REG, MEM)
55 RTX_COMPARE
56 an rtx code for a comparison (e.g, LT, GT)
57 RTX_COMM_COMPARE
58 an rtx code for a commutative comparison (e.g, EQ, NE, ORDERED)
59 RTX_UNARY
60 an rtx code for a unary arithmetic expression (e.g, NEG, NOT)
61 RTX_COMM_ARITH
62 an rtx code for a commutative binary operation (e.g,, PLUS, MULT)
63 RTX_TERNARY
64 an rtx code for a non-bitfield three input operation (IF_THEN_ELSE)
65 RTX_BIN_ARITH
66 an rtx code for a non-commutative binary operation (e.g., MINUS, DIV)
67 RTX_BITFIELD_OPS
68 an rtx code for a bit-field operation (ZERO_EXTRACT, SIGN_EXTRACT)
69 RTX_INSN
70 an rtx code for a machine insn (INSN, JUMP_INSN, CALL_INSN)
71 RTX_MATCH
72 an rtx code for something that matches in insns (e.g, MATCH_DUP)
73 RTX_AUTOINC
74 an rtx code for autoincrement addressing modes (e.g. POST_DEC)
75 RTX_EXTRA
76 everything else
1af1688b 77
b5c2f1d1
ZW
78 All of the expressions that appear only in machine descriptions,
79 not in RTL used by the compiler itself, are at the end of the file. */
1af1688b 80
b5c2f1d1
ZW
81/* Unknown, or no such operation; the enumeration constant should have
82 value zero. */
ec8e098d 83DEF_RTL_EXPR(UNKNOWN, "UnKnown", "*", RTX_EXTRA)
1af1688b 84
1af1688b
RK
85/* ---------------------------------------------------------------------
86 Expressions used in constructing lists.
87 --------------------------------------------------------------------- */
88
89/* a linked list of expressions */
ec8e098d 90DEF_RTL_EXPR(EXPR_LIST, "expr_list", "ee", RTX_EXTRA)
1af1688b
RK
91
92/* a linked list of instructions.
93 The insns are represented in print by their uids. */
ec8e098d 94DEF_RTL_EXPR(INSN_LIST, "insn_list", "ue", RTX_EXTRA)
1af1688b 95
ddbd5439
MK
96/* a linked list of dependencies.
97 The insns are represented in print by their uids.
c7ec5472
MK
98 Operand 2 is the status of a dependence (see sched-int.h for more). */
99DEF_RTL_EXPR(DEPS_LIST, "deps_list", "uei", RTX_EXTRA)
ddbd5439 100
b5c2f1d1
ZW
101/* SEQUENCE appears in the result of a `gen_...' function
102 for a DEFINE_EXPAND that wants to make several insns.
103 Its elements are the bodies of the insns that should be made.
104 `emit_insn' takes the SEQUENCE apart and makes separate insns. */
105DEF_RTL_EXPR(SEQUENCE, "sequence", "E", RTX_EXTRA)
1af1688b 106
b5c2f1d1
ZW
107/* Refers to the address of its argument. This is only used in alias.c. */
108DEF_RTL_EXPR(ADDRESS, "address", "e", RTX_MATCH)
1af1688b 109
b5c2f1d1
ZW
110/* ----------------------------------------------------------------------
111 Expression types used for things in the instruction chain.
1af1688b 112
b5c2f1d1
ZW
113 All formats must start with "iuu" to handle the chain.
114 Each insn expression holds an rtl instruction and its semantics
115 during back-end processing.
116 See macros's in "rtl.h" for the meaning of each rtx->u.fld[].
1af1688b 117
b5c2f1d1 118 ---------------------------------------------------------------------- */
1af1688b 119
b5c2f1d1
ZW
120/* An instruction that cannot jump. */
121DEF_RTL_EXPR(INSN, "insn", "iuuBieiee", RTX_INSN)
1af1688b 122
b5c2f1d1
ZW
123/* An instruction that can possibly jump.
124 Fields ( rtx->u.fld[] ) have exact same meaning as INSN's. */
125DEF_RTL_EXPR(JUMP_INSN, "jump_insn", "iuuBieiee0", RTX_INSN)
1af1688b 126
b5c2f1d1
ZW
127/* An instruction that can possibly call a subroutine
128 but which will not change which instruction comes next
129 in the current function.
130 Field ( rtx->u.fld[9] ) is CALL_INSN_FUNCTION_USAGE.
131 All other fields ( rtx->u.fld[] ) have exact same meaning as INSN's. */
132DEF_RTL_EXPR(CALL_INSN, "call_insn", "iuuBieieee", RTX_INSN)
1af1688b 133
b5c2f1d1
ZW
134/* A marker that indicates that control will not flow through. */
135DEF_RTL_EXPR(BARRIER, "barrier", "iuu000000", RTX_EXTRA)
1af1688b 136
b5c2f1d1
ZW
137/* Holds a label that is followed by instructions.
138 Operand:
139 4: is used in jump.c for the use-count of the label.
140 5: is used in flow.c to point to the chain of label_ref's to this label.
141 6: is a number that is unique in the entire compilation.
142 7: is the user-given name of the label, if any. */
143DEF_RTL_EXPR(CODE_LABEL, "code_label", "iuuB00is", RTX_EXTRA)
1af1688b 144
b5c2f1d1
ZW
145#ifdef USE_MAPPED_LOCATION
146/* Say where in the code a source line starts, for symbol table's sake.
147 Operand:
148 4: unused if line number > 0, note-specific data otherwise.
149 5: line number if > 0, enum note_insn otherwise.
150 6: CODE_LABEL_NUMBER if line number == NOTE_INSN_DELETED_LABEL. */
151#else
152/* Say where in the code a source line starts, for symbol table's sake.
153 Operand:
154 4: filename, if line number > 0, note-specific data otherwise.
155 5: line number if > 0, enum note_insn otherwise.
156 6: unique number if line number == note_insn_deleted_label. */
157#endif
158DEF_RTL_EXPR(NOTE, "note", "iuuB0ni", RTX_EXTRA)
1af1688b 159
b5c2f1d1
ZW
160/* ----------------------------------------------------------------------
161 Top level constituents of INSN, JUMP_INSN and CALL_INSN.
162 ---------------------------------------------------------------------- */
163
164/* Conditionally execute code.
165 Operand 0 is the condition that if true, the code is executed.
166 Operand 1 is the code to be executed (typically a SET).
1af1688b 167
b5c2f1d1
ZW
168 Semantics are that there are no side effects if the condition
169 is false. This pattern is created automatically by the if_convert
170 pass run after reload or by target-specific splitters. */
171DEF_RTL_EXPR(COND_EXEC, "cond_exec", "ee", RTX_EXTRA)
1af1688b 172
b5c2f1d1
ZW
173/* Several operations to be done in parallel (perhaps under COND_EXEC). */
174DEF_RTL_EXPR(PARALLEL, "parallel", "E", RTX_EXTRA)
ae3c61fa 175
b5c2f1d1
ZW
176/* A string that is passed through to the assembler as input.
177 One can obviously pass comments through by using the
178 assembler comment syntax.
179 These occur in an insn all by themselves as the PATTERN.
180 They also appear inside an ASM_OPERANDS
181 as a convenient way to hold a string. */
182DEF_RTL_EXPR(ASM_INPUT, "asm_input", "s", RTX_EXTRA)
e543e219 183
b5c2f1d1
ZW
184#ifdef USE_MAPPED_LOCATION
185/* An assembler instruction with operands.
186 1st operand is the instruction template.
187 2nd operand is the constraint for the output.
188 3rd operand is the number of the output this expression refers to.
189 When an insn stores more than one value, a separate ASM_OPERANDS
190 is made for each output; this integer distinguishes them.
191 4th is a vector of values of input operands.
192 5th is a vector of modes and constraints for the input operands.
193 Each element is an ASM_INPUT containing a constraint string
194 and whose mode indicates the mode of the input operand.
195 6th is the source line number. */
196DEF_RTL_EXPR(ASM_OPERANDS, "asm_operands", "ssiEEi", RTX_EXTRA)
197#else
198/* An assembler instruction with operands.
199 1st operand is the instruction template.
200 2nd operand is the constraint for the output.
201 3rd operand is the number of the output this expression refers to.
202 When an insn stores more than one value, a separate ASM_OPERANDS
203 is made for each output; this integer distinguishes them.
204 4th is a vector of values of input operands.
205 5th is a vector of modes and constraints for the input operands.
206 Each element is an ASM_INPUT containing a constraint string
207 and whose mode indicates the mode of the input operand.
208 6th is the name of the containing source file.
209 7th is the source line number. */
210DEF_RTL_EXPR(ASM_OPERANDS, "asm_operands", "ssiEEsi", RTX_EXTRA)
211#endif
e543e219 212
b5c2f1d1
ZW
213/* A machine-specific operation.
214 1st operand is a vector of operands being used by the operation so that
215 any needed reloads can be done.
216 2nd operand is a unique value saying which of a number of machine-specific
217 operations is to be performed.
218 (Note that the vector must be the first operand because of the way that
219 genrecog.c record positions within an insn.)
220 This can occur all by itself in a PATTERN, as a component of a PARALLEL,
221 or inside an expression. */
222DEF_RTL_EXPR(UNSPEC, "unspec", "Ei", RTX_EXTRA)
1af1688b 223
b5c2f1d1
ZW
224/* Similar, but a volatile operation and one which may trap. */
225DEF_RTL_EXPR(UNSPEC_VOLATILE, "unspec_volatile", "Ei", RTX_EXTRA)
1af1688b 226
b5c2f1d1
ZW
227/* Vector of addresses, stored as full words. */
228/* Each element is a LABEL_REF to a CODE_LABEL whose address we want. */
229DEF_RTL_EXPR(ADDR_VEC, "addr_vec", "E", RTX_EXTRA)
1af1688b 230
b5c2f1d1
ZW
231/* Vector of address differences X0 - BASE, X1 - BASE, ...
232 First operand is BASE; the vector contains the X's.
233 The machine mode of this rtx says how much space to leave
234 for each difference and is adjusted by branch shortening if
235 CASE_VECTOR_SHORTEN_MODE is defined.
236 The third and fourth operands store the target labels with the
237 minimum and maximum addresses respectively.
238 The fifth operand stores flags for use by branch shortening.
239 Set at the start of shorten_branches:
240 min_align: the minimum alignment for any of the target labels.
241 base_after_vec: true iff BASE is after the ADDR_DIFF_VEC.
242 min_after_vec: true iff minimum addr target label is after the ADDR_DIFF_VEC.
243 max_after_vec: true iff maximum addr target label is after the ADDR_DIFF_VEC.
244 min_after_base: true iff minimum address target label is after BASE.
245 max_after_base: true iff maximum address target label is after BASE.
246 Set by the actual branch shortening process:
247 offset_unsigned: true iff offsets have to be treated as unsigned.
248 scale: scaling that is necessary to make offsets fit into the mode.
c88c0d42 249
b5c2f1d1
ZW
250 The third, fourth and fifth operands are only valid when
251 CASE_VECTOR_SHORTEN_MODE is defined, and only in an optimizing
252 compilations. */
253
254DEF_RTL_EXPR(ADDR_DIFF_VEC, "addr_diff_vec", "eEee0", RTX_EXTRA)
ede7cd44 255
b5c2f1d1
ZW
256/* Memory prefetch, with attributes supported on some targets.
257 Operand 1 is the address of the memory to fetch.
258 Operand 2 is 1 for a write access, 0 otherwise.
259 Operand 3 is the level of temporal locality; 0 means there is no
260 temporal locality and 1, 2, and 3 are for increasing levels of temporal
261 locality.
1af1688b 262
b5c2f1d1
ZW
263 The attributes specified by operands 2 and 3 are ignored for targets
264 whose prefetch instructions do not support them. */
265DEF_RTL_EXPR(PREFETCH, "prefetch", "eee", RTX_EXTRA)
1af1688b 266
b5c2f1d1
ZW
267/* ----------------------------------------------------------------------
268 At the top level of an instruction (perhaps under PARALLEL).
269 ---------------------------------------------------------------------- */
1af1688b 270
b5c2f1d1
ZW
271/* Assignment.
272 Operand 1 is the location (REG, MEM, PC, CC0 or whatever) assigned to.
273 Operand 2 is the value stored there.
274 ALL assignment must use SET.
275 Instructions that do multiple assignments must use multiple SET,
276 under PARALLEL. */
277DEF_RTL_EXPR(SET, "set", "ee", RTX_EXTRA)
3262c1f5 278
b5c2f1d1
ZW
279/* Indicate something is used in a way that we don't want to explain.
280 For example, subroutine calls will use the register
281 in which the static chain is passed. */
282DEF_RTL_EXPR(USE, "use", "e", RTX_EXTRA)
3262c1f5 283
b5c2f1d1
ZW
284/* Indicate something is clobbered in a way that we don't want to explain.
285 For example, subroutine calls will clobber some physical registers
286 (the ones that are by convention not saved). */
287DEF_RTL_EXPR(CLOBBER, "clobber", "e", RTX_EXTRA)
e543e219 288
b5c2f1d1
ZW
289/* Call a subroutine.
290 Operand 1 is the address to call.
291 Operand 2 is the number of arguments. */
e543e219 292
b5c2f1d1 293DEF_RTL_EXPR(CALL, "call", "ee", RTX_EXTRA)
1af1688b 294
b5c2f1d1
ZW
295/* Return from a subroutine. */
296
297DEF_RTL_EXPR(RETURN, "return", "", RTX_EXTRA)
298
299/* Conditional trap.
300 Operand 1 is the condition.
301 Operand 2 is the trap code.
302 For an unconditional trap, make the condition (const_int 1). */
303DEF_RTL_EXPR(TRAP_IF, "trap_if", "ee", RTX_EXTRA)
304
305/* Placeholder for _Unwind_Resume before we know if a function call
306 or a branch is needed. Operand 1 is the exception region from
307 which control is flowing. */
308DEF_RTL_EXPR(RESX, "resx", "i", RTX_EXTRA)
1af1688b 309
fae15c93 310/* ----------------------------------------------------------------------
b5c2f1d1 311 Primitive values for use in expressions.
fae15c93
VM
312 ---------------------------------------------------------------------- */
313
b5c2f1d1
ZW
314/* numeric integer constant */
315DEF_RTL_EXPR(CONST_INT, "const_int", "w", RTX_CONST_OBJ)
fae15c93 316
b5c2f1d1
ZW
317/* numeric floating point constant.
318 Operands hold the value. They are all 'w' and there may be from 2 to 6;
319 see real.h. */
320DEF_RTL_EXPR(CONST_DOUBLE, "const_double", CONST_DOUBLE_FORMAT, RTX_CONST_OBJ)
fae15c93 321
b5c2f1d1 322/* Describes a vector constant. */
f4770271 323DEF_RTL_EXPR(CONST_VECTOR, "const_vector", "E", RTX_CONST_OBJ)
fae15c93 324
b5c2f1d1
ZW
325/* String constant. Used for attributes in machine descriptions and
326 for special cases in DWARF2 debug output. NOT used for source-
327 language string constants. */
328DEF_RTL_EXPR(CONST_STRING, "const_string", "s", RTX_OBJ)
fae15c93 329
b5c2f1d1
ZW
330/* This is used to encapsulate an expression whose value is constant
331 (such as the sum of a SYMBOL_REF and a CONST_INT) so that it will be
332 recognized as a constant operand rather than by arithmetic instructions. */
fae15c93 333
b5c2f1d1 334DEF_RTL_EXPR(CONST, "const", "e", RTX_CONST_OBJ)
30028c85 335
b5c2f1d1
ZW
336/* program counter. Ordinary jumps are represented
337 by a SET whose first operand is (PC). */
338DEF_RTL_EXPR(PC, "pc", "", RTX_OBJ)
30028c85 339
d67fb775
SB
340/* Used in the cselib routines to describe a value. Objects of this
341 kind are only allocated in cselib.c, in an alloc pool instead of
342 in GC memory. The only operand of a VALUE is a cselib_val_struct. */
b5c2f1d1 343DEF_RTL_EXPR(VALUE, "value", "0", RTX_OBJ)
30028c85 344
b5c2f1d1
ZW
345/* A register. The "operand" is the register number, accessed with
346 the REGNO macro. If this number is less than FIRST_PSEUDO_REGISTER
347 than a hardware register is being referred to. The second operand
348 holds the original register number - this will be different for a
18b3a02a
GK
349 pseudo register that got turned into a hard register. The third
350 operand points to a reg_attrs structure.
b5c2f1d1
ZW
351 This rtx needs to have as many (or more) fields as a MEM, since we
352 can change REG rtx's into MEMs during reload. */
353DEF_RTL_EXPR(REG, "reg", "i00", RTX_OBJ)
30028c85 354
b5c2f1d1
ZW
355/* A scratch register. This represents a register used only within a
356 single insn. It will be turned into a REG during register allocation
357 or reload unless the constraint indicates that the register won't be
358 needed, in which case it can remain a SCRATCH. This code is
359 marked as having one operand so it can be turned into a REG. */
360DEF_RTL_EXPR(SCRATCH, "scratch", "0", RTX_OBJ)
fae15c93 361
b5c2f1d1
ZW
362/* One word of a multi-word value.
363 The first operand is the complete value; the second says which word.
364 The WORDS_BIG_ENDIAN flag controls whether word number 0
365 (as numbered in a SUBREG) is the most or least significant word.
30028c85 366
b5c2f1d1
ZW
367 This is also used to refer to a value in a different machine mode.
368 For example, it can be used to refer to a SImode value as if it were
369 Qimode, or vice versa. Then the word number is always 0. */
370DEF_RTL_EXPR(SUBREG, "subreg", "ei", RTX_EXTRA)
30028c85 371
b5c2f1d1
ZW
372/* This one-argument rtx is used for move instructions
373 that are guaranteed to alter only the low part of a destination.
374 Thus, (SET (SUBREG:HI (REG...)) (MEM:HI ...))
375 has an unspecified effect on the high part of REG,
376 but (SET (STRICT_LOW_PART (SUBREG:HI (REG...))) (MEM:HI ...))
377 is guaranteed to alter only the bits of REG that are in HImode.
30028c85 378
b5c2f1d1
ZW
379 The actual instruction used is probably the same in both cases,
380 but the register constraints may be tighter when STRICT_LOW_PART
381 is in use. */
30028c85 382
b5c2f1d1 383DEF_RTL_EXPR(STRICT_LOW_PART, "strict_low_part", "e", RTX_EXTRA)
30028c85 384
b5c2f1d1
ZW
385/* (CONCAT a b) represents the virtual concatenation of a and b
386 to make a value that has as many bits as a and b put together.
387 This is used for complex values. Normally it appears only
388 in DECL_RTLs and during RTL generation, but not in the insn chain. */
389DEF_RTL_EXPR(CONCAT, "concat", "ee", RTX_OBJ)
30028c85 390
b5c2f1d1
ZW
391/* A memory location; operand is the address. The second operand is the
392 alias set to which this MEM belongs. We use `0' instead of `w' for this
393 field so that the field need not be specified in machine descriptions. */
394DEF_RTL_EXPR(MEM, "mem", "e0", RTX_OBJ)
30028c85 395
b5c2f1d1 396/* Reference to an assembler label in the code for this function.
fc6c490e
SB
397 The operand is a CODE_LABEL found in the insn chain. */
398DEF_RTL_EXPR(LABEL_REF, "label_ref", "u", RTX_CONST_OBJ)
30028c85 399
b5c2f1d1
ZW
400/* Reference to a named label:
401 Operand 0: label name
402 Operand 1: flags (see SYMBOL_FLAG_* in rtl.h)
403 Operand 2: tree from which this symbol is derived, or null.
404 This is either a DECL node, or some kind of constant. */
405DEF_RTL_EXPR(SYMBOL_REF, "symbol_ref", "s00", RTX_CONST_OBJ)
30028c85 406
b5c2f1d1
ZW
407/* The condition code register is represented, in our imagination,
408 as a register holding a value that can be compared to zero.
409 In fact, the machine has already compared them and recorded the
410 results; but instructions that look at the condition code
411 pretend to be looking at the entire value and comparing it. */
412DEF_RTL_EXPR(CC0, "cc0", "", RTX_OBJ)
30028c85 413
b5c2f1d1
ZW
414/* ----------------------------------------------------------------------
415 Expressions for operators in an rtl pattern
416 ---------------------------------------------------------------------- */
fae15c93 417
b5c2f1d1
ZW
418/* if_then_else. This is used in representing ordinary
419 conditional jump instructions.
420 Operand:
421 0: condition
422 1: then expr
423 2: else expr */
424DEF_RTL_EXPR(IF_THEN_ELSE, "if_then_else", "eee", RTX_TERNARY)
fae15c93 425
b5c2f1d1
ZW
426/* Comparison, produces a condition code result. */
427DEF_RTL_EXPR(COMPARE, "compare", "ee", RTX_BIN_ARITH)
fae15c93 428
b5c2f1d1
ZW
429/* plus */
430DEF_RTL_EXPR(PLUS, "plus", "ee", RTX_COMM_ARITH)
fae15c93 431
b5c2f1d1
ZW
432/* Operand 0 minus operand 1. */
433DEF_RTL_EXPR(MINUS, "minus", "ee", RTX_BIN_ARITH)
e3c8eb86 434
b5c2f1d1
ZW
435/* Minus operand 0. */
436DEF_RTL_EXPR(NEG, "neg", "e", RTX_UNARY)
fae15c93 437
b5c2f1d1 438DEF_RTL_EXPR(MULT, "mult", "ee", RTX_COMM_ARITH)
dfa849f3 439
b5c2f1d1
ZW
440/* Operand 0 divided by operand 1. */
441DEF_RTL_EXPR(DIV, "div", "ee", RTX_BIN_ARITH)
442/* Remainder of operand 0 divided by operand 1. */
443DEF_RTL_EXPR(MOD, "mod", "ee", RTX_BIN_ARITH)
fae15c93 444
b5c2f1d1
ZW
445/* Unsigned divide and remainder. */
446DEF_RTL_EXPR(UDIV, "udiv", "ee", RTX_BIN_ARITH)
447DEF_RTL_EXPR(UMOD, "umod", "ee", RTX_BIN_ARITH)
fae15c93 448
b5c2f1d1
ZW
449/* Bitwise operations. */
450DEF_RTL_EXPR(AND, "and", "ee", RTX_COMM_ARITH)
b5c2f1d1 451DEF_RTL_EXPR(IOR, "ior", "ee", RTX_COMM_ARITH)
b5c2f1d1 452DEF_RTL_EXPR(XOR, "xor", "ee", RTX_COMM_ARITH)
b5c2f1d1 453DEF_RTL_EXPR(NOT, "not", "e", RTX_UNARY)
fae15c93 454
b5c2f1d1
ZW
455/* Operand:
456 0: value to be shifted.
457 1: number of bits. */
458DEF_RTL_EXPR(ASHIFT, "ashift", "ee", RTX_BIN_ARITH) /* shift left */
459DEF_RTL_EXPR(ROTATE, "rotate", "ee", RTX_BIN_ARITH) /* rotate left */
460DEF_RTL_EXPR(ASHIFTRT, "ashiftrt", "ee", RTX_BIN_ARITH) /* arithmetic shift right */
461DEF_RTL_EXPR(LSHIFTRT, "lshiftrt", "ee", RTX_BIN_ARITH) /* logical shift right */
462DEF_RTL_EXPR(ROTATERT, "rotatert", "ee", RTX_BIN_ARITH) /* rotate right */
fae15c93 463
b5c2f1d1
ZW
464/* Minimum and maximum values of two operands. We need both signed and
465 unsigned forms. (We cannot use MIN for SMIN because it conflicts
7ae4d8d4
RH
466 with a macro of the same name.) The signed variants should be used
467 with floating point. Further, if both operands are zeros, or if either
468 operand is NaN, then it is unspecified which of the two operands is
469 returned as the result. */
fae15c93 470
b5c2f1d1
ZW
471DEF_RTL_EXPR(SMIN, "smin", "ee", RTX_COMM_ARITH)
472DEF_RTL_EXPR(SMAX, "smax", "ee", RTX_COMM_ARITH)
473DEF_RTL_EXPR(UMIN, "umin", "ee", RTX_COMM_ARITH)
474DEF_RTL_EXPR(UMAX, "umax", "ee", RTX_COMM_ARITH)
fae15c93 475
b5c2f1d1
ZW
476/* These unary operations are used to represent incrementation
477 and decrementation as they occur in memory addresses.
478 The amount of increment or decrement are not represented
479 because they can be understood from the machine-mode of the
480 containing MEM. These operations exist in only two cases:
481 1. pushes onto the stack.
482 2. created automatically by the life_analysis pass in flow.c. */
483DEF_RTL_EXPR(PRE_DEC, "pre_dec", "e", RTX_AUTOINC)
484DEF_RTL_EXPR(PRE_INC, "pre_inc", "e", RTX_AUTOINC)
485DEF_RTL_EXPR(POST_DEC, "post_dec", "e", RTX_AUTOINC)
486DEF_RTL_EXPR(POST_INC, "post_inc", "e", RTX_AUTOINC)
fae15c93 487
b5c2f1d1
ZW
488/* These binary operations are used to represent generic address
489 side-effects in memory addresses, except for simple incrementation
490 or decrementation which use the above operations. They are
491 created automatically by the life_analysis pass in flow.c.
492 The first operand is a REG which is used as the address.
493 The second operand is an expression that is assigned to the
494 register, either before (PRE_MODIFY) or after (POST_MODIFY)
495 evaluating the address.
496 Currently, the compiler can only handle second operands of the
497 form (plus (reg) (reg)) and (plus (reg) (const_int)), where
498 the first operand of the PLUS has to be the same register as
499 the first operand of the *_MODIFY. */
500DEF_RTL_EXPR(PRE_MODIFY, "pre_modify", "ee", RTX_AUTOINC)
501DEF_RTL_EXPR(POST_MODIFY, "post_modify", "ee", RTX_AUTOINC)
fae15c93 502
b5c2f1d1
ZW
503/* Comparison operations. The ordered comparisons exist in two
504 flavors, signed and unsigned. */
505DEF_RTL_EXPR(NE, "ne", "ee", RTX_COMM_COMPARE)
506DEF_RTL_EXPR(EQ, "eq", "ee", RTX_COMM_COMPARE)
507DEF_RTL_EXPR(GE, "ge", "ee", RTX_COMPARE)
508DEF_RTL_EXPR(GT, "gt", "ee", RTX_COMPARE)
509DEF_RTL_EXPR(LE, "le", "ee", RTX_COMPARE)
510DEF_RTL_EXPR(LT, "lt", "ee", RTX_COMPARE)
511DEF_RTL_EXPR(GEU, "geu", "ee", RTX_COMPARE)
512DEF_RTL_EXPR(GTU, "gtu", "ee", RTX_COMPARE)
513DEF_RTL_EXPR(LEU, "leu", "ee", RTX_COMPARE)
514DEF_RTL_EXPR(LTU, "ltu", "ee", RTX_COMPARE)
fae15c93 515
b5c2f1d1
ZW
516/* Additional floating point unordered comparison flavors. */
517DEF_RTL_EXPR(UNORDERED, "unordered", "ee", RTX_COMM_COMPARE)
518DEF_RTL_EXPR(ORDERED, "ordered", "ee", RTX_COMM_COMPARE)
fae15c93 519
b5c2f1d1
ZW
520/* These are equivalent to unordered or ... */
521DEF_RTL_EXPR(UNEQ, "uneq", "ee", RTX_COMM_COMPARE)
522DEF_RTL_EXPR(UNGE, "unge", "ee", RTX_COMPARE)
523DEF_RTL_EXPR(UNGT, "ungt", "ee", RTX_COMPARE)
524DEF_RTL_EXPR(UNLE, "unle", "ee", RTX_COMPARE)
525DEF_RTL_EXPR(UNLT, "unlt", "ee", RTX_COMPARE)
fae15c93 526
b5c2f1d1
ZW
527/* This is an ordered NE, ie !UNEQ, ie false for NaN. */
528DEF_RTL_EXPR(LTGT, "ltgt", "ee", RTX_COMM_COMPARE)
fae15c93 529
b5c2f1d1
ZW
530/* Represents the result of sign-extending the sole operand.
531 The machine modes of the operand and of the SIGN_EXTEND expression
532 determine how much sign-extension is going on. */
533DEF_RTL_EXPR(SIGN_EXTEND, "sign_extend", "e", RTX_UNARY)
1af1688b 534
b5c2f1d1
ZW
535/* Similar for zero-extension (such as unsigned short to int). */
536DEF_RTL_EXPR(ZERO_EXTEND, "zero_extend", "e", RTX_UNARY)
1af1688b 537
b5c2f1d1
ZW
538/* Similar but here the operand has a wider mode. */
539DEF_RTL_EXPR(TRUNCATE, "truncate", "e", RTX_UNARY)
1af1688b 540
b5c2f1d1
ZW
541/* Similar for extending floating-point values (such as SFmode to DFmode). */
542DEF_RTL_EXPR(FLOAT_EXTEND, "float_extend", "e", RTX_UNARY)
543DEF_RTL_EXPR(FLOAT_TRUNCATE, "float_truncate", "e", RTX_UNARY)
1af1688b 544
b5c2f1d1
ZW
545/* Conversion of fixed point operand to floating point value. */
546DEF_RTL_EXPR(FLOAT, "float", "e", RTX_UNARY)
1af1688b 547
b5c2f1d1
ZW
548/* With fixed-point machine mode:
549 Conversion of floating point operand to fixed point value.
550 Value is defined only when the operand's value is an integer.
551 With floating-point machine mode (and operand with same mode):
552 Operand is rounded toward zero to produce an integer value
553 represented in floating point. */
554DEF_RTL_EXPR(FIX, "fix", "e", RTX_UNARY)
1af1688b 555
b5c2f1d1
ZW
556/* Conversion of unsigned fixed point operand to floating point value. */
557DEF_RTL_EXPR(UNSIGNED_FLOAT, "unsigned_float", "e", RTX_UNARY)
1af1688b 558
b5c2f1d1
ZW
559/* With fixed-point machine mode:
560 Conversion of floating point operand to *unsigned* fixed point value.
561 Value is defined only when the operand's value is an integer. */
562DEF_RTL_EXPR(UNSIGNED_FIX, "unsigned_fix", "e", RTX_UNARY)
1af1688b 563
b5c2f1d1
ZW
564/* Absolute value */
565DEF_RTL_EXPR(ABS, "abs", "e", RTX_UNARY)
1af1688b 566
b5c2f1d1
ZW
567/* Square root */
568DEF_RTL_EXPR(SQRT, "sqrt", "e", RTX_UNARY)
8653a1ed 569
b5c2f1d1
ZW
570/* Find first bit that is set.
571 Value is 1 + number of trailing zeros in the arg.,
572 or 0 if arg is 0. */
573DEF_RTL_EXPR(FFS, "ffs", "e", RTX_UNARY)
417a6986 574
b5c2f1d1
ZW
575/* Count leading zeros. */
576DEF_RTL_EXPR(CLZ, "clz", "e", RTX_UNARY)
417a6986 577
b5c2f1d1
ZW
578/* Count trailing zeros. */
579DEF_RTL_EXPR(CTZ, "ctz", "e", RTX_UNARY)
417a6986 580
b5c2f1d1
ZW
581/* Population count (number of 1 bits). */
582DEF_RTL_EXPR(POPCOUNT, "popcount", "e", RTX_UNARY)
417a6986 583
b5c2f1d1
ZW
584/* Population parity (number of 1 bits modulo 2). */
585DEF_RTL_EXPR(PARITY, "parity", "e", RTX_UNARY)
1af1688b 586
b5c2f1d1
ZW
587/* Reference to a signed bit-field of specified size and position.
588 Operand 0 is the memory unit (usually SImode or QImode) which
589 contains the field's first bit. Operand 1 is the width, in bits.
590 Operand 2 is the number of bits in the memory unit before the
591 first bit of this field.
592 If BITS_BIG_ENDIAN is defined, the first bit is the msb and
593 operand 2 counts from the msb of the memory unit.
594 Otherwise, the first bit is the lsb and operand 2 counts from
46d096a3
SB
595 the lsb of the memory unit.
596 This kind of expression can not appear as an lvalue in RTL. */
b5c2f1d1 597DEF_RTL_EXPR(SIGN_EXTRACT, "sign_extract", "eee", RTX_BITFIELD_OPS)
1af1688b 598
46d096a3
SB
599/* Similar for unsigned bit-field.
600 But note! This kind of expression _can_ appear as an lvalue. */
b5c2f1d1 601DEF_RTL_EXPR(ZERO_EXTRACT, "zero_extract", "eee", RTX_BITFIELD_OPS)
1af1688b 602
b5c2f1d1 603/* For RISC machines. These save memory when splitting insns. */
1af1688b 604
b5c2f1d1
ZW
605/* HIGH are the high-order bits of a constant expression. */
606DEF_RTL_EXPR(HIGH, "high", "e", RTX_CONST_OBJ)
1af1688b 607
b5c2f1d1
ZW
608/* LO_SUM is the sum of a register and the low-order bits
609 of a constant expression. */
610DEF_RTL_EXPR(LO_SUM, "lo_sum", "ee", RTX_OBJ)
1af1688b 611
b5c2f1d1
ZW
612/* Describes a merge operation between two vector values.
613 Operands 0 and 1 are the vectors to be merged, operand 2 is a bitmask
614 that specifies where the parts of the result are taken from. Set bits
615 indicate operand 0, clear bits indicate operand 1. The parts are defined
616 by the mode of the vectors. */
617DEF_RTL_EXPR(VEC_MERGE, "vec_merge", "eee", RTX_TERNARY)
6b29b0e2 618
b5c2f1d1
ZW
619/* Describes an operation that selects parts of a vector.
620 Operands 0 is the source vector, operand 1 is a PARALLEL that contains
621 a CONST_INT for each of the subparts of the result vector, giving the
622 number of the source subpart that should be stored into it. */
623DEF_RTL_EXPR(VEC_SELECT, "vec_select", "ee", RTX_BIN_ARITH)
1af1688b 624
b5c2f1d1
ZW
625/* Describes a vector concat operation. Operands 0 and 1 are the source
626 vectors, the result is a vector that is as long as operands 0 and 1
627 combined and is the concatenation of the two source vectors. */
628DEF_RTL_EXPR(VEC_CONCAT, "vec_concat", "ee", RTX_BIN_ARITH)
1af1688b 629
b5c2f1d1
ZW
630/* Describes an operation that converts a small vector into a larger one by
631 duplicating the input values. The output vector mode must have the same
632 submodes as the input vector mode, and the number of output parts must be
633 an integer multiple of the number of input parts. */
634DEF_RTL_EXPR(VEC_DUPLICATE, "vec_duplicate", "e", RTX_UNARY)
635
636/* Addition with signed saturation */
637DEF_RTL_EXPR(SS_PLUS, "ss_plus", "ee", RTX_COMM_ARITH)
1af1688b 638
b5c2f1d1
ZW
639/* Addition with unsigned saturation */
640DEF_RTL_EXPR(US_PLUS, "us_plus", "ee", RTX_COMM_ARITH)
1fcea2b0 641
b5c2f1d1
ZW
642/* Operand 0 minus operand 1, with signed saturation. */
643DEF_RTL_EXPR(SS_MINUS, "ss_minus", "ee", RTX_BIN_ARITH)
1fcea2b0 644
b5c2f1d1
ZW
645/* Operand 0 minus operand 1, with unsigned saturation. */
646DEF_RTL_EXPR(US_MINUS, "us_minus", "ee", RTX_BIN_ARITH)
1af1688b 647
b5c2f1d1
ZW
648/* Signed saturating truncate. */
649DEF_RTL_EXPR(SS_TRUNCATE, "ss_truncate", "e", RTX_UNARY)
33f7f353 650
b5c2f1d1
ZW
651/* Unsigned saturating truncate. */
652DEF_RTL_EXPR(US_TRUNCATE, "us_truncate", "e", RTX_UNARY)
1af1688b 653
b5c2f1d1
ZW
654/* Information about the variable and its location. */
655DEF_RTL_EXPR(VAR_LOCATION, "var_location", "te", RTX_EXTRA)
21b8482a 656
b5c2f1d1
ZW
657/* All expressions from this point forward appear only in machine
658 descriptions. */
9e995780 659#ifdef GENERATOR_FILE
21b8482a 660
b5c2f1d1
ZW
661/* Include a secondary machine-description file at this point. */
662DEF_RTL_EXPR(INCLUDE, "include", "s", RTX_EXTRA)
1af1688b 663
b5c2f1d1 664/* Pattern-matching operators: */
1af1688b 665
b5c2f1d1
ZW
666/* Use the function named by the second arg (the string)
667 as a predicate; if matched, store the structure that was matched
668 in the operand table at index specified by the first arg (the integer).
669 If the second arg is the null string, the structure is just stored.
1af1688b 670
b5c2f1d1
ZW
671 A third string argument indicates to the register allocator restrictions
672 on where the operand can be allocated.
1af1688b 673
b5c2f1d1
ZW
674 If the target needs no restriction on any instruction this field should
675 be the null string.
1af1688b 676
b5c2f1d1
ZW
677 The string is prepended by:
678 '=' to indicate the operand is only written to.
679 '+' to indicate the operand is both read and written to.
1af1688b 680
b5c2f1d1
ZW
681 Each character in the string represents an allocable class for an operand.
682 'g' indicates the operand can be any valid class.
683 'i' indicates the operand can be immediate (in the instruction) data.
684 'r' indicates the operand can be in a register.
685 'm' indicates the operand can be in memory.
686 'o' a subset of the 'm' class. Those memory addressing modes that
687 can be offset at compile time (have a constant added to them).
1af1688b 688
b5c2f1d1
ZW
689 Other characters indicate target dependent operand classes and
690 are described in each target's machine description.
1af1688b 691
b5c2f1d1
ZW
692 For instructions with more than one operand, sets of classes can be
693 separated by a comma to indicate the appropriate multi-operand constraints.
694 There must be a 1 to 1 correspondence between these sets of classes in
695 all operands for an instruction.
696 */
697DEF_RTL_EXPR(MATCH_OPERAND, "match_operand", "iss", RTX_MATCH)
1af1688b 698
b5c2f1d1
ZW
699/* Match a SCRATCH or a register. When used to generate rtl, a
700 SCRATCH is generated. As for MATCH_OPERAND, the mode specifies
701 the desired mode and the first argument is the operand number.
702 The second argument is the constraint. */
703DEF_RTL_EXPR(MATCH_SCRATCH, "match_scratch", "is", RTX_MATCH)
52a11cbf 704
b5c2f1d1
ZW
705/* Apply a predicate, AND match recursively the operands of the rtx.
706 Operand 0 is the operand-number, as in match_operand.
707 Operand 1 is a predicate to apply (as a string, a function name).
708 Operand 2 is a vector of expressions, each of which must match
709 one subexpression of the rtx this construct is matching. */
710DEF_RTL_EXPR(MATCH_OPERATOR, "match_operator", "isE", RTX_MATCH)
1af1688b 711
b5c2f1d1
ZW
712/* Match a PARALLEL of arbitrary length. The predicate is applied
713 to the PARALLEL and the initial expressions in the PARALLEL are matched.
714 Operand 0 is the operand-number, as in match_operand.
715 Operand 1 is a predicate to apply to the PARALLEL.
716 Operand 2 is a vector of expressions, each of which must match the
717 corresponding element in the PARALLEL. */
718DEF_RTL_EXPR(MATCH_PARALLEL, "match_parallel", "isE", RTX_MATCH)
1af1688b 719
b5c2f1d1
ZW
720/* Match only something equal to what is stored in the operand table
721 at the index specified by the argument. Use with MATCH_OPERAND. */
722DEF_RTL_EXPR(MATCH_DUP, "match_dup", "i", RTX_MATCH)
1af1688b 723
b5c2f1d1
ZW
724/* Match only something equal to what is stored in the operand table
725 at the index specified by the argument. Use with MATCH_OPERATOR. */
726DEF_RTL_EXPR(MATCH_OP_DUP, "match_op_dup", "iE", RTX_MATCH)
69ef87e2 727
b5c2f1d1
ZW
728/* Match only something equal to what is stored in the operand table
729 at the index specified by the argument. Use with MATCH_PARALLEL. */
730DEF_RTL_EXPR(MATCH_PAR_DUP, "match_par_dup", "iE", RTX_MATCH)
1af1688b 731
b5c2f1d1
ZW
732/* Appears only in define_predicate/define_special_predicate
733 expressions. Evaluates true only if the operand has an RTX code
6e7a4706
ZW
734 from the set given by the argument (a comma-separated list). If the
735 second argument is present and nonempty, it is a sequence of digits
736 and/or letters which indicates the subexpression to test, using the
737 same syntax as genextract/genrecog's location strings: 0-9 for
738 XEXP (op, n), a-z for XVECEXP (op, 0, n); each character applies to
739 the result of the one before it. */
740DEF_RTL_EXPR(MATCH_CODE, "match_code", "ss", RTX_MATCH)
1af1688b 741
b5c2f1d1
ZW
742/* Appears only in define_predicate/define_special_predicate
743 expressions. The argument is a C expression to be injected at this
744 point in the predicate formula. */
745DEF_RTL_EXPR(MATCH_TEST, "match_test", "s", RTX_MATCH)
c5c76735 746
b5c2f1d1 747/* Insn (and related) definitions. */
1af1688b 748
b5c2f1d1
ZW
749/* Definition of the pattern for one kind of instruction.
750 Operand:
751 0: names this instruction.
752 If the name is the null string, the instruction is in the
753 machine description just to be recognized, and will never be emitted by
754 the tree to rtl expander.
755 1: is the pattern.
756 2: is a string which is a C expression
757 giving an additional condition for recognizing this pattern.
758 A null string means no extra condition.
759 3: is the action to execute if this pattern is matched.
760 If this assembler code template starts with a * then it is a fragment of
761 C code to run to decide on a template to use. Otherwise, it is the
762 template to use.
763 4: optionally, a vector of attributes for this insn.
764 */
765DEF_RTL_EXPR(DEFINE_INSN, "define_insn", "sEsTV", RTX_EXTRA)
eab5c70a 766
b5c2f1d1
ZW
767/* Definition of a peephole optimization.
768 1st operand: vector of insn patterns to match
769 2nd operand: C expression that must be true
770 3rd operand: template or C code to produce assembler output.
771 4: optionally, a vector of attributes for this insn.
1af1688b 772
b5c2f1d1
ZW
773 This form is deprecated; use define_peephole2 instead. */
774DEF_RTL_EXPR(DEFINE_PEEPHOLE, "define_peephole", "EsTV", RTX_EXTRA)
1af1688b 775
b5c2f1d1
ZW
776/* Definition of a split operation.
777 1st operand: insn pattern to match
778 2nd operand: C expression that must be true
779 3rd operand: vector of insn patterns to place into a SEQUENCE
780 4th operand: optionally, some C code to execute before generating the
781 insns. This might, for example, create some RTX's and store them in
782 elements of `recog_data.operand' for use by the vector of
783 insn-patterns.
784 (`operands' is an alias here for `recog_data.operand'). */
785DEF_RTL_EXPR(DEFINE_SPLIT, "define_split", "EsES", RTX_EXTRA)
786
787/* Definition of an insn and associated split.
788 This is the concatenation, with a few modifications, of a define_insn
789 and a define_split which share the same pattern.
790 Operand:
791 0: names this instruction.
792 If the name is the null string, the instruction is in the
793 machine description just to be recognized, and will never be emitted by
794 the tree to rtl expander.
795 1: is the pattern.
796 2: is a string which is a C expression
797 giving an additional condition for recognizing this pattern.
798 A null string means no extra condition.
799 3: is the action to execute if this pattern is matched.
800 If this assembler code template starts with a * then it is a fragment of
801 C code to run to decide on a template to use. Otherwise, it is the
802 template to use.
803 4: C expression that must be true for split. This may start with "&&"
804 in which case the split condition is the logical and of the insn
805 condition and what follows the "&&" of this operand.
806 5: vector of insn patterns to place into a SEQUENCE
807 6: optionally, some C code to execute before generating the
808 insns. This might, for example, create some RTX's and store them in
809 elements of `recog_data.operand' for use by the vector of
810 insn-patterns.
811 (`operands' is an alias here for `recog_data.operand').
812 7: optionally, a vector of attributes for this insn. */
813DEF_RTL_EXPR(DEFINE_INSN_AND_SPLIT, "define_insn_and_split", "sEsTsESV", RTX_EXTRA)
814
815/* Definition of an RTL peephole operation.
816 Follows the same arguments as define_split. */
817DEF_RTL_EXPR(DEFINE_PEEPHOLE2, "define_peephole2", "EsES", RTX_EXTRA)
818
819/* Define how to generate multiple insns for a standard insn name.
820 1st operand: the insn name.
821 2nd operand: vector of insn-patterns.
822 Use match_operand to substitute an element of `recog_data.operand'.
823 3rd operand: C expression that must be true for this to be available.
824 This may not test any operands.
825 4th operand: Extra C code to execute before generating the insns.
826 This might, for example, create some RTX's and store them in
827 elements of `recog_data.operand' for use by the vector of
828 insn-patterns.
829 (`operands' is an alias here for `recog_data.operand'). */
830DEF_RTL_EXPR(DEFINE_EXPAND, "define_expand", "sEss", RTX_EXTRA)
831
832/* Define a requirement for delay slots.
833 1st operand: Condition involving insn attributes that, if true,
834 indicates that the insn requires the number of delay slots
835 shown.
836 2nd operand: Vector whose length is the three times the number of delay
837 slots required.
838 Each entry gives three conditions, each involving attributes.
839 The first must be true for an insn to occupy that delay slot
840 location. The second is true for all insns that can be
841 annulled if the branch is true and the third is true for all
842 insns that can be annulled if the branch is false.
1af1688b 843
b5c2f1d1
ZW
844 Multiple DEFINE_DELAYs may be present. They indicate differing
845 requirements for delay slots. */
846DEF_RTL_EXPR(DEFINE_DELAY, "define_delay", "eE", RTX_EXTRA)
1af1688b 847
b5c2f1d1
ZW
848/* Define attribute computation for `asm' instructions. */
849DEF_RTL_EXPR(DEFINE_ASM_ATTRIBUTES, "define_asm_attributes", "V", RTX_EXTRA)
1af1688b 850
b5c2f1d1
ZW
851/* Definition of a conditional execution meta operation. Automatically
852 generates new instances of DEFINE_INSN, selected by having attribute
853 "predicable" true. The new pattern will contain a COND_EXEC and the
854 predicate at top-level.
1af1688b 855
b5c2f1d1
ZW
856 Operand:
857 0: The predicate pattern. The top-level form should match a
858 relational operator. Operands should have only one alternative.
859 1: A C expression giving an additional condition for recognizing
860 the generated pattern.
861 2: A template or C code to produce assembler output. */
862DEF_RTL_EXPR(DEFINE_COND_EXEC, "define_cond_exec", "Ess", RTX_EXTRA)
1af1688b 863
b5c2f1d1
ZW
864/* Definition of an operand predicate. The difference between
865 DEFINE_PREDICATE and DEFINE_SPECIAL_PREDICATE is that genrecog will
866 not warn about a match_operand with no mode if it has a predicate
867 defined with DEFINE_SPECIAL_PREDICATE.
ea8fbf8a 868
b5c2f1d1
ZW
869 Operand:
870 0: The name of the predicate.
871 1: A boolean expression which computes whether or not the predicate
872 matches. This expression can use IOR, AND, NOT, MATCH_OPERAND,
873 MATCH_CODE, and MATCH_TEST. It must be specific enough that genrecog
874 can calculate the set of RTX codes that can possibly match.
875 2: A C function body which must return true for the predicate to match.
876 Optional. Use this when the test is too complicated to fit into a
877 match_test expression. */
878DEF_RTL_EXPR(DEFINE_PREDICATE, "define_predicate", "ses", RTX_EXTRA)
879DEF_RTL_EXPR(DEFINE_SPECIAL_PREDICATE, "define_special_predicate", "ses", RTX_EXTRA)
1af1688b 880
f38840db
ZW
881/* Definition of a register operand constraint. This simply maps the
882 constraint string to a register class.
883
884 Operand:
885 0: The name of the constraint (often, but not always, a single letter).
886 1: A C expression which evaluates to the appropriate register class for
887 this constraint. If this is not just a constant, it should look only
888 at -m switches and the like.
889 2: A docstring for this constraint, in Texinfo syntax; not currently
890 used, in future will be incorporated into the manual's list of
891 machine-specific operand constraints. */
892DEF_RTL_EXPR(DEFINE_REGISTER_CONSTRAINT, "define_register_constraint", "sss", RTX_EXTRA)
893
894/* Definition of a non-register operand constraint. These look at the
895 operand and decide whether it fits the constraint.
896
897 DEFINE_CONSTRAINT gets no special treatment if it fails to match.
898 It is appropriate for constant-only constraints, and most others.
899
900 DEFINE_MEMORY_CONSTRAINT tells reload that this constraint can be made
901 to match, if it doesn't already, by converting the operand to the form
902 (mem (reg X)) where X is a base register. It is suitable for constraints
903 that describe a subset of all memory references.
904
905 DEFINE_ADDRESS_CONSTRAINT tells reload that this constraint can be made
906 to match, if it doesn't already, by converting the operand to the form
907 (reg X) where X is a base register. It is suitable for constraints that
908 describe a subset of all address references.
909
910 When in doubt, use plain DEFINE_CONSTRAINT.
911
912 Operand:
913 0: The name of the constraint (often, but not always, a single letter).
914 1: A docstring for this constraint, in Texinfo syntax; not currently
915 used, in future will be incorporated into the manual's list of
916 machine-specific operand constraints.
917 2: A boolean expression which computes whether or not the constraint
918 matches. It should follow the same rules as a define_predicate
919 expression, including the bit about specifying the set of RTX codes
920 that could possibly match. MATCH_TEST subexpressions may make use of
921 these variables:
922 `op' - the RTL object defining the operand.
923 `mode' - the mode of `op'.
924 `ival' - INTVAL(op), if op is a CONST_INT.
925 `hval' - CONST_DOUBLE_HIGH(op), if op is an integer CONST_DOUBLE.
926 `lval' - CONST_DOUBLE_LOW(op), if op is an integer CONST_DOUBLE.
927 `rval' - CONST_DOUBLE_REAL_VALUE(op), if op is a floating-point
928 CONST_DOUBLE.
929 Do not use ival/hval/lval/rval if op is not the appropriate kind of
930 RTL object. */
931DEF_RTL_EXPR(DEFINE_CONSTRAINT, "define_constraint", "sse", RTX_EXTRA)
932DEF_RTL_EXPR(DEFINE_MEMORY_CONSTRAINT, "define_memory_constraint", "sse", RTX_EXTRA)
933DEF_RTL_EXPR(DEFINE_ADDRESS_CONSTRAINT, "define_address_constraint", "sse", RTX_EXTRA)
934
935
b5c2f1d1 936/* Constructions for CPU pipeline description described by NDFAs. */
1af1688b 937
b5c2f1d1
ZW
938/* (define_cpu_unit string [string]) describes cpu functional
939 units (separated by comma).
1af1688b 940
b5c2f1d1
ZW
941 1st operand: Names of cpu functional units.
942 2nd operand: Name of automaton (see comments for DEFINE_AUTOMATON).
1af1688b 943
b5c2f1d1
ZW
944 All define_reservations, define_cpu_units, and
945 define_query_cpu_units should have unique names which may not be
946 "nothing". */
947DEF_RTL_EXPR(DEFINE_CPU_UNIT, "define_cpu_unit", "sS", RTX_EXTRA)
1af1688b 948
b5c2f1d1
ZW
949/* (define_query_cpu_unit string [string]) describes cpu functional
950 units analogously to define_cpu_unit. The reservation of such
951 units can be queried for automaton state. */
952DEF_RTL_EXPR(DEFINE_QUERY_CPU_UNIT, "define_query_cpu_unit", "sS", RTX_EXTRA)
1af1688b 953
b5c2f1d1
ZW
954/* (exclusion_set string string) means that each CPU functional unit
955 in the first string can not be reserved simultaneously with any
956 unit whose name is in the second string and vise versa. CPU units
957 in the string are separated by commas. For example, it is useful
958 for description CPU with fully pipelined floating point functional
959 unit which can execute simultaneously only single floating point
960 insns or only double floating point insns. All CPU functional
961 units in a set should belong to the same automaton. */
962DEF_RTL_EXPR(EXCLUSION_SET, "exclusion_set", "ss", RTX_EXTRA)
1af1688b 963
b5c2f1d1
ZW
964/* (presence_set string string) means that each CPU functional unit in
965 the first string can not be reserved unless at least one of pattern
966 of units whose names are in the second string is reserved. This is
967 an asymmetric relation. CPU units or unit patterns in the strings
968 are separated by commas. Pattern is one unit name or unit names
969 separated by white-spaces.
970
971 For example, it is useful for description that slot1 is reserved
972 after slot0 reservation for a VLIW processor. We could describe it
973 by the following construction
1af1688b 974
b5c2f1d1 975 (presence_set "slot1" "slot0")
1af1688b 976
b5c2f1d1
ZW
977 Or slot1 is reserved only after slot0 and unit b0 reservation. In
978 this case we could write
1af1688b 979
b5c2f1d1 980 (presence_set "slot1" "slot0 b0")
1af1688b 981
b5c2f1d1
ZW
982 All CPU functional units in a set should belong to the same
983 automaton. */
984DEF_RTL_EXPR(PRESENCE_SET, "presence_set", "ss", RTX_EXTRA)
1af1688b 985
b5c2f1d1
ZW
986/* (final_presence_set string string) is analogous to `presence_set'.
987 The difference between them is when checking is done. When an
988 instruction is issued in given automaton state reflecting all
989 current and planned unit reservations, the automaton state is
990 changed. The first state is a source state, the second one is a
991 result state. Checking for `presence_set' is done on the source
992 state reservation, checking for `final_presence_set' is done on the
993 result reservation. This construction is useful to describe a
994 reservation which is actually two subsequent reservations. For
995 example, if we use
1af1688b 996
b5c2f1d1 997 (presence_set "slot1" "slot0")
1af1688b 998
b5c2f1d1
ZW
999 the following insn will be never issued (because slot1 requires
1000 slot0 which is absent in the source state).
1af1688b 1001
b5c2f1d1 1002 (define_reservation "insn_and_nop" "slot0 + slot1")
1af1688b 1003
b5c2f1d1
ZW
1004 but it can be issued if we use analogous `final_presence_set'. */
1005DEF_RTL_EXPR(FINAL_PRESENCE_SET, "final_presence_set", "ss", RTX_EXTRA)
1af1688b 1006
b5c2f1d1
ZW
1007/* (absence_set string string) means that each CPU functional unit in
1008 the first string can be reserved only if each pattern of units
1009 whose names are in the second string is not reserved. This is an
1010 asymmetric relation (actually exclusion set is analogous to this
1011 one but it is symmetric). CPU units or unit patterns in the string
1012 are separated by commas. Pattern is one unit name or unit names
1013 separated by white-spaces.
1af1688b 1014
b5c2f1d1
ZW
1015 For example, it is useful for description that slot0 can not be
1016 reserved after slot1 or slot2 reservation for a VLIW processor. We
1017 could describe it by the following construction
1af1688b 1018
b5c2f1d1 1019 (absence_set "slot2" "slot0, slot1")
1af1688b 1020
b5c2f1d1
ZW
1021 Or slot2 can not be reserved if slot0 and unit b0 are reserved or
1022 slot1 and unit b1 are reserved . In this case we could write
1af1688b 1023
b5c2f1d1 1024 (absence_set "slot2" "slot0 b0, slot1 b1")
1af1688b 1025
b5c2f1d1
ZW
1026 All CPU functional units in a set should to belong the same
1027 automaton. */
1028DEF_RTL_EXPR(ABSENCE_SET, "absence_set", "ss", RTX_EXTRA)
1af1688b 1029
b5c2f1d1
ZW
1030/* (final_absence_set string string) is analogous to `absence_set' but
1031 checking is done on the result (state) reservation. See comments
1032 for `final_presence_set'. */
1033DEF_RTL_EXPR(FINAL_ABSENCE_SET, "final_absence_set", "ss", RTX_EXTRA)
b18cfc28 1034
b5c2f1d1
ZW
1035/* (define_bypass number out_insn_names in_insn_names) names bypass
1036 with given latency (the first number) from insns given by the first
1037 string (see define_insn_reservation) into insns given by the second
1038 string. Insn names in the strings are separated by commas. The
1039 third operand is optional name of function which is additional
1040 guard for the bypass. The function will get the two insns as
1041 parameters. If the function returns zero the bypass will be
1042 ignored for this case. Additional guard is necessary to recognize
1043 complicated bypasses, e.g. when consumer is load address. */
1044DEF_RTL_EXPR(DEFINE_BYPASS, "define_bypass", "issS", RTX_EXTRA)
1af1688b 1045
b5c2f1d1
ZW
1046/* (define_automaton string) describes names of automata generated and
1047 used for pipeline hazards recognition. The names are separated by
1048 comma. Actually it is possibly to generate the single automaton
1049 but unfortunately it can be very large. If we use more one
1050 automata, the summary size of the automata usually is less than the
1051 single one. The automaton name is used in define_cpu_unit and
1052 define_query_cpu_unit. All automata should have unique names. */
1053DEF_RTL_EXPR(DEFINE_AUTOMATON, "define_automaton", "s", RTX_EXTRA)
1eb8759b 1054
b5c2f1d1
ZW
1055/* (automata_option string) describes option for generation of
1056 automata. Currently there are the following options:
1eb8759b 1057
b5c2f1d1
ZW
1058 o "no-minimization" which makes no minimization of automata. This
1059 is only worth to do when we are debugging the description and
1060 need to look more accurately at reservations of states.
7913f3d0 1061
b5c2f1d1
ZW
1062 o "time" which means printing additional time statistics about
1063 generation of automata.
1064
1065 o "v" which means generation of file describing the result
1066 automata. The file has suffix `.dfa' and can be used for the
1067 description verification and debugging.
1af1688b 1068
b5c2f1d1
ZW
1069 o "w" which means generation of warning instead of error for
1070 non-critical errors.
1af1688b 1071
b5c2f1d1 1072 o "ndfa" which makes nondeterministic finite state automata.
1af1688b 1073
b5c2f1d1
ZW
1074 o "progress" which means output of a progress bar showing how many
1075 states were generated so far for automaton being processed. */
1076DEF_RTL_EXPR(AUTOMATA_OPTION, "automata_option", "s", RTX_EXTRA)
1af1688b 1077
b5c2f1d1
ZW
1078/* (define_reservation string string) names reservation (the first
1079 string) of cpu functional units (the 2nd string). Sometimes unit
1080 reservations for different insns contain common parts. In such
1081 case, you can describe common part and use its name (the 1st
1082 parameter) in regular expression in define_insn_reservation. All
1083 define_reservations, define_cpu_units, and define_query_cpu_units
1084 should have unique names which may not be "nothing". */
1085DEF_RTL_EXPR(DEFINE_RESERVATION, "define_reservation", "ss", RTX_EXTRA)
1af1688b 1086
b5c2f1d1
ZW
1087/* (define_insn_reservation name default_latency condition regexpr)
1088 describes reservation of cpu functional units (the 3nd operand) for
1089 instruction which is selected by the condition (the 2nd parameter).
1090 The first parameter is used for output of debugging information.
1091 The reservations are described by a regular expression according
1092 the following syntax:
1af1688b 1093
b5c2f1d1
ZW
1094 regexp = regexp "," oneof
1095 | oneof
1af1688b 1096
b5c2f1d1
ZW
1097 oneof = oneof "|" allof
1098 | allof
1af1688b 1099
b5c2f1d1
ZW
1100 allof = allof "+" repeat
1101 | repeat
1102
1103 repeat = element "*" number
1104 | element
1af1688b 1105
b5c2f1d1
ZW
1106 element = cpu_function_unit_name
1107 | reservation_name
1108 | result_name
1109 | "nothing"
1110 | "(" regexp ")"
1af1688b 1111
b5c2f1d1
ZW
1112 1. "," is used for describing start of the next cycle in
1113 reservation.
1af1688b 1114
b5c2f1d1
ZW
1115 2. "|" is used for describing the reservation described by the
1116 first regular expression *or* the reservation described by the
1117 second regular expression *or* etc.
2928cd7a 1118
b5c2f1d1
ZW
1119 3. "+" is used for describing the reservation described by the
1120 first regular expression *and* the reservation described by the
1121 second regular expression *and* etc.
2928cd7a 1122
b5c2f1d1
ZW
1123 4. "*" is used for convenience and simply means sequence in
1124 which the regular expression are repeated NUMBER times with
1125 cycle advancing (see ",").
2928cd7a 1126
b5c2f1d1 1127 5. cpu functional unit name which means its reservation.
2928cd7a 1128
b5c2f1d1 1129 6. reservation name -- see define_reservation.
1af1688b 1130
b5c2f1d1 1131 7. string "nothing" means no units reservation. */
1af1688b 1132
b5c2f1d1 1133DEF_RTL_EXPR(DEFINE_INSN_RESERVATION, "define_insn_reservation", "sies", RTX_EXTRA)
1af1688b 1134
b5c2f1d1 1135/* Expressions used for insn attributes. */
1af1688b 1136
b5c2f1d1
ZW
1137/* Definition of an insn attribute.
1138 1st operand: name of the attribute
1139 2nd operand: comma-separated list of possible attribute values
1140 3rd operand: expression for the default value of the attribute. */
1141DEF_RTL_EXPR(DEFINE_ATTR, "define_attr", "sse", RTX_EXTRA)
1af1688b 1142
b5c2f1d1
ZW
1143/* Marker for the name of an attribute. */
1144DEF_RTL_EXPR(ATTR, "attr", "s", RTX_EXTRA)
0dfa1860 1145
b5c2f1d1
ZW
1146/* For use in the last (optional) operand of DEFINE_INSN or DEFINE_PEEPHOLE and
1147 in DEFINE_ASM_INSN to specify an attribute to assign to insns matching that
1148 pattern.
0dfa1860 1149
b5c2f1d1
ZW
1150 (set_attr "name" "value") is equivalent to
1151 (set (attr "name") (const_string "value")) */
1152DEF_RTL_EXPR(SET_ATTR, "set_attr", "ss", RTX_EXTRA)
0dfa1860 1153
b5c2f1d1
ZW
1154/* In the last operand of DEFINE_INSN and DEFINE_PEEPHOLE, this can be used to
1155 specify that attribute values are to be assigned according to the
1156 alternative matched.
0dfa1860 1157
b5c2f1d1 1158 The following three expressions are equivalent:
f9f27ee5 1159
b5c2f1d1
ZW
1160 (set (attr "att") (cond [(eq_attrq "alternative" "1") (const_string "a1")
1161 (eq_attrq "alternative" "2") (const_string "a2")]
1162 (const_string "a3")))
1163 (set_attr_alternative "att" [(const_string "a1") (const_string "a2")
1164 (const_string "a3")])
1165 (set_attr "att" "a1,a2,a3")
1166 */
1167DEF_RTL_EXPR(SET_ATTR_ALTERNATIVE, "set_attr_alternative", "sE", RTX_EXTRA)
f9f27ee5 1168
b5c2f1d1
ZW
1169/* A conditional expression true if the value of the specified attribute of
1170 the current insn equals the specified value. The first operand is the
1171 attribute name and the second is the comparison value. */
1172DEF_RTL_EXPR(EQ_ATTR, "eq_attr", "ss", RTX_EXTRA)
f9f27ee5 1173
b5c2f1d1
ZW
1174/* A special case of the above representing a set of alternatives. The first
1175 operand is bitmap of the set, the second one is the default value. */
1176DEF_RTL_EXPR(EQ_ATTR_ALT, "eq_attr_alt", "ii", RTX_EXTRA)
f9f27ee5 1177
b5c2f1d1
ZW
1178/* A conditional expression which is true if the specified flag is
1179 true for the insn being scheduled in reorg.
f9f27ee5 1180
b5c2f1d1
ZW
1181 genattr.c defines the following flags which can be tested by
1182 (attr_flag "foo") expressions in eligible_for_delay.
f9f27ee5 1183
b5c2f1d1 1184 forward, backward, very_likely, likely, very_unlikely, and unlikely. */
f9f27ee5 1185
b5c2f1d1 1186DEF_RTL_EXPR (ATTR_FLAG, "attr_flag", "s", RTX_EXTRA)
f9f27ee5 1187
b5c2f1d1
ZW
1188/* General conditional. The first operand is a vector composed of pairs of
1189 expressions. The first element of each pair is evaluated, in turn.
1190 The value of the conditional is the second expression of the first pair
1191 whose first expression evaluates nonzero. If none of the expressions is
1192 true, the second operand will be used as the value of the conditional. */
1193DEF_RTL_EXPR(COND, "cond", "Ee", RTX_EXTRA)
f9f27ee5 1194
9e995780 1195#endif /* GENERATOR_FILE */
d9d4fb43 1196
1af1688b
RK
1197/*
1198Local variables:
1199mode:c
1af1688b
RK
1200End:
1201*/
This page took 3.305894 seconds and 5 git commands to generate.