1 //===-- SIFoldOperands.cpp - Fold operands --- ----------------------------===//
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 /// \file
8 //===----------------------------------------------------------------------===//
9 //
10 
11 #include "AMDGPU.h"
12 #include "AMDGPUSubtarget.h"
13 #include "SIInstrInfo.h"
14 #include "SIMachineFunctionInfo.h"
15 #include "MCTargetDesc/AMDGPUMCTargetDesc.h"
16 #include "llvm/ADT/DepthFirstIterator.h"
17 #include "llvm/ADT/SetVector.h"
18 #include "llvm/CodeGen/MachineFunctionPass.h"
19 #include "llvm/CodeGen/MachineInstrBuilder.h"
20 #include "llvm/CodeGen/MachineRegisterInfo.h"
21 #include "llvm/Support/Debug.h"
22 #include "llvm/Support/raw_ostream.h"
23 #include "llvm/Target/TargetMachine.h"
24 
25 #define DEBUG_TYPE "si-fold-operands"
26 using namespace llvm;
27 
28 namespace {
29 
30 struct FoldCandidate {
31   MachineInstr *UseMI;
32   union {
33     MachineOperand *OpToFold;
34     uint64_t ImmToFold;
35     int FrameIndexToFold;
36   };
37   int ShrinkOpcode;
38   unsigned UseOpNo;
39   MachineOperand::MachineOperandType Kind;
40   bool Commuted;
41 
42   FoldCandidate(MachineInstr *MI, unsigned OpNo, MachineOperand *FoldOp,
43                 bool Commuted_ = false,
44                 int ShrinkOp = -1) :
45     UseMI(MI), OpToFold(nullptr), ShrinkOpcode(ShrinkOp), UseOpNo(OpNo),
46     Kind(FoldOp->getType()),
47     Commuted(Commuted_) {
48     if (FoldOp->isImm()) {
49       ImmToFold = FoldOp->getImm();
50     } else if (FoldOp->isFI()) {
51       FrameIndexToFold = FoldOp->getIndex();
52     } else {
53       assert(FoldOp->isReg() || FoldOp->isGlobal());
54       OpToFold = FoldOp;
55     }
56   }
57 
58   bool isFI() const {
59     return Kind == MachineOperand::MO_FrameIndex;
60   }
61 
62   bool isImm() const {
63     return Kind == MachineOperand::MO_Immediate;
64   }
65 
66   bool isReg() const {
67     return Kind == MachineOperand::MO_Register;
68   }
69 
70   bool isGlobal() const { return Kind == MachineOperand::MO_GlobalAddress; }
71 
72   bool isCommuted() const {
73     return Commuted;
74   }
75 
76   bool needsShrink() const {
77     return ShrinkOpcode != -1;
78   }
79 
80   int getShrinkOpcode() const {
81     return ShrinkOpcode;
82   }
83 };
84 
85 class SIFoldOperands : public MachineFunctionPass {
86 public:
87   static char ID;
88   MachineRegisterInfo *MRI;
89   const SIInstrInfo *TII;
90   const SIRegisterInfo *TRI;
91   const GCNSubtarget *ST;
92   const SIMachineFunctionInfo *MFI;
93 
94   void foldOperand(MachineOperand &OpToFold,
95                    MachineInstr *UseMI,
96                    int UseOpIdx,
97                    SmallVectorImpl<FoldCandidate> &FoldList,
98                    SmallVectorImpl<MachineInstr *> &CopiesToReplace) const;
99 
100   void foldInstOperand(MachineInstr &MI, MachineOperand &OpToFold) const;
101 
102   const MachineOperand *isClamp(const MachineInstr &MI) const;
103   bool tryFoldClamp(MachineInstr &MI);
104 
105   std::pair<const MachineOperand *, int> isOMod(const MachineInstr &MI) const;
106   bool tryFoldOMod(MachineInstr &MI);
107 
108 public:
109   SIFoldOperands() : MachineFunctionPass(ID) {
110     initializeSIFoldOperandsPass(*PassRegistry::getPassRegistry());
111   }
112 
113   bool runOnMachineFunction(MachineFunction &MF) override;
114 
115   StringRef getPassName() const override { return "SI Fold Operands"; }
116 
117   void getAnalysisUsage(AnalysisUsage &AU) const override {
118     AU.setPreservesCFG();
119     MachineFunctionPass::getAnalysisUsage(AU);
120   }
121 };
122 
123 } // End anonymous namespace.
124 
125 INITIALIZE_PASS(SIFoldOperands, DEBUG_TYPE,
126                 "SI Fold Operands", false, false)
127 
128 char SIFoldOperands::ID = 0;
129 
130 char &llvm::SIFoldOperandsID = SIFoldOperands::ID;
131 
132 // Wrapper around isInlineConstant that understands special cases when
133 // instruction types are replaced during operand folding.
134 static bool isInlineConstantIfFolded(const SIInstrInfo *TII,
135                                      const MachineInstr &UseMI,
136                                      unsigned OpNo,
137                                      const MachineOperand &OpToFold) {
138   if (TII->isInlineConstant(UseMI, OpNo, OpToFold))
139     return true;
140 
141   unsigned Opc = UseMI.getOpcode();
142   switch (Opc) {
143   case AMDGPU::V_MAC_F32_e64:
144   case AMDGPU::V_MAC_F16_e64:
145   case AMDGPU::V_FMAC_F32_e64:
146   case AMDGPU::V_FMAC_F16_e64: {
147     // Special case for mac. Since this is replaced with mad when folded into
148     // src2, we need to check the legality for the final instruction.
149     int Src2Idx = AMDGPU::getNamedOperandIdx(Opc, AMDGPU::OpName::src2);
150     if (static_cast<int>(OpNo) == Src2Idx) {
151       bool IsFMA = Opc == AMDGPU::V_FMAC_F32_e64 ||
152                    Opc == AMDGPU::V_FMAC_F16_e64;
153       bool IsF32 = Opc == AMDGPU::V_MAC_F32_e64 ||
154                    Opc == AMDGPU::V_FMAC_F32_e64;
155 
156       unsigned Opc = IsFMA ?
157         (IsF32 ? AMDGPU::V_FMA_F32 : AMDGPU::V_FMA_F16_gfx9) :
158         (IsF32 ? AMDGPU::V_MAD_F32 : AMDGPU::V_MAD_F16);
159       const MCInstrDesc &MadDesc = TII->get(Opc);
160       return TII->isInlineConstant(OpToFold, MadDesc.OpInfo[OpNo].OperandType);
161     }
162     return false;
163   }
164   default:
165     return false;
166   }
167 }
168 
169 // TODO: Add heuristic that the frame index might not fit in the addressing mode
170 // immediate offset to avoid materializing in loops.
171 static bool frameIndexMayFold(const SIInstrInfo *TII,
172                               const MachineInstr &UseMI,
173                               int OpNo,
174                               const MachineOperand &OpToFold) {
175   return OpToFold.isFI() &&
176     (TII->isMUBUF(UseMI) || TII->isFLATScratch(UseMI)) &&
177     OpNo == AMDGPU::getNamedOperandIdx(UseMI.getOpcode(), AMDGPU::OpName::vaddr);
178 }
179 
180 FunctionPass *llvm::createSIFoldOperandsPass() {
181   return new SIFoldOperands();
182 }
183 
184 static bool updateOperand(FoldCandidate &Fold,
185                           const SIInstrInfo &TII,
186                           const TargetRegisterInfo &TRI,
187                           const GCNSubtarget &ST) {
188   MachineInstr *MI = Fold.UseMI;
189   MachineOperand &Old = MI->getOperand(Fold.UseOpNo);
190   assert(Old.isReg());
191 
192   if (Fold.isImm()) {
193     if (MI->getDesc().TSFlags & SIInstrFlags::IsPacked &&
194         !(MI->getDesc().TSFlags & SIInstrFlags::IsMAI) &&
195         AMDGPU::isInlinableLiteralV216(static_cast<uint16_t>(Fold.ImmToFold),
196                                        ST.hasInv2PiInlineImm())) {
197       // Set op_sel/op_sel_hi on this operand or bail out if op_sel is
198       // already set.
199       unsigned Opcode = MI->getOpcode();
200       int OpNo = MI->getOperandNo(&Old);
201       int ModIdx = -1;
202       if (OpNo == AMDGPU::getNamedOperandIdx(Opcode, AMDGPU::OpName::src0))
203         ModIdx = AMDGPU::OpName::src0_modifiers;
204       else if (OpNo == AMDGPU::getNamedOperandIdx(Opcode, AMDGPU::OpName::src1))
205         ModIdx = AMDGPU::OpName::src1_modifiers;
206       else if (OpNo == AMDGPU::getNamedOperandIdx(Opcode, AMDGPU::OpName::src2))
207         ModIdx = AMDGPU::OpName::src2_modifiers;
208       assert(ModIdx != -1);
209       ModIdx = AMDGPU::getNamedOperandIdx(Opcode, ModIdx);
210       MachineOperand &Mod = MI->getOperand(ModIdx);
211       unsigned Val = Mod.getImm();
212       if ((Val & SISrcMods::OP_SEL_0) || !(Val & SISrcMods::OP_SEL_1))
213         return false;
214       // Only apply the following transformation if that operand requries
215       // a packed immediate.
216       switch (TII.get(Opcode).OpInfo[OpNo].OperandType) {
217       case AMDGPU::OPERAND_REG_IMM_V2FP16:
218       case AMDGPU::OPERAND_REG_IMM_V2INT16:
219       case AMDGPU::OPERAND_REG_INLINE_C_V2FP16:
220       case AMDGPU::OPERAND_REG_INLINE_C_V2INT16:
221         // If upper part is all zero we do not need op_sel_hi.
222         if (!isUInt<16>(Fold.ImmToFold)) {
223           if (!(Fold.ImmToFold & 0xffff)) {
224             Mod.setImm(Mod.getImm() | SISrcMods::OP_SEL_0);
225             Mod.setImm(Mod.getImm() & ~SISrcMods::OP_SEL_1);
226             Old.ChangeToImmediate((Fold.ImmToFold >> 16) & 0xffff);
227             return true;
228           }
229           Mod.setImm(Mod.getImm() & ~SISrcMods::OP_SEL_1);
230           Old.ChangeToImmediate(Fold.ImmToFold & 0xffff);
231           return true;
232         }
233         break;
234       default:
235         break;
236       }
237     }
238   }
239 
240   if ((Fold.isImm() || Fold.isFI() || Fold.isGlobal()) && Fold.needsShrink()) {
241     MachineBasicBlock *MBB = MI->getParent();
242     auto Liveness = MBB->computeRegisterLiveness(&TRI, AMDGPU::VCC, MI, 16);
243     if (Liveness != MachineBasicBlock::LQR_Dead) {
244       LLVM_DEBUG(dbgs() << "Not shrinking " << MI << " due to vcc liveness\n");
245       return false;
246     }
247 
248     MachineRegisterInfo &MRI = MBB->getParent()->getRegInfo();
249     int Op32 = Fold.getShrinkOpcode();
250     MachineOperand &Dst0 = MI->getOperand(0);
251     MachineOperand &Dst1 = MI->getOperand(1);
252     assert(Dst0.isDef() && Dst1.isDef());
253 
254     bool HaveNonDbgCarryUse = !MRI.use_nodbg_empty(Dst1.getReg());
255 
256     const TargetRegisterClass *Dst0RC = MRI.getRegClass(Dst0.getReg());
257     Register NewReg0 = MRI.createVirtualRegister(Dst0RC);
258 
259     MachineInstr *Inst32 = TII.buildShrunkInst(*MI, Op32);
260 
261     if (HaveNonDbgCarryUse) {
262       BuildMI(*MBB, MI, MI->getDebugLoc(), TII.get(AMDGPU::COPY), Dst1.getReg())
263         .addReg(AMDGPU::VCC, RegState::Kill);
264     }
265 
266     // Keep the old instruction around to avoid breaking iterators, but
267     // replace it with a dummy instruction to remove uses.
268     //
269     // FIXME: We should not invert how this pass looks at operands to avoid
270     // this. Should track set of foldable movs instead of looking for uses
271     // when looking at a use.
272     Dst0.setReg(NewReg0);
273     for (unsigned I = MI->getNumOperands() - 1; I > 0; --I)
274       MI->RemoveOperand(I);
275     MI->setDesc(TII.get(AMDGPU::IMPLICIT_DEF));
276 
277     if (Fold.isCommuted())
278       TII.commuteInstruction(*Inst32, false);
279     return true;
280   }
281 
282   assert(!Fold.needsShrink() && "not handled");
283 
284   if (Fold.isImm()) {
285     // FIXME: ChangeToImmediate should probably clear the subreg flags. It's
286     // reinterpreted as TargetFlags.
287     Old.setSubReg(0);
288     Old.ChangeToImmediate(Fold.ImmToFold);
289     return true;
290   }
291 
292   if (Fold.isGlobal()) {
293     Old.ChangeToGA(Fold.OpToFold->getGlobal(), Fold.OpToFold->getOffset(),
294                    Fold.OpToFold->getTargetFlags());
295     return true;
296   }
297 
298   if (Fold.isFI()) {
299     Old.ChangeToFrameIndex(Fold.FrameIndexToFold);
300     return true;
301   }
302 
303   MachineOperand *New = Fold.OpToFold;
304   Old.substVirtReg(New->getReg(), New->getSubReg(), TRI);
305   Old.setIsUndef(New->isUndef());
306   return true;
307 }
308 
309 static bool isUseMIInFoldList(ArrayRef<FoldCandidate> FoldList,
310                               const MachineInstr *MI) {
311   for (auto Candidate : FoldList) {
312     if (Candidate.UseMI == MI)
313       return true;
314   }
315   return false;
316 }
317 
318 static void appendFoldCandidate(SmallVectorImpl<FoldCandidate> &FoldList,
319                                 MachineInstr *MI, unsigned OpNo,
320                                 MachineOperand *FoldOp, bool Commuted = false,
321                                 int ShrinkOp = -1) {
322   // Skip additional folding on the same operand.
323   for (FoldCandidate &Fold : FoldList)
324     if (Fold.UseMI == MI && Fold.UseOpNo == OpNo)
325       return;
326   LLVM_DEBUG(dbgs() << "Append " << (Commuted ? "commuted" : "normal")
327                     << " operand " << OpNo << "\n  " << *MI << '\n');
328   FoldList.push_back(FoldCandidate(MI, OpNo, FoldOp, Commuted, ShrinkOp));
329 }
330 
331 static bool tryAddToFoldList(SmallVectorImpl<FoldCandidate> &FoldList,
332                              MachineInstr *MI, unsigned OpNo,
333                              MachineOperand *OpToFold,
334                              const SIInstrInfo *TII) {
335   if (!TII->isOperandLegal(*MI, OpNo, OpToFold)) {
336     // Special case for v_mac_{f16, f32}_e64 if we are trying to fold into src2
337     unsigned Opc = MI->getOpcode();
338     if ((Opc == AMDGPU::V_MAC_F32_e64 || Opc == AMDGPU::V_MAC_F16_e64 ||
339          Opc == AMDGPU::V_FMAC_F32_e64 || Opc == AMDGPU::V_FMAC_F16_e64) &&
340         (int)OpNo == AMDGPU::getNamedOperandIdx(Opc, AMDGPU::OpName::src2)) {
341       bool IsFMA = Opc == AMDGPU::V_FMAC_F32_e64 ||
342                    Opc == AMDGPU::V_FMAC_F16_e64;
343       bool IsF32 = Opc == AMDGPU::V_MAC_F32_e64 ||
344                    Opc == AMDGPU::V_FMAC_F32_e64;
345       unsigned NewOpc = IsFMA ?
346         (IsF32 ? AMDGPU::V_FMA_F32 : AMDGPU::V_FMA_F16_gfx9) :
347         (IsF32 ? AMDGPU::V_MAD_F32 : AMDGPU::V_MAD_F16);
348 
349       // Check if changing this to a v_mad_{f16, f32} instruction will allow us
350       // to fold the operand.
351       MI->setDesc(TII->get(NewOpc));
352       bool FoldAsMAD = tryAddToFoldList(FoldList, MI, OpNo, OpToFold, TII);
353       if (FoldAsMAD) {
354         MI->untieRegOperand(OpNo);
355         return true;
356       }
357       MI->setDesc(TII->get(Opc));
358     }
359 
360     // Special case for s_setreg_b32
361     if (Opc == AMDGPU::S_SETREG_B32 && OpToFold->isImm()) {
362       MI->setDesc(TII->get(AMDGPU::S_SETREG_IMM32_B32));
363       appendFoldCandidate(FoldList, MI, OpNo, OpToFold);
364       return true;
365     }
366 
367     // If we are already folding into another operand of MI, then
368     // we can't commute the instruction, otherwise we risk making the
369     // other fold illegal.
370     if (isUseMIInFoldList(FoldList, MI))
371       return false;
372 
373     unsigned CommuteOpNo = OpNo;
374 
375     // Operand is not legal, so try to commute the instruction to
376     // see if this makes it possible to fold.
377     unsigned CommuteIdx0 = TargetInstrInfo::CommuteAnyOperandIndex;
378     unsigned CommuteIdx1 = TargetInstrInfo::CommuteAnyOperandIndex;
379     bool CanCommute = TII->findCommutedOpIndices(*MI, CommuteIdx0, CommuteIdx1);
380 
381     if (CanCommute) {
382       if (CommuteIdx0 == OpNo)
383         CommuteOpNo = CommuteIdx1;
384       else if (CommuteIdx1 == OpNo)
385         CommuteOpNo = CommuteIdx0;
386     }
387 
388 
389     // One of operands might be an Imm operand, and OpNo may refer to it after
390     // the call of commuteInstruction() below. Such situations are avoided
391     // here explicitly as OpNo must be a register operand to be a candidate
392     // for memory folding.
393     if (CanCommute && (!MI->getOperand(CommuteIdx0).isReg() ||
394                        !MI->getOperand(CommuteIdx1).isReg()))
395       return false;
396 
397     if (!CanCommute ||
398         !TII->commuteInstruction(*MI, false, CommuteIdx0, CommuteIdx1))
399       return false;
400 
401     if (!TII->isOperandLegal(*MI, CommuteOpNo, OpToFold)) {
402       if ((Opc == AMDGPU::V_ADD_CO_U32_e64 ||
403            Opc == AMDGPU::V_SUB_CO_U32_e64 ||
404            Opc == AMDGPU::V_SUBREV_CO_U32_e64) && // FIXME
405           (OpToFold->isImm() || OpToFold->isFI() || OpToFold->isGlobal())) {
406         MachineRegisterInfo &MRI = MI->getParent()->getParent()->getRegInfo();
407 
408         // Verify the other operand is a VGPR, otherwise we would violate the
409         // constant bus restriction.
410         unsigned OtherIdx = CommuteOpNo == CommuteIdx0 ? CommuteIdx1 : CommuteIdx0;
411         MachineOperand &OtherOp = MI->getOperand(OtherIdx);
412         if (!OtherOp.isReg() ||
413             !TII->getRegisterInfo().isVGPR(MRI, OtherOp.getReg()))
414           return false;
415 
416         assert(MI->getOperand(1).isDef());
417 
418         // Make sure to get the 32-bit version of the commuted opcode.
419         unsigned MaybeCommutedOpc = MI->getOpcode();
420         int Op32 = AMDGPU::getVOPe32(MaybeCommutedOpc);
421 
422         appendFoldCandidate(FoldList, MI, CommuteOpNo, OpToFold, true, Op32);
423         return true;
424       }
425 
426       TII->commuteInstruction(*MI, false, CommuteIdx0, CommuteIdx1);
427       return false;
428     }
429 
430     appendFoldCandidate(FoldList, MI, CommuteOpNo, OpToFold, true);
431     return true;
432   }
433 
434   // Check the case where we might introduce a second constant operand to a
435   // scalar instruction
436   if (TII->isSALU(MI->getOpcode())) {
437     const MCInstrDesc &InstDesc = MI->getDesc();
438     const MCOperandInfo &OpInfo = InstDesc.OpInfo[OpNo];
439     const SIRegisterInfo &SRI = TII->getRegisterInfo();
440 
441     // Fine if the operand can be encoded as an inline constant
442     if (OpToFold->isImm()) {
443       if (!SRI.opCanUseInlineConstant(OpInfo.OperandType) ||
444           !TII->isInlineConstant(*OpToFold, OpInfo)) {
445         // Otherwise check for another constant
446         for (unsigned i = 0, e = InstDesc.getNumOperands(); i != e; ++i) {
447           auto &Op = MI->getOperand(i);
448           if (OpNo != i &&
449               TII->isLiteralConstantLike(Op, OpInfo)) {
450             return false;
451           }
452         }
453       }
454     }
455   }
456 
457   appendFoldCandidate(FoldList, MI, OpNo, OpToFold);
458   return true;
459 }
460 
461 // If the use operand doesn't care about the value, this may be an operand only
462 // used for register indexing, in which case it is unsafe to fold.
463 static bool isUseSafeToFold(const SIInstrInfo *TII,
464                             const MachineInstr &MI,
465                             const MachineOperand &UseMO) {
466   if (UseMO.isUndef() || TII->isSDWA(MI))
467     return false;
468 
469   switch (MI.getOpcode()) {
470   case AMDGPU::V_MOV_B32_e32:
471   case AMDGPU::V_MOV_B32_e64:
472   case AMDGPU::V_MOV_B64_PSEUDO:
473     // Do not fold into an indirect mov.
474     return !MI.hasRegisterImplicitUseOperand(AMDGPU::M0);
475   }
476 
477   return true;
478   //return !MI.hasRegisterImplicitUseOperand(UseMO.getReg());
479 }
480 
481 // Find a def of the UseReg, check if it is a reg_seqence and find initializers
482 // for each subreg, tracking it to foldable inline immediate if possible.
483 // Returns true on success.
484 static bool getRegSeqInit(
485     SmallVectorImpl<std::pair<MachineOperand*, unsigned>> &Defs,
486     Register UseReg, uint8_t OpTy,
487     const SIInstrInfo *TII, const MachineRegisterInfo &MRI) {
488   MachineInstr *Def = MRI.getUniqueVRegDef(UseReg);
489   if (!Def || !Def->isRegSequence())
490     return false;
491 
492   for (unsigned I = 1, E = Def->getNumExplicitOperands(); I < E; I += 2) {
493     MachineOperand *Sub = &Def->getOperand(I);
494     assert (Sub->isReg());
495 
496     for (MachineInstr *SubDef = MRI.getUniqueVRegDef(Sub->getReg());
497          SubDef && Sub->isReg() && !Sub->getSubReg() &&
498          TII->isFoldableCopy(*SubDef);
499          SubDef = MRI.getUniqueVRegDef(Sub->getReg())) {
500       MachineOperand *Op = &SubDef->getOperand(1);
501       if (Op->isImm()) {
502         if (TII->isInlineConstant(*Op, OpTy))
503           Sub = Op;
504         break;
505       }
506       if (!Op->isReg())
507         break;
508       Sub = Op;
509     }
510 
511     Defs.push_back(std::make_pair(Sub, Def->getOperand(I + 1).getImm()));
512   }
513 
514   return true;
515 }
516 
517 static bool tryToFoldACImm(const SIInstrInfo *TII,
518                            const MachineOperand &OpToFold,
519                            MachineInstr *UseMI,
520                            unsigned UseOpIdx,
521                            SmallVectorImpl<FoldCandidate> &FoldList) {
522   const MCInstrDesc &Desc = UseMI->getDesc();
523   const MCOperandInfo *OpInfo = Desc.OpInfo;
524   if (!OpInfo || UseOpIdx >= Desc.getNumOperands())
525     return false;
526 
527   uint8_t OpTy = OpInfo[UseOpIdx].OperandType;
528   if (OpTy < AMDGPU::OPERAND_REG_INLINE_AC_FIRST ||
529       OpTy > AMDGPU::OPERAND_REG_INLINE_AC_LAST)
530     return false;
531 
532   if (OpToFold.isImm() && TII->isInlineConstant(OpToFold, OpTy) &&
533       TII->isOperandLegal(*UseMI, UseOpIdx, &OpToFold)) {
534     UseMI->getOperand(UseOpIdx).ChangeToImmediate(OpToFold.getImm());
535     return true;
536   }
537 
538   if (!OpToFold.isReg())
539     return false;
540 
541   Register UseReg = OpToFold.getReg();
542   if (!Register::isVirtualRegister(UseReg))
543     return false;
544 
545   if (llvm::find_if(FoldList, [UseMI](const FoldCandidate &FC) {
546         return FC.UseMI == UseMI; }) != FoldList.end())
547     return false;
548 
549   MachineRegisterInfo &MRI = UseMI->getParent()->getParent()->getRegInfo();
550   SmallVector<std::pair<MachineOperand*, unsigned>, 32> Defs;
551   if (!getRegSeqInit(Defs, UseReg, OpTy, TII, MRI))
552     return false;
553 
554   int32_t Imm;
555   for (unsigned I = 0, E = Defs.size(); I != E; ++I) {
556     const MachineOperand *Op = Defs[I].first;
557     if (!Op->isImm())
558       return false;
559 
560     auto SubImm = Op->getImm();
561     if (!I) {
562       Imm = SubImm;
563       if (!TII->isInlineConstant(*Op, OpTy) ||
564           !TII->isOperandLegal(*UseMI, UseOpIdx, Op))
565         return false;
566 
567       continue;
568     }
569     if (Imm != SubImm)
570       return false; // Can only fold splat constants
571   }
572 
573   appendFoldCandidate(FoldList, UseMI, UseOpIdx, Defs[0].first);
574   return true;
575 }
576 
577 void SIFoldOperands::foldOperand(
578   MachineOperand &OpToFold,
579   MachineInstr *UseMI,
580   int UseOpIdx,
581   SmallVectorImpl<FoldCandidate> &FoldList,
582   SmallVectorImpl<MachineInstr *> &CopiesToReplace) const {
583   const MachineOperand &UseOp = UseMI->getOperand(UseOpIdx);
584 
585   if (!isUseSafeToFold(TII, *UseMI, UseOp))
586     return;
587 
588   // FIXME: Fold operands with subregs.
589   if (UseOp.isReg() && OpToFold.isReg()) {
590     if (UseOp.isImplicit() || UseOp.getSubReg() != AMDGPU::NoSubRegister)
591       return;
592   }
593 
594   // Special case for REG_SEQUENCE: We can't fold literals into
595   // REG_SEQUENCE instructions, so we have to fold them into the
596   // uses of REG_SEQUENCE.
597   if (UseMI->isRegSequence()) {
598     Register RegSeqDstReg = UseMI->getOperand(0).getReg();
599     unsigned RegSeqDstSubReg = UseMI->getOperand(UseOpIdx + 1).getImm();
600 
601     MachineRegisterInfo::use_iterator Next;
602     for (MachineRegisterInfo::use_iterator
603            RSUse = MRI->use_begin(RegSeqDstReg), RSE = MRI->use_end();
604          RSUse != RSE; RSUse = Next) {
605       Next = std::next(RSUse);
606 
607       MachineInstr *RSUseMI = RSUse->getParent();
608 
609       if (tryToFoldACImm(TII, UseMI->getOperand(0), RSUseMI,
610                          RSUse.getOperandNo(), FoldList))
611         continue;
612 
613       if (RSUse->getSubReg() != RegSeqDstSubReg)
614         continue;
615 
616       foldOperand(OpToFold, RSUseMI, RSUse.getOperandNo(), FoldList,
617                   CopiesToReplace);
618     }
619 
620     return;
621   }
622 
623   if (tryToFoldACImm(TII, OpToFold, UseMI, UseOpIdx, FoldList))
624     return;
625 
626   if (frameIndexMayFold(TII, *UseMI, UseOpIdx, OpToFold)) {
627     // Sanity check that this is a stack access.
628     // FIXME: Should probably use stack pseudos before frame lowering.
629 
630     if (TII->getNamedOperand(*UseMI, AMDGPU::OpName::srsrc)->getReg() !=
631         MFI->getScratchRSrcReg())
632       return;
633 
634     // Ensure this is either relative to the current frame or the current wave.
635     MachineOperand &SOff =
636         *TII->getNamedOperand(*UseMI, AMDGPU::OpName::soffset);
637     if ((!SOff.isReg() || SOff.getReg() != MFI->getStackPtrOffsetReg()) &&
638         (!SOff.isImm() || SOff.getImm() != 0))
639       return;
640 
641     // A frame index will resolve to a positive constant, so it should always be
642     // safe to fold the addressing mode, even pre-GFX9.
643     UseMI->getOperand(UseOpIdx).ChangeToFrameIndex(OpToFold.getIndex());
644 
645     // If this is relative to the current wave, update it to be relative to the
646     // current frame.
647     if (SOff.isImm())
648       SOff.ChangeToRegister(MFI->getStackPtrOffsetReg(), false);
649     return;
650   }
651 
652   bool FoldingImmLike =
653       OpToFold.isImm() || OpToFold.isFI() || OpToFold.isGlobal();
654 
655   if (FoldingImmLike && UseMI->isCopy()) {
656     Register DestReg = UseMI->getOperand(0).getReg();
657     Register SrcReg = UseMI->getOperand(1).getReg();
658     assert(SrcReg.isVirtual());
659 
660     const TargetRegisterClass *SrcRC = MRI->getRegClass(SrcReg);
661 
662     // Don't fold into a copy to a physical register with the same class. Doing
663     // so would interfere with the register coalescer's logic which would avoid
664     // redundant initalizations.
665     if (DestReg.isPhysical() && SrcRC->contains(DestReg))
666       return;
667 
668     const TargetRegisterClass *DestRC = TRI->getRegClassForReg(*MRI, DestReg);
669     if (TRI->isSGPRClass(SrcRC) && TRI->hasVectorRegisters(DestRC)) {
670       MachineRegisterInfo::use_iterator NextUse;
671       SmallVector<FoldCandidate, 4> CopyUses;
672       for (MachineRegisterInfo::use_iterator Use = MRI->use_begin(DestReg),
673                                              E = MRI->use_end();
674            Use != E; Use = NextUse) {
675         NextUse = std::next(Use);
676         // There's no point trying to fold into an implicit operand.
677         if (Use->isImplicit())
678           continue;
679 
680         FoldCandidate FC = FoldCandidate(Use->getParent(), Use.getOperandNo(),
681                                          &UseMI->getOperand(1));
682         CopyUses.push_back(FC);
683       }
684       for (auto &F : CopyUses) {
685         foldOperand(*F.OpToFold, F.UseMI, F.UseOpNo, FoldList, CopiesToReplace);
686       }
687     }
688 
689     if (DestRC == &AMDGPU::AGPR_32RegClass &&
690         TII->isInlineConstant(OpToFold, AMDGPU::OPERAND_REG_INLINE_C_INT32)) {
691       UseMI->setDesc(TII->get(AMDGPU::V_ACCVGPR_WRITE_B32));
692       UseMI->getOperand(1).ChangeToImmediate(OpToFold.getImm());
693       CopiesToReplace.push_back(UseMI);
694       return;
695     }
696 
697     // In order to fold immediates into copies, we need to change the
698     // copy to a MOV.
699 
700     unsigned MovOp = TII->getMovOpcode(DestRC);
701     if (MovOp == AMDGPU::COPY)
702       return;
703 
704     UseMI->setDesc(TII->get(MovOp));
705     MachineInstr::mop_iterator ImpOpI = UseMI->implicit_operands().begin();
706     MachineInstr::mop_iterator ImpOpE = UseMI->implicit_operands().end();
707     while (ImpOpI != ImpOpE) {
708       MachineInstr::mop_iterator Tmp = ImpOpI;
709       ImpOpI++;
710       UseMI->RemoveOperand(UseMI->getOperandNo(Tmp));
711     }
712     CopiesToReplace.push_back(UseMI);
713   } else {
714     if (UseMI->isCopy() && OpToFold.isReg() &&
715         UseMI->getOperand(0).getReg().isVirtual() &&
716         !UseMI->getOperand(1).getSubReg()) {
717       LLVM_DEBUG(dbgs() << "Folding " << OpToFold
718                         << "\n into " << *UseMI << '\n');
719       unsigned Size = TII->getOpSize(*UseMI, 1);
720       Register UseReg = OpToFold.getReg();
721       UseMI->getOperand(1).setReg(UseReg);
722       UseMI->getOperand(1).setSubReg(OpToFold.getSubReg());
723       UseMI->getOperand(1).setIsKill(false);
724       CopiesToReplace.push_back(UseMI);
725       OpToFold.setIsKill(false);
726 
727       // That is very tricky to store a value into an AGPR. v_accvgpr_write_b32
728       // can only accept VGPR or inline immediate. Recreate a reg_sequence with
729       // its initializers right here, so we will rematerialize immediates and
730       // avoid copies via different reg classes.
731       SmallVector<std::pair<MachineOperand*, unsigned>, 32> Defs;
732       if (Size > 4 && TRI->isAGPR(*MRI, UseMI->getOperand(0).getReg()) &&
733           getRegSeqInit(Defs, UseReg, AMDGPU::OPERAND_REG_INLINE_C_INT32, TII,
734                         *MRI)) {
735         const DebugLoc &DL = UseMI->getDebugLoc();
736         MachineBasicBlock &MBB = *UseMI->getParent();
737 
738         UseMI->setDesc(TII->get(AMDGPU::REG_SEQUENCE));
739         for (unsigned I = UseMI->getNumOperands() - 1; I > 0; --I)
740           UseMI->RemoveOperand(I);
741 
742         MachineInstrBuilder B(*MBB.getParent(), UseMI);
743         DenseMap<TargetInstrInfo::RegSubRegPair, Register> VGPRCopies;
744         SmallSetVector<TargetInstrInfo::RegSubRegPair, 32> SeenAGPRs;
745         for (unsigned I = 0; I < Size / 4; ++I) {
746           MachineOperand *Def = Defs[I].first;
747           TargetInstrInfo::RegSubRegPair CopyToVGPR;
748           if (Def->isImm() &&
749               TII->isInlineConstant(*Def, AMDGPU::OPERAND_REG_INLINE_C_INT32)) {
750             int64_t Imm = Def->getImm();
751 
752             auto Tmp = MRI->createVirtualRegister(&AMDGPU::AGPR_32RegClass);
753             BuildMI(MBB, UseMI, DL,
754                     TII->get(AMDGPU::V_ACCVGPR_WRITE_B32), Tmp).addImm(Imm);
755             B.addReg(Tmp);
756           } else if (Def->isReg() && TRI->isAGPR(*MRI, Def->getReg())) {
757             auto Src = getRegSubRegPair(*Def);
758             Def->setIsKill(false);
759             if (!SeenAGPRs.insert(Src)) {
760               // We cannot build a reg_sequence out of the same registers, they
761               // must be copied. Better do it here before copyPhysReg() created
762               // several reads to do the AGPR->VGPR->AGPR copy.
763               CopyToVGPR = Src;
764             } else {
765               B.addReg(Src.Reg, Def->isUndef() ? RegState::Undef : 0,
766                        Src.SubReg);
767             }
768           } else {
769             assert(Def->isReg());
770             Def->setIsKill(false);
771             auto Src = getRegSubRegPair(*Def);
772 
773             // Direct copy from SGPR to AGPR is not possible. To avoid creation
774             // of exploded copies SGPR->VGPR->AGPR in the copyPhysReg() later,
775             // create a copy here and track if we already have such a copy.
776             if (TRI->isSGPRReg(*MRI, Src.Reg)) {
777               CopyToVGPR = Src;
778             } else {
779               auto Tmp = MRI->createVirtualRegister(&AMDGPU::AGPR_32RegClass);
780               BuildMI(MBB, UseMI, DL, TII->get(AMDGPU::COPY), Tmp).add(*Def);
781               B.addReg(Tmp);
782             }
783           }
784 
785           if (CopyToVGPR.Reg) {
786             Register Vgpr;
787             if (VGPRCopies.count(CopyToVGPR)) {
788               Vgpr = VGPRCopies[CopyToVGPR];
789             } else {
790               Vgpr = MRI->createVirtualRegister(&AMDGPU::VGPR_32RegClass);
791               BuildMI(MBB, UseMI, DL, TII->get(AMDGPU::COPY), Vgpr).add(*Def);
792               VGPRCopies[CopyToVGPR] = Vgpr;
793             }
794             auto Tmp = MRI->createVirtualRegister(&AMDGPU::AGPR_32RegClass);
795             BuildMI(MBB, UseMI, DL,
796                     TII->get(AMDGPU::V_ACCVGPR_WRITE_B32), Tmp).addReg(Vgpr);
797             B.addReg(Tmp);
798           }
799 
800           B.addImm(Defs[I].second);
801         }
802         LLVM_DEBUG(dbgs() << "Folded " << *UseMI << '\n');
803         return;
804       }
805 
806       if (Size != 4)
807         return;
808       if (TRI->isAGPR(*MRI, UseMI->getOperand(0).getReg()) &&
809           TRI->isVGPR(*MRI, UseMI->getOperand(1).getReg()))
810         UseMI->setDesc(TII->get(AMDGPU::V_ACCVGPR_WRITE_B32));
811       else if (TRI->isVGPR(*MRI, UseMI->getOperand(0).getReg()) &&
812                TRI->isAGPR(*MRI, UseMI->getOperand(1).getReg()))
813         UseMI->setDesc(TII->get(AMDGPU::V_ACCVGPR_READ_B32));
814       return;
815     }
816 
817     unsigned UseOpc = UseMI->getOpcode();
818     if (UseOpc == AMDGPU::V_READFIRSTLANE_B32 ||
819         (UseOpc == AMDGPU::V_READLANE_B32 &&
820          (int)UseOpIdx ==
821          AMDGPU::getNamedOperandIdx(UseOpc, AMDGPU::OpName::src0))) {
822       // %vgpr = V_MOV_B32 imm
823       // %sgpr = V_READFIRSTLANE_B32 %vgpr
824       // =>
825       // %sgpr = S_MOV_B32 imm
826       if (FoldingImmLike) {
827         if (execMayBeModifiedBeforeUse(*MRI,
828                                        UseMI->getOperand(UseOpIdx).getReg(),
829                                        *OpToFold.getParent(),
830                                        *UseMI))
831           return;
832 
833         UseMI->setDesc(TII->get(AMDGPU::S_MOV_B32));
834 
835         // FIXME: ChangeToImmediate should clear subreg
836         UseMI->getOperand(1).setSubReg(0);
837         if (OpToFold.isImm())
838           UseMI->getOperand(1).ChangeToImmediate(OpToFold.getImm());
839         else
840           UseMI->getOperand(1).ChangeToFrameIndex(OpToFold.getIndex());
841         UseMI->RemoveOperand(2); // Remove exec read (or src1 for readlane)
842         return;
843       }
844 
845       if (OpToFold.isReg() && TRI->isSGPRReg(*MRI, OpToFold.getReg())) {
846         if (execMayBeModifiedBeforeUse(*MRI,
847                                        UseMI->getOperand(UseOpIdx).getReg(),
848                                        *OpToFold.getParent(),
849                                        *UseMI))
850           return;
851 
852         // %vgpr = COPY %sgpr0
853         // %sgpr1 = V_READFIRSTLANE_B32 %vgpr
854         // =>
855         // %sgpr1 = COPY %sgpr0
856         UseMI->setDesc(TII->get(AMDGPU::COPY));
857         UseMI->getOperand(1).setReg(OpToFold.getReg());
858         UseMI->getOperand(1).setSubReg(OpToFold.getSubReg());
859         UseMI->getOperand(1).setIsKill(false);
860         UseMI->RemoveOperand(2); // Remove exec read (or src1 for readlane)
861         return;
862       }
863     }
864 
865     const MCInstrDesc &UseDesc = UseMI->getDesc();
866 
867     // Don't fold into target independent nodes.  Target independent opcodes
868     // don't have defined register classes.
869     if (UseDesc.isVariadic() ||
870         UseOp.isImplicit() ||
871         UseDesc.OpInfo[UseOpIdx].RegClass == -1)
872       return;
873   }
874 
875   if (!FoldingImmLike) {
876     tryAddToFoldList(FoldList, UseMI, UseOpIdx, &OpToFold, TII);
877 
878     // FIXME: We could try to change the instruction from 64-bit to 32-bit
879     // to enable more folding opportunites.  The shrink operands pass
880     // already does this.
881     return;
882   }
883 
884 
885   const MCInstrDesc &FoldDesc = OpToFold.getParent()->getDesc();
886   const TargetRegisterClass *FoldRC =
887     TRI->getRegClass(FoldDesc.OpInfo[0].RegClass);
888 
889   // Split 64-bit constants into 32-bits for folding.
890   if (UseOp.getSubReg() && AMDGPU::getRegBitWidth(FoldRC->getID()) == 64) {
891     Register UseReg = UseOp.getReg();
892     const TargetRegisterClass *UseRC = MRI->getRegClass(UseReg);
893 
894     if (AMDGPU::getRegBitWidth(UseRC->getID()) != 64)
895       return;
896 
897     APInt Imm(64, OpToFold.getImm());
898     if (UseOp.getSubReg() == AMDGPU::sub0) {
899       Imm = Imm.getLoBits(32);
900     } else {
901       assert(UseOp.getSubReg() == AMDGPU::sub1);
902       Imm = Imm.getHiBits(32);
903     }
904 
905     MachineOperand ImmOp = MachineOperand::CreateImm(Imm.getSExtValue());
906     tryAddToFoldList(FoldList, UseMI, UseOpIdx, &ImmOp, TII);
907     return;
908   }
909 
910 
911 
912   tryAddToFoldList(FoldList, UseMI, UseOpIdx, &OpToFold, TII);
913 }
914 
915 static bool evalBinaryInstruction(unsigned Opcode, int32_t &Result,
916                                   uint32_t LHS, uint32_t RHS) {
917   switch (Opcode) {
918   case AMDGPU::V_AND_B32_e64:
919   case AMDGPU::V_AND_B32_e32:
920   case AMDGPU::S_AND_B32:
921     Result = LHS & RHS;
922     return true;
923   case AMDGPU::V_OR_B32_e64:
924   case AMDGPU::V_OR_B32_e32:
925   case AMDGPU::S_OR_B32:
926     Result = LHS | RHS;
927     return true;
928   case AMDGPU::V_XOR_B32_e64:
929   case AMDGPU::V_XOR_B32_e32:
930   case AMDGPU::S_XOR_B32:
931     Result = LHS ^ RHS;
932     return true;
933   case AMDGPU::S_XNOR_B32:
934     Result = ~(LHS ^ RHS);
935     return true;
936   case AMDGPU::S_NAND_B32:
937     Result = ~(LHS & RHS);
938     return true;
939   case AMDGPU::S_NOR_B32:
940     Result = ~(LHS | RHS);
941     return true;
942   case AMDGPU::S_ANDN2_B32:
943     Result = LHS & ~RHS;
944     return true;
945   case AMDGPU::S_ORN2_B32:
946     Result = LHS | ~RHS;
947     return true;
948   case AMDGPU::V_LSHL_B32_e64:
949   case AMDGPU::V_LSHL_B32_e32:
950   case AMDGPU::S_LSHL_B32:
951     // The instruction ignores the high bits for out of bounds shifts.
952     Result = LHS << (RHS & 31);
953     return true;
954   case AMDGPU::V_LSHLREV_B32_e64:
955   case AMDGPU::V_LSHLREV_B32_e32:
956     Result = RHS << (LHS & 31);
957     return true;
958   case AMDGPU::V_LSHR_B32_e64:
959   case AMDGPU::V_LSHR_B32_e32:
960   case AMDGPU::S_LSHR_B32:
961     Result = LHS >> (RHS & 31);
962     return true;
963   case AMDGPU::V_LSHRREV_B32_e64:
964   case AMDGPU::V_LSHRREV_B32_e32:
965     Result = RHS >> (LHS & 31);
966     return true;
967   case AMDGPU::V_ASHR_I32_e64:
968   case AMDGPU::V_ASHR_I32_e32:
969   case AMDGPU::S_ASHR_I32:
970     Result = static_cast<int32_t>(LHS) >> (RHS & 31);
971     return true;
972   case AMDGPU::V_ASHRREV_I32_e64:
973   case AMDGPU::V_ASHRREV_I32_e32:
974     Result = static_cast<int32_t>(RHS) >> (LHS & 31);
975     return true;
976   default:
977     return false;
978   }
979 }
980 
981 static unsigned getMovOpc(bool IsScalar) {
982   return IsScalar ? AMDGPU::S_MOV_B32 : AMDGPU::V_MOV_B32_e32;
983 }
984 
985 /// Remove any leftover implicit operands from mutating the instruction. e.g.
986 /// if we replace an s_and_b32 with a copy, we don't need the implicit scc def
987 /// anymore.
988 static void stripExtraCopyOperands(MachineInstr &MI) {
989   const MCInstrDesc &Desc = MI.getDesc();
990   unsigned NumOps = Desc.getNumOperands() +
991                     Desc.getNumImplicitUses() +
992                     Desc.getNumImplicitDefs();
993 
994   for (unsigned I = MI.getNumOperands() - 1; I >= NumOps; --I)
995     MI.RemoveOperand(I);
996 }
997 
998 static void mutateCopyOp(MachineInstr &MI, const MCInstrDesc &NewDesc) {
999   MI.setDesc(NewDesc);
1000   stripExtraCopyOperands(MI);
1001 }
1002 
1003 static MachineOperand *getImmOrMaterializedImm(MachineRegisterInfo &MRI,
1004                                                MachineOperand &Op) {
1005   if (Op.isReg()) {
1006     // If this has a subregister, it obviously is a register source.
1007     if (Op.getSubReg() != AMDGPU::NoSubRegister ||
1008         !Register::isVirtualRegister(Op.getReg()))
1009       return &Op;
1010 
1011     MachineInstr *Def = MRI.getVRegDef(Op.getReg());
1012     if (Def && Def->isMoveImmediate()) {
1013       MachineOperand &ImmSrc = Def->getOperand(1);
1014       if (ImmSrc.isImm())
1015         return &ImmSrc;
1016     }
1017   }
1018 
1019   return &Op;
1020 }
1021 
1022 // Try to simplify operations with a constant that may appear after instruction
1023 // selection.
1024 // TODO: See if a frame index with a fixed offset can fold.
1025 static bool tryConstantFoldOp(MachineRegisterInfo &MRI,
1026                               const SIInstrInfo *TII,
1027                               MachineInstr *MI,
1028                               MachineOperand *ImmOp) {
1029   unsigned Opc = MI->getOpcode();
1030   if (Opc == AMDGPU::V_NOT_B32_e64 || Opc == AMDGPU::V_NOT_B32_e32 ||
1031       Opc == AMDGPU::S_NOT_B32) {
1032     MI->getOperand(1).ChangeToImmediate(~ImmOp->getImm());
1033     mutateCopyOp(*MI, TII->get(getMovOpc(Opc == AMDGPU::S_NOT_B32)));
1034     return true;
1035   }
1036 
1037   int Src1Idx = AMDGPU::getNamedOperandIdx(Opc, AMDGPU::OpName::src1);
1038   if (Src1Idx == -1)
1039     return false;
1040 
1041   int Src0Idx = AMDGPU::getNamedOperandIdx(Opc, AMDGPU::OpName::src0);
1042   MachineOperand *Src0 = getImmOrMaterializedImm(MRI, MI->getOperand(Src0Idx));
1043   MachineOperand *Src1 = getImmOrMaterializedImm(MRI, MI->getOperand(Src1Idx));
1044 
1045   if (!Src0->isImm() && !Src1->isImm())
1046     return false;
1047 
1048   if (MI->getOpcode() == AMDGPU::V_LSHL_OR_B32 ||
1049       MI->getOpcode() == AMDGPU::V_LSHL_ADD_U32 ||
1050       MI->getOpcode() == AMDGPU::V_AND_OR_B32) {
1051     if (Src0->isImm() && Src0->getImm() == 0) {
1052       // v_lshl_or_b32 0, X, Y -> copy Y
1053       // v_lshl_or_b32 0, X, K -> v_mov_b32 K
1054       // v_lshl_add_b32 0, X, Y -> copy Y
1055       // v_lshl_add_b32 0, X, K -> v_mov_b32 K
1056       // v_and_or_b32 0, X, Y -> copy Y
1057       // v_and_or_b32 0, X, K -> v_mov_b32 K
1058       bool UseCopy = TII->getNamedOperand(*MI, AMDGPU::OpName::src2)->isReg();
1059       MI->RemoveOperand(Src1Idx);
1060       MI->RemoveOperand(Src0Idx);
1061 
1062       MI->setDesc(TII->get(UseCopy ? AMDGPU::COPY : AMDGPU::V_MOV_B32_e32));
1063       return true;
1064     }
1065   }
1066 
1067   // and k0, k1 -> v_mov_b32 (k0 & k1)
1068   // or k0, k1 -> v_mov_b32 (k0 | k1)
1069   // xor k0, k1 -> v_mov_b32 (k0 ^ k1)
1070   if (Src0->isImm() && Src1->isImm()) {
1071     int32_t NewImm;
1072     if (!evalBinaryInstruction(Opc, NewImm, Src0->getImm(), Src1->getImm()))
1073       return false;
1074 
1075     const SIRegisterInfo &TRI = TII->getRegisterInfo();
1076     bool IsSGPR = TRI.isSGPRReg(MRI, MI->getOperand(0).getReg());
1077 
1078     // Be careful to change the right operand, src0 may belong to a different
1079     // instruction.
1080     MI->getOperand(Src0Idx).ChangeToImmediate(NewImm);
1081     MI->RemoveOperand(Src1Idx);
1082     mutateCopyOp(*MI, TII->get(getMovOpc(IsSGPR)));
1083     return true;
1084   }
1085 
1086   if (!MI->isCommutable())
1087     return false;
1088 
1089   if (Src0->isImm() && !Src1->isImm()) {
1090     std::swap(Src0, Src1);
1091     std::swap(Src0Idx, Src1Idx);
1092   }
1093 
1094   int32_t Src1Val = static_cast<int32_t>(Src1->getImm());
1095   if (Opc == AMDGPU::V_OR_B32_e64 ||
1096       Opc == AMDGPU::V_OR_B32_e32 ||
1097       Opc == AMDGPU::S_OR_B32) {
1098     if (Src1Val == 0) {
1099       // y = or x, 0 => y = copy x
1100       MI->RemoveOperand(Src1Idx);
1101       mutateCopyOp(*MI, TII->get(AMDGPU::COPY));
1102     } else if (Src1Val == -1) {
1103       // y = or x, -1 => y = v_mov_b32 -1
1104       MI->RemoveOperand(Src1Idx);
1105       mutateCopyOp(*MI, TII->get(getMovOpc(Opc == AMDGPU::S_OR_B32)));
1106     } else
1107       return false;
1108 
1109     return true;
1110   }
1111 
1112   if (MI->getOpcode() == AMDGPU::V_AND_B32_e64 ||
1113       MI->getOpcode() == AMDGPU::V_AND_B32_e32 ||
1114       MI->getOpcode() == AMDGPU::S_AND_B32) {
1115     if (Src1Val == 0) {
1116       // y = and x, 0 => y = v_mov_b32 0
1117       MI->RemoveOperand(Src0Idx);
1118       mutateCopyOp(*MI, TII->get(getMovOpc(Opc == AMDGPU::S_AND_B32)));
1119     } else if (Src1Val == -1) {
1120       // y = and x, -1 => y = copy x
1121       MI->RemoveOperand(Src1Idx);
1122       mutateCopyOp(*MI, TII->get(AMDGPU::COPY));
1123       stripExtraCopyOperands(*MI);
1124     } else
1125       return false;
1126 
1127     return true;
1128   }
1129 
1130   if (MI->getOpcode() == AMDGPU::V_XOR_B32_e64 ||
1131       MI->getOpcode() == AMDGPU::V_XOR_B32_e32 ||
1132       MI->getOpcode() == AMDGPU::S_XOR_B32) {
1133     if (Src1Val == 0) {
1134       // y = xor x, 0 => y = copy x
1135       MI->RemoveOperand(Src1Idx);
1136       mutateCopyOp(*MI, TII->get(AMDGPU::COPY));
1137       return true;
1138     }
1139   }
1140 
1141   return false;
1142 }
1143 
1144 // Try to fold an instruction into a simpler one
1145 static bool tryFoldInst(const SIInstrInfo *TII,
1146                         MachineInstr *MI) {
1147   unsigned Opc = MI->getOpcode();
1148 
1149   if (Opc == AMDGPU::V_CNDMASK_B32_e32    ||
1150       Opc == AMDGPU::V_CNDMASK_B32_e64    ||
1151       Opc == AMDGPU::V_CNDMASK_B64_PSEUDO) {
1152     const MachineOperand *Src0 = TII->getNamedOperand(*MI, AMDGPU::OpName::src0);
1153     const MachineOperand *Src1 = TII->getNamedOperand(*MI, AMDGPU::OpName::src1);
1154     int Src1ModIdx = AMDGPU::getNamedOperandIdx(Opc, AMDGPU::OpName::src1_modifiers);
1155     int Src0ModIdx = AMDGPU::getNamedOperandIdx(Opc, AMDGPU::OpName::src0_modifiers);
1156     if (Src1->isIdenticalTo(*Src0) &&
1157         (Src1ModIdx == -1 || !MI->getOperand(Src1ModIdx).getImm()) &&
1158         (Src0ModIdx == -1 || !MI->getOperand(Src0ModIdx).getImm())) {
1159       LLVM_DEBUG(dbgs() << "Folded " << *MI << " into ");
1160       auto &NewDesc =
1161           TII->get(Src0->isReg() ? (unsigned)AMDGPU::COPY : getMovOpc(false));
1162       int Src2Idx = AMDGPU::getNamedOperandIdx(Opc, AMDGPU::OpName::src2);
1163       if (Src2Idx != -1)
1164         MI->RemoveOperand(Src2Idx);
1165       MI->RemoveOperand(AMDGPU::getNamedOperandIdx(Opc, AMDGPU::OpName::src1));
1166       if (Src1ModIdx != -1)
1167         MI->RemoveOperand(Src1ModIdx);
1168       if (Src0ModIdx != -1)
1169         MI->RemoveOperand(Src0ModIdx);
1170       mutateCopyOp(*MI, NewDesc);
1171       LLVM_DEBUG(dbgs() << *MI << '\n');
1172       return true;
1173     }
1174   }
1175 
1176   return false;
1177 }
1178 
1179 void SIFoldOperands::foldInstOperand(MachineInstr &MI,
1180                                      MachineOperand &OpToFold) const {
1181   // We need mutate the operands of new mov instructions to add implicit
1182   // uses of EXEC, but adding them invalidates the use_iterator, so defer
1183   // this.
1184   SmallVector<MachineInstr *, 4> CopiesToReplace;
1185   SmallVector<FoldCandidate, 4> FoldList;
1186   MachineOperand &Dst = MI.getOperand(0);
1187 
1188   bool FoldingImm = OpToFold.isImm() || OpToFold.isFI() || OpToFold.isGlobal();
1189   if (FoldingImm) {
1190     unsigned NumLiteralUses = 0;
1191     MachineOperand *NonInlineUse = nullptr;
1192     int NonInlineUseOpNo = -1;
1193 
1194     MachineRegisterInfo::use_iterator NextUse;
1195     for (MachineRegisterInfo::use_iterator
1196            Use = MRI->use_begin(Dst.getReg()), E = MRI->use_end();
1197          Use != E; Use = NextUse) {
1198       NextUse = std::next(Use);
1199       MachineInstr *UseMI = Use->getParent();
1200       unsigned OpNo = Use.getOperandNo();
1201 
1202       // Folding the immediate may reveal operations that can be constant
1203       // folded or replaced with a copy. This can happen for example after
1204       // frame indices are lowered to constants or from splitting 64-bit
1205       // constants.
1206       //
1207       // We may also encounter cases where one or both operands are
1208       // immediates materialized into a register, which would ordinarily not
1209       // be folded due to multiple uses or operand constraints.
1210 
1211       if (OpToFold.isImm() && tryConstantFoldOp(*MRI, TII, UseMI, &OpToFold)) {
1212         LLVM_DEBUG(dbgs() << "Constant folded " << *UseMI << '\n');
1213 
1214         // Some constant folding cases change the same immediate's use to a new
1215         // instruction, e.g. and x, 0 -> 0. Make sure we re-visit the user
1216         // again. The same constant folded instruction could also have a second
1217         // use operand.
1218         NextUse = MRI->use_begin(Dst.getReg());
1219         FoldList.clear();
1220         continue;
1221       }
1222 
1223       // Try to fold any inline immediate uses, and then only fold other
1224       // constants if they have one use.
1225       //
1226       // The legality of the inline immediate must be checked based on the use
1227       // operand, not the defining instruction, because 32-bit instructions
1228       // with 32-bit inline immediate sources may be used to materialize
1229       // constants used in 16-bit operands.
1230       //
1231       // e.g. it is unsafe to fold:
1232       //  s_mov_b32 s0, 1.0    // materializes 0x3f800000
1233       //  v_add_f16 v0, v1, s0 // 1.0 f16 inline immediate sees 0x00003c00
1234 
1235       // Folding immediates with more than one use will increase program size.
1236       // FIXME: This will also reduce register usage, which may be better
1237       // in some cases. A better heuristic is needed.
1238       if (isInlineConstantIfFolded(TII, *UseMI, OpNo, OpToFold)) {
1239         foldOperand(OpToFold, UseMI, OpNo, FoldList, CopiesToReplace);
1240       } else if (frameIndexMayFold(TII, *UseMI, OpNo, OpToFold)) {
1241         foldOperand(OpToFold, UseMI, OpNo, FoldList,
1242                     CopiesToReplace);
1243       } else {
1244         if (++NumLiteralUses == 1) {
1245           NonInlineUse = &*Use;
1246           NonInlineUseOpNo = OpNo;
1247         }
1248       }
1249     }
1250 
1251     if (NumLiteralUses == 1) {
1252       MachineInstr *UseMI = NonInlineUse->getParent();
1253       foldOperand(OpToFold, UseMI, NonInlineUseOpNo, FoldList, CopiesToReplace);
1254     }
1255   } else {
1256     // Folding register.
1257     SmallVector <MachineRegisterInfo::use_iterator, 4> UsesToProcess;
1258     for (MachineRegisterInfo::use_iterator
1259            Use = MRI->use_begin(Dst.getReg()), E = MRI->use_end();
1260          Use != E; ++Use) {
1261       UsesToProcess.push_back(Use);
1262     }
1263     for (auto U : UsesToProcess) {
1264       MachineInstr *UseMI = U->getParent();
1265 
1266       foldOperand(OpToFold, UseMI, U.getOperandNo(),
1267         FoldList, CopiesToReplace);
1268     }
1269   }
1270 
1271   MachineFunction *MF = MI.getParent()->getParent();
1272   // Make sure we add EXEC uses to any new v_mov instructions created.
1273   for (MachineInstr *Copy : CopiesToReplace)
1274     Copy->addImplicitDefUseOperands(*MF);
1275 
1276   for (FoldCandidate &Fold : FoldList) {
1277     assert(!Fold.isReg() || Fold.OpToFold);
1278     if (Fold.isReg() && Register::isVirtualRegister(Fold.OpToFold->getReg())) {
1279       Register Reg = Fold.OpToFold->getReg();
1280       MachineInstr *DefMI = Fold.OpToFold->getParent();
1281       if (DefMI->readsRegister(AMDGPU::EXEC, TRI) &&
1282           execMayBeModifiedBeforeUse(*MRI, Reg, *DefMI, *Fold.UseMI))
1283         continue;
1284     }
1285     if (updateOperand(Fold, *TII, *TRI, *ST)) {
1286       // Clear kill flags.
1287       if (Fold.isReg()) {
1288         assert(Fold.OpToFold && Fold.OpToFold->isReg());
1289         // FIXME: Probably shouldn't bother trying to fold if not an
1290         // SGPR. PeepholeOptimizer can eliminate redundant VGPR->VGPR
1291         // copies.
1292         MRI->clearKillFlags(Fold.OpToFold->getReg());
1293       }
1294       LLVM_DEBUG(dbgs() << "Folded source from " << MI << " into OpNo "
1295                         << static_cast<int>(Fold.UseOpNo) << " of "
1296                         << *Fold.UseMI << '\n');
1297       tryFoldInst(TII, Fold.UseMI);
1298     } else if (Fold.isCommuted()) {
1299       // Restoring instruction's original operand order if fold has failed.
1300       TII->commuteInstruction(*Fold.UseMI, false);
1301     }
1302   }
1303 }
1304 
1305 // Clamp patterns are canonically selected to v_max_* instructions, so only
1306 // handle them.
1307 const MachineOperand *SIFoldOperands::isClamp(const MachineInstr &MI) const {
1308   unsigned Op = MI.getOpcode();
1309   switch (Op) {
1310   case AMDGPU::V_MAX_F32_e64:
1311   case AMDGPU::V_MAX_F16_e64:
1312   case AMDGPU::V_MAX_F64:
1313   case AMDGPU::V_PK_MAX_F16: {
1314     if (!TII->getNamedOperand(MI, AMDGPU::OpName::clamp)->getImm())
1315       return nullptr;
1316 
1317     // Make sure sources are identical.
1318     const MachineOperand *Src0 = TII->getNamedOperand(MI, AMDGPU::OpName::src0);
1319     const MachineOperand *Src1 = TII->getNamedOperand(MI, AMDGPU::OpName::src1);
1320     if (!Src0->isReg() || !Src1->isReg() ||
1321         Src0->getReg() != Src1->getReg() ||
1322         Src0->getSubReg() != Src1->getSubReg() ||
1323         Src0->getSubReg() != AMDGPU::NoSubRegister)
1324       return nullptr;
1325 
1326     // Can't fold up if we have modifiers.
1327     if (TII->hasModifiersSet(MI, AMDGPU::OpName::omod))
1328       return nullptr;
1329 
1330     unsigned Src0Mods
1331       = TII->getNamedOperand(MI, AMDGPU::OpName::src0_modifiers)->getImm();
1332     unsigned Src1Mods
1333       = TII->getNamedOperand(MI, AMDGPU::OpName::src1_modifiers)->getImm();
1334 
1335     // Having a 0 op_sel_hi would require swizzling the output in the source
1336     // instruction, which we can't do.
1337     unsigned UnsetMods = (Op == AMDGPU::V_PK_MAX_F16) ? SISrcMods::OP_SEL_1
1338                                                       : 0u;
1339     if (Src0Mods != UnsetMods && Src1Mods != UnsetMods)
1340       return nullptr;
1341     return Src0;
1342   }
1343   default:
1344     return nullptr;
1345   }
1346 }
1347 
1348 // We obviously have multiple uses in a clamp since the register is used twice
1349 // in the same instruction.
1350 static bool hasOneNonDBGUseInst(const MachineRegisterInfo &MRI, unsigned Reg) {
1351   int Count = 0;
1352   for (auto I = MRI.use_instr_nodbg_begin(Reg), E = MRI.use_instr_nodbg_end();
1353        I != E; ++I) {
1354     if (++Count > 1)
1355       return false;
1356   }
1357 
1358   return true;
1359 }
1360 
1361 // FIXME: Clamp for v_mad_mixhi_f16 handled during isel.
1362 bool SIFoldOperands::tryFoldClamp(MachineInstr &MI) {
1363   const MachineOperand *ClampSrc = isClamp(MI);
1364   if (!ClampSrc || !hasOneNonDBGUseInst(*MRI, ClampSrc->getReg()))
1365     return false;
1366 
1367   MachineInstr *Def = MRI->getVRegDef(ClampSrc->getReg());
1368 
1369   // The type of clamp must be compatible.
1370   if (TII->getClampMask(*Def) != TII->getClampMask(MI))
1371     return false;
1372 
1373   MachineOperand *DefClamp = TII->getNamedOperand(*Def, AMDGPU::OpName::clamp);
1374   if (!DefClamp)
1375     return false;
1376 
1377   LLVM_DEBUG(dbgs() << "Folding clamp " << *DefClamp << " into " << *Def
1378                     << '\n');
1379 
1380   // Clamp is applied after omod, so it is OK if omod is set.
1381   DefClamp->setImm(1);
1382   MRI->replaceRegWith(MI.getOperand(0).getReg(), Def->getOperand(0).getReg());
1383   MI.eraseFromParent();
1384   return true;
1385 }
1386 
1387 static int getOModValue(unsigned Opc, int64_t Val) {
1388   switch (Opc) {
1389   case AMDGPU::V_MUL_F32_e64: {
1390     switch (static_cast<uint32_t>(Val)) {
1391     case 0x3f000000: // 0.5
1392       return SIOutMods::DIV2;
1393     case 0x40000000: // 2.0
1394       return SIOutMods::MUL2;
1395     case 0x40800000: // 4.0
1396       return SIOutMods::MUL4;
1397     default:
1398       return SIOutMods::NONE;
1399     }
1400   }
1401   case AMDGPU::V_MUL_F16_e64: {
1402     switch (static_cast<uint16_t>(Val)) {
1403     case 0x3800: // 0.5
1404       return SIOutMods::DIV2;
1405     case 0x4000: // 2.0
1406       return SIOutMods::MUL2;
1407     case 0x4400: // 4.0
1408       return SIOutMods::MUL4;
1409     default:
1410       return SIOutMods::NONE;
1411     }
1412   }
1413   default:
1414     llvm_unreachable("invalid mul opcode");
1415   }
1416 }
1417 
1418 // FIXME: Does this really not support denormals with f16?
1419 // FIXME: Does this need to check IEEE mode bit? SNaNs are generally not
1420 // handled, so will anything other than that break?
1421 std::pair<const MachineOperand *, int>
1422 SIFoldOperands::isOMod(const MachineInstr &MI) const {
1423   unsigned Op = MI.getOpcode();
1424   switch (Op) {
1425   case AMDGPU::V_MUL_F32_e64:
1426   case AMDGPU::V_MUL_F16_e64: {
1427     // If output denormals are enabled, omod is ignored.
1428     if ((Op == AMDGPU::V_MUL_F32_e64 && MFI->getMode().FP32OutputDenormals) ||
1429         (Op == AMDGPU::V_MUL_F16_e64 && MFI->getMode().FP64FP16OutputDenormals))
1430       return std::make_pair(nullptr, SIOutMods::NONE);
1431 
1432     const MachineOperand *RegOp = nullptr;
1433     const MachineOperand *ImmOp = nullptr;
1434     const MachineOperand *Src0 = TII->getNamedOperand(MI, AMDGPU::OpName::src0);
1435     const MachineOperand *Src1 = TII->getNamedOperand(MI, AMDGPU::OpName::src1);
1436     if (Src0->isImm()) {
1437       ImmOp = Src0;
1438       RegOp = Src1;
1439     } else if (Src1->isImm()) {
1440       ImmOp = Src1;
1441       RegOp = Src0;
1442     } else
1443       return std::make_pair(nullptr, SIOutMods::NONE);
1444 
1445     int OMod = getOModValue(Op, ImmOp->getImm());
1446     if (OMod == SIOutMods::NONE ||
1447         TII->hasModifiersSet(MI, AMDGPU::OpName::src0_modifiers) ||
1448         TII->hasModifiersSet(MI, AMDGPU::OpName::src1_modifiers) ||
1449         TII->hasModifiersSet(MI, AMDGPU::OpName::omod) ||
1450         TII->hasModifiersSet(MI, AMDGPU::OpName::clamp))
1451       return std::make_pair(nullptr, SIOutMods::NONE);
1452 
1453     return std::make_pair(RegOp, OMod);
1454   }
1455   case AMDGPU::V_ADD_F32_e64:
1456   case AMDGPU::V_ADD_F16_e64: {
1457     // If output denormals are enabled, omod is ignored.
1458     if ((Op == AMDGPU::V_ADD_F32_e64 && MFI->getMode().FP32OutputDenormals) ||
1459         (Op == AMDGPU::V_ADD_F16_e64 && MFI->getMode().FP64FP16OutputDenormals))
1460       return std::make_pair(nullptr, SIOutMods::NONE);
1461 
1462     // Look through the DAGCombiner canonicalization fmul x, 2 -> fadd x, x
1463     const MachineOperand *Src0 = TII->getNamedOperand(MI, AMDGPU::OpName::src0);
1464     const MachineOperand *Src1 = TII->getNamedOperand(MI, AMDGPU::OpName::src1);
1465 
1466     if (Src0->isReg() && Src1->isReg() && Src0->getReg() == Src1->getReg() &&
1467         Src0->getSubReg() == Src1->getSubReg() &&
1468         !TII->hasModifiersSet(MI, AMDGPU::OpName::src0_modifiers) &&
1469         !TII->hasModifiersSet(MI, AMDGPU::OpName::src1_modifiers) &&
1470         !TII->hasModifiersSet(MI, AMDGPU::OpName::clamp) &&
1471         !TII->hasModifiersSet(MI, AMDGPU::OpName::omod))
1472       return std::make_pair(Src0, SIOutMods::MUL2);
1473 
1474     return std::make_pair(nullptr, SIOutMods::NONE);
1475   }
1476   default:
1477     return std::make_pair(nullptr, SIOutMods::NONE);
1478   }
1479 }
1480 
1481 // FIXME: Does this need to check IEEE bit on function?
1482 bool SIFoldOperands::tryFoldOMod(MachineInstr &MI) {
1483   const MachineOperand *RegOp;
1484   int OMod;
1485   std::tie(RegOp, OMod) = isOMod(MI);
1486   if (OMod == SIOutMods::NONE || !RegOp->isReg() ||
1487       RegOp->getSubReg() != AMDGPU::NoSubRegister ||
1488       !hasOneNonDBGUseInst(*MRI, RegOp->getReg()))
1489     return false;
1490 
1491   MachineInstr *Def = MRI->getVRegDef(RegOp->getReg());
1492   MachineOperand *DefOMod = TII->getNamedOperand(*Def, AMDGPU::OpName::omod);
1493   if (!DefOMod || DefOMod->getImm() != SIOutMods::NONE)
1494     return false;
1495 
1496   // Clamp is applied after omod. If the source already has clamp set, don't
1497   // fold it.
1498   if (TII->hasModifiersSet(*Def, AMDGPU::OpName::clamp))
1499     return false;
1500 
1501   LLVM_DEBUG(dbgs() << "Folding omod " << MI << " into " << *Def << '\n');
1502 
1503   DefOMod->setImm(OMod);
1504   MRI->replaceRegWith(MI.getOperand(0).getReg(), Def->getOperand(0).getReg());
1505   MI.eraseFromParent();
1506   return true;
1507 }
1508 
1509 bool SIFoldOperands::runOnMachineFunction(MachineFunction &MF) {
1510   if (skipFunction(MF.getFunction()))
1511     return false;
1512 
1513   MRI = &MF.getRegInfo();
1514   ST = &MF.getSubtarget<GCNSubtarget>();
1515   TII = ST->getInstrInfo();
1516   TRI = &TII->getRegisterInfo();
1517   MFI = MF.getInfo<SIMachineFunctionInfo>();
1518 
1519   // omod is ignored by hardware if IEEE bit is enabled. omod also does not
1520   // correctly handle signed zeros.
1521   //
1522   // FIXME: Also need to check strictfp
1523   bool IsIEEEMode = MFI->getMode().IEEE;
1524   bool HasNSZ = MFI->hasNoSignedZerosFPMath();
1525 
1526   for (MachineBasicBlock *MBB : depth_first(&MF)) {
1527     MachineBasicBlock::iterator I, Next;
1528 
1529     MachineOperand *CurrentKnownM0Val = nullptr;
1530     for (I = MBB->begin(); I != MBB->end(); I = Next) {
1531       Next = std::next(I);
1532       MachineInstr &MI = *I;
1533 
1534       tryFoldInst(TII, &MI);
1535 
1536       if (!TII->isFoldableCopy(MI)) {
1537         // Saw an unknown clobber of m0, so we no longer know what it is.
1538         if (CurrentKnownM0Val && MI.modifiesRegister(AMDGPU::M0, TRI))
1539           CurrentKnownM0Val = nullptr;
1540 
1541         // TODO: Omod might be OK if there is NSZ only on the source
1542         // instruction, and not the omod multiply.
1543         if (IsIEEEMode || (!HasNSZ && !MI.getFlag(MachineInstr::FmNsz)) ||
1544             !tryFoldOMod(MI))
1545           tryFoldClamp(MI);
1546 
1547         continue;
1548       }
1549 
1550       // Specially track simple redefs of m0 to the same value in a block, so we
1551       // can erase the later ones.
1552       if (MI.getOperand(0).getReg() == AMDGPU::M0) {
1553         MachineOperand &NewM0Val = MI.getOperand(1);
1554         if (CurrentKnownM0Val && CurrentKnownM0Val->isIdenticalTo(NewM0Val)) {
1555           MI.eraseFromParent();
1556           continue;
1557         }
1558 
1559         // We aren't tracking other physical registers
1560         CurrentKnownM0Val = (NewM0Val.isReg() && NewM0Val.getReg().isPhysical()) ?
1561           nullptr : &NewM0Val;
1562         continue;
1563       }
1564 
1565       MachineOperand &OpToFold = MI.getOperand(1);
1566       bool FoldingImm =
1567           OpToFold.isImm() || OpToFold.isFI() || OpToFold.isGlobal();
1568 
1569       // FIXME: We could also be folding things like TargetIndexes.
1570       if (!FoldingImm && !OpToFold.isReg())
1571         continue;
1572 
1573       if (OpToFold.isReg() && !Register::isVirtualRegister(OpToFold.getReg()))
1574         continue;
1575 
1576       // Prevent folding operands backwards in the function. For example,
1577       // the COPY opcode must not be replaced by 1 in this example:
1578       //
1579       //    %3 = COPY %vgpr0; VGPR_32:%3
1580       //    ...
1581       //    %vgpr0 = V_MOV_B32_e32 1, implicit %exec
1582       MachineOperand &Dst = MI.getOperand(0);
1583       if (Dst.isReg() && !Register::isVirtualRegister(Dst.getReg()))
1584         continue;
1585 
1586       foldInstOperand(MI, OpToFold);
1587     }
1588   }
1589   return true;
1590 }
1591