LLVM 24.0.0git
TargetLowering.h
Go to the documentation of this file.
1//===- llvm/CodeGen/TargetLowering.h - Target Lowering Info -----*- C++ -*-===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8///
9/// \file
10/// This file describes how to lower LLVM code to machine code. This has two
11/// main components:
12///
13/// 1. Which ValueTypes are natively supported by the target.
14/// 2. Which operations are supported for supported ValueTypes.
15/// 3. Cost thresholds for alternative implementations of certain operations.
16///
17/// In addition it has a few other components, like information about FP
18/// immediates.
19///
20//===----------------------------------------------------------------------===//
21
22#ifndef LLVM_CODEGEN_TARGETLOWERING_H
23#define LLVM_CODEGEN_TARGETLOWERING_H
24
25#include "llvm/ADT/APInt.h"
26#include "llvm/ADT/ArrayRef.h"
27#include "llvm/ADT/DenseMap.h"
29#include "llvm/ADT/StringRef.h"
42#include "llvm/IR/Attributes.h"
43#include "llvm/IR/CallingConv.h"
44#include "llvm/IR/DataLayout.h"
46#include "llvm/IR/Function.h"
47#include "llvm/IR/InlineAsm.h"
48#include "llvm/IR/Instruction.h"
51#include "llvm/IR/Type.h"
58#include <algorithm>
59#include <cassert>
60#include <climits>
61#include <cstdint>
62#include <map>
63#include <string>
64#include <utility>
65#include <vector>
66
67namespace llvm {
68
69class AssumptionCache;
70class CCState;
71class CCValAssign;
74class Constant;
75enum class ExceptionHandling : int;
76class FastISel;
78class GlobalValue;
79class Loop;
81class IntrinsicInst;
82class IRBuilderBase;
83struct KnownBits;
84class LLVMContext;
86class MachineFunction;
87class MachineInstr;
89class MachineLoop;
91class MCContext;
92class MCExpr;
93class Module;
96class TargetMachine;
97class MCRegisterClass;
101class Value;
102class VPIntrinsic;
103
104namespace Sched {
105
107 None, // No preference
108 Source, // Follow source order.
109 RegPressure, // Scheduling for lowest register pressure.
110 Hybrid, // Scheduling for both latency and register pressure.
111 ILP, // Scheduling for ILP in low register pressure mode.
112 VLIW, // Scheduling for VLIW targets.
113 Fast, // Fast suboptimal list scheduling
114 Linearize, // Linearize DAG, no scheduling
115 Last = Linearize // Marker for the last Sched::Preference
116};
117
118} // end namespace Sched
119
120// MemOp models a memory operation, either memset or memcpy/memmove.
121struct MemOp {
122private:
123 enum class MemOpKind {
124 Memset,
125 MemsetWithZero, // memset the memory with zeros
126 Memcpy, // copy memory from source to destination, source and destination do
127 // not overlap
128 MemcpyStrSrc, // memcpy source is an in-register constant, so it does not
129 // need to be loaded
130 Memmove, // memmove: like memcpy, but source and destination regions may
131 // overlap
132 };
133
134 // Shared
135 uint64_t Size;
136 bool DstAlignCanChange; // true if destination alignment can satisfy any
137 // constraint.
138 Align DstAlign; // Specified alignment of the memory operation.
139
140 bool IsVolatile;
141 MemOpKind Kind;
142 Align SrcAlign; // Inferred alignment of the source or default value if the
143 // memory operation does not need to load the value.
144public:
145 static MemOp Copy(uint64_t Size, bool DstAlignCanChange, Align DstAlign,
146 Align SrcAlign, bool IsVolatile,
147 bool MemcpyStrSrc = false) {
148 MemOp Op;
149 Op.Size = Size;
150 Op.DstAlignCanChange = DstAlignCanChange;
151 Op.DstAlign = DstAlign;
152 Op.IsVolatile = IsVolatile;
153 Op.Kind = MemcpyStrSrc ? MemOpKind::MemcpyStrSrc : MemOpKind::Memcpy;
154 Op.SrcAlign = SrcAlign;
155 return Op;
156 }
157
158 static MemOp Move(uint64_t Size, bool DstAlignCanChange, Align DstAlign,
159 Align SrcAlign, bool IsVolatile) {
160 MemOp Op;
161 Op.Size = Size;
162 Op.DstAlignCanChange = DstAlignCanChange;
163 Op.DstAlign = DstAlign;
164 Op.IsVolatile = IsVolatile;
165 Op.Kind = MemOpKind::Memmove;
166 Op.SrcAlign = SrcAlign;
167 return Op;
168 }
169
170 static MemOp Set(uint64_t Size, bool DstAlignCanChange, Align DstAlign,
171 bool IsZeroMemset, bool IsVolatile) {
172 MemOp Op;
173 Op.Size = Size;
174 Op.DstAlignCanChange = DstAlignCanChange;
175 Op.DstAlign = DstAlign;
176 Op.IsVolatile = IsVolatile;
177 Op.Kind = IsZeroMemset ? MemOpKind::MemsetWithZero : MemOpKind::Memset;
178 return Op;
179 }
180
181 uint64_t size() const { return Size; }
183 assert(!DstAlignCanChange);
184 return DstAlign;
185 }
186 bool isFixedDstAlign() const { return !DstAlignCanChange; }
187 bool isVolatile() const { return IsVolatile; }
188 bool isMemset() const {
189 return Kind == MemOpKind::Memset || Kind == MemOpKind::MemsetWithZero;
190 }
191 bool isMemcpy() const {
192 return Kind == MemOpKind::Memcpy || Kind == MemOpKind::MemcpyStrSrc;
193 }
194 bool isMemmove() const { return Kind == MemOpKind::Memmove; }
195 bool isMemcpyOrMemmove() const { return isMemcpy() || isMemmove(); }
197 return isMemcpyOrMemmove() && !DstAlignCanChange;
198 }
199 bool isZeroMemset() const { return Kind == MemOpKind::MemsetWithZero; }
200 bool isMemcpyStrSrc() const { return Kind == MemOpKind::MemcpyStrSrc; }
202 assert(isMemcpyOrMemmove() && "Must be a memcpy or memmove");
203 return SrcAlign;
204 }
205 bool isSrcAligned(Align AlignCheck) const {
206 return isMemset() || llvm::isAligned(AlignCheck, SrcAlign.value());
207 }
208 bool isDstAligned(Align AlignCheck) const {
209 return DstAlignCanChange || llvm::isAligned(AlignCheck, DstAlign.value());
210 }
211 bool isAligned(Align AlignCheck) const {
212 return isSrcAligned(AlignCheck) && isDstAligned(AlignCheck);
213 }
214};
215
216/// This base class for TargetLowering contains the SelectionDAG-independent
217/// parts that can be used from the rest of CodeGen.
219public:
220 /// This enum indicates whether operations are valid for a target, and if not,
221 /// what action should be used to make them valid.
223 Legal, // The target natively supports this operation.
224 Promote, // This operation should be executed in a larger type.
225 Expand, // Try to expand this to other ops, otherwise use a libcall.
226 LibCall, // Don't try to expand this to other ops, always use a libcall.
227 Custom // Use the LowerOperation hook to implement custom lowering.
228 };
229
230 /// This enum indicates whether a types are legal for a target, and if not,
231 /// what action should be used to make them valid.
233 TypeLegal, // The target natively supports this type.
234 TypePromoteInteger, // Replace this integer with a larger one.
235 TypeExpandInteger, // Split this integer into two of half the size.
236 TypeSoftenFloat, // Convert this float to a same size integer type.
237 TypeExpandFloat, // Split this float into two of half the size.
238 TypeScalarizeVector, // Replace this one-element vector with its element.
239 TypeSplitVector, // Split this vector into two of half the size.
240 TypeWidenVector, // This vector should be widened into a larger vector.
241 TypeSoftPromoteHalf, // Soften half to i16 and use float to do arithmetic.
242 TypeScalarizeScalableVector, // This action is explicitly left
243 // unimplemented. While it is theoretically
244 // possible to legalize operations on scalable
245 // types with a loop that handles the vscale *
246 // #lanes of the vector, this is non-trivial at
247 // SelectionDAG level and these types are
248 // better to be widened or promoted.
249 };
250
251 /// LegalizeKind holds the legalization kind that needs to happen to EVT
252 /// in order to type-legalize it.
253 using LegalizeKind = std::pair<LegalizeTypeAction, EVT>;
254
255 /// Enum that describes how the target represents true/false values.
257 UndefinedBooleanContent, // Only bit 0 counts, the rest can hold garbage.
258 ZeroOrOneBooleanContent, // All bits zero except for bit 0.
259 ZeroOrNegativeOneBooleanContent // All bits equal to bit 0.
260 };
261
262 /// Enum that describes what type of support for selects the target has.
264 ScalarValSelect, // The target supports scalar selects (ex: cmov).
265 ScalarCondVectorVal, // The target supports selects with a scalar condition
266 // and vector values (ex: cmov).
267 VectorMaskSelect // The target supports vector selects with a vector
268 // mask (ex: x86 blends).
269 };
270
271 /// Enum that specifies what an atomic load/AtomicRMWInst is expanded
272 /// to, if at all. Exists because different targets have different levels of
273 /// support for these atomic instructions, and also have different options
274 /// w.r.t. what they should expand to.
276 None, // Don't expand the instruction.
277 CastToInteger, // Cast the atomic instruction to another type, e.g. from
278 // floating-point to integer type.
279 LLSC, // Expand the instruction into loadlinked/storeconditional; used
280 // by ARM/AArch64/PowerPC.
281 LLOnly, // Expand the (load) instruction into just a load-linked, which has
282 // greater atomic guarantees than a normal load.
283 CmpXChg, // Expand the instruction into cmpxchg; used by at least X86.
284 MaskedIntrinsic, // Use a target-specific intrinsic for the LL/SC loop.
285 BitTestIntrinsic, // Use a target-specific intrinsic for special bit
286 // operations; used by X86.
287 CmpArithIntrinsic, // Use a target-specific intrinsic for special compare
288 // operations; used by X86.
289 Expand, // Generic expansion in terms of other atomic operations.
290 CustomExpand, // Custom target-specific expansion using TLI hooks.
291
292 // Rewrite to a non-atomic form for use in a known non-preemptible
293 // environment.
295 };
296
297 /// Enum that specifies when a multiplication should be expanded.
298 enum class MulExpansionKind {
299 Always, // Always expand the instruction.
300 OnlyLegalOrCustom, // Only expand when the resulting instructions are legal
301 // or custom.
302 };
303
304 /// Enum that specifies when a float negation is beneficial.
305 enum class NegatibleCost {
306 Cheaper = 0, // Negated expression is cheaper.
307 Neutral = 1, // Negated expression has the same cost.
308 Expensive = 2 // Negated expression is more expensive.
309 };
310
311 /// Enum that specifies how expensive lowering an EXTRACT_SUBVECTOR is.
313 Free = 0, // Lowers to no instruction at all, e.g. a subregister copy.
314 Cheap = 1, // Lowers to at most one instruction, and may still be free if
315 // the target can fold the extract into the instruction
316 // consuming it (e.g. a widening op that reads the high half of
317 // a register).
318 Expensive = 2 // Needs a shuffle sequence that cannot be folded away.
319 };
320
321 /// Enum of different potentially desirable ways to fold (and/or (setcc ...),
322 /// (setcc ...)).
324 None = 0, // No fold is preferable.
325 AddAnd = 1, // Fold with `Add` op and `And` op is preferable.
326 NotAnd = 2, // Fold with `Not` op and `And` op is preferable.
327 ABS = 4, // Fold with `llvm.abs` op is preferable.
328 };
329
331 public:
334 /// Original unlegalized argument type.
336 /// Same as OrigTy, or partially legalized for soft float libcalls.
338 bool IsSExt : 1;
339 bool IsZExt : 1;
340 bool IsNoExt : 1;
341 bool IsInReg : 1;
342 bool IsSRet : 1;
343 bool IsNest : 1;
344 bool IsByVal : 1;
345 bool IsByRef : 1;
346 bool IsInAlloca : 1;
348 bool IsReturned : 1;
349 bool IsSwiftSelf : 1;
350 bool IsSwiftAsync : 1;
351 bool IsSwiftError : 1;
353 MaybeAlign Alignment = std::nullopt;
354 Type *IndirectType = nullptr;
355
362
365
367
368 LLVM_ABI void setAttributes(const CallBase *Call, unsigned ArgIdx);
369 };
370 using ArgListTy = std::vector<ArgListEntry>;
371
373 switch (Content) {
375 // Extend by adding rubbish bits.
376 return ISD::ANY_EXTEND;
378 // Extend by adding zero bits.
379 return ISD::ZERO_EXTEND;
381 // Extend by copying the sign bit.
382 return ISD::SIGN_EXTEND;
383 }
384 llvm_unreachable("Invalid content kind");
385 }
386
387 explicit TargetLoweringBase(const TargetMachine &TM,
388 const TargetSubtargetInfo &STI);
392
393 /// Return true if the target support strict float operation
394 bool isStrictFPEnabled() const {
395 return IsStrictFPEnabled;
396 }
397
398protected:
399 /// Initialize all of the actions to default values.
400 void initActions();
401
402public:
403 const TargetMachine &getTargetMachine() const { return TM; }
404
405 virtual bool useSoftFloat() const { return false; }
406
407 /// Return the pointer type for the given address space, defaults to
408 /// the pointer type from the data layout.
409 /// FIXME: The default needs to be removed once all the code is updated.
410 virtual MVT getPointerTy(const DataLayout &DL, uint32_t AS = 0) const {
411 return MVT::getIntegerVT(DL.getPointerSizeInBits(AS));
412 }
413
414 /// Return the in-memory pointer type for the given address space, defaults to
415 /// the pointer type from the data layout.
416 /// FIXME: The default needs to be removed once all the code is updated.
417 virtual MVT getPointerMemTy(const DataLayout &DL, uint32_t AS = 0) const {
418 return MVT::getIntegerVT(DL.getPointerSizeInBits(AS));
419 }
420
421 /// Return the type for frame index, which is determined by
422 /// the alloca address space specified through the data layout.
424 return getPointerTy(DL, DL.getAllocaAddrSpace());
425 }
426
427 /// Return the type for code pointers, which is determined by the program
428 /// address space specified through the data layout.
430 return getPointerTy(DL, DL.getProgramAddressSpace());
431 }
432
433 /// Return the type for operands of fence.
434 /// TODO: Let fence operands be of i32 type and remove this.
435 virtual MVT getFenceOperandTy(const DataLayout &DL) const {
436 return getPointerTy(DL);
437 }
438
439 /// Return the type to use for a scalar shift opcode, given the shifted amount
440 /// type. Targets should return a legal type if the input type is legal.
441 /// Targets can return a type that is too small if the input type is illegal.
442 virtual MVT getScalarShiftAmountTy(const DataLayout &, EVT) const;
443
444 /// Returns the type for the shift amount of a shift opcode. For vectors,
445 /// returns the input type. For scalars, calls getScalarShiftAmountTy.
446 /// If getScalarShiftAmountTy type cannot represent all possible shift
447 /// amounts, returns MVT::i32.
448 EVT getShiftAmountTy(EVT LHSTy, const DataLayout &DL) const;
449
450 /// Return the preferred type to use for a shift opcode, given the shifted
451 /// amount type is \p ShiftValueTy.
453 virtual LLT getPreferredShiftAmountTy(LLT ShiftValueTy) const {
454 return ShiftValueTy;
455 }
456
457 /// Returns the type to be used for the index operand vector operations. By
458 /// default we assume it will have the same size as an address space 0
459 /// pointer.
460 virtual unsigned getVectorIdxWidth(const DataLayout &DL) const {
461 return DL.getPointerSizeInBits(0);
462 }
463
464 /// Returns the type to be used for the index operand of:
465 /// ISD::INSERT_VECTOR_ELT, ISD::EXTRACT_VECTOR_ELT,
466 /// ISD::INSERT_SUBVECTOR, and ISD::EXTRACT_SUBVECTOR
470
471 /// Returns the type to be used for the index operand of:
472 /// G_INSERT_VECTOR_ELT, G_EXTRACT_VECTOR_ELT,
473 /// G_INSERT_SUBVECTOR, and G_EXTRACT_SUBVECTOR
476 }
477
478 /// Returns the type to be used for the EVL/AVL operand of VP nodes:
479 /// ISD::VP_UDIV, ISD::VP_SDIV, etc. It must be a legal scalar integer type,
480 /// and must be at least as large as i32. The EVL is implicitly zero-extended
481 /// to any larger type.
482 virtual MVT getVPExplicitVectorLengthTy() const { return MVT::i32; }
483
484 /// This callback is used to inspect load/store instructions and add
485 /// target-specific MachineMemOperand flags to them. The default
486 /// implementation does nothing.
490
491 /// This callback is used to inspect load/store SDNode.
492 /// The default implementation does nothing.
497
498 MachineMemOperand::Flags getLoadMemOperandFlags(
499 const LoadInst &LI, const DataLayout &DL, AssumptionCache *AC = nullptr,
500 const TargetLibraryInfo *LibInfo = nullptr,
502 MachineMemOperand::Flags getStoreMemOperandFlags(const StoreInst &SI,
503 const DataLayout &DL) const;
504 MachineMemOperand::Flags getAtomicMemOperandFlags(const Instruction &AI,
505 const DataLayout &DL) const;
507 getVPIntrinsicMemOperandFlags(const VPIntrinsic &VPIntrin) const;
508
509 virtual bool isSelectSupported(SelectSupportKind /*kind*/) const {
510 return true;
511 }
512
513 /// Return true if the @llvm.get.active.lane.mask intrinsic should be expanded
514 /// using generic code in SelectionDAGBuilder.
515 virtual bool shouldExpandGetActiveLaneMask(EVT VT, EVT OpVT) const {
516 return true;
517 }
518
519 virtual bool shouldExpandGetVectorLength(EVT CountVT, unsigned VF,
520 bool IsScalable) const {
521 return true;
522 }
523
524 /// Return the minimum number of bits required to hold the maximum possible
525 /// number of trailing zero vector elements.
526 unsigned getBitWidthForCttzElements(EVT RetVT, ElementCount EC,
527 bool ZeroIsPoison,
528 const ConstantRange *VScaleRange) const;
529
530 // Return true if op(vecreduce(x), vecreduce(y)) should be reassociated to
531 // vecreduce(op(x, y)) for the reduction opcode RedOpc.
532 virtual bool shouldReassociateReduction(unsigned RedOpc, EVT VT) const {
533 return true;
534 }
535
536 /// Return true if it is profitable to convert a select of FP constants into
537 /// a constant pool load whose address depends on the select condition. The
538 /// parameter may be used to differentiate a select with FP compare from
539 /// integer compare.
540 virtual bool reduceSelectOfFPConstantLoads(EVT CmpOpVT) const {
541 return true;
542 }
543
544 /// Does the target have multiple (allocatable) condition registers that
545 /// can be used to store the results of comparisons for use by selects
546 /// and conditional branches. With multiple condition registers, the code
547 /// generator will not aggressively sink comparisons into the blocks of their
548 /// users. \p VT is the type of the condition value, e.g. the type of the
549 /// result of a comparison.
550 virtual bool hasMultipleConditionRegisters(EVT VT) const { return false; }
551
552 /// Return true if the target has BitExtract instructions.
553 bool hasExtractBitsInsn() const { return HasExtractBitsInsn; }
554
555 /// Return the preferred vector type legalization action.
558 // The default action for one element vectors is to scalarize
560 return TypeScalarizeVector;
561 // The default action for an odd-width vector is to widen.
562 if (!VT.isPow2VectorType())
563 return TypeWidenVector;
564 // The default action for other vectors is to promote
565 return TypePromoteInteger;
566 }
567
568 // Return true if, for soft-promoted half, the half type should be passed to
569 // and returned from functions as f32. The default behavior is to pass as
570 // i16. If soft-promoted half is not used, this function is ignored and
571 // values are always passed and returned as f32.
572 virtual bool useFPRegsForHalfType() const { return false; }
573
574 // There are two general methods for expanding a BUILD_VECTOR node:
575 // 1. Use SCALAR_TO_VECTOR on the defined scalar values and then shuffle
576 // them together.
577 // 2. Build the vector on the stack and then load it.
578 // If this function returns true, then method (1) will be used, subject to
579 // the constraint that all of the necessary shuffles are legal (as determined
580 // by isShuffleMaskLegal). If this function returns false, then method (2) is
581 // always used. The vector type, and the number of defined values, are
582 // provided.
583 virtual bool
585 unsigned DefinedValues) const {
586 return DefinedValues < 3;
587 }
588
589 /// Return true if integer divide is usually cheaper than a sequence of
590 /// several shifts, adds, and multiplies for this target.
591 /// The definition of "cheaper" may depend on whether we're optimizing
592 /// for speed or for size.
593 virtual bool isIntDivCheap(EVT VT, AttributeList Attr) const { return false; }
594
595 /// Return true if the target can handle a standalone remainder operation.
596 virtual bool hasStandaloneRem(EVT VT) const {
597 return true;
598 }
599
600 /// Return true if SQRT(X) shouldn't be replaced with X*RSQRT(X).
601 virtual bool isFsqrtCheap(SDValue X, SelectionDAG &DAG) const {
602 // Default behavior is to replace SQRT(X) with X*RSQRT(X).
603 return false;
604 }
605
606 /// Reciprocal estimate status values used by the functions below.
611 };
612
613 /// Return a ReciprocalEstimate enum value for a square root of the given type
614 /// based on the function's attributes. If the operation is not overridden by
615 /// the function's attributes, "Unspecified" is returned and target defaults
616 /// are expected to be used for instruction selection.
617 int getRecipEstimateSqrtEnabled(EVT VT, MachineFunction &MF) const;
618
619 /// Return a ReciprocalEstimate enum value for a division of the given type
620 /// based on the function's attributes. If the operation is not overridden by
621 /// the function's attributes, "Unspecified" is returned and target defaults
622 /// are expected to be used for instruction selection.
623 int getRecipEstimateDivEnabled(EVT VT, MachineFunction &MF) const;
624
625 /// Return the refinement step count for a square root of the given type based
626 /// on the function's attributes. If the operation is not overridden by
627 /// the function's attributes, "Unspecified" is returned and target defaults
628 /// are expected to be used for instruction selection.
629 int getSqrtRefinementSteps(EVT VT, MachineFunction &MF) const;
630
631 /// Return the refinement step count for a division of the given type based
632 /// on the function's attributes. If the operation is not overridden by
633 /// the function's attributes, "Unspecified" is returned and target defaults
634 /// are expected to be used for instruction selection.
635 int getDivRefinementSteps(EVT VT, MachineFunction &MF) const;
636
637 /// Returns true if target has indicated at least one type should be bypassed.
638 bool isSlowDivBypassed() const { return !BypassSlowDivWidths.empty(); }
639
640 /// Returns map of slow types for division or remainder with corresponding
641 /// fast types
643 return BypassSlowDivWidths;
644 }
645
646 /// Return true if Flow Control is an expensive operation that should be
647 /// avoided.
648 bool isJumpExpensive() const { return JumpIsExpensive; }
649
650 // Costs parameters used by
651 // SelectionDAGBuilder::shouldKeepJumpConditionsTogether.
652 // shouldKeepJumpConditionsTogether will use these parameter value to
653 // determine if two conditions in the form `br (and/or cond1, cond2)` should
654 // be split into two branches or left as one.
655 //
656 // BaseCost is the cost threshold (in latency). If the estimated latency of
657 // computing both `cond1` and `cond2` is below the cost of just computing
658 // `cond1` + BaseCost, the two conditions will be kept together. Otherwise
659 // they will be split.
660 //
661 // LikelyBias increases BaseCost if branch probability info indicates that it
662 // is likely that both `cond1` and `cond2` will be computed.
663 //
664 // UnlikelyBias decreases BaseCost if branch probability info indicates that
665 // it is likely that both `cond1` and `cond2` will be computed.
666 //
667 // Set any field to -1 to make it ignored (setting BaseCost to -1 results in
668 // `shouldKeepJumpConditionsTogether` always returning false).
674 // Return params for deciding if we should keep two branch conditions merged
675 // or split them into two separate branches.
676 // Arg0: The binary op joining the two conditions (and/or).
677 // Arg1: The first condition (cond1)
678 // Arg2: The second condition (cond2)
679 // Arg3: The containing function.
680 virtual CondMergingParams
682 const Value *, const Function *) const {
683 // -1 will always result in splitting.
684 return {-1, -1, -1};
685 }
686
687 /// Return true if selects are only cheaper than branches if the branch is
688 /// unlikely to be predicted right.
692
693 virtual bool fallBackToDAGISel(const Instruction &Inst) const {
694 return false;
695 }
696
697 /// Return true if the following transform is beneficial:
698 /// fold (conv (load x)) -> (load (conv*)x)
699 /// On architectures that don't natively support some vector loads
700 /// efficiently, casting the load to a smaller vector of larger types and
701 /// loading is more efficient, however, this can be undone by optimizations in
702 /// dag combiner.
703 virtual bool isLoadBitCastBeneficial(EVT LoadVT, EVT BitcastVT,
704 const SelectionDAG &DAG,
705 const MachineMemOperand &MMO) const;
706
707 /// Return true if the following transform is beneficial:
708 /// (store (y (conv x)), y*)) -> (store x, (x*))
709 virtual bool isStoreBitCastBeneficial(EVT StoreVT, EVT BitcastVT,
710 const SelectionDAG &DAG,
711 const MachineMemOperand &MMO) const {
712 // Default to the same logic as loads.
713 return isLoadBitCastBeneficial(StoreVT, BitcastVT, DAG, MMO);
714 }
715
716 /// Return true if it is expected to be cheaper to do a store of vector
717 /// constant with the given size and type for the address space than to
718 /// store the individual scalar element constants.
719 virtual bool storeOfVectorConstantIsCheap(bool IsZero, EVT MemVT,
720 unsigned NumElem,
721 unsigned AddrSpace) const {
722 return IsZero;
723 }
724
725 /// Allow store merging for the specified type after legalization in addition
726 /// to before legalization. This may transform stores that do not exist
727 /// earlier (for example, stores created from intrinsics).
728 virtual bool mergeStoresAfterLegalization(EVT MemVT) const {
729 return true;
730 }
731
732 /// Returns if it's reasonable to merge stores to MemVT size.
733 virtual bool canMergeStoresTo(unsigned AS, EVT MemVT,
734 const MachineFunction &MF) const {
735 return true;
736 }
737
738 /// Return true if it is cheap to speculate a call to intrinsic cttz.
739 virtual bool isCheapToSpeculateCttz(Type *Ty) const {
740 return false;
741 }
742
743 /// Return true if it is cheap to speculate a call to intrinsic ctlz.
744 virtual bool isCheapToSpeculateCtlz(Type *Ty) const {
745 return false;
746 }
747
748 /// Return true if ctlz instruction is fast.
749 virtual bool isCtlzFast() const {
750 return false;
751 }
752
753 /// Return true if ctpop instruction is fast.
754 virtual bool isCtpopFast(EVT VT) const {
755 return isOperationLegal(ISD::CTPOP, VT);
756 }
757
758 /// Return the maximum number of "x & (x - 1)" operations that can be done
759 /// instead of deferring to a custom CTPOP.
760 virtual unsigned getCustomCtpopCost(EVT VT, ISD::CondCode Cond) const {
761 return 1;
762 }
763
764 /// Return true if instruction generated for equality comparison is folded
765 /// with instruction generated for signed comparison.
766 virtual bool isEqualityCmpFoldedWithSignedCmp() const { return true; }
767
768 /// Return true if the heuristic to prefer icmp eq zero should be used in code
769 /// gen prepare.
770 virtual bool preferZeroCompareBranch() const { return false; }
771
772 /// Return true if it is cheaper to split the store of a merged int val
773 /// from a pair of smaller values into multiple stores.
774 virtual bool isMultiStoresCheaperThanBitsMerge(EVT LTy, EVT HTy) const {
775 return false;
776 }
777
778 /// Return if the target supports combining a
779 /// chain like:
780 /// \code
781 /// %andResult = and %val1, #mask
782 /// %icmpResult = icmp %andResult, 0
783 /// \endcode
784 /// into a single machine instruction of a form like:
785 /// \code
786 /// cc = test %register, #mask
787 /// \endcode
788 virtual bool isMaskAndCmp0FoldingBeneficial(const Instruction &AndI) const {
789 return false;
790 }
791
792 /// Return true if it is valid to merge the TargetMMOFlags in two SDNodes.
793 virtual bool
795 const MemSDNode &NodeY) const {
796 return true;
797 }
798
799 /// Use bitwise logic to make pairs of compares more efficient. For example:
800 /// and (seteq A, B), (seteq C, D) --> seteq (or (xor A, B), (xor C, D)), 0
801 /// This should be true when it takes more than one instruction to lower
802 /// setcc (cmp+set on x86 scalar), when bitwise ops are faster than logic on
803 /// condition bits (crand on PowerPC), and/or when reducing cmp+br is a win.
804 virtual bool convertSetCCLogicToBitwiseLogic(EVT VT) const {
805 return false;
806 }
807
808 /// Return the preferred operand type if the target has a quick way to compare
809 /// integer values of the given size. Assume that any legal integer type can
810 /// be compared efficiently. Targets may override this to allow illegal wide
811 /// types to return a vector type if there is support to compare that type.
812 virtual MVT hasFastEqualityCompare(unsigned NumBits) const {
813 MVT VT = MVT::getIntegerVT(NumBits);
815 }
816
817 /// Return true if the target should transform:
818 /// (X & Y) == Y ---> (~X & Y) == 0
819 /// (X & Y) != Y ---> (~X & Y) != 0
820 ///
821 /// This may be profitable if the target has a bitwise and-not operation that
822 /// sets comparison flags. A target may want to limit the transformation based
823 /// on the type of Y or if Y is a constant.
824 ///
825 /// Note that the transform will not occur if Y is known to be a power-of-2
826 /// because a mask and compare of a single bit can be handled by inverting the
827 /// predicate, for example:
828 /// (X & 8) == 8 ---> (X & 8) != 0
829 virtual bool hasAndNotCompare(SDValue Y) const {
830 return false;
831 }
832
833 /// Return true if the target has a bitwise and-not operation:
834 /// X = ~A & B
835 /// This can be used to simplify select or other instructions.
836 virtual bool hasAndNot(SDValue X) const {
837 // If the target has the more complex version of this operation, assume that
838 // it has this operation too.
839 return hasAndNotCompare(X);
840 }
841
842 /// Return true if the target has a bit-test instruction:
843 /// (X & (1 << Y)) ==/!= 0
844 /// This knowledge can be used to prevent breaking the pattern,
845 /// or creating it if it could be recognized.
846 virtual bool hasBitTest(SDValue X, SDValue Y) const { return false; }
847
848 /// There are two ways to clear extreme bits (either low or high):
849 /// Mask: x & (-1 << y) (the instcombine canonical form)
850 /// Shifts: x >> y << y
851 /// Return true if the variant with 2 variable shifts is preferred.
852 /// Return false if there is no preference.
854 // By default, let's assume that no one prefers shifts.
855 return false;
856 }
857
858 /// Return true if it is profitable to fold a pair of shifts into a mask.
859 /// This is usually true on most targets. But some targets, like Thumb1,
860 /// have immediate shift instructions, but no immediate "and" instruction;
861 /// this makes the fold unprofitable.
862 virtual bool shouldFoldConstantShiftPairToMask(const SDNode *N) const {
863 return true;
864 }
865
866 /// Should we tranform the IR-optimal check for whether given truncation
867 /// down into KeptBits would be truncating or not:
868 /// (add %x, (1 << (KeptBits-1))) srccond (1 << KeptBits)
869 /// Into it's more traditional form:
870 /// ((%x << C) a>> C) dstcond %x
871 /// Return true if we should transform.
872 /// Return false if there is no preference.
874 unsigned KeptBits) const {
875 // By default, let's assume that no one prefers shifts.
876 return false;
877 }
878
879 /// Given the pattern
880 /// (X & (C l>>/<< Y)) ==/!= 0
881 /// return true if it should be transformed into:
882 /// ((X <</l>> Y) & C) ==/!= 0
883 /// WARNING: if 'X' is a constant, the fold may deadlock!
884 /// FIXME: we could avoid passing XC, but we can't use isConstOrConstSplat()
885 /// here because it can end up being not linked in.
888 unsigned OldShiftOpcode, unsigned NewShiftOpcode,
889 SelectionDAG &DAG) const {
890 if (hasBitTest(X, Y)) {
891 // One interesting pattern that we'd want to form is 'bit test':
892 // ((1 << Y) & C) ==/!= 0
893 // But we also need to be careful not to try to reverse that fold.
894
895 // Is this '1 << Y' ?
896 if (OldShiftOpcode == ISD::SHL && CC->isOne())
897 return false; // Keep the 'bit test' pattern.
898
899 // Will it be '1 << Y' after the transform ?
900 if (XC && NewShiftOpcode == ISD::SHL && XC->isOne())
901 return true; // Do form the 'bit test' pattern.
902 }
903
904 // If 'X' is a constant, and we transform, then we will immediately
905 // try to undo the fold, thus causing endless combine loop.
906 // So by default, let's assume everyone prefers the fold
907 // iff 'X' is not a constant.
908 return !XC;
909 }
910
911 // Return true if its desirable to perform the following transform:
912 // (fmul C, (uitofp Pow2))
913 // -> (bitcast_to_FP (add (bitcast_to_INT C), Log2(Pow2) << mantissa))
914 // (fdiv C, (uitofp Pow2))
915 // -> (bitcast_to_FP (sub (bitcast_to_INT C), Log2(Pow2) << mantissa))
916 //
917 // This is only queried after we have verified the transform will be bitwise
918 // equals.
919 //
920 // SDNode *N : The FDiv/FMul node we want to transform.
921 // SDValue FPConst: The Float constant operand in `N`.
922 // SDValue IntPow2: The Integer power of 2 operand in `N`.
924 SDValue IntPow2) const {
925 // Default to avoiding fdiv which is often very expensive.
926 return N->getOpcode() == ISD::FDIV;
927 }
928
929 // Given:
930 // (icmp eq/ne (and X, C0), (shift X, C1))
931 // or
932 // (icmp eq/ne X, (rotate X, CPow2))
933
934 // If C0 is a mask or shifted mask and the shift amt (C1) isolates the
935 // remaining bits (i.e something like `(x64 & UINT32_MAX) == (x64 >> 32)`)
936 // Do we prefer the shift to be shift-right, shift-left, or rotate.
937 // Note: Its only valid to convert the rotate version to the shift version iff
938 // the shift-amt (`C1`) is a power of 2 (including 0).
939 // If ShiftOpc (current Opcode) is returned, do nothing.
941 EVT VT, unsigned ShiftOpc, bool MayTransformRotate,
942 const APInt &ShiftOrRotateAmt,
943 const std::optional<APInt> &AndMask) const {
944 return ShiftOpc;
945 }
946
947 /// These two forms are equivalent:
948 /// sub %y, (xor %x, -1)
949 /// add (add %x, 1), %y
950 /// The variant with two add's is IR-canonical.
951 /// Some targets may prefer one to the other.
952 virtual bool preferIncOfAddToSubOfNot(EVT VT) const {
953 // By default, let's assume that everyone prefers the form with two add's.
954 return true;
955 }
956
957 // By default prefer folding (abs (sub nsw x, y)) -> abds(x, y). Some targets
958 // may want to avoid this to prevent loss of sub_nsw pattern.
959 virtual bool preferABDSToABSWithNSW(EVT VT) const {
960 return true;
961 }
962
963 // Return true if the target wants to transform Op(Splat(X)) -> Splat(Op(X))
964 virtual bool preferScalarizeSplat(SDNode *N) const { return true; }
965
966 // Return true if the target wants to transform:
967 // (TruncVT truncate(sext_in_reg(VT X, ExtVT))
968 // -> (TruncVT sext_in_reg(truncate(VT X), ExtVT))
969 // Some targets might prefer pre-sextinreg to improve truncation/saturation.
970 virtual bool preferSextInRegOfTruncate(EVT TruncVT, EVT VT, EVT ExtVT) const {
971 return true;
972 }
973
974 /// Return true if the target wants to use the optimization that
975 /// turns ext(promotableInst1(...(promotableInstN(load)))) into
976 /// promotedInst1(...(promotedInstN(ext(load)))).
978
979 /// Return true if the target can combine store(extractelement VectorTy,
980 /// Idx).
981 /// \p Cost[out] gives the cost of that transformation when this is true.
982 virtual bool canCombineStoreAndExtract(Type *VectorTy, Value *Idx,
983 unsigned &Cost) const {
984 return false;
985 }
986
987 /// Return true if the target shall perform extract vector element and store
988 /// given that the vector is known to be splat of constant.
989 /// \p Index[out] gives the index of the vector element to be extracted when
990 /// this is true.
992 Type *VectorTy, unsigned ElemSizeInBits, unsigned &Index) const {
993 return false;
994 }
995
996 /// Return true if inserting a scalar into a variable element of an undef
997 /// vector is more efficiently handled by splatting the scalar instead.
998 virtual bool shouldSplatInsEltVarIndex(EVT) const {
999 return false;
1000 }
1001
1002 /// Return true if target always benefits from combining into FMA for a
1003 /// given value type. This must typically return false on targets where FMA
1004 /// takes more cycles to execute than FADD.
1005 virtual bool enableAggressiveFMAFusion(EVT VT) const { return false; }
1006
1007 /// Return true if target always benefits from combining into FMA for a
1008 /// given value type. This must typically return false on targets where FMA
1009 /// takes more cycles to execute than FADD.
1010 virtual bool enableAggressiveFMAFusion(LLT Ty) const { return false; }
1011
1012 /// Return the ValueType of the result of SETCC operations.
1013 virtual EVT getSetCCResultType(const DataLayout &DL, LLVMContext &Context,
1014 EVT VT) const;
1015
1016 /// Return the ValueType for comparison libcalls. Comparison libcalls include
1017 /// floating point comparison calls, and Ordered/Unordered check calls on
1018 /// floating point numbers.
1020 return MVT::i32; // return the default value
1021 }
1022
1023 /// For targets without i1 registers, this gives the nature of the high-bits
1024 /// of boolean values held in types wider than i1.
1025 ///
1026 /// "Boolean values" are special true/false values produced by nodes like
1027 /// SETCC and consumed (as the condition) by nodes like SELECT and BRCOND.
1028 /// Not to be confused with general values promoted from i1. Some cpus
1029 /// distinguish between vectors of boolean and scalars; the isVec parameter
1030 /// selects between the two kinds. For example on X86 a scalar boolean should
1031 /// be zero extended from i1, while the elements of a vector of booleans
1032 /// should be sign extended from i1.
1033 ///
1034 /// Some cpus also treat floating point types the same way as they treat
1035 /// vectors instead of the way they treat scalars.
1036 BooleanContent getBooleanContents(bool isVec, bool isFloat) const {
1037 if (isVec)
1038 return BooleanVectorContents;
1039 return isFloat ? BooleanFloatContents : BooleanContents;
1040 }
1041
1043 return getBooleanContents(Type.isVector(), Type.isFloatingPoint());
1044 }
1045
1046 /// Promote the given target boolean to a target boolean of the given type.
1047 /// A target boolean is an integer value, not necessarily of type i1, the bits
1048 /// of which conform to getBooleanContents.
1049 ///
1050 /// ValVT is the type of values that produced the boolean.
1052 EVT ValVT) const {
1053 SDLoc dl(Bool);
1054 EVT BoolVT =
1055 getSetCCResultType(DAG.getDataLayout(), *DAG.getContext(), ValVT);
1057 return DAG.getNode(ExtendCode, dl, BoolVT, Bool);
1058 }
1059
1060 /// Return target scheduling preference.
1062 return SchedPreferenceInfo;
1063 }
1064
1065 /// Some scheduler, e.g. hybrid, can switch to different scheduling heuristics
1066 /// for different nodes. This function returns the preference (or none) for
1067 /// the given node.
1069 return Sched::None;
1070 }
1071
1072 /// Return the register class that should be used for the specified value
1073 /// type.
1074 virtual const TargetRegisterClass *getRegClassFor(MVT VT, bool isDivergent = false) const {
1075 (void)isDivergent;
1076 const TargetRegisterClass *RC = RegClassForVT[VT.SimpleTy];
1077 assert(RC && "This value type is not natively supported!");
1078 return RC;
1079 }
1080
1081 /// Allows target to decide about the register class of the
1082 /// specific value that is live outside the defining block.
1083 /// Returns true if the value needs uniform register class.
1085 const Value *) const {
1086 return false;
1087 }
1088
1089 /// Return the 'representative' register class for the specified value
1090 /// type.
1091 ///
1092 /// The 'representative' register class is the largest legal super-reg
1093 /// register class for the register class of the value type. For example, on
1094 /// i386 the rep register class for i8, i16, and i32 are GR32; while the rep
1095 /// register class is GR64 on x86_64.
1096 virtual const TargetRegisterClass *getRepRegClassFor(MVT VT) const {
1097 const TargetRegisterClass *RC = RepRegClassForVT[VT.SimpleTy];
1098 return RC;
1099 }
1100
1101 /// Return the cost of the 'representative' register class for the specified
1102 /// value type.
1104 return RepRegClassCostForVT[VT.SimpleTy];
1105 }
1106
1107 /// Return the preferred strategy to legalize tihs SHIFT instruction, with
1108 /// \p ExpansionFactor being the recursion depth - how many expansion needed.
1114 virtual ShiftLegalizationStrategy
1116 unsigned ExpansionFactor) const {
1117 if (ExpansionFactor == 1)
1120 }
1121
1122 /// Return true if the target has native support for the specified value type.
1123 /// This means that it has a register that directly holds it without
1124 /// promotions or expansions.
1125 bool isTypeLegal(EVT VT) const {
1126 assert(!VT.isSimple() ||
1127 (unsigned)VT.getSimpleVT().SimpleTy < std::size(RegClassForVT));
1128 return VT.isSimple() && RegClassForVT[VT.getSimpleVT().SimpleTy] != nullptr;
1129 }
1130
1132 /// ValueTypeActions - For each value type, keep a LegalizeTypeAction enum
1133 /// that indicates how instruction selection should deal with the type.
1134 LegalizeTypeAction ValueTypeActions[MVT::VALUETYPE_SIZE];
1135
1136 public:
1137 ValueTypeActionImpl() { llvm::fill(ValueTypeActions, TypeLegal); }
1138
1140 return ValueTypeActions[VT.SimpleTy];
1141 }
1142
1144 ValueTypeActions[VT.SimpleTy] = Action;
1145 }
1146 };
1147
1149 return ValueTypeActions;
1150 }
1151
1152 /// Return pair that represents the legalization kind (first) that needs to
1153 /// happen to EVT (second) in order to type-legalize it.
1154 ///
1155 /// First: how we should legalize values of this type, either it is already
1156 /// legal (return 'Legal') or we need to promote it to a larger type (return
1157 /// 'Promote'), or we need to expand it into multiple registers of smaller
1158 /// integer type (return 'Expand'). 'Custom' is not an option.
1159 ///
1160 /// Second: for types supported by the target, this is an identity function.
1161 /// For types that must be promoted to larger types, this returns the larger
1162 /// type to promote to. For integer types that are larger than the largest
1163 /// integer register, this contains one step in the expansion to get to the
1164 /// smaller register. For illegal floating point types, this returns the
1165 /// integer type to transform to.
1166 LegalizeKind getTypeConversion(LLVMContext &Context, EVT VT) const;
1167
1168 /// Return how we should legalize values of this type, either it is already
1169 /// legal (return 'Legal') or we need to promote it to a larger type (return
1170 /// 'Promote'), or we need to expand it into multiple registers of smaller
1171 /// integer type (return 'Expand'). 'Custom' is not an option.
1173 return getTypeConversion(Context, VT).first;
1174 }
1176 return ValueTypeActions.getTypeAction(VT);
1177 }
1178
1179 /// For types supported by the target, this is an identity function. For
1180 /// types that must be promoted to larger types, this returns the larger type
1181 /// to promote to. For integer types that are larger than the largest integer
1182 /// register, this contains one step in the expansion to get to the smaller
1183 /// register. For illegal floating point types, this returns the integer type
1184 /// to transform to.
1185 virtual EVT getTypeToTransformTo(LLVMContext &Context, EVT VT) const {
1186 return getTypeConversion(Context, VT).second;
1187 }
1188
1189 /// Perform getTypeToTransformTo repeatedly until a legal type is obtained.
1190 /// Useful for vector operations that might take multiple steps to legalize.
1192 EVT LegalVT = getTypeToTransformTo(Context, VT);
1193 while (LegalVT != VT) {
1194 VT = LegalVT;
1195 LegalVT = getTypeToTransformTo(Context, VT);
1196 }
1197 return LegalVT;
1198 }
1199
1200 /// For types supported by the target, this is an identity function. For
1201 /// types that must be expanded (i.e. integer types that are larger than the
1202 /// largest integer register or illegal floating point types), this returns
1203 /// the largest legal type it will be expanded to.
1204 EVT getTypeToExpandTo(LLVMContext &Context, EVT VT) const {
1205 assert(!VT.isVector());
1206 while (true) {
1207 switch (getTypeAction(Context, VT)) {
1208 case TypeLegal:
1209 return VT;
1210 case TypeExpandInteger:
1211 VT = getTypeToTransformTo(Context, VT);
1212 break;
1213 default:
1214 llvm_unreachable("Type is not legal nor is it to be expanded!");
1215 }
1216 }
1217 }
1218
1219 /// Vector types are broken down into some number of legal first class types.
1220 /// For example, EVT::v8f32 maps to 2 EVT::v4f32 with Altivec or SSE1, or 8
1221 /// promoted EVT::f64 values with the X86 FP stack. Similarly, EVT::v2i64
1222 /// turns into 4 EVT::i32 values with both PPC and X86.
1223 ///
1224 /// This method returns the number of registers needed, and the VT for each
1225 /// register. It also returns the VT and quantity of the intermediate values
1226 /// before they are promoted/expanded.
1228 EVT &IntermediateVT,
1229 unsigned &NumIntermediates,
1230 MVT &RegisterVT) const {
1231 return getVectorTypeBreakdownImpl(Context, VT, IntermediateVT,
1232 NumIntermediates, RegisterVT,
1233 /*ForCallingConv=*/false);
1234 }
1235
1236 /// Return true if fixed-length, non-power-of-two vectors should be broken
1237 /// down into legal vector parts instead of scalars for internal values.
1239 return false;
1240 }
1241
1242 bool shouldUseDynamicVectorTypeBreakdown(EVT VT, bool ForCallingConv) const {
1243 return preferVectorizedNonPowerOfTwoTypeBreakdown() && !ForCallingConv &&
1244 VT.isFixedLengthVector() &&
1246 }
1247
1248 /// Certain targets such as MIPS require that some types such as vectors are
1249 /// always broken down into scalars in some contexts. This occurs even if the
1250 /// vector type is legal.
1252 LLVMContext &Context, CallingConv::ID CC, EVT VT, EVT &IntermediateVT,
1253 unsigned &NumIntermediates, MVT &RegisterVT) const {
1254 return getVectorTypeBreakdownImpl(Context, VT, IntermediateVT,
1255 NumIntermediates, RegisterVT,
1256 /*ForCallingConv=*/true);
1257 }
1258
1260 unsigned opc = 0; // target opcode
1261 EVT memVT; // memory VT
1262
1263 // value representing memory location
1265
1266 // Fallback address space for use if ptrVal is nullptr. std::nullopt means
1267 // unknown address space.
1268 std::optional<unsigned> fallbackAddressSpace;
1269
1270 int offset = 0; // offset off of ptrVal
1271 uint64_t size = 0; // the size of the memory location
1272 // (taken from memVT if zero)
1273 MaybeAlign align = Align(1); // alignment
1274
1279 IntrinsicInfo() = default;
1280 };
1281
1282 /// Given an intrinsic, checks if on the target the intrinsic will need to map
1283 /// to a MemIntrinsicNode (touches memory). If this is the case, it stores
1284 /// the intrinsic information into the IntrinsicInfo vector passed to the
1285 /// function. The vector may contain multiple entries for intrinsics that
1286 /// access multiple memory locations.
1288 const CallBase &I, MachineFunction &MF,
1289 unsigned Intrinsic) const {}
1290
1291 /// Returns true if the target can instruction select the specified FP
1292 /// immediate natively. If false, the legalizer will materialize the FP
1293 /// immediate as a load from a constant pool.
1294 virtual bool isFPImmLegal(const APFloat & /*Imm*/, EVT /*VT*/,
1295 bool ForCodeSize = false) const {
1296 return false;
1297 }
1298
1299 /// Targets can use this to indicate that they only support *some*
1300 /// VECTOR_SHUFFLE operations, those with specific masks. By default, if a
1301 /// target supports the VECTOR_SHUFFLE node, all mask values are assumed to be
1302 /// legal.
1303 virtual bool isShuffleMaskLegal(ArrayRef<int> /*Mask*/, EVT /*VT*/) const {
1304 return true;
1305 }
1306
1307 /// Returns true if the operation can trap for the value type.
1308 ///
1309 /// VT must be a legal type. By default, we optimistically assume most
1310 /// operations don't trap except for integer divide and remainder.
1311 virtual bool canOpTrap(unsigned Op, EVT VT) const;
1312
1313 /// Similar to isShuffleMaskLegal. Targets can use this to indicate if there
1314 /// is a suitable VECTOR_SHUFFLE that can be used to replace a VAND with a
1315 /// constant pool entry.
1317 EVT /*VT*/) const {
1318 return false;
1319 }
1320
1321 /// How to legalize this custom operation?
1323 return Legal;
1324 }
1325
1326 /// Return how this operation should be treated: either it is legal, needs to
1327 /// be promoted to a larger size, needs to be expanded to some other code
1328 /// sequence, or the target has a custom expander for it.
1330 // If a target-specific SDNode requires legalization, require the target
1331 // to provide custom legalization for it.
1332 if (Op >= std::size(OpActions[0]))
1333 return Custom;
1334 if (VT.isExtended())
1335 return Expand;
1336 return OpActions[(unsigned)VT.getSimpleVT().SimpleTy][Op];
1337 }
1338
1339 /// Custom method defined by each target to indicate if an operation which
1340 /// may require a scale is supported natively by the target.
1341 /// If not, the operation is illegal.
1342 virtual bool isSupportedFixedPointOperation(unsigned Op, EVT VT,
1343 unsigned Scale) const {
1344 return false;
1345 }
1346
1347 /// Some fixed point operations may be natively supported by the target but
1348 /// only for specific scales. This method allows for checking
1349 /// if the width is supported by the target for a given operation that may
1350 /// depend on scale.
1352 unsigned Scale) const {
1353 auto Action = getOperationAction(Op, VT);
1354 if (Action != Legal)
1355 return Action;
1356
1357 // This operation is supported in this type but may only work on specific
1358 // scales.
1359 bool Supported;
1360 switch (Op) {
1361 default:
1362 llvm_unreachable("Unexpected fixed point operation.");
1363 case ISD::SMULFIX:
1364 case ISD::SMULFIXSAT:
1365 case ISD::UMULFIX:
1366 case ISD::UMULFIXSAT:
1367 case ISD::SDIVFIX:
1368 case ISD::SDIVFIXSAT:
1369 case ISD::UDIVFIX:
1370 case ISD::UDIVFIXSAT:
1371 Supported = isSupportedFixedPointOperation(Op, VT, Scale);
1372 break;
1373 }
1374
1375 return Supported ? Action : Expand;
1376 }
1377
1378 // If Op is a strict floating-point operation, return the result
1379 // of getOperationAction for the equivalent non-strict operation.
1381 unsigned EqOpc;
1382 switch (Op) {
1383 default: llvm_unreachable("Unexpected FP pseudo-opcode");
1384#define DAG_INSTRUCTION(NAME, NARG, ROUND_MODE, INTRINSIC, DAGN) \
1385 case ISD::STRICT_##DAGN: EqOpc = ISD::DAGN; break;
1386#define CMP_INSTRUCTION(NAME, NARG, ROUND_MODE, INTRINSIC, DAGN) \
1387 case ISD::STRICT_##DAGN: EqOpc = ISD::SETCC; break;
1388#include "llvm/IR/ConstrainedOps.def"
1389 }
1390
1391 return getOperationAction(EqOpc, VT);
1392 }
1393
1394 /// Return true if the specified operation is legal on this target or can be
1395 /// made legal with custom lowering. This is used to help guide high-level
1396 /// lowering decisions. LegalOnly is an optional convenience for code paths
1397 /// traversed pre and post legalisation.
1399 bool LegalOnly = false) const {
1400 if (LegalOnly)
1401 return isOperationLegal(Op, VT);
1402
1403 return (VT == MVT::Other || isTypeLegal(VT)) &&
1404 (getOperationAction(Op, VT) == Legal ||
1405 getOperationAction(Op, VT) == Custom);
1406 }
1407
1408 /// Return true if the specified operation is legal on this target or can be
1409 /// made legal using promotion. This is used to help guide high-level lowering
1410 /// decisions. LegalOnly is an optional convenience for code paths traversed
1411 /// pre and post legalisation.
1413 bool LegalOnly = false) const {
1414 if (LegalOnly)
1415 return isOperationLegal(Op, VT);
1416
1417 return (VT == MVT::Other || isTypeLegal(VT)) &&
1418 (getOperationAction(Op, VT) == Legal ||
1419 getOperationAction(Op, VT) == Promote);
1420 }
1421
1422 /// Return true if the specified operation is legal on this target or can be
1423 /// made legal with custom lowering or using promotion. This is used to help
1424 /// guide high-level lowering decisions. LegalOnly is an optional convenience
1425 /// for code paths traversed pre and post legalisation.
1427 bool LegalOnly = false) const {
1428 if (LegalOnly)
1429 return isOperationLegal(Op, VT);
1430
1431 return (VT == MVT::Other || isTypeLegal(VT)) &&
1432 (getOperationAction(Op, VT) == Legal ||
1433 getOperationAction(Op, VT) == Custom ||
1434 getOperationAction(Op, VT) == Promote);
1435 }
1436
1437 /// Return true if the operation uses custom lowering, regardless of whether
1438 /// the type is legal or not.
1439 bool isOperationCustom(unsigned Op, EVT VT) const {
1440 return getOperationAction(Op, VT) == Custom;
1441 }
1442
1443 /// Return true if lowering to a jump table is allowed.
1444 virtual bool areJTsAllowed(const Function *Fn) const {
1445 if (Fn->getFnAttribute("no-jump-tables").getValueAsBool())
1446 return false;
1447
1448 return isOperationLegalOrCustom(ISD::BR_JT, MVT::Other) ||
1450 }
1451
1452 /// Check whether the range [Low,High] fits in a machine word.
1453 bool rangeFitsInWord(const APInt &Low, const APInt &High,
1454 const DataLayout &DL) const {
1455 // FIXME: Using the pointer type doesn't seem ideal.
1456 uint64_t BW = DL.getIndexSizeInBits(0u);
1457 uint64_t Range = (High - Low).getLimitedValue(UINT64_MAX - 1) + 1;
1458 return Range <= BW;
1459 }
1460
1461 /// Return true if lowering to a jump table is suitable for a set of case
1462 /// clusters which may contain \p NumCases cases, \p Range range of values.
1463 virtual bool isSuitableForJumpTable(const SwitchInst *SI, uint64_t NumCases,
1465 BlockFrequencyInfo *BFI) const;
1466
1467 /// Returns preferred type for switch condition.
1468 virtual MVT getPreferredSwitchConditionType(LLVMContext &Context,
1469 EVT ConditionVT) const;
1470
1471 /// Return true if lowering to a bit test is suitable for a set of case
1472 /// clusters which contains \p NumDests unique destinations, \p Low and
1473 /// \p High as its lowest and highest case values, and expects \p NumCmps
1474 /// case value comparisons. Check if the number of destinations, comparison
1475 /// metric, and range are all suitable.
1478 const APInt &Low, const APInt &High, const DataLayout &DL) const {
1479 // FIXME: I don't think NumCmps is the correct metric: a single case and a
1480 // range of cases both require only one branch to lower. Just looking at the
1481 // number of clusters and destinations should be enough to decide whether to
1482 // build bit tests.
1483
1484 // To lower a range with bit tests, the range must fit the bitwidth of a
1485 // machine word.
1486 if (!rangeFitsInWord(Low, High, DL))
1487 return false;
1488
1489 unsigned NumDests = DestCmps.size();
1490 unsigned NumCmps = 0;
1491 unsigned int MaxBitTestEntry = 0;
1492 for (auto &DestCmp : DestCmps) {
1493 NumCmps += DestCmp.second;
1494 if (DestCmp.second > MaxBitTestEntry)
1495 MaxBitTestEntry = DestCmp.second;
1496 }
1497
1498 // Comparisons might be cheaper for small number of comparisons, which can
1499 // be Arch Target specific.
1500 if (MaxBitTestEntry < getMinimumBitTestCmps())
1501 return false;
1502
1503 // Decide whether it's profitable to lower this range with bit tests. Each
1504 // destination requires a bit test and branch, and there is an overall range
1505 // check branch. For a small number of clusters, separate comparisons might
1506 // be cheaper, and for many destinations, splitting the range might be
1507 // better.
1508 return (NumDests == 1 && NumCmps >= 3) || (NumDests == 2 && NumCmps >= 5) ||
1509 (NumDests == 3 && NumCmps >= 6);
1510 }
1511
1512 /// Return true if the specified operation is illegal on this target or
1513 /// unlikely to be made legal with custom lowering. This is used to help guide
1514 /// high-level lowering decisions.
1515 bool isOperationExpand(unsigned Op, EVT VT) const {
1516 return (!isTypeLegal(VT) || getOperationAction(Op, VT) == Expand);
1517 }
1518
1519 /// Return true if the specified operation is legal on this target.
1520 bool isOperationLegal(unsigned Op, EVT VT) const {
1521 return (VT == MVT::Other || isTypeLegal(VT)) &&
1522 getOperationAction(Op, VT) == Legal;
1523 }
1524
1525 bool isOperationExpandOrLibCall(unsigned Op, EVT VT) const {
1526 return isOperationExpand(Op, VT) || getOperationAction(Op, VT) == LibCall;
1527 }
1528
1529 /// Returns an alternative action to use when the coarser lookups (configured
1530 /// through `setLoadExtAction` and `setAtomicLoadExtAction`) yield
1531 /// `LegalizeAction::Custom`. Allows targets to use builtin behaviors (e.g.
1532 /// Legal, Promote) specialized by Alignment and AddrSpace, rather than just
1533 /// types.
1534 virtual LegalizeAction
1535 getCustomLoadAction(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace,
1536 unsigned ExtType, bool Atomic) const {
1538 }
1539
1540 /// Return how this load with extension should be treated: either it is legal,
1541 /// needs to be promoted to a larger size, needs to be expanded to some other
1542 /// code sequence, or the target has a custom expander for it.
1543 LegalizeAction getLoadAction(EVT ValVT, EVT MemVT, Align Alignment,
1544 unsigned AddrSpace, unsigned ExtType,
1545 bool Atomic) const {
1546 if (ValVT.isExtended() || MemVT.isExtended())
1547 return Expand;
1548 unsigned ValI = (unsigned)ValVT.getSimpleVT().SimpleTy;
1549 unsigned MemI = (unsigned)MemVT.getSimpleVT().SimpleTy;
1551 MemI < MVT::VALUETYPE_SIZE && "Table isn't big enough!");
1552 unsigned Shift = 4 * ExtType;
1553
1554 LegalizeAction Action;
1555 if (Atomic) {
1556 Action =
1557 (LegalizeAction)((AtomicLoadExtActions[ValI][MemI] >> Shift) & 0xf);
1558 assert((Action == Legal || Action == Expand) &&
1559 "Unsupported atomic load extension action.");
1560 } else {
1561 Action = (LegalizeAction)((LoadExtActions[ValI][MemI] >> Shift) & 0xf);
1562 }
1563
1564 if (Action == LegalizeAction::Custom) {
1565 return getCustomLoadAction(ValVT, MemVT, Alignment, AddrSpace, ExtType,
1566 Atomic);
1567 }
1568
1569 return Action;
1570 }
1571
1572 /// Return true if the specified load with extension is legal on this target.
1573 bool isLoadLegal(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace,
1574 unsigned ExtType, bool Atomic) const {
1575 return getLoadAction(ValVT, MemVT, Alignment, AddrSpace, ExtType, Atomic) ==
1576 Legal;
1577 }
1578
1579 /// Return true if the specified load with extension is legal or custom
1580 /// on this target.
1581 bool isLoadLegalOrCustom(EVT ValVT, EVT MemVT, Align Alignment,
1582 unsigned AddrSpace, unsigned ExtType,
1583 bool Atomic) const {
1584 LegalizeAction Action =
1585 getLoadAction(ValVT, MemVT, Alignment, AddrSpace, ExtType, Atomic);
1586 return Action == Legal || Action == Custom;
1587 }
1588
1589 /// Returns an alternative action to use when the coarser lookups (configured
1590 /// through `setTruncStoreAction` yield
1591 /// `LegalizeAction::Custom`. Allows targets to use builtin behaviors (e.g.
1592 /// Legal, Promote) specialized by Alignment and AddrSpace, rather than just
1593 /// types.
1595 Align Alignment,
1596 unsigned AddrSpace) const {
1598 }
1599
1600 /// Return how this store with truncation should be treated: either it is
1601 /// legal, needs to be promoted to a larger size, needs to be expanded to some
1602 /// other code sequence, or the target has a custom expander for it.
1604 unsigned AddrSpace) const {
1605 if (ValVT.isExtended() || MemVT.isExtended())
1606 return Expand;
1607 unsigned ValI = (unsigned)ValVT.getSimpleVT().SimpleTy;
1608 unsigned MemI = (unsigned)MemVT.getSimpleVT().SimpleTy;
1610 "Table isn't big enough!");
1611
1612 LegalizeAction Action = TruncStoreActions[ValI][MemI];
1613
1614 if (Action == LegalizeAction::Custom) {
1615 return getCustomTruncStoreAction(ValVT, MemVT, Alignment, AddrSpace);
1616 }
1617
1618 return Action;
1619 }
1620
1621 /// Return true if the specified store with truncation is legal on this
1622 /// target.
1623 bool isTruncStoreLegal(EVT ValVT, EVT MemVT, Align Alignment,
1624 unsigned AddrSpace) const {
1625 return isTypeLegal(ValVT) &&
1626 getTruncStoreAction(ValVT, MemVT, Alignment, AddrSpace) == Legal;
1627 }
1628
1629 /// Return true if the specified store with truncation has solution on this
1630 /// target.
1631 bool isTruncStoreLegalOrCustom(EVT ValVT, EVT MemVT, Align Alignment,
1632 unsigned AddrSpace) const {
1633 if (!isTypeLegal(ValVT))
1634 return false;
1635
1636 LegalizeAction Action =
1637 getTruncStoreAction(ValVT, MemVT, Alignment, AddrSpace);
1638 return (Action == Legal || Action == Custom);
1639 }
1640
1641 virtual bool canCombineTruncStore(EVT ValVT, EVT MemVT, Align Alignment,
1642 unsigned AddrSpace, bool LegalOnly) const {
1643 if (LegalOnly)
1644 return isTruncStoreLegal(ValVT, MemVT, Alignment, AddrSpace);
1645
1646 return isTruncStoreLegalOrCustom(ValVT, MemVT, Alignment, AddrSpace);
1647 }
1648
1649 /// Return how the indexed load should be treated: either it is legal, needs
1650 /// to be promoted to a larger size, needs to be expanded to some other code
1651 /// sequence, or the target has a custom expander for it.
1652 LegalizeAction getIndexedLoadAction(unsigned IdxMode, MVT VT) const {
1653 return getIndexedModeAction(IdxMode, VT, IMAB_Load);
1654 }
1655
1656 /// Return true if the specified indexed load is legal on this target.
1657 bool isIndexedLoadLegal(unsigned IdxMode, EVT VT) const {
1658 return VT.isSimple() &&
1659 (getIndexedLoadAction(IdxMode, VT.getSimpleVT()) == Legal ||
1660 getIndexedLoadAction(IdxMode, VT.getSimpleVT()) == Custom);
1661 }
1662
1663 /// Return how the indexed store should be treated: either it is legal, needs
1664 /// to be promoted to a larger size, needs to be expanded to some other code
1665 /// sequence, or the target has a custom expander for it.
1666 LegalizeAction getIndexedStoreAction(unsigned IdxMode, MVT VT) const {
1667 return getIndexedModeAction(IdxMode, VT, IMAB_Store);
1668 }
1669
1670 /// Return true if the specified indexed load is legal on this target.
1671 bool isIndexedStoreLegal(unsigned IdxMode, EVT VT) const {
1672 return VT.isSimple() &&
1673 (getIndexedStoreAction(IdxMode, VT.getSimpleVT()) == Legal ||
1674 getIndexedStoreAction(IdxMode, VT.getSimpleVT()) == Custom);
1675 }
1676
1677 /// Return how the indexed load should be treated: either it is legal, needs
1678 /// to be promoted to a larger size, needs to be expanded to some other code
1679 /// sequence, or the target has a custom expander for it.
1680 LegalizeAction getIndexedMaskedLoadAction(unsigned IdxMode, MVT VT) const {
1681 return getIndexedModeAction(IdxMode, VT, IMAB_MaskedLoad);
1682 }
1683
1684 /// Return true if the specified indexed load is legal on this target.
1685 bool isIndexedMaskedLoadLegal(unsigned IdxMode, EVT VT) const {
1686 return VT.isSimple() &&
1687 (getIndexedMaskedLoadAction(IdxMode, VT.getSimpleVT()) == Legal ||
1689 }
1690
1691 /// Return how the indexed store should be treated: either it is legal, needs
1692 /// to be promoted to a larger size, needs to be expanded to some other code
1693 /// sequence, or the target has a custom expander for it.
1694 LegalizeAction getIndexedMaskedStoreAction(unsigned IdxMode, MVT VT) const {
1695 return getIndexedModeAction(IdxMode, VT, IMAB_MaskedStore);
1696 }
1697
1698 /// Return true if the specified indexed load is legal on this target.
1699 bool isIndexedMaskedStoreLegal(unsigned IdxMode, EVT VT) const {
1700 return VT.isSimple() &&
1701 (getIndexedMaskedStoreAction(IdxMode, VT.getSimpleVT()) == Legal ||
1703 }
1704
1705 /// Returns true if the index type for a masked gather/scatter requires
1706 /// extending
1707 virtual bool shouldExtendGSIndex(EVT VT, EVT &EltTy) const { return false; }
1708
1709 // Returns true if Extend can be folded into the index of a masked gathers/scatters
1710 // on this target.
1711 virtual bool shouldRemoveExtendFromGSIndex(SDValue Extend, EVT DataVT) const {
1712 return false;
1713 }
1714
1715 // Return true if the target supports a scatter/gather instruction with
1716 // indices which are scaled by the particular value. Note that all targets
1717 // must by definition support scale of 1.
1719 uint64_t ElemSize) const {
1720 // MGATHER/MSCATTER are only required to support scaling by one or by the
1721 // element size.
1722 if (Scale != ElemSize && Scale != 1)
1723 return false;
1724 return true;
1725 }
1726
1727 /// Return how the condition code should be treated: either it is legal, needs
1728 /// to be expanded to some other code sequence, or the target has a custom
1729 /// expander for it.
1732 assert((unsigned)CC < std::size(CondCodeActions) &&
1733 ((unsigned)VT.SimpleTy >> 3) < std::size(CondCodeActions[0]) &&
1734 "Table isn't big enough!");
1735 // See setCondCodeAction for how this is encoded.
1736 uint32_t Shift = 4 * (VT.SimpleTy & 0x7);
1737 uint32_t Value = CondCodeActions[CC][VT.SimpleTy >> 3];
1738 LegalizeAction Action = (LegalizeAction) ((Value >> Shift) & 0xF);
1739 assert(Action != Promote && "Can't promote condition code!");
1740 return Action;
1741 }
1742
1743 /// Return true if the specified condition code is legal for a comparison of
1744 /// the specified types on this target.
1745 bool isCondCodeLegal(ISD::CondCode CC, MVT VT) const {
1746 return getCondCodeAction(CC, VT) == Legal;
1747 }
1748
1749 /// Return true if the specified condition code is legal or custom for a
1750 /// comparison of the specified types on this target.
1752 return getCondCodeAction(CC, VT) == Legal ||
1753 getCondCodeAction(CC, VT) == Custom;
1754 }
1755
1756 /// Return how a PARTIAL_REDUCE_U/SMLA node with Acc type AccVT and Input type
1757 /// InputVT should be treated. Either it's legal, needs to be promoted to a
1758 /// larger size, needs to be expanded to some other code sequence, or the
1759 /// target has a custom expander for it.
1761 EVT InputVT) const {
1764 PartialReduceActionTypes Key = {Opc, AccVT.getSimpleVT().SimpleTy,
1765 InputVT.getSimpleVT().SimpleTy};
1766 auto It = PartialReduceMLAActions.find(Key);
1767 return It != PartialReduceMLAActions.end() ? It->second : Expand;
1768 }
1769
1770 /// Return true if a PARTIAL_REDUCE_U/SMLA node with the specified types is
1771 /// legal or custom for this target.
1773 EVT InputVT) const {
1774 LegalizeAction Action = getPartialReduceMLAAction(Opc, AccVT, InputVT);
1775 return Action == Legal || Action == Custom;
1776 }
1777
1778 /// If the action for this operation is to promote, this method returns the
1779 /// ValueType to promote to.
1780 MVT getTypeToPromoteTo(unsigned Op, MVT VT) const {
1782 "This operation isn't promoted!");
1783
1784 // See if this has an explicit type specified.
1785 std::map<std::pair<unsigned, MVT::SimpleValueType>,
1787 PromoteToType.find(std::make_pair(Op, VT.SimpleTy));
1788 if (PTTI != PromoteToType.end()) return PTTI->second;
1789
1790 assert((VT.isInteger() || VT.isFloatingPoint()) &&
1791 "Cannot autopromote this type, add it with AddPromotedToType.");
1792
1793 uint64_t VTBits = VT.getScalarSizeInBits();
1794 MVT NVT = VT;
1795 do {
1796 NVT = (MVT::SimpleValueType)(NVT.SimpleTy+1);
1797 assert(NVT.isInteger() == VT.isInteger() &&
1798 NVT.isFloatingPoint() == VT.isFloatingPoint() &&
1799 "Didn't find type to promote to!");
1800 } while (VTBits >= NVT.getScalarSizeInBits() || !isTypeLegal(NVT) ||
1801 getOperationAction(Op, NVT) == Promote);
1802 return NVT;
1803 }
1804
1806 bool AllowUnknown = false) const {
1807 return getValueType(DL, Ty, AllowUnknown);
1808 }
1809
1810 /// Return the EVT corresponding to this LLVM type. This is fixed by the LLVM
1811 /// operations except for the pointer size. If AllowUnknown is true, this
1812 /// will return MVT::Other for types with no EVT counterpart (e.g. structs),
1813 /// otherwise it will assert.
1815 bool AllowUnknown = false) const {
1816 // Lower scalar pointers to native pointer types.
1817 if (auto *PTy = dyn_cast<PointerType>(Ty))
1818 return getPointerTy(DL, PTy->getAddressSpace());
1819
1820 if (auto *VTy = dyn_cast<VectorType>(Ty)) {
1821 Type *EltTy = VTy->getElementType();
1822 // Lower vectors of pointers to native pointer types.
1823 EVT EltVT;
1824 if (auto *PTy = dyn_cast<PointerType>(EltTy))
1825 EltVT = getPointerTy(DL, PTy->getAddressSpace());
1826 else
1827 EltVT = EVT::getEVT(EltTy, false);
1828 return EVT::getVectorVT(Ty->getContext(), EltVT, VTy->getElementCount());
1829 }
1830
1831 return EVT::getEVT(Ty, AllowUnknown);
1832 }
1833
1835 bool AllowUnknown = false) const {
1836 // Lower scalar pointers to native pointer types.
1837 if (auto *PTy = dyn_cast<PointerType>(Ty))
1838 return getPointerMemTy(DL, PTy->getAddressSpace());
1839
1840 if (auto *VTy = dyn_cast<VectorType>(Ty)) {
1841 Type *EltTy = VTy->getElementType();
1842 EVT EltVT;
1843 if (auto *PTy = dyn_cast<PointerType>(EltTy))
1844 EltVT = getPointerMemTy(DL, PTy->getAddressSpace());
1845 else
1846 EltVT = EVT::getEVT(EltTy, false);
1847 return EVT::getVectorVT(Ty->getContext(), EltVT, VTy->getElementCount());
1848 }
1849
1850 return getValueType(DL, Ty, AllowUnknown);
1851 }
1852
1853
1854 /// Return the MVT corresponding to this LLVM type. See getValueType.
1856 bool AllowUnknown = false) const {
1857 return getValueType(DL, Ty, AllowUnknown).getSimpleVT();
1858 }
1859
1860 /// Returns the desired alignment for ByVal or InAlloca aggregate function
1861 /// arguments in the caller parameter area.
1862 virtual Align getByValTypeAlignment(Type *Ty, const DataLayout &DL) const;
1863
1864 /// Return the type of registers that this ValueType will eventually require.
1865 MVT getRegisterType(LLVMContext &Context, EVT VT) const {
1866 return getRegisterTypeImpl(Context, VT, /*ForCallingConv=*/false);
1867 }
1868
1869 /// Return the number of registers that this ValueType will eventually
1870 /// require.
1871 ///
1872 /// This is one for any types promoted to live in larger registers, but may be
1873 /// more than one for types (like i64) that are split into pieces. For types
1874 /// like i140, which are first promoted then expanded, it is the number of
1875 /// registers needed to hold all the bits of the original type. For an i140
1876 /// on a 32 bit machine this means 5 registers.
1877 ///
1878 /// RegisterVT may be passed as a way to override the default settings, for
1879 /// instance with i128 inline assembly operands on SystemZ.
1880 virtual unsigned
1882 std::optional<MVT> RegisterVT = std::nullopt) const {
1883 return getNumRegistersImpl(Context, VT, /*ForCallingConv=*/false);
1884 }
1885
1886 /// Certain combinations of ABIs, Targets and features require that types
1887 /// are legal for some operations and not for other operations.
1888 /// For MIPS all vector types must be passed through the integer register set.
1890 CallingConv::ID CC, EVT VT) const {
1891 return getRegisterTypeImpl(Context, VT, /*ForCallingConv=*/true);
1892 }
1893
1894 /// Certain targets require unusual breakdowns of certain types. For MIPS,
1895 /// this occurs when a vector type is used, as vector are passed through the
1896 /// integer register set.
1898 CallingConv::ID CC,
1899 EVT VT) const {
1900 return getNumRegistersImpl(Context, VT, /*ForCallingConv=*/true);
1901 }
1902
1903 /// Certain targets have context sensitive alignment requirements, where one
1904 /// type has the alignment requirement of another type.
1906 const DataLayout &DL) const {
1907 return DL.getABITypeAlign(ArgTy);
1908 }
1909
1910 /// If true, then instruction selection should seek to shrink the FP constant
1911 /// of the specified type to a smaller type in order to save space and / or
1912 /// reduce runtime.
1913 virtual bool ShouldShrinkFPConstant(EVT) const { return true; }
1914
1915 /// Return true if it is profitable to reduce a load to a smaller type.
1916 /// \p ByteOffset is only set if we know the pointer offset at compile time
1917 /// otherwise we should assume that additional pointer math is required.
1918 /// Example: (i16 (trunc (i32 (load x))) -> i16 load x
1919 /// Example: (i16 (trunc (srl (i32 (load x)), 16)) -> i16 load x+2
1921 SDNode *Load, ISD::LoadExtType ExtTy, EVT NewVT,
1922 std::optional<unsigned> ByteOffset = std::nullopt) const {
1923 // By default, assume that it is cheaper to extract a subvector from a wide
1924 // vector load rather than creating multiple narrow vector loads.
1925 if (NewVT.isVector() && !SDValue(Load, 0).hasOneUse())
1926 return false;
1927
1928 return true;
1929 }
1930
1931 /// Return true (the default) if it is profitable to remove a sext_inreg(x)
1932 /// where the sext is redundant, and use x directly.
1933 virtual bool shouldRemoveRedundantExtend(SDValue Op) const { return true; }
1934
1935 /// Indicates if any padding is guaranteed to go at the most significant bits
1936 /// when storing the type to memory and the type size isn't equal to the store
1937 /// size.
1939 return VT.isScalarInteger() && !VT.isByteSized();
1940 }
1941
1942 /// When splitting a value of the specified type into parts, does the Lo
1943 /// or Hi part come first? This usually follows the endianness, except
1944 /// for ppcf128, where the Hi part always comes first.
1946 return DL.isBigEndian() || VT == MVT::ppcf128;
1947 }
1948
1949 /// If true, the target has custom DAG combine transformations that it can
1950 /// perform for the specified node.
1952 assert(unsigned(NT >> 3) < std::size(TargetDAGCombineArray));
1953 return TargetDAGCombineArray[NT >> 3] & (1 << (NT&7));
1954 }
1955
1958 }
1959
1960 /// Returns the size of the platform's va_list object.
1961 virtual unsigned getVaListSizeInBits(const DataLayout &DL) const {
1962 return getPointerTy(DL).getSizeInBits();
1963 }
1964
1965 /// Get maximum # of store operations permitted for llvm.memset
1966 ///
1967 /// This function returns the maximum number of store operations permitted
1968 /// to replace a call to llvm.memset. The value is set by the target at the
1969 /// performance threshold for such a replacement. If OptSize is true,
1970 /// return the limit for functions that have OptSize attribute.
1971 unsigned getMaxStoresPerMemset(bool OptSize) const;
1972
1973 /// Get maximum # of store operations permitted for llvm.memcpy
1974 ///
1975 /// This function returns the maximum number of store operations permitted
1976 /// to replace a call to llvm.memcpy. The value is set by the target at the
1977 /// performance threshold for such a replacement. If OptSize is true,
1978 /// return the limit for functions that have OptSize attribute.
1979 unsigned getMaxStoresPerMemcpy(bool OptSize) const;
1980
1981 /// \brief Get maximum # of store operations to be glued together
1982 ///
1983 /// This function returns the maximum number of store operations permitted
1984 /// to glue together during lowering of llvm.memcpy. The value is set by
1985 // the target at the performance threshold for such a replacement.
1986 virtual unsigned getMaxGluedStoresPerMemcpy() const {
1988 }
1989
1990 /// Get maximum # of load operations permitted for memcmp
1991 ///
1992 /// This function returns the maximum number of load operations permitted
1993 /// to replace a call to memcmp. The value is set by the target at the
1994 /// performance threshold for such a replacement. If OptSize is true,
1995 /// return the limit for functions that have OptSize attribute.
1996 unsigned getMaxExpandSizeMemcmp(bool OptSize) const {
1998 }
1999
2000 /// Get maximum # of store operations permitted for llvm.memmove
2001 ///
2002 /// This function returns the maximum number of store operations permitted
2003 /// to replace a call to llvm.memmove. The value is set by the target at the
2004 /// performance threshold for such a replacement. If OptSize is true,
2005 /// return the limit for functions that have OptSize attribute.
2006 unsigned getMaxStoresPerMemmove(bool OptSize) const;
2007
2008 /// Determine if the target supports unaligned memory accesses.
2009 ///
2010 /// This function returns true if the target allows unaligned memory accesses
2011 /// of the specified type in the given address space. If true, it also returns
2012 /// a relative speed of the unaligned memory access in the last argument by
2013 /// reference. The higher the speed number the faster the operation comparing
2014 /// to a number returned by another such call. This is used, for example, in
2015 /// situations where an array copy/move/set is converted to a sequence of
2016 /// store operations. Its use helps to ensure that such replacements don't
2017 /// generate code that causes an alignment error (trap) on the target machine.
2019 EVT, unsigned AddrSpace = 0, Align Alignment = Align(1),
2021 unsigned * /*Fast*/ = nullptr) const {
2022 return false;
2023 }
2024
2025 /// LLT handling variant.
2027 LLT, unsigned AddrSpace = 0, Align Alignment = Align(1),
2029 unsigned * /*Fast*/ = nullptr) const {
2030 return false;
2031 }
2032
2033 /// This function returns true if the memory access is aligned or if the
2034 /// target allows this specific unaligned memory access. If the access is
2035 /// allowed, the optional final parameter returns a relative speed of the
2036 /// access (as defined by the target).
2037 bool allowsMemoryAccessForAlignment(
2038 LLVMContext &Context, const DataLayout &DL, EVT VT,
2039 unsigned AddrSpace = 0, Align Alignment = Align(1),
2041 unsigned *Fast = nullptr) const;
2042
2043 /// Return true if the memory access of this type is aligned or if the target
2044 /// allows this specific unaligned access for the given MachineMemOperand.
2045 /// If the access is allowed, the optional final parameter returns a relative
2046 /// speed of the access (as defined by the target).
2047 bool allowsMemoryAccessForAlignment(LLVMContext &Context,
2048 const DataLayout &DL, EVT VT,
2049 const MachineMemOperand &MMO,
2050 unsigned *Fast = nullptr) const;
2051
2052 /// Return true if the target supports a memory access of this type for the
2053 /// given address space and alignment. If the access is allowed, the optional
2054 /// final parameter returns the relative speed of the access (as defined by
2055 /// the target).
2056 virtual bool
2057 allowsMemoryAccess(LLVMContext &Context, const DataLayout &DL, EVT VT,
2058 unsigned AddrSpace = 0, Align Alignment = Align(1),
2060 unsigned *Fast = nullptr) const;
2061
2062 /// Return true if the target supports a memory access of this type for the
2063 /// given MachineMemOperand. If the access is allowed, the optional
2064 /// final parameter returns the relative access speed (as defined by the
2065 /// target).
2066 bool allowsMemoryAccess(LLVMContext &Context, const DataLayout &DL, EVT VT,
2067 const MachineMemOperand &MMO,
2068 unsigned *Fast = nullptr) const;
2069
2070 /// LLT handling variant.
2071 bool allowsMemoryAccess(LLVMContext &Context, const DataLayout &DL, LLT Ty,
2072 const MachineMemOperand &MMO,
2073 unsigned *Fast = nullptr) const;
2074
2075 /// Returns the target specific optimal type for load and store operations as
2076 /// a result of memset, memcpy, and memmove lowering.
2077 /// It returns EVT::Other if the type should be determined using generic
2078 /// target-independent logic.
2079 virtual EVT
2081 const AttributeList & /*FuncAttributes*/) const {
2082 return MVT::Other;
2083 }
2084
2085 /// LLT returning variant.
2086 virtual LLT
2088 const AttributeList & /*FuncAttributes*/) const {
2089 return LLT();
2090 }
2091
2092 /// Returns true if it's safe to use load / store of the specified type to
2093 /// expand memcpy / memset inline.
2094 ///
2095 /// This is mostly true for all types except for some special cases. For
2096 /// example, on X86 targets without SSE2 f64 load / store are done with fldl /
2097 /// fstpl which also does type conversion. Note the specified type doesn't
2098 /// have to be legal as the hook is used before type legalization.
2099 virtual bool isSafeMemOpType(MVT /*VT*/) const { return true; }
2100
2101 /// Return lower limit for number of blocks in a jump table.
2102 virtual unsigned getMinimumJumpTableEntries() const;
2103
2104 /// Return lower limit of the density in a jump table.
2105 unsigned getMinimumJumpTableDensity(bool OptForSize) const;
2106
2107 /// Return upper limit for number of entries in a jump table.
2108 /// Zero if no limit.
2109 unsigned getMaximumJumpTableSize() const;
2110
2111 virtual bool isJumpTableRelative() const;
2112
2113 /// Retuen the minimum of largest number of comparisons in BitTest.
2114 unsigned getMinimumBitTestCmps() const;
2115
2116 /// Return maximum known-legal store size, which can be guaranteed for
2117 /// scalable vectors.
2119 return MaximumLegalStoreInBits;
2120 }
2121
2122 /// If a physical register, this specifies the register that
2123 /// llvm.savestack/llvm.restorestack should save and restore.
2125 return StackPointerRegisterToSaveRestore;
2126 }
2127
2128 /// If a physical register, this returns the register that receives the
2129 /// exception address on entry to an EH pad.
2130 virtual Register
2132 const Constant *PersonalityFn) const {
2133 return Register();
2134 }
2135
2136 /// If a physical register, this returns the register that receives the
2137 /// exception typeid on entry to a landing pad.
2138 virtual Register
2140 const Constant *PersonalityFn) const {
2141 return Register();
2142 }
2143
2144 virtual bool needsFixedCatchObjects() const {
2145 reportFatalUsageError("Funclet EH is not implemented for this target");
2146 }
2147
2148 /// Return the minimum stack alignment of an argument.
2150 return MinStackArgumentAlignment;
2151 }
2152
2153 /// Return the minimum function alignment.
2154 Align getMinFunctionAlignment() const { return MinFunctionAlignment; }
2155
2156 /// Return the preferred function alignment.
2157 Align getPrefFunctionAlignment() const { return PrefFunctionAlignment; }
2158
2159 /// Return the preferred loop alignment.
2160 virtual Align getPrefLoopAlignment(MachineLoop *ML = nullptr) const;
2161
2162 /// Return the maximum amount of bytes allowed to be emitted when padding for
2163 /// alignment
2164 virtual unsigned
2165 getMaxPermittedBytesForAlignment(MachineBasicBlock *MBB) const;
2166
2167 /// Should loops be aligned even when the function is marked OptSize (but not
2168 /// MinSize).
2169 virtual bool alignLoopsWithOptSize() const { return false; }
2170
2171 /// If the target has a standard location for the stack protector guard,
2172 /// returns the address of that location. Otherwise, returns nullptr.
2173 /// DEPRECATED: please override useLoadStackGuardNode and customize
2174 /// LOAD_STACK_GUARD, or customize \@llvm.stackguard().
2175 virtual Value *getIRStackGuard(IRBuilderBase &IRB,
2176 const LibcallLoweringInfo &Libcalls) const;
2177
2178 /// Inserts necessary declarations for SSP (stack protection) purpose.
2179 /// Should be used only when getIRStackGuard returns nullptr.
2180 virtual void insertSSPDeclarations(Module &M,
2181 const LibcallLoweringInfo &Libcalls) const;
2182
2183 /// Return the variable that's previously inserted by insertSSPDeclarations,
2184 /// if any, otherwise return nullptr. Should be used only when
2185 /// getIRStackGuard returns nullptr.
2186 virtual Value *getSDagStackGuard(const Module &M,
2187 const LibcallLoweringInfo &Libcalls) const;
2188
2189 /// If this function returns true, stack protection checks should mix the
2190 /// frame pointer (or whichever pointer is used to address locals) into the
2191 /// stack guard value before checking it. getIRStackGuard must return nullptr
2192 /// if this returns true.
2193 virtual bool useStackGuardMixFP() const { return false; }
2194
2195 /// If the target has a standard stack protection check function that
2196 /// performs validation and error handling, returns the function. Otherwise,
2197 /// returns nullptr. Must be previously inserted by insertSSPDeclarations.
2198 /// Should be used only when getIRStackGuard returns nullptr.
2199 Function *getSSPStackGuardCheck(const Module &M,
2200 const LibcallLoweringInfo &Libcalls) const;
2201
2202protected:
2203 Value *getDefaultSafeStackPointerLocation(IRBuilderBase &IRB,
2204 bool UseTLS) const;
2205
2206public:
2207 /// Returns the target-specific address of the unsafe stack pointer.
2208 virtual Value *
2209 getSafeStackPointerLocation(IRBuilderBase &IRB,
2210 const LibcallLoweringInfo &Libcalls) const;
2211
2212 /// Returns the name of the symbol used to emit stack probes or the empty
2213 /// string if not applicable.
2214 virtual bool hasStackProbeSymbol(const MachineFunction &MF) const { return false; }
2215
2216 virtual bool hasInlineStackProbe(const MachineFunction &MF) const { return false; }
2217
2219 return "";
2220 }
2221
2222 /// Returns true if a cast from SrcAS to DestAS is "cheap", such that e.g. we
2223 /// are happy to sink it into basic blocks. A cast may be free, but not
2224 /// necessarily a no-op. e.g. a free truncate from a 64-bit to 32-bit pointer.
2225 virtual bool isFreeAddrSpaceCast(unsigned SrcAS, unsigned DestAS) const;
2226
2227 /// Return true if the pointer arguments to CI should be aligned by aligning
2228 /// the object whose address is being passed. If so then MinSize is set to the
2229 /// minimum size the object must be to be aligned and PrefAlign is set to the
2230 /// preferred alignment.
2231 virtual bool shouldAlignPointerArgs(CallInst * /*CI*/, unsigned & /*MinSize*/,
2232 Align & /*PrefAlign*/) const {
2233 return false;
2234 }
2235
2236 //===--------------------------------------------------------------------===//
2237 /// \name Helpers for TargetTransformInfo implementations
2238 /// @{
2239
2240 /// Get the ISD node that corresponds to the Instruction class opcode.
2241 int InstructionOpcodeToISD(unsigned Opcode) const;
2242
2243 /// Get the ISD node that corresponds to the Intrinsic ID. Returns
2244 /// ISD::DELETED_NODE by default for an unsupported Intrinsic ID.
2245 int IntrinsicIDToISD(Intrinsic::ID ID) const;
2246
2247 /// @}
2248
2249 //===--------------------------------------------------------------------===//
2250 /// \name Helpers for atomic expansion.
2251 /// @{
2252
2253 /// Returns the maximum atomic operation size (in bits) supported by
2254 /// the backend. Atomic operations greater than this size (as well
2255 /// as ones that are not naturally aligned), will be expanded by
2256 /// AtomicExpandPass into an __atomic_* library call.
2258 return MaxAtomicSizeInBitsSupported;
2259 }
2260
2261 /// Returns the size in bits of the maximum div/rem the backend supports.
2262 /// Larger operations will be expanded by ExpandIRInsts.
2264 return MaxDivRemBitWidthSupported;
2265 }
2266
2267 /// Returns the size in bits of the maximum fp to/from int conversion the
2268 /// backend supports. Larger operations will be expanded by ExpandIRInsts.
2270 return MaxLargeFPConvertBitWidthSupported;
2271 }
2272
2273 /// Returns the size of the smallest cmpxchg or ll/sc instruction
2274 /// the backend supports. Any smaller operations are widened in
2275 /// AtomicExpandPass.
2276 ///
2277 /// Note that *unlike* operations above the maximum size, atomic ops
2278 /// are still natively supported below the minimum; they just
2279 /// require a more complex expansion.
2280 unsigned getMinCmpXchgSizeInBits() const { return MinCmpXchgSizeInBits; }
2281
2282 /// Return true if the target supports an atomic access of \p SizeInBytes
2283 /// bytes at the given \p Alignment. The default implementation only allows
2284 /// naturally aligned atomics, unless setSupportsUnalignedAtomics(true) was
2285 /// called.
2286 virtual bool isAtomicAlignmentSupported(Align Alignment,
2287 uint64_t SizeInBytes) const {
2288 return SupportsUnalignedAtomics || Alignment.value() >= SizeInBytes;
2289 }
2290
2291 /// Whether AtomicExpandPass should automatically insert fences and reduce
2292 /// ordering for this atomic. This should be true for most architectures with
2293 /// weak memory ordering. Defaults to false.
2294 virtual bool shouldInsertFencesForAtomic(const Instruction *I) const {
2295 return false;
2296 }
2297
2298 /// Whether AtomicExpandPass should automatically insert a seq_cst trailing
2299 /// fence without reducing the ordering for this atomic store. Defaults to
2300 /// false.
2301 virtual bool
2303 return false;
2304 }
2305
2306 // The memory ordering that AtomicExpandPass should assign to a atomic
2307 // instruction that it has lowered by adding fences. This can be used
2308 // to "fold" one of the fences into the atomic instruction.
2309 virtual AtomicOrdering
2313
2314 // Whether to issue an atomic load for the initial word value before the
2315 // atomicrmw/cmpxchg emulation loop.
2316 // TODO: For correctness, an atomic load should be issued for all targets.
2317 // Remove this API once this is achieved
2319 return true;
2320 }
2321
2322 /// Perform a load-linked operation on Addr, returning a "Value *" with the
2323 /// corresponding pointee type. This may entail some non-trivial operations to
2324 /// truncate or reconstruct types that will be illegal in the backend. See
2325 /// ARMISelLowering for an example implementation.
2326 virtual Value *emitLoadLinked(IRBuilderBase &Builder, Type *ValueTy,
2327 Value *Addr, AtomicOrdering Ord) const {
2328 llvm_unreachable("Load linked unimplemented on this target");
2329 }
2330
2331 /// Perform a store-conditional operation to Addr. Return the status of the
2332 /// store. This should be 0 if the store succeeded, non-zero otherwise.
2334 Value *Addr, AtomicOrdering Ord) const {
2335 llvm_unreachable("Store conditional unimplemented on this target");
2336 }
2337
2338 /// Perform a masked atomicrmw using a target-specific intrinsic. This
2339 /// represents the core LL/SC loop which will be lowered at a late stage by
2340 /// the backend. The target-specific intrinsic returns the loaded value and
2341 /// is not responsible for masking and shifting the result.
2343 AtomicRMWInst *AI,
2344 Value *AlignedAddr, Value *Incr,
2345 Value *Mask, Value *ShiftAmt,
2346 AtomicOrdering Ord) const {
2347 llvm_unreachable("Masked atomicrmw expansion unimplemented on this target");
2348 }
2349
2350 /// Perform a atomicrmw expansion using a target-specific way. This is
2351 /// expected to be called when masked atomicrmw and bit test atomicrmw don't
2352 /// work, and the target supports another way to lower atomicrmw.
2353 virtual void emitExpandAtomicRMW(AtomicRMWInst *AI) const {
2355 "Generic atomicrmw expansion unimplemented on this target");
2356 }
2357
2358 /// Perform a atomic store using a target-specific way.
2359 virtual void emitExpandAtomicStore(StoreInst *SI) const {
2361 "Generic atomic store expansion unimplemented on this target");
2362 }
2363
2364 /// Perform a atomic load using a target-specific way.
2365 virtual void emitExpandAtomicLoad(LoadInst *LI) const {
2367 "Generic atomic load expansion unimplemented on this target");
2368 }
2369
2370 /// Perform a cmpxchg expansion using a target-specific method.
2372 llvm_unreachable("Generic cmpxchg expansion unimplemented on this target");
2373 }
2374
2375 /// Perform a bit test atomicrmw using a target-specific intrinsic. This
2376 /// represents the combined bit test intrinsic which will be lowered at a late
2377 /// stage by the backend.
2380 "Bit test atomicrmw expansion unimplemented on this target");
2381 }
2382
2383 /// Perform a atomicrmw which the result is only used by comparison, using a
2384 /// target-specific intrinsic. This represents the combined atomic and compare
2385 /// intrinsic which will be lowered at a late stage by the backend.
2388 "Compare arith atomicrmw expansion unimplemented on this target");
2389 }
2390
2391 /// Perform a masked cmpxchg using a target-specific intrinsic. This
2392 /// represents the core LL/SC loop which will be lowered at a late stage by
2393 /// the backend. The target-specific intrinsic returns the loaded value and
2394 /// is not responsible for masking and shifting the result.
2396 IRBuilderBase &Builder, AtomicCmpXchgInst *CI, Value *AlignedAddr,
2397 Value *CmpVal, Value *NewVal, Value *Mask, AtomicOrdering Ord) const {
2398 llvm_unreachable("Masked cmpxchg expansion unimplemented on this target");
2399 }
2400
2401 //===--------------------------------------------------------------------===//
2402 /// \name KCFI check lowering.
2403 /// @{
2404
2407 const TargetInstrInfo *TII) const {
2408 llvm_unreachable("KCFI is not supported on this target");
2409 }
2410
2411 /// @}
2412
2413 /// Inserts in the IR a target-specific intrinsic specifying a fence.
2414 /// It is called by AtomicExpandPass before expanding an
2415 /// AtomicRMW/AtomicCmpXchg/AtomicStore/AtomicLoad
2416 /// if shouldInsertFencesForAtomic returns true.
2417 ///
2418 /// Inst is the original atomic instruction, prior to other expansions that
2419 /// may be performed.
2420 ///
2421 /// This function should either return a nullptr, or a pointer to an IR-level
2422 /// Instruction*. Even complex fence sequences can be represented by a
2423 /// single Instruction* through an intrinsic to be lowered later.
2424 ///
2425 /// The default implementation emits an IR fence before any release (or
2426 /// stronger) operation that stores, and after any acquire (or stronger)
2427 /// operation. This is generally a correct implementation, but backends may
2428 /// override if they wish to use alternative schemes (e.g. the PowerPC
2429 /// standard ABI uses a fence before a seq_cst load instead of after a
2430 /// seq_cst store).
2431 /// @{
2432 virtual Instruction *emitLeadingFence(IRBuilderBase &Builder,
2433 Instruction *Inst,
2434 AtomicOrdering Ord) const;
2435
2436 virtual Instruction *emitTrailingFence(IRBuilderBase &Builder,
2437 Instruction *Inst,
2438 AtomicOrdering Ord) const;
2439 /// @}
2440
2441 // Emits code that executes when the comparison result in the ll/sc
2442 // expansion of a cmpxchg instruction is such that the store-conditional will
2443 // not execute. This makes it possible to balance out the load-linked with
2444 // a dedicated instruction, if desired.
2445 // E.g., on ARM, if ldrex isn't followed by strex, the exclusive monitor would
2446 // be unnecessarily held, except if clrex, inserted by this hook, is executed.
2447 virtual void emitAtomicCmpXchgNoStoreLLBalance(IRBuilderBase &Builder) const {}
2448
2449 /// Returns true if arguments should be sign-extended in lib calls.
2450 virtual bool shouldSignExtendTypeInLibCall(Type *Ty, bool IsSigned) const {
2451 return IsSigned;
2452 }
2453
2454 /// Returns true if arguments should be extended in lib calls.
2455 virtual bool shouldExtendTypeInLibCall(EVT Type) const {
2456 return true;
2457 }
2458
2459 /// Returns how the given (atomic) load should be expanded by the
2460 /// IR-level AtomicExpand pass.
2464
2465 /// Returns how the given (atomic) load should be cast by the IR-level
2466 /// AtomicExpand pass.
2472
2473 /// Returns how the given (atomic) store should be expanded by the IR-level
2474 /// AtomicExpand pass into. For instance AtomicExpansionKind::CustomExpand
2475 /// will try to use an atomicrmw xchg.
2479
2480 /// Returns how the given (atomic) store should be cast by the IR-level
2481 /// AtomicExpand pass into. For instance AtomicExpansionKind::CastToInteger
2482 /// will try to cast the operands to integer values.
2484 if (SI->getValueOperand()->getType()->isFloatingPointTy())
2487 }
2488
2489 /// Returns how the given atomic cmpxchg should be expanded by the IR-level
2490 /// AtomicExpand pass.
2491 virtual AtomicExpansionKind
2495
2496 /// Returns how the IR-level AtomicExpand pass should expand the given
2497 /// AtomicRMW, if at all. Default is to never expand.
2498 virtual AtomicExpansionKind
2500 if (RMW->isFloatingPointOperation())
2502 if (RMW->getType()->isVectorTy())
2505 }
2506
2507 /// Returns how the given atomic atomicrmw should be cast by the IR-level
2508 /// AtomicExpand pass.
2509 virtual AtomicExpansionKind
2511 Type *ValTy = RMWI->getValOperand()->getType();
2512 if (RMWI->getOperation() == AtomicRMWInst::Xchg &&
2513 (ValTy->isFloatingPointTy() || ValTy->isPointerTy() ||
2514 ValTy->isVectorTy()))
2516
2518 }
2519
2520 /// On some platforms, an AtomicRMW that never actually modifies the value
2521 /// (such as fetch_add of 0) can be turned into a fence followed by an
2522 /// atomic load. This may sound useless, but it makes it possible for the
2523 /// processor to keep the cacheline shared, dramatically improving
2524 /// performance. And such idempotent RMWs are useful for implementing some
2525 /// kinds of locks, see for example (justification + benchmarks):
2526 /// http://www.hpl.hp.com/techreports/2012/HPL-2012-68.pdf
2527 /// This method tries doing that transformation, returning the atomic load if
2528 /// it succeeds, and nullptr otherwise.
2529 /// If shouldExpandAtomicLoadInIR returns true on that load, it will undergo
2530 /// another round of expansion.
2531 virtual LoadInst *
2533 return nullptr;
2534 }
2535
2536 /// Returns how the platform's atomic operations are extended (ZERO_EXTEND,
2537 /// SIGN_EXTEND, or ANY_EXTEND).
2539 return ISD::ZERO_EXTEND;
2540 }
2541
2542 /// Returns how the platform's atomic compare and swap expects its comparison
2543 /// value to be extended (ZERO_EXTEND, SIGN_EXTEND, or ANY_EXTEND). This is
2544 /// separate from getExtendForAtomicOps, which is concerned with the
2545 /// sign-extension of the instruction's output, whereas here we are concerned
2546 /// with the sign-extension of the input. For targets with compare-and-swap
2547 /// instructions (or sub-word comparisons in their LL/SC loop expansions),
2548 /// the input can be ANY_EXTEND, but the output will still have a specific
2549 /// extension.
2551 return ISD::ANY_EXTEND;
2552 }
2553
2554 /// Returns how the platform's atomic rmw operations expect their input
2555 /// argument to be extended (ZERO_EXTEND, SIGN_EXTEND, or ANY_EXTEND).
2557 return ISD::ANY_EXTEND;
2558 }
2559
2560 /// @}
2561
2562 /// Returns true if we should normalize
2563 /// select(N0&N1, X, Y) => select(N0, select(N1, X, Y), Y) and
2564 /// select(N0|N1, X, Y) => select(N0, select(N1, X, Y, Y)) if it is likely
2565 /// that it saves us from materializing N0 and N1 in an integer register.
2566 /// Targets that are able to perform and/or on flags should return false here.
2567 /// \p VT is the type of the select (and X and Y). \p CCVT is the type of its
2568 /// condition (N0 and N1).
2570 EVT CCVT) const {
2571 // If a target has multiple condition registers, then it likely has logical
2572 // operations on those registers.
2574 return false;
2575 // Only do the transform if the value won't be split into multiple
2576 // registers.
2577 LegalizeTypeAction Action = getTypeAction(Context, VT);
2578 return Action != TypeExpandInteger && Action != TypeExpandFloat &&
2579 Action != TypeSplitVector;
2580 }
2581
2582 virtual bool isProfitableToCombineMinNumMaxNum(EVT VT) const { return true; }
2583
2584 /// Return true if a select of constants (select Cond, C1, C2) should be
2585 /// transformed into simple math ops with the condition value. For example:
2586 /// select Cond, C1, C1-1 --> add (zext Cond), C1-1
2587 virtual bool convertSelectOfConstantsToMath(EVT VT) const {
2588 return false;
2589 }
2590
2591 /// Return true if it is profitable to transform an integer
2592 /// multiplication-by-constant into simpler operations like shifts and adds.
2593 /// This may be true if the target does not directly support the
2594 /// multiplication operation for the specified type or the sequence of simpler
2595 /// ops is faster than the multiply.
2597 EVT VT, SDValue C) const {
2598 return false;
2599 }
2600
2601 /// Return true if it may be profitable to transform
2602 /// (mul (add x, c1), c2) -> (add (mul x, c2), c1*c2).
2603 /// This may not be true if c1 and c2 can be represented as immediates but
2604 /// c1*c2 cannot, for example.
2605 /// The target should check if c1, c2 and c1*c2 can be represented as
2606 /// immediates, or have to be materialized into registers. If it is not sure
2607 /// about some cases, a default true can be returned to let the DAGCombiner
2608 /// decide.
2609 /// AddNode is (add x, c1), and ConstNode is c2.
2611 SDValue ConstNode) const {
2612 return true;
2613 }
2614
2615 /// Return true if it is more correct/profitable to use strict FP_TO_INT
2616 /// conversion operations - canonicalizing the FP source value instead of
2617 /// converting all cases and then selecting based on value.
2618 /// This may be true if the target throws exceptions for out of bounds
2619 /// conversions or has fast FP CMOV.
2620 virtual bool shouldUseStrictFP_TO_INT(EVT FpVT, EVT IntVT,
2621 bool IsSigned) const {
2622 return false;
2623 }
2624
2625 /// Return true if it is beneficial to expand an @llvm.powi.* intrinsic.
2626 /// If not optimizing for size, expanding @llvm.powi.* intrinsics is always
2627 /// considered beneficial.
2628 /// If optimizing for size, expansion is only considered beneficial for upto
2629 /// 5 multiplies and a divide (if the exponent is negative).
2630 bool isBeneficialToExpandPowI(int64_t Exponent, bool OptForSize) const {
2631 if (Exponent < 0)
2632 Exponent = -Exponent;
2633 uint64_t E = static_cast<uint64_t>(Exponent);
2634 return !OptForSize || (llvm::popcount(E) + Log2_64(E) < 7);
2635 }
2636
2637 //===--------------------------------------------------------------------===//
2638 // TargetLowering Configuration Methods - These methods should be invoked by
2639 // the derived class constructor to configure this object for the target.
2640 //
2641protected:
2642 /// Specify how the target extends the result of integer and floating point
2643 /// boolean values from i1 to a wider type. See getBooleanContents.
2645 BooleanContents = Ty;
2646 BooleanFloatContents = Ty;
2647 }
2648
2649 /// Specify how the target extends the result of integer and floating point
2650 /// boolean values from i1 to a wider type. See getBooleanContents.
2652 BooleanContents = IntTy;
2653 BooleanFloatContents = FloatTy;
2654 }
2655
2656 /// Specify how the target extends the result of a vector boolean value from a
2657 /// vector of i1 to a wider type. See getBooleanContents.
2659 BooleanVectorContents = Ty;
2660 }
2661
2662 /// Specify the target scheduling preference.
2664 SchedPreferenceInfo = Pref;
2665 }
2666
2667 /// Indicate the minimum number of blocks to generate jump tables.
2668 void setMinimumJumpTableEntries(unsigned Val);
2669
2670 /// Indicate the maximum number of entries in jump tables.
2671 /// Set to zero to generate unlimited jump tables.
2672 void setMaximumJumpTableSize(unsigned);
2673
2674 /// Set the minimum of largest of number of comparisons to generate BitTest.
2675 void setMinimumBitTestCmps(unsigned Val);
2676
2677 /// If set to a physical register, this specifies the register that
2678 /// llvm.savestack/llvm.restorestack should save and restore.
2680 StackPointerRegisterToSaveRestore = R;
2681 }
2682
2683 /// Tells the code generator that the target has BitExtract instructions.
2684 /// The code generator will aggressively sink "shift"s into the blocks of
2685 /// their users if the users will generate "and" instructions which can be
2686 /// combined with "shift" to BitExtract instructions.
2687 void setHasExtractBitsInsn(bool hasExtractInsn = true) {
2688 HasExtractBitsInsn = hasExtractInsn;
2689 }
2690
2691 /// Tells the code generator not to expand logic operations on comparison
2692 /// predicates into separate sequences that increase the amount of flow
2693 /// control.
2694 void setJumpIsExpensive(bool isExpensive = true);
2695
2696 /// Tells the code generator which bitwidths to bypass.
2697 void addBypassSlowDiv(unsigned int SlowBitWidth, unsigned int FastBitWidth) {
2698 BypassSlowDivWidths[SlowBitWidth] = FastBitWidth;
2699 }
2700
2701 /// Add the specified register class as an available regclass for the
2702 /// specified value type. This indicates the selector can handle values of
2703 /// that class natively.
2705 assert((unsigned)VT.SimpleTy < std::size(RegClassForVT));
2706 RegClassForVT[VT.SimpleTy] = RC;
2707 }
2708
2709 /// Return the largest legal super-reg register class of the register class
2710 /// for the specified type and its associated "cost".
2711 virtual std::pair<const TargetRegisterClass *, uint8_t>
2712 findRepresentativeClass(const TargetRegisterInfo *TRI, MVT VT) const;
2713
2714 /// Once all of the register classes are added, this allows us to compute
2715 /// derived properties we expose.
2716 void computeRegisterProperties(const TargetRegisterInfo *TRI);
2717
2718 /// Indicate that the specified operation does not work with the specified
2719 /// type and indicate what to do about it. Note that VT may refer to either
2720 /// the type of a result or that of an operand of Op.
2721 void setOperationAction(unsigned Op, MVT VT, LegalizeAction Action) {
2722 assert(Op < std::size(OpActions[0]) && "Table isn't big enough!");
2723 OpActions[(unsigned)VT.SimpleTy][Op] = Action;
2724 }
2726 LegalizeAction Action) {
2727 for (auto Op : Ops)
2728 setOperationAction(Op, VT, Action);
2729 }
2731 LegalizeAction Action) {
2732 for (auto VT : VTs)
2733 setOperationAction(Ops, VT, Action);
2734 }
2735
2736 /// Indicate that the specified load with extension does not work with the
2737 /// specified type and indicate what to do about it.
2738 void setLoadExtAction(unsigned ExtType, MVT ValVT, MVT MemVT,
2739 LegalizeAction Action) {
2740 assert(ExtType < ISD::LAST_LOADEXT_TYPE && ValVT.isValid() &&
2741 MemVT.isValid() && "Table isn't big enough!");
2742 assert((unsigned)Action < 0x10 && "too many bits for bitfield array");
2743 unsigned Shift = 4 * ExtType;
2744 LoadExtActions[ValVT.SimpleTy][MemVT.SimpleTy] &= ~((uint16_t)0xF << Shift);
2745 LoadExtActions[ValVT.SimpleTy][MemVT.SimpleTy] |= (uint16_t)Action << Shift;
2746 }
2747 void setLoadExtAction(ArrayRef<unsigned> ExtTypes, MVT ValVT, MVT MemVT,
2748 LegalizeAction Action) {
2749 for (auto ExtType : ExtTypes)
2750 setLoadExtAction(ExtType, ValVT, MemVT, Action);
2751 }
2753 ArrayRef<MVT> MemVTs, LegalizeAction Action) {
2754 for (auto MemVT : MemVTs)
2755 setLoadExtAction(ExtTypes, ValVT, MemVT, Action);
2756 }
2757
2758 /// Let target indicate that an extending atomic load of the specified type
2759 /// is legal.
2760 void setAtomicLoadExtAction(unsigned ExtType, MVT ValVT, MVT MemVT,
2761 LegalizeAction Action) {
2762 assert(ExtType < ISD::LAST_LOADEXT_TYPE && ValVT.isValid() &&
2763 MemVT.isValid() && "Table isn't big enough!");
2764 assert((unsigned)Action < 0x10 && "too many bits for bitfield array");
2765 unsigned Shift = 4 * ExtType;
2766 AtomicLoadExtActions[ValVT.SimpleTy][MemVT.SimpleTy] &=
2767 ~((uint16_t)0xF << Shift);
2768 AtomicLoadExtActions[ValVT.SimpleTy][MemVT.SimpleTy] |=
2769 ((uint16_t)Action << Shift);
2770 }
2772 LegalizeAction Action) {
2773 for (auto ExtType : ExtTypes)
2774 setAtomicLoadExtAction(ExtType, ValVT, MemVT, Action);
2775 }
2777 ArrayRef<MVT> MemVTs, LegalizeAction Action) {
2778 for (auto MemVT : MemVTs)
2779 setAtomicLoadExtAction(ExtTypes, ValVT, MemVT, Action);
2780 }
2781
2782 /// Indicate that the specified truncating store does not work with the
2783 /// specified type and indicate what to do about it.
2784 void setTruncStoreAction(MVT ValVT, MVT MemVT, LegalizeAction Action) {
2785 assert(ValVT.isValid() && MemVT.isValid() && "Table isn't big enough!");
2786 TruncStoreActions[(unsigned)ValVT.SimpleTy][MemVT.SimpleTy] = Action;
2787 }
2788
2789 /// Indicate that the specified indexed load does or does not work with the
2790 /// specified type and indicate what to do abort it.
2791 ///
2792 /// NOTE: All indexed mode loads are initialized to Expand in
2793 /// TargetLowering.cpp
2795 LegalizeAction Action) {
2796 for (auto IdxMode : IdxModes)
2797 setIndexedModeAction(IdxMode, VT, IMAB_Load, Action);
2798 }
2799
2801 LegalizeAction Action) {
2802 for (auto VT : VTs)
2803 setIndexedLoadAction(IdxModes, VT, Action);
2804 }
2805
2806 /// Indicate that the specified indexed store does or does not work with the
2807 /// specified type and indicate what to do about it.
2808 ///
2809 /// NOTE: All indexed mode stores are initialized to Expand in
2810 /// TargetLowering.cpp
2812 LegalizeAction Action) {
2813 for (auto IdxMode : IdxModes)
2814 setIndexedModeAction(IdxMode, VT, IMAB_Store, Action);
2815 }
2816
2818 LegalizeAction Action) {
2819 for (auto VT : VTs)
2820 setIndexedStoreAction(IdxModes, VT, Action);
2821 }
2822
2823 /// Indicate that the specified indexed masked load does or does not work with
2824 /// the specified type and indicate what to do about it.
2825 ///
2826 /// NOTE: All indexed mode masked loads are initialized to Expand in
2827 /// TargetLowering.cpp
2828 void setIndexedMaskedLoadAction(unsigned IdxMode, MVT VT,
2829 LegalizeAction Action) {
2830 setIndexedModeAction(IdxMode, VT, IMAB_MaskedLoad, Action);
2831 }
2832
2833 /// Indicate that the specified indexed masked store does or does not work
2834 /// with the specified type and indicate what to do about it.
2835 ///
2836 /// NOTE: All indexed mode masked stores are initialized to Expand in
2837 /// TargetLowering.cpp
2838 void setIndexedMaskedStoreAction(unsigned IdxMode, MVT VT,
2839 LegalizeAction Action) {
2840 setIndexedModeAction(IdxMode, VT, IMAB_MaskedStore, Action);
2841 }
2842
2843 /// Indicate that the specified condition code is or isn't supported on the
2844 /// target and indicate what to do about it.
2846 LegalizeAction Action) {
2847 for (auto CC : CCs) {
2848 assert(VT.isValid() && (unsigned)CC < std::size(CondCodeActions) &&
2849 "Table isn't big enough!");
2850 assert((unsigned)Action < 0x10 && "too many bits for bitfield array");
2851 /// The lower 3 bits of the SimpleTy index into Nth 4bit set from the
2852 /// 32-bit value and the upper 29 bits index into the second dimension of
2853 /// the array to select what 32-bit value to use.
2854 uint32_t Shift = 4 * (VT.SimpleTy & 0x7);
2855 CondCodeActions[CC][VT.SimpleTy >> 3] &= ~((uint32_t)0xF << Shift);
2856 CondCodeActions[CC][VT.SimpleTy >> 3] |= (uint32_t)Action << Shift;
2857 }
2858 }
2860 LegalizeAction Action) {
2861 for (auto VT : VTs)
2862 setCondCodeAction(CCs, VT, Action);
2863 }
2864
2865 /// Indicate how a PARTIAL_REDUCE_U/SMLA node with Acc type AccVT and Input
2866 /// type InputVT should be treated by the target. Either it's legal, needs to
2867 /// be promoted to a larger size, needs to be expanded to some other code
2868 /// sequence, or the target has a custom expander for it.
2869 void setPartialReduceMLAAction(unsigned Opc, MVT AccVT, MVT InputVT,
2870 LegalizeAction Action) {
2873 assert(AccVT.isValid() && InputVT.isValid() &&
2874 "setPartialReduceMLAAction types aren't valid");
2875 PartialReduceActionTypes Key = {Opc, AccVT.SimpleTy, InputVT.SimpleTy};
2876 PartialReduceMLAActions[Key] = Action;
2877 }
2879 MVT InputVT, LegalizeAction Action) {
2880 for (unsigned Opc : Opcodes)
2881 setPartialReduceMLAAction(Opc, AccVT, InputVT, Action);
2882 }
2883
2884 /// If Opc/OrigVT is specified as being promoted, the promotion code defaults
2885 /// to trying a larger integer/fp until it can find one that works. If that
2886 /// default is insufficient, this method can be used by the target to override
2887 /// the default.
2888 void AddPromotedToType(unsigned Opc, MVT OrigVT, MVT DestVT) {
2889 PromoteToType[std::make_pair(Opc, OrigVT.SimpleTy)] = DestVT.SimpleTy;
2890 }
2891
2892 /// Convenience method to set an operation to Promote and specify the type
2893 /// in a single call.
2894 void setOperationPromotedToType(unsigned Opc, MVT OrigVT, MVT DestVT) {
2895 setOperationAction(Opc, OrigVT, Promote);
2896 AddPromotedToType(Opc, OrigVT, DestVT);
2897 }
2899 MVT DestVT) {
2900 for (auto Op : Ops) {
2901 setOperationAction(Op, OrigVT, Promote);
2902 AddPromotedToType(Op, OrigVT, DestVT);
2903 }
2904 }
2905
2906 /// Targets should invoke this method for each target independent node that
2907 /// they want to provide a custom DAG combiner for by implementing the
2908 /// PerformDAGCombine virtual method.
2910 for (auto NT : NTs) {
2911 assert(unsigned(NT >> 3) < std::size(TargetDAGCombineArray));
2912 TargetDAGCombineArray[NT >> 3] |= 1 << (NT & 7);
2913 }
2914 }
2915
2916 /// Set the target's minimum function alignment.
2918 MinFunctionAlignment = Alignment;
2919 }
2920
2921 /// Set the target's preferred function alignment. This should be set if
2922 /// there is a performance benefit to higher-than-minimum alignment
2924 PrefFunctionAlignment = Alignment;
2925 }
2926
2927 /// Set the target's preferred loop alignment. Default alignment is one, it
2928 /// means the target does not care about loop alignment. The target may also
2929 /// override getPrefLoopAlignment to provide per-loop values.
2930 void setPrefLoopAlignment(Align Alignment) { PrefLoopAlignment = Alignment; }
2931 void setMaxBytesForAlignment(unsigned MaxBytes) {
2932 MaxBytesForAlignment = MaxBytes;
2933 }
2934
2935 /// Set the minimum stack alignment of an argument.
2937 MinStackArgumentAlignment = Alignment;
2938 }
2939
2940 /// Set the maximum atomic operation size supported by the
2941 /// backend. Atomic operations greater than this size (as well as
2942 /// ones that are not naturally aligned), will be expanded by
2943 /// AtomicExpandPass into an __atomic_* library call.
2944 void setMaxAtomicSizeInBitsSupported(unsigned SizeInBits) {
2945 MaxAtomicSizeInBitsSupported = SizeInBits;
2946 }
2947
2948 /// Set the size in bits of the maximum div/rem the backend supports.
2949 /// Larger operations will be expanded by ExpandIRInsts.
2950 void setMaxDivRemBitWidthSupported(unsigned SizeInBits) {
2951 MaxDivRemBitWidthSupported = SizeInBits;
2952 }
2953
2954 /// Set the size in bits of the maximum fp to/from int conversion the backend
2955 /// supports. Larger operations will be expanded by ExpandIRInsts.
2956 void setMaxLargeFPConvertBitWidthSupported(unsigned SizeInBits) {
2957 MaxLargeFPConvertBitWidthSupported = SizeInBits;
2958 }
2959
2960 /// Sets the minimum cmpxchg or ll/sc size supported by the backend.
2961 void setMinCmpXchgSizeInBits(unsigned SizeInBits) {
2962 MinCmpXchgSizeInBits = SizeInBits;
2963 }
2964
2965 /// Sets whether unaligned atomic operations are supported.
2966 void setSupportsUnalignedAtomics(bool UnalignedSupported) {
2967 SupportsUnalignedAtomics = UnalignedSupported;
2968 }
2969
2970public:
2971 //===--------------------------------------------------------------------===//
2972 // Addressing mode description hooks (used by LSR etc).
2973 //
2974
2975 /// CodeGenPrepare sinks address calculations into the same BB as Load/Store
2976 /// instructions reading the address. This allows as much computation as
2977 /// possible to be done in the address mode for that operand. This hook lets
2978 /// targets also pass back when this should be done on intrinsics which
2979 /// load/store.
2980 virtual bool getAddrModeArguments(const IntrinsicInst * /*I*/,
2981 SmallVectorImpl<Value *> & /*Ops*/,
2982 Type *& /*AccessTy*/) const {
2983 return false;
2984 }
2985
2986 /// This represents an addressing mode of:
2987 /// BaseGV + BaseOffs + BaseReg + Scale*ScaleReg + ScalableOffset*vscale
2988 /// If BaseGV is null, there is no BaseGV.
2989 /// If BaseOffs is zero, there is no base offset.
2990 /// If HasBaseReg is false, there is no base register.
2991 /// If Scale is zero, there is no ScaleReg. Scale of 1 indicates a reg with
2992 /// no scale.
2993 /// If ScalableOffset is zero, there is no scalable offset.
2994 struct AddrMode {
2996 int64_t BaseOffs = 0;
2997 bool HasBaseReg = false;
2998 int64_t Scale = 0;
2999 int64_t ScalableOffset = 0;
3000 AddrMode() = default;
3001 };
3002
3003 /// Return true if the addressing mode represented by AM is legal for this
3004 /// target, for a load/store of the specified type.
3005 ///
3006 /// The type may be VoidTy, in which case only return true if the addressing
3007 /// mode is legal for a load/store of any legal type. TODO: Handle
3008 /// pre/postinc as well.
3009 ///
3010 /// If the address space cannot be determined, it will be -1.
3011 ///
3012 /// TODO: Remove default argument
3013 virtual bool isLegalAddressingMode(const DataLayout &DL, const AddrMode &AM,
3014 Type *Ty, unsigned AddrSpace,
3015 Instruction *I = nullptr) const;
3016
3017 /// Returns true if the targets addressing mode can target thread local
3018 /// storage (TLS).
3019 virtual bool addressingModeSupportsTLS(const GlobalValue &) const {
3020 return false;
3021 }
3022
3023 /// Return the prefered common base offset.
3024 virtual int64_t getPreferredLargeGEPBaseOffset(int64_t MinOffset,
3025 int64_t MaxOffset) const {
3026 return 0;
3027 }
3028
3029 /// Return true if the specified immediate is legal icmp immediate, that is
3030 /// the target has icmp instructions which can compare a register against the
3031 /// immediate without having to materialize the immediate into a register.
3032 virtual bool isLegalICmpImmediate(int64_t) const {
3033 return true;
3034 }
3035
3036 /// Return true if the specified immediate is legal add immediate, that is the
3037 /// target has add instructions which can add a register with the immediate
3038 /// without having to materialize the immediate into a register.
3039 virtual bool isLegalAddImmediate(int64_t) const {
3040 return true;
3041 }
3042
3043 /// Return true if adding the specified scalable immediate is legal, that is
3044 /// the target has add instructions which can add a register with the
3045 /// immediate (multiplied by vscale) without having to materialize the
3046 /// immediate into a register.
3047 virtual bool isLegalAddScalableImmediate(int64_t) const { return false; }
3048
3049 /// Return true if the specified immediate is legal for the value input of a
3050 /// store instruction.
3051 virtual bool isLegalStoreImmediate(int64_t Value) const {
3052 // Default implementation assumes that at least 0 works since it is likely
3053 // that a zero register exists or a zero immediate is allowed.
3054 return Value == 0;
3055 }
3056
3057 /// Given a shuffle vector SVI representing a vector splat, return a new
3058 /// scalar type of size equal to SVI's scalar type if the new type is more
3059 /// profitable. Returns nullptr otherwise. For example under MVE float splats
3060 /// are converted to integer to prevent the need to move from SPR to GPR
3061 /// registers.
3063 return nullptr;
3064 }
3065
3066 /// Given a set in interconnected phis of type 'From' that are loaded/stored
3067 /// or bitcast to type 'To', return true if the set should be converted to
3068 /// 'To'.
3069 virtual bool shouldConvertPhiType(Type *From, Type *To) const {
3070 return (From->isIntegerTy() || From->isFloatingPointTy()) &&
3071 (To->isIntegerTy() || To->isFloatingPointTy());
3072 }
3073
3074 /// Returns true if the opcode is a commutative binary operation.
3075 virtual bool isCommutativeBinOp(unsigned Opcode) const {
3076 // FIXME: This should get its info from the td file.
3077 switch (Opcode) {
3078 case ISD::ADD:
3079 case ISD::SMIN:
3080 case ISD::SMAX:
3081 case ISD::UMIN:
3082 case ISD::UMAX:
3083 case ISD::MUL:
3084 case ISD::CLMUL:
3085 case ISD::CLMULH:
3086 case ISD::CLMULR:
3087 case ISD::MULHU:
3088 case ISD::MULHS:
3089 case ISD::SMUL_LOHI:
3090 case ISD::UMUL_LOHI:
3091 case ISD::FADD:
3092 case ISD::FMUL:
3093 case ISD::AND:
3094 case ISD::OR:
3095 case ISD::XOR:
3096 case ISD::SADDO:
3097 case ISD::UADDO:
3098 case ISD::ADDC:
3099 case ISD::ADDE:
3100 case ISD::SADDSAT:
3101 case ISD::UADDSAT:
3102 case ISD::FMINNUM:
3103 case ISD::FMAXNUM:
3104 case ISD::FMINNUM_IEEE:
3105 case ISD::FMAXNUM_IEEE:
3106 case ISD::FMINIMUM:
3107 case ISD::FMAXIMUM:
3108 case ISD::FMINIMUMNUM:
3109 case ISD::FMAXIMUMNUM:
3110 case ISD::AVGFLOORS:
3111 case ISD::AVGFLOORU:
3112 case ISD::AVGCEILS:
3113 case ISD::AVGCEILU:
3114 case ISD::ABDS:
3115 case ISD::ABDU:
3116 return true;
3117 default: return false;
3118 }
3119 }
3120
3121 /// Return true if the node is a math/logic binary operator.
3122 virtual bool isBinOp(unsigned Opcode) const {
3123 // A commutative binop must be a binop.
3124 if (isCommutativeBinOp(Opcode))
3125 return true;
3126 // These are non-commutative binops.
3127 switch (Opcode) {
3128 case ISD::SUB:
3129 case ISD::SHL:
3130 case ISD::SRL:
3131 case ISD::SRA:
3132 case ISD::ROTL:
3133 case ISD::ROTR:
3134 case ISD::SDIV:
3135 case ISD::UDIV:
3136 case ISD::SREM:
3137 case ISD::UREM:
3138 case ISD::SSUBSAT:
3139 case ISD::USUBSAT:
3140 case ISD::FSUB:
3141 case ISD::FDIV:
3142 case ISD::FREM:
3143 case ISD::PSEUDO_FMIN:
3144 case ISD::PSEUDO_FMAX:
3145 return true;
3146 default:
3147 return false;
3148 }
3149 }
3150
3151 /// Return true if it's free to truncate a value of type FromTy to type
3152 /// ToTy. e.g. On x86 it's free to truncate a i32 value in register EAX to i16
3153 /// by referencing its sub-register AX.
3154 /// Targets must return false when FromTy <= ToTy.
3155 virtual bool isTruncateFree(Type *FromTy, Type *ToTy) const {
3156 return false;
3157 }
3158
3159 /// Return true if a truncation from FromTy to ToTy is permitted when deciding
3160 /// whether a call is in tail position. Typically this means that both results
3161 /// would be assigned to the same register or stack slot, but it could mean
3162 /// the target performs adequate checks of its own before proceeding with the
3163 /// tail call. Targets must return false when FromTy <= ToTy.
3164 virtual bool allowTruncateForTailCall(Type *FromTy, Type *ToTy) const {
3165 return false;
3166 }
3167
3168 virtual bool isTruncateFree(EVT FromVT, EVT ToVT) const { return false; }
3169 virtual bool isTruncateFree(LLT FromTy, LLT ToTy, LLVMContext &Ctx) const {
3170 return isTruncateFree(getApproximateEVTForLLT(FromTy, Ctx),
3171 getApproximateEVTForLLT(ToTy, Ctx));
3172 }
3173
3174 /// Return true if truncating the specific node Val to type VT2 is free.
3175 virtual bool isTruncateFree(SDValue Val, EVT VT2) const {
3176 // Fallback to type matching.
3177 return isTruncateFree(Val.getValueType(), VT2);
3178 }
3179
3180 virtual bool isProfitableToHoist(Instruction *I) const { return true; }
3181
3182 /// Return true if the extension represented by \p I is free.
3183 /// Unlikely the is[Z|FP]ExtFree family which is based on types,
3184 /// this method can use the context provided by \p I to decide
3185 /// whether or not \p I is free.
3186 /// This method extends the behavior of the is[Z|FP]ExtFree family.
3187 /// In other words, if is[Z|FP]Free returns true, then this method
3188 /// returns true as well. The converse is not true.
3189 /// The target can perform the adequate checks by overriding isExtFreeImpl.
3190 /// \pre \p I must be a sign, zero, or fp extension.
3191 bool isExtFree(const Instruction *I) const {
3192 switch (I->getOpcode()) {
3193 case Instruction::FPExt:
3194 if (isFPExtFree(EVT::getEVT(I->getType()),
3195 EVT::getEVT(I->getOperand(0)->getType())))
3196 return true;
3197 break;
3198 case Instruction::ZExt:
3199 if (isZExtFree(I->getOperand(0)->getType(), I->getType()))
3200 return true;
3201 break;
3202 case Instruction::SExt:
3203 break;
3204 default:
3205 llvm_unreachable("Instruction is not an extension");
3206 }
3207 return isExtFreeImpl(I);
3208 }
3209
3210 /// Return true if \p Load and \p Ext can form an ExtLoad.
3211 /// For example, in AArch64
3212 /// %L = load i8, i8* %ptr
3213 /// %E = zext i8 %L to i32
3214 /// can be lowered into one load instruction
3215 /// ldrb w0, [x0]
3216 bool isExtLoad(const LoadInst *Load, const Instruction *Ext,
3217 const DataLayout &DL) const {
3218 EVT VT = getValueType(DL, Ext->getType());
3219 EVT LoadVT = getValueType(DL, Load->getType());
3220
3221 // If the load has other users and the truncate is not free, the ext
3222 // probably isn't free.
3223 if (!Load->hasOneUse() && (isTypeLegal(LoadVT) || !isTypeLegal(VT)) &&
3224 !isTruncateFree(Ext->getType(), Load->getType()))
3225 return false;
3226
3227 // Check whether the target supports casts folded into loads.
3228 unsigned LType;
3229 if (isa<ZExtInst>(Ext))
3230 LType = ISD::ZEXTLOAD;
3231 else {
3232 assert(isa<SExtInst>(Ext) && "Unexpected ext type!");
3233 LType = ISD::SEXTLOAD;
3234 }
3235
3236 return isLoadLegal(VT, LoadVT, Load->getAlign(),
3237 Load->getPointerAddressSpace(), LType, false);
3238 }
3239
3240 /// Return true if any actual instruction that defines a value of type FromTy
3241 /// implicitly zero-extends the value to ToTy in the result register.
3242 ///
3243 /// The function should return true when it is likely that the truncate can
3244 /// be freely folded with an instruction defining a value of FromTy. If
3245 /// the defining instruction is unknown (because you're looking at a
3246 /// function argument, PHI, etc.) then the target may require an
3247 /// explicit truncate, which is not necessarily free, but this function
3248 /// does not deal with those cases.
3249 /// Targets must return false when FromTy >= ToTy.
3250 virtual bool isZExtFree(Type *FromTy, Type *ToTy) const {
3251 return false;
3252 }
3253
3254 virtual bool isZExtFree(EVT FromTy, EVT ToTy) const { return false; }
3255 virtual bool isZExtFree(LLT FromTy, LLT ToTy, LLVMContext &Ctx) const {
3256 return isZExtFree(getApproximateEVTForLLT(FromTy, Ctx),
3257 getApproximateEVTForLLT(ToTy, Ctx));
3258 }
3259
3260 /// Return true if zero-extending the specific node Val to type VT2 is free
3261 /// (either because it's implicitly zero-extended such as ARM ldrb / ldrh or
3262 /// because it's folded such as X86 zero-extending loads).
3263 virtual bool isZExtFree(SDValue Val, EVT VT2) const {
3264 return isZExtFree(Val.getValueType(), VT2);
3265 }
3266
3267 /// Return true is an anyext is free from FromTy to ToTy. Usually true for
3268 /// scalar types when not trying to pack elements into vector lanes.
3269 virtual bool isAnyExtFree(EVT FromTy, EVT ToTy) const {
3270 return !FromTy.isVector();
3271 }
3272
3273 /// Return true if sign-extension from FromTy to ToTy is cheaper than
3274 /// zero-extension.
3275 virtual bool isSExtCheaperThanZExt(EVT FromTy, EVT ToTy) const {
3276 return false;
3277 }
3278
3279 /// Return true if this constant should be sign extended when promoting to
3280 /// a larger type.
3281 virtual bool signExtendConstant(const ConstantInt *C) const { return false; }
3282
3283 /// Try to optimize extending or truncating conversion instructions (like
3284 /// zext, trunc, fptoui, uitofp) for the target.
3285 virtual bool
3287 const TargetTransformInfo &TTI) const {
3288 return false;
3289 }
3290
3291 /// Return true if the target supplies and combines to a paired load
3292 /// two loaded values of type LoadedType next to each other in memory.
3293 /// RequiredAlignment gives the minimal alignment constraints that must be met
3294 /// to be able to select this paired load.
3295 ///
3296 /// This information is *not* used to generate actual paired loads, but it is
3297 /// used to generate a sequence of loads that is easier to combine into a
3298 /// paired load.
3299 /// For instance, something like this:
3300 /// a = load i64* addr
3301 /// b = trunc i64 a to i32
3302 /// c = lshr i64 a, 32
3303 /// d = trunc i64 c to i32
3304 /// will be optimized into:
3305 /// b = load i32* addr1
3306 /// d = load i32* addr2
3307 /// Where addr1 = addr2 +/- sizeof(i32).
3308 ///
3309 /// In other words, unless the target performs a post-isel load combining,
3310 /// this information should not be provided because it will generate more
3311 /// loads.
3312 virtual bool hasPairedLoad(EVT /*LoadedType*/,
3313 Align & /*RequiredAlignment*/) const {
3314 return false;
3315 }
3316
3317 /// Return true if the target has a vector blend instruction.
3318 virtual bool hasVectorBlend() const { return false; }
3319
3320 /// Get the maximum supported factor for interleaved memory accesses.
3321 /// Default to be the minimum interleave factor: 2.
3322 virtual unsigned getMaxSupportedInterleaveFactor() const { return 2; }
3323
3324 /// Lower an interleaved load to target specific intrinsics. Return
3325 /// true on success.
3326 ///
3327 /// \p Load is the vector load instruction. Can be either a plain load
3328 /// instruction or a vp.load intrinsic.
3329 /// \p Mask is a per-segment (i.e. number of lanes equal to that of one
3330 /// component being interwoven) mask. Can be nullptr, in which case the
3331 /// result is uncondiitional.
3332 /// \p Shuffles is the shufflevector list to DE-interleave the loaded vector.
3333 /// \p Indices is the corresponding indices for each shufflevector.
3334 /// \p Factor is the interleave factor.
3335 /// \p GapMask is a mask with zeros for components / fields that may not be
3336 /// accessed.
3339 ArrayRef<unsigned> Indices, unsigned Factor,
3340 const APInt &GapMask) const {
3341 return false;
3342 }
3343
3344 /// Lower an interleaved store to target specific intrinsics. Return
3345 /// true on success.
3346 ///
3347 /// \p SI is the vector store instruction. Can be either a plain store
3348 /// or a vp.store.
3349 /// \p Mask is a per-segment (i.e. number of lanes equal to that of one
3350 /// component being interwoven) mask. Can be nullptr, in which case the
3351 /// result is unconditional.
3352 /// \p SVI is the shufflevector to RE-interleave the stored vector.
3353 /// \p Factor is the interleave factor.
3354 /// \p GapMask is a mask with zeros for components / fields that may not be
3355 /// accessed.
3357 ShuffleVectorInst *SVI, unsigned Factor,
3358 const APInt &GapMask) const {
3359 return false;
3360 }
3361
3362 /// Lower a deinterleave intrinsic to a target specific load intrinsic.
3363 /// Return true on success. Currently only supports
3364 /// llvm.vector.deinterleave{2,3,5,7}
3365 ///
3366 /// \p Load is the accompanying load instruction. Can be either a plain load
3367 /// instruction or a vp.load intrinsic.
3368 /// \p DI represents the deinterleaveN intrinsic.
3369 /// \p GapMask is a mask with zeros for components / fields that may not be
3370 /// accessed.
3372 IntrinsicInst *DI,
3373 const APInt &GapMask) const {
3374 return false;
3375 }
3376
3377 /// Lower an interleave intrinsic to a target specific store intrinsic.
3378 /// Return true on success. Currently only supports
3379 /// llvm.vector.interleave{2,3,5,7}
3380 ///
3381 /// \p Store is the accompanying store instruction. Can be either a plain
3382 /// store or a vp.store intrinsic.
3383 /// \p Mask is a per-segment (i.e. number of lanes equal to that of one
3384 /// component being interwoven) mask. Can be nullptr, in which case the
3385 /// result is uncondiitional.
3386 /// \p InterleaveValues contains the interleaved values.
3387 virtual bool
3389 ArrayRef<Value *> InterleaveValues) const {
3390 return false;
3391 }
3392
3393 /// Return true if an fpext operation is free (for instance, because
3394 /// single-precision floating-point numbers are implicitly extended to
3395 /// double-precision).
3396 virtual bool isFPExtFree(EVT DestVT, EVT SrcVT) const {
3397 assert(SrcVT.isFloatingPoint() && DestVT.isFloatingPoint() &&
3398 "invalid fpext types");
3399 return false;
3400 }
3401
3402 /// Return true if an fpext operation input to an \p Opcode operation is free
3403 /// (for instance, because half-precision floating-point numbers are
3404 /// implicitly extended to float-precision) for an FMA instruction.
3405 virtual bool isFPExtFoldable(const MachineInstr &MI, unsigned Opcode,
3406 LLT DestTy, LLT SrcTy) const {
3407 return false;
3408 }
3409
3410 /// Return true if an fpext operation input to an \p Opcode operation is free
3411 /// (for instance, because half-precision floating-point numbers are
3412 /// implicitly extended to float-precision) for an FMA instruction.
3413 virtual bool isFPExtFoldable(const SelectionDAG &DAG, unsigned Opcode,
3414 EVT DestVT, EVT SrcVT) const {
3415 assert(DestVT.isFloatingPoint() && SrcVT.isFloatingPoint() &&
3416 "invalid fpext types");
3417 return isFPExtFree(DestVT, SrcVT);
3418 }
3419
3420 /// Return true if folding a vector load into ExtVal (a sign, zero, or any
3421 /// extend node) is profitable.
3422 virtual bool isVectorLoadExtDesirable(SDValue ExtVal) const { return false; }
3423
3424 /// Return true if an fneg operation is free to the point where it is never
3425 /// worthwhile to replace it with a bitwise operation.
3426 virtual bool isFNegFree(EVT VT) const {
3427 assert(VT.isFloatingPoint());
3428 return false;
3429 }
3430
3431 /// Return true if an fabs operation is free to the point where it is never
3432 /// worthwhile to replace it with a bitwise operation.
3433 virtual bool isFAbsFree(EVT VT) const {
3434 assert(VT.isFloatingPoint());
3435 return false;
3436 }
3437
3438 /// Return true if an FMA operation is faster than a pair of fmul and fadd
3439 /// instructions. fmuladd intrinsics will be expanded to FMAs when this method
3440 /// returns true, otherwise fmuladd is expanded to fmul + fadd.
3441 ///
3442 /// NOTE: This may be called before legalization on types for which FMAs are
3443 /// not legal, but should return true if those types will eventually legalize
3444 /// to types that support FMAs. After legalization, it will only be called on
3445 /// types that support FMAs (via Legal or Custom actions)
3446 ///
3447 /// Targets that care about soft float support should return false when soft
3448 /// float code is being generated (i.e. use-soft-float).
3450 EVT) const {
3451 return false;
3452 }
3453
3454 /// Return true if an FMA operation is faster than a pair of fmul and fadd
3455 /// instructions. fmuladd intrinsics will be expanded to FMAs when this method
3456 /// returns true, otherwise fmuladd is expanded to fmul + fadd.
3457 ///
3458 /// NOTE: This may be called before legalization on types for which FMAs are
3459 /// not legal, but should return true if those types will eventually legalize
3460 /// to types that support FMAs. After legalization, it will only be called on
3461 /// types that support FMAs (via Legal or Custom actions)
3463 LLT) const {
3464 return false;
3465 }
3466
3467 /// IR version
3468 virtual bool isFMAFasterThanFMulAndFAdd(const Function &F, Type *) const {
3469 return false;
3470 }
3471
3472 /// Returns true if \p MI can be combined with another instruction to
3473 /// form TargetOpcode::G_FMAD. \p N may be an TargetOpcode::G_FADD,
3474 /// TargetOpcode::G_FSUB, or an TargetOpcode::G_FMUL which will be
3475 /// distributed into an fadd/fsub.
3476 virtual bool isFMADLegal(const MachineInstr &MI, LLT Ty) const {
3477 assert((MI.getOpcode() == TargetOpcode::G_FADD ||
3478 MI.getOpcode() == TargetOpcode::G_FSUB ||
3479 MI.getOpcode() == TargetOpcode::G_FMUL) &&
3480 "unexpected node in FMAD forming combine");
3481 switch (Ty.getScalarSizeInBits()) {
3482 case 16:
3483 return isOperationLegal(TargetOpcode::G_FMAD, MVT::f16);
3484 case 32:
3485 return isOperationLegal(TargetOpcode::G_FMAD, MVT::f32);
3486 case 64:
3487 return isOperationLegal(TargetOpcode::G_FMAD, MVT::f64);
3488 default:
3489 break;
3490 }
3491
3492 return false;
3493 }
3494
3495 /// Returns true if be combined with to form an ISD::FMAD. \p N may be an
3496 /// ISD::FADD, ISD::FSUB, or an ISD::FMUL which will be distributed into an
3497 /// fadd/fsub.
3498 virtual bool isFMADLegal(const SelectionDAG &DAG, const SDNode *N) const {
3499 assert((N->getOpcode() == ISD::FADD || N->getOpcode() == ISD::FSUB ||
3500 N->getOpcode() == ISD::FMUL) &&
3501 "unexpected node in FMAD forming combine");
3502 return isOperationLegal(ISD::FMAD, N->getValueType(0));
3503 }
3504
3505 // Return true when the decision to generate FMA's (or FMS, FMLA etc) rather
3506 // than FMUL and ADD is delegated to the machine combiner.
3508 CodeGenOptLevel OptLevel) const {
3509 return false;
3510 }
3511
3512 /// Return true if it's profitable to narrow operations of type SrcVT to
3513 /// DestVT. e.g. on x86, it's profitable to narrow from i32 to i8 but not from
3514 /// i32 to i16.
3515 virtual bool isNarrowingProfitable(SDNode *N, EVT SrcVT, EVT DestVT) const {
3516 return false;
3517 }
3518
3519 /// Return true if pulling a binary operation into a select with an identity
3520 /// constant is profitable. This is the inverse of an IR transform.
3521 /// Example: X + (Cond ? Y : 0) --> Cond ? (X + Y) : X
3522 virtual bool shouldFoldSelectWithIdentityConstant(unsigned BinOpcode, EVT VT,
3523 unsigned SelectOpcode,
3524 SDValue X,
3525 SDValue Y) const {
3526 return false;
3527 }
3528
3529 /// Return true if it is beneficial to convert a load of a constant to
3530 /// just the constant itself.
3531 /// On some targets it might be more efficient to use a combination of
3532 /// arithmetic instructions to materialize the constant instead of loading it
3533 /// from a constant pool.
3535 Type *Ty) const {
3536 return false;
3537 }
3538
3539 /// Return the cost of extracting a subvector of type \p ResVT from a vector
3540 /// of type \p SrcVT, starting at element \p Index.
3541 ///
3542 /// Most callers only create a new EXTRACT_SUBVECTOR when the cost is at most
3543 /// ExtractSubvectorCost::Cheap. This hook exists because EXTRACT_SUBVECTOR
3544 /// usually has custom lowering that depends on the index of the first
3545 /// element, so only the target knows which lowering is cheap.
3547 unsigned Index) const {
3549 }
3550
3551 /// Try to convert an extract element of a vector binary operation into an
3552 /// extract element followed by a scalar operation.
3553 virtual bool shouldScalarizeBinop(SDValue VecOp) const {
3554 return false;
3555 }
3556
3557 /// Return true if extraction of a scalar element from the given vector type
3558 /// at the given index is cheap. For example, if scalar operations occur on
3559 /// the same register file as vector operations, then an extract element may
3560 /// be a sub-register rename rather than an actual instruction.
3561 virtual bool isExtractVecEltCheap(EVT VT, unsigned Index) const {
3562 return false;
3563 }
3564
3565 /// Try to convert math with an overflow comparison into the corresponding DAG
3566 /// node operation. Targets may want to override this independently of whether
3567 /// the operation is legal/custom for the given type because it may obscure
3568 /// matching of other patterns.
3569 virtual bool shouldFormOverflowOp(unsigned Opcode, EVT VT,
3570 bool MathUsed) const {
3571 // Form it if it is legal.
3572 if (isOperationLegal(Opcode, VT))
3573 return true;
3574
3575 // TODO: The default logic is inherited from code in CodeGenPrepare.
3576 // The opcode should not make a difference by default?
3577 if (Opcode != ISD::UADDO)
3578 return false;
3579
3580 // Allow the transform as long as we have an integer type that is not
3581 // obviously illegal and unsupported and if the math result is used
3582 // besides the overflow check. On some targets (e.g. SPARC), it is
3583 // not profitable to form on overflow op if the math result has no
3584 // concrete users.
3585 if (VT.isVector())
3586 return false;
3587 return MathUsed && (VT.isSimple() || !isOperationExpand(Opcode, VT));
3588 }
3589
3590 // Return true if the target wants to optimize the mul overflow intrinsic
3591 // for the given \p VT.
3593 EVT VT) const {
3594 return false;
3595 }
3596
3597 // Return true if it is profitable to use a scalar input to a BUILD_VECTOR
3598 // even if the vector itself has multiple uses.
3599 virtual bool aggressivelyPreferBuildVectorSources(EVT VecVT) const {
3600 return false;
3601 }
3602
3603 // Return true if CodeGenPrepare should consider splitting large offset of a
3604 // GEP to make the GEP fit into the addressing mode and can be sunk into the
3605 // same blocks of its users.
3606 virtual bool shouldConsiderGEPOffsetSplit() const { return false; }
3607
3608 /// Return true if creating a shift of the type by the given
3609 /// amount is not profitable.
3610 virtual bool shouldAvoidTransformToShift(EVT VT, unsigned Amount) const {
3611 return false;
3612 }
3613
3614 // Should we fold (select_cc seteq (and x, y), 0, 0, A) -> (and (sra (shl x))
3615 // A) where y has a single bit set?
3617 const APInt &AndMask) const {
3618 unsigned ShCt = AndMask.getBitWidth() - 1;
3619 return !shouldAvoidTransformToShift(VT, ShCt);
3620 }
3621
3622 /// Does this target require the clearing of high-order bits in a register
3623 /// passed to the fp16 to fp conversion library function.
3624 virtual bool shouldKeepZExtForFP16Conv() const { return false; }
3625
3626 /// Should we generate fp_to_si_sat and fp_to_ui_sat from type FPVT to type
3627 /// VT. Used when folding idioms into a saturating fp-to-int conversion, such
3628 /// as min(max(fptoi)) clamps or NaN-guarded selects.
3629 virtual bool shouldConvertFpToSat(unsigned Op, EVT FPVT, EVT VT) const {
3630 return isOperationLegalOrCustom(Op, VT);
3631 }
3632
3633 /// Should we prefer selects to doing arithmetic on boolean types
3635 return false;
3636 }
3637
3638 /// True if target has some particular form of dealing with pointer arithmetic
3639 /// semantics for pointers with the given value type. False if pointer
3640 /// arithmetic should not be preserved for passes such as instruction
3641 /// selection, and can fallback to regular arithmetic.
3642 /// This should be removed when PTRADD nodes are widely supported by backends.
3643 virtual bool shouldPreservePtrArith(const Function &F, EVT PtrVT) const {
3644 return false;
3645 }
3646
3647 /// True if the target allows transformations of in-bounds pointer
3648 /// arithmetic that cause out-of-bounds intermediate results.
3650 EVT PtrVT) const {
3651 return false;
3652 }
3653
3654 /// Does this target support complex deinterleaving
3655 virtual bool isComplexDeinterleavingSupported() const { return false; }
3656
3657 /// Does this target support complex deinterleaving with the given operation
3658 /// and type
3661 return false;
3662 }
3663
3664 // Get the preferred opcode for FP_TO_XINT nodes.
3665 // By default, this checks if the provded operation is an illegal FP_TO_UINT
3666 // and if so, checks if FP_TO_SINT is legal or custom for use as a
3667 // replacement. If both UINT and SINT conversions are Custom, we choose SINT
3668 // by default because that's the right thing on PPC.
3669 virtual unsigned getPreferredFPToIntOpcode(unsigned Op, EVT FromVT,
3670 EVT ToVT) const {
3671 if (isOperationLegal(Op, ToVT))
3672 return Op;
3673 switch (Op) {
3674 case ISD::FP_TO_UINT:
3676 return ISD::FP_TO_SINT;
3677 break;
3681 break;
3682 default:
3683 break;
3684 }
3685 return Op;
3686 }
3687
3688 /// Create the IR node for the given complex deinterleaving operation.
3689 /// If one cannot be created using all the given inputs, nullptr should be
3690 /// returned.
3693 ComplexDeinterleavingRotation Rotation, Value *InputA, Value *InputB,
3694 Value *Accumulator = nullptr) const {
3695 return nullptr;
3696 }
3697
3699 return RuntimeLibcallInfo;
3700 }
3701
3702 const LibcallLoweringInfo &getLibcallLoweringInfo() const { return Libcalls; }
3703
3704 void setLibcallImpl(RTLIB::Libcall Call, RTLIB::LibcallImpl Impl) {
3705 Libcalls.setLibcallImpl(Call, Impl);
3706 }
3707
3708 /// Get the libcall impl routine name for the specified libcall.
3709 RTLIB::LibcallImpl getLibcallImpl(RTLIB::Libcall Call) const {
3710 return Libcalls.getLibcallImpl(Call);
3711 }
3712
3713 /// Get the libcall routine name for the specified libcall.
3714 // FIXME: This should be removed. Only LibcallImpl should have a name.
3715 const char *getLibcallName(RTLIB::Libcall Call) const {
3716 return Libcalls.getLibcallName(Call);
3717 }
3718
3719 /// Get the libcall routine name for the specified libcall implementation
3723
3724 RTLIB::LibcallImpl getMemcpyImpl() const { return Libcalls.getMemcpyImpl(); }
3725
3726 /// Check if this is valid libcall for the current module, otherwise
3727 /// RTLIB::Unsupported.
3728 RTLIB::LibcallImpl getSupportedLibcallImpl(StringRef FuncName) const {
3729 return RuntimeLibcallInfo.getSupportedLibcallImpl(FuncName);
3730 }
3731
3732 /// Get the CallingConv that should be used for the specified libcall
3733 /// implementation.
3735 return Libcalls.getLibcallImplCallingConv(Call);
3736 }
3737
3738 /// Get the CallingConv that should be used for the specified libcall.
3739 // FIXME: Remove this wrapper and directly use the used LibcallImpl
3741 return Libcalls.getLibcallCallingConv(Call);
3742 }
3743
3744 /// Execute target specific actions to finalize target lowering.
3745 /// This is used to set extra flags in MachineFrameInformation and freezing
3746 /// the set of reserved registers.
3747 /// The default implementation just freezes the set of reserved registers.
3748 virtual void finalizeLowering(MachineFunction &MF) const;
3749
3750 /// Returns true if it's profitable to allow merging store of loads when there
3751 /// are functions calls between the load and the store.
3752 virtual bool shouldMergeStoreOfLoadsOverCall(EVT, EVT) const { return true; }
3753
3754 //===----------------------------------------------------------------------===//
3755 // GlobalISel Hooks
3756 //===----------------------------------------------------------------------===//
3757 /// Check whether or not \p MI needs to be moved close to its uses.
3758 virtual bool shouldLocalize(const MachineInstr &MI, const TargetTransformInfo *TTI) const;
3759
3760
3761private:
3762 const TargetMachine &TM;
3763
3764 /// Tells the code generator that the target has BitExtract instructions.
3765 /// The code generator will aggressively sink "shift"s into the blocks of
3766 /// their users if the users will generate "and" instructions which can be
3767 /// combined with "shift" to BitExtract instructions.
3768 bool HasExtractBitsInsn;
3769
3770 /// Tells the code generator to bypass slow divide or remainder
3771 /// instructions. For example, BypassSlowDivWidths[32,8] tells the code
3772 /// generator to bypass 32-bit integer div/rem with an 8-bit unsigned integer
3773 /// div/rem when the operands are positive and less than 256.
3774 DenseMap <unsigned int, unsigned int> BypassSlowDivWidths;
3775
3776 /// Tells the code generator that it shouldn't generate extra flow control
3777 /// instructions and should attempt to combine flow control instructions via
3778 /// predication.
3779 bool JumpIsExpensive;
3780
3781 /// Information about the contents of the high-bits in boolean values held in
3782 /// a type wider than i1. See getBooleanContents.
3783 BooleanContent BooleanContents;
3784
3785 /// Information about the contents of the high-bits in boolean values held in
3786 /// a type wider than i1. See getBooleanContents.
3787 BooleanContent BooleanFloatContents;
3788
3789 /// Information about the contents of the high-bits in boolean vector values
3790 /// when the element type is wider than i1. See getBooleanContents.
3791 BooleanContent BooleanVectorContents;
3792
3793 /// The target scheduling preference: shortest possible total cycles or lowest
3794 /// register usage.
3795 Sched::Preference SchedPreferenceInfo;
3796
3797 /// The minimum alignment that any argument on the stack needs to have.
3798 Align MinStackArgumentAlignment;
3799
3800 /// The minimum function alignment (used when optimizing for size, and to
3801 /// prevent explicitly provided alignment from leading to incorrect code).
3802 Align MinFunctionAlignment;
3803
3804 /// The preferred function alignment (used when alignment unspecified and
3805 /// optimizing for speed).
3806 Align PrefFunctionAlignment;
3807
3808 /// The preferred loop alignment (in log2 bot in bytes).
3809 Align PrefLoopAlignment;
3810 /// The maximum amount of bytes permitted to be emitted for alignment.
3811 unsigned MaxBytesForAlignment;
3812
3813 /// Size in bits of the maximum atomics size the backend supports.
3814 /// Accesses larger than this will be expanded by AtomicExpandPass.
3815 unsigned MaxAtomicSizeInBitsSupported;
3816
3817 /// Size in bits of the maximum div/rem size the backend supports.
3818 /// Larger operations will be expanded by ExpandIRInsts.
3819 unsigned MaxDivRemBitWidthSupported;
3820
3821 /// Size in bits of the maximum fp to/from int conversion size the
3822 /// backend supports. Larger operations will be expanded by
3823 /// ExpandIRInsts.
3824 unsigned MaxLargeFPConvertBitWidthSupported;
3825
3826 /// Size in bits of the minimum cmpxchg or ll/sc operation the
3827 /// backend supports.
3828 unsigned MinCmpXchgSizeInBits;
3829
3830 /// The minimum of largest number of comparisons to use bit test for switch.
3831 unsigned MinimumBitTestCmps;
3832
3833 /// Maximum known-legal store size, which can be guaranteed for scalable
3834 /// vectors.
3835 unsigned MaximumLegalStoreInBits;
3836
3837 /// This indicates if the target supports unaligned atomic operations.
3838 bool SupportsUnalignedAtomics;
3839
3840 /// If set to a physical register, this specifies the register that
3841 /// llvm.savestack/llvm.restorestack should save and restore.
3842 Register StackPointerRegisterToSaveRestore;
3843
3844 /// This indicates the default register class to use for each ValueType the
3845 /// target supports natively.
3846 const TargetRegisterClass *RegClassForVT[MVT::VALUETYPE_SIZE];
3847 uint16_t NumRegistersForVT[MVT::VALUETYPE_SIZE];
3848 MVT RegisterTypeForVT[MVT::VALUETYPE_SIZE];
3849
3850 /// This indicates the "representative" register class to use for each
3851 /// ValueType the target supports natively. This information is used by the
3852 /// scheduler to track register pressure. By default, the representative
3853 /// register class is the largest legal super-reg register class of the
3854 /// register class of the specified type. e.g. On x86, i8, i16, and i32's
3855 /// representative class would be GR32.
3856 const TargetRegisterClass *RepRegClassForVT[MVT::VALUETYPE_SIZE] = {nullptr};
3857
3858 /// This indicates the "cost" of the "representative" register class for each
3859 /// ValueType. The cost is used by the scheduler to approximate register
3860 /// pressure.
3861 uint8_t RepRegClassCostForVT[MVT::VALUETYPE_SIZE];
3862
3863 /// For any value types we are promoting or expanding, this contains the value
3864 /// type that we are changing to. For Expanded types, this contains one step
3865 /// of the expand (e.g. i64 -> i32), even if there are multiple steps required
3866 /// (e.g. i64 -> i16). For types natively supported by the system, this holds
3867 /// the same type (e.g. i32 -> i32).
3868 MVT TransformToType[MVT::VALUETYPE_SIZE];
3869
3870 /// For each operation and each value type, keep a LegalizeAction that
3871 /// indicates how instruction selection should deal with the operation. Most
3872 /// operations are Legal (aka, supported natively by the target), but
3873 /// operations that are not should be described. Note that operations on
3874 /// non-legal value types are not described here.
3875 LegalizeAction OpActions[MVT::VALUETYPE_SIZE][ISD::BUILTIN_OP_END];
3876
3877 /// For each load extension type and each value type, keep a LegalizeAction
3878 /// that indicates how instruction selection should deal with a load of a
3879 /// specific value type and extension type. Uses 4-bits to store the action
3880 /// for each of the 4 load ext types.
3881 uint16_t LoadExtActions[MVT::VALUETYPE_SIZE][MVT::VALUETYPE_SIZE];
3882
3883 /// Similar to LoadExtActions, but for atomic loads. Only Legal or Expand
3884 /// (default) values are supported.
3885 uint16_t AtomicLoadExtActions[MVT::VALUETYPE_SIZE][MVT::VALUETYPE_SIZE];
3886
3887 /// For each value type pair keep a LegalizeAction that indicates whether a
3888 /// truncating store of a specific value type and truncating type is legal.
3889 LegalizeAction TruncStoreActions[MVT::VALUETYPE_SIZE][MVT::VALUETYPE_SIZE];
3890
3891 /// For each indexed mode and each value type, keep a quad of LegalizeAction
3892 /// that indicates how instruction selection should deal with the load /
3893 /// store / maskedload / maskedstore.
3894 ///
3895 /// The first dimension is the value_type for the reference. The second
3896 /// dimension represents the various modes for load store.
3897 uint16_t IndexedModeActions[MVT::VALUETYPE_SIZE][ISD::LAST_INDEXED_MODE];
3898
3899 /// For each condition code (ISD::CondCode) keep a LegalizeAction that
3900 /// indicates how instruction selection should deal with the condition code.
3901 ///
3902 /// Because each CC action takes up 4 bits, we need to have the array size be
3903 /// large enough to fit all of the value types. This can be done by rounding
3904 /// up the MVT::VALUETYPE_SIZE value to the next multiple of 8.
3905 uint32_t CondCodeActions[ISD::SETCC_INVALID][(MVT::VALUETYPE_SIZE + 7) / 8];
3906
3907 using PartialReduceActionTypes =
3908 std::tuple<unsigned, MVT::SimpleValueType, MVT::SimpleValueType>;
3909 /// For each partial reduce opcode, result type and input type combination,
3910 /// keep a LegalizeAction which indicates how instruction selection should
3911 /// deal with this operation.
3912 DenseMap<PartialReduceActionTypes, LegalizeAction> PartialReduceMLAActions;
3913
3914 ValueTypeActionImpl ValueTypeActions;
3915
3916private:
3917 /// Targets can specify ISD nodes that they would like PerformDAGCombine
3918 /// callbacks for by calling setTargetDAGCombine(), which sets a bit in this
3919 /// array.
3920 unsigned char
3921 TargetDAGCombineArray[(ISD::BUILTIN_OP_END+CHAR_BIT-1)/CHAR_BIT];
3922
3923 /// For operations that must be promoted to a specific type, this holds the
3924 /// destination type. This map should be sparse, so don't hold it as an
3925 /// array.
3926 ///
3927 /// Targets add entries to this map with AddPromotedToType(..), clients access
3928 /// this with getTypeToPromoteTo(..).
3929 std::map<std::pair<unsigned, MVT::SimpleValueType>, MVT::SimpleValueType>
3930 PromoteToType;
3931
3932 /// FIXME: This should not live here; it should come from an analysis.
3933 const RTLIB::RuntimeLibcallsInfo RuntimeLibcallInfo;
3934
3935 /// The list of libcalls that the target will use.
3936 /// FIXME: This should not live here; it should come from an analysis.
3937 LibcallLoweringInfo Libcalls;
3938
3939 /// The bits of IndexedModeActions used to store the legalisation actions
3940 /// We store the data as | ML | MS | L | S | each taking 4 bits.
3941 enum IndexedModeActionsBits {
3942 IMAB_Store = 0,
3943 IMAB_Load = 4,
3944 IMAB_MaskedStore = 8,
3945 IMAB_MaskedLoad = 12
3946 };
3947
3948 void setIndexedModeAction(unsigned IdxMode, MVT VT, unsigned Shift,
3949 LegalizeAction Action) {
3950 assert(VT.isValid() && IdxMode < ISD::LAST_INDEXED_MODE &&
3951 (unsigned)Action < 0xf && "Table isn't big enough!");
3952 unsigned Ty = (unsigned)VT.SimpleTy;
3953 IndexedModeActions[Ty][IdxMode] &= ~(0xf << Shift);
3954 IndexedModeActions[Ty][IdxMode] |= ((uint16_t)Action) << Shift;
3955 }
3956
3957 LegalizeAction getIndexedModeAction(unsigned IdxMode, MVT VT,
3958 unsigned Shift) const {
3959 assert(IdxMode < ISD::LAST_INDEXED_MODE && VT.isValid() &&
3960 "Table isn't big enough!");
3961 unsigned Ty = (unsigned)VT.SimpleTy;
3962 return (LegalizeAction)((IndexedModeActions[Ty][IdxMode] >> Shift) & 0xf);
3963 }
3964
3965 unsigned getVectorTypeBreakdownImpl(LLVMContext &Context, EVT VT,
3966 EVT &IntermediateVT,
3967 unsigned &NumIntermediates,
3968 MVT &RegisterVT,
3969 bool ForCallingConv) const;
3970
3971 unsigned getVectorTypeBreakdownMVT(MVT VT, MVT &IntermediateVT,
3972 unsigned &NumIntermediates,
3973 MVT &RegisterVT);
3974
3975 /// Return the type of registers that this ValueType will eventually require.
3976 MVT getCachedRegisterType(MVT VT) const {
3977 assert((unsigned)VT.SimpleTy < std::size(RegisterTypeForVT));
3978 return RegisterTypeForVT[VT.SimpleTy];
3979 }
3980
3981 MVT getRegisterTypeImpl(LLVMContext &Context, EVT VT,
3982 bool ForCallingConv) const {
3983 if (VT.isSimple() &&
3984 !shouldUseDynamicVectorTypeBreakdown(VT, ForCallingConv))
3985 return getCachedRegisterType(VT.getSimpleVT());
3986 if (VT.isVector()) {
3987 EVT VT1;
3988 MVT RegisterVT;
3989 unsigned NumIntermediates;
3990 (void)getVectorTypeBreakdownImpl(Context, VT, VT1, NumIntermediates,
3991 RegisterVT, ForCallingConv);
3992 return RegisterVT;
3993 }
3994 if (VT.isInteger()) {
3995 return getRegisterTypeImpl(Context, getTypeToTransformTo(Context, VT),
3996 ForCallingConv);
3997 }
3998 llvm_unreachable("Unsupported extended type!");
3999 }
4000
4001 unsigned getNumRegistersImpl(LLVMContext &Context, EVT VT,
4002 bool ForCallingConv) const {
4003 if (VT.isSimple() &&
4004 !shouldUseDynamicVectorTypeBreakdown(VT, ForCallingConv)) {
4005 assert((unsigned)VT.getSimpleVT().SimpleTy <
4006 std::size(NumRegistersForVT));
4007 return NumRegistersForVT[VT.getSimpleVT().SimpleTy];
4008 }
4009 if (VT.isVector()) {
4010 EVT VT1;
4011 MVT VT2;
4012 unsigned NumIntermediates;
4013 return getVectorTypeBreakdownImpl(Context, VT, VT1, NumIntermediates, VT2,
4014 ForCallingConv);
4015 }
4016 if (VT.isInteger()) {
4017 unsigned BitWidth = VT.getSizeInBits();
4018 unsigned RegWidth =
4019 getRegisterTypeImpl(Context, VT, ForCallingConv).getSizeInBits();
4020 return (BitWidth + RegWidth - 1) / RegWidth;
4021 }
4022 llvm_unreachable("Unsupported extended type!");
4023 }
4024
4025protected:
4026 /// Return true if the extension represented by \p I is free.
4027 /// \pre \p I is a sign, zero, or fp extension and
4028 /// is[Z|FP]ExtFree of the related types is not true.
4029 virtual bool isExtFreeImpl(const Instruction *I) const { return false; }
4030
4031 /// Depth that GatherAllAliases should continue looking for chain
4032 /// dependencies when trying to find a more preferable chain. As an
4033 /// approximation, this should be more than the number of consecutive stores
4034 /// expected to be merged.
4036
4037 /// \brief Specify maximum number of store instructions per memset call.
4038 ///
4039 /// When lowering \@llvm.memset this field specifies the maximum number of
4040 /// store operations that may be substituted for the call to memset. Targets
4041 /// must set this value based on the cost threshold for that target. Targets
4042 /// should assume that the memset will be done using as many of the largest
4043 /// store operations first, followed by smaller ones, if necessary, per
4044 /// alignment restrictions. For example, storing 9 bytes on a 32-bit machine
4045 /// with 16-bit alignment would result in four 2-byte stores and one 1-byte
4046 /// store. This only applies to setting a constant array of a constant size.
4048 /// Likewise for functions with the OptSize attribute.
4050
4051 /// \brief Specify maximum number of store instructions per memcpy call.
4052 ///
4053 /// When lowering \@llvm.memcpy this field specifies the maximum number of
4054 /// store operations that may be substituted for a call to memcpy. Targets
4055 /// must set this value based on the cost threshold for that target. Targets
4056 /// should assume that the memcpy will be done using as many of the largest
4057 /// store operations first, followed by smaller ones, if necessary, per
4058 /// alignment restrictions. For example, storing 7 bytes on a 32-bit machine
4059 /// with 32-bit alignment would result in one 4-byte store, a one 2-byte store
4060 /// and one 1-byte store. This only applies to copying a constant array of
4061 /// constant size.
4063 /// Likewise for functions with the OptSize attribute.
4065 /// \brief Specify max number of store instructions to glue in inlined memcpy.
4066 ///
4067 /// When memcpy is inlined based on MaxStoresPerMemcpy, specify maximum number
4068 /// of store instructions to keep together. This helps in pairing and
4069 // vectorization later on.
4071
4072 /// \brief Specify maximum number of load instructions per memcmp call.
4073 ///
4074 /// When lowering \@llvm.memcmp this field specifies the maximum number of
4075 /// pairs of load operations that may be substituted for a call to memcmp.
4076 /// Targets must set this value based on the cost threshold for that target.
4077 /// Targets should assume that the memcmp will be done using as many of the
4078 /// largest load operations first, followed by smaller ones, if necessary, per
4079 /// alignment restrictions. For example, loading 7 bytes on a 32-bit machine
4080 /// with 32-bit alignment would result in one 4-byte load, a one 2-byte load
4081 /// and one 1-byte load. This only applies to copying a constant array of
4082 /// constant size.
4084 /// Likewise for functions with the OptSize attribute.
4086
4087 /// \brief Specify maximum number of store instructions per memmove call.
4088 ///
4089 /// When lowering \@llvm.memmove this field specifies the maximum number of
4090 /// store instructions that may be substituted for a call to memmove. Targets
4091 /// must set this value based on the cost threshold for that target. Targets
4092 /// should assume that the memmove will be done using as many of the largest
4093 /// store operations first, followed by smaller ones, if necessary, per
4094 /// alignment restrictions. For example, moving 9 bytes on a 32-bit machine
4095 /// with 8-bit alignment would result in nine 1-byte stores. This only
4096 /// applies to copying a constant array of constant size.
4098 /// Likewise for functions with the OptSize attribute.
4100
4101 /// Tells the code generator that select is more expensive than a branch if
4102 /// the branch is usually predicted right.
4104
4105 /// \see enableExtLdPromotion.
4107
4108 /// Return true if the value types that can be represented by the specified
4109 /// register class are all legal.
4110 bool isLegalRC(const TargetRegisterInfo &TRI,
4111 const TargetRegisterClass &RC) const;
4112
4113 /// Replace/modify any TargetFrameIndex operands with a targte-dependent
4114 /// sequence of memory operands that is recognized by PrologEpilogInserter.
4116 MachineBasicBlock *MBB) const;
4117
4119};
4120
4121/// This class defines information used to lower LLVM code to legal SelectionDAG
4122/// operators that the target instruction selector can accept natively.
4123///
4124/// This class also defines callbacks that targets must implement to lower
4125/// target-specific constructs to SelectionDAG operators.
4127public:
4128 struct DAGCombinerInfo;
4129 struct MakeLibCallOptions;
4130
4133
4134 explicit TargetLowering(const TargetMachine &TM,
4135 const TargetSubtargetInfo &STI);
4137
4138 bool isPositionIndependent() const;
4139
4140 // If set to true, SelectionDAG nodes will be consistently processed in
4141 // topological order. This is a temporary hook until sorting can be
4142 // enabled globally.
4143 virtual bool useTopologicalSorting() const { return false; }
4144
4147 UniformityInfo *UA) const {
4148 return false;
4149 }
4150
4151 // Lets target to control the following reassociation of operands: (op (op x,
4152 // c1), y) -> (op (op x, y), c1) where N0 is (op x, c1) and N1 is y. By
4153 // default consider profitable any case where N0 has single use. This
4154 // behavior reflects the condition replaced by this target hook call in the
4155 // DAGCombiner. Any particular target can implement its own heuristic to
4156 // restrict common combiner.
4158 SDValue N1) const {
4159 return N0.hasOneUse();
4160 }
4161
4162 // Lets target to control the following reassociation of operands: (op (op x,
4163 // c1), y) -> (op (op x, y), c1) where N0 is (op x, c1) and N1 is y. By
4164 // default consider profitable any case where N0 has single use. This
4165 // behavior reflects the condition replaced by this target hook call in the
4166 // combiner. Any particular target can implement its own heuristic to
4167 // restrict common combiner.
4169 Register N1) const {
4170 return MRI.hasOneNonDBGUse(N0);
4171 }
4172
4173 virtual bool isSDNodeAlwaysUniform(const SDNode * N) const {
4174 return false;
4175 }
4176
4177 /// Returns true by value, base pointer and offset pointer and addressing mode
4178 /// by reference if the node's address can be legally represented as
4179 /// pre-indexed load / store address.
4180 virtual bool getPreIndexedAddressParts(SDNode * /*N*/, SDValue &/*Base*/,
4181 SDValue &/*Offset*/,
4182 ISD::MemIndexedMode &/*AM*/,
4183 SelectionDAG &/*DAG*/) const {
4184 return false;
4185 }
4186
4187 /// Returns true by value, base pointer and offset pointer and addressing mode
4188 /// by reference if this node can be combined with a load / store to form a
4189 /// post-indexed load / store.
4190 virtual bool getPostIndexedAddressParts(SDNode * /*N*/, SDNode * /*Op*/,
4191 SDValue &/*Base*/,
4192 SDValue &/*Offset*/,
4193 ISD::MemIndexedMode &/*AM*/,
4194 SelectionDAG &/*DAG*/) const {
4195 return false;
4196 }
4197
4198 /// Returns true if the specified base+offset is a legal indexed addressing
4199 /// mode for this target. \p MI is the load or store instruction that is being
4200 /// considered for transformation.
4202 bool IsPre, MachineRegisterInfo &MRI) const {
4203 return false;
4204 }
4205
4206 /// Return the entry encoding for a jump table in the current function. The
4207 /// returned value is a member of the MachineJumpTableInfo::JTEntryKind enum.
4208 virtual unsigned getJumpTableEncoding() const;
4209
4210 virtual MVT getJumpTableRegTy(const DataLayout &DL) const {
4211 return getPointerTy(DL);
4212 }
4213
4214 virtual const MCExpr *
4216 const MachineBasicBlock * /*MBB*/, unsigned /*uid*/,
4217 MCContext &/*Ctx*/) const {
4218 llvm_unreachable("Need to implement this hook if target has custom JTIs");
4219 }
4220
4221 /// Returns relocation base for the given PIC jumptable.
4222 virtual SDValue getPICJumpTableRelocBase(SDValue Table,
4223 SelectionDAG &DAG) const;
4224
4225 /// This returns the relocation base for the given PIC jumptable, the same as
4226 /// getPICJumpTableRelocBase, but as an MCExpr.
4227 virtual const MCExpr *
4228 getPICJumpTableRelocBaseExpr(const MachineFunction *MF,
4229 unsigned JTI, MCContext &Ctx) const;
4230
4231 /// Return true if folding a constant offset with the given GlobalAddress is
4232 /// legal. It is frequently not legal in PIC relocation models.
4233 virtual bool isOffsetFoldingLegal(const GlobalAddressSDNode *GA) const;
4234
4235 /// On x86, return true if the operand with index OpNo is a CALL or JUMP
4236 /// instruction, which can use either a memory constraint or an address
4237 /// constraint. -fasm-blocks "__asm call foo" lowers to
4238 /// call void asm sideeffect inteldialect "call ${0:P}", "*m..."
4239 ///
4240 /// This function is used by a hack to choose the address constraint,
4241 /// lowering to a direct call.
4242 virtual bool
4244 unsigned OpNo) const {
4245 return false;
4246 }
4247
4249 SDValue &Chain) const;
4250
4251 void softenSetCCOperands(SelectionDAG &DAG, EVT VT, SDValue &NewLHS,
4252 SDValue &NewRHS, ISD::CondCode &CCCode,
4253 const SDLoc &DL, const SDValue OldLHS,
4254 const SDValue OldRHS) const;
4255
4256 void softenSetCCOperands(SelectionDAG &DAG, EVT VT, SDValue &NewLHS,
4257 SDValue &NewRHS, ISD::CondCode &CCCode,
4258 const SDLoc &DL, const SDValue OldLHS,
4259 const SDValue OldRHS, SDValue &Chain,
4260 bool IsSignaling = false) const;
4261
4263 SDValue Chain, MachineMemOperand *MMO,
4264 SDValue &NewLoad, SDValue Ptr,
4265 SDValue PassThru, SDValue Mask) const {
4266 llvm_unreachable("Not Implemented");
4267 }
4268
4270 SDValue Chain, MachineMemOperand *MMO,
4271 SDValue Ptr, SDValue Val,
4272 SDValue Mask) const {
4273 llvm_unreachable("Not Implemented");
4274 }
4275
4276 /// Returns a pair of (return value, chain).
4277 /// It is an error to pass RTLIB::Unsupported as \p LibcallImpl
4278 std::pair<SDValue, SDValue>
4279 makeLibCall(SelectionDAG &DAG, RTLIB::LibcallImpl LibcallImpl, EVT RetVT,
4280 ArrayRef<SDValue> Ops, MakeLibCallOptions CallOptions,
4281 const SDLoc &dl, SDValue Chain = SDValue()) const;
4282
4283 /// It is an error to pass RTLIB::UNKNOWN_LIBCALL as \p LC.
4284 std::pair<SDValue, SDValue> makeLibCall(SelectionDAG &DAG, RTLIB::Libcall LC,
4285 EVT RetVT, ArrayRef<SDValue> Ops,
4286 MakeLibCallOptions CallOptions,
4287 const SDLoc &dl,
4288 SDValue Chain = SDValue()) const {
4289 return makeLibCall(DAG, getLibcallImpl(LC), RetVT, Ops, CallOptions, dl,
4290 Chain);
4291 }
4292
4293 /// Check whether parameters to a call that are passed in callee saved
4294 /// registers are the same as from the calling function. This needs to be
4295 /// checked for tail call eligibility.
4296 bool parametersInCSRMatch(const MachineRegisterInfo &MRI,
4297 const uint32_t *CallerPreservedMask,
4298 const SmallVectorImpl<CCValAssign> &ArgLocs,
4299 const SmallVectorImpl<SDValue> &OutVals) const;
4300
4301 //===--------------------------------------------------------------------===//
4302 // TargetLowering Optimization Methods
4303 //
4304
4305 /// A convenience struct that encapsulates a DAG, and two SDValues for
4306 /// returning information from TargetLowering to its clients that want to
4307 /// combine.
4314
4316 bool LT, bool LO) :
4317 DAG(InDAG), LegalTys(LT), LegalOps(LO) {}
4318
4319 bool LegalTypes() const { return LegalTys; }
4320 bool LegalOperations() const { return LegalOps; }
4321
4323 Old = O;
4324 New = N;
4325 return true;
4326 }
4327 };
4328
4329 /// Determines the optimal series of memory ops to replace the memset /
4330 /// memcpy. Return true if the number of memory ops is below the threshold
4331 /// (Limit). Note that this is always the case when Limit is ~0. It returns
4332 /// the types of the sequence of memory ops to perform memset / memcpy by
4333 /// reference. If LargestVT is non-null, the target may set it to the largest
4334 /// EVT that should be used for generating the memset value (e.g., for vector
4335 /// splats). If LargestVT is null or left unchanged, the caller will compute
4336 /// it from MemOps.
4337 virtual bool findOptimalMemOpLowering(LLVMContext &Context,
4338 std::vector<EVT> &MemOps,
4339 unsigned Limit, const MemOp &Op,
4340 unsigned DstAS, unsigned SrcAS,
4341 const AttributeList &FuncAttributes,
4342 EVT *LargestVT = nullptr) const;
4343
4344 /// Check to see if the specified operand of the specified instruction is a
4345 /// constant integer. If so, check to see if there are any bits set in the
4346 /// constant that are not demanded. If so, shrink the constant and return
4347 /// true.
4349 const APInt &DemandedElts,
4350 TargetLoweringOpt &TLO) const;
4351
4352 /// Helper wrapper around ShrinkDemandedConstant, demanding all elements.
4354 TargetLoweringOpt &TLO) const;
4355
4356 // Target hook to do target-specific const optimization, which is called by
4357 // ShrinkDemandedConstant. This function should return true if the target
4358 // doesn't want ShrinkDemandedConstant to further optimize the constant.
4360 const APInt &DemandedBits,
4361 const APInt &DemandedElts,
4362 TargetLoweringOpt &TLO) const {
4363 return false;
4364 }
4365
4366 /// Convert x+y to (VT)((SmallVT)x+(SmallVT)y) if the casts are free.
4367 /// This uses isTruncateFree/isZExtFree and ANY_EXTEND for the widening cast,
4368 /// but it could be generalized for targets with other types of implicit
4369 /// widening casts.
4370 bool ShrinkDemandedOp(SDValue Op, unsigned BitWidth,
4371 const APInt &DemandedBits,
4372 TargetLoweringOpt &TLO) const;
4373
4374 /// Look at Op. At this point, we know that only the DemandedBits bits of the
4375 /// result of Op are ever used downstream. If we can use this information to
4376 /// simplify Op, create a new simplified DAG node and return true, returning
4377 /// the original and new nodes in Old and New. Otherwise, analyze the
4378 /// expression and return a mask of KnownOne and KnownZero bits for the
4379 /// expression (used to simplify the caller). The KnownZero/One bits may only
4380 /// be accurate for those bits in the Demanded masks.
4381 /// \p AssumeSingleUse When this parameter is true, this function will
4382 /// attempt to simplify \p Op even if there are multiple uses.
4383 /// Callers are responsible for correctly updating the DAG based on the
4384 /// results of this function, because simply replacing TLO.Old
4385 /// with TLO.New will be incorrect when this parameter is true and TLO.Old
4386 /// has multiple uses.
4387 bool SimplifyDemandedBits(SDValue Op, const APInt &DemandedBits,
4388 const APInt &DemandedElts, KnownBits &Known,
4389 TargetLoweringOpt &TLO, unsigned Depth = 0,
4390 bool AssumeSingleUse = false) const;
4391
4392 /// Helper wrapper around SimplifyDemandedBits, demanding all elements.
4393 /// Adds Op back to the worklist upon success.
4394 bool SimplifyDemandedBits(SDValue Op, const APInt &DemandedBits,
4395 KnownBits &Known, TargetLoweringOpt &TLO,
4396 unsigned Depth = 0,
4397 bool AssumeSingleUse = false) const;
4398
4399 /// Helper wrapper around SimplifyDemandedBits.
4400 /// Adds Op back to the worklist upon success.
4401 bool SimplifyDemandedBits(SDValue Op, const APInt &DemandedBits,
4402 DAGCombinerInfo &DCI) const;
4403
4404 /// Helper wrapper around SimplifyDemandedBits.
4405 /// Adds Op back to the worklist upon success.
4406 bool SimplifyDemandedBits(SDValue Op, const APInt &DemandedBits,
4407 const APInt &DemandedElts,
4408 DAGCombinerInfo &DCI) const;
4409
4410 /// More limited version of SimplifyDemandedBits that can be used to "look
4411 /// through" ops that don't contribute to the DemandedBits/DemandedElts -
4412 /// bitwise ops etc.
4413 SDValue SimplifyMultipleUseDemandedBits(SDValue Op, const APInt &DemandedBits,
4414 const APInt &DemandedElts,
4415 SelectionDAG &DAG,
4416 unsigned Depth = 0) const;
4417
4418 /// Helper wrapper around SimplifyMultipleUseDemandedBits, demanding all
4419 /// elements.
4420 SDValue SimplifyMultipleUseDemandedBits(SDValue Op, const APInt &DemandedBits,
4421 SelectionDAG &DAG,
4422 unsigned Depth = 0) const;
4423
4424 /// Helper wrapper around SimplifyMultipleUseDemandedBits, demanding all
4425 /// bits from only some vector elements.
4426 SDValue SimplifyMultipleUseDemandedVectorElts(SDValue Op,
4427 const APInt &DemandedElts,
4428 SelectionDAG &DAG,
4429 unsigned Depth = 0) const;
4430
4431 /// Look at Vector Op. At this point, we know that only the DemandedElts
4432 /// elements of the result of Op are ever used downstream. If we can use
4433 /// this information to simplify Op, create a new simplified DAG node and
4434 /// return true, storing the original and new nodes in TLO.
4435 /// Otherwise, analyze the expression and return a mask of KnownUndef and
4436 /// KnownZero elements for the expression (used to simplify the caller).
4437 /// The KnownUndef/Zero elements may only be accurate for those bits
4438 /// in the DemandedMask.
4439 /// \p AssumeSingleUse When this parameter is true, this function will
4440 /// attempt to simplify \p Op even if there are multiple uses.
4441 /// Callers are responsible for correctly updating the DAG based on the
4442 /// results of this function, because simply replacing TLO.Old
4443 /// with TLO.New will be incorrect when this parameter is true and TLO.Old
4444 /// has multiple uses.
4445 bool SimplifyDemandedVectorElts(SDValue Op, const APInt &DemandedEltMask,
4446 APInt &KnownUndef, APInt &KnownZero,
4447 TargetLoweringOpt &TLO, unsigned Depth = 0,
4448 bool AssumeSingleUse = false) const;
4449
4450 /// Helper wrapper around SimplifyDemandedVectorElts.
4451 /// Adds Op back to the worklist upon success.
4452 bool SimplifyDemandedVectorElts(SDValue Op, const APInt &DemandedElts,
4453 DAGCombinerInfo &DCI) const;
4454
4455 /// Return true if the target supports simplifying demanded vector elements by
4456 /// converting them to undefs.
4457 virtual bool
4459 const TargetLoweringOpt &TLO) const {
4460 return true;
4461 }
4462
4463 /// If only low elements of a vector are demanded, shrink the operation to the
4464 /// returned size in bits by converting
4465 /// (op x) to insert_subvector (op (extract_subvector x)).
4466 ///
4467 /// The returned size must be a multiple of the element size, greater than or
4468 /// equal to the demanded part of the vector and less than the original
4469 /// vector size. Return 0 to disable shrinking.
4470 virtual unsigned
4472 const APInt &DemandedElts) const {
4473 return 0;
4474 }
4475
4476 /// Determine which of the bits specified in Mask are known to be either zero
4477 /// or one and return them in the KnownZero/KnownOne bitsets. The DemandedElts
4478 /// argument allows us to only collect the known bits that are shared by the
4479 /// requested vector elements.
4480 virtual void computeKnownBitsForTargetNode(const SDValue Op,
4482 const APInt &DemandedElts,
4483 const SelectionDAG &DAG,
4484 unsigned Depth = 0) const;
4485
4486 /// Determine which of the bits specified in Mask are known to be either zero
4487 /// or one and return them in the KnownZero/KnownOne bitsets. The DemandedElts
4488 /// argument allows us to only collect the known bits that are shared by the
4489 /// requested vector elements. This is for GISel.
4490 virtual void computeKnownBitsForTargetInstr(GISelValueTracking &Analysis,
4492 const APInt &DemandedElts,
4493 const MachineRegisterInfo &MRI,
4494 unsigned Depth = 0) const;
4495
4496 virtual void computeKnownFPClassForTargetInstr(GISelValueTracking &Analysis,
4497 Register R,
4499 const APInt &DemandedElts,
4500 const MachineRegisterInfo &MRI,
4501 unsigned Depth = 0) const;
4502
4503 /// Determine the known alignment for the pointer value \p R. This is can
4504 /// typically be inferred from the number of low known 0 bits. However, for a
4505 /// pointer with a non-integral address space, the alignment value may be
4506 /// independent from the known low bits.
4507 virtual Align computeKnownAlignForTargetInstr(GISelValueTracking &Analysis,
4508 Register R,
4509 const MachineRegisterInfo &MRI,
4510 unsigned Depth = 0) const;
4511
4512 /// Determine known bits of a pointer to a known valid stack object.
4513 /// The default implementation computes low bits based on alignment.
4514 virtual void computeKnownBitsForStackObjectPointer(KnownBits &Known,
4515 const MachineFunction &MF,
4516 Align Alignment) const;
4517
4518 /// This method can be implemented by targets that want to expose additional
4519 /// information about sign bits to the DAG Combiner. The DemandedElts
4520 /// argument allows us to only collect the minimum sign bits that are shared
4521 /// by the requested vector elements.
4522 virtual unsigned ComputeNumSignBitsForTargetNode(SDValue Op,
4523 const APInt &DemandedElts,
4524 const SelectionDAG &DAG,
4525 unsigned Depth = 0) const;
4526
4527 /// This method can be implemented by targets that want to expose additional
4528 /// information about sign bits to GlobalISel combiners. The DemandedElts
4529 /// argument allows us to only collect the minimum sign bits that are shared
4530 /// by the requested vector elements.
4531 virtual unsigned computeNumSignBitsForTargetInstr(
4532 GISelValueTracking &Analysis, Register R, const APInt &DemandedElts,
4533 const MachineRegisterInfo &MRI, unsigned Depth = 0) const;
4534
4535 /// Attempt to simplify any target nodes based on the demanded vector
4536 /// elements, returning true on success. Otherwise, analyze the expression and
4537 /// return a mask of KnownUndef and KnownZero elements for the expression
4538 /// (used to simplify the caller). The KnownUndef/Zero elements may only be
4539 /// accurate for those bits in the DemandedMask.
4540 virtual bool SimplifyDemandedVectorEltsForTargetNode(
4541 SDValue Op, const APInt &DemandedElts, APInt &KnownUndef,
4542 APInt &KnownZero, TargetLoweringOpt &TLO, unsigned Depth = 0) const;
4543
4544 /// Attempt to simplify any target nodes based on the demanded bits/elts,
4545 /// returning true on success. Otherwise, analyze the
4546 /// expression and return a mask of KnownOne and KnownZero bits for the
4547 /// expression (used to simplify the caller). The KnownZero/One bits may only
4548 /// be accurate for those bits in the Demanded masks.
4549 virtual bool SimplifyDemandedBitsForTargetNode(SDValue Op,
4550 const APInt &DemandedBits,
4551 const APInt &DemandedElts,
4553 TargetLoweringOpt &TLO,
4554 unsigned Depth = 0) const;
4555
4556 /// More limited version of SimplifyDemandedBits that can be used to "look
4557 /// through" ops that don't contribute to the DemandedBits/DemandedElts -
4558 /// bitwise ops etc.
4559 virtual SDValue SimplifyMultipleUseDemandedBitsForTargetNode(
4560 SDValue Op, const APInt &DemandedBits, const APInt &DemandedElts,
4561 SelectionDAG &DAG, unsigned Depth) const;
4562
4563 /// Return true if this function can prove that \p Op is never poison
4564 /// and, \p Kind can be used to track poison and/or undef bits. The
4565 /// DemandedElts argument limits the check to the requested vector elements.
4566 virtual bool isGuaranteedNotToBeUndefOrPoisonForTargetNode(
4567 SDValue Op, const APInt &DemandedElts, const SelectionDAG &DAG,
4568 UndefPoisonKind Kind, unsigned Depth) const;
4569
4570 /// Return true if Op can create undef or poison from non-undef & non-poison
4571 /// operands. The DemandedElts argument limits the check to the requested
4572 /// vector elements.
4573 virtual bool canCreateUndefOrPoisonForTargetNode(
4574 SDValue Op, const APInt &DemandedElts, const SelectionDAG &DAG,
4575 UndefPoisonKind Kind, bool ConsiderFlags, unsigned Depth) const;
4576
4577 /// Tries to build a legal vector shuffle using the provided parameters
4578 /// or equivalent variations. The Mask argument maybe be modified as the
4579 /// function tries different variations.
4580 /// Returns an empty SDValue if the operation fails.
4581 SDValue buildLegalVectorShuffle(EVT VT, const SDLoc &DL, SDValue N0,
4583 SelectionDAG &DAG) const;
4584
4585 /// This method returns the constant pool value that will be loaded by LD.
4586 /// NOTE: You must check for implicit extensions of the constant by LD.
4587 virtual const Constant *getTargetConstantFromLoad(LoadSDNode *LD) const;
4588
4589 /// Determine floating-point class information for a target node. The
4590 /// DemandedElts argument allows us to only collect the known FP classes
4591 /// that are shared by the requested vector elements.
4592 virtual void computeKnownFPClassForTargetNode(const SDValue Op,
4594 const APInt &DemandedElts,
4595 const SelectionDAG &DAG,
4596 unsigned Depth = 0) const;
4597
4598 /// If \p SNaN is false, \returns true if \p Op is known to never be any
4599 /// NaN. If \p sNaN is true, returns if \p Op is known to never be a signaling
4600 /// NaN.
4601 virtual bool isKnownNeverNaNForTargetNode(SDValue Op,
4602 const APInt &DemandedElts,
4603 const SelectionDAG &DAG,
4604 bool SNaN = false,
4605 unsigned Depth = 0) const;
4606
4607 /// Return true if vector \p Op has the same value across all \p DemandedElts,
4608 /// indicating any elements which may be undef in the output \p UndefElts.
4609 virtual bool isSplatValueForTargetNode(SDValue Op, const APInt &DemandedElts,
4610 APInt &UndefElts,
4611 const SelectionDAG &DAG,
4612 unsigned Depth = 0) const;
4613
4614 /// Returns true if the given Opc is considered a canonical constant for the
4615 /// target, which should not be transformed back into a BUILD_VECTOR.
4617 return Op.getOpcode() == ISD::SPLAT_VECTOR ||
4618 Op.getOpcode() == ISD::SPLAT_VECTOR_PARTS;
4619 }
4620
4621 /// Return true if the given select/vselect should be considered canonical and
4622 /// not be transformed. Currently only used for "vselect (not Cond), N1, N2 ->
4623 /// vselect Cond, N2, N1".
4624 virtual bool isTargetCanonicalSelect(SDNode *N) const { return false; }
4625
4627 void *DC; // The DAG Combiner object.
4630
4631 public:
4633
4634 DAGCombinerInfo(SelectionDAG &dag, CombineLevel level, bool cl, void *dc)
4635 : DC(dc), Level(level), CalledByLegalizer(cl), DAG(dag) {}
4636
4637 bool isBeforeLegalize() const { return Level == BeforeLegalizeTypes; }
4639 bool isAfterLegalizeDAG() const { return Level >= AfterLegalizeDAG; }
4642
4643 LLVM_ABI void AddToWorklist(SDNode *N);
4644 LLVM_ABI SDValue CombineTo(SDNode *N, ArrayRef<SDValue> To,
4645 bool AddTo = true);
4646 LLVM_ABI SDValue CombineTo(SDNode *N, SDValue Res, bool AddTo = true);
4647 LLVM_ABI SDValue CombineTo(SDNode *N, SDValue Res0, SDValue Res1,
4648 bool AddTo = true);
4649
4650 LLVM_ABI bool recursivelyDeleteUnusedNodes(SDNode *N);
4651
4652 LLVM_ABI void CommitTargetLoweringOpt(const TargetLoweringOpt &TLO);
4653 };
4654
4655 /// Return if the N is a constant or constant vector equal to the true value
4656 /// from getBooleanContents().
4657 bool isConstTrueVal(SDValue N) const;
4658
4659 /// Return if the N is a constant or constant vector equal to the false value
4660 /// from getBooleanContents().
4661 bool isConstFalseVal(SDValue N) const;
4662
4663 /// Return if \p N is a True value when extended to \p VT.
4664 bool isExtendedTrueVal(const ConstantSDNode *N, EVT VT, bool SExt) const;
4665
4666 /// Try to simplify a setcc built with the specified operands and cc. If it is
4667 /// unable to simplify it, return a null SDValue.
4668 SDValue SimplifySetCC(EVT VT, SDValue N0, SDValue N1, ISD::CondCode Cond,
4669 bool foldBooleans, DAGCombinerInfo &DCI,
4670 const SDLoc &dl) const;
4671
4672 // For targets which wrap address, unwrap for analysis.
4673 virtual SDValue unwrapAddress(SDValue N) const { return N; }
4674
4675 /// Returns true (and the GlobalValue and the offset) if the node is a
4676 /// GlobalAddress + offset.
4677 virtual bool
4678 isGAPlusOffset(SDNode *N, const GlobalValue* &GA, int64_t &Offset) const;
4679
4680 /// This method will be invoked for all target nodes and for any
4681 /// target-independent nodes that the target has registered with invoke it
4682 /// for.
4683 ///
4684 /// The semantics are as follows:
4685 /// Return Value:
4686 /// SDValue.Val == 0 - No change was made
4687 /// SDValue.Val == N - N was replaced, is dead, and is already handled.
4688 /// otherwise - N should be replaced by the returned Operand.
4689 ///
4690 /// In addition, methods provided by DAGCombinerInfo may be used to perform
4691 /// more complex transformations.
4692 ///
4693 virtual SDValue PerformDAGCombine(SDNode *N, DAGCombinerInfo &DCI) const;
4694
4695 /// Return true if it is profitable to move this shift by a constant amount
4696 /// through its operand, adjusting any immediate operands as necessary to
4697 /// preserve semantics. This transformation may not be desirable if it
4698 /// disrupts a particularly auspicious target-specific tree (e.g. bitfield
4699 /// extraction in AArch64). By default, it returns true.
4700 ///
4701 /// @param N the shift node
4702 /// @param Level the current DAGCombine legalization level.
4704 CombineLevel Level) const {
4705 SDValue ShiftLHS = N->getOperand(0);
4706 if (!ShiftLHS->hasOneUse())
4707 return false;
4708 if (ShiftLHS.getOpcode() == ISD::SIGN_EXTEND &&
4709 !ShiftLHS.getOperand(0)->hasOneUse())
4710 return false;
4711 return true;
4712 }
4713
4714 /// GlobalISel - return true if it is profitable to move this shift by a
4715 /// constant amount through its operand, adjusting any immediate operands as
4716 /// necessary to preserve semantics. This transformation may not be desirable
4717 /// if it disrupts a particularly auspicious target-specific tree (e.g.
4718 /// bitfield extraction in AArch64). By default, it returns true.
4719 ///
4720 /// @param MI the shift instruction
4721 /// @param IsAfterLegal true if running after legalization.
4723 bool IsAfterLegal) const {
4724 return true;
4725 }
4726
4727 /// GlobalISel - return true if it's profitable to perform the combine:
4728 /// shl ([sza]ext x), y => zext (shl x, y)
4729 virtual bool isDesirableToPullExtFromShl(const MachineInstr &MI) const {
4730 return true;
4731 }
4732
4733 // Return AndOrSETCCFoldKind::{AddAnd, ABS} if its desirable to try and
4734 // optimize LogicOp(SETCC0, SETCC1). An example (what is implemented as of
4735 // writing this) is:
4736 // With C as a power of 2 and C != 0 and C != INT_MIN:
4737 // AddAnd:
4738 // (icmp eq A, C) | (icmp eq A, -C)
4739 // -> (icmp eq and(add(A, C), ~(C + C)), 0)
4740 // (icmp ne A, C) & (icmp ne A, -C)w
4741 // -> (icmp ne and(add(A, C), ~(C + C)), 0)
4742 // ABS:
4743 // (icmp eq A, C) | (icmp eq A, -C)
4744 // -> (icmp eq Abs(A), C)
4745 // (icmp ne A, C) & (icmp ne A, -C)w
4746 // -> (icmp ne Abs(A), C)
4747 //
4748 // @param LogicOp the logic op
4749 // @param SETCC0 the first of the SETCC nodes
4750 // @param SETCC0 the second of the SETCC nodes
4752 const SDNode *LogicOp, const SDNode *SETCC0, const SDNode *SETCC1) const {
4754 }
4755
4756 /// Return true if it is profitable to combine an XOR of a logical shift
4757 /// to create a logical shift of NOT. This transformation may not be desirable
4758 /// if it disrupts a particularly auspicious target-specific tree (e.g.
4759 /// BIC on ARM/AArch64). By default, it returns true.
4760 virtual bool isDesirableToCommuteXorWithShift(const SDNode *N) const {
4761 return true;
4762 }
4763
4764 /// Return true if the target has native support for the specified value type
4765 /// and it is 'desirable' to use the type for the given node type. e.g. On x86
4766 /// i16 is legal, but undesirable since i16 instruction encodings are longer
4767 /// and some i16 instructions are slow.
4768 virtual bool isTypeDesirableForOp(unsigned /*Opc*/, EVT VT) const {
4769 // By default, assume all legal types are desirable.
4770 return isTypeLegal(VT);
4771 }
4772
4773 /// Return true if it is profitable for dag combiner to transform a floating
4774 /// point op of specified opcode to a equivalent op of an integer
4775 /// type. e.g. f32 load -> i32 load can be profitable on ARM.
4776 virtual bool isDesirableToTransformToIntegerOp(unsigned /*Opc*/,
4777 EVT /*VT*/) const {
4778 return false;
4779 }
4780
4781 /// This method query the target whether it is beneficial for dag combiner to
4782 /// promote the specified node. If true, it should return the desired
4783 /// promotion type by reference.
4784 virtual bool IsDesirableToPromoteOp(SDValue /*Op*/, EVT &/*PVT*/) const {
4785 return false;
4786 }
4787
4788 /// Return true if the target supports swifterror attribute. It optimizes
4789 /// loads and stores to reading and writing a specific register.
4790 virtual bool supportSwiftError() const {
4791 return false;
4792 }
4793
4794 /// Return true if the target supports that a subset of CSRs for the given
4795 /// machine function is handled explicitly via copies.
4796 virtual bool supportSplitCSR(MachineFunction *MF) const {
4797 return false;
4798 }
4799
4800 /// Return true if the target supports kcfi operand bundles.
4801 virtual bool supportKCFIBundles() const { return false; }
4802
4803 /// Return true if the target supports ptrauth operand bundles.
4804 virtual bool supportPtrAuthBundles() const { return false; }
4805
4806 /// Perform necessary initialization to handle a subset of CSRs explicitly
4807 /// via copies. This function is called at the beginning of instruction
4808 /// selection.
4809 virtual void initializeSplitCSR(MachineBasicBlock *Entry) const {
4810 llvm_unreachable("Not Implemented");
4811 }
4812
4813 /// Insert explicit copies in entry and exit blocks. We copy a subset of
4814 /// CSRs to virtual registers in the entry block, and copy them back to
4815 /// physical registers in the exit blocks. This function is called at the end
4816 /// of instruction selection.
4818 MachineBasicBlock *Entry,
4819 const SmallVectorImpl<MachineBasicBlock *> &Exits) const {
4820 llvm_unreachable("Not Implemented");
4821 }
4822
4823 /// Return the newly negated expression if the cost is not expensive and
4824 /// set the cost in \p Cost to indicate that if it is cheaper or neutral to
4825 /// do the negation.
4826 virtual SDValue getNegatedExpression(SDValue Op, SelectionDAG &DAG,
4827 bool LegalOps, bool OptForSize,
4828 NegatibleCost &Cost,
4829 unsigned Depth = 0) const;
4830
4832 SDValue Op, SelectionDAG &DAG, bool LegalOps, bool OptForSize,
4834 unsigned Depth = 0) const {
4836 SDValue Neg =
4837 getNegatedExpression(Op, DAG, LegalOps, OptForSize, Cost, Depth);
4838 if (!Neg)
4839 return SDValue();
4840
4841 if (Cost <= CostThreshold)
4842 return Neg;
4843
4844 // Remove the new created node to avoid the side effect to the DAG.
4845 if (Neg->use_empty())
4846 DAG.RemoveDeadNode(Neg.getNode());
4847 return SDValue();
4848 }
4849
4850 /// This is the helper function to return the newly negated expression only
4851 /// when the cost is cheaper.
4853 bool LegalOps, bool OptForSize,
4854 unsigned Depth = 0) const {
4855 return getCheaperOrNeutralNegatedExpression(Op, DAG, LegalOps, OptForSize,
4857 }
4858
4859 /// This is the helper function to return the newly negated expression if
4860 /// the cost is not expensive.
4862 bool OptForSize, unsigned Depth = 0) const {
4864 return getNegatedExpression(Op, DAG, LegalOps, OptForSize, Cost, Depth);
4865 }
4866
4867 //===--------------------------------------------------------------------===//
4868 // Lowering methods - These methods must be implemented by targets so that
4869 // the SelectionDAGBuilder code knows how to lower these.
4870 //
4871
4872 /// Target-specific splitting of values into parts that fit a register
4873 /// storing a legal type
4875 SelectionDAG & DAG, const SDLoc &DL, SDValue Val, SDValue *Parts,
4876 unsigned NumParts, MVT PartVT, std::optional<CallingConv::ID> CC) const {
4877 return false;
4878 }
4879
4880 /// Target-specific combining of register parts into its original value
4881 virtual SDValue
4883 const SDValue *Parts, unsigned NumParts,
4884 MVT PartVT, EVT ValueVT,
4885 std::optional<CallingConv::ID> CC) const {
4886 return SDValue();
4887 }
4888
4889 /// This hook must be implemented to lower the incoming (formal) arguments,
4890 /// described by the Ins array, into the specified DAG. The implementation
4891 /// should fill in the InVals array with legal-type argument values, and
4892 /// return the resulting token chain value.
4894 SDValue /*Chain*/, CallingConv::ID /*CallConv*/, bool /*isVarArg*/,
4895 const SmallVectorImpl<ISD::InputArg> & /*Ins*/, const SDLoc & /*dl*/,
4896 SelectionDAG & /*DAG*/, SmallVectorImpl<SDValue> & /*InVals*/) const {
4897 llvm_unreachable("Not Implemented");
4898 }
4899
4900 /// Optional target hook to add target-specific actions when entering EH pad
4901 /// blocks. The implementation should return the resulting token chain value.
4902 virtual SDValue lowerEHPadEntry(SDValue Chain, const SDLoc &DL,
4903 SelectionDAG &DAG) const {
4904 return SDValue();
4905 }
4906
4907 virtual void markLibCallAttributes(MachineFunction *MF, unsigned CC,
4908 ArgListTy &Args) const {}
4909
4910 /// This structure contains the information necessary for lowering
4911 /// pointer-authenticating indirect calls. It is equivalent to the "ptrauth"
4912 /// operand bundle found on the call instruction, if any.
4917
4918 /// This structure contains all information that is necessary for lowering
4919 /// calls. It is passed to TLI::LowerCallTo when the SelectionDAG builder
4920 /// needs to lower a call, and targets will see this struct in their LowerCall
4921 /// implementation.
4924 /// Original unlegalized return type.
4925 Type *OrigRetTy = nullptr;
4926 /// Same as OrigRetTy, or partially legalized for soft float libcalls.
4927 Type *RetTy = nullptr;
4928 bool RetSExt : 1;
4929 bool RetZExt : 1;
4930 bool IsVarArg : 1;
4931 bool IsInReg : 1;
4937 bool NoMerge : 1;
4938
4939 // IsTailCall should be modified by implementations of
4940 // TargetLowering::LowerCall that perform tail call conversions.
4941 bool IsTailCall = false;
4942
4943 // Is Call lowering done post SelectionDAG type legalization.
4945
4946 unsigned NumFixedArgs = -1;
4952 const CallBase *CB = nullptr;
4957 const ConstantInt *CFIType = nullptr;
4960
4961 std::optional<PtrAuthInfo> PAI;
4962
4968
4970 DL = dl;
4971 return *this;
4972 }
4973
4975 Chain = InChain;
4976 return *this;
4977 }
4978
4979 // setCallee with target/module-specific attributes
4981 SDValue Target, ArgListTy &&ArgsList) {
4982 return setLibCallee(CC, ResultType, ResultType, Target,
4983 std::move(ArgsList));
4984 }
4985
4987 Type *OrigResultType, SDValue Target,
4988 ArgListTy &&ArgsList) {
4989 OrigRetTy = OrigResultType;
4990 RetTy = ResultType;
4991 Callee = Target;
4992 CallConv = CC;
4993 NumFixedArgs = ArgsList.size();
4994 Args = std::move(ArgsList);
4995
4996 DAG.getTargetLoweringInfo().markLibCallAttributes(
4997 &(DAG.getMachineFunction()), CC, Args);
4998 return *this;
4999 }
5000
5002 SDValue Target, ArgListTy &&ArgsList,
5003 AttributeSet ResultAttrs = {}) {
5004 RetTy = OrigRetTy = ResultType;
5005 IsInReg = ResultAttrs.hasAttribute(Attribute::InReg);
5006 RetSExt = ResultAttrs.hasAttribute(Attribute::SExt);
5007 RetZExt = ResultAttrs.hasAttribute(Attribute::ZExt);
5008 NoMerge = ResultAttrs.hasAttribute(Attribute::NoMerge);
5009
5010 Callee = Target;
5011 CallConv = CC;
5012 NumFixedArgs = ArgsList.size();
5013 Args = std::move(ArgsList);
5014 return *this;
5015 }
5016
5018 SDValue Target, ArgListTy &&ArgsList,
5019 const CallBase &Call) {
5020 RetTy = OrigRetTy = ResultType;
5021
5022 IsInReg = Call.hasRetAttr(Attribute::InReg);
5024 Call.doesNotReturn() ||
5025 (!isa<InvokeInst>(Call) && isa<UnreachableInst>(Call.getNextNode()));
5026 IsVarArg = FTy->isVarArg();
5027 IsReturnValueUsed = !Call.use_empty();
5028 RetSExt = Call.hasRetAttr(Attribute::SExt);
5029 RetZExt = Call.hasRetAttr(Attribute::ZExt);
5030 NoMerge = Call.hasFnAttr(Attribute::NoMerge);
5031
5032 Callee = Target;
5033
5034 CallConv = Call.getCallingConv();
5035 NumFixedArgs = FTy->getNumParams();
5036 Args = std::move(ArgsList);
5037
5038 CB = &Call;
5039
5040 return *this;
5041 }
5042
5044 IsInReg = Value;
5045 return *this;
5046 }
5047
5050 return *this;
5051 }
5052
5054 IsVarArg = Value;
5055 return *this;
5056 }
5057
5059 IsTailCall = Value;
5060 return *this;
5061 }
5062
5065 return *this;
5066 }
5067
5070 return *this;
5071 }
5072
5074 RetSExt = Value;
5075 return *this;
5076 }
5077
5079 RetZExt = Value;
5080 return *this;
5081 }
5082
5085 return *this;
5086 }
5087
5090 return *this;
5091 }
5092
5094 PAI = Value;
5095 return *this;
5096 }
5097
5100 return *this;
5101 }
5102
5104 CFIType = Type;
5105 return *this;
5106 }
5107
5110 return *this;
5111 }
5112
5114 DeactivationSymbol = Sym;
5115 return *this;
5116 }
5117
5119 return Args;
5120 }
5121 };
5122
5123 /// This structure is used to pass arguments to makeLibCall function.
5125 // By passing type list before soften to makeLibCall, the target hook
5126 // shouldExtendTypeInLibCall can get the original type before soften.
5130
5131 bool IsSigned : 1;
5135 bool IsSoften : 1;
5136
5140
5142 IsSigned = Value;
5143 return *this;
5144 }
5145
5148 return *this;
5149 }
5150
5153 return *this;
5154 }
5155
5158 return *this;
5159 }
5160
5162 OpsVTBeforeSoften = OpsVT;
5163 RetVTBeforeSoften = RetVT;
5164 IsSoften = true;
5165 return *this;
5166 }
5167
5168 /// Override the argument type for an operand. Leave the type as null to use
5169 /// the type from the operand's node.
5171 OpsTypeOverrides = OpsTypes;
5172 return *this;
5173 }
5174 };
5175
5176 /// This function lowers an abstract call to a function into an actual call.
5177 /// This returns a pair of operands. The first element is the return value
5178 /// for the function (if RetTy is not VoidTy). The second element is the
5179 /// outgoing token chain. It calls LowerCall to do the actual lowering.
5180 std::pair<SDValue, SDValue> LowerCallTo(CallLoweringInfo &CLI) const;
5181
5182 /// This hook must be implemented to lower calls into the specified
5183 /// DAG. The outgoing arguments to the call are described by the Outs array,
5184 /// and the values to be returned by the call are described by the Ins
5185 /// array. The implementation should fill in the InVals array with legal-type
5186 /// return values from the call, and return the resulting token chain value.
5187 virtual SDValue
5189 SmallVectorImpl<SDValue> &/*InVals*/) const {
5190 llvm_unreachable("Not Implemented");
5191 }
5192
5193 /// Target-specific cleanup for formal ByVal parameters.
5194 virtual void HandleByVal(CCState *, unsigned &, Align) const {}
5195
5196 /// This hook should be implemented to check whether the return values
5197 /// described by the Outs array can fit into the return registers. If false
5198 /// is returned, an sret-demotion is performed.
5199 virtual bool CanLowerReturn(CallingConv::ID /*CallConv*/,
5200 MachineFunction &/*MF*/, bool /*isVarArg*/,
5201 const SmallVectorImpl<ISD::OutputArg> &/*Outs*/,
5202 LLVMContext &/*Context*/, const Type *RetTy) const
5203 {
5204 // Return true by default to get preexisting behavior.
5205 return true;
5206 }
5207
5208 /// Annotate a stack object pointer with known-bits assertions.
5209 SDValue annotateStackObjectPointer(SDValue Ptr, SelectionDAG &DAG,
5210 const SDLoc &DL, Align Alignment) const;
5211
5212 /// This hook must be implemented to lower outgoing return values, described
5213 /// by the Outs array, into the specified DAG. The implementation should
5214 /// return the resulting token chain value.
5215 virtual SDValue LowerReturn(SDValue /*Chain*/, CallingConv::ID /*CallConv*/,
5216 bool /*isVarArg*/,
5217 const SmallVectorImpl<ISD::OutputArg> & /*Outs*/,
5218 const SmallVectorImpl<SDValue> & /*OutVals*/,
5219 const SDLoc & /*dl*/,
5220 SelectionDAG & /*DAG*/) const {
5221 llvm_unreachable("Not Implemented");
5222 }
5223
5224 /// Return true if result of the specified node is used by a return node
5225 /// only. It also compute and return the input chain for the tail call.
5226 ///
5227 /// This is used to determine whether it is possible to codegen a libcall as
5228 /// tail call at legalization time.
5229 virtual bool isUsedByReturnOnly(SDNode *, SDValue &/*Chain*/) const {
5230 return false;
5231 }
5232
5233 /// Return true if the target may be able emit the call instruction as a tail
5234 /// call. This is used by optimization passes to determine if it's profitable
5235 /// to duplicate return instructions to enable tailcall optimization.
5236 virtual bool mayBeEmittedAsTailCall(const CallInst *) const {
5237 return false;
5238 }
5239
5240 /// Return the register ID of the name passed in. Used by named register
5241 /// global variables extension. There is no target-independent behaviour
5242 /// so the default action is to bail.
5243 virtual Register getRegisterByName(const char* RegName, LLT Ty,
5244 const MachineFunction &MF) const {
5245 reportFatalUsageError("Named registers not implemented for this target");
5246 }
5247
5248 /// Return the type that should be used to zero or sign extend a
5249 /// zeroext/signext integer return value. FIXME: Some C calling conventions
5250 /// require the return type to be promoted, but this is not true all the time,
5251 /// e.g. i1/i8/i16 on x86/x86_64. It is also not necessary for non-C calling
5252 /// conventions. The frontend should handle this and include all of the
5253 /// necessary information.
5255 ISD::NodeType /*ExtendKind*/) const {
5256 EVT MinVT = getRegisterType(Context, MVT::i32);
5257 return VT.bitsLT(MinVT) ? MinVT : VT;
5258 }
5259
5260 /// For some targets, an LLVM struct type must be broken down into multiple
5261 /// simple types, but the calling convention specifies that the entire struct
5262 /// must be passed in a block of consecutive registers.
5263 virtual bool
5265 bool isVarArg,
5266 const DataLayout &DL) const {
5267 return false;
5268 }
5269
5270 /// For most targets, an LLVM type must be broken down into multiple
5271 /// smaller types. Usually the halves are ordered according to the endianness
5272 /// but for some platform that would break. So this method will default to
5273 /// matching the endianness but can be overridden.
5274 virtual bool
5276 return DL.isLittleEndian();
5277 }
5278
5279 /// Returns a 0 terminated array of registers that can be safely used as
5280 /// scratch registers.
5282 return nullptr;
5283 }
5284
5285 /// Returns a 0 terminated array of rounding control registers that can be
5286 /// attached into strict FP call.
5290
5291 /// This callback is used to prepare for a volatile or atomic load.
5292 /// It takes a chain node as input and returns the chain for the load itself.
5293 ///
5294 /// Having a callback like this is necessary for targets like SystemZ,
5295 /// which allows a CPU to reuse the result of a previous load indefinitely,
5296 /// even if a cache-coherent store is performed by another CPU. The default
5297 /// implementation does nothing.
5299 SelectionDAG &DAG) const {
5300 return Chain;
5301 }
5302
5303 /// This callback is invoked by the type legalizer to legalize nodes with an
5304 /// illegal operand type but legal result types. It replaces the
5305 /// LowerOperation callback in the type Legalizer. The reason we can not do
5306 /// away with LowerOperation entirely is that LegalizeDAG isn't yet ready to
5307 /// use this callback.
5308 ///
5309 /// TODO: Consider merging with ReplaceNodeResults.
5310 ///
5311 /// The target places new result values for the node in Results (their number
5312 /// and types must exactly match those of the original return values of
5313 /// the node), or leaves Results empty, which indicates that the node is not
5314 /// to be custom lowered after all.
5315 /// The default implementation calls LowerOperation.
5316 virtual void LowerOperationWrapper(SDNode *N,
5318 SelectionDAG &DAG) const;
5319
5320 /// This callback is invoked for operations that are unsupported by the
5321 /// target, which are registered to use 'custom' lowering, and whose defined
5322 /// values are all legal. If the target has no operations that require custom
5323 /// lowering, it need not implement this. The default implementation of this
5324 /// aborts.
5325 virtual SDValue LowerOperation(SDValue Op, SelectionDAG &DAG) const;
5326
5327 /// This callback is invoked when a node result type is illegal for the
5328 /// target, and the operation was registered to use 'custom' lowering for that
5329 /// result type. The target places new result values for the node in Results
5330 /// (their number and types must exactly match those of the original return
5331 /// values of the node), or leaves Results empty, which indicates that the
5332 /// node is not to be custom lowered after all.
5333 ///
5334 /// If the target has no operations that require custom lowering, it need not
5335 /// implement this. The default implementation aborts.
5336 virtual void ReplaceNodeResults(SDNode * /*N*/,
5337 SmallVectorImpl<SDValue> &/*Results*/,
5338 SelectionDAG &/*DAG*/) const {
5339 llvm_unreachable("ReplaceNodeResults not implemented for this target!");
5340 }
5341
5342 /// This method returns the name of a target specific DAG node.
5343 virtual const char *getTargetNodeName(unsigned Opcode) const;
5344
5345 /// This method returns a target specific FastISel object, or null if the
5346 /// target does not support "fast" ISel.
5348 const TargetLibraryInfo *,
5349 const LibcallLoweringInfo *) const {
5350 return nullptr;
5351 }
5352
5353 //===--------------------------------------------------------------------===//
5354 // Inline Asm Support hooks
5355 //
5356
5358 C_Register, // Constraint represents specific register(s).
5359 C_RegisterClass, // Constraint represents any of register(s) in class.
5360 C_Memory, // Memory constraint.
5361 C_Address, // Address constraint.
5362 C_Immediate, // Requires an immediate.
5363 C_Other, // Something else.
5364 C_Unknown // Unsupported constraint.
5365 };
5366
5368 // Generic weights.
5369 CW_Invalid = -1, // No match.
5370 CW_Okay = 0, // Acceptable.
5371 CW_Good = 1, // Good weight.
5372 CW_Better = 2, // Better weight.
5373 CW_Best = 3, // Best weight.
5374
5375 // Well-known weights.
5376 CW_SpecificReg = CW_Okay, // Specific register operands.
5377 CW_Register = CW_Good, // Register operands.
5378 CW_Memory = CW_Better, // Memory operands.
5379 CW_Constant = CW_Best, // Constant operand.
5380 CW_Default = CW_Okay // Default or don't know type.
5381 };
5382
5383 /// This contains information for each constraint that we are lowering.
5385 /// This contains the actual string for the code, like "m". TargetLowering
5386 /// picks the 'best' code from ConstraintInfo::Codes that most closely
5387 /// matches the operand.
5388 std::string ConstraintCode;
5389
5390 /// Information about the constraint code, e.g. Register, RegisterClass,
5391 /// Memory, Other, Unknown.
5393
5394 /// If this is the result output operand or a clobber, this is null,
5395 /// otherwise it is the incoming operand to the CallInst. This gets
5396 /// modified as the asm is processed.
5398
5399 /// The ValueType for the operand value.
5400 MVT ConstraintVT = MVT::Other;
5401
5402 /// Copy constructor for copying from a ConstraintInfo.
5405
5406 /// Return true of this is an input operand that is a matching constraint
5407 /// like "4".
5408 LLVM_ABI bool isMatchingInputConstraint() const;
5409
5410 /// If this is an input matching constraint, this method returns the output
5411 /// operand it matches.
5412 LLVM_ABI unsigned getMatchedOperand() const;
5413 };
5414
5415 using AsmOperandInfoVector = std::vector<AsmOperandInfo>;
5416
5417 /// Split up the constraint string from the inline assembly value into the
5418 /// specific constraints and their prefixes, and also tie in the associated
5419 /// operand values. If this returns an empty vector, and if the constraint
5420 /// string itself isn't empty, there was an error parsing.
5422 const TargetRegisterInfo *TRI,
5423 const CallBase &Call) const;
5424
5425 /// Examine constraint type and operand type and determine a weight value.
5426 /// The operand object must already have been set up with the operand type.
5428 AsmOperandInfo &info, int maIndex) const;
5429
5430 /// Examine constraint string and operand type and determine a weight value.
5431 /// The operand object must already have been set up with the operand type.
5433 AsmOperandInfo &info, const char *constraint) const;
5434
5435 /// Determines the constraint code and constraint type to use for the specific
5436 /// AsmOperandInfo, setting OpInfo.ConstraintCode and OpInfo.ConstraintType.
5437 /// If the actual operand being passed in is available, it can be passed in as
5438 /// Op, otherwise an empty SDValue can be passed.
5439 virtual void ComputeConstraintToUse(AsmOperandInfo &OpInfo,
5440 SDValue Op,
5441 SelectionDAG *DAG = nullptr) const;
5442
5443 /// Given a constraint, return the type of constraint it is for this target.
5444 virtual ConstraintType getConstraintType(StringRef Constraint) const;
5445
5446 using ConstraintPair = std::pair<StringRef, TargetLowering::ConstraintType>;
5448 /// Given an OpInfo with list of constraints codes as strings, return a
5449 /// sorted Vector of pairs of constraint codes and their types in priority of
5450 /// what we'd prefer to lower them as. This may contain immediates that
5451 /// cannot be lowered, but it is meant to be a machine agnostic order of
5452 /// preferences.
5454
5455 /// Given a physical register constraint (e.g. {edx}), return the register
5456 /// number and the register class for the register.
5457 ///
5458 /// Given a register class constraint, like 'r', if this corresponds directly
5459 /// to an LLVM register class, return a register of 0 and the register class
5460 /// pointer.
5461 ///
5462 /// This should only be used for C_Register constraints. On error, this
5463 /// returns a register number of 0 and a null register class pointer.
5464 virtual std::pair<unsigned, const TargetRegisterClass *>
5466 StringRef Constraint, MVT VT) const;
5467
5469 getInlineAsmMemConstraint(StringRef ConstraintCode) const {
5470 if (ConstraintCode == "m")
5472 if (ConstraintCode == "o")
5474 if (ConstraintCode == "X")
5476 if (ConstraintCode == "p")
5479 }
5480
5481 /// Try to replace an X constraint, which matches anything, with another that
5482 /// has more specific requirements based on the type of the corresponding
5483 /// operand. This returns null if there is no replacement to make.
5484 virtual const char *LowerXConstraint(EVT ConstraintVT) const;
5485
5486 /// Lower the specified operand into the Ops vector. If it is invalid, don't
5487 /// add anything to Ops.
5488 virtual void LowerAsmOperandForConstraint(SDValue Op, StringRef Constraint,
5489 std::vector<SDValue> &Ops,
5490 SelectionDAG &DAG) const;
5491
5492 // Lower custom output constraints. If invalid, return SDValue().
5493 virtual SDValue LowerAsmOutputForConstraint(SDValue &Chain, SDValue &Glue,
5494 const SDLoc &DL,
5495 const AsmOperandInfo &OpInfo,
5496 SelectionDAG &DAG) const;
5497
5498 // Targets may override this function to collect operands from the CallInst
5499 // and for example, lower them into the SelectionDAG operands.
5500 virtual void CollectTargetIntrinsicOperands(const CallInst &I,
5502 SelectionDAG &DAG) const;
5503
5504 //===--------------------------------------------------------------------===//
5505 // Div utility functions
5506 //
5507
5508 SDValue BuildSDIV(SDNode *N, SelectionDAG &DAG, bool IsAfterLegalization,
5509 bool IsAfterLegalTypes,
5510 SmallVectorImpl<SDNode *> &Created) const;
5511 SDValue BuildUDIV(SDNode *N, SelectionDAG &DAG, bool IsAfterLegalization,
5512 bool IsAfterLegalTypes,
5513 SmallVectorImpl<SDNode *> &Created) const;
5514 // Build sdiv by power-of-2 with conditional move instructions
5515 SDValue buildSDIVPow2WithCMov(SDNode *N, const APInt &Divisor,
5516 SelectionDAG &DAG,
5517 SmallVectorImpl<SDNode *> &Created) const;
5518
5519 /// Targets may override this function to provide custom SDIV lowering for
5520 /// power-of-2 denominators. If the target returns an empty SDValue, LLVM
5521 /// assumes SDIV is expensive and replaces it with a series of other integer
5522 /// operations.
5523 virtual SDValue BuildSDIVPow2(SDNode *N, const APInt &Divisor,
5524 SelectionDAG &DAG,
5525 SmallVectorImpl<SDNode *> &Created) const;
5526
5527 /// Targets may override this function to provide custom SREM lowering for
5528 /// power-of-2 denominators. If the target returns an empty SDValue, LLVM
5529 /// assumes SREM is expensive and replaces it with a series of other integer
5530 /// operations.
5531 virtual SDValue BuildSREMPow2(SDNode *N, const APInt &Divisor,
5532 SelectionDAG &DAG,
5533 SmallVectorImpl<SDNode *> &Created) const;
5534
5535 /// Indicate whether this target prefers to combine FDIVs with the same
5536 /// divisor. If the transform should never be done, return zero. If the
5537 /// transform should be done, return the minimum number of divisor uses
5538 /// that must exist.
5539 virtual unsigned combineRepeatedFPDivisors() const {
5540 return 0;
5541 }
5542
5543 /// Hooks for building estimates in place of slower divisions and square
5544 /// roots.
5545
5546 /// Return either a square root or its reciprocal estimate value for the input
5547 /// operand.
5548 /// \p Enabled is a ReciprocalEstimate enum with value either 'Unspecified' or
5549 /// 'Enabled' as set by a potential default override attribute.
5550 /// If \p RefinementSteps is 'Unspecified', the number of Newton-Raphson
5551 /// refinement iterations required to generate a sufficient (though not
5552 /// necessarily IEEE-754 compliant) estimate is returned in that parameter.
5553 /// The boolean UseOneConstNR output is used to select a Newton-Raphson
5554 /// algorithm implementation that uses either one or two constants.
5555 /// The boolean Reciprocal is used to select whether the estimate is for the
5556 /// square root of the input operand or the reciprocal of its square root.
5557 /// A target may choose to implement its own refinement within this function.
5558 /// If that's true, then return '0' as the number of RefinementSteps to avoid
5559 /// any further refinement of the estimate.
5560 /// An empty SDValue return means no estimate sequence can be created.
5562 int Enabled, int &RefinementSteps,
5563 bool &UseOneConstNR, bool Reciprocal) const {
5564 return SDValue();
5565 }
5566
5567 /// Try to convert the fminnum/fmaxnum to a compare/select sequence. This is
5568 /// required for correctness since InstCombine might have canonicalized a
5569 /// fcmp+select sequence to a FMINNUM/FMAXNUM intrinsic. If we were to fall
5570 /// through to the default expansion/soften to libcall, we might introduce a
5571 /// link-time dependency on libm into a file that originally did not have one.
5572 SDValue createSelectForFMINNUM_FMAXNUM(SDNode *Node, SelectionDAG &DAG) const;
5573
5574 /// Return a reciprocal estimate value for the input operand.
5575 /// \p Enabled is a ReciprocalEstimate enum with value either 'Unspecified' or
5576 /// 'Enabled' as set by a potential default override attribute.
5577 /// If \p RefinementSteps is 'Unspecified', the number of Newton-Raphson
5578 /// refinement iterations required to generate a sufficient (though not
5579 /// necessarily IEEE-754 compliant) estimate is returned in that parameter.
5580 /// A target may choose to implement its own refinement within this function.
5581 /// If that's true, then return '0' as the number of RefinementSteps to avoid
5582 /// any further refinement of the estimate.
5583 /// An empty SDValue return means no estimate sequence can be created.
5585 int Enabled, int &RefinementSteps) const {
5586 return SDValue();
5587 }
5588
5589 /// Return a target-dependent comparison result if the input operand is
5590 /// suitable for use with a square root estimate calculation. For example, the
5591 /// comparison may check if the operand is NAN, INF, zero, normal, etc. The
5592 /// result should be used as the condition operand for a select or branch.
5593 virtual SDValue getSqrtInputTest(SDValue Operand, SelectionDAG &DAG,
5594 const DenormalMode &Mode,
5595 SDNodeFlags Flags = {}) const;
5596
5597 /// Return a target-dependent result if the input operand is not suitable for
5598 /// use with a square root estimate calculation.
5600 SelectionDAG &DAG) const {
5601 return DAG.getConstantFP(0.0, SDLoc(Operand), Operand.getValueType());
5602 }
5603
5604 //===--------------------------------------------------------------------===//
5605 // Legalization utility functions
5606 //
5607
5608 /// Expand a MUL or [US]MUL_LOHI of n-bit values into two or four nodes,
5609 /// respectively, each computing an n/2-bit part of the result.
5610 /// \param Result A vector that will be filled with the parts of the result
5611 /// in little-endian order.
5612 /// \param LL Low bits of the LHS of the MUL. You can use this parameter
5613 /// if you want to control how low bits are extracted from the LHS.
5614 /// \param LH High bits of the LHS of the MUL. See LL for meaning.
5615 /// \param RL Low bits of the RHS of the MUL. See LL for meaning
5616 /// \param RH High bits of the RHS of the MUL. See LL for meaning.
5617 /// \returns true if the node has been expanded, false if it has not
5618 bool expandMUL_LOHI(unsigned Opcode, EVT VT, const SDLoc &dl, SDValue LHS,
5619 SDValue RHS, SmallVectorImpl<SDValue> &Result, EVT HiLoVT,
5620 SelectionDAG &DAG, MulExpansionKind Kind,
5621 SDValue LL = SDValue(), SDValue LH = SDValue(),
5622 SDValue RL = SDValue(), SDValue RH = SDValue()) const;
5623
5624 /// Expand a MUL into two nodes. One that computes the high bits of
5625 /// the result and one that computes the low bits.
5626 /// \param HiLoVT The value type to use for the Lo and Hi nodes.
5627 /// \param LL Low bits of the LHS of the MUL. You can use this parameter
5628 /// if you want to control how low bits are extracted from the LHS.
5629 /// \param LH High bits of the LHS of the MUL. See LL for meaning.
5630 /// \param RL Low bits of the RHS of the MUL. See LL for meaning
5631 /// \param RH High bits of the RHS of the MUL. See LL for meaning.
5632 /// \returns true if the node has been expanded. false if it has not
5633 bool expandMUL(SDNode *N, SDValue &Lo, SDValue &Hi, EVT HiLoVT,
5634 SelectionDAG &DAG, MulExpansionKind Kind,
5635 SDValue LL = SDValue(), SDValue LH = SDValue(),
5636 SDValue RL = SDValue(), SDValue RH = SDValue()) const;
5637
5638 /// Attempt to expand an n-bit div/rem/divrem by constant using an n/2-bit
5639 /// algorithm. First, attempt to expand the division using a n/2-bit urem by
5640 /// constant and other arithmetic ops. The n/2-bit urem by constant will be
5641 /// expanded by DAGCombiner. As this is not possible for all constant
5642 /// divisors, this method falls back to an implementation of the magic
5643 /// algorithm using n/2-bit operations.
5644 /// \param N Node to expand
5645 /// \param Result A vector that will be filled with the lo and high parts of
5646 /// the results. For *DIVREM, this will be the quotient parts followed
5647 /// by the remainder parts.
5648 /// \param HiLoVT The value type to use for the Lo and Hi parts. Should be
5649 /// half of VT.
5650 /// \param LL Low bits of the LHS of the operation. You can use this
5651 /// parameter if you want to control how low bits are extracted from
5652 /// the LHS.
5653 /// \param LH High bits of the LHS of the operation. See LL for meaning.
5654 /// \returns true if the node has been expanded, false if it has not.
5655 bool expandDIVREMByConstant(SDNode *N, SmallVectorImpl<SDValue> &Result,
5656 EVT HiLoVT, SelectionDAG &DAG,
5657 SDValue LL = SDValue(),
5658 SDValue LH = SDValue()) const;
5659
5660 /// Expand funnel shift.
5661 /// \param N Node to expand
5662 /// \returns The expansion if successful, SDValue() otherwise
5663 SDValue expandFunnelShift(SDNode *N, SelectionDAG &DAG) const;
5664
5665 /// Expand carryless multiply.
5666 /// \param N Node to expand
5667 /// \returns The expansion if successful, SDValue() otherwise
5668 SDValue expandCLMUL(SDNode *N, SelectionDAG &DAG) const;
5669
5670 /// Expand parallel bit extract (compress).
5671 /// \param N Node to expand
5672 /// \returns The expansion if successful, SDValue() otherwise
5673 SDValue expandPEXT(SDNode *N, SelectionDAG &DAG) const;
5674
5675 /// Expand parallel bit deposit (expand).
5676 /// \param N Node to expand
5677 /// \returns The expansion if successful, SDValue() otherwise
5678 SDValue expandPDEP(SDNode *N, SelectionDAG &DAG) const;
5679
5680 /// Expand rotations.
5681 /// \param N Node to expand
5682 /// \param AllowVectorOps expand vector rotate, this should only be performed
5683 /// if the legalization is happening outside of LegalizeVectorOps
5684 /// \returns The expansion if successful, SDValue() otherwise
5685 SDValue expandROT(SDNode *N, bool AllowVectorOps, SelectionDAG &DAG) const;
5686
5687 /// Expand shift-by-parts.
5688 /// \param N Node to expand
5689 /// \param Lo lower-output-part after conversion
5690 /// \param Hi upper-output-part after conversion
5691 void expandShiftParts(SDNode *N, SDValue &Lo, SDValue &Hi,
5692 SelectionDAG &DAG) const;
5693
5694 /// Expand float(f32) to SINT(i64) conversion
5695 /// \param N Node to expand
5696 /// \param Result output after conversion
5697 /// \returns True, if the expansion was successful, false otherwise
5698 bool expandFP_TO_SINT(SDNode *N, SDValue &Result, SelectionDAG &DAG) const;
5699
5700 /// Expand float to UINT conversion
5701 /// \param N Node to expand
5702 /// \param Result output after conversion
5703 /// \param Chain output chain after conversion
5704 /// \returns True, if the expansion was successful, false otherwise
5705 bool expandFP_TO_UINT(SDNode *N, SDValue &Result, SDValue &Chain,
5706 SelectionDAG &DAG) const;
5707
5708 /// Expand UINT(i64) to double(f64) conversion
5709 /// \param N Node to expand
5710 /// \param Result output after conversion
5711 /// \param Chain output chain after conversion
5712 /// \returns True, if the expansion was successful, false otherwise
5713 bool expandUINT_TO_FP(SDNode *N, SDValue &Result, SDValue &Chain,
5714 SelectionDAG &DAG) const;
5715
5716 /// Expand fminnum/fmaxnum into fminnum_ieee/fmaxnum_ieee with quieted inputs.
5717 SDValue expandFMINNUM_FMAXNUM(SDNode *N, SelectionDAG &DAG) const;
5718
5719 /// Expand fminimum/fmaximum into multiple comparison with selects.
5720 SDValue expandFMINIMUM_FMAXIMUM(SDNode *N, SelectionDAG &DAG) const;
5721
5722 /// Expand fminimumnum/fmaximumnum into multiple comparison with selects.
5723 SDValue expandFMINIMUMNUM_FMAXIMUMNUM(SDNode *N, SelectionDAG &DAG) const;
5724
5725 /// Expand FP_TO_[US]INT_SAT into FP_TO_[US]INT and selects or min/max.
5726 /// \param N Node to expand
5727 /// \returns The expansion result
5728 SDValue expandFP_TO_INT_SAT(SDNode *N, SelectionDAG &DAG) const;
5729
5730 /// Truncate Op to ResultVT. If the result is exact, leave it alone. If it is
5731 /// not exact, force the result to be odd.
5732 /// \param ResultVT The type of result.
5733 /// \param Op The value to round.
5734 /// \returns The expansion result
5735 SDValue expandRoundInexactToOdd(EVT ResultVT, SDValue Op, const SDLoc &DL,
5736 SelectionDAG &DAG) const;
5737
5738 /// Expand round(fp) to fp conversion
5739 /// \param N Node to expand
5740 /// \returns The expansion result
5741 SDValue expandFP_ROUND(SDNode *Node, SelectionDAG &DAG) const;
5742
5743 /// Expand check for floating point class.
5744 /// \param ResultVT The type of intrinsic call result.
5745 /// \param Op The tested value.
5746 /// \param Test The test to perform.
5747 /// \param Flags The optimization flags.
5748 /// \returns The expansion result or SDValue() if it fails.
5749 SDValue expandIS_FPCLASS(EVT ResultVT, SDValue Op, FPClassTest Test,
5750 SDNodeFlags Flags, const SDLoc &DL,
5751 SelectionDAG &DAG) const;
5752
5753 /// Expand FCANONICALIZE to FMUL with 1.
5754 /// \param NodeNode to expand
5755 /// \returns The expansion result
5756 SDValue expandFCANONICALIZE(SDNode *Node, SelectionDAG &DAG) const;
5757
5758 /// Expand CONVERT_TO_ARBITRARY_FP using bit manipulation.
5759 /// \param Node Node to expand.
5760 /// \returns The expansion result, or SDValue() if fails.
5761 SDValue expandCONVERT_TO_ARBITRARY_FP(SDNode *Node, SelectionDAG &DAG) const;
5762
5763 /// Expand CONVERT_FROM_ARBITRARY_FP using bit manipulation.
5764 /// \param Node Node to expand.
5765 /// \returns The expansion result, or SDValue() if fails.
5766 SDValue expandCONVERT_FROM_ARBITRARY_FP(SDNode *Node,
5767 SelectionDAG &DAG) const;
5768
5769 /// Expand CTPOP nodes. Expands vector/scalar CTPOP nodes,
5770 /// vector nodes can only succeed if all operations are legal/custom.
5771 /// \param N Node to expand
5772 /// \returns The expansion result or SDValue() if it fails.
5773 SDValue expandCTPOP(SDNode *N, SelectionDAG &DAG) const;
5774
5775 /// Expand CTLZ/CTLZ_ZERO_POISON nodes. Expands vector/scalar CTLZ nodes,
5776 /// vector nodes can only succeed if all operations are legal/custom.
5777 /// \param N Node to expand
5778 /// \returns The expansion result or SDValue() if it fails.
5779 SDValue expandCTLZ(SDNode *N, SelectionDAG &DAG) const;
5780
5781 /// Expand CTLS (count leading sign bits) nodes.
5782 /// CTLS(x) = CTLZ(OR(SHL(XOR(x, SRA(x, BW-1)), 1), 1))
5783 /// \param N Node to expand
5784 /// \returns The expansion result or SDValue() if it fails.
5785 SDValue expandCTLS(SDNode *N, SelectionDAG &DAG) const;
5786
5787 /// Expand CTTZ via Table Lookup.
5788 /// \param N Node to expand
5789 /// \returns The expansion result or SDValue() if it fails.
5790 SDValue CTTZTableLookup(SDNode *N, SelectionDAG &DAG, const SDLoc &DL, EVT VT,
5791 SDValue Op, unsigned NumBitsPerElt) const;
5792
5793 /// Expand CTTZ/CTTZ_ZERO_POISON nodes. Expands vector/scalar CTTZ nodes,
5794 /// vector nodes can only succeed if all operations are legal/custom.
5795 /// \param N Node to expand
5796 /// \returns The expansion result or SDValue() if it fails.
5797 SDValue expandCTTZ(SDNode *N, SelectionDAG &DAG) const;
5798
5799 /// Expand VP_CTTZ_ELTS/VP_CTTZ_ELTS_ZERO_POISON nodes.
5800 /// \param N Node to expand
5801 /// \returns The expansion result or SDValue() if it fails.
5802 SDValue expandVPCTTZElements(SDNode *N, SelectionDAG &DAG) const;
5803
5804 /// Expand VECTOR_MATCH nodes.
5805 /// \param N Node to expand
5806 /// \returns The expansion result or SDValue() if it fails.
5807 SDValue expandVectorMatch(SDNode *N, SelectionDAG &DAG) const;
5808
5809 /// Expand VECTOR_FIND_LAST_ACTIVE nodes
5810 /// \param N Node to expand
5811 /// \returns The expansion result or SDValue() if it fails.
5812 SDValue expandVectorFindLastActive(SDNode *N, SelectionDAG &DAG) const;
5813
5814 /// Expand LOOP_DEPENDENCE_MASK nodes
5815 /// \param N Node to expand
5816 /// \returns The expansion result or SDValue() if it fails.
5817 SDValue expandLoopDependenceMask(SDNode *N, SelectionDAG &DAG) const;
5818
5819 /// Expand ABS nodes. Expands vector/scalar ABS nodes,
5820 /// vector nodes can only succeed if all operations are legal/custom.
5821 /// (ABS x) -> (XOR (ADD x, (SRA x, type_size)), (SRA x, type_size))
5822 /// \param N Node to expand
5823 /// \param IsNegative indicate negated abs
5824 /// \returns The expansion result or SDValue() if it fails.
5825 SDValue expandABS(SDNode *N, SelectionDAG &DAG,
5826 bool IsNegative = false) const;
5827
5828 /// Expand ABDS/ABDU nodes. Expands vector/scalar ABDS/ABDU nodes.
5829 /// \param N Node to expand
5830 /// \returns The expansion result or SDValue() if it fails.
5831 SDValue expandABD(SDNode *N, SelectionDAG &DAG) const;
5832
5833 /// Expand vector/scalar AVGCEILS/AVGCEILU/AVGFLOORS/AVGFLOORU nodes.
5834 /// \param N Node to expand
5835 /// \returns The expansion result or SDValue() if it fails.
5836 SDValue expandAVG(SDNode *N, SelectionDAG &DAG) const;
5837
5838 /// Expand BSWAP nodes. Expands scalar/vector BSWAP nodes with i16/i32/i64
5839 /// scalar types. Returns SDValue() if expand fails.
5840 /// \param N Node to expand
5841 /// \returns The expansion result or SDValue() if it fails.
5842 SDValue expandBSWAP(SDNode *N, SelectionDAG &DAG) const;
5843
5844 /// Expand BITREVERSE nodes. Expands scalar/vector BITREVERSE nodes.
5845 /// Returns SDValue() if expand fails.
5846 /// \param N Node to expand
5847 /// \returns The expansion result or SDValue() if it fails.
5848 SDValue expandBITREVERSE(SDNode *N, SelectionDAG &DAG) const;
5849
5850 /// Turn load of vector type into a load of the individual elements.
5851 /// \param LD load to expand
5852 /// \returns BUILD_VECTOR and TokenFactor nodes.
5853 std::pair<SDValue, SDValue> scalarizeVectorLoad(LoadSDNode *LD,
5854 SelectionDAG &DAG) const;
5855
5856 // Turn a store of a vector type into stores of the individual elements.
5857 /// \param ST Store with a vector value type
5858 /// \returns TokenFactor of the individual store chains.
5860
5861 /// Expands an unaligned load to 2 half-size loads for an integer, and
5862 /// possibly more for vectors.
5863 std::pair<SDValue, SDValue> expandUnalignedLoad(LoadSDNode *LD,
5864 SelectionDAG &DAG) const;
5865
5866 /// Expands an unaligned store to 2 half-size stores for integer values, and
5867 /// possibly more for vectors.
5868 SDValue expandUnalignedStore(StoreSDNode *ST, SelectionDAG &DAG) const;
5869
5870 /// Increments memory address \p Addr according to the type of the value
5871 /// \p DataVT that should be stored. If the data is stored in compressed
5872 /// form, the memory address should be incremented according to the number of
5873 /// the stored elements. This number is equal to the number of '1's bits
5874 /// in the \p Mask.
5875 /// \p DataVT is a vector type. \p Mask is a vector value.
5876 /// \p DataVT and \p Mask have the same number of vector elements.
5877 SDValue IncrementMemoryAddress(SDValue Addr, SDValue Mask, const SDLoc &DL,
5878 EVT DataVT, SelectionDAG &DAG,
5879 bool IsCompressedMemory) const;
5880
5881 /// Get a pointer to vector element \p Idx located in memory for a vector of
5882 /// type \p VecVT starting at a base address of \p VecPtr. If \p Idx is out of
5883 /// bounds the returned pointer is unspecified, but will be within the vector
5884 /// bounds. \p PtrArithFlags can be used to mark that arithmetic within the
5885 /// vector in memory is known to not wrap or to be inbounds.
5886 SDValue getVectorElementPointer(
5887 SelectionDAG &DAG, SDValue VecPtr, EVT VecVT, SDValue Index,
5888 const SDNodeFlags PtrArithFlags = SDNodeFlags()) const;
5889
5890 /// Get a pointer to vector element \p Idx located in memory for a vector of
5891 /// type \p VecVT starting at a base address of \p VecPtr. If \p Idx is out of
5892 /// bounds the returned pointer is unspecified, but will be within the vector
5893 /// bounds. \p VecPtr is guaranteed to point to the beginning of a memory
5894 /// location large enough for the vector.
5896 EVT VecVT, SDValue Index) const {
5897 return getVectorElementPointer(DAG, VecPtr, VecVT, Index,
5900 }
5901
5902 /// Get a pointer to a sub-vector of type \p SubVecVT at index \p Idx located
5903 /// in memory for a vector of type \p VecVT starting at a base address of
5904 /// \p VecPtr. If \p Idx plus the size of \p SubVecVT is out of bounds the
5905 /// returned pointer is unspecified, but the value returned will be such that
5906 /// the entire subvector would be within the vector bounds. \p PtrArithFlags
5907 /// can be used to mark that arithmetic within the vector in memory is known
5908 /// to not wrap or to be inbounds.
5909 SDValue
5910 getVectorSubVecPointer(SelectionDAG &DAG, SDValue VecPtr, EVT VecVT,
5911 EVT SubVecVT, SDValue Index,
5912 const SDNodeFlags PtrArithFlags = SDNodeFlags()) const;
5913
5914 /// Method for building the DAG expansion of ISD::[US][MIN|MAX]. This
5915 /// method accepts integers as its arguments.
5916 SDValue expandIntMINMAX(SDNode *Node, SelectionDAG &DAG) const;
5917
5918 /// Method for building the DAG expansion of ISD::[US][ADD|SUB]SAT. This
5919 /// method accepts integers as its arguments.
5920 SDValue expandAddSubSat(SDNode *Node, SelectionDAG &DAG) const;
5921
5922 /// Method for building the DAG expansion of ISD::[US]CMP. This
5923 /// method accepts integers as its arguments
5924 SDValue expandCMP(SDNode *Node, SelectionDAG &DAG) const;
5925
5926 /// Method for building the DAG expansion of ISD::[US]SHLSAT. This
5927 /// method accepts integers as its arguments.
5928 SDValue expandShlSat(SDNode *Node, SelectionDAG &DAG) const;
5929
5930 /// Method for building the DAG expansion of ISD::[U|S]MULFIX[SAT]. This
5931 /// method accepts integers as its arguments.
5932 SDValue expandFixedPointMul(SDNode *Node, SelectionDAG &DAG) const;
5933
5934 /// Method for building the DAG expansion of ISD::[US]DIVFIX[SAT]. This
5935 /// method accepts integers as its arguments.
5936 /// Note: This method may fail if the division could not be performed
5937 /// within the type. Clients must retry with a wider type if this happens.
5938 SDValue expandFixedPointDiv(unsigned Opcode, const SDLoc &dl,
5940 unsigned Scale, SelectionDAG &DAG) const;
5941
5942 /// Method for building the DAG expansion of ISD::U(ADD|SUB)O. Expansion
5943 /// always suceeds and populates the Result and Overflow arguments.
5944 void expandUADDSUBO(SDNode *Node, SDValue &Result, SDValue &Overflow,
5945 SelectionDAG &DAG) const;
5946
5947 /// Method for building the DAG expansion of ISD::S(ADD|SUB)O. Expansion
5948 /// always suceeds and populates the Result and Overflow arguments.
5949 void expandSADDSUBO(SDNode *Node, SDValue &Result, SDValue &Overflow,
5950 SelectionDAG &DAG) const;
5951
5952 /// Method for building the DAG expansion of ISD::[US]MULO. Returns whether
5953 /// expansion was successful and populates the Result and Overflow arguments.
5954 bool expandMULO(SDNode *Node, SDValue &Result, SDValue &Overflow,
5955 SelectionDAG &DAG) const;
5956
5957 /// Calculate the product twice the width of LHS and RHS. If HiLHS/HiRHS are
5958 /// non-null they will be included in the multiplication. The expansion works
5959 /// by splitting the 2 inputs into 4 pieces that we can multiply and add
5960 /// together without neding MULH or MUL_LOHI.
5961 void forceExpandMultiply(SelectionDAG &DAG, const SDLoc &dl, bool Signed,
5963 SDValue HiLHS = SDValue(),
5964 SDValue HiRHS = SDValue()) const;
5965
5966 /// Calculate full product of LHS and RHS either via a libcall or through
5967 /// brute force expansion of the multiplication. The expansion works by
5968 /// splitting the 2 inputs into 4 pieces that we can multiply and add together
5969 /// without needing MULH or MUL_LOHI.
5970 void forceExpandWideMUL(SelectionDAG &DAG, const SDLoc &dl, bool Signed,
5971 const SDValue LHS, const SDValue RHS, SDValue &Lo,
5972 SDValue &Hi) const;
5973
5974 /// Expand a VECREDUCE_* into an explicit calculation. If Count is specified,
5975 /// only the first Count elements of the vector are used.
5976 SDValue expandVecReduce(SDNode *Node, SelectionDAG &DAG) const;
5977
5978 /// Expand a VECREDUCE_SEQ_* into an explicit ordered calculation.
5979 SDValue expandVecReduceSeq(SDNode *Node, SelectionDAG &DAG) const;
5980
5981 /// Expand an SREM or UREM using SDIV/UDIV or SDIVREM/UDIVREM, if legal.
5982 /// Returns true if the expansion was successful.
5983 bool expandREM(SDNode *Node, SDValue &Result, SelectionDAG &DAG) const;
5984
5985 /// Method for building the DAG expansion of ISD::VECTOR_SPLICE. This
5986 /// method accepts vectors as its arguments.
5987 SDValue expandVectorSplice(SDNode *Node, SelectionDAG &DAG) const;
5988
5989 /// Expand a vector VECTOR_COMPRESS into a sequence of extract element, store
5990 /// temporarily, advance store position, before re-loading the final vector.
5991 SDValue expandVECTOR_COMPRESS(SDNode *Node, SelectionDAG &DAG) const;
5992
5993 /// Expand a CTTZ_ELTS or CTTZ_ELTS_ZERO_POISON by calculating (VL - i) for
5994 /// each active lane (i), getting the maximum and subtracting it from VL.
5995 SDValue expandCttzElts(SDNode *Node, SelectionDAG &DAG) const;
5996
5997 /// Expands PARTIAL_REDUCE_S/UMLA nodes to a series of simpler operations,
5998 /// consisting of zext/sext, extract_subvector, mul and add operations.
5999 SDValue expandPartialReduceMLA(SDNode *Node, SelectionDAG &DAG) const;
6000
6001 /// Expands a node with multiple results to an FP or vector libcall. The
6002 /// libcall is expected to take all the operands of the \p Node followed by
6003 /// output pointers for each of the results. \p CallRetResNo can be optionally
6004 /// set to indicate that one of the results comes from the libcall's return
6005 /// value.
6006 bool expandMultipleResultFPLibCall(
6007 SelectionDAG &DAG, RTLIB::Libcall LC, SDNode *Node,
6009 std::optional<unsigned> CallRetResNo = {}) const;
6010
6011 /// Legalize a SETCC with given LHS and RHS and condition code CC on the
6012 /// current target.
6013 ///
6014 /// If the SETCC has been legalized using AND / OR, then the legalized node
6015 /// will be stored in LHS. RHS and CC will be set to SDValue(). NeedInvert
6016 /// will be set to false.
6017 ///
6018 /// If the SETCC has been legalized by using getSetCCSwappedOperands(), then
6019 /// the values of LHS and RHS will be swapped, CC will be set to the new
6020 /// condition, and NeedInvert will be set to false.
6021 ///
6022 /// If the SETCC has been legalized using the inverse condcode, then LHS and
6023 /// RHS will be unchanged, CC will set to the inverted condcode, and
6024 /// NeedInvert will be set to true. The caller must invert the result of the
6025 /// SETCC with SelectionDAG::getLogicalNOT() or take equivalent action to swap
6026 /// the effect of a true/false result.
6027 ///
6028 /// \returns true if the SETCC has been legalized, false if it hasn't.
6029 bool LegalizeSetCCCondCode(SelectionDAG &DAG, EVT VT, SDValue &LHS,
6030 SDValue &RHS, SDValue &CC, bool &NeedInvert,
6031 const SDLoc &dl, SDValue &Chain,
6032 bool IsSignaling = false) const;
6033
6034 //===--------------------------------------------------------------------===//
6035 // Instruction Emitting Hooks
6036 //
6037
6038 /// This method should be implemented by targets that mark instructions with
6039 /// the 'usesCustomInserter' flag. These instructions are special in various
6040 /// ways, which require special support to insert. The specified MachineInstr
6041 /// is created but not inserted into any basic blocks, and this method is
6042 /// called to expand it into a sequence of instructions, potentially also
6043 /// creating new basic blocks and control flow.
6044 /// As long as the returned basic block is different (i.e., we created a new
6045 /// one), the custom inserter is free to modify the rest of \p MBB.
6046 virtual MachineBasicBlock *
6047 EmitInstrWithCustomInserter(MachineInstr &MI, MachineBasicBlock *MBB) const;
6048
6049 /// This method should be implemented by targets that mark instructions with
6050 /// the 'hasPostISelHook' flag. These instructions must be adjusted after
6051 /// instruction selection by target hooks. e.g. To fill in optional defs for
6052 /// ARM 's' setting instructions.
6053 virtual void AdjustInstrPostInstrSelection(MachineInstr &MI,
6054 SDNode *Node) const;
6055
6056 /// If this function returns true, SelectionDAGBuilder emits a
6057 /// LOAD_STACK_GUARD node when it is lowering Intrinsic::stackprotector.
6058 virtual bool useLoadStackGuardNode(const Module &M) const { return false; }
6059
6061 const SDLoc &DL) const {
6062 llvm_unreachable("not implemented for this target");
6063 }
6064
6065 /// Lower TLS global address SDNode for target independent emulated TLS model.
6066 virtual SDValue LowerToTLSEmulatedModel(const GlobalAddressSDNode *GA,
6067 SelectionDAG &DAG) const;
6068
6069 /// Expands target specific indirect branch for the case of JumpTable
6070 /// expansion.
6071 virtual SDValue expandIndirectJTBranch(const SDLoc &dl, SDValue Value,
6072 SDValue Addr, int JTI,
6073 SelectionDAG &DAG) const;
6074
6075 // seteq(x, 0) -> truncate(srl(ctlz(zext(x)), log2(#bits)))
6076 // If we're comparing for equality to zero and isCtlzFast is true, expose the
6077 // fact that this can be implemented as a ctlz/srl pair, so that the dag
6078 // combiner can fold the new nodes.
6079 SDValue lowerCmpEqZeroToCtlzSrl(SDValue Op, SelectionDAG &DAG) const;
6080
6081 // Return true if `X & Y eq/ne 0` is preferable to `X & Y ne/eq Y`
6083 return true;
6084 }
6085
6086 // Expand vector operation by dividing it into smaller length operations and
6087 // joining their results. SDValue() is returned when expansion did not happen.
6088 SDValue expandVectorNaryOpBySplitting(SDNode *Node, SelectionDAG &DAG) const;
6089
6090 /// Replace an extraction of a load with a narrowed load.
6091 ///
6092 /// \param ResultVT type of the result extraction.
6093 /// \param InVecVT type of the input vector to with bitcasts resolved.
6094 /// \param EltNo index of the vector element to load.
6095 /// \param OriginalLoad vector load that to be replaced.
6096 /// \returns \p ResultVT Load on success SDValue() on failure.
6097 SDValue scalarizeExtractedVectorLoad(EVT ResultVT, const SDLoc &DL,
6098 EVT InVecVT, SDValue EltNo,
6099 LoadSDNode *OriginalLoad,
6100 SelectionDAG &DAG) const;
6101
6102protected:
6103 void setTypeIdForCallsiteInfo(const CallBase *CB, MachineFunction &MF,
6104 MachineFunction::CallSiteInfo &CSInfo) const;
6105
6106private:
6107 SDValue foldSetCCWithAnd(EVT VT, SDValue N0, SDValue N1, ISD::CondCode Cond,
6108 const SDLoc &DL, DAGCombinerInfo &DCI) const;
6109 SDValue foldSetCCWithOr(EVT VT, SDValue N0, SDValue N1, ISD::CondCode Cond,
6110 const SDLoc &DL, DAGCombinerInfo &DCI) const;
6111 SDValue foldSetCCWithBinOp(EVT VT, SDValue N0, SDValue N1, ISD::CondCode Cond,
6112 const SDLoc &DL, DAGCombinerInfo &DCI) const;
6113
6114 SDValue optimizeSetCCOfSignedTruncationCheck(EVT SCCVT, SDValue N0,
6116 DAGCombinerInfo &DCI,
6117 const SDLoc &DL) const;
6118
6119 // (X & (C l>>/<< Y)) ==/!= 0 --> ((X <</l>> Y) & C) ==/!= 0
6120 SDValue optimizeSetCCByHoistingAndByConstFromLogicalShift(
6121 EVT SCCVT, SDValue N0, SDValue N1C, ISD::CondCode Cond,
6122 DAGCombinerInfo &DCI, const SDLoc &DL) const;
6123
6124 SDValue prepareUREMEqFold(EVT SETCCVT, SDValue REMNode,
6125 SDValue CompTargetNode, ISD::CondCode Cond,
6126 DAGCombinerInfo &DCI, const SDLoc &DL,
6127 SmallVectorImpl<SDNode *> &Created) const;
6128 SDValue buildUREMEqFold(EVT SETCCVT, SDValue REMNode, SDValue CompTargetNode,
6129 ISD::CondCode Cond, DAGCombinerInfo &DCI,
6130 const SDLoc &DL) const;
6131
6132 SDValue prepareSREMEqFold(EVT SETCCVT, SDValue REMNode,
6133 SDValue CompTargetNode, ISD::CondCode Cond,
6134 DAGCombinerInfo &DCI, const SDLoc &DL,
6135 SmallVectorImpl<SDNode *> &Created) const;
6136 SDValue buildSREMEqFold(EVT SETCCVT, SDValue REMNode, SDValue CompTargetNode,
6137 ISD::CondCode Cond, DAGCombinerInfo &DCI,
6138 const SDLoc &DL) const;
6139
6140 bool expandUDIVREMByConstantViaUREMDecomposition(
6141 SDNode *N, APInt Divisor, SmallVectorImpl<SDValue> &Result, EVT HiLoVT,
6142 SelectionDAG &DAG, SDValue LL, SDValue LH) const;
6143
6144 bool expandUDIVREMByConstantViaUMulHiMagic(SDNode *N, const APInt &Divisor,
6146 EVT HiLoVT, SelectionDAG &DAG,
6147 SDValue LL, SDValue LH) const;
6148};
6149
6150/// Given an LLVM IR type and return type attributes, compute the return value
6151/// EVTs and flags, and optionally also the offsets, if the return value is
6152/// being lowered to memory.
6153LLVM_ABI void GetReturnInfo(CallingConv::ID CC, Type *ReturnType,
6154 AttributeList attr,
6155 SmallVectorImpl<ISD::OutputArg> &Outs,
6156 const TargetLowering &TLI, const DataLayout &DL);
6157
6158} // end namespace llvm
6159
6160#endif // LLVM_CODEGEN_TARGETLOWERING_H
return SDValue()
assert(UImm &&(UImm !=~static_cast< T >(0)) &&"Invalid immediate!")
unsigned Imm
unsigned uint64_t
This file implements a class to represent arbitrary precision integral constant values and operations...
MachineBasicBlock & MBB
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
MachineBasicBlock MachineBasicBlock::iterator MBBI
Function Alias Analysis Results
Atomic ordering constants.
This file contains the simple types necessary to represent the attributes associated with functions a...
#define X(NUM, ENUM, NAME)
Definition ELF.h:857
block Block Frequency Analysis
static GCRegistry::Add< ShadowStackGC > C("shadow-stack", "Very portable GC for uncooperative code generators")
static GCRegistry::Add< CoreCLRGC > E("coreclr", "CoreCLR-compatible GC")
static GCRegistry::Add< OcamlGC > B("ocaml", "ocaml 3.10-compatible GC")
#define LLVM_ABI
Definition Compiler.h:215
#define LLVM_READONLY
Definition Compiler.h:330
This file defines the DenseMap class.
const HexagonInstrInfo * TII
IRTranslator LLVM IR MI
static bool ShrinkDemandedConstant(Instruction *I, unsigned OpNo, const APInt &Demanded)
Check to see if the specified operand of the specified instruction is a constant integer.
const AbstractManglingParser< Derived, Alloc >::OperatorInfo AbstractManglingParser< Derived, Alloc >::Ops[]
#define RegName(no)
lazy value info
Implement a low-level type suitable for MachineInstr level instruction selection.
#define F(x, y, z)
Definition MD5.cpp:54
#define I(x, y, z)
Definition MD5.cpp:57
Register const TargetRegisterInfo * TRI
Promote Memory to Register
Definition Mem2Reg.cpp:110
const uint64_t BitWidth
ConstantRange Range(APInt(BitWidth, Low), APInt(BitWidth, High))
uint64_t High
PowerPC Reduce CR logical Operation
const SmallVectorImpl< MachineOperand > & Cond
static cl::opt< RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode > Mode("regalloc-enable-advisor", cl::Hidden, cl::init(RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode::Default), cl::desc("Enable regalloc advisor mode"), cl::values(clEnumValN(RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode::Default, "default", "Default"), clEnumValN(RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode::Release, "release", "precompiled"), clEnumValN(RegAllocEvictionAdvisorAnalysisLegacy::AdvisorMode::Development, "development", "for training")))
static Type * getValueType(Value *V, bool LookThroughCmp=false)
Returns the "element type" of the given value/instruction V.
This file defines the SmallVector class.
static TableGen::Emitter::Opt Y("gen-skeleton-entry", EmitSkeleton, "Generate example skeleton entry")
static SymbolRef::Type getType(const Symbol *Sym)
Definition TapiFile.cpp:39
static SDValue scalarizeVectorStore(StoreSDNode *Store, MVT StoreVT, SelectionDAG &DAG)
Scalarize a vector store, bitcasting to TargetVT to determine the scalar type.
Value * RHS
Value * LHS
Class for arbitrary precision integers.
Definition APInt.h:78
unsigned getBitWidth() const
Return the number of bits in the APInt.
Definition APInt.h:1509
Represent a constant reference to an array (0 or more elements consecutively in memory),...
Definition ArrayRef.h:40
A cache of @llvm.assume calls within a function.
An instruction that atomically checks whether a specified value is in a memory location,...
an instruction that atomically reads a memory location, combines it with another value,...
bool isFloatingPointOperation() const
BinOp getOperation() const
This class holds the attributes for a particular argument, parameter, function, or return value.
Definition Attributes.h:407
LLVM_ABI bool getValueAsBool() const
Return the attribute's value as a boolean.
BlockFrequencyInfo pass uses BlockFrequencyInfoImpl implementation to estimate IR basic block frequen...
CCState - This class holds information needed while lowering arguments and return values.
CCValAssign - Represent assignment of one arg/retval to a location.
Base class for all callable instructions (InvokeInst and CallInst) Holds everything related to callin...
This class represents a function call, abstracting a target machine's calling convention.
This is the shared class of boolean and integer constants.
Definition Constants.h:87
This class represents a range of values.
This is an important base class in LLVM.
Definition Constant.h:43
A parsed version of the target data layout string in and methods for querying it.
Definition DataLayout.h:64
unsigned size() const
Definition DenseMap.h:172
constexpr bool isScalar() const
Exactly one element.
Definition TypeSize.h:320
This is a fast-path instruction selection class that generates poor code and doesn't support illegal ...
Definition FastISel.h:67
FunctionLoweringInfo - This contains information that is global to a function that is used when lower...
Class to represent function types.
unsigned getNumParams() const
Return the number of fixed parameters this function type requires.
bool isVarArg() const
Attribute getFnAttribute(Attribute::AttrKind Kind) const
Return the attribute for the given attribute kind.
Definition Function.cpp:762
Common base class shared among various IRBuilders.
Definition IRBuilder.h:114
A wrapper class for inspecting calls to intrinsic functions.
static LLT integer(unsigned SizeInBits)
This is an important class for using LLVM in a threaded context.
Definition LLVMContext.h:68
Tracks which library functions to use for a particular subtarget or function.
An instruction for reading from memory.
This class is used to represent ISD::LOAD nodes.
Represents a single loop in the control flow graph.
Definition LoopInfo.h:40
Context object for machine code objects.
Definition MCContext.h:83
Base class for the full range of assembler expressions which are needed for parsing.
Definition MCExpr.h:34
MCRegisterClass - Base class of TargetRegisterClass.
Machine Value Type.
@ INVALID_SIMPLE_VALUE_TYPE
SimpleValueType SimpleTy
uint64_t getScalarSizeInBits() const
bool isInteger() const
Return true if this is an integer or a vector integer type.
bool isPow2VectorType() const
Returns true if the given vector is a power of 2.
ElementCount getVectorElementCount() const
bool isFloatingPoint() const
Return true if this is a FP or a vector FP type.
bool isValid() const
Return true if this is a valid simple valuetype.
static MVT getIntegerVT(unsigned BitWidth)
Instructions::iterator instr_iterator
Representation of each machine instruction.
A description of a memory reference used in the backend.
Flags
Flags values. These may be or'd together.
MachineRegisterInfo - Keep track of information for virtual and physical registers,...
LLVM_ABI bool hasOneNonDBGUse(Register RegNo) const
hasOneNonDBGUse - Return true if there is exactly one non-Debug use of the specified register.
This is an abstract virtual class for memory operations.
A Module instance is used to store all the information related to an LLVM module.
Definition Module.h:67
Represent a mutable reference to an array (0 or more elements consecutively in memory),...
Definition ArrayRef.h:294
A discriminated union of two or more pointer types, with the discriminator in the low bits of the poi...
Analysis providing profile information.
Wrapper class representing virtual and physical registers.
Definition Register.h:20
Wrapper class for IR location info (IR ordering and DebugLoc) to be passed into SDNode creation funct...
Represents one node in the SelectionDAG.
bool hasOneUse() const
Return true if there is exactly one use of this node.
bool use_empty() const
Return true if there are no uses of this node.
Unlike LLVM values, Selection DAG nodes may return multiple values as the result of a computation.
SDNode * getNode() const
get the SDNode which holds the desired result
bool hasOneUse() const
Return true if there is exactly one node using value ResNo of Node, in exactly one operand.
EVT getValueType() const
Return the ValueType of the referenced return value.
const SDValue & getOperand(unsigned i) const
unsigned getOpcode() const
This is used to represent a portion of an LLVM function in a low-level Data Dependence DAG representa...
LLVM_ABI SDValue getConstantFP(double Val, const SDLoc &DL, EVT VT, bool isTarget=false)
Create a ConstantFPSDNode wrapping a constant value.
const DataLayout & getDataLayout() const
LLVM_ABI void RemoveDeadNode(SDNode *N)
Remove the specified node from the system.
LLVM_ABI SDValue getNode(unsigned Opcode, const SDLoc &DL, EVT VT, ArrayRef< SDUse > Ops)
Gets or creates the specified node.
LLVMContext * getContext() const
This instruction constructs a fixed permutation of two input vectors.
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
An instruction for storing to memory.
This class is used to represent ISD::STORE nodes.
Represent a constant reference to a string, i.e.
Definition StringRef.h:56
Multiway switch.
TargetInstrInfo - Interface to description of machine instruction set.
Provides information about what library functions are available for the current target.
ArgListEntry(Value *Val, SDValue Node=SDValue())
ArgListEntry(Value *Val, SDValue Node, Type *Ty)
Type * Ty
Same as OrigTy, or partially legalized for soft float libcalls.
Type * OrigTy
Original unlegalized argument type.
LegalizeTypeAction getTypeAction(MVT VT) const
void setTypeAction(MVT VT, LegalizeTypeAction Action)
This base class for TargetLowering contains the SelectionDAG-independent parts that can be used from ...
virtual Value * emitStoreConditional(IRBuilderBase &Builder, Value *Val, Value *Addr, AtomicOrdering Ord) const
Perform a store-conditional operation to Addr.
virtual bool isFMAFasterThanFMulAndFAdd(const MachineFunction &MF, EVT) const
Return true if an FMA operation is faster than a pair of fmul and fadd instructions.
bool isOperationExpand(unsigned Op, EVT VT) const
Return true if the specified operation is illegal on this target or unlikely to be made legal with cu...
EVT getMemValueType(const DataLayout &DL, Type *Ty, bool AllowUnknown=false) const
virtual bool enableAggressiveFMAFusion(LLT Ty) const
Return true if target always benefits from combining into FMA for a given value type.
virtual void emitBitTestAtomicRMWIntrinsic(AtomicRMWInst *AI) const
Perform a bit test atomicrmw using a target-specific intrinsic.
void setOperationAction(ArrayRef< unsigned > Ops, ArrayRef< MVT > VTs, LegalizeAction Action)
virtual bool requiresUniformRegister(MachineFunction &MF, const Value *) const
Allows target to decide about the register class of the specific value that is live outside the defin...
void setBooleanVectorContents(BooleanContent Ty)
Specify how the target extends the result of a vector boolean value from a vector of i1 to a wider ty...
virtual unsigned getVaListSizeInBits(const DataLayout &DL) const
Returns the size of the platform's va_list object.
virtual bool lowerDeinterleaveIntrinsicToLoad(Instruction *Load, Value *Mask, IntrinsicInst *DI, const APInt &GapMask) const
Lower a deinterleave intrinsic to a target specific load intrinsic.
void setOperationAction(unsigned Op, MVT VT, LegalizeAction Action)
Indicate that the specified operation does not work with the specified type and indicate what to do a...
virtual bool preferSextInRegOfTruncate(EVT TruncVT, EVT VT, EVT ExtVT) const
virtual bool decomposeMulByConstant(LLVMContext &Context, EVT VT, SDValue C) const
Return true if it is profitable to transform an integer multiplication-by-constant into simpler opera...
void setMaxDivRemBitWidthSupported(unsigned SizeInBits)
Set the size in bits of the maximum div/rem the backend supports.
virtual bool hasAndNot(SDValue X) const
Return true if the target has a bitwise and-not operation: X = ~A & B This can be used to simplify se...
ReciprocalEstimate
Reciprocal estimate status values used by the functions below.
bool PredictableSelectIsExpensive
Tells the code generator that select is more expensive than a branch if the branch is usually predict...
virtual bool isShuffleMaskLegal(ArrayRef< int >, EVT) const
Targets can use this to indicate that they only support some VECTOR_SHUFFLE operations,...
virtual bool isAtomicAlignmentSupported(Align Alignment, uint64_t SizeInBytes) const
Return true if the target supports an atomic access of SizeInBytes bytes at the given Alignment.
virtual bool enableAggressiveFMAFusion(EVT VT) const
Return true if target always benefits from combining into FMA for a given value type.
virtual bool isComplexDeinterleavingOperationSupported(ComplexDeinterleavingOperation Operation, Type *Ty) const
Does this target support complex deinterleaving with the given operation and type.
virtual bool shouldRemoveRedundantExtend(SDValue Op) const
Return true (the default) if it is profitable to remove a sext_inreg(x) where the sext is redundant,...
bool isIndexedStoreLegal(unsigned IdxMode, EVT VT) const
Return true if the specified indexed load is legal on this target.
SDValue promoteTargetBoolean(SelectionDAG &DAG, SDValue Bool, EVT ValVT) const
Promote the given target boolean to a target boolean of the given type.
virtual bool isFMADLegal(const SelectionDAG &DAG, const SDNode *N) const
Returns true if be combined with to form an ISD::FMAD.
virtual bool shouldReduceLoadWidth(SDNode *Load, ISD::LoadExtType ExtTy, EVT NewVT, std::optional< unsigned > ByteOffset=std::nullopt) const
Return true if it is profitable to reduce a load to a smaller type.
virtual bool hasStandaloneRem(EVT VT) const
Return true if the target can handle a standalone remainder operation.
virtual bool isExtFreeImpl(const Instruction *I) const
Return true if the extension represented by I is free.
EVT getValueType(const DataLayout &DL, Type *Ty, bool AllowUnknown=false) const
Return the EVT corresponding to this LLVM type.
LegalizeAction
This enum indicates whether operations are valid for a target, and if not, what action should be used...
virtual bool shouldExpandBuildVectorWithShuffles(EVT, unsigned DefinedValues) const
LegalizeAction getIndexedMaskedStoreAction(unsigned IdxMode, MVT VT) const
Return how the indexed store should be treated: either it is legal, needs to be promoted to a larger ...
virtual bool isSelectSupported(SelectSupportKind) const
CallingConv::ID getLibcallCallingConv(RTLIB::Libcall Call) const
Get the CallingConv that should be used for the specified libcall.
unsigned MaxStoresPerMemcpyOptSize
Likewise for functions with the OptSize attribute.
MachineBasicBlock * emitPatchPoint(MachineInstr &MI, MachineBasicBlock *MBB) const
Replace/modify any TargetFrameIndex operands with a targte-dependent sequence of memory operands that...
virtual bool isEqualityCmpFoldedWithSignedCmp() const
Return true if instruction generated for equality comparison is folded with instruction generated for...
virtual bool preferSelectsOverBooleanArithmetic(EVT VT) const
Should we prefer selects to doing arithmetic on boolean types.
virtual bool isLegalICmpImmediate(int64_t) const
Return true if the specified immediate is legal icmp immediate, that is the target has icmp instructi...
virtual bool convertSetCCLogicToBitwiseLogic(EVT VT) const
Use bitwise logic to make pairs of compares more efficient.
void setAtomicLoadExtAction(ArrayRef< unsigned > ExtTypes, MVT ValVT, ArrayRef< MVT > MemVTs, LegalizeAction Action)
virtual const TargetRegisterClass * getRegClassFor(MVT VT, bool isDivergent=false) const
Return the register class that should be used for the specified value type.
virtual bool shouldFormOverflowOp(unsigned Opcode, EVT VT, bool MathUsed) const
Try to convert math with an overflow comparison into the corresponding DAG node operation.
ShiftLegalizationStrategy
Return the preferred strategy to legalize tihs SHIFT instruction, with ExpansionFactor being the recu...
virtual bool isVectorLoadExtDesirable(SDValue ExtVal) const
Return true if folding a vector load into ExtVal (a sign, zero, or any extend node) is profitable.
virtual bool isMaskAndCmp0FoldingBeneficial(const Instruction &AndI) const
Return if the target supports combining a chain like:
virtual Value * createComplexDeinterleavingIR(IRBuilderBase &B, ComplexDeinterleavingOperation OperationType, ComplexDeinterleavingRotation Rotation, Value *InputA, Value *InputB, Value *Accumulator=nullptr) const
Create the IR node for the given complex deinterleaving operation.
virtual bool shouldConvertConstantLoadToIntImm(const APInt &Imm, Type *Ty) const
Return true if it is beneficial to convert a load of a constant to just the constant itself.
virtual MVT::SimpleValueType getCmpLibcallReturnType() const
Return the ValueType for comparison libcalls.
virtual bool isSupportedFixedPointOperation(unsigned Op, EVT VT, unsigned Scale) const
Custom method defined by each target to indicate if an operation which may require a scale is support...
void setLoadExtAction(ArrayRef< unsigned > ExtTypes, MVT ValVT, MVT MemVT, LegalizeAction Action)
unsigned getMaximumLegalStoreInBits() const
Return maximum known-legal store size, which can be guaranteed for scalable vectors.
virtual bool shouldOptimizeMulOverflowWithZeroHighBits(LLVMContext &Context, EVT VT) const
virtual AtomicExpansionKind shouldExpandAtomicRMWInIR(const AtomicRMWInst *RMW) const
Returns how the IR-level AtomicExpand pass should expand the given AtomicRMW, if at all.
virtual Sched::Preference getSchedulingPreference(SDNode *) const
Some scheduler, e.g.
virtual MachineInstr * EmitKCFICheck(MachineBasicBlock &MBB, MachineBasicBlock::instr_iterator &MBBI, const TargetInstrInfo *TII) const
void setMinStackArgumentAlignment(Align Alignment)
Set the minimum stack alignment of an argument.
bool isExtLoad(const LoadInst *Load, const Instruction *Ext, const DataLayout &DL) const
Return true if Load and Ext can form an ExtLoad.
LegalizeTypeAction getTypeAction(MVT VT) const
virtual bool isLegalScaleForGatherScatter(uint64_t Scale, uint64_t ElemSize) const
EVT getTypeToExpandTo(LLVMContext &Context, EVT VT) const
For types supported by the target, this is an identity function.
virtual bool isSExtCheaperThanZExt(EVT FromTy, EVT ToTy) const
Return true if sign-extension from FromTy to ToTy is cheaper than zero-extension.
virtual bool shouldInsertFencesForAtomic(const Instruction *I) const
Whether AtomicExpandPass should automatically insert fences and reduce ordering for this atomic.
virtual AtomicOrdering atomicOperationOrderAfterFenceSplit(const Instruction *I) const
MVT getVectorIdxTy(const DataLayout &DL) const
Returns the type to be used for the index operand of: ISD::INSERT_VECTOR_ELT, ISD::EXTRACT_VECTOR_ELT...
bool isOperationExpandOrLibCall(unsigned Op, EVT VT) const
virtual bool allowsMisalignedMemoryAccesses(LLT, unsigned AddrSpace=0, Align Alignment=Align(1), MachineMemOperand::Flags Flags=MachineMemOperand::MONone, unsigned *=nullptr) const
LLT handling variant.
virtual bool isSafeMemOpType(MVT) const
Returns true if it's safe to use load / store of the specified type to expand memcpy / memset inline.
virtual void emitExpandAtomicCmpXchg(AtomicCmpXchgInst *CI) const
Perform a cmpxchg expansion using a target-specific method.
virtual ISD::NodeType getExtendForAtomicRMWArg(unsigned Op) const
Returns how the platform's atomic rmw operations expect their input argument to be extended (ZERO_EXT...
const TargetMachine & getTargetMachine() const
unsigned MaxLoadsPerMemcmp
Specify maximum number of load instructions per memcmp call.
virtual unsigned getNumRegistersForCallingConv(LLVMContext &Context, CallingConv::ID CC, EVT VT) const
Certain targets require unusual breakdowns of certain types.
bool rangeFitsInWord(const APInt &Low, const APInt &High, const DataLayout &DL) const
Check whether the range [Low,High] fits in a machine word.
virtual bool isCtpopFast(EVT VT) const
Return true if ctpop instruction is fast.
virtual MachineMemOperand::Flags getTargetMMOFlags(const Instruction &I) const
This callback is used to inspect load/store instructions and add target-specific MachineMemOperand fl...
virtual Register getExceptionSelectorRegister(ExceptionHandling EH, const Constant *PersonalityFn) const
If a physical register, this returns the register that receives the exception typeid on entry to a la...
unsigned MaxGluedStoresPerMemcpy
Specify max number of store instructions to glue in inlined memcpy.
virtual bool isZExtFree(Type *FromTy, Type *ToTy) const
Return true if any actual instruction that defines a value of type FromTy implicitly zero-extends the...
bool isPaddedAtMostSignificantBitsWhenStored(EVT VT) const
Indicates if any padding is guaranteed to go at the most significant bits when storing the type to me...
virtual MVT getRegisterTypeForCallingConv(LLVMContext &Context, CallingConv::ID CC, EVT VT) const
Certain combinations of ABIs, Targets and features require that types are legal for some operations a...
void setOperationPromotedToType(unsigned Opc, MVT OrigVT, MVT DestVT)
Convenience method to set an operation to Promote and specify the type in a single call.
LegalizeTypeAction
This enum indicates whether a types are legal for a target, and if not, what action should be used to...
virtual bool useStackGuardMixFP() const
If this function returns true, stack protection checks should mix the frame pointer (or whichever poi...
unsigned getMinCmpXchgSizeInBits() const
Returns the size of the smallest cmpxchg or ll/sc instruction the backend supports.
virtual Value * emitMaskedAtomicRMWIntrinsic(IRBuilderBase &Builder, AtomicRMWInst *AI, Value *AlignedAddr, Value *Incr, Value *Mask, Value *ShiftAmt, AtomicOrdering Ord) const
Perform a masked atomicrmw using a target-specific intrinsic.
virtual bool areJTsAllowed(const Function *Fn) const
Return true if lowering to a jump table is allowed.
virtual LegalizeAction getCustomTruncStoreAction(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace) const
Returns an alternative action to use when the coarser lookups (configured through setTruncStoreAction...
bool enableExtLdPromotion() const
Return true if the target wants to use the optimization that turns ext(promotableInst1(....
virtual bool isFPExtFoldable(const MachineInstr &MI, unsigned Opcode, LLT DestTy, LLT SrcTy) const
Return true if an fpext operation input to an Opcode operation is free (for instance,...
void setIndexedMaskedLoadAction(unsigned IdxMode, MVT VT, LegalizeAction Action)
Indicate that the specified indexed masked load does or does not work with the specified type and ind...
void setMaxBytesForAlignment(unsigned MaxBytes)
bool isOperationLegalOrPromote(unsigned Op, EVT VT, bool LegalOnly=false) const
Return true if the specified operation is legal on this target or can be made legal using promotion.
void setHasExtractBitsInsn(bool hasExtractInsn=true)
Tells the code generator that the target has BitExtract instructions.
void addBypassSlowDiv(unsigned int SlowBitWidth, unsigned int FastBitWidth)
Tells the code generator which bitwidths to bypass.
virtual bool hasBitTest(SDValue X, SDValue Y) const
Return true if the target has a bit-test instruction: (X & (1 << Y)) ==/!= 0 This knowledge can be us...
MVT getRegisterType(LLVMContext &Context, EVT VT) const
Return the type of registers that this ValueType will eventually require.
virtual AtomicExpansionKind shouldExpandAtomicCmpXchgInIR(const AtomicCmpXchgInst *AI) const
Returns how the given atomic cmpxchg should be expanded by the IR-level AtomicExpand pass.
virtual bool needsFixedCatchObjects() const
virtual bool isAnyExtFree(EVT FromTy, EVT ToTy) const
Return true is an anyext is free from FromTy to ToTy.
EVT getLegalTypeToTransformTo(LLVMContext &Context, EVT VT) const
Perform getTypeToTransformTo repeatedly until a legal type is obtained.
virtual Value * emitLoadLinked(IRBuilderBase &Builder, Type *ValueTy, Value *Addr, AtomicOrdering Ord) const
Perform a load-linked operation on Addr, returning a "Value *" with the corresponding pointee type.
void setMaxLargeFPConvertBitWidthSupported(unsigned SizeInBits)
Set the size in bits of the maximum fp to/from int conversion the backend supports.
const LibcallLoweringInfo & getLibcallLoweringInfo() const
virtual unsigned getNumRegisters(LLVMContext &Context, EVT VT, std::optional< MVT > RegisterVT=std::nullopt) const
Return the number of registers that this ValueType will eventually require.
virtual bool isCheapToSpeculateCttz(Type *Ty) const
Return true if it is cheap to speculate a call to intrinsic cttz.
unsigned getMinimumBitTestCmps() const
Retuen the minimum of largest number of comparisons in BitTest.
bool isJumpExpensive() const
Return true if Flow Control is an expensive operation that should be avoided.
virtual bool useFPRegsForHalfType() const
LegalizeAction getCondCodeAction(ISD::CondCode CC, MVT VT) const
Return how the condition code should be treated: either it is legal, needs to be expanded to some oth...
bool hasExtractBitsInsn() const
Return true if the target has BitExtract instructions.
virtual bool isLoadBitCastBeneficial(EVT LoadVT, EVT BitcastVT, const SelectionDAG &DAG, const MachineMemOperand &MMO) const
Return true if the following transform is beneficial: fold (conv (load x)) -> (load (conv*)x) On arch...
LegalizeAction getIndexedStoreAction(unsigned IdxMode, MVT VT) const
Return how the indexed store should be treated: either it is legal, needs to be promoted to a larger ...
void setIndexedLoadAction(ArrayRef< unsigned > IdxModes, MVT VT, LegalizeAction Action)
Indicate that the specified indexed load does or does not work with the specified type and indicate w...
CallingConv::ID getLibcallImplCallingConv(RTLIB::LibcallImpl Call) const
Get the CallingConv that should be used for the specified libcall implementation.
void setPrefLoopAlignment(Align Alignment)
Set the target's preferred loop alignment.
virtual bool areTwoSDNodeTargetMMOFlagsMergeable(const MemSDNode &NodeX, const MemSDNode &NodeY) const
Return true if it is valid to merge the TargetMMOFlags in two SDNodes.
virtual bool isCommutativeBinOp(unsigned Opcode) const
Returns true if the opcode is a commutative binary operation.
void setMaxAtomicSizeInBitsSupported(unsigned SizeInBits)
Set the maximum atomic operation size supported by the backend.
virtual bool isFPImmLegal(const APFloat &, EVT, bool ForCodeSize=false) const
Returns true if the target can instruction select the specified FP immediate natively.
LegalizeAction getTruncStoreAction(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace) const
Return how this store with truncation should be treated: either it is legal, needs to be promoted to ...
virtual unsigned getPreferredFPToIntOpcode(unsigned Op, EVT FromVT, EVT ToVT) const
virtual bool isExtractVecEltCheap(EVT VT, unsigned Index) const
Return true if extraction of a scalar element from the given vector type at the given index is cheap.
void setOperationAction(ArrayRef< unsigned > Ops, MVT VT, LegalizeAction Action)
virtual bool optimizeFMulOrFDivAsShiftAddBitcast(SDNode *N, SDValue FPConst, SDValue IntPow2) const
SelectSupportKind
Enum that describes what type of support for selects the target has.
RTLIB::LibcallImpl getMemcpyImpl() const
LegalizeAction getIndexedLoadAction(unsigned IdxMode, MVT VT) const
Return how the indexed load should be treated: either it is legal, needs to be promoted to a larger s...
virtual bool shouldTransformSignedTruncationCheck(EVT XVT, unsigned KeptBits) const
Should we tranform the IR-optimal check for whether given truncation down into KeptBits would be trun...
virtual bool isFPExtFoldable(const SelectionDAG &DAG, unsigned Opcode, EVT DestVT, EVT SrcVT) const
Return true if an fpext operation input to an Opcode operation is free (for instance,...
bool isLegalRC(const TargetRegisterInfo &TRI, const TargetRegisterClass &RC) const
Return true if the value types that can be represented by the specified register class are all legal.
virtual TargetLoweringBase::LegalizeTypeAction getPreferredVectorAction(MVT VT) const
Return the preferred vector type legalization action.
virtual bool allowTruncateForTailCall(Type *FromTy, Type *ToTy) const
Return true if a truncation from FromTy to ToTy is permitted when deciding whether a call is in tail ...
void setAtomicLoadExtAction(unsigned ExtType, MVT ValVT, MVT MemVT, LegalizeAction Action)
Let target indicate that an extending atomic load of the specified type is legal.
virtual bool shouldExtendGSIndex(EVT VT, EVT &EltTy) const
Returns true if the index type for a masked gather/scatter requires extending.
virtual unsigned getVectorTypeBreakdownForCallingConv(LLVMContext &Context, CallingConv::ID CC, EVT VT, EVT &IntermediateVT, unsigned &NumIntermediates, MVT &RegisterVT) const
Certain targets such as MIPS require that some types such as vectors are always broken down into scal...
Register getStackPointerRegisterToSaveRestore() const
If a physical register, this specifies the register that llvm.savestack/llvm.restorestack should save...
virtual StringRef getStackProbeSymbolName(const MachineFunction &MF) const
LegalizeAction getFixedPointOperationAction(unsigned Op, EVT VT, unsigned Scale) const
Some fixed point operations may be natively supported by the target but only for specific scales.
virtual bool preferScalarizeSplat(SDNode *N) const
bool isIndexedMaskedLoadLegal(unsigned IdxMode, EVT VT) const
Return true if the specified indexed load is legal on this target.
virtual ISD::NodeType getExtendForAtomicOps() const
Returns how the platform's atomic operations are extended (ZERO_EXTEND, SIGN_EXTEND,...
Sched::Preference getSchedulingPreference() const
Return target scheduling preference.
virtual bool allowsMisalignedMemoryAccesses(EVT, unsigned AddrSpace=0, Align Alignment=Align(1), MachineMemOperand::Flags Flags=MachineMemOperand::MONone, unsigned *=nullptr) const
Determine if the target supports unaligned memory accesses.
virtual LLT getOptimalMemOpLLT(const MemOp &Op, const AttributeList &) const
LLT returning variant.
void setMinFunctionAlignment(Align Alignment)
Set the target's minimum function alignment.
bool isOperationCustom(unsigned Op, EVT VT) const
Return true if the operation uses custom lowering, regardless of whether the type is legal or not.
virtual ExtractSubvectorCost getExtractSubvectorCost(EVT ResVT, EVT SrcVT, unsigned Index) const
Return the cost of extracting a subvector of type ResVT from a vector of type SrcVT,...
virtual void emitExpandAtomicRMW(AtomicRMWInst *AI) const
Perform a atomicrmw expansion using a target-specific way.
unsigned MaxStoresPerMemsetOptSize
Likewise for functions with the OptSize attribute.
virtual bool reduceSelectOfFPConstantLoads(EVT CmpOpVT) const
Return true if it is profitable to convert a select of FP constants into a constant pool load whose a...
bool hasBigEndianPartOrdering(EVT VT, const DataLayout &DL) const
When splitting a value of the specified type into parts, does the Lo or Hi part come first?
virtual bool hasStackProbeSymbol(const MachineFunction &MF) const
Returns the name of the symbol used to emit stack probes or the empty string if not applicable.
bool isSlowDivBypassed() const
Returns true if target has indicated at least one type should be bypassed.
virtual Align getABIAlignmentForCallingConv(Type *ArgTy, const DataLayout &DL) const
Certain targets have context sensitive alignment requirements, where one type has the alignment requi...
virtual bool isMulAddWithConstProfitable(SDValue AddNode, SDValue ConstNode) const
Return true if it may be profitable to transform (mul (add x, c1), c2) -> (add (mul x,...
virtual bool shouldExtendTypeInLibCall(EVT Type) const
Returns true if arguments should be extended in lib calls.
void setBooleanContents(BooleanContent Ty)
Specify how the target extends the result of integer and floating point boolean values from i1 to a w...
bool isPartialReduceMLALegalOrCustom(unsigned Opc, EVT AccVT, EVT InputVT) const
Return true if a PARTIAL_REDUCE_U/SMLA node with the specified types is legal or custom for this targ...
virtual bool isFsqrtCheap(SDValue X, SelectionDAG &DAG) const
Return true if SQRT(X) shouldn't be replaced with X*RSQRT(X).
unsigned MaxStoresPerMemmove
Specify maximum number of store instructions per memmove call.
virtual bool shouldNormalizeToSelectSequence(LLVMContext &Context, EVT VT, EVT CCVT) const
Returns true if we should normalize select(N0&N1, X, Y) => select(N0, select(N1, X,...
bool isSuitableForBitTests(const DenseMap< const BasicBlock *, unsigned int > &DestCmps, const APInt &Low, const APInt &High, const DataLayout &DL) const
Return true if lowering to a bit test is suitable for a set of case clusters which contains NumDests ...
virtual bool shouldExpandGetActiveLaneMask(EVT VT, EVT OpVT) const
Return true if the @llvm.get.active.lane.mask intrinsic should be expanded using generic code in Sele...
virtual bool shallExtractConstSplatVectorElementToStore(Type *VectorTy, unsigned ElemSizeInBits, unsigned &Index) const
Return true if the target shall perform extract vector element and store given that the vector is kno...
virtual bool isTruncateFree(Type *FromTy, Type *ToTy) const
Return true if it's free to truncate a value of type FromTy to type ToTy.
virtual bool hasMultipleConditionRegisters(EVT VT) const
Does the target have multiple (allocatable) condition registers that can be used to store the results...
unsigned getMaxExpandSizeMemcmp(bool OptSize) const
Get maximum # of load operations permitted for memcmp.
bool isStrictFPEnabled() const
Return true if the target support strict float operation.
virtual bool shouldAvoidTransformToShift(EVT VT, unsigned Amount) const
Return true if creating a shift of the type by the given amount is not profitable.
virtual bool shouldPreservePtrArith(const Function &F, EVT PtrVT) const
True if target has some particular form of dealing with pointer arithmetic semantics for pointers wit...
virtual bool isFPExtFree(EVT DestVT, EVT SrcVT) const
Return true if an fpext operation is free (for instance, because single-precision floating-point numb...
virtual EVT getSetCCResultType(const DataLayout &DL, LLVMContext &Context, EVT VT) const
Return the ValueType of the result of SETCC operations.
virtual bool lowerInterleavedStore(Instruction *Store, Value *Mask, ShuffleVectorInst *SVI, unsigned Factor, const APInt &GapMask) const
Lower an interleaved store to target specific intrinsics.
virtual EVT getTypeToTransformTo(LLVMContext &Context, EVT VT) const
For types supported by the target, this is an identity function.
unsigned MaxStoresPerMemmoveOptSize
Likewise for functions with the OptSize attribute.
virtual bool shouldFoldSelectWithSingleBitTest(EVT VT, const APInt &AndMask) const
MVT getSimpleValueType(const DataLayout &DL, Type *Ty, bool AllowUnknown=false) const
Return the MVT corresponding to this LLVM type. See getValueType.
BooleanContent getBooleanContents(bool isVec, bool isFloat) const
For targets without i1 registers, this gives the nature of the high-bits of boolean values held in ty...
virtual bool shouldReassociateReduction(unsigned RedOpc, EVT VT) const
void addRegisterClass(MVT VT, const TargetRegisterClass *RC)
Add the specified register class as an available regclass for the specified value type.
virtual CondMergingParams getJumpConditionMergingParams(Instruction::BinaryOps, const Value *, const Value *, const Function *) const
bool isCondCodeLegal(ISD::CondCode CC, MVT VT) const
Return true if the specified condition code is legal for a comparison of the specified types on this ...
virtual bool canCombineStoreAndExtract(Type *VectorTy, Value *Idx, unsigned &Cost) const
Return true if the target can combine store(extractelement VectorTy,Idx).
bool isTypeLegal(EVT VT) const
Return true if the target has native support for the specified value type.
virtual bool shouldFoldConstantShiftPairToMask(const SDNode *N) const
Return true if it is profitable to fold a pair of shifts into a mask.
MVT getProgramPointerTy(const DataLayout &DL) const
Return the type for code pointers, which is determined by the program address space specified through...
void setIndexedStoreAction(ArrayRef< unsigned > IdxModes, MVT VT, LegalizeAction Action)
Indicate that the specified indexed store does or does not work with the specified type and indicate ...
ExtractSubvectorCost
Enum that specifies how expensive lowering an EXTRACT_SUBVECTOR is.
virtual void emitAtomicCmpXchgNoStoreLLBalance(IRBuilderBase &Builder) const
void setSupportsUnalignedAtomics(bool UnalignedSupported)
Sets whether unaligned atomic operations are supported.
void setLoadExtAction(ArrayRef< unsigned > ExtTypes, MVT ValVT, ArrayRef< MVT > MemVTs, LegalizeAction Action)
virtual void emitExpandAtomicStore(StoreInst *SI) const
Perform a atomic store using a target-specific way.
virtual bool preferIncOfAddToSubOfNot(EVT VT) const
These two forms are equivalent: sub y, (xor x, -1) add (add x, 1), y The variant with two add's is IR...
virtual bool ShouldShrinkFPConstant(EVT) const
If true, then instruction selection should seek to shrink the FP constant of the specified type to a ...
virtual MVT getPointerTy(const DataLayout &DL, uint32_t AS=0) const
Return the pointer type for the given address space, defaults to the pointer type from the data layou...
void setPrefFunctionAlignment(Align Alignment)
Set the target's preferred function alignment.
unsigned getMaxDivRemBitWidthSupported() const
Returns the size in bits of the maximum div/rem the backend supports.
virtual bool isLegalAddImmediate(int64_t) const
Return true if the specified immediate is legal add immediate, that is the target has add instruction...
virtual unsigned getMaxSupportedInterleaveFactor() const
Get the maximum supported factor for interleaved memory accesses.
bool isOperationLegal(unsigned Op, EVT VT) const
Return true if the specified operation is legal on this target.
virtual bool shouldKeepZExtForFP16Conv() const
Does this target require the clearing of high-order bits in a register passed to the fp16 to fp conve...
virtual AtomicExpansionKind shouldCastAtomicRMWIInIR(AtomicRMWInst *RMWI) const
Returns how the given atomic atomicrmw should be cast by the IR-level AtomicExpand pass.
void setIndexedMaskedStoreAction(unsigned IdxMode, MVT VT, LegalizeAction Action)
Indicate that the specified indexed masked store does or does not work with the specified type and in...
virtual bool canTransformPtrArithOutOfBounds(const Function &F, EVT PtrVT) const
True if the target allows transformations of in-bounds pointer arithmetic that cause out-of-bounds in...
virtual bool shouldConsiderGEPOffsetSplit() const
const ValueTypeActionImpl & getValueTypeActions() const
virtual bool canCombineTruncStore(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace, bool LegalOnly) const
TargetLoweringBase(const TargetMachine &TM, const TargetSubtargetInfo &STI)
NOTE: The TargetMachine owns TLOF.
unsigned MaxStoresPerMemset
Specify maximum number of store instructions per memset call.
virtual bool isTruncateFree(SDValue Val, EVT VT2) const
Return true if truncating the specific node Val to type VT2 is free.
virtual bool isProfitableToCombineMinNumMaxNum(EVT VT) const
virtual unsigned getCustomCtpopCost(EVT VT, ISD::CondCode Cond) const
Return the maximum number of "x & (x - 1)" operations that can be done instead of deferring to a cust...
virtual bool shouldProduceAndByConstByHoistingConstFromShiftsLHSOfAnd(SDValue X, ConstantSDNode *XC, ConstantSDNode *CC, SDValue Y, unsigned OldShiftOpcode, unsigned NewShiftOpcode, SelectionDAG &DAG) const
Given the pattern (X & (C l>>/<< Y)) ==/!= 0 return true if it should be transformed into: ((X <</l>>...
virtual bool shouldInsertTrailingSeqCstFenceForAtomicStore(const Instruction *I) const
Whether AtomicExpandPass should automatically insert a seq_cst trailing fence without reducing the or...
virtual bool isFNegFree(EVT VT) const
Return true if an fneg operation is free to the point where it is never worthwhile to replace it with...
void setPartialReduceMLAAction(unsigned Opc, MVT AccVT, MVT InputVT, LegalizeAction Action)
Indicate how a PARTIAL_REDUCE_U/SMLA node with Acc type AccVT and Input type InputVT should be treate...
virtual AtomicExpansionKind shouldExpandAtomicLoadInIR(LoadInst *LI) const
Returns how the given (atomic) load should be expanded by the IR-level AtomicExpand pass.
void setTruncStoreAction(MVT ValVT, MVT MemVT, LegalizeAction Action)
Indicate that the specified truncating store does not work with the specified type and indicate what ...
bool isExtFree(const Instruction *I) const
Return true if the extension represented by I is free.
virtual MVT getFenceOperandTy(const DataLayout &DL) const
Return the type for operands of fence.
virtual Value * emitMaskedAtomicCmpXchgIntrinsic(IRBuilderBase &Builder, AtomicCmpXchgInst *CI, Value *AlignedAddr, Value *CmpVal, Value *NewVal, Value *Mask, AtomicOrdering Ord) const
Perform a masked cmpxchg using a target-specific intrinsic.
virtual bool isZExtFree(EVT FromTy, EVT ToTy) const
virtual ISD::NodeType getExtendForAtomicCmpSwapArg() const
Returns how the platform's atomic compare and swap expects its comparison value to be extended (ZERO_...
virtual bool shouldFoldSelectWithIdentityConstant(unsigned BinOpcode, EVT VT, unsigned SelectOpcode, SDValue X, SDValue Y) const
Return true if pulling a binary operation into a select with an identity constant is profitable.
BooleanContent
Enum that describes how the target represents true/false values.
virtual bool shouldExpandGetVectorLength(EVT CountVT, unsigned VF, bool IsScalable) const
virtual bool isIntDivCheap(EVT VT, AttributeList Attr) const
Return true if integer divide is usually cheaper than a sequence of several shifts,...
virtual ShiftLegalizationStrategy preferredShiftLegalizationStrategy(SelectionDAG &DAG, SDNode *N, unsigned ExpansionFactor) const
virtual uint8_t getRepRegClassCostFor(MVT VT) const
Return the cost of the 'representative' register class for the specified value type.
virtual bool isZExtFree(LLT FromTy, LLT ToTy, LLVMContext &Ctx) const
bool isOperationLegalOrCustom(unsigned Op, EVT VT, bool LegalOnly=false) const
Return true if the specified operation is legal on this target or can be made legal with custom lower...
LegalizeAction getPartialReduceMLAAction(unsigned Opc, EVT AccVT, EVT InputVT) const
Return how a PARTIAL_REDUCE_U/SMLA node with Acc type AccVT and Input type InputVT should be treated.
bool isPredictableSelectExpensive() const
Return true if selects are only cheaper than branches if the branch is unlikely to be predicted right...
virtual bool mergeStoresAfterLegalization(EVT MemVT) const
Allow store merging for the specified type after legalization in addition to before legalization.
unsigned getVectorTypeBreakdown(LLVMContext &Context, EVT VT, EVT &IntermediateVT, unsigned &NumIntermediates, MVT &RegisterVT) const
Vector types are broken down into some number of legal first class types.
virtual bool shouldIssueAtomicLoadForAtomicEmulationLoop(void) const
virtual bool shouldMergeStoreOfLoadsOverCall(EVT, EVT) const
Returns true if it's profitable to allow merging store of loads when there are functions calls betwee...
RTLIB::LibcallImpl getSupportedLibcallImpl(StringRef FuncName) const
Check if this is valid libcall for the current module, otherwise RTLIB::Unsupported.
virtual bool isProfitableToHoist(Instruction *I) const
unsigned getGatherAllAliasesMaxDepth() const
virtual LegalizeAction getCustomOperationAction(SDNode &Op) const
How to legalize this custom operation?
virtual bool isFMAFasterThanFMulAndFAdd(const Function &F, Type *) const
IR version.
virtual bool hasAndNotCompare(SDValue Y) const
Return true if the target should transform: (X & Y) == Y ---> (~X & Y) == 0 (X & Y) !...
virtual bool storeOfVectorConstantIsCheap(bool IsZero, EVT MemVT, unsigned NumElem, unsigned AddrSpace) const
Return true if it is expected to be cheaper to do a store of vector constant with the given size and ...
unsigned MaxLoadsPerMemcmpOptSize
Likewise for functions with the OptSize attribute.
virtual MVT hasFastEqualityCompare(unsigned NumBits) const
Return the preferred operand type if the target has a quick way to compare integer values of the give...
virtual const TargetRegisterClass * getRepRegClassFor(MVT VT) const
Return the 'representative' register class for the specified value type.
virtual bool isNarrowingProfitable(SDNode *N, EVT SrcVT, EVT DestVT) const
Return true if it's profitable to narrow operations of type SrcVT to DestVT.
LegalizeAction getLoadAction(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace, unsigned ExtType, bool Atomic) const
Return how this load with extension should be treated: either it is legal, needs to be promoted to a ...
virtual bool isMultiStoresCheaperThanBitsMerge(EVT LTy, EVT HTy) const
Return true if it is cheaper to split the store of a merged int val from a pair of smaller values int...
bool shouldUseDynamicVectorTypeBreakdown(EVT VT, bool ForCallingConv) const
TargetLoweringBase(const TargetLoweringBase &)=delete
virtual unsigned getMaxGluedStoresPerMemcpy() const
Get maximum # of store operations to be glued together.
virtual bool isBinOp(unsigned Opcode) const
Return true if the node is a math/logic binary operator.
virtual bool shouldFoldMaskToVariableShiftPair(SDValue X) const
There are two ways to clear extreme bits (either low or high): Mask: x & (-1 << y) (the instcombine c...
virtual bool alignLoopsWithOptSize() const
Should loops be aligned even when the function is marked OptSize (but not MinSize).
unsigned getMaxAtomicSizeInBitsSupported() const
Returns the maximum atomic operation size (in bits) supported by the backend.
bool isIndexedLoadLegal(unsigned IdxMode, EVT VT) const
Return true if the specified indexed load is legal on this target.
void setMinCmpXchgSizeInBits(unsigned SizeInBits)
Sets the minimum cmpxchg or ll/sc size supported by the backend.
virtual bool canMergeStoresTo(unsigned AS, EVT MemVT, const MachineFunction &MF) const
Returns if it's reasonable to merge stores to MemVT size.
void setPartialReduceMLAAction(ArrayRef< unsigned > Opcodes, MVT AccVT, MVT InputVT, LegalizeAction Action)
LegalizeAction getStrictFPOperationAction(unsigned Op, EVT VT) const
void setStackPointerRegisterToSaveRestore(Register R)
If set to a physical register, this specifies the register that llvm.savestack/llvm....
virtual bool preferABDSToABSWithNSW(EVT VT) const
void AddPromotedToType(unsigned Opc, MVT OrigVT, MVT DestVT)
If Opc/OrigVT is specified as being promoted, the promotion code defaults to trying a larger integer/...
virtual bool getAddrModeArguments(const IntrinsicInst *, SmallVectorImpl< Value * > &, Type *&) const
CodeGenPrepare sinks address calculations into the same BB as Load/Store instructions reading the add...
virtual bool hasInlineStackProbe(const MachineFunction &MF) const
AtomicExpansionKind
Enum that specifies what an atomic load/AtomicRMWInst is expanded to, if at all.
void setCondCodeAction(ArrayRef< ISD::CondCode > CCs, MVT VT, LegalizeAction Action)
Indicate that the specified condition code is or isn't supported on the target and indicate what to d...
void setBooleanContents(BooleanContent IntTy, BooleanContent FloatTy)
Specify how the target extends the result of integer and floating point boolean values from i1 to a w...
const DenseMap< unsigned int, unsigned int > & getBypassSlowDivWidths() const
Returns map of slow types for division or remainder with corresponding fast types.
void setOperationPromotedToType(ArrayRef< unsigned > Ops, MVT OrigVT, MVT DestVT)
unsigned getMaxLargeFPConvertBitWidthSupported() const
Returns the size in bits of the maximum fp to/from int conversion the backend supports.
virtual bool isFMAFasterThanFMulAndFAdd(const MachineFunction &MF, LLT) const
Return true if an FMA operation is faster than a pair of fmul and fadd instructions.
virtual bool isTruncateFree(EVT FromVT, EVT ToVT) const
bool isTruncStoreLegal(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace) const
Return true if the specified store with truncation is legal on this target.
virtual bool isCheapToSpeculateCtlz(Type *Ty) const
Return true if it is cheap to speculate a call to intrinsic ctlz.
virtual void getTgtMemIntrinsic(SmallVectorImpl< IntrinsicInfo > &Infos, const CallBase &I, MachineFunction &MF, unsigned Intrinsic) const
Given an intrinsic, checks if on the target the intrinsic will need to map to a MemIntrinsicNode (tou...
virtual bool signExtendConstant(const ConstantInt *C) const
Return true if this constant should be sign extended when promoting to a larger type.
virtual bool lowerInterleaveIntrinsicToStore(Instruction *Store, Value *Mask, ArrayRef< Value * > InterleaveValues) const
Lower an interleave intrinsic to a target specific store intrinsic.
virtual bool isTruncateFree(LLT FromTy, LLT ToTy, LLVMContext &Ctx) const
AndOrSETCCFoldKind
Enum of different potentially desirable ways to fold (and/or (setcc ...), (setcc ....
virtual bool shouldScalarizeBinop(SDValue VecOp) const
Try to convert an extract element of a vector binary operation into an extract element followed by a ...
Align getPrefFunctionAlignment() const
Return the preferred function alignment.
RTLIB::LibcallImpl getLibcallImpl(RTLIB::Libcall Call) const
Get the libcall impl routine name for the specified libcall.
virtual void emitExpandAtomicLoad(LoadInst *LI) const
Perform a atomic load using a target-specific way.
Align getMinFunctionAlignment() const
Return the minimum function alignment.
virtual AtomicExpansionKind shouldExpandAtomicStoreInIR(StoreInst *SI) const
Returns how the given (atomic) store should be expanded by the IR-level AtomicExpand pass into.
virtual bool preferVectorizedNonPowerOfTwoTypeBreakdown() const
Return true if fixed-length, non-power-of-two vectors should be broken down into legal vector parts i...
static StringRef getLibcallImplName(RTLIB::LibcallImpl Call)
Get the libcall routine name for the specified libcall implementation.
void setTargetDAGCombine(ArrayRef< ISD::NodeType > NTs)
Targets should invoke this method for each target independent node that they want to provide a custom...
virtual bool isCtlzFast() const
Return true if ctlz instruction is fast.
virtual bool useSoftFloat() const
virtual bool isStoreBitCastBeneficial(EVT StoreVT, EVT BitcastVT, const SelectionDAG &DAG, const MachineMemOperand &MMO) const
Return true if the following transform is beneficial: (store (y (conv x)), y*)) -> (store x,...
BooleanContent getBooleanContents(EVT Type) const
virtual LegalizeAction getCustomLoadAction(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace, unsigned ExtType, bool Atomic) const
Returns an alternative action to use when the coarser lookups (configured through setLoadExtAction an...
bool isIndexedMaskedStoreLegal(unsigned IdxMode, EVT VT) const
Return true if the specified indexed load is legal on this target.
virtual int64_t getPreferredLargeGEPBaseOffset(int64_t MinOffset, int64_t MaxOffset) const
Return the prefered common base offset.
virtual bool isVectorClearMaskLegal(ArrayRef< int >, EVT) const
Similar to isShuffleMaskLegal.
LegalizeKind getTypeConversion(LLVMContext &Context, EVT VT) const
Return pair that represents the legalization kind (first) that needs to happen to EVT (second) in ord...
Align getMinStackArgumentAlignment() const
Return the minimum stack alignment of an argument.
virtual bool shouldUseStrictFP_TO_INT(EVT FpVT, EVT IntVT, bool IsSigned) const
Return true if it is more correct/profitable to use strict FP_TO_INT conversion operations - canonica...
void setLoadExtAction(unsigned ExtType, MVT ValVT, MVT MemVT, LegalizeAction Action)
Indicate that the specified load with extension does not work with the specified type and indicate wh...
bool hasTargetDAGCombine(ISD::NodeType NT) const
If true, the target has custom DAG combine transformations that it can perform for the specified node...
void setLibcallImpl(RTLIB::Libcall Call, RTLIB::LibcallImpl Impl)
virtual bool fallBackToDAGISel(const Instruction &Inst) const
unsigned GatherAllAliasesMaxDepth
Depth that GatherAllAliases should continue looking for chain dependencies when trying to find a more...
virtual bool shouldSplatInsEltVarIndex(EVT) const
Return true if inserting a scalar into a variable element of an undef vector is more efficiently hand...
LegalizeAction getIndexedMaskedLoadAction(unsigned IdxMode, MVT VT) const
Return how the indexed load should be treated: either it is legal, needs to be promoted to a larger s...
NegatibleCost
Enum that specifies when a float negation is beneficial.
LegalizeTypeAction getTypeAction(LLVMContext &Context, EVT VT) const
Return how we should legalize values of this type, either it is already legal (return 'Legal') or we ...
virtual unsigned preferedOpcodeForCmpEqPiecesOfOperand(EVT VT, unsigned ShiftOpc, bool MayTransformRotate, const APInt &ShiftOrRotateAmt, const std::optional< APInt > &AndMask) const
virtual void emitCmpArithAtomicRMWIntrinsic(AtomicRMWInst *AI) const
Perform a atomicrmw which the result is only used by comparison, using a target-specific intrinsic.
virtual bool shouldSignExtendTypeInLibCall(Type *Ty, bool IsSigned) const
Returns true if arguments should be sign-extended in lib calls.
virtual bool isFMADLegal(const MachineInstr &MI, LLT Ty) const
Returns true if MI can be combined with another instruction to form TargetOpcode::G_FMAD.
void setCondCodeAction(ArrayRef< ISD::CondCode > CCs, ArrayRef< MVT > VTs, LegalizeAction Action)
const char * getLibcallName(RTLIB::Libcall Call) const
Get the libcall routine name for the specified libcall.
virtual bool isLegalAddScalableImmediate(int64_t) const
Return true if adding the specified scalable immediate is legal, that is the target has add instructi...
std::vector< ArgListEntry > ArgListTy
virtual bool shouldAlignPointerArgs(CallInst *, unsigned &, Align &) const
Return true if the pointer arguments to CI should be aligned by aligning the object whose address is ...
virtual bool hasVectorBlend() const
Return true if the target has a vector blend instruction.
virtual AtomicExpansionKind shouldCastAtomicStoreInIR(StoreInst *SI) const
Returns how the given (atomic) store should be cast by the IR-level AtomicExpand pass into.
bool isTruncStoreLegalOrCustom(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace) const
Return true if the specified store with truncation has solution on this target.
void setIndexedStoreAction(ArrayRef< unsigned > IdxModes, ArrayRef< MVT > VTs, LegalizeAction Action)
virtual bool aggressivelyPreferBuildVectorSources(EVT VecVT) const
virtual Register getExceptionPointerRegister(ExceptionHandling EH, const Constant *PersonalityFn) const
If a physical register, this returns the register that receives the exception address on entry to an ...
virtual MachineMemOperand::Flags getTargetMMOFlags(const MemSDNode &Node) const
This callback is used to inspect load/store SDNode.
virtual EVT getOptimalMemOpType(LLVMContext &Context, const MemOp &Op, const AttributeList &) const
Returns the target specific optimal type for load and store operations as a result of memset,...
virtual Type * shouldConvertSplatType(ShuffleVectorInst *SVI) const
Given a shuffle vector SVI representing a vector splat, return a new scalar type of size equal to SVI...
virtual bool isZExtFree(SDValue Val, EVT VT2) const
Return true if zero-extending the specific node Val to type VT2 is free (either because it's implicit...
void setAtomicLoadExtAction(ArrayRef< unsigned > ExtTypes, MVT ValVT, MVT MemVT, LegalizeAction Action)
virtual bool shouldRemoveExtendFromGSIndex(SDValue Extend, EVT DataVT) const
virtual LLVM_READONLY LLT getPreferredShiftAmountTy(LLT ShiftValueTy) const
Return the preferred type to use for a shift opcode, given the shifted amount type is ShiftValueTy.
bool isBeneficialToExpandPowI(int64_t Exponent, bool OptForSize) const
Return true if it is beneficial to expand an @llvm.powi.
LLT getVectorIdxLLT(const DataLayout &DL) const
Returns the type to be used for the index operand of: G_INSERT_VECTOR_ELT, G_EXTRACT_VECTOR_ELT,...
virtual EVT getAsmOperandValueType(const DataLayout &DL, Type *Ty, bool AllowUnknown=false) const
void setIndexedLoadAction(ArrayRef< unsigned > IdxModes, ArrayRef< MVT > VTs, LegalizeAction Action)
virtual AtomicExpansionKind shouldCastAtomicLoadInIR(LoadInst *LI) const
Returns how the given (atomic) load should be cast by the IR-level AtomicExpand pass.
bool isCondCodeLegalOrCustom(ISD::CondCode CC, MVT VT) const
Return true if the specified condition code is legal or custom for a comparison of the specified type...
virtual bool isComplexDeinterleavingSupported() const
Does this target support complex deinterleaving.
unsigned MaxStoresPerMemcpy
Specify maximum number of store instructions per memcpy call.
MVT getFrameIndexTy(const DataLayout &DL) const
Return the type for frame index, which is determined by the alloca address space specified through th...
virtual MVT getPointerMemTy(const DataLayout &DL, uint32_t AS=0) const
Return the in-memory pointer type for the given address space, defaults to the pointer type from the ...
bool isLoadLegal(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace, unsigned ExtType, bool Atomic) const
Return true if the specified load with extension is legal on this target.
void setSchedulingPreference(Sched::Preference Pref)
Specify the target scheduling preference.
virtual bool addressingModeSupportsTLS(const GlobalValue &) const
Returns true if the targets addressing mode can target thread local storage (TLS).
bool isLoadLegalOrCustom(EVT ValVT, EVT MemVT, Align Alignment, unsigned AddrSpace, unsigned ExtType, bool Atomic) const
Return true if the specified load with extension is legal or custom on this target.
virtual bool shouldConvertPhiType(Type *From, Type *To) const
Given a set in interconnected phis of type 'From' that are loaded/stored or bitcast to type 'To',...
virtual bool isFAbsFree(EVT VT) const
Return true if an fabs operation is free to the point where it is never worthwhile to replace it with...
virtual bool isLegalStoreImmediate(int64_t Value) const
Return true if the specified immediate is legal for the value input of a store instruction.
virtual bool preferZeroCompareBranch() const
Return true if the heuristic to prefer icmp eq zero should be used in code gen prepare.
LegalizeAction getOperationAction(unsigned Op, EVT VT) const
Return how this operation should be treated: either it is legal, needs to be promoted to a larger siz...
virtual bool lowerInterleavedLoad(Instruction *Load, Value *Mask, ArrayRef< ShuffleVectorInst * > Shuffles, ArrayRef< unsigned > Indices, unsigned Factor, const APInt &GapMask) const
Lower an interleaved load to target specific intrinsics.
virtual unsigned getVectorIdxWidth(const DataLayout &DL) const
Returns the type to be used for the index operand vector operations.
MVT getTypeToPromoteTo(unsigned Op, MVT VT) const
If the action for this operation is to promote, this method returns the ValueType to promote to.
virtual bool generateFMAsInMachineCombiner(EVT VT, CodeGenOptLevel OptLevel) const
virtual LoadInst * lowerIdempotentRMWIntoFencedLoad(AtomicRMWInst *RMWI) const
On some platforms, an AtomicRMW that never actually modifies the value (such as fetch_add of 0) can b...
virtual bool isLegalAddressingMode(const DataLayout &DL, const AddrMode &AM, Type *Ty, unsigned AddrSpace, Instruction *I=nullptr) const
Return true if the addressing mode represented by AM is legal for this target, for a load/store of th...
virtual bool hasPairedLoad(EVT, Align &) const
Return true if the target supplies and combines to a paired load two loaded values of type LoadedType...
virtual bool convertSelectOfConstantsToMath(EVT VT) const
Return true if a select of constants (select Cond, C1, C2) should be transformed into simple math ops...
bool isOperationLegalOrCustomOrPromote(unsigned Op, EVT VT, bool LegalOnly=false) const
Return true if the specified operation is legal on this target or can be made legal with custom lower...
virtual bool optimizeExtendOrTruncateConversion(Instruction *I, Loop *L, const TargetTransformInfo &TTI) const
Try to optimize extending or truncating conversion instructions (like zext, trunc,...
virtual MVT getVPExplicitVectorLengthTy() const
Returns the type to be used for the EVL/AVL operand of VP nodes: ISD::VP_UDIV, ISD::VP_SDIV,...
std::pair< LegalizeTypeAction, EVT > LegalizeKind
LegalizeKind holds the legalization kind that needs to happen to EVT in order to type-legalize it.
TargetLoweringBase & operator=(const TargetLoweringBase &)=delete
MulExpansionKind
Enum that specifies when a multiplication should be expanded.
static ISD::NodeType getExtendForContent(BooleanContent Content)
const RTLIB::RuntimeLibcallsInfo & getRuntimeLibcallsInfo() const
virtual bool shouldConvertFpToSat(unsigned Op, EVT FPVT, EVT VT) const
Should we generate fp_to_si_sat and fp_to_ui_sat from type FPVT to type VT.
virtual bool supportKCFIBundles() const
Return true if the target supports kcfi operand bundles.
virtual ConstraintWeight getMultipleConstraintMatchWeight(AsmOperandInfo &info, int maIndex) const
Examine constraint type and operand type and determine a weight value.
SmallVector< ConstraintPair > ConstraintGroup
virtual SDValue getSqrtEstimate(SDValue Operand, SelectionDAG &DAG, int Enabled, int &RefinementSteps, bool &UseOneConstNR, bool Reciprocal) const
Hooks for building estimates in place of slower divisions and square roots.
virtual bool isDesirableToCommuteWithShift(const MachineInstr &MI, bool IsAfterLegal) const
GlobalISel - return true if it is profitable to move this shift by a constant amount through its oper...
virtual bool supportPtrAuthBundles() const
Return true if the target supports ptrauth operand bundles.
virtual void ReplaceNodeResults(SDNode *, SmallVectorImpl< SDValue > &, SelectionDAG &) const
This callback is invoked when a node result type is illegal for the target, and the operation was reg...
virtual bool isUsedByReturnOnly(SDNode *, SDValue &) const
Return true if result of the specified node is used by a return node only.
virtual bool supportSwiftError() const
Return true if the target supports swifterror attribute.
virtual SDValue visitMaskedLoad(SelectionDAG &DAG, const SDLoc &DL, SDValue Chain, MachineMemOperand *MMO, SDValue &NewLoad, SDValue Ptr, SDValue PassThru, SDValue Mask) const
virtual unsigned getPreferredShrunkVectorSizeInBits(SDValue Op, const APInt &DemandedElts) const
If only low elements of a vector are demanded, shrink the operation to the returned size in bits by c...
SDValue getNegatedExpression(SDValue Op, SelectionDAG &DAG, bool LegalOps, bool OptForSize, unsigned Depth=0) const
This is the helper function to return the newly negated expression if the cost is not expensive.
virtual bool isReassocProfitable(SelectionDAG &DAG, SDValue N0, SDValue N1) const
virtual EVT getTypeForExtReturn(LLVMContext &Context, EVT VT, ISD::NodeType) const
Return the type that should be used to zero or sign extend a zeroext/signext integer return value.
SDValue getCheaperOrNeutralNegatedExpression(SDValue Op, SelectionDAG &DAG, bool LegalOps, bool OptForSize, const NegatibleCost CostThreshold=NegatibleCost::Neutral, unsigned Depth=0) const
virtual Register getRegisterByName(const char *RegName, LLT Ty, const MachineFunction &MF) const
Return the register ID of the name passed in.
virtual InlineAsm::ConstraintCode getInlineAsmMemConstraint(StringRef ConstraintCode) const
virtual bool targetShrinkDemandedConstant(SDValue Op, const APInt &DemandedBits, const APInt &DemandedElts, TargetLoweringOpt &TLO) const
std::vector< AsmOperandInfo > AsmOperandInfoVector
virtual bool isTargetCanonicalConstantNode(SDValue Op) const
Returns true if the given Opc is considered a canonical constant for the target, which should not be ...
virtual bool isTargetCanonicalSelect(SDNode *N) const
Return true if the given select/vselect should be considered canonical and not be transformed.
SDValue getCheaperNegatedExpression(SDValue Op, SelectionDAG &DAG, bool LegalOps, bool OptForSize, unsigned Depth=0) const
This is the helper function to return the newly negated expression only when the cost is cheaper.
virtual SDValue prepareVolatileOrAtomicLoad(SDValue Chain, const SDLoc &DL, SelectionDAG &DAG) const
This callback is used to prepare for a volatile or atomic load.
virtual SDValue emitStackGuardMixFP(SelectionDAG &DAG, SDValue Val, const SDLoc &DL) const
virtual SDValue lowerEHPadEntry(SDValue Chain, const SDLoc &DL, SelectionDAG &DAG) const
Optional target hook to add target-specific actions when entering EH pad blocks.
virtual ConstraintType getConstraintType(StringRef Constraint) const
Given a constraint, return the type of constraint it is for this target.
virtual SDValue unwrapAddress(SDValue N) const
virtual bool splitValueIntoRegisterParts(SelectionDAG &DAG, const SDLoc &DL, SDValue Val, SDValue *Parts, unsigned NumParts, MVT PartVT, std::optional< CallingConv::ID > CC) const
Target-specific splitting of values into parts that fit a register storing a legal type.
virtual bool IsDesirableToPromoteOp(SDValue, EVT &) const
This method query the target whether it is beneficial for dag combiner to promote the specified node.
virtual SDValue joinRegisterPartsIntoValue(SelectionDAG &DAG, const SDLoc &DL, const SDValue *Parts, unsigned NumParts, MVT PartVT, EVT ValueVT, std::optional< CallingConv::ID > CC) const
Target-specific combining of register parts into its original value.
virtual void insertCopiesSplitCSR(MachineBasicBlock *Entry, const SmallVectorImpl< MachineBasicBlock * > &Exits) const
Insert explicit copies in entry and exit blocks.
virtual SDValue LowerCall(CallLoweringInfo &, SmallVectorImpl< SDValue > &) const
This hook must be implemented to lower calls into the specified DAG.
virtual bool isTypeDesirableForOp(unsigned, EVT VT) const
Return true if the target has native support for the specified value type and it is 'desirable' to us...
~TargetLowering() override
TargetLowering & operator=(const TargetLowering &)=delete
virtual bool isDesirableToPullExtFromShl(const MachineInstr &MI) const
GlobalISel - return true if it's profitable to perform the combine: shl ([sza]ext x),...
bool isPositionIndependent() const
std::pair< StringRef, TargetLowering::ConstraintType > ConstraintPair
virtual SDValue getNegatedExpression(SDValue Op, SelectionDAG &DAG, bool LegalOps, bool OptForSize, NegatibleCost &Cost, unsigned Depth=0) const
Return the newly negated expression if the cost is not expensive and set the cost in Cost to indicate...
virtual ConstraintWeight getSingleConstraintMatchWeight(AsmOperandInfo &info, const char *constraint) const
Examine constraint string and operand type and determine a weight value.
virtual bool isIndexingLegal(MachineInstr &MI, Register Base, Register Offset, bool IsPre, MachineRegisterInfo &MRI) const
Returns true if the specified base+offset is a legal indexed addressing mode for this target.
ConstraintGroup getConstraintPreferences(AsmOperandInfo &OpInfo) const
Given an OpInfo with list of constraints codes as strings, return a sorted Vector of pairs of constra...
virtual void initializeSplitCSR(MachineBasicBlock *Entry) const
Perform necessary initialization to handle a subset of CSRs explicitly via copies.
virtual bool isSDNodeSourceOfDivergence(const SDNode *N, FunctionLoweringInfo *FLI, UniformityInfo *UA) const
virtual SDValue getRecipEstimate(SDValue Operand, SelectionDAG &DAG, int Enabled, int &RefinementSteps) const
Return a reciprocal estimate value for the input operand.
virtual std::pair< unsigned, const TargetRegisterClass * > getRegForInlineAsmConstraint(const TargetRegisterInfo *TRI, StringRef Constraint, MVT VT) const
Given a physical register constraint (e.g.
virtual bool isSDNodeAlwaysUniform(const SDNode *N) const
virtual bool isDesirableToCommuteXorWithShift(const SDNode *N) const
Return true if it is profitable to combine an XOR of a logical shift to create a logical shift of NOT...
TargetLowering(const TargetLowering &)=delete
virtual bool shouldSimplifyDemandedVectorElts(SDValue Op, const TargetLoweringOpt &TLO) const
Return true if the target supports simplifying demanded vector elements by converting them to undefs.
virtual SDValue LowerFormalArguments(SDValue, CallingConv::ID, bool, const SmallVectorImpl< ISD::InputArg > &, const SDLoc &, SelectionDAG &, SmallVectorImpl< SDValue > &) const
This hook must be implemented to lower the incoming (formal) arguments, described by the Ins array,...
virtual AsmOperandInfoVector ParseConstraints(const DataLayout &DL, const TargetRegisterInfo *TRI, const CallBase &Call) const
Split up the constraint string from the inline assembly value into the specific constraints and their...
virtual SDValue getSqrtResultForDenormInput(SDValue Operand, SelectionDAG &DAG) const
Return a target-dependent result if the input operand is not suitable for use with a square root esti...
virtual bool getPostIndexedAddressParts(SDNode *, SDNode *, SDValue &, SDValue &, ISD::MemIndexedMode &, SelectionDAG &) const
Returns true by value, base pointer and offset pointer and addressing mode by reference if this node ...
virtual bool shouldSplitFunctionArgumentsAsLittleEndian(const DataLayout &DL) const
For most targets, an LLVM type must be broken down into multiple smaller types.
virtual ArrayRef< MCPhysReg > getRoundingControlRegisters() const
Returns a 0 terminated array of rounding control registers that can be attached into strict FP call.
virtual SDValue LowerReturn(SDValue, CallingConv::ID, bool, const SmallVectorImpl< ISD::OutputArg > &, const SmallVectorImpl< SDValue > &, const SDLoc &, SelectionDAG &) const
This hook must be implemented to lower outgoing return values, described by the Outs array,...
virtual bool functionArgumentNeedsConsecutiveRegisters(Type *Ty, CallingConv::ID CallConv, bool isVarArg, const DataLayout &DL) const
For some targets, an LLVM struct type must be broken down into multiple simple types,...
virtual bool isDesirableToCommuteWithShift(const SDNode *N, CombineLevel Level) const
Return true if it is profitable to move this shift by a constant amount through its operand,...
virtual void ComputeConstraintToUse(AsmOperandInfo &OpInfo, SDValue Op, SelectionDAG *DAG=nullptr) const
Determines the constraint code and constraint type to use for the specific AsmOperandInfo,...
virtual SDValue visitMaskedStore(SelectionDAG &DAG, const SDLoc &DL, SDValue Chain, MachineMemOperand *MMO, SDValue Ptr, SDValue Val, SDValue Mask) const
virtual const MCExpr * LowerCustomJumpTableEntry(const MachineJumpTableInfo *, const MachineBasicBlock *, unsigned, MCContext &) const
virtual bool useTopologicalSorting() const
virtual bool useLoadStackGuardNode(const Module &M) const
If this function returns true, SelectionDAGBuilder emits a LOAD_STACK_GUARD node when it is lowering ...
std::pair< SDValue, SDValue > makeLibCall(SelectionDAG &DAG, RTLIB::Libcall LC, EVT RetVT, ArrayRef< SDValue > Ops, MakeLibCallOptions CallOptions, const SDLoc &dl, SDValue Chain=SDValue()) const
It is an error to pass RTLIB::UNKNOWN_LIBCALL as LC.
virtual FastISel * createFastISel(FunctionLoweringInfo &, const TargetLibraryInfo *, const LibcallLoweringInfo *) const
This method returns a target specific FastISel object, or null if the target does not support "fast" ...
virtual unsigned combineRepeatedFPDivisors() const
Indicate whether this target prefers to combine FDIVs with the same divisor.
virtual AndOrSETCCFoldKind isDesirableToCombineLogicOpOfSETCC(const SDNode *LogicOp, const SDNode *SETCC0, const SDNode *SETCC1) const
virtual void HandleByVal(CCState *, unsigned &, Align) const
Target-specific cleanup for formal ByVal parameters.
virtual const MCPhysReg * getScratchRegisters(CallingConv::ID CC) const
Returns a 0 terminated array of registers that can be safely used as scratch registers.
virtual bool getPreIndexedAddressParts(SDNode *, SDValue &, SDValue &, ISD::MemIndexedMode &, SelectionDAG &) const
Returns true by value, base pointer and offset pointer and addressing mode by reference if the node's...
SDValue getVectorElementPointer(SelectionDAG &DAG, SDValue VecPtr, EVT VecVT, SDValue Index, const SDNodeFlags PtrArithFlags=SDNodeFlags()) const
Get a pointer to vector element Idx located in memory for a vector of type VecVT starting at a base a...
std::pair< SDValue, SDValue > makeLibCall(SelectionDAG &DAG, RTLIB::LibcallImpl LibcallImpl, EVT RetVT, ArrayRef< SDValue > Ops, MakeLibCallOptions CallOptions, const SDLoc &dl, SDValue Chain=SDValue()) const
Returns a pair of (return value, chain).
virtual bool supportSplitCSR(MachineFunction *MF) const
Return true if the target supports that a subset of CSRs for the given machine function is handled ex...
virtual bool isReassocProfitable(MachineRegisterInfo &MRI, Register N0, Register N1) const
virtual bool mayBeEmittedAsTailCall(const CallInst *) const
Return true if the target may be able emit the call instruction as a tail call.
virtual bool isInlineAsmTargetBranch(const SmallVectorImpl< StringRef > &AsmStrs, unsigned OpNo) const
On x86, return true if the operand with index OpNo is a CALL or JUMP instruction, which can use eithe...
SDValue getInboundsVectorElementPointer(SelectionDAG &DAG, SDValue VecPtr, EVT VecVT, SDValue Index) const
Get a pointer to vector element Idx located in memory for a vector of type VecVT starting at a base a...
virtual MVT getJumpTableRegTy(const DataLayout &DL) const
virtual void markLibCallAttributes(MachineFunction *MF, unsigned CC, ArgListTy &Args) const
virtual bool CanLowerReturn(CallingConv::ID, MachineFunction &, bool, const SmallVectorImpl< ISD::OutputArg > &, LLVMContext &, const Type *RetTy) const
This hook should be implemented to check whether the return values described by the Outs array can fi...
virtual bool isXAndYEqZeroPreferableToXAndYEqY(ISD::CondCode, EVT) const
virtual bool isDesirableToTransformToIntegerOp(unsigned, EVT) const
Return true if it is profitable for dag combiner to transform a floating point op of specified opcode...
Primary interface to the complete machine description for the target machine.
TargetRegisterInfo base class - We assume that the target defines a static array of TargetRegisterDes...
TargetSubtargetInfo - Generic base class for all target subtargets.
This pass provides access to the codegen interfaces that are needed for IR-level transformations.
Target - Wrapper for Target specific information.
The instances of the Type class are immutable: once they are created, they are never changed.
Definition Type.h:46
bool isVectorTy() const
True if this is an instance of VectorType.
Definition Type.h:288
bool isPointerTy() const
True if this is an instance of PointerType.
Definition Type.h:282
bool isFloatingPointTy() const
Return true if this is one of the floating-point types.
Definition Type.h:186
bool isIntegerTy() const
True if this is an instance of IntegerType.
Definition Type.h:257
This is the common base class for vector predication intrinsics.
LLVM Value Representation.
Definition Value.h:75
Type * getType() const
All values are typed, get the type of this value.
Definition Value.h:255
CallInst * Call
#define UINT64_MAX
Definition DataTypes.h:77
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
unsigned ID
LLVM IR allows to use arbitrary numbers as calling convention identifiers.
Definition CallingConv.h:24
@ C
The default llvm calling convention, compatible with C.
Definition CallingConv.h:34
NodeType
ISD::NodeType enum - This enum defines the target-independent operators for a SelectionDAG.
Definition ISDOpcodes.h:41
@ PARTIAL_REDUCE_SMLA
PARTIAL_REDUCE_[U|S]MLA(Accumulator, Input1, Input2) The partial reduction nodes sign or zero extend ...
@ SMUL_LOHI
SMUL_LOHI/UMUL_LOHI - Multiply two integers of type iN, producing a signed/unsigned value of type i[2...
Definition ISDOpcodes.h:275
@ SMULFIX
RESULT = [US]MULFIX(LHS, RHS, SCALE) - Perform fixed point multiplication on 2 integers with the same...
Definition ISDOpcodes.h:394
@ ADDC
Carry-setting nodes for multiple precision addition and subtraction.
Definition ISDOpcodes.h:294
@ FMAD
FMAD - Perform a * b + c, while getting the same result as the separately rounded operations.
Definition ISDOpcodes.h:524
@ ADD
Simple integer binary arithmetic operators.
Definition ISDOpcodes.h:264
@ SMULFIXSAT
Same as the corresponding unsaturated fixed point instructions, but the result is clamped between the...
Definition ISDOpcodes.h:400
@ ANY_EXTEND
ANY_EXTEND - Used for integer types. The high bits are undefined.
Definition ISDOpcodes.h:863
@ PSEUDO_FMIN
PSEUDO_FMIN is strictly equivalent to op0 olt op1 ?
@ FADD
Simple binary floating point operators.
Definition ISDOpcodes.h:417
@ CLMUL
Carry-less multiplication operations.
Definition ISDOpcodes.h:780
@ SDIVFIX
RESULT = [US]DIVFIX(LHS, RHS, SCALE) - Perform fixed point division on 2 integers with the same width...
Definition ISDOpcodes.h:407
@ PARTIAL_REDUCE_UMLA
@ SIGN_EXTEND
Conversion operators.
Definition ISDOpcodes.h:854
@ AVGCEILS
AVGCEILS/AVGCEILU - Rounding averaging add - Add two integers using an integer of type i[N+2],...
Definition ISDOpcodes.h:717
@ PARTIAL_REDUCE_FMLA
@ BRIND
BRIND - Indirect branch.
@ BR_JT
BR_JT - Jumptable branch.
@ SSUBSAT
RESULT = [US]SUBSAT(LHS, RHS) - Perform saturation subtraction on 2 integers with the same bit width ...
Definition ISDOpcodes.h:374
@ SPLAT_VECTOR
SPLAT_VECTOR(VAL) - Returns a vector with the scalar value VAL duplicated in all lanes.
Definition ISDOpcodes.h:674
@ SADDO
RESULT, BOOL = [SU]ADDO(LHS, RHS) - Overflow-aware nodes for addition.
Definition ISDOpcodes.h:348
@ MULHU
MULHU/MULHS - Multiply high - Multiply two integers of type iN, producing an unsigned/signed value of...
Definition ISDOpcodes.h:706
@ SHL
Shift and rotation operations.
Definition ISDOpcodes.h:771
@ FMINNUM_IEEE
FMINNUM_IEEE/FMAXNUM_IEEE - Perform floating-point minimumNumber or maximumNumber on two values,...
@ ZERO_EXTEND
ZERO_EXTEND - Used for integer types, zeroing the new bits.
Definition ISDOpcodes.h:860
@ FMINNUM
FMINNUM/FMAXNUM - Perform floating-point minimum maximum on two values, following IEEE-754 definition...
@ SMIN
[US]{MIN/MAX} - Binary minimum or maximum of signed or unsigned integers.
Definition ISDOpcodes.h:729
@ SDIVFIXSAT
Same as the corresponding unsaturated fixed point instructions, but the result is clamped between the...
Definition ISDOpcodes.h:413
@ STRICT_FP_TO_UINT
Definition ISDOpcodes.h:480
@ STRICT_FP_TO_SINT
STRICT_FP_TO_[US]INT - Convert a floating point value to a signed or unsigned integer.
Definition ISDOpcodes.h:479
@ FMINIMUM
FMINIMUM/FMAXIMUM - NaN-propagating minimum/maximum that also treat -0.0 as less than 0....
@ FP_TO_SINT
FP_TO_[US]INT - Convert a floating point value to a signed or unsigned integer.
Definition ISDOpcodes.h:936
@ AND
Bitwise operators - logical and, logical or, logical xor.
Definition ISDOpcodes.h:741
@ AVGFLOORS
AVGFLOORS/AVGFLOORU - Averaging add - Add two integers using an integer of type i[N+1],...
Definition ISDOpcodes.h:712
@ ADDE
Carry-using nodes for multiple precision addition and subtraction.
Definition ISDOpcodes.h:304
@ SPLAT_VECTOR_PARTS
SPLAT_VECTOR_PARTS(SCALAR1, SCALAR2, ...) - Returns a vector with the scalar values joined together a...
Definition ISDOpcodes.h:683
@ PARTIAL_REDUCE_SUMLA
@ SADDSAT
RESULT = [US]ADDSAT(LHS, RHS) - Perform saturation addition on 2 integers with the same bit width (W)...
Definition ISDOpcodes.h:365
@ FMINIMUMNUM
FMINIMUMNUM/FMAXIMUMNUM - minimumnum/maximumnum that is same with FMINNUM_IEEE and FMAXNUM_IEEE besid...
@ ABDS
ABDS/ABDU - Absolute difference - Return the absolute difference between two numbers interpreted as s...
Definition ISDOpcodes.h:724
static const int LAST_LOADEXT_TYPE
MemIndexedMode
MemIndexedMode enum - This enum defines the load / store indexed addressing modes.
CondCode
ISD::CondCode enum - These are ordered carefully to make the bitfields below work out,...
LoadExtType
LoadExtType enum - This enum defines the three variants of LOADEXT (load with extension).
This namespace contains an enum with a value for every intrinsic/builtin function known by LLVM.
@ System
Synchronized with respect to all concurrently executing threads.
Definition LLVMContext.h:58
This namespace contains all of the command line option processing machinery.
Definition MCSchedule.h:35
This is an optimization pass for GlobalISel generic memory operations.
GenericUniformityInfo< SSAContext > UniformityInfo
@ Low
Lower the current thread's priority such that it does not affect foreground tasks significantly.
Definition Threading.h:280
@ Offset
Definition DWP.cpp:577
void fill(R &&Range, T &&Value)
Provide wrappers to std::fill which take ranges instead of having to pass begin/end explicitly.
Definition STLExtras.h:1759
LLVM_ABI void GetReturnInfo(CallingConv::ID CC, Type *ReturnType, AttributeList attr, SmallVectorImpl< ISD::OutputArg > &Outs, const TargetLowering &TLI, const DataLayout &DL)
Given an LLVM IR type and return type attributes, compute the return value EVTs and flags,...
InstructionCost Cost
@ Known
Known to have no common set bits.
decltype(auto) dyn_cast(const From &Val)
dyn_cast<X> - Return the argument parameter cast to the specified type.
Definition Casting.h:643
bool isAligned(Align Lhs, uint64_t SizeInBytes)
Checks that SizeInBytes is a multiple of the alignment.
Definition Alignment.h:134
@ Load
The value being inserted comes from a load (InsertElement only).
@ Store
The extracted value is stored (ExtractElement only).
constexpr int popcount(T Value) noexcept
Count the number of set bits in a value.
Definition bit.h:156
unsigned Log2_64(uint64_t Value)
Return the floor log base 2 of the specified value, -1 if the value is zero.
Definition MathExtras.h:332
LLVM_ABI bool isConstTrueVal(const TargetLowering &TLI, int64_t Val, bool IsVector, bool IsFP)
Returns true if given the TargetLowering's boolean contents information, the value Val contains a tru...
Definition Utils.cpp:1604
constexpr bool isPowerOf2_32(uint32_t Value)
Return true if the argument is a power of two > 0.
Definition MathExtras.h:280
FPClassTest
Floating-point class tests, supported by 'is_fpclass' intrinsic.
CodeGenOptLevel
Code generation optimization level.
Definition CodeGen.h:149
@ Default
-O2, -Os, -Oz
Definition CodeGen.h:152
bool isa(const From &Val)
isa<X> - Return true if the parameter to the template is an instance of one of the template type argu...
Definition Casting.h:547
LLVM_ATTRIBUTE_VISIBILITY_DEFAULT AnalysisKey InnerAnalysisManagerProxy< AnalysisManagerT, IRUnitT, ExtraArgTs... >::Key
AtomicOrdering
Atomic ordering for LLVM's memory model.
LLVM_ABI EVT getApproximateEVTForLLT(LLT Ty, LLVMContext &Ctx)
TargetTransformInfo TTI
CombineLevel
Definition DAGCombine.h:15
@ AfterLegalizeDAG
Definition DAGCombine.h:19
@ AfterLegalizeVectorOps
Definition DAGCombine.h:18
@ BeforeLegalizeTypes
Definition DAGCombine.h:16
uint16_t MCPhysReg
An unsigned integer type large enough to represent all physical registers, but not necessarily virtua...
Definition MCRegister.h:21
@ Fast
Assign the register banks as fast as possible (default).
LLVM_ABI bool isInTailCallPosition(const CallBase &Call, const TargetMachine &TM, bool ReturnsFirstArg=false)
Test if the given instruction is in a position to be optimized with a tail-call.
Definition Analysis.cpp:539
DWARFExpression::Operation Op
LLVM_ABI bool isConstFalseVal(const TargetLowering &TLI, int64_t Val, bool IsVector, bool IsFP)
Definition Utils.cpp:1617
constexpr unsigned BitWidth
OutputIt move(R &&Range, OutputIt Out)
Provide wrappers to std::move which take ranges instead of having to pass begin/end explicitly.
Definition STLExtras.h:1917
ExceptionHandling
Definition CodeGen.h:54
UndefPoisonKind
Enumeration to track whether we are interested in Undef, Poison, or both.
Definition UndefPoison.h:20
static cl::opt< unsigned > CostThreshold("dfa-cost-threshold", cl::desc("Maximum cost accepted for the transformation"), cl::Hidden, cl::init(50))
MCRegisterClass TargetRegisterClass
Definition FastISel.h:58
LLVM_ABI void reportFatalUsageError(Error Err)
Report a fatal error that does not indicate a bug in LLVM.
Definition Error.cpp:177
Implement std::hash so that hash_code can be used in STL containers.
Definition BitVector.h:878
#define N
This struct is a compact representation of a valid (non-zero power of two) alignment.
Definition Alignment.h:39
constexpr uint64_t value() const
This is a hole in the type system and should not be abused.
Definition Alignment.h:77
Represent subnormal handling kind for floating point instruction inputs and outputs.
Extended Value Type.
Definition ValueTypes.h:35
bool isSimple() const
Test if the given EVT is simple (as opposed to being extended).
Definition ValueTypes.h:145
static EVT getVectorVT(LLVMContext &Context, EVT VT, unsigned NumElements, bool IsScalable=false)
Returns the EVT that represents a vector NumElements in length, where each element is of type VT.
Definition ValueTypes.h:70
bool bitsLT(EVT VT) const
Return true if this has less bits than VT.
Definition ValueTypes.h:323
bool isFloatingPoint() const
Return true if this is a FP or a vector FP type.
Definition ValueTypes.h:155
bool isByteSized() const
Return true if the bit size is a multiple of 8.
Definition ValueTypes.h:266
static LLVM_ABI EVT getEVT(Type *Ty, bool HandleUnknown=false)
Return the value type corresponding to the specified type.
MVT getSimpleVT() const
Return the SimpleValueType held in the specified simple EVT.
Definition ValueTypes.h:339
bool isFixedLengthVector() const
Definition ValueTypes.h:199
bool isVector() const
Return true if this is a vector value type.
Definition ValueTypes.h:176
bool isExtended() const
Test if the given EVT is extended (as opposed to being simple).
Definition ValueTypes.h:150
bool isScalarInteger() const
Return true if this is an integer, but not a vector.
Definition ValueTypes.h:165
unsigned getVectorNumElements() const
Given a vector type, return the number of elements it contains.
Definition ValueTypes.h:359
ConstraintInfo()=default
Default constructor.
This struct is a compact representation of a valid (power of two) or undefined (0) alignment.
Definition Alignment.h:106
bool isDstAligned(Align AlignCheck) const
bool isFixedDstAlign() const
uint64_t size() const
static MemOp Set(uint64_t Size, bool DstAlignCanChange, Align DstAlign, bool IsZeroMemset, bool IsVolatile)
Align getDstAlign() const
bool isMemcpyStrSrc() const
bool isAligned(Align AlignCheck) const
static MemOp Copy(uint64_t Size, bool DstAlignCanChange, Align DstAlign, Align SrcAlign, bool IsVolatile, bool MemcpyStrSrc=false)
bool isSrcAligned(Align AlignCheck) const
bool isMemcpyOrMemmoveWithFixedDstAlign() const
bool isMemcpyOrMemmove() const
bool isMemmove() const
bool isMemset() const
bool isMemcpy() const
static MemOp Move(uint64_t Size, bool DstAlignCanChange, Align DstAlign, Align SrcAlign, bool IsVolatile)
bool isZeroMemset() const
bool isVolatile() const
Align getSrcAlign() const
A simple container for information about the supported runtime calls.
static StringRef getLibcallImplName(RTLIB::LibcallImpl CallImpl)
Get the libcall routine name for the specified libcall implementation.
These are IR-level optimization flags that may be propagated to SDNodes.
This represents an addressing mode of: BaseGV + BaseOffs + BaseReg + Scale*ScaleReg + ScalableOffset*...
std::optional< unsigned > fallbackAddressSpace
PointerUnion< const Value *, const PseudoSourceValue * > ptrVal
This contains information for each constraint that we are lowering.
AsmOperandInfo(InlineAsm::ConstraintInfo Info)
Copy constructor for copying from a ConstraintInfo.
MVT ConstraintVT
The ValueType for the operand value.
TargetLowering::ConstraintType ConstraintType
Information about the constraint code, e.g.
std::string ConstraintCode
This contains the actual string for the code, like "m".
Value * CallOperandVal
If this is the result output operand or a clobber, this is null, otherwise it is the incoming operand...
This structure contains all information that is necessary for lowering calls.
CallLoweringInfo & setConvergent(bool Value=true)
CallLoweringInfo & setIsPostTypeLegalization(bool Value=true)
CallLoweringInfo & setDeactivationSymbol(GlobalValue *Sym)
CallLoweringInfo & setCallee(Type *ResultType, FunctionType *FTy, SDValue Target, ArgListTy &&ArgsList, const CallBase &Call)
CallLoweringInfo & setCFIType(const ConstantInt *Type)
CallLoweringInfo & setInRegister(bool Value=true)
CallLoweringInfo & setLibCallee(CallingConv::ID CC, Type *ResultType, SDValue Target, ArgListTy &&ArgsList)
SmallVector< ISD::InputArg, 32 > Ins
CallLoweringInfo & setVarArg(bool Value=true)
Type * OrigRetTy
Original unlegalized return type.
std::optional< PtrAuthInfo > PAI
CallLoweringInfo & setDiscardResult(bool Value=true)
CallLoweringInfo & setZExtResult(bool Value=true)
CallLoweringInfo & setIsPatchPoint(bool Value=true)
CallLoweringInfo & setDebugLoc(const SDLoc &dl)
CallLoweringInfo & setLibCallee(CallingConv::ID CC, Type *ResultType, Type *OrigResultType, SDValue Target, ArgListTy &&ArgsList)
CallLoweringInfo & setTailCall(bool Value=true)
CallLoweringInfo & setIsPreallocated(bool Value=true)
CallLoweringInfo & setSExtResult(bool Value=true)
CallLoweringInfo & setNoReturn(bool Value=true)
CallLoweringInfo & setConvergenceControlToken(SDValue Token)
SmallVector< ISD::OutputArg, 32 > Outs
Type * RetTy
Same as OrigRetTy, or partially legalized for soft float libcalls.
CallLoweringInfo & setChain(SDValue InChain)
CallLoweringInfo & setPtrAuth(PtrAuthInfo Value)
CallLoweringInfo & setCallee(CallingConv::ID CC, Type *ResultType, SDValue Target, ArgListTy &&ArgsList, AttributeSet ResultAttrs={})
DAGCombinerInfo(SelectionDAG &dag, CombineLevel level, bool cl, void *dc)
This structure is used to pass arguments to makeLibCall function.
MakeLibCallOptions & setIsPostTypeLegalization(bool Value=true)
MakeLibCallOptions & setDiscardResult(bool Value=true)
MakeLibCallOptions & setTypeListBeforeSoften(ArrayRef< EVT > OpsVT, EVT RetVT)
MakeLibCallOptions & setIsSigned(bool Value=true)
MakeLibCallOptions & setNoReturn(bool Value=true)
MakeLibCallOptions & setOpsTypeOverrides(ArrayRef< Type * > OpsTypes)
Override the argument type for an operand.
This structure contains the information necessary for lowering pointer-authenticating indirect calls.
A convenience struct that encapsulates a DAG, and two SDValues for returning information from TargetL...
TargetLoweringOpt(SelectionDAG &InDAG, bool LT, bool LO)