1 //===- TargetSelectionDAG.td - Common code for DAG isels ---*- tablegen -*-===//
3 // The LLVM Compiler Infrastructure
5 // This file was developed by the LLVM research group and is distributed under
6 // the University of Illinois Open Source License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This file defines the target-independent interfaces used by SelectionDAG
11 // instruction selection generators.
13 //===----------------------------------------------------------------------===//
15 //===----------------------------------------------------------------------===//
16 // Selection DAG Type Constraint definitions.
18 // Note that the semantics of these constraints are hard coded into tblgen. To
19 // modify or add constraints, you have to hack tblgen.
22 class SDTypeConstraint<int opnum> {
23 int OperandNum = opnum;
26 // SDTCisVT - The specified operand has exactly this VT.
27 class SDTCisVT<int OpNum, ValueType vt> : SDTypeConstraint<OpNum> {
31 class SDTCisPtrTy<int OpNum> : SDTypeConstraint<OpNum>;
33 // SDTCisInt - The specified operand is has integer type.
34 class SDTCisInt<int OpNum> : SDTypeConstraint<OpNum>;
36 // SDTCisFP - The specified operand is has floating point type.
37 class SDTCisFP<int OpNum> : SDTypeConstraint<OpNum>;
39 // SDTCisSameAs - The two specified operands have identical types.
40 class SDTCisSameAs<int OpNum, int OtherOp> : SDTypeConstraint<OpNum> {
41 int OtherOperandNum = OtherOp;
44 // SDTCisVTSmallerThanOp - The specified operand is a VT SDNode, and its type is
45 // smaller than the 'Other' operand.
46 class SDTCisVTSmallerThanOp<int OpNum, int OtherOp> : SDTypeConstraint<OpNum> {
47 int OtherOperandNum = OtherOp;
50 class SDTCisOpSmallerThanOp<int SmallOp, int BigOp> : SDTypeConstraint<SmallOp>{
51 int BigOperandNum = BigOp;
54 //===----------------------------------------------------------------------===//
55 // Selection DAG Type Profile definitions.
57 // These use the constraints defined above to describe the type requirements of
58 // the various nodes. These are not hard coded into tblgen, allowing targets to
59 // add their own if needed.
62 // SDTypeProfile - This profile describes the type requirements of a Selection
64 class SDTypeProfile<int numresults, int numoperands,
65 list<SDTypeConstraint> constraints> {
66 int NumResults = numresults;
67 int NumOperands = numoperands;
68 list<SDTypeConstraint> Constraints = constraints;
72 def SDTIntLeaf: SDTypeProfile<1, 0, [SDTCisInt<0>]>; // for 'imm'.
73 def SDTPtrLeaf: SDTypeProfile<1, 0, [SDTCisPtrTy<0>]>; // for '&g'.
74 def SDTOther : SDTypeProfile<1, 0, [SDTCisVT<0, OtherVT>]>; // for 'vt'.
75 def SDTUNDEF : SDTypeProfile<1, 0, []>; // for 'undef'.
76 def SDTIntBinOp : SDTypeProfile<1, 2, [ // add, and, or, xor, udiv, etc.
77 SDTCisSameAs<0, 1>, SDTCisSameAs<0, 2>, SDTCisInt<0>
79 def SDTIntShiftOp : SDTypeProfile<1, 2, [ // shl, sra, srl
80 SDTCisSameAs<0, 1>, SDTCisInt<0>, SDTCisInt<2>
82 def SDTFPBinOp : SDTypeProfile<1, 2, [ // fadd, fmul, etc.
83 SDTCisSameAs<0, 1>, SDTCisSameAs<0, 2>, SDTCisFP<0>
85 def SDTFPTernaryOp : SDTypeProfile<1, 3, [ // fmadd, fnmsub, etc.
86 SDTCisSameAs<0, 1>, SDTCisSameAs<0, 2>, SDTCisSameAs<0, 3>, SDTCisFP<0>
88 def SDTIntUnaryOp : SDTypeProfile<1, 1, [ // ctlz
89 SDTCisSameAs<0, 1>, SDTCisInt<0>
91 def SDTIntExtendOp : SDTypeProfile<1, 1, [ // sext, zext, anyext
92 SDTCisInt<0>, SDTCisInt<1>, SDTCisOpSmallerThanOp<1, 0>
94 def SDTIntTruncOp : SDTypeProfile<1, 1, [ // trunc
95 SDTCisInt<0>, SDTCisInt<1>, SDTCisOpSmallerThanOp<0, 1>
97 def SDTFPUnaryOp : SDTypeProfile<1, 1, [ // fneg, fsqrt, etc
98 SDTCisSameAs<0, 1>, SDTCisFP<0>
100 def SDTFPRoundOp : SDTypeProfile<1, 1, [ // fround
101 SDTCisFP<0>, SDTCisFP<1>, SDTCisOpSmallerThanOp<0, 1>
103 def SDTFPExtendOp : SDTypeProfile<1, 1, [ // fextend
104 SDTCisFP<0>, SDTCisFP<1>, SDTCisOpSmallerThanOp<1, 0>
106 def SDTIntToFPOp : SDTypeProfile<1, 1, [ // [su]int_to_fp
107 SDTCisFP<0>, SDTCisInt<1>
109 def SDTFPToIntOp : SDTypeProfile<1, 1, [ // fp_to_[su]int
110 SDTCisInt<0>, SDTCisFP<1>
112 def SDTExtInreg : SDTypeProfile<1, 2, [ // sext_inreg
113 SDTCisSameAs<0, 1>, SDTCisInt<0>, SDTCisVT<2, OtherVT>,
114 SDTCisVTSmallerThanOp<2, 1>
117 def SDTSetCC : SDTypeProfile<1, 3, [ // setcc
118 SDTCisInt<0>, SDTCisSameAs<1, 2>, SDTCisVT<3, OtherVT>
121 def SDTSelect : SDTypeProfile<1, 3, [ // select
122 SDTCisInt<1>, SDTCisSameAs<0, 2>, SDTCisSameAs<2, 3>
125 def SDTSelectCC : SDTypeProfile<1, 5, [ // select_cc
126 SDTCisSameAs<1, 2>, SDTCisSameAs<3, 4>, SDTCisSameAs<0, 3>,
130 def SDTBr : SDTypeProfile<0, 1, [ // br
134 def SDTRet : SDTypeProfile<0, 0, []>; // ret
136 def SDTReadPort : SDTypeProfile<1, 1, [ // readport
137 SDTCisInt<0>, SDTCisInt<1>
140 def SDTWritePort : SDTypeProfile<0, 2, [ // writeport
141 SDTCisInt<0>, SDTCisInt<1>
144 def SDTLoad : SDTypeProfile<1, 1, [ // load
148 def SDTStore : SDTypeProfile<0, 2, [ // store
152 def SDTExtLoad : SDTypeProfile<1, 3, [ // extload
153 SDTCisPtrTy<1>, SDTCisVT<2, OtherVT>, SDTCisVT<3, OtherVT>
155 def SDTIntExtLoad : SDTypeProfile<1, 3, [ // sextload, zextload
156 SDTCisInt<0>, SDTCisPtrTy<1>, SDTCisVT<2, OtherVT>, SDTCisVT<3, OtherVT>
158 def SDTTruncStore : SDTypeProfile<0, 4, [ // truncstore
159 SDTCisPtrTy<1>, SDTCisVT<2, OtherVT>, SDTCisVT<3, OtherVT>
163 //===----------------------------------------------------------------------===//
164 // Selection DAG Node Properties.
166 // Note: These are hard coded into tblgen.
168 class SDNodeProperty;
169 def SDNPCommutative : SDNodeProperty; // X op Y == Y op X
170 def SDNPAssociative : SDNodeProperty; // (X op Y) op Z == X op (Y op Z)
171 def SDNPHasChain : SDNodeProperty; // R/W chain operand and result
173 //===----------------------------------------------------------------------===//
174 // Selection DAG Node definitions.
176 class SDNode<string opcode, SDTypeProfile typeprof,
177 list<SDNodeProperty> props = [], string sdclass = "SDNode"> {
178 string Opcode = opcode;
179 string SDClass = sdclass;
180 list<SDNodeProperty> Properties = props;
181 SDTypeProfile TypeProfile = typeprof;
188 def imm : SDNode<"ISD::Constant" , SDTIntLeaf , [], "ConstantSDNode">;
189 def vt : SDNode<"ISD::VALUETYPE" , SDTOther , [], "VTSDNode">;
190 def bb : SDNode<"ISD::BasicBlock", SDTOther , [], "BasicBlockSDNode">;
191 def cond : SDNode<"ISD::CONDCODE" , SDTOther , [], "CondCodeSDNode">;
192 def undef : SDNode<"ISD::UNDEF" , SDTUNDEF , []>;
193 def globaladdr : SDNode<"ISD::GlobalAddress", SDTPtrLeaf, [],
194 "GlobalAddressSDNode">;
195 def tglobaladdr: SDNode<"ISD::TargetGlobalAddress", SDTPtrLeaf, [],
196 "GlobalAddressSDNode">;
197 def constpool : SDNode<"ISD::ConstantPool", SDTPtrLeaf, [],
198 "ConstantPoolSDNode">;
199 def tconstpool : SDNode<"ISD::TargetConstantPool", SDTPtrLeaf, [],
200 "ConstantPoolSDNode">;
201 def frameindex : SDNode<"ISD::FrameIndex", SDTPtrLeaf, [],
203 def tframeindex: SDNode<"ISD::TargetFrameIndex", SDTPtrLeaf, [],
205 def externalsym: SDNode<"ISD::ExternalSymbol", SDTPtrLeaf, [],
206 "ExternalSymbolSDNode">;
207 def add : SDNode<"ISD::ADD" , SDTIntBinOp ,
208 [SDNPCommutative, SDNPAssociative]>;
209 def sub : SDNode<"ISD::SUB" , SDTIntBinOp>;
210 def mul : SDNode<"ISD::MUL" , SDTIntBinOp,
211 [SDNPCommutative, SDNPAssociative]>;
212 def mulhs : SDNode<"ISD::MULHS" , SDTIntBinOp, [SDNPCommutative]>;
213 def mulhu : SDNode<"ISD::MULHU" , SDTIntBinOp, [SDNPCommutative]>;
214 def sdiv : SDNode<"ISD::SDIV" , SDTIntBinOp>;
215 def udiv : SDNode<"ISD::UDIV" , SDTIntBinOp>;
216 def srem : SDNode<"ISD::SREM" , SDTIntBinOp>;
217 def urem : SDNode<"ISD::UREM" , SDTIntBinOp>;
218 def srl : SDNode<"ISD::SRL" , SDTIntShiftOp>;
219 def sra : SDNode<"ISD::SRA" , SDTIntShiftOp>;
220 def shl : SDNode<"ISD::SHL" , SDTIntShiftOp>;
221 def and : SDNode<"ISD::AND" , SDTIntBinOp,
222 [SDNPCommutative, SDNPAssociative]>;
223 def or : SDNode<"ISD::OR" , SDTIntBinOp,
224 [SDNPCommutative, SDNPAssociative]>;
225 def xor : SDNode<"ISD::XOR" , SDTIntBinOp,
226 [SDNPCommutative, SDNPAssociative]>;
228 def sext_inreg : SDNode<"ISD::SIGN_EXTEND_INREG", SDTExtInreg>;
229 def ctlz : SDNode<"ISD::CTLZ" , SDTIntUnaryOp>;
230 def cttz : SDNode<"ISD::CTTZ" , SDTIntUnaryOp>;
231 def ctpop : SDNode<"ISD::CTPOP" , SDTIntUnaryOp>;
232 def sext : SDNode<"ISD::SIGN_EXTEND", SDTIntExtendOp>;
233 def zext : SDNode<"ISD::ZERO_EXTEND", SDTIntExtendOp>;
234 def anyext : SDNode<"ISD::ANY_EXTEND" , SDTIntExtendOp>;
235 def trunc : SDNode<"ISD::TRUNCATE" , SDTIntTruncOp>;
237 def fadd : SDNode<"ISD::FADD" , SDTFPBinOp, [SDNPCommutative]>;
238 def fsub : SDNode<"ISD::FSUB" , SDTFPBinOp>;
239 def fmul : SDNode<"ISD::FMUL" , SDTFPBinOp, [SDNPCommutative]>;
240 def fdiv : SDNode<"ISD::FDIV" , SDTFPBinOp>;
241 def frem : SDNode<"ISD::FREM" , SDTFPBinOp>;
242 def fabs : SDNode<"ISD::FABS" , SDTFPUnaryOp>;
243 def fneg : SDNode<"ISD::FNEG" , SDTFPUnaryOp>;
244 def fsqrt : SDNode<"ISD::FSQRT" , SDTFPUnaryOp>;
245 def fsin : SDNode<"ISD::FSIN" , SDTFPUnaryOp>;
246 def fcos : SDNode<"ISD::FCOS" , SDTFPUnaryOp>;
248 def fround : SDNode<"ISD::FP_ROUND" , SDTFPRoundOp>;
249 def fextend : SDNode<"ISD::FP_EXTEND" , SDTFPExtendOp>;
251 def sint_to_fp : SDNode<"ISD::SINT_TO_FP" , SDTIntToFPOp>;
252 def uint_to_fp : SDNode<"ISD::UINT_TO_FP" , SDTIntToFPOp>;
253 def fp_to_sint : SDNode<"ISD::FP_TO_SINT" , SDTFPToIntOp>;
254 def fp_to_uint : SDNode<"ISD::FP_TO_UINT" , SDTFPToIntOp>;
256 def setcc : SDNode<"ISD::SETCC" , SDTSetCC>;
257 def select : SDNode<"ISD::SELECT" , SDTSelect>;
258 def selectcc : SDNode<"ISD::SELECT_CC" , SDTSelectCC>;
260 def br : SDNode<"ISD::BR" , SDTBr, [SDNPHasChain]>;
261 def ret : SDNode<"ISD::RET" , SDTRet, [SDNPHasChain]>;
263 def readport : SDNode<"ISD::READPORT" , SDTReadPort, [SDNPHasChain]>;
264 def writeport : SDNode<"ISD::WRITEPORT" , SDTWritePort, [SDNPHasChain]>;
266 def load : SDNode<"ISD::LOAD" , SDTLoad, [SDNPHasChain]>;
267 def store : SDNode<"ISD::STORE" , SDTStore, [SDNPHasChain]>;
269 // Do not use sextld and zextld directly. Use sextload and zextload (see
270 // below) which pass in a dummy srcvalue node which tblgen will skip over.
271 def sextld : SDNode<"ISD::SEXTLOAD" , SDTIntExtLoad, [SDNPHasChain]>;
272 def zextld : SDNode<"ISD::ZEXTLOAD" , SDTIntExtLoad, [SDNPHasChain]>;
273 def extld : SDNode<"ISD::EXTLOAD" , SDTExtLoad, [SDNPHasChain]>;
274 def truncst : SDNode<"ISD::TRUNCSTORE" , SDTTruncStore, [SDNPHasChain]>;
276 //===----------------------------------------------------------------------===//
277 // Selection DAG Condition Codes
279 class CondCode; // ISD::CondCode enums
280 def SETOEQ : CondCode; def SETOGT : CondCode;
281 def SETOGE : CondCode; def SETOLT : CondCode; def SETOLE : CondCode;
282 def SETONE : CondCode; def SETO : CondCode; def SETUO : CondCode;
283 def SETUEQ : CondCode; def SETUGT : CondCode; def SETUGE : CondCode;
284 def SETULT : CondCode; def SETULE : CondCode; def SETUNE : CondCode;
286 def SETEQ : CondCode; def SETGT : CondCode; def SETGE : CondCode;
287 def SETLT : CondCode; def SETLE : CondCode; def SETNE : CondCode;
290 //===----------------------------------------------------------------------===//
291 // Selection DAG Node Transformation Functions.
293 // This mechanism allows targets to manipulate nodes in the output DAG once a
294 // match has been formed. This is typically used to manipulate immediate
297 class SDNodeXForm<SDNode opc, code xformFunction> {
299 code XFormFunction = xformFunction;
302 def NOOP_SDNodeXForm : SDNodeXForm<imm, [{}]>;
305 //===----------------------------------------------------------------------===//
306 // Selection DAG Pattern Fragments.
308 // Pattern fragments are reusable chunks of dags that match specific things.
309 // They can take arguments and have C++ predicates that control whether they
310 // match. They are intended to make the patterns for common instructions more
311 // compact and readable.
314 /// PatFrag - Represents a pattern fragment. This can match something on the
315 /// DAG, frame a single node to multiply nested other fragments.
317 class PatFrag<dag ops, dag frag, code pred = [{}],
318 SDNodeXForm xform = NOOP_SDNodeXForm> {
321 code Predicate = pred;
322 SDNodeXForm OperandTransform = xform;
325 // PatLeaf's are pattern fragments that have no operands. This is just a helper
326 // to define immediates and other common things concisely.
327 class PatLeaf<dag frag, code pred = [{}], SDNodeXForm xform = NOOP_SDNodeXForm>
328 : PatFrag<(ops), frag, pred, xform>;
332 def immAllOnes : PatLeaf<(imm), [{ return N->isAllOnesValue(); }]>;
334 def vtInt : PatLeaf<(vt), [{ return MVT::isInteger(N->getVT()); }]>;
335 def vtFP : PatLeaf<(vt), [{ return MVT::isFloatingPoint(N->getVT()); }]>;
337 // Other helper fragments.
339 def not : PatFrag<(ops node:$in), (xor node:$in, immAllOnes)>;
340 def ineg : PatFrag<(ops node:$in), (sub 0, node:$in)>;
342 // extending load & truncstore fragments.
343 def sextload : PatFrag<(ops node:$ptr, node:$vt),
344 (sextld node:$ptr, srcvalue:$dummy, node:$vt)>;
345 def zextload : PatFrag<(ops node:$ptr, node:$vt),
346 (zextld node:$ptr, srcvalue:$dummy, node:$vt)>;
347 def extload : PatFrag<(ops node:$ptr, node:$vt),
348 (extld node:$ptr, srcvalue:$dummy, node:$vt)>;
349 def truncstore : PatFrag<(ops node:$val, node:$ptr, node:$vt),
350 (truncst node:$val, node:$ptr, srcvalue:$dummy,
353 // setcc convenience fragments.
354 def setoeq : PatFrag<(ops node:$lhs, node:$rhs),
355 (setcc node:$lhs, node:$rhs, SETOEQ)>;
356 def setogt : PatFrag<(ops node:$lhs, node:$rhs),
357 (setcc node:$lhs, node:$rhs, SETOGT)>;
358 def setoge : PatFrag<(ops node:$lhs, node:$rhs),
359 (setcc node:$lhs, node:$rhs, SETOGE)>;
360 def setolt : PatFrag<(ops node:$lhs, node:$rhs),
361 (setcc node:$lhs, node:$rhs, SETOLT)>;
362 def setole : PatFrag<(ops node:$lhs, node:$rhs),
363 (setcc node:$lhs, node:$rhs, SETOLE)>;
364 def setone : PatFrag<(ops node:$lhs, node:$rhs),
365 (setcc node:$lhs, node:$rhs, SETONE)>;
366 def seto : PatFrag<(ops node:$lhs, node:$rhs),
367 (setcc node:$lhs, node:$rhs, SETO)>;
368 def setuo : PatFrag<(ops node:$lhs, node:$rhs),
369 (setcc node:$lhs, node:$rhs, SETUO)>;
370 def setueq : PatFrag<(ops node:$lhs, node:$rhs),
371 (setcc node:$lhs, node:$rhs, SETUEQ)>;
372 def setugt : PatFrag<(ops node:$lhs, node:$rhs),
373 (setcc node:$lhs, node:$rhs, SETUGT)>;
374 def setuge : PatFrag<(ops node:$lhs, node:$rhs),
375 (setcc node:$lhs, node:$rhs, SETUGE)>;
376 def setult : PatFrag<(ops node:$lhs, node:$rhs),
377 (setcc node:$lhs, node:$rhs, SETULT)>;
378 def setule : PatFrag<(ops node:$lhs, node:$rhs),
379 (setcc node:$lhs, node:$rhs, SETULE)>;
380 def setune : PatFrag<(ops node:$lhs, node:$rhs),
381 (setcc node:$lhs, node:$rhs, SETUNE)>;
382 def seteq : PatFrag<(ops node:$lhs, node:$rhs),
383 (setcc node:$lhs, node:$rhs, SETEQ)>;
384 def setgt : PatFrag<(ops node:$lhs, node:$rhs),
385 (setcc node:$lhs, node:$rhs, SETGT)>;
386 def setge : PatFrag<(ops node:$lhs, node:$rhs),
387 (setcc node:$lhs, node:$rhs, SETGE)>;
388 def setlt : PatFrag<(ops node:$lhs, node:$rhs),
389 (setcc node:$lhs, node:$rhs, SETLT)>;
390 def setle : PatFrag<(ops node:$lhs, node:$rhs),
391 (setcc node:$lhs, node:$rhs, SETLE)>;
392 def setne : PatFrag<(ops node:$lhs, node:$rhs),
393 (setcc node:$lhs, node:$rhs, SETNE)>;
395 //===----------------------------------------------------------------------===//
396 // Selection DAG Pattern Support.
398 // Patterns are what are actually matched against the target-flavored
399 // instruction selection DAG. Instructions defined by the target implicitly
400 // define patterns in most cases, but patterns can also be explicitly added when
401 // an operation is defined by a sequence of instructions (e.g. loading a large
402 // immediate value on RISC targets that do not support immediates as large as
406 class Pattern<dag patternToMatch, list<dag> resultInstrs> {
407 dag PatternToMatch = patternToMatch;
408 list<dag> ResultInstrs = resultInstrs;
409 list<Predicate> Predicates = []; // See class Instruction in Target.td.
412 // Pat - A simple (but common) form of a pattern, which produces a simple result
413 // not needing a full list.
414 class Pat<dag pattern, dag result> : Pattern<pattern, [result]>;
416 //===----------------------------------------------------------------------===//
417 // Complex pattern definitions.
419 // Complex patterns, e.g. X86 addressing mode, requires pattern matching code
420 // in C++. NumOperands is the number of operands returned by the select function;
421 // SelectFunc is the name of the function used to pattern match the max. pattern;
422 // RootNodes are the list of possible root nodes of the sub-dags to match.
423 // e.g. X86 addressing mode - def addr : ComplexPattern<4, "SelectAddr", [add]>;
425 class ComplexPattern<ValueType ty, int numops, string fn, list<SDNode> roots = []> {
427 int NumOperands = numops;
428 string SelectFunc = fn;
429 list<SDNode> RootNodes = roots;
432 //===----------------------------------------------------------------------===//
435 def SDT_dwarf_loc : SDTypeProfile<0, 3,
436 [SDTCisInt<0>, SDTCisInt<1>, SDTCisInt<2>]>;
437 def dwarf_loc : SDNode<"ISD::DEBUG_LOC", SDT_dwarf_loc,[SDNPHasChain]>;