TailDuplicator.cpp revision 304240
1//===-- TailDuplicator.cpp - Duplicate blocks into predecessors' tails ---===//
2//
3//                     The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// This utility class duplicates basic blocks ending in unconditional branches
11// into the tails of their predecessors.
12//
13//===----------------------------------------------------------------------===//
14
15#include "llvm/CodeGen/TailDuplicator.h"
16#include "llvm/ADT/DenseSet.h"
17#include "llvm/ADT/SetVector.h"
18#include "llvm/ADT/SmallSet.h"
19#include "llvm/ADT/Statistic.h"
20#include "llvm/CodeGen/MachineBranchProbabilityInfo.h"
21#include "llvm/CodeGen/MachineFunctionPass.h"
22#include "llvm/CodeGen/MachineInstrBuilder.h"
23#include "llvm/CodeGen/MachineModuleInfo.h"
24#include "llvm/CodeGen/Passes.h"
25#include "llvm/IR/Function.h"
26#include "llvm/Support/CommandLine.h"
27#include "llvm/Support/Debug.h"
28#include "llvm/Support/ErrorHandling.h"
29#include "llvm/Support/raw_ostream.h"
30using namespace llvm;
31
32#define DEBUG_TYPE "tailduplication"
33
34STATISTIC(NumTails, "Number of tails duplicated");
35STATISTIC(NumTailDups, "Number of tail duplicated blocks");
36STATISTIC(NumTailDupAdded,
37          "Number of instructions added due to tail duplication");
38STATISTIC(NumTailDupRemoved,
39          "Number of instructions removed due to tail duplication");
40STATISTIC(NumDeadBlocks, "Number of dead blocks removed");
41STATISTIC(NumAddedPHIs, "Number of phis added");
42
43// Heuristic for tail duplication.
44static cl::opt<unsigned> TailDuplicateSize(
45    "tail-dup-size",
46    cl::desc("Maximum instructions to consider tail duplicating"), cl::init(2),
47    cl::Hidden);
48
49static cl::opt<bool>
50    TailDupVerify("tail-dup-verify",
51                  cl::desc("Verify sanity of PHI instructions during taildup"),
52                  cl::init(false), cl::Hidden);
53
54static cl::opt<unsigned> TailDupLimit("tail-dup-limit", cl::init(~0U),
55                                      cl::Hidden);
56
57namespace llvm {
58
59void TailDuplicator::initMF(MachineFunction &MF, const MachineModuleInfo *MMIin,
60                            const MachineBranchProbabilityInfo *MBPIin) {
61  TII = MF.getSubtarget().getInstrInfo();
62  TRI = MF.getSubtarget().getRegisterInfo();
63  MRI = &MF.getRegInfo();
64  MMI = MMIin;
65  MBPI = MBPIin;
66
67  assert(MBPI != nullptr && "Machine Branch Probability Info required");
68
69  PreRegAlloc = MRI->isSSA();
70}
71
72static void VerifyPHIs(MachineFunction &MF, bool CheckExtra) {
73  for (MachineFunction::iterator I = ++MF.begin(), E = MF.end(); I != E; ++I) {
74    MachineBasicBlock *MBB = &*I;
75    SmallSetVector<MachineBasicBlock *, 8> Preds(MBB->pred_begin(),
76                                                 MBB->pred_end());
77    MachineBasicBlock::iterator MI = MBB->begin();
78    while (MI != MBB->end()) {
79      if (!MI->isPHI())
80        break;
81      for (SmallSetVector<MachineBasicBlock *, 8>::iterator PI = Preds.begin(),
82                                                            PE = Preds.end();
83           PI != PE; ++PI) {
84        MachineBasicBlock *PredBB = *PI;
85        bool Found = false;
86        for (unsigned i = 1, e = MI->getNumOperands(); i != e; i += 2) {
87          MachineBasicBlock *PHIBB = MI->getOperand(i + 1).getMBB();
88          if (PHIBB == PredBB) {
89            Found = true;
90            break;
91          }
92        }
93        if (!Found) {
94          dbgs() << "Malformed PHI in BB#" << MBB->getNumber() << ": " << *MI;
95          dbgs() << "  missing input from predecessor BB#"
96                 << PredBB->getNumber() << '\n';
97          llvm_unreachable(nullptr);
98        }
99      }
100
101      for (unsigned i = 1, e = MI->getNumOperands(); i != e; i += 2) {
102        MachineBasicBlock *PHIBB = MI->getOperand(i + 1).getMBB();
103        if (CheckExtra && !Preds.count(PHIBB)) {
104          dbgs() << "Warning: malformed PHI in BB#" << MBB->getNumber() << ": "
105                 << *MI;
106          dbgs() << "  extra input from predecessor BB#" << PHIBB->getNumber()
107                 << '\n';
108          llvm_unreachable(nullptr);
109        }
110        if (PHIBB->getNumber() < 0) {
111          dbgs() << "Malformed PHI in BB#" << MBB->getNumber() << ": " << *MI;
112          dbgs() << "  non-existing BB#" << PHIBB->getNumber() << '\n';
113          llvm_unreachable(nullptr);
114        }
115      }
116      ++MI;
117    }
118  }
119}
120
121/// Tail duplicate the block and cleanup.
122bool TailDuplicator::tailDuplicateAndUpdate(MachineFunction &MF, bool IsSimple,
123                                            MachineBasicBlock *MBB) {
124  // Save the successors list.
125  SmallSetVector<MachineBasicBlock *, 8> Succs(MBB->succ_begin(),
126                                               MBB->succ_end());
127
128  SmallVector<MachineBasicBlock *, 8> TDBBs;
129  SmallVector<MachineInstr *, 16> Copies;
130  if (!tailDuplicate(MF, IsSimple, MBB, TDBBs, Copies))
131    return false;
132
133  ++NumTails;
134
135  SmallVector<MachineInstr *, 8> NewPHIs;
136  MachineSSAUpdater SSAUpdate(MF, &NewPHIs);
137
138  // TailBB's immediate successors are now successors of those predecessors
139  // which duplicated TailBB. Add the predecessors as sources to the PHI
140  // instructions.
141  bool isDead = MBB->pred_empty() && !MBB->hasAddressTaken();
142  if (PreRegAlloc)
143    updateSuccessorsPHIs(MBB, isDead, TDBBs, Succs);
144
145  // If it is dead, remove it.
146  if (isDead) {
147    NumTailDupRemoved += MBB->size();
148    removeDeadBlock(MBB);
149    ++NumDeadBlocks;
150  }
151
152  // Update SSA form.
153  if (!SSAUpdateVRs.empty()) {
154    for (unsigned i = 0, e = SSAUpdateVRs.size(); i != e; ++i) {
155      unsigned VReg = SSAUpdateVRs[i];
156      SSAUpdate.Initialize(VReg);
157
158      // If the original definition is still around, add it as an available
159      // value.
160      MachineInstr *DefMI = MRI->getVRegDef(VReg);
161      MachineBasicBlock *DefBB = nullptr;
162      if (DefMI) {
163        DefBB = DefMI->getParent();
164        SSAUpdate.AddAvailableValue(DefBB, VReg);
165      }
166
167      // Add the new vregs as available values.
168      DenseMap<unsigned, AvailableValsTy>::iterator LI =
169          SSAUpdateVals.find(VReg);
170      for (unsigned j = 0, ee = LI->second.size(); j != ee; ++j) {
171        MachineBasicBlock *SrcBB = LI->second[j].first;
172        unsigned SrcReg = LI->second[j].second;
173        SSAUpdate.AddAvailableValue(SrcBB, SrcReg);
174      }
175
176      // Rewrite uses that are outside of the original def's block.
177      MachineRegisterInfo::use_iterator UI = MRI->use_begin(VReg);
178      while (UI != MRI->use_end()) {
179        MachineOperand &UseMO = *UI;
180        MachineInstr *UseMI = UseMO.getParent();
181        ++UI;
182        if (UseMI->isDebugValue()) {
183          // SSAUpdate can replace the use with an undef. That creates
184          // a debug instruction that is a kill.
185          // FIXME: Should it SSAUpdate job to delete debug instructions
186          // instead of replacing the use with undef?
187          UseMI->eraseFromParent();
188          continue;
189        }
190        if (UseMI->getParent() == DefBB && !UseMI->isPHI())
191          continue;
192        SSAUpdate.RewriteUse(UseMO);
193      }
194    }
195
196    SSAUpdateVRs.clear();
197    SSAUpdateVals.clear();
198  }
199
200  // Eliminate some of the copies inserted by tail duplication to maintain
201  // SSA form.
202  for (unsigned i = 0, e = Copies.size(); i != e; ++i) {
203    MachineInstr *Copy = Copies[i];
204    if (!Copy->isCopy())
205      continue;
206    unsigned Dst = Copy->getOperand(0).getReg();
207    unsigned Src = Copy->getOperand(1).getReg();
208    if (MRI->hasOneNonDBGUse(Src) &&
209        MRI->constrainRegClass(Src, MRI->getRegClass(Dst))) {
210      // Copy is the only use. Do trivial copy propagation here.
211      MRI->replaceRegWith(Dst, Src);
212      Copy->eraseFromParent();
213    }
214  }
215
216  if (NewPHIs.size())
217    NumAddedPHIs += NewPHIs.size();
218
219  return true;
220}
221
222/// Look for small blocks that are unconditionally branched to and do not fall
223/// through. Tail-duplicate their instructions into their predecessors to
224/// eliminate (dynamic) branches.
225bool TailDuplicator::tailDuplicateBlocks(MachineFunction &MF) {
226  bool MadeChange = false;
227
228  if (PreRegAlloc && TailDupVerify) {
229    DEBUG(dbgs() << "\n*** Before tail-duplicating\n");
230    VerifyPHIs(MF, true);
231  }
232
233  for (MachineFunction::iterator I = ++MF.begin(), E = MF.end(); I != E;) {
234    MachineBasicBlock *MBB = &*I++;
235
236    if (NumTails == TailDupLimit)
237      break;
238
239    bool IsSimple = isSimpleBB(MBB);
240
241    if (!shouldTailDuplicate(MF, IsSimple, *MBB))
242      continue;
243
244    MadeChange |= tailDuplicateAndUpdate(MF, IsSimple, MBB);
245  }
246
247  if (PreRegAlloc && TailDupVerify)
248    VerifyPHIs(MF, false);
249
250  return MadeChange;
251}
252
253static bool isDefLiveOut(unsigned Reg, MachineBasicBlock *BB,
254                         const MachineRegisterInfo *MRI) {
255  for (MachineInstr &UseMI : MRI->use_instructions(Reg)) {
256    if (UseMI.isDebugValue())
257      continue;
258    if (UseMI.getParent() != BB)
259      return true;
260  }
261  return false;
262}
263
264static unsigned getPHISrcRegOpIdx(MachineInstr *MI, MachineBasicBlock *SrcBB) {
265  for (unsigned i = 1, e = MI->getNumOperands(); i != e; i += 2)
266    if (MI->getOperand(i + 1).getMBB() == SrcBB)
267      return i;
268  return 0;
269}
270
271// Remember which registers are used by phis in this block. This is
272// used to determine which registers are liveout while modifying the
273// block (which is why we need to copy the information).
274static void getRegsUsedByPHIs(const MachineBasicBlock &BB,
275                              DenseSet<unsigned> *UsedByPhi) {
276  for (const auto &MI : BB) {
277    if (!MI.isPHI())
278      break;
279    for (unsigned i = 1, e = MI.getNumOperands(); i != e; i += 2) {
280      unsigned SrcReg = MI.getOperand(i).getReg();
281      UsedByPhi->insert(SrcReg);
282    }
283  }
284}
285
286/// Add a definition and source virtual registers pair for SSA update.
287void TailDuplicator::addSSAUpdateEntry(unsigned OrigReg, unsigned NewReg,
288                                       MachineBasicBlock *BB) {
289  DenseMap<unsigned, AvailableValsTy>::iterator LI =
290      SSAUpdateVals.find(OrigReg);
291  if (LI != SSAUpdateVals.end())
292    LI->second.push_back(std::make_pair(BB, NewReg));
293  else {
294    AvailableValsTy Vals;
295    Vals.push_back(std::make_pair(BB, NewReg));
296    SSAUpdateVals.insert(std::make_pair(OrigReg, Vals));
297    SSAUpdateVRs.push_back(OrigReg);
298  }
299}
300
301/// Process PHI node in TailBB by turning it into a copy in PredBB. Remember the
302/// source register that's contributed by PredBB and update SSA update map.
303void TailDuplicator::processPHI(
304    MachineInstr *MI, MachineBasicBlock *TailBB, MachineBasicBlock *PredBB,
305    DenseMap<unsigned, RegSubRegPair> &LocalVRMap,
306    SmallVectorImpl<std::pair<unsigned, RegSubRegPair>> &Copies,
307    const DenseSet<unsigned> &RegsUsedByPhi, bool Remove) {
308  unsigned DefReg = MI->getOperand(0).getReg();
309  unsigned SrcOpIdx = getPHISrcRegOpIdx(MI, PredBB);
310  assert(SrcOpIdx && "Unable to find matching PHI source?");
311  unsigned SrcReg = MI->getOperand(SrcOpIdx).getReg();
312  unsigned SrcSubReg = MI->getOperand(SrcOpIdx).getSubReg();
313  const TargetRegisterClass *RC = MRI->getRegClass(DefReg);
314  LocalVRMap.insert(std::make_pair(DefReg, RegSubRegPair(SrcReg, SrcSubReg)));
315
316  // Insert a copy from source to the end of the block. The def register is the
317  // available value liveout of the block.
318  unsigned NewDef = MRI->createVirtualRegister(RC);
319  Copies.push_back(std::make_pair(NewDef, RegSubRegPair(SrcReg, SrcSubReg)));
320  if (isDefLiveOut(DefReg, TailBB, MRI) || RegsUsedByPhi.count(DefReg))
321    addSSAUpdateEntry(DefReg, NewDef, PredBB);
322
323  if (!Remove)
324    return;
325
326  // Remove PredBB from the PHI node.
327  MI->RemoveOperand(SrcOpIdx + 1);
328  MI->RemoveOperand(SrcOpIdx);
329  if (MI->getNumOperands() == 1)
330    MI->eraseFromParent();
331}
332
333/// Duplicate a TailBB instruction to PredBB and update
334/// the source operands due to earlier PHI translation.
335void TailDuplicator::duplicateInstruction(
336    MachineInstr *MI, MachineBasicBlock *TailBB, MachineBasicBlock *PredBB,
337    MachineFunction &MF,
338    DenseMap<unsigned, RegSubRegPair> &LocalVRMap,
339    const DenseSet<unsigned> &UsedByPhi) {
340  MachineInstr *NewMI = TII->duplicate(*MI, MF);
341  if (PreRegAlloc) {
342    for (unsigned i = 0, e = NewMI->getNumOperands(); i != e; ++i) {
343      MachineOperand &MO = NewMI->getOperand(i);
344      if (!MO.isReg())
345        continue;
346      unsigned Reg = MO.getReg();
347      if (!TargetRegisterInfo::isVirtualRegister(Reg))
348        continue;
349      if (MO.isDef()) {
350        const TargetRegisterClass *RC = MRI->getRegClass(Reg);
351        unsigned NewReg = MRI->createVirtualRegister(RC);
352        MO.setReg(NewReg);
353        LocalVRMap.insert(std::make_pair(Reg, RegSubRegPair(NewReg, 0)));
354        if (isDefLiveOut(Reg, TailBB, MRI) || UsedByPhi.count(Reg))
355          addSSAUpdateEntry(Reg, NewReg, PredBB);
356      } else {
357        auto VI = LocalVRMap.find(Reg);
358        if (VI != LocalVRMap.end()) {
359          // Need to make sure that the register class of the mapped register
360          // will satisfy the constraints of the class of the register being
361          // replaced.
362          auto *OrigRC = MRI->getRegClass(Reg);
363          auto *MappedRC = MRI->getRegClass(VI->second.Reg);
364          const TargetRegisterClass *ConstrRC;
365          if (VI->second.SubReg != 0) {
366            ConstrRC = TRI->getMatchingSuperRegClass(MappedRC, OrigRC,
367                                                     VI->second.SubReg);
368            if (ConstrRC) {
369              // The actual constraining (as in "find appropriate new class")
370              // is done by getMatchingSuperRegClass, so now we only need to
371              // change the class of the mapped register.
372              MRI->setRegClass(VI->second.Reg, ConstrRC);
373            }
374          } else {
375            // For mapped registers that do not have sub-registers, simply
376            // restrict their class to match the original one.
377            ConstrRC = MRI->constrainRegClass(VI->second.Reg, OrigRC);
378          }
379
380          if (ConstrRC) {
381            // If the class constraining succeeded, we can simply replace
382            // the old register with the mapped one.
383            MO.setReg(VI->second.Reg);
384            // We have Reg -> VI.Reg:VI.SubReg, so if Reg is used with a
385            // sub-register, we need to compose the sub-register indices.
386            MO.setSubReg(TRI->composeSubRegIndices(MO.getSubReg(),
387                                                   VI->second.SubReg));
388          } else {
389            // The direct replacement is not possible, due to failing register
390            // class constraints. An explicit COPY is necessary. Create one
391            // that can be reused
392            auto *NewRC = MI->getRegClassConstraint(i, TII, TRI);
393            if (NewRC == nullptr)
394              NewRC = OrigRC;
395            unsigned NewReg = MRI->createVirtualRegister(NewRC);
396            BuildMI(*PredBB, MI, MI->getDebugLoc(),
397                    TII->get(TargetOpcode::COPY), NewReg)
398                .addReg(VI->second.Reg, 0, VI->second.SubReg);
399            LocalVRMap.erase(VI);
400            LocalVRMap.insert(std::make_pair(Reg, RegSubRegPair(NewReg, 0)));
401            MO.setReg(NewReg);
402            // The composed VI.Reg:VI.SubReg is replaced with NewReg, which
403            // is equivalent to the whole register Reg. Hence, Reg:subreg
404            // is same as NewReg:subreg, so keep the sub-register index
405            // unchanged.
406          }
407          // Clear any kill flags from this operand.  The new register could
408          // have uses after this one, so kills are not valid here.
409          MO.setIsKill(false);
410        }
411      }
412    }
413  }
414  PredBB->insert(PredBB->instr_end(), NewMI);
415}
416
417/// After FromBB is tail duplicated into its predecessor blocks, the successors
418/// have gained new predecessors. Update the PHI instructions in them
419/// accordingly.
420void TailDuplicator::updateSuccessorsPHIs(
421    MachineBasicBlock *FromBB, bool isDead,
422    SmallVectorImpl<MachineBasicBlock *> &TDBBs,
423    SmallSetVector<MachineBasicBlock *, 8> &Succs) {
424  for (SmallSetVector<MachineBasicBlock *, 8>::iterator SI = Succs.begin(),
425                                                        SE = Succs.end();
426       SI != SE; ++SI) {
427    MachineBasicBlock *SuccBB = *SI;
428    for (MachineBasicBlock::iterator II = SuccBB->begin(), EE = SuccBB->end();
429         II != EE; ++II) {
430      if (!II->isPHI())
431        break;
432      MachineInstrBuilder MIB(*FromBB->getParent(), II);
433      unsigned Idx = 0;
434      for (unsigned i = 1, e = II->getNumOperands(); i != e; i += 2) {
435        MachineOperand &MO = II->getOperand(i + 1);
436        if (MO.getMBB() == FromBB) {
437          Idx = i;
438          break;
439        }
440      }
441
442      assert(Idx != 0);
443      MachineOperand &MO0 = II->getOperand(Idx);
444      unsigned Reg = MO0.getReg();
445      if (isDead) {
446        // Folded into the previous BB.
447        // There could be duplicate phi source entries. FIXME: Should sdisel
448        // or earlier pass fixed this?
449        for (unsigned i = II->getNumOperands() - 2; i != Idx; i -= 2) {
450          MachineOperand &MO = II->getOperand(i + 1);
451          if (MO.getMBB() == FromBB) {
452            II->RemoveOperand(i + 1);
453            II->RemoveOperand(i);
454          }
455        }
456      } else
457        Idx = 0;
458
459      // If Idx is set, the operands at Idx and Idx+1 must be removed.
460      // We reuse the location to avoid expensive RemoveOperand calls.
461
462      DenseMap<unsigned, AvailableValsTy>::iterator LI =
463          SSAUpdateVals.find(Reg);
464      if (LI != SSAUpdateVals.end()) {
465        // This register is defined in the tail block.
466        for (unsigned j = 0, ee = LI->second.size(); j != ee; ++j) {
467          MachineBasicBlock *SrcBB = LI->second[j].first;
468          // If we didn't duplicate a bb into a particular predecessor, we
469          // might still have added an entry to SSAUpdateVals to correcly
470          // recompute SSA. If that case, avoid adding a dummy extra argument
471          // this PHI.
472          if (!SrcBB->isSuccessor(SuccBB))
473            continue;
474
475          unsigned SrcReg = LI->second[j].second;
476          if (Idx != 0) {
477            II->getOperand(Idx).setReg(SrcReg);
478            II->getOperand(Idx + 1).setMBB(SrcBB);
479            Idx = 0;
480          } else {
481            MIB.addReg(SrcReg).addMBB(SrcBB);
482          }
483        }
484      } else {
485        // Live in tail block, must also be live in predecessors.
486        for (unsigned j = 0, ee = TDBBs.size(); j != ee; ++j) {
487          MachineBasicBlock *SrcBB = TDBBs[j];
488          if (Idx != 0) {
489            II->getOperand(Idx).setReg(Reg);
490            II->getOperand(Idx + 1).setMBB(SrcBB);
491            Idx = 0;
492          } else {
493            MIB.addReg(Reg).addMBB(SrcBB);
494          }
495        }
496      }
497      if (Idx != 0) {
498        II->RemoveOperand(Idx + 1);
499        II->RemoveOperand(Idx);
500      }
501    }
502  }
503}
504
505/// Determine if it is profitable to duplicate this block.
506bool TailDuplicator::shouldTailDuplicate(const MachineFunction &MF,
507                                         bool IsSimple,
508                                         MachineBasicBlock &TailBB) {
509  // Only duplicate blocks that end with unconditional branches.
510  if (TailBB.canFallThrough())
511    return false;
512
513  // Don't try to tail-duplicate single-block loops.
514  if (TailBB.isSuccessor(&TailBB))
515    return false;
516
517  // Set the limit on the cost to duplicate. When optimizing for size,
518  // duplicate only one, because one branch instruction can be eliminated to
519  // compensate for the duplication.
520  unsigned MaxDuplicateCount;
521  if (TailDuplicateSize.getNumOccurrences() == 0 &&
522      // FIXME: Use Function::optForSize().
523      MF.getFunction()->hasFnAttribute(Attribute::OptimizeForSize))
524    MaxDuplicateCount = 1;
525  else
526    MaxDuplicateCount = TailDuplicateSize;
527
528  // If the target has hardware branch prediction that can handle indirect
529  // branches, duplicating them can often make them predictable when there
530  // are common paths through the code.  The limit needs to be high enough
531  // to allow undoing the effects of tail merging and other optimizations
532  // that rearrange the predecessors of the indirect branch.
533
534  bool HasIndirectbr = false;
535  if (!TailBB.empty())
536    HasIndirectbr = TailBB.back().isIndirectBranch();
537
538  if (HasIndirectbr && PreRegAlloc)
539    MaxDuplicateCount = 20;
540
541  // Check the instructions in the block to determine whether tail-duplication
542  // is invalid or unlikely to be profitable.
543  unsigned InstrCount = 0;
544  for (MachineInstr &MI : TailBB) {
545    // Non-duplicable things shouldn't be tail-duplicated.
546    if (MI.isNotDuplicable())
547      return false;
548
549    // Convergent instructions can be duplicated only if doing so doesn't add
550    // new control dependencies, which is what we're going to do here.
551    if (MI.isConvergent())
552      return false;
553
554    // Do not duplicate 'return' instructions if this is a pre-regalloc run.
555    // A return may expand into a lot more instructions (e.g. reload of callee
556    // saved registers) after PEI.
557    if (PreRegAlloc && MI.isReturn())
558      return false;
559
560    // Avoid duplicating calls before register allocation. Calls presents a
561    // barrier to register allocation so duplicating them may end up increasing
562    // spills.
563    if (PreRegAlloc && MI.isCall())
564      return false;
565
566    if (!MI.isPHI() && !MI.isDebugValue())
567      InstrCount += 1;
568
569    if (InstrCount > MaxDuplicateCount)
570      return false;
571  }
572
573  // Check if any of the successors of TailBB has a PHI node in which the
574  // value corresponding to TailBB uses a subregister.
575  // If a phi node uses a register paired with a subregister, the actual
576  // "value type" of the phi may differ from the type of the register without
577  // any subregisters. Due to a bug, tail duplication may add a new operand
578  // without a necessary subregister, producing an invalid code. This is
579  // demonstrated by test/CodeGen/Hexagon/tail-dup-subreg-abort.ll.
580  // Disable tail duplication for this case for now, until the problem is
581  // fixed.
582  for (auto SB : TailBB.successors()) {
583    for (auto &I : *SB) {
584      if (!I.isPHI())
585        break;
586      unsigned Idx = getPHISrcRegOpIdx(&I, &TailBB);
587      assert(Idx != 0);
588      MachineOperand &PU = I.getOperand(Idx);
589      if (PU.getSubReg() != 0)
590        return false;
591    }
592  }
593
594  if (HasIndirectbr && PreRegAlloc)
595    return true;
596
597  if (IsSimple)
598    return true;
599
600  if (!PreRegAlloc)
601    return true;
602
603  return canCompletelyDuplicateBB(TailBB);
604}
605
606/// True if this BB has only one unconditional jump.
607bool TailDuplicator::isSimpleBB(MachineBasicBlock *TailBB) {
608  if (TailBB->succ_size() != 1)
609    return false;
610  if (TailBB->pred_empty())
611    return false;
612  MachineBasicBlock::iterator I = TailBB->getFirstNonDebugInstr();
613  if (I == TailBB->end())
614    return true;
615  return I->isUnconditionalBranch();
616}
617
618static bool bothUsedInPHI(const MachineBasicBlock &A,
619                          const SmallPtrSet<MachineBasicBlock *, 8> &SuccsB) {
620  for (MachineBasicBlock *BB : A.successors())
621    if (SuccsB.count(BB) && !BB->empty() && BB->begin()->isPHI())
622      return true;
623
624  return false;
625}
626
627bool TailDuplicator::canCompletelyDuplicateBB(MachineBasicBlock &BB) {
628  for (MachineBasicBlock *PredBB : BB.predecessors()) {
629    if (PredBB->succ_size() > 1)
630      return false;
631
632    MachineBasicBlock *PredTBB = nullptr, *PredFBB = nullptr;
633    SmallVector<MachineOperand, 4> PredCond;
634    if (TII->analyzeBranch(*PredBB, PredTBB, PredFBB, PredCond, true))
635      return false;
636
637    if (!PredCond.empty())
638      return false;
639  }
640  return true;
641}
642
643bool TailDuplicator::duplicateSimpleBB(
644    MachineBasicBlock *TailBB, SmallVectorImpl<MachineBasicBlock *> &TDBBs,
645    const DenseSet<unsigned> &UsedByPhi,
646    SmallVectorImpl<MachineInstr *> &Copies) {
647  SmallPtrSet<MachineBasicBlock *, 8> Succs(TailBB->succ_begin(),
648                                            TailBB->succ_end());
649  SmallVector<MachineBasicBlock *, 8> Preds(TailBB->pred_begin(),
650                                            TailBB->pred_end());
651  bool Changed = false;
652  for (SmallSetVector<MachineBasicBlock *, 8>::iterator PI = Preds.begin(),
653                                                        PE = Preds.end();
654       PI != PE; ++PI) {
655    MachineBasicBlock *PredBB = *PI;
656
657    if (PredBB->hasEHPadSuccessor())
658      continue;
659
660    if (bothUsedInPHI(*PredBB, Succs))
661      continue;
662
663    MachineBasicBlock *PredTBB = nullptr, *PredFBB = nullptr;
664    SmallVector<MachineOperand, 4> PredCond;
665    if (TII->analyzeBranch(*PredBB, PredTBB, PredFBB, PredCond, true))
666      continue;
667
668    Changed = true;
669    DEBUG(dbgs() << "\nTail-duplicating into PredBB: " << *PredBB
670                 << "From simple Succ: " << *TailBB);
671
672    MachineBasicBlock *NewTarget = *TailBB->succ_begin();
673    MachineBasicBlock *NextBB = &*std::next(PredBB->getIterator());
674
675    // Make PredFBB explicit.
676    if (PredCond.empty())
677      PredFBB = PredTBB;
678
679    // Make fall through explicit.
680    if (!PredTBB)
681      PredTBB = NextBB;
682    if (!PredFBB)
683      PredFBB = NextBB;
684
685    // Redirect
686    if (PredFBB == TailBB)
687      PredFBB = NewTarget;
688    if (PredTBB == TailBB)
689      PredTBB = NewTarget;
690
691    // Make the branch unconditional if possible
692    if (PredTBB == PredFBB) {
693      PredCond.clear();
694      PredFBB = nullptr;
695    }
696
697    // Avoid adding fall through branches.
698    if (PredFBB == NextBB)
699      PredFBB = nullptr;
700    if (PredTBB == NextBB && PredFBB == nullptr)
701      PredTBB = nullptr;
702
703    TII->RemoveBranch(*PredBB);
704
705    if (!PredBB->isSuccessor(NewTarget))
706      PredBB->replaceSuccessor(TailBB, NewTarget);
707    else {
708      PredBB->removeSuccessor(TailBB, true);
709      assert(PredBB->succ_size() <= 1);
710    }
711
712    if (PredTBB)
713      TII->InsertBranch(*PredBB, PredTBB, PredFBB, PredCond, DebugLoc());
714
715    TDBBs.push_back(PredBB);
716  }
717  return Changed;
718}
719
720/// If it is profitable, duplicate TailBB's contents in each
721/// of its predecessors.
722bool TailDuplicator::tailDuplicate(MachineFunction &MF, bool IsSimple,
723                                   MachineBasicBlock *TailBB,
724                                   SmallVectorImpl<MachineBasicBlock *> &TDBBs,
725                                   SmallVectorImpl<MachineInstr *> &Copies) {
726  DEBUG(dbgs() << "\n*** Tail-duplicating BB#" << TailBB->getNumber() << '\n');
727
728  DenseSet<unsigned> UsedByPhi;
729  getRegsUsedByPHIs(*TailBB, &UsedByPhi);
730
731  if (IsSimple)
732    return duplicateSimpleBB(TailBB, TDBBs, UsedByPhi, Copies);
733
734  // Iterate through all the unique predecessors and tail-duplicate this
735  // block into them, if possible. Copying the list ahead of time also
736  // avoids trouble with the predecessor list reallocating.
737  bool Changed = false;
738  SmallSetVector<MachineBasicBlock *, 8> Preds(TailBB->pred_begin(),
739                                               TailBB->pred_end());
740  for (SmallSetVector<MachineBasicBlock *, 8>::iterator PI = Preds.begin(),
741                                                        PE = Preds.end();
742       PI != PE; ++PI) {
743    MachineBasicBlock *PredBB = *PI;
744
745    assert(TailBB != PredBB &&
746           "Single-block loop should have been rejected earlier!");
747    // EH edges are ignored by AnalyzeBranch.
748    if (PredBB->succ_size() > 1)
749      continue;
750
751    MachineBasicBlock *PredTBB, *PredFBB;
752    SmallVector<MachineOperand, 4> PredCond;
753    if (TII->analyzeBranch(*PredBB, PredTBB, PredFBB, PredCond, true))
754      continue;
755    if (!PredCond.empty())
756      continue;
757    // Don't duplicate into a fall-through predecessor (at least for now).
758    if (PredBB->isLayoutSuccessor(TailBB) && PredBB->canFallThrough())
759      continue;
760
761    DEBUG(dbgs() << "\nTail-duplicating into PredBB: " << *PredBB
762                 << "From Succ: " << *TailBB);
763
764    TDBBs.push_back(PredBB);
765
766    // Remove PredBB's unconditional branch.
767    TII->RemoveBranch(*PredBB);
768
769    // Clone the contents of TailBB into PredBB.
770    DenseMap<unsigned, RegSubRegPair> LocalVRMap;
771    SmallVector<std::pair<unsigned, RegSubRegPair>, 4> CopyInfos;
772    // Use instr_iterator here to properly handle bundles, e.g.
773    // ARM Thumb2 IT block.
774    MachineBasicBlock::instr_iterator I = TailBB->instr_begin();
775    while (I != TailBB->instr_end()) {
776      MachineInstr *MI = &*I;
777      ++I;
778      if (MI->isPHI()) {
779        // Replace the uses of the def of the PHI with the register coming
780        // from PredBB.
781        processPHI(MI, TailBB, PredBB, LocalVRMap, CopyInfos, UsedByPhi, true);
782      } else {
783        // Replace def of virtual registers with new registers, and update
784        // uses with PHI source register or the new registers.
785        duplicateInstruction(MI, TailBB, PredBB, MF, LocalVRMap, UsedByPhi);
786      }
787    }
788    appendCopies(PredBB, CopyInfos, Copies);
789
790    // Simplify
791    TII->analyzeBranch(*PredBB, PredTBB, PredFBB, PredCond, true);
792
793    NumTailDupAdded += TailBB->size() - 1; // subtract one for removed branch
794
795    // Update the CFG.
796    PredBB->removeSuccessor(PredBB->succ_begin());
797    assert(PredBB->succ_empty() &&
798           "TailDuplicate called on block with multiple successors!");
799    for (MachineBasicBlock::succ_iterator I = TailBB->succ_begin(),
800                                          E = TailBB->succ_end();
801         I != E; ++I)
802      PredBB->addSuccessor(*I, MBPI->getEdgeProbability(TailBB, I));
803
804    Changed = true;
805    ++NumTailDups;
806  }
807
808  // If TailBB was duplicated into all its predecessors except for the prior
809  // block, which falls through unconditionally, move the contents of this
810  // block into the prior block.
811  MachineBasicBlock *PrevBB = &*std::prev(TailBB->getIterator());
812  MachineBasicBlock *PriorTBB = nullptr, *PriorFBB = nullptr;
813  SmallVector<MachineOperand, 4> PriorCond;
814  // This has to check PrevBB->succ_size() because EH edges are ignored by
815  // AnalyzeBranch.
816  if (PrevBB->succ_size() == 1 &&
817      !TII->analyzeBranch(*PrevBB, PriorTBB, PriorFBB, PriorCond, true) &&
818      PriorCond.empty() && !PriorTBB && TailBB->pred_size() == 1 &&
819      !TailBB->hasAddressTaken()) {
820    DEBUG(dbgs() << "\nMerging into block: " << *PrevBB
821                 << "From MBB: " << *TailBB);
822    if (PreRegAlloc) {
823      DenseMap<unsigned, RegSubRegPair> LocalVRMap;
824      SmallVector<std::pair<unsigned, RegSubRegPair>, 4> CopyInfos;
825      MachineBasicBlock::iterator I = TailBB->begin();
826      // Process PHI instructions first.
827      while (I != TailBB->end() && I->isPHI()) {
828        // Replace the uses of the def of the PHI with the register coming
829        // from PredBB.
830        MachineInstr *MI = &*I++;
831        processPHI(MI, TailBB, PrevBB, LocalVRMap, CopyInfos, UsedByPhi, true);
832      }
833
834      // Now copy the non-PHI instructions.
835      while (I != TailBB->end()) {
836        // Replace def of virtual registers with new registers, and update
837        // uses with PHI source register or the new registers.
838        MachineInstr *MI = &*I++;
839        assert(!MI->isBundle() && "Not expecting bundles before regalloc!");
840        duplicateInstruction(MI, TailBB, PrevBB, MF, LocalVRMap, UsedByPhi);
841        MI->eraseFromParent();
842      }
843      appendCopies(PrevBB, CopyInfos, Copies);
844    } else {
845      // No PHIs to worry about, just splice the instructions over.
846      PrevBB->splice(PrevBB->end(), TailBB, TailBB->begin(), TailBB->end());
847    }
848    PrevBB->removeSuccessor(PrevBB->succ_begin());
849    assert(PrevBB->succ_empty());
850    PrevBB->transferSuccessors(TailBB);
851    TDBBs.push_back(PrevBB);
852    Changed = true;
853  }
854
855  // If this is after register allocation, there are no phis to fix.
856  if (!PreRegAlloc)
857    return Changed;
858
859  // If we made no changes so far, we are safe.
860  if (!Changed)
861    return Changed;
862
863  // Handle the nasty case in that we duplicated a block that is part of a loop
864  // into some but not all of its predecessors. For example:
865  //    1 -> 2 <-> 3                 |
866  //          \                      |
867  //           \---> rest            |
868  // if we duplicate 2 into 1 but not into 3, we end up with
869  // 12 -> 3 <-> 2 -> rest           |
870  //   \             /               |
871  //    \----->-----/                |
872  // If there was a "var = phi(1, 3)" in 2, it has to be ultimately replaced
873  // with a phi in 3 (which now dominates 2).
874  // What we do here is introduce a copy in 3 of the register defined by the
875  // phi, just like when we are duplicating 2 into 3, but we don't copy any
876  // real instructions or remove the 3 -> 2 edge from the phi in 2.
877  for (SmallSetVector<MachineBasicBlock *, 8>::iterator PI = Preds.begin(),
878                                                        PE = Preds.end();
879       PI != PE; ++PI) {
880    MachineBasicBlock *PredBB = *PI;
881    if (std::find(TDBBs.begin(), TDBBs.end(), PredBB) != TDBBs.end())
882      continue;
883
884    // EH edges
885    if (PredBB->succ_size() != 1)
886      continue;
887
888    DenseMap<unsigned, RegSubRegPair> LocalVRMap;
889    SmallVector<std::pair<unsigned, RegSubRegPair>, 4> CopyInfos;
890    MachineBasicBlock::iterator I = TailBB->begin();
891    // Process PHI instructions first.
892    while (I != TailBB->end() && I->isPHI()) {
893      // Replace the uses of the def of the PHI with the register coming
894      // from PredBB.
895      MachineInstr *MI = &*I++;
896      processPHI(MI, TailBB, PredBB, LocalVRMap, CopyInfos, UsedByPhi, false);
897    }
898    appendCopies(PredBB, CopyInfos, Copies);
899  }
900
901  return Changed;
902}
903
904/// At the end of the block \p MBB generate COPY instructions between registers
905/// described by \p CopyInfos. Append resulting instructions to \p Copies.
906void TailDuplicator::appendCopies(MachineBasicBlock *MBB,
907      SmallVectorImpl<std::pair<unsigned,RegSubRegPair>> &CopyInfos,
908      SmallVectorImpl<MachineInstr*> &Copies) {
909  MachineBasicBlock::iterator Loc = MBB->getFirstTerminator();
910  const MCInstrDesc &CopyD = TII->get(TargetOpcode::COPY);
911  for (auto &CI : CopyInfos) {
912    auto C = BuildMI(*MBB, Loc, DebugLoc(), CopyD, CI.first)
913                .addReg(CI.second.Reg, 0, CI.second.SubReg);
914    Copies.push_back(C);
915  }
916}
917
918/// Remove the specified dead machine basic block from the function, updating
919/// the CFG.
920void TailDuplicator::removeDeadBlock(MachineBasicBlock *MBB) {
921  assert(MBB->pred_empty() && "MBB must be dead!");
922  DEBUG(dbgs() << "\nRemoving MBB: " << *MBB);
923
924  // Remove all successors.
925  while (!MBB->succ_empty())
926    MBB->removeSuccessor(MBB->succ_end() - 1);
927
928  // Remove the block.
929  MBB->eraseFromParent();
930}
931
932} // End llvm namespace
933