1 //===-- BranchFolding.cpp - Fold machine code branch instructions ---------===//
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 pass forwards branches to unconditional branches to make them branch
11 // directly to the target block.  This pass often results in dead MBB's, which
12 // it then removes.
13 //
14 // Note that this pass must be run after register allocation, it cannot handle
15 // SSA form. It also must handle virtual registers for targets that emit virtual
16 // ISA (e.g. NVPTX).
17 //
18 //===----------------------------------------------------------------------===//
19 
20 #include "BranchFolding.h"
21 #include "llvm/ADT/STLExtras.h"
22 #include "llvm/ADT/SmallSet.h"
23 #include "llvm/ADT/Statistic.h"
24 #include "llvm/CodeGen/Analysis.h"
25 #include "llvm/CodeGen/MachineBlockFrequencyInfo.h"
26 #include "llvm/CodeGen/MachineBranchProbabilityInfo.h"
27 #include "llvm/CodeGen/MachineFunctionPass.h"
28 #include "llvm/CodeGen/MachineJumpTableInfo.h"
29 #include "llvm/CodeGen/MachineMemOperand.h"
30 #include "llvm/CodeGen/MachineLoopInfo.h"
31 #include "llvm/CodeGen/MachineModuleInfo.h"
32 #include "llvm/CodeGen/MachineRegisterInfo.h"
33 #include "llvm/CodeGen/Passes.h"
34 #include "llvm/CodeGen/TargetPassConfig.h"
35 #include "llvm/IR/Function.h"
36 #include "llvm/Support/CommandLine.h"
37 #include "llvm/Support/Debug.h"
38 #include "llvm/Support/ErrorHandling.h"
39 #include "llvm/Support/raw_ostream.h"
40 #include "llvm/Target/TargetInstrInfo.h"
41 #include "llvm/Target/TargetRegisterInfo.h"
42 #include "llvm/Target/TargetSubtargetInfo.h"
43 #include <algorithm>
44 using namespace llvm;
45 
46 #define DEBUG_TYPE "branchfolding"
47 
48 STATISTIC(NumDeadBlocks, "Number of dead blocks removed");
49 STATISTIC(NumBranchOpts, "Number of branches optimized");
50 STATISTIC(NumTailMerge , "Number of block tails merged");
51 STATISTIC(NumHoist     , "Number of times common instructions are hoisted");
52 
53 static cl::opt<cl::boolOrDefault> FlagEnableTailMerge("enable-tail-merge",
54                               cl::init(cl::BOU_UNSET), cl::Hidden);
55 
56 // Throttle for huge numbers of predecessors (compile speed problems)
57 static cl::opt<unsigned>
58 TailMergeThreshold("tail-merge-threshold",
59           cl::desc("Max number of predecessors to consider tail merging"),
60           cl::init(150), cl::Hidden);
61 
62 // Heuristic for tail merging (and, inversely, tail duplication).
63 // TODO: This should be replaced with a target query.
64 static cl::opt<unsigned>
65 TailMergeSize("tail-merge-size",
66           cl::desc("Min number of instructions to consider tail merging"),
67                               cl::init(3), cl::Hidden);
68 
69 namespace {
70   /// BranchFolderPass - Wrap branch folder in a machine function pass.
71   class BranchFolderPass : public MachineFunctionPass {
72   public:
73     static char ID;
74     explicit BranchFolderPass(): MachineFunctionPass(ID) {}
75 
76     bool runOnMachineFunction(MachineFunction &MF) override;
77 
78     void getAnalysisUsage(AnalysisUsage &AU) const override {
79       AU.addRequired<MachineBlockFrequencyInfo>();
80       AU.addRequired<MachineBranchProbabilityInfo>();
81       AU.addRequired<TargetPassConfig>();
82       MachineFunctionPass::getAnalysisUsage(AU);
83     }
84   };
85 }
86 
87 char BranchFolderPass::ID = 0;
88 char &llvm::BranchFolderPassID = BranchFolderPass::ID;
89 
90 INITIALIZE_PASS(BranchFolderPass, "branch-folder",
91                 "Control Flow Optimizer", false, false)
92 
93 bool BranchFolderPass::runOnMachineFunction(MachineFunction &MF) {
94   if (skipFunction(*MF.getFunction()))
95     return false;
96 
97   TargetPassConfig *PassConfig = &getAnalysis<TargetPassConfig>();
98   // TailMerge can create jump into if branches that make CFG irreducible for
99   // HW that requires structurized CFG.
100   bool EnableTailMerge = !MF.getTarget().requiresStructuredCFG() &&
101                          PassConfig->getEnableTailMerge();
102   BranchFolder::MBFIWrapper MBBFreqInfo(
103       getAnalysis<MachineBlockFrequencyInfo>());
104   BranchFolder Folder(EnableTailMerge, /*CommonHoist=*/true, MBBFreqInfo,
105                       getAnalysis<MachineBranchProbabilityInfo>());
106   return Folder.OptimizeFunction(MF, MF.getSubtarget().getInstrInfo(),
107                                  MF.getSubtarget().getRegisterInfo(),
108                                  getAnalysisIfAvailable<MachineModuleInfo>());
109 }
110 
111 BranchFolder::BranchFolder(bool defaultEnableTailMerge, bool CommonHoist,
112                            MBFIWrapper &FreqInfo,
113                            const MachineBranchProbabilityInfo &ProbInfo,
114                            unsigned MinTailLength)
115     : EnableHoistCommonCode(CommonHoist), MinCommonTailLength(MinTailLength),
116       MBBFreqInfo(FreqInfo), MBPI(ProbInfo) {
117   if (MinCommonTailLength == 0)
118     MinCommonTailLength = TailMergeSize;
119   switch (FlagEnableTailMerge) {
120   case cl::BOU_UNSET: EnableTailMerge = defaultEnableTailMerge; break;
121   case cl::BOU_TRUE: EnableTailMerge = true; break;
122   case cl::BOU_FALSE: EnableTailMerge = false; break;
123   }
124 }
125 
126 /// RemoveDeadBlock - Remove the specified dead machine basic block from the
127 /// function, updating the CFG.
128 void BranchFolder::RemoveDeadBlock(MachineBasicBlock *MBB) {
129   assert(MBB->pred_empty() && "MBB must be dead!");
130   DEBUG(dbgs() << "\nRemoving MBB: " << *MBB);
131 
132   MachineFunction *MF = MBB->getParent();
133   // drop all successors.
134   while (!MBB->succ_empty())
135     MBB->removeSuccessor(MBB->succ_end()-1);
136 
137   // Avoid matching if this pointer gets reused.
138   TriedMerging.erase(MBB);
139 
140   // Remove the block.
141   MF->erase(MBB);
142   FuncletMembership.erase(MBB);
143   if (MLI)
144     MLI->removeBlock(MBB);
145 }
146 
147 /// OptimizeImpDefsBlock - If a basic block is just a bunch of implicit_def
148 /// followed by terminators, and if the implicitly defined registers are not
149 /// used by the terminators, remove those implicit_def's. e.g.
150 /// BB1:
151 ///   r0 = implicit_def
152 ///   r1 = implicit_def
153 ///   br
154 /// This block can be optimized away later if the implicit instructions are
155 /// removed.
156 bool BranchFolder::OptimizeImpDefsBlock(MachineBasicBlock *MBB) {
157   SmallSet<unsigned, 4> ImpDefRegs;
158   MachineBasicBlock::iterator I = MBB->begin();
159   while (I != MBB->end()) {
160     if (!I->isImplicitDef())
161       break;
162     unsigned Reg = I->getOperand(0).getReg();
163     if (TargetRegisterInfo::isPhysicalRegister(Reg)) {
164       for (MCSubRegIterator SubRegs(Reg, TRI, /*IncludeSelf=*/true);
165            SubRegs.isValid(); ++SubRegs)
166         ImpDefRegs.insert(*SubRegs);
167     } else {
168       ImpDefRegs.insert(Reg);
169     }
170     ++I;
171   }
172   if (ImpDefRegs.empty())
173     return false;
174 
175   MachineBasicBlock::iterator FirstTerm = I;
176   while (I != MBB->end()) {
177     if (!TII->isUnpredicatedTerminator(*I))
178       return false;
179     // See if it uses any of the implicitly defined registers.
180     for (const MachineOperand &MO : I->operands()) {
181       if (!MO.isReg() || !MO.isUse())
182         continue;
183       unsigned Reg = MO.getReg();
184       if (ImpDefRegs.count(Reg))
185         return false;
186     }
187     ++I;
188   }
189 
190   I = MBB->begin();
191   while (I != FirstTerm) {
192     MachineInstr *ImpDefMI = &*I;
193     ++I;
194     MBB->erase(ImpDefMI);
195   }
196 
197   return true;
198 }
199 
200 /// OptimizeFunction - Perhaps branch folding, tail merging and other
201 /// CFG optimizations on the given function.  Block placement changes the layout
202 /// and may create new tail merging opportunities.
203 bool BranchFolder::OptimizeFunction(MachineFunction &MF,
204                                     const TargetInstrInfo *tii,
205                                     const TargetRegisterInfo *tri,
206                                     MachineModuleInfo *mmi,
207                                     MachineLoopInfo *mli, bool AfterPlacement) {
208   if (!tii) return false;
209 
210   TriedMerging.clear();
211 
212   AfterBlockPlacement = AfterPlacement;
213   TII = tii;
214   TRI = tri;
215   MMI = mmi;
216   MLI = mli;
217 
218   MachineRegisterInfo &MRI = MF.getRegInfo();
219   UpdateLiveIns = MRI.tracksLiveness() && TRI->trackLivenessAfterRegAlloc(MF);
220   if (!UpdateLiveIns)
221     MRI.invalidateLiveness();
222 
223   // Fix CFG.  The later algorithms expect it to be right.
224   bool MadeChange = false;
225   for (MachineBasicBlock &MBB : MF) {
226     MachineBasicBlock *TBB = nullptr, *FBB = nullptr;
227     SmallVector<MachineOperand, 4> Cond;
228     if (!TII->analyzeBranch(MBB, TBB, FBB, Cond, true))
229       MadeChange |= MBB.CorrectExtraCFGEdges(TBB, FBB, !Cond.empty());
230     MadeChange |= OptimizeImpDefsBlock(&MBB);
231   }
232 
233   // Recalculate funclet membership.
234   FuncletMembership = getFuncletMembership(MF);
235 
236   bool MadeChangeThisIteration = true;
237   while (MadeChangeThisIteration) {
238     MadeChangeThisIteration    = TailMergeBlocks(MF);
239     // No need to clean up if tail merging does not change anything after the
240     // block placement.
241     if (!AfterBlockPlacement || MadeChangeThisIteration)
242       MadeChangeThisIteration |= OptimizeBranches(MF);
243     if (EnableHoistCommonCode)
244       MadeChangeThisIteration |= HoistCommonCode(MF);
245     MadeChange |= MadeChangeThisIteration;
246   }
247 
248   // See if any jump tables have become dead as the code generator
249   // did its thing.
250   MachineJumpTableInfo *JTI = MF.getJumpTableInfo();
251   if (!JTI)
252     return MadeChange;
253 
254   // Walk the function to find jump tables that are live.
255   BitVector JTIsLive(JTI->getJumpTables().size());
256   for (const MachineBasicBlock &BB : MF) {
257     for (const MachineInstr &I : BB)
258       for (const MachineOperand &Op : I.operands()) {
259         if (!Op.isJTI()) continue;
260 
261         // Remember that this JT is live.
262         JTIsLive.set(Op.getIndex());
263       }
264   }
265 
266   // Finally, remove dead jump tables.  This happens when the
267   // indirect jump was unreachable (and thus deleted).
268   for (unsigned i = 0, e = JTIsLive.size(); i != e; ++i)
269     if (!JTIsLive.test(i)) {
270       JTI->RemoveJumpTable(i);
271       MadeChange = true;
272     }
273 
274   return MadeChange;
275 }
276 
277 //===----------------------------------------------------------------------===//
278 //  Tail Merging of Blocks
279 //===----------------------------------------------------------------------===//
280 
281 /// HashMachineInstr - Compute a hash value for MI and its operands.
282 static unsigned HashMachineInstr(const MachineInstr &MI) {
283   unsigned Hash = MI.getOpcode();
284   for (unsigned i = 0, e = MI.getNumOperands(); i != e; ++i) {
285     const MachineOperand &Op = MI.getOperand(i);
286 
287     // Merge in bits from the operand if easy. We can't use MachineOperand's
288     // hash_code here because it's not deterministic and we sort by hash value
289     // later.
290     unsigned OperandHash = 0;
291     switch (Op.getType()) {
292     case MachineOperand::MO_Register:
293       OperandHash = Op.getReg();
294       break;
295     case MachineOperand::MO_Immediate:
296       OperandHash = Op.getImm();
297       break;
298     case MachineOperand::MO_MachineBasicBlock:
299       OperandHash = Op.getMBB()->getNumber();
300       break;
301     case MachineOperand::MO_FrameIndex:
302     case MachineOperand::MO_ConstantPoolIndex:
303     case MachineOperand::MO_JumpTableIndex:
304       OperandHash = Op.getIndex();
305       break;
306     case MachineOperand::MO_GlobalAddress:
307     case MachineOperand::MO_ExternalSymbol:
308       // Global address / external symbol are too hard, don't bother, but do
309       // pull in the offset.
310       OperandHash = Op.getOffset();
311       break;
312     default:
313       break;
314     }
315 
316     Hash += ((OperandHash << 3) | Op.getType()) << (i & 31);
317   }
318   return Hash;
319 }
320 
321 /// HashEndOfMBB - Hash the last instruction in the MBB.
322 static unsigned HashEndOfMBB(const MachineBasicBlock &MBB) {
323   MachineBasicBlock::const_iterator I = MBB.getLastNonDebugInstr();
324   if (I == MBB.end())
325     return 0;
326 
327   return HashMachineInstr(*I);
328 }
329 
330 /// ComputeCommonTailLength - Given two machine basic blocks, compute the number
331 /// of instructions they actually have in common together at their end.  Return
332 /// iterators for the first shared instruction in each block.
333 static unsigned ComputeCommonTailLength(MachineBasicBlock *MBB1,
334                                         MachineBasicBlock *MBB2,
335                                         MachineBasicBlock::iterator &I1,
336                                         MachineBasicBlock::iterator &I2) {
337   I1 = MBB1->end();
338   I2 = MBB2->end();
339 
340   unsigned TailLen = 0;
341   while (I1 != MBB1->begin() && I2 != MBB2->begin()) {
342     --I1; --I2;
343     // Skip debugging pseudos; necessary to avoid changing the code.
344     while (I1->isDebugValue()) {
345       if (I1==MBB1->begin()) {
346         while (I2->isDebugValue()) {
347           if (I2==MBB2->begin())
348             // I1==DBG at begin; I2==DBG at begin
349             return TailLen;
350           --I2;
351         }
352         ++I2;
353         // I1==DBG at begin; I2==non-DBG, or first of DBGs not at begin
354         return TailLen;
355       }
356       --I1;
357     }
358     // I1==first (untested) non-DBG preceding known match
359     while (I2->isDebugValue()) {
360       if (I2==MBB2->begin()) {
361         ++I1;
362         // I1==non-DBG, or first of DBGs not at begin; I2==DBG at begin
363         return TailLen;
364       }
365       --I2;
366     }
367     // I1, I2==first (untested) non-DBGs preceding known match
368     if (!I1->isIdenticalTo(*I2) ||
369         // FIXME: This check is dubious. It's used to get around a problem where
370         // people incorrectly expect inline asm directives to remain in the same
371         // relative order. This is untenable because normal compiler
372         // optimizations (like this one) may reorder and/or merge these
373         // directives.
374         I1->isInlineAsm()) {
375       ++I1; ++I2;
376       break;
377     }
378     ++TailLen;
379   }
380   // Back past possible debugging pseudos at beginning of block.  This matters
381   // when one block differs from the other only by whether debugging pseudos
382   // are present at the beginning. (This way, the various checks later for
383   // I1==MBB1->begin() work as expected.)
384   if (I1 == MBB1->begin() && I2 != MBB2->begin()) {
385     --I2;
386     while (I2->isDebugValue()) {
387       if (I2 == MBB2->begin())
388         return TailLen;
389       --I2;
390     }
391     ++I2;
392   }
393   if (I2 == MBB2->begin() && I1 != MBB1->begin()) {
394     --I1;
395     while (I1->isDebugValue()) {
396       if (I1 == MBB1->begin())
397         return TailLen;
398       --I1;
399     }
400     ++I1;
401   }
402   return TailLen;
403 }
404 
405 void BranchFolder::computeLiveIns(MachineBasicBlock &MBB) {
406   if (!UpdateLiveIns)
407     return;
408 
409   LiveRegs.init(TRI);
410   LiveRegs.addLiveOutsNoPristines(MBB);
411   for (MachineInstr &MI : make_range(MBB.rbegin(), MBB.rend()))
412     LiveRegs.stepBackward(MI);
413 
414   for (unsigned Reg : LiveRegs) {
415     // Skip the register if we are about to add one of its super registers.
416     bool ContainsSuperReg = false;
417     for (MCSuperRegIterator SReg(Reg, TRI); SReg.isValid(); ++SReg) {
418       if (LiveRegs.contains(*SReg)) {
419         ContainsSuperReg = true;
420         break;
421       }
422     }
423     if (ContainsSuperReg)
424       continue;
425     MBB.addLiveIn(Reg);
426   }
427 }
428 
429 /// ReplaceTailWithBranchTo - Delete the instruction OldInst and everything
430 /// after it, replacing it with an unconditional branch to NewDest.
431 void BranchFolder::ReplaceTailWithBranchTo(MachineBasicBlock::iterator OldInst,
432                                            MachineBasicBlock *NewDest) {
433   TII->ReplaceTailWithBranchTo(OldInst, NewDest);
434 
435   computeLiveIns(*NewDest);
436 
437   ++NumTailMerge;
438 }
439 
440 /// SplitMBBAt - Given a machine basic block and an iterator into it, split the
441 /// MBB so that the part before the iterator falls into the part starting at the
442 /// iterator.  This returns the new MBB.
443 MachineBasicBlock *BranchFolder::SplitMBBAt(MachineBasicBlock &CurMBB,
444                                             MachineBasicBlock::iterator BBI1,
445                                             const BasicBlock *BB) {
446   if (!TII->isLegalToSplitMBBAt(CurMBB, BBI1))
447     return nullptr;
448 
449   MachineFunction &MF = *CurMBB.getParent();
450 
451   // Create the fall-through block.
452   MachineFunction::iterator MBBI = CurMBB.getIterator();
453   MachineBasicBlock *NewMBB =MF.CreateMachineBasicBlock(BB);
454   CurMBB.getParent()->insert(++MBBI, NewMBB);
455 
456   // Move all the successors of this block to the specified block.
457   NewMBB->transferSuccessors(&CurMBB);
458 
459   // Add an edge from CurMBB to NewMBB for the fall-through.
460   CurMBB.addSuccessor(NewMBB);
461 
462   // Splice the code over.
463   NewMBB->splice(NewMBB->end(), &CurMBB, BBI1, CurMBB.end());
464 
465   // NewMBB belongs to the same loop as CurMBB.
466   if (MLI)
467     if (MachineLoop *ML = MLI->getLoopFor(&CurMBB))
468       ML->addBasicBlockToLoop(NewMBB, MLI->getBase());
469 
470   // NewMBB inherits CurMBB's block frequency.
471   MBBFreqInfo.setBlockFreq(NewMBB, MBBFreqInfo.getBlockFreq(&CurMBB));
472 
473   computeLiveIns(*NewMBB);
474 
475   // Add the new block to the funclet.
476   const auto &FuncletI = FuncletMembership.find(&CurMBB);
477   if (FuncletI != FuncletMembership.end()) {
478     auto n = FuncletI->second;
479     FuncletMembership[NewMBB] = n;
480   }
481 
482   return NewMBB;
483 }
484 
485 /// EstimateRuntime - Make a rough estimate for how long it will take to run
486 /// the specified code.
487 static unsigned EstimateRuntime(MachineBasicBlock::iterator I,
488                                 MachineBasicBlock::iterator E) {
489   unsigned Time = 0;
490   for (; I != E; ++I) {
491     if (I->isDebugValue())
492       continue;
493     if (I->isCall())
494       Time += 10;
495     else if (I->mayLoad() || I->mayStore())
496       Time += 2;
497     else
498       ++Time;
499   }
500   return Time;
501 }
502 
503 // CurMBB needs to add an unconditional branch to SuccMBB (we removed these
504 // branches temporarily for tail merging).  In the case where CurMBB ends
505 // with a conditional branch to the next block, optimize by reversing the
506 // test and conditionally branching to SuccMBB instead.
507 static void FixTail(MachineBasicBlock *CurMBB, MachineBasicBlock *SuccBB,
508                     const TargetInstrInfo *TII) {
509   MachineFunction *MF = CurMBB->getParent();
510   MachineFunction::iterator I = std::next(MachineFunction::iterator(CurMBB));
511   MachineBasicBlock *TBB = nullptr, *FBB = nullptr;
512   SmallVector<MachineOperand, 4> Cond;
513   DebugLoc dl;  // FIXME: this is nowhere
514   if (I != MF->end() && !TII->analyzeBranch(*CurMBB, TBB, FBB, Cond, true)) {
515     MachineBasicBlock *NextBB = &*I;
516     if (TBB == NextBB && !Cond.empty() && !FBB) {
517       if (!TII->ReverseBranchCondition(Cond)) {
518         TII->RemoveBranch(*CurMBB);
519         TII->InsertBranch(*CurMBB, SuccBB, nullptr, Cond, dl);
520         return;
521       }
522     }
523   }
524   TII->InsertBranch(*CurMBB, SuccBB, nullptr,
525                     SmallVector<MachineOperand, 0>(), dl);
526 }
527 
528 bool
529 BranchFolder::MergePotentialsElt::operator<(const MergePotentialsElt &o) const {
530   if (getHash() < o.getHash())
531     return true;
532   if (getHash() > o.getHash())
533     return false;
534   if (getBlock()->getNumber() < o.getBlock()->getNumber())
535     return true;
536   if (getBlock()->getNumber() > o.getBlock()->getNumber())
537     return false;
538   // _GLIBCXX_DEBUG checks strict weak ordering, which involves comparing
539   // an object with itself.
540 #ifndef _GLIBCXX_DEBUG
541   llvm_unreachable("Predecessor appears twice");
542 #else
543   return false;
544 #endif
545 }
546 
547 BlockFrequency
548 BranchFolder::MBFIWrapper::getBlockFreq(const MachineBasicBlock *MBB) const {
549   auto I = MergedBBFreq.find(MBB);
550 
551   if (I != MergedBBFreq.end())
552     return I->second;
553 
554   return MBFI.getBlockFreq(MBB);
555 }
556 
557 void BranchFolder::MBFIWrapper::setBlockFreq(const MachineBasicBlock *MBB,
558                                              BlockFrequency F) {
559   MergedBBFreq[MBB] = F;
560 }
561 
562 raw_ostream &
563 BranchFolder::MBFIWrapper::printBlockFreq(raw_ostream &OS,
564                                           const MachineBasicBlock *MBB) const {
565   return MBFI.printBlockFreq(OS, getBlockFreq(MBB));
566 }
567 
568 raw_ostream &
569 BranchFolder::MBFIWrapper::printBlockFreq(raw_ostream &OS,
570                                           const BlockFrequency Freq) const {
571   return MBFI.printBlockFreq(OS, Freq);
572 }
573 
574 /// CountTerminators - Count the number of terminators in the given
575 /// block and set I to the position of the first non-terminator, if there
576 /// is one, or MBB->end() otherwise.
577 static unsigned CountTerminators(MachineBasicBlock *MBB,
578                                  MachineBasicBlock::iterator &I) {
579   I = MBB->end();
580   unsigned NumTerms = 0;
581   for (;;) {
582     if (I == MBB->begin()) {
583       I = MBB->end();
584       break;
585     }
586     --I;
587     if (!I->isTerminator()) break;
588     ++NumTerms;
589   }
590   return NumTerms;
591 }
592 
593 /// ProfitableToMerge - Check if two machine basic blocks have a common tail
594 /// and decide if it would be profitable to merge those tails.  Return the
595 /// length of the common tail and iterators to the first common instruction
596 /// in each block.
597 /// MBB1, MBB2      The blocks to check
598 /// MinCommonTailLength  Minimum size of tail block to be merged.
599 /// CommonTailLen   Out parameter to record the size of the shared tail between
600 ///                 MBB1 and MBB2
601 /// I1, I2          Iterator references that will be changed to point to the first
602 ///                 instruction in the common tail shared by MBB1,MBB2
603 /// SuccBB          A common successor of MBB1, MBB2 which are in a canonical form
604 ///                 relative to SuccBB
605 /// PredBB          The layout predecessor of SuccBB, if any.
606 /// FuncletMembership  map from block to funclet #.
607 /// AfterPlacement  True if we are merging blocks after layout. Stricter
608 ///                 thresholds apply to prevent undoing tail-duplication.
609 static bool
610 ProfitableToMerge(MachineBasicBlock *MBB1, MachineBasicBlock *MBB2,
611                   unsigned MinCommonTailLength, unsigned &CommonTailLen,
612                   MachineBasicBlock::iterator &I1,
613                   MachineBasicBlock::iterator &I2, MachineBasicBlock *SuccBB,
614                   MachineBasicBlock *PredBB,
615                   DenseMap<const MachineBasicBlock *, int> &FuncletMembership,
616                   bool AfterPlacement) {
617   // It is never profitable to tail-merge blocks from two different funclets.
618   if (!FuncletMembership.empty()) {
619     auto Funclet1 = FuncletMembership.find(MBB1);
620     assert(Funclet1 != FuncletMembership.end());
621     auto Funclet2 = FuncletMembership.find(MBB2);
622     assert(Funclet2 != FuncletMembership.end());
623     if (Funclet1->second != Funclet2->second)
624       return false;
625   }
626 
627   CommonTailLen = ComputeCommonTailLength(MBB1, MBB2, I1, I2);
628   if (CommonTailLen == 0)
629     return false;
630   DEBUG(dbgs() << "Common tail length of BB#" << MBB1->getNumber()
631                << " and BB#" << MBB2->getNumber() << " is " << CommonTailLen
632                << '\n');
633 
634   // It's almost always profitable to merge any number of non-terminator
635   // instructions with the block that falls through into the common successor.
636   // This is true only for a single successor. For multiple successors, we are
637   // trading a conditional branch for an unconditional one.
638   // TODO: Re-visit successor size for non-layout tail merging.
639   if ((MBB1 == PredBB || MBB2 == PredBB) &&
640       (!AfterPlacement || MBB1->succ_size() == 1)) {
641     MachineBasicBlock::iterator I;
642     unsigned NumTerms = CountTerminators(MBB1 == PredBB ? MBB2 : MBB1, I);
643     if (CommonTailLen > NumTerms)
644       return true;
645   }
646 
647   // If one of the blocks can be completely merged and happens to be in
648   // a position where the other could fall through into it, merge any number
649   // of instructions, because it can be done without a branch.
650   // TODO: If the blocks are not adjacent, move one of them so that they are?
651   if (MBB1->isLayoutSuccessor(MBB2) && I2 == MBB2->begin())
652     return true;
653   if (MBB2->isLayoutSuccessor(MBB1) && I1 == MBB1->begin())
654     return true;
655 
656   // If both blocks have an unconditional branch temporarily stripped out,
657   // count that as an additional common instruction for the following
658   // heuristics. This heuristic is only accurate for single-succ blocks, so to
659   // make sure that during layout merging and duplicating don't crash, we check
660   // for that when merging during layout.
661   unsigned EffectiveTailLen = CommonTailLen;
662   if (SuccBB && MBB1 != PredBB && MBB2 != PredBB &&
663       (MBB1->succ_size() == 1 || !AfterPlacement) &&
664       !MBB1->back().isBarrier() &&
665       !MBB2->back().isBarrier())
666     ++EffectiveTailLen;
667 
668   // Check if the common tail is long enough to be worthwhile.
669   if (EffectiveTailLen >= MinCommonTailLength)
670     return true;
671 
672   // If we are optimizing for code size, 2 instructions in common is enough if
673   // we don't have to split a block.  At worst we will be introducing 1 new
674   // branch instruction, which is likely to be smaller than the 2
675   // instructions that would be deleted in the merge.
676   MachineFunction *MF = MBB1->getParent();
677   return EffectiveTailLen >= 2 && MF->getFunction()->optForSize() &&
678          (I1 == MBB1->begin() || I2 == MBB2->begin());
679 }
680 
681 /// ComputeSameTails - Look through all the blocks in MergePotentials that have
682 /// hash CurHash (guaranteed to match the last element).  Build the vector
683 /// SameTails of all those that have the (same) largest number of instructions
684 /// in common of any pair of these blocks.  SameTails entries contain an
685 /// iterator into MergePotentials (from which the MachineBasicBlock can be
686 /// found) and a MachineBasicBlock::iterator into that MBB indicating the
687 /// instruction where the matching code sequence begins.
688 /// Order of elements in SameTails is the reverse of the order in which
689 /// those blocks appear in MergePotentials (where they are not necessarily
690 /// consecutive).
691 unsigned BranchFolder::ComputeSameTails(unsigned CurHash,
692                                         unsigned MinCommonTailLength,
693                                         MachineBasicBlock *SuccBB,
694                                         MachineBasicBlock *PredBB) {
695   unsigned maxCommonTailLength = 0U;
696   SameTails.clear();
697   MachineBasicBlock::iterator TrialBBI1, TrialBBI2;
698   MPIterator HighestMPIter = std::prev(MergePotentials.end());
699   for (MPIterator CurMPIter = std::prev(MergePotentials.end()),
700                   B = MergePotentials.begin();
701        CurMPIter != B && CurMPIter->getHash() == CurHash; --CurMPIter) {
702     for (MPIterator I = std::prev(CurMPIter); I->getHash() == CurHash; --I) {
703       unsigned CommonTailLen;
704       if (ProfitableToMerge(CurMPIter->getBlock(), I->getBlock(),
705                             MinCommonTailLength,
706                             CommonTailLen, TrialBBI1, TrialBBI2,
707                             SuccBB, PredBB,
708                             FuncletMembership,
709                             AfterBlockPlacement)) {
710         if (CommonTailLen > maxCommonTailLength) {
711           SameTails.clear();
712           maxCommonTailLength = CommonTailLen;
713           HighestMPIter = CurMPIter;
714           SameTails.push_back(SameTailElt(CurMPIter, TrialBBI1));
715         }
716         if (HighestMPIter == CurMPIter &&
717             CommonTailLen == maxCommonTailLength)
718           SameTails.push_back(SameTailElt(I, TrialBBI2));
719       }
720       if (I == B)
721         break;
722     }
723   }
724   return maxCommonTailLength;
725 }
726 
727 /// RemoveBlocksWithHash - Remove all blocks with hash CurHash from
728 /// MergePotentials, restoring branches at ends of blocks as appropriate.
729 void BranchFolder::RemoveBlocksWithHash(unsigned CurHash,
730                                         MachineBasicBlock *SuccBB,
731                                         MachineBasicBlock *PredBB) {
732   MPIterator CurMPIter, B;
733   for (CurMPIter = std::prev(MergePotentials.end()),
734       B = MergePotentials.begin();
735        CurMPIter->getHash() == CurHash; --CurMPIter) {
736     // Put the unconditional branch back, if we need one.
737     MachineBasicBlock *CurMBB = CurMPIter->getBlock();
738     if (SuccBB && CurMBB != PredBB)
739       FixTail(CurMBB, SuccBB, TII);
740     if (CurMPIter == B)
741       break;
742   }
743   if (CurMPIter->getHash() != CurHash)
744     CurMPIter++;
745   MergePotentials.erase(CurMPIter, MergePotentials.end());
746 }
747 
748 /// CreateCommonTailOnlyBlock - None of the blocks to be tail-merged consist
749 /// only of the common tail.  Create a block that does by splitting one.
750 bool BranchFolder::CreateCommonTailOnlyBlock(MachineBasicBlock *&PredBB,
751                                              MachineBasicBlock *SuccBB,
752                                              unsigned maxCommonTailLength,
753                                              unsigned &commonTailIndex) {
754   commonTailIndex = 0;
755   unsigned TimeEstimate = ~0U;
756   for (unsigned i = 0, e = SameTails.size(); i != e; ++i) {
757     // Use PredBB if possible; that doesn't require a new branch.
758     if (SameTails[i].getBlock() == PredBB) {
759       commonTailIndex = i;
760       break;
761     }
762     // Otherwise, make a (fairly bogus) choice based on estimate of
763     // how long it will take the various blocks to execute.
764     unsigned t = EstimateRuntime(SameTails[i].getBlock()->begin(),
765                                  SameTails[i].getTailStartPos());
766     if (t <= TimeEstimate) {
767       TimeEstimate = t;
768       commonTailIndex = i;
769     }
770   }
771 
772   MachineBasicBlock::iterator BBI =
773     SameTails[commonTailIndex].getTailStartPos();
774   MachineBasicBlock *MBB = SameTails[commonTailIndex].getBlock();
775 
776   // If the common tail includes any debug info we will take it pretty
777   // randomly from one of the inputs.  Might be better to remove it?
778   DEBUG(dbgs() << "\nSplitting BB#" << MBB->getNumber() << ", size "
779                << maxCommonTailLength);
780 
781   // If the split block unconditionally falls-thru to SuccBB, it will be
782   // merged. In control flow terms it should then take SuccBB's name. e.g. If
783   // SuccBB is an inner loop, the common tail is still part of the inner loop.
784   const BasicBlock *BB = (SuccBB && MBB->succ_size() == 1) ?
785     SuccBB->getBasicBlock() : MBB->getBasicBlock();
786   MachineBasicBlock *newMBB = SplitMBBAt(*MBB, BBI, BB);
787   if (!newMBB) {
788     DEBUG(dbgs() << "... failed!");
789     return false;
790   }
791 
792   SameTails[commonTailIndex].setBlock(newMBB);
793   SameTails[commonTailIndex].setTailStartPos(newMBB->begin());
794 
795   // If we split PredBB, newMBB is the new predecessor.
796   if (PredBB == MBB)
797     PredBB = newMBB;
798 
799   return true;
800 }
801 
802 static void
803 mergeMMOsFromMemoryOperations(MachineBasicBlock::iterator MBBIStartPos,
804                               MachineBasicBlock &MBBCommon) {
805   // Merge MMOs from memory operations in the common block.
806   MachineBasicBlock *MBB = MBBIStartPos->getParent();
807   // Note CommonTailLen does not necessarily matches the size of
808   // the common BB nor all its instructions because of debug
809   // instructions differences.
810   unsigned CommonTailLen = 0;
811   for (auto E = MBB->end(); MBBIStartPos != E; ++MBBIStartPos)
812     ++CommonTailLen;
813 
814   MachineBasicBlock::reverse_iterator MBBI = MBB->rbegin();
815   MachineBasicBlock::reverse_iterator MBBIE = MBB->rend();
816   MachineBasicBlock::reverse_iterator MBBICommon = MBBCommon.rbegin();
817   MachineBasicBlock::reverse_iterator MBBIECommon = MBBCommon.rend();
818 
819   while (CommonTailLen--) {
820     assert(MBBI != MBBIE && "Reached BB end within common tail length!");
821     (void)MBBIE;
822 
823     if (MBBI->isDebugValue()) {
824       ++MBBI;
825       continue;
826     }
827 
828     while ((MBBICommon != MBBIECommon) && MBBICommon->isDebugValue())
829       ++MBBICommon;
830 
831     assert(MBBICommon != MBBIECommon &&
832            "Reached BB end within common tail length!");
833     assert(MBBICommon->isIdenticalTo(*MBBI) && "Expected matching MIIs!");
834 
835     if (MBBICommon->mayLoad() || MBBICommon->mayStore())
836       MBBICommon->setMemRefs(MBBICommon->mergeMemRefsWith(*MBBI));
837 
838     ++MBBI;
839     ++MBBICommon;
840   }
841 }
842 
843 // See if any of the blocks in MergePotentials (which all have SuccBB as a
844 // successor, or all have no successor if it is null) can be tail-merged.
845 // If there is a successor, any blocks in MergePotentials that are not
846 // tail-merged and are not immediately before Succ must have an unconditional
847 // branch to Succ added (but the predecessor/successor lists need no
848 // adjustment). The lone predecessor of Succ that falls through into Succ,
849 // if any, is given in PredBB.
850 // MinCommonTailLength - Except for the special cases below, tail-merge if
851 // there are at least this many instructions in common.
852 bool BranchFolder::TryTailMergeBlocks(MachineBasicBlock *SuccBB,
853                                       MachineBasicBlock *PredBB,
854                                       unsigned MinCommonTailLength) {
855   bool MadeChange = false;
856 
857   DEBUG(dbgs() << "\nTryTailMergeBlocks: ";
858         for (unsigned i = 0, e = MergePotentials.size(); i != e; ++i)
859           dbgs() << "BB#" << MergePotentials[i].getBlock()->getNumber()
860                  << (i == e-1 ? "" : ", ");
861         dbgs() << "\n";
862         if (SuccBB) {
863           dbgs() << "  with successor BB#" << SuccBB->getNumber() << '\n';
864           if (PredBB)
865             dbgs() << "  which has fall-through from BB#"
866                    << PredBB->getNumber() << "\n";
867         }
868         dbgs() << "Looking for common tails of at least "
869                << MinCommonTailLength << " instruction"
870                << (MinCommonTailLength == 1 ? "" : "s") << '\n';
871        );
872 
873   // Sort by hash value so that blocks with identical end sequences sort
874   // together.
875   array_pod_sort(MergePotentials.begin(), MergePotentials.end());
876 
877   // Walk through equivalence sets looking for actual exact matches.
878   while (MergePotentials.size() > 1) {
879     unsigned CurHash = MergePotentials.back().getHash();
880 
881     // Build SameTails, identifying the set of blocks with this hash code
882     // and with the maximum number of instructions in common.
883     unsigned maxCommonTailLength = ComputeSameTails(CurHash,
884                                                     MinCommonTailLength,
885                                                     SuccBB, PredBB);
886 
887     // If we didn't find any pair that has at least MinCommonTailLength
888     // instructions in common, remove all blocks with this hash code and retry.
889     if (SameTails.empty()) {
890       RemoveBlocksWithHash(CurHash, SuccBB, PredBB);
891       continue;
892     }
893 
894     // If one of the blocks is the entire common tail (and not the entry
895     // block, which we can't jump to), we can treat all blocks with this same
896     // tail at once.  Use PredBB if that is one of the possibilities, as that
897     // will not introduce any extra branches.
898     MachineBasicBlock *EntryBB =
899         &MergePotentials.front().getBlock()->getParent()->front();
900     unsigned commonTailIndex = SameTails.size();
901     // If there are two blocks, check to see if one can be made to fall through
902     // into the other.
903     if (SameTails.size() == 2 &&
904         SameTails[0].getBlock()->isLayoutSuccessor(SameTails[1].getBlock()) &&
905         SameTails[1].tailIsWholeBlock())
906       commonTailIndex = 1;
907     else if (SameTails.size() == 2 &&
908              SameTails[1].getBlock()->isLayoutSuccessor(
909                                                      SameTails[0].getBlock()) &&
910              SameTails[0].tailIsWholeBlock())
911       commonTailIndex = 0;
912     else {
913       // Otherwise just pick one, favoring the fall-through predecessor if
914       // there is one.
915       for (unsigned i = 0, e = SameTails.size(); i != e; ++i) {
916         MachineBasicBlock *MBB = SameTails[i].getBlock();
917         if (MBB == EntryBB && SameTails[i].tailIsWholeBlock())
918           continue;
919         if (MBB == PredBB) {
920           commonTailIndex = i;
921           break;
922         }
923         if (SameTails[i].tailIsWholeBlock())
924           commonTailIndex = i;
925       }
926     }
927 
928     if (commonTailIndex == SameTails.size() ||
929         (SameTails[commonTailIndex].getBlock() == PredBB &&
930          !SameTails[commonTailIndex].tailIsWholeBlock())) {
931       // None of the blocks consist entirely of the common tail.
932       // Split a block so that one does.
933       if (!CreateCommonTailOnlyBlock(PredBB, SuccBB,
934                                      maxCommonTailLength, commonTailIndex)) {
935         RemoveBlocksWithHash(CurHash, SuccBB, PredBB);
936         continue;
937       }
938     }
939 
940     MachineBasicBlock *MBB = SameTails[commonTailIndex].getBlock();
941 
942     // Recompute common tail MBB's edge weights and block frequency.
943     setCommonTailEdgeWeights(*MBB);
944 
945     // MBB is common tail.  Adjust all other BB's to jump to this one.
946     // Traversal must be forwards so erases work.
947     DEBUG(dbgs() << "\nUsing common tail in BB#" << MBB->getNumber()
948                  << " for ");
949     for (unsigned int i=0, e = SameTails.size(); i != e; ++i) {
950       if (commonTailIndex == i)
951         continue;
952       DEBUG(dbgs() << "BB#" << SameTails[i].getBlock()->getNumber()
953                    << (i == e-1 ? "" : ", "));
954       // Merge MMOs from memory operations as needed.
955       mergeMMOsFromMemoryOperations(SameTails[i].getTailStartPos(), *MBB);
956       // Hack the end off BB i, making it jump to BB commonTailIndex instead.
957       ReplaceTailWithBranchTo(SameTails[i].getTailStartPos(), MBB);
958       // BB i is no longer a predecessor of SuccBB; remove it from the worklist.
959       MergePotentials.erase(SameTails[i].getMPIter());
960     }
961     DEBUG(dbgs() << "\n");
962     // We leave commonTailIndex in the worklist in case there are other blocks
963     // that match it with a smaller number of instructions.
964     MadeChange = true;
965   }
966   return MadeChange;
967 }
968 
969 bool BranchFolder::TailMergeBlocks(MachineFunction &MF) {
970   bool MadeChange = false;
971   if (!EnableTailMerge) return MadeChange;
972 
973   // First find blocks with no successors.
974   // Block placement does not create new tail merging opportunities for these
975   // blocks.
976   if (!AfterBlockPlacement) {
977     MergePotentials.clear();
978     for (MachineBasicBlock &MBB : MF) {
979       if (MergePotentials.size() == TailMergeThreshold)
980         break;
981       if (!TriedMerging.count(&MBB) && MBB.succ_empty())
982         MergePotentials.push_back(MergePotentialsElt(HashEndOfMBB(MBB), &MBB));
983     }
984 
985     // If this is a large problem, avoid visiting the same basic blocks
986     // multiple times.
987     if (MergePotentials.size() == TailMergeThreshold)
988       for (unsigned i = 0, e = MergePotentials.size(); i != e; ++i)
989         TriedMerging.insert(MergePotentials[i].getBlock());
990 
991     // See if we can do any tail merging on those.
992     if (MergePotentials.size() >= 2)
993       MadeChange |= TryTailMergeBlocks(nullptr, nullptr, MinCommonTailLength);
994   }
995 
996   // Look at blocks (IBB) with multiple predecessors (PBB).
997   // We change each predecessor to a canonical form, by
998   // (1) temporarily removing any unconditional branch from the predecessor
999   // to IBB, and
1000   // (2) alter conditional branches so they branch to the other block
1001   // not IBB; this may require adding back an unconditional branch to IBB
1002   // later, where there wasn't one coming in.  E.g.
1003   //   Bcc IBB
1004   //   fallthrough to QBB
1005   // here becomes
1006   //   Bncc QBB
1007   // with a conceptual B to IBB after that, which never actually exists.
1008   // With those changes, we see whether the predecessors' tails match,
1009   // and merge them if so.  We change things out of canonical form and
1010   // back to the way they were later in the process.  (OptimizeBranches
1011   // would undo some of this, but we can't use it, because we'd get into
1012   // a compile-time infinite loop repeatedly doing and undoing the same
1013   // transformations.)
1014 
1015   for (MachineFunction::iterator I = std::next(MF.begin()), E = MF.end();
1016        I != E; ++I) {
1017     if (I->pred_size() < 2) continue;
1018     SmallPtrSet<MachineBasicBlock *, 8> UniquePreds;
1019     MachineBasicBlock *IBB = &*I;
1020     MachineBasicBlock *PredBB = &*std::prev(I);
1021     MergePotentials.clear();
1022     MachineLoop *ML;
1023 
1024     // Bail if merging after placement and IBB is the loop header because
1025     // -- If merging predecessors that belong to the same loop as IBB, the
1026     // common tail of merged predecessors may become the loop top if block
1027     // placement is called again and the predecessors may branch to this common
1028     // tail and require more branches. This can be relaxed if
1029     // MachineBlockPlacement::findBestLoopTop is more flexible.
1030     // --If merging predecessors that do not belong to the same loop as IBB, the
1031     // loop info of IBB's loop and the other loops may be affected. Calling the
1032     // block placement again may make big change to the layout and eliminate the
1033     // reason to do tail merging here.
1034     if (AfterBlockPlacement && MLI) {
1035       ML = MLI->getLoopFor(IBB);
1036       if (ML && IBB == ML->getHeader())
1037         continue;
1038     }
1039 
1040     for (MachineBasicBlock *PBB : I->predecessors()) {
1041       if (MergePotentials.size() == TailMergeThreshold)
1042         break;
1043 
1044       if (TriedMerging.count(PBB))
1045         continue;
1046 
1047       // Skip blocks that loop to themselves, can't tail merge these.
1048       if (PBB == IBB)
1049         continue;
1050 
1051       // Visit each predecessor only once.
1052       if (!UniquePreds.insert(PBB).second)
1053         continue;
1054 
1055       // Skip blocks which may jump to a landing pad. Can't tail merge these.
1056       if (PBB->hasEHPadSuccessor())
1057         continue;
1058 
1059       // After block placement, only consider predecessors that belong to the
1060       // same loop as IBB.  The reason is the same as above when skipping loop
1061       // header.
1062       if (AfterBlockPlacement && MLI)
1063         if (ML != MLI->getLoopFor(PBB))
1064           continue;
1065 
1066       MachineBasicBlock *TBB = nullptr, *FBB = nullptr;
1067       SmallVector<MachineOperand, 4> Cond;
1068       if (!TII->analyzeBranch(*PBB, TBB, FBB, Cond, true)) {
1069         // Failing case: IBB is the target of a cbr, and we cannot reverse the
1070         // branch.
1071         SmallVector<MachineOperand, 4> NewCond(Cond);
1072         if (!Cond.empty() && TBB == IBB) {
1073           if (TII->ReverseBranchCondition(NewCond))
1074             continue;
1075           // This is the QBB case described above
1076           if (!FBB) {
1077             auto Next = ++PBB->getIterator();
1078             if (Next != MF.end())
1079               FBB = &*Next;
1080           }
1081         }
1082 
1083         // Failing case: the only way IBB can be reached from PBB is via
1084         // exception handling.  Happens for landing pads.  Would be nice to have
1085         // a bit in the edge so we didn't have to do all this.
1086         if (IBB->isEHPad()) {
1087           MachineFunction::iterator IP = ++PBB->getIterator();
1088           MachineBasicBlock *PredNextBB = nullptr;
1089           if (IP != MF.end())
1090             PredNextBB = &*IP;
1091           if (!TBB) {
1092             if (IBB != PredNextBB)      // fallthrough
1093               continue;
1094           } else if (FBB) {
1095             if (TBB != IBB && FBB != IBB)   // cbr then ubr
1096               continue;
1097           } else if (Cond.empty()) {
1098             if (TBB != IBB)               // ubr
1099               continue;
1100           } else {
1101             if (TBB != IBB && IBB != PredNextBB)  // cbr
1102               continue;
1103           }
1104         }
1105 
1106         // Remove the unconditional branch at the end, if any.
1107         if (TBB && (Cond.empty() || FBB)) {
1108           DebugLoc dl;  // FIXME: this is nowhere
1109           TII->RemoveBranch(*PBB);
1110           if (!Cond.empty())
1111             // reinsert conditional branch only, for now
1112             TII->InsertBranch(*PBB, (TBB == IBB) ? FBB : TBB, nullptr,
1113                               NewCond, dl);
1114         }
1115 
1116         MergePotentials.push_back(MergePotentialsElt(HashEndOfMBB(*PBB), PBB));
1117       }
1118     }
1119 
1120     // If this is a large problem, avoid visiting the same basic blocks multiple
1121     // times.
1122     if (MergePotentials.size() == TailMergeThreshold)
1123       for (unsigned i = 0, e = MergePotentials.size(); i != e; ++i)
1124         TriedMerging.insert(MergePotentials[i].getBlock());
1125 
1126     if (MergePotentials.size() >= 2)
1127       MadeChange |= TryTailMergeBlocks(IBB, PredBB, MinCommonTailLength);
1128 
1129     // Reinsert an unconditional branch if needed. The 1 below can occur as a
1130     // result of removing blocks in TryTailMergeBlocks.
1131     PredBB = &*std::prev(I); // this may have been changed in TryTailMergeBlocks
1132     if (MergePotentials.size() == 1 &&
1133         MergePotentials.begin()->getBlock() != PredBB)
1134       FixTail(MergePotentials.begin()->getBlock(), IBB, TII);
1135   }
1136 
1137   return MadeChange;
1138 }
1139 
1140 void BranchFolder::setCommonTailEdgeWeights(MachineBasicBlock &TailMBB) {
1141   SmallVector<BlockFrequency, 2> EdgeFreqLs(TailMBB.succ_size());
1142   BlockFrequency AccumulatedMBBFreq;
1143 
1144   // Aggregate edge frequency of successor edge j:
1145   //  edgeFreq(j) = sum (freq(bb) * edgeProb(bb, j)),
1146   //  where bb is a basic block that is in SameTails.
1147   for (const auto &Src : SameTails) {
1148     const MachineBasicBlock *SrcMBB = Src.getBlock();
1149     BlockFrequency BlockFreq = MBBFreqInfo.getBlockFreq(SrcMBB);
1150     AccumulatedMBBFreq += BlockFreq;
1151 
1152     // It is not necessary to recompute edge weights if TailBB has less than two
1153     // successors.
1154     if (TailMBB.succ_size() <= 1)
1155       continue;
1156 
1157     auto EdgeFreq = EdgeFreqLs.begin();
1158 
1159     for (auto SuccI = TailMBB.succ_begin(), SuccE = TailMBB.succ_end();
1160          SuccI != SuccE; ++SuccI, ++EdgeFreq)
1161       *EdgeFreq += BlockFreq * MBPI.getEdgeProbability(SrcMBB, *SuccI);
1162   }
1163 
1164   MBBFreqInfo.setBlockFreq(&TailMBB, AccumulatedMBBFreq);
1165 
1166   if (TailMBB.succ_size() <= 1)
1167     return;
1168 
1169   auto SumEdgeFreq =
1170       std::accumulate(EdgeFreqLs.begin(), EdgeFreqLs.end(), BlockFrequency(0))
1171           .getFrequency();
1172   auto EdgeFreq = EdgeFreqLs.begin();
1173 
1174   if (SumEdgeFreq > 0) {
1175     for (auto SuccI = TailMBB.succ_begin(), SuccE = TailMBB.succ_end();
1176          SuccI != SuccE; ++SuccI, ++EdgeFreq) {
1177       auto Prob = BranchProbability::getBranchProbability(
1178           EdgeFreq->getFrequency(), SumEdgeFreq);
1179       TailMBB.setSuccProbability(SuccI, Prob);
1180     }
1181   }
1182 }
1183 
1184 //===----------------------------------------------------------------------===//
1185 //  Branch Optimization
1186 //===----------------------------------------------------------------------===//
1187 
1188 bool BranchFolder::OptimizeBranches(MachineFunction &MF) {
1189   bool MadeChange = false;
1190 
1191   // Make sure blocks are numbered in order
1192   MF.RenumberBlocks();
1193   // Renumbering blocks alters funclet membership, recalculate it.
1194   FuncletMembership = getFuncletMembership(MF);
1195 
1196   for (MachineFunction::iterator I = std::next(MF.begin()), E = MF.end();
1197        I != E; ) {
1198     MachineBasicBlock *MBB = &*I++;
1199     MadeChange |= OptimizeBlock(MBB);
1200 
1201     // If it is dead, remove it.
1202     if (MBB->pred_empty()) {
1203       RemoveDeadBlock(MBB);
1204       MadeChange = true;
1205       ++NumDeadBlocks;
1206     }
1207   }
1208 
1209   return MadeChange;
1210 }
1211 
1212 // Blocks should be considered empty if they contain only debug info;
1213 // else the debug info would affect codegen.
1214 static bool IsEmptyBlock(MachineBasicBlock *MBB) {
1215   return MBB->getFirstNonDebugInstr() == MBB->end();
1216 }
1217 
1218 // Blocks with only debug info and branches should be considered the same
1219 // as blocks with only branches.
1220 static bool IsBranchOnlyBlock(MachineBasicBlock *MBB) {
1221   MachineBasicBlock::iterator I = MBB->getFirstNonDebugInstr();
1222   assert(I != MBB->end() && "empty block!");
1223   return I->isBranch();
1224 }
1225 
1226 /// IsBetterFallthrough - Return true if it would be clearly better to
1227 /// fall-through to MBB1 than to fall through into MBB2.  This has to return
1228 /// a strict ordering, returning true for both (MBB1,MBB2) and (MBB2,MBB1) will
1229 /// result in infinite loops.
1230 static bool IsBetterFallthrough(MachineBasicBlock *MBB1,
1231                                 MachineBasicBlock *MBB2) {
1232   // Right now, we use a simple heuristic.  If MBB2 ends with a call, and
1233   // MBB1 doesn't, we prefer to fall through into MBB1.  This allows us to
1234   // optimize branches that branch to either a return block or an assert block
1235   // into a fallthrough to the return.
1236   MachineBasicBlock::iterator MBB1I = MBB1->getLastNonDebugInstr();
1237   MachineBasicBlock::iterator MBB2I = MBB2->getLastNonDebugInstr();
1238   if (MBB1I == MBB1->end() || MBB2I == MBB2->end())
1239     return false;
1240 
1241   // If there is a clear successor ordering we make sure that one block
1242   // will fall through to the next
1243   if (MBB1->isSuccessor(MBB2)) return true;
1244   if (MBB2->isSuccessor(MBB1)) return false;
1245 
1246   return MBB2I->isCall() && !MBB1I->isCall();
1247 }
1248 
1249 /// getBranchDebugLoc - Find and return, if any, the DebugLoc of the branch
1250 /// instructions on the block.
1251 static DebugLoc getBranchDebugLoc(MachineBasicBlock &MBB) {
1252   MachineBasicBlock::iterator I = MBB.getLastNonDebugInstr();
1253   if (I != MBB.end() && I->isBranch())
1254     return I->getDebugLoc();
1255   return DebugLoc();
1256 }
1257 
1258 /// OptimizeBlock - Analyze and optimize control flow related to the specified
1259 /// block.  This is never called on the entry block.
1260 bool BranchFolder::OptimizeBlock(MachineBasicBlock *MBB) {
1261   bool MadeChange = false;
1262   MachineFunction &MF = *MBB->getParent();
1263 ReoptimizeBlock:
1264 
1265   MachineFunction::iterator FallThrough = MBB->getIterator();
1266   ++FallThrough;
1267 
1268   // Make sure MBB and FallThrough belong to the same funclet.
1269   bool SameFunclet = true;
1270   if (!FuncletMembership.empty() && FallThrough != MF.end()) {
1271     auto MBBFunclet = FuncletMembership.find(MBB);
1272     assert(MBBFunclet != FuncletMembership.end());
1273     auto FallThroughFunclet = FuncletMembership.find(&*FallThrough);
1274     assert(FallThroughFunclet != FuncletMembership.end());
1275     SameFunclet = MBBFunclet->second == FallThroughFunclet->second;
1276   }
1277 
1278   // If this block is empty, make everyone use its fall-through, not the block
1279   // explicitly.  Landing pads should not do this since the landing-pad table
1280   // points to this block.  Blocks with their addresses taken shouldn't be
1281   // optimized away.
1282   if (IsEmptyBlock(MBB) && !MBB->isEHPad() && !MBB->hasAddressTaken() &&
1283       SameFunclet) {
1284     // Dead block?  Leave for cleanup later.
1285     if (MBB->pred_empty()) return MadeChange;
1286 
1287     if (FallThrough == MF.end()) {
1288       // TODO: Simplify preds to not branch here if possible!
1289     } else if (FallThrough->isEHPad()) {
1290       // Don't rewrite to a landing pad fallthough.  That could lead to the case
1291       // where a BB jumps to more than one landing pad.
1292       // TODO: Is it ever worth rewriting predecessors which don't already
1293       // jump to a landing pad, and so can safely jump to the fallthrough?
1294     } else if (MBB->isSuccessor(&*FallThrough)) {
1295       // Rewrite all predecessors of the old block to go to the fallthrough
1296       // instead.
1297       while (!MBB->pred_empty()) {
1298         MachineBasicBlock *Pred = *(MBB->pred_end()-1);
1299         Pred->ReplaceUsesOfBlockWith(MBB, &*FallThrough);
1300       }
1301       // If MBB was the target of a jump table, update jump tables to go to the
1302       // fallthrough instead.
1303       if (MachineJumpTableInfo *MJTI = MF.getJumpTableInfo())
1304         MJTI->ReplaceMBBInJumpTables(MBB, &*FallThrough);
1305       MadeChange = true;
1306     }
1307     return MadeChange;
1308   }
1309 
1310   // Check to see if we can simplify the terminator of the block before this
1311   // one.
1312   MachineBasicBlock &PrevBB = *std::prev(MachineFunction::iterator(MBB));
1313 
1314   MachineBasicBlock *PriorTBB = nullptr, *PriorFBB = nullptr;
1315   SmallVector<MachineOperand, 4> PriorCond;
1316   bool PriorUnAnalyzable =
1317       TII->analyzeBranch(PrevBB, PriorTBB, PriorFBB, PriorCond, true);
1318   if (!PriorUnAnalyzable) {
1319     // If the CFG for the prior block has extra edges, remove them.
1320     MadeChange |= PrevBB.CorrectExtraCFGEdges(PriorTBB, PriorFBB,
1321                                               !PriorCond.empty());
1322 
1323     // If the previous branch is conditional and both conditions go to the same
1324     // destination, remove the branch, replacing it with an unconditional one or
1325     // a fall-through.
1326     if (PriorTBB && PriorTBB == PriorFBB) {
1327       DebugLoc dl = getBranchDebugLoc(PrevBB);
1328       TII->RemoveBranch(PrevBB);
1329       PriorCond.clear();
1330       if (PriorTBB != MBB)
1331         TII->InsertBranch(PrevBB, PriorTBB, nullptr, PriorCond, dl);
1332       MadeChange = true;
1333       ++NumBranchOpts;
1334       goto ReoptimizeBlock;
1335     }
1336 
1337     // If the previous block unconditionally falls through to this block and
1338     // this block has no other predecessors, move the contents of this block
1339     // into the prior block. This doesn't usually happen when SimplifyCFG
1340     // has been used, but it can happen if tail merging splits a fall-through
1341     // predecessor of a block.
1342     // This has to check PrevBB->succ_size() because EH edges are ignored by
1343     // AnalyzeBranch.
1344     if (PriorCond.empty() && !PriorTBB && MBB->pred_size() == 1 &&
1345         PrevBB.succ_size() == 1 &&
1346         !MBB->hasAddressTaken() && !MBB->isEHPad()) {
1347       DEBUG(dbgs() << "\nMerging into block: " << PrevBB
1348                    << "From MBB: " << *MBB);
1349       // Remove redundant DBG_VALUEs first.
1350       if (PrevBB.begin() != PrevBB.end()) {
1351         MachineBasicBlock::iterator PrevBBIter = PrevBB.end();
1352         --PrevBBIter;
1353         MachineBasicBlock::iterator MBBIter = MBB->begin();
1354         // Check if DBG_VALUE at the end of PrevBB is identical to the
1355         // DBG_VALUE at the beginning of MBB.
1356         while (PrevBBIter != PrevBB.begin() && MBBIter != MBB->end()
1357                && PrevBBIter->isDebugValue() && MBBIter->isDebugValue()) {
1358           if (!MBBIter->isIdenticalTo(*PrevBBIter))
1359             break;
1360           MachineInstr &DuplicateDbg = *MBBIter;
1361           ++MBBIter; -- PrevBBIter;
1362           DuplicateDbg.eraseFromParent();
1363         }
1364       }
1365       PrevBB.splice(PrevBB.end(), MBB, MBB->begin(), MBB->end());
1366       PrevBB.removeSuccessor(PrevBB.succ_begin());
1367       assert(PrevBB.succ_empty());
1368       PrevBB.transferSuccessors(MBB);
1369       MadeChange = true;
1370       return MadeChange;
1371     }
1372 
1373     // If the previous branch *only* branches to *this* block (conditional or
1374     // not) remove the branch.
1375     if (PriorTBB == MBB && !PriorFBB) {
1376       TII->RemoveBranch(PrevBB);
1377       MadeChange = true;
1378       ++NumBranchOpts;
1379       goto ReoptimizeBlock;
1380     }
1381 
1382     // If the prior block branches somewhere else on the condition and here if
1383     // the condition is false, remove the uncond second branch.
1384     if (PriorFBB == MBB) {
1385       DebugLoc dl = getBranchDebugLoc(PrevBB);
1386       TII->RemoveBranch(PrevBB);
1387       TII->InsertBranch(PrevBB, PriorTBB, nullptr, PriorCond, dl);
1388       MadeChange = true;
1389       ++NumBranchOpts;
1390       goto ReoptimizeBlock;
1391     }
1392 
1393     // If the prior block branches here on true and somewhere else on false, and
1394     // if the branch condition is reversible, reverse the branch to create a
1395     // fall-through.
1396     if (PriorTBB == MBB) {
1397       SmallVector<MachineOperand, 4> NewPriorCond(PriorCond);
1398       if (!TII->ReverseBranchCondition(NewPriorCond)) {
1399         DebugLoc dl = getBranchDebugLoc(PrevBB);
1400         TII->RemoveBranch(PrevBB);
1401         TII->InsertBranch(PrevBB, PriorFBB, nullptr, NewPriorCond, dl);
1402         MadeChange = true;
1403         ++NumBranchOpts;
1404         goto ReoptimizeBlock;
1405       }
1406     }
1407 
1408     // If this block has no successors (e.g. it is a return block or ends with
1409     // a call to a no-return function like abort or __cxa_throw) and if the pred
1410     // falls through into this block, and if it would otherwise fall through
1411     // into the block after this, move this block to the end of the function.
1412     //
1413     // We consider it more likely that execution will stay in the function (e.g.
1414     // due to loops) than it is to exit it.  This asserts in loops etc, moving
1415     // the assert condition out of the loop body.
1416     if (MBB->succ_empty() && !PriorCond.empty() && !PriorFBB &&
1417         MachineFunction::iterator(PriorTBB) == FallThrough &&
1418         !MBB->canFallThrough()) {
1419       bool DoTransform = true;
1420 
1421       // We have to be careful that the succs of PredBB aren't both no-successor
1422       // blocks.  If neither have successors and if PredBB is the second from
1423       // last block in the function, we'd just keep swapping the two blocks for
1424       // last.  Only do the swap if one is clearly better to fall through than
1425       // the other.
1426       if (FallThrough == --MF.end() &&
1427           !IsBetterFallthrough(PriorTBB, MBB))
1428         DoTransform = false;
1429 
1430       if (DoTransform) {
1431         // Reverse the branch so we will fall through on the previous true cond.
1432         SmallVector<MachineOperand, 4> NewPriorCond(PriorCond);
1433         if (!TII->ReverseBranchCondition(NewPriorCond)) {
1434           DEBUG(dbgs() << "\nMoving MBB: " << *MBB
1435                        << "To make fallthrough to: " << *PriorTBB << "\n");
1436 
1437           DebugLoc dl = getBranchDebugLoc(PrevBB);
1438           TII->RemoveBranch(PrevBB);
1439           TII->InsertBranch(PrevBB, MBB, nullptr, NewPriorCond, dl);
1440 
1441           // Move this block to the end of the function.
1442           MBB->moveAfter(&MF.back());
1443           MadeChange = true;
1444           ++NumBranchOpts;
1445           return MadeChange;
1446         }
1447       }
1448     }
1449   }
1450 
1451   // Analyze the branch in the current block.
1452   MachineBasicBlock *CurTBB = nullptr, *CurFBB = nullptr;
1453   SmallVector<MachineOperand, 4> CurCond;
1454   bool CurUnAnalyzable =
1455       TII->analyzeBranch(*MBB, CurTBB, CurFBB, CurCond, true);
1456   if (!CurUnAnalyzable) {
1457     // If the CFG for the prior block has extra edges, remove them.
1458     MadeChange |= MBB->CorrectExtraCFGEdges(CurTBB, CurFBB, !CurCond.empty());
1459 
1460     // If this is a two-way branch, and the FBB branches to this block, reverse
1461     // the condition so the single-basic-block loop is faster.  Instead of:
1462     //    Loop: xxx; jcc Out; jmp Loop
1463     // we want:
1464     //    Loop: xxx; jncc Loop; jmp Out
1465     if (CurTBB && CurFBB && CurFBB == MBB && CurTBB != MBB) {
1466       SmallVector<MachineOperand, 4> NewCond(CurCond);
1467       if (!TII->ReverseBranchCondition(NewCond)) {
1468         DebugLoc dl = getBranchDebugLoc(*MBB);
1469         TII->RemoveBranch(*MBB);
1470         TII->InsertBranch(*MBB, CurFBB, CurTBB, NewCond, dl);
1471         MadeChange = true;
1472         ++NumBranchOpts;
1473         goto ReoptimizeBlock;
1474       }
1475     }
1476 
1477     // If this branch is the only thing in its block, see if we can forward
1478     // other blocks across it.
1479     if (CurTBB && CurCond.empty() && !CurFBB &&
1480         IsBranchOnlyBlock(MBB) && CurTBB != MBB &&
1481         !MBB->hasAddressTaken() && !MBB->isEHPad()) {
1482       DebugLoc dl = getBranchDebugLoc(*MBB);
1483       // This block may contain just an unconditional branch.  Because there can
1484       // be 'non-branch terminators' in the block, try removing the branch and
1485       // then seeing if the block is empty.
1486       TII->RemoveBranch(*MBB);
1487       // If the only things remaining in the block are debug info, remove these
1488       // as well, so this will behave the same as an empty block in non-debug
1489       // mode.
1490       if (IsEmptyBlock(MBB)) {
1491         // Make the block empty, losing the debug info (we could probably
1492         // improve this in some cases.)
1493         MBB->erase(MBB->begin(), MBB->end());
1494       }
1495       // If this block is just an unconditional branch to CurTBB, we can
1496       // usually completely eliminate the block.  The only case we cannot
1497       // completely eliminate the block is when the block before this one
1498       // falls through into MBB and we can't understand the prior block's branch
1499       // condition.
1500       if (MBB->empty()) {
1501         bool PredHasNoFallThrough = !PrevBB.canFallThrough();
1502         if (PredHasNoFallThrough || !PriorUnAnalyzable ||
1503             !PrevBB.isSuccessor(MBB)) {
1504           // If the prior block falls through into us, turn it into an
1505           // explicit branch to us to make updates simpler.
1506           if (!PredHasNoFallThrough && PrevBB.isSuccessor(MBB) &&
1507               PriorTBB != MBB && PriorFBB != MBB) {
1508             if (!PriorTBB) {
1509               assert(PriorCond.empty() && !PriorFBB &&
1510                      "Bad branch analysis");
1511               PriorTBB = MBB;
1512             } else {
1513               assert(!PriorFBB && "Machine CFG out of date!");
1514               PriorFBB = MBB;
1515             }
1516             DebugLoc pdl = getBranchDebugLoc(PrevBB);
1517             TII->RemoveBranch(PrevBB);
1518             TII->InsertBranch(PrevBB, PriorTBB, PriorFBB, PriorCond, pdl);
1519           }
1520 
1521           // Iterate through all the predecessors, revectoring each in-turn.
1522           size_t PI = 0;
1523           bool DidChange = false;
1524           bool HasBranchToSelf = false;
1525           while(PI != MBB->pred_size()) {
1526             MachineBasicBlock *PMBB = *(MBB->pred_begin() + PI);
1527             if (PMBB == MBB) {
1528               // If this block has an uncond branch to itself, leave it.
1529               ++PI;
1530               HasBranchToSelf = true;
1531             } else {
1532               DidChange = true;
1533               PMBB->ReplaceUsesOfBlockWith(MBB, CurTBB);
1534               // If this change resulted in PMBB ending in a conditional
1535               // branch where both conditions go to the same destination,
1536               // change this to an unconditional branch (and fix the CFG).
1537               MachineBasicBlock *NewCurTBB = nullptr, *NewCurFBB = nullptr;
1538               SmallVector<MachineOperand, 4> NewCurCond;
1539               bool NewCurUnAnalyzable = TII->analyzeBranch(
1540                   *PMBB, NewCurTBB, NewCurFBB, NewCurCond, true);
1541               if (!NewCurUnAnalyzable && NewCurTBB && NewCurTBB == NewCurFBB) {
1542                 DebugLoc pdl = getBranchDebugLoc(*PMBB);
1543                 TII->RemoveBranch(*PMBB);
1544                 NewCurCond.clear();
1545                 TII->InsertBranch(*PMBB, NewCurTBB, nullptr, NewCurCond, pdl);
1546                 MadeChange = true;
1547                 ++NumBranchOpts;
1548                 PMBB->CorrectExtraCFGEdges(NewCurTBB, nullptr, false);
1549               }
1550             }
1551           }
1552 
1553           // Change any jumptables to go to the new MBB.
1554           if (MachineJumpTableInfo *MJTI = MF.getJumpTableInfo())
1555             MJTI->ReplaceMBBInJumpTables(MBB, CurTBB);
1556           if (DidChange) {
1557             ++NumBranchOpts;
1558             MadeChange = true;
1559             if (!HasBranchToSelf) return MadeChange;
1560           }
1561         }
1562       }
1563 
1564       // Add the branch back if the block is more than just an uncond branch.
1565       TII->InsertBranch(*MBB, CurTBB, nullptr, CurCond, dl);
1566     }
1567   }
1568 
1569   // If the prior block doesn't fall through into this block, and if this
1570   // block doesn't fall through into some other block, see if we can find a
1571   // place to move this block where a fall-through will happen.
1572   if (!PrevBB.canFallThrough()) {
1573 
1574     // Now we know that there was no fall-through into this block, check to
1575     // see if it has a fall-through into its successor.
1576     bool CurFallsThru = MBB->canFallThrough();
1577 
1578     if (!MBB->isEHPad()) {
1579       // Check all the predecessors of this block.  If one of them has no fall
1580       // throughs, move this block right after it.
1581       for (MachineBasicBlock *PredBB : MBB->predecessors()) {
1582         // Analyze the branch at the end of the pred.
1583         MachineBasicBlock *PredTBB = nullptr, *PredFBB = nullptr;
1584         SmallVector<MachineOperand, 4> PredCond;
1585         if (PredBB != MBB && !PredBB->canFallThrough() &&
1586             !TII->analyzeBranch(*PredBB, PredTBB, PredFBB, PredCond, true) &&
1587             (!CurFallsThru || !CurTBB || !CurFBB) &&
1588             (!CurFallsThru || MBB->getNumber() >= PredBB->getNumber())) {
1589           // If the current block doesn't fall through, just move it.
1590           // If the current block can fall through and does not end with a
1591           // conditional branch, we need to append an unconditional jump to
1592           // the (current) next block.  To avoid a possible compile-time
1593           // infinite loop, move blocks only backward in this case.
1594           // Also, if there are already 2 branches here, we cannot add a third;
1595           // this means we have the case
1596           // Bcc next
1597           // B elsewhere
1598           // next:
1599           if (CurFallsThru) {
1600             MachineBasicBlock *NextBB = &*std::next(MBB->getIterator());
1601             CurCond.clear();
1602             TII->InsertBranch(*MBB, NextBB, nullptr, CurCond, DebugLoc());
1603           }
1604           MBB->moveAfter(PredBB);
1605           MadeChange = true;
1606           goto ReoptimizeBlock;
1607         }
1608       }
1609     }
1610 
1611     if (!CurFallsThru) {
1612       // Check all successors to see if we can move this block before it.
1613       for (MachineBasicBlock *SuccBB : MBB->successors()) {
1614         // Analyze the branch at the end of the block before the succ.
1615         MachineFunction::iterator SuccPrev = --SuccBB->getIterator();
1616 
1617         // If this block doesn't already fall-through to that successor, and if
1618         // the succ doesn't already have a block that can fall through into it,
1619         // and if the successor isn't an EH destination, we can arrange for the
1620         // fallthrough to happen.
1621         if (SuccBB != MBB && &*SuccPrev != MBB &&
1622             !SuccPrev->canFallThrough() && !CurUnAnalyzable &&
1623             !SuccBB->isEHPad()) {
1624           MBB->moveBefore(SuccBB);
1625           MadeChange = true;
1626           goto ReoptimizeBlock;
1627         }
1628       }
1629 
1630       // Okay, there is no really great place to put this block.  If, however,
1631       // the block before this one would be a fall-through if this block were
1632       // removed, move this block to the end of the function.
1633       MachineBasicBlock *PrevTBB = nullptr, *PrevFBB = nullptr;
1634       SmallVector<MachineOperand, 4> PrevCond;
1635       if (FallThrough != MF.end() &&
1636           !TII->analyzeBranch(PrevBB, PrevTBB, PrevFBB, PrevCond, true) &&
1637           PrevBB.isSuccessor(&*FallThrough)) {
1638         MBB->moveAfter(&MF.back());
1639         MadeChange = true;
1640         return MadeChange;
1641       }
1642     }
1643   }
1644 
1645   return MadeChange;
1646 }
1647 
1648 //===----------------------------------------------------------------------===//
1649 //  Hoist Common Code
1650 //===----------------------------------------------------------------------===//
1651 
1652 /// HoistCommonCode - Hoist common instruction sequences at the start of basic
1653 /// blocks to their common predecessor.
1654 bool BranchFolder::HoistCommonCode(MachineFunction &MF) {
1655   bool MadeChange = false;
1656   for (MachineFunction::iterator I = MF.begin(), E = MF.end(); I != E; ) {
1657     MachineBasicBlock *MBB = &*I++;
1658     MadeChange |= HoistCommonCodeInSuccs(MBB);
1659   }
1660 
1661   return MadeChange;
1662 }
1663 
1664 /// findFalseBlock - BB has a fallthrough. Find its 'false' successor given
1665 /// its 'true' successor.
1666 static MachineBasicBlock *findFalseBlock(MachineBasicBlock *BB,
1667                                          MachineBasicBlock *TrueBB) {
1668   for (MachineBasicBlock *SuccBB : BB->successors())
1669     if (SuccBB != TrueBB)
1670       return SuccBB;
1671   return nullptr;
1672 }
1673 
1674 template <class Container>
1675 static void addRegAndItsAliases(unsigned Reg, const TargetRegisterInfo *TRI,
1676                                 Container &Set) {
1677   if (TargetRegisterInfo::isPhysicalRegister(Reg)) {
1678     for (MCRegAliasIterator AI(Reg, TRI, true); AI.isValid(); ++AI)
1679       Set.insert(*AI);
1680   } else {
1681     Set.insert(Reg);
1682   }
1683 }
1684 
1685 /// findHoistingInsertPosAndDeps - Find the location to move common instructions
1686 /// in successors to. The location is usually just before the terminator,
1687 /// however if the terminator is a conditional branch and its previous
1688 /// instruction is the flag setting instruction, the previous instruction is
1689 /// the preferred location. This function also gathers uses and defs of the
1690 /// instructions from the insertion point to the end of the block. The data is
1691 /// used by HoistCommonCodeInSuccs to ensure safety.
1692 static
1693 MachineBasicBlock::iterator findHoistingInsertPosAndDeps(MachineBasicBlock *MBB,
1694                                                   const TargetInstrInfo *TII,
1695                                                   const TargetRegisterInfo *TRI,
1696                                                   SmallSet<unsigned,4> &Uses,
1697                                                   SmallSet<unsigned,4> &Defs) {
1698   MachineBasicBlock::iterator Loc = MBB->getFirstTerminator();
1699   if (!TII->isUnpredicatedTerminator(*Loc))
1700     return MBB->end();
1701 
1702   for (const MachineOperand &MO : Loc->operands()) {
1703     if (!MO.isReg())
1704       continue;
1705     unsigned Reg = MO.getReg();
1706     if (!Reg)
1707       continue;
1708     if (MO.isUse()) {
1709       addRegAndItsAliases(Reg, TRI, Uses);
1710     } else {
1711       if (!MO.isDead())
1712         // Don't try to hoist code in the rare case the terminator defines a
1713         // register that is later used.
1714         return MBB->end();
1715 
1716       // If the terminator defines a register, make sure we don't hoist
1717       // the instruction whose def might be clobbered by the terminator.
1718       addRegAndItsAliases(Reg, TRI, Defs);
1719     }
1720   }
1721 
1722   if (Uses.empty())
1723     return Loc;
1724   if (Loc == MBB->begin())
1725     return MBB->end();
1726 
1727   // The terminator is probably a conditional branch, try not to separate the
1728   // branch from condition setting instruction.
1729   MachineBasicBlock::iterator PI = Loc;
1730   --PI;
1731   while (PI != MBB->begin() && PI->isDebugValue())
1732     --PI;
1733 
1734   bool IsDef = false;
1735   for (const MachineOperand &MO : PI->operands()) {
1736     // If PI has a regmask operand, it is probably a call. Separate away.
1737     if (MO.isRegMask())
1738       return Loc;
1739     if (!MO.isReg() || MO.isUse())
1740       continue;
1741     unsigned Reg = MO.getReg();
1742     if (!Reg)
1743       continue;
1744     if (Uses.count(Reg)) {
1745       IsDef = true;
1746       break;
1747     }
1748   }
1749   if (!IsDef)
1750     // The condition setting instruction is not just before the conditional
1751     // branch.
1752     return Loc;
1753 
1754   // Be conservative, don't insert instruction above something that may have
1755   // side-effects. And since it's potentially bad to separate flag setting
1756   // instruction from the conditional branch, just abort the optimization
1757   // completely.
1758   // Also avoid moving code above predicated instruction since it's hard to
1759   // reason about register liveness with predicated instruction.
1760   bool DontMoveAcrossStore = true;
1761   if (!PI->isSafeToMove(nullptr, DontMoveAcrossStore) || TII->isPredicated(*PI))
1762     return MBB->end();
1763 
1764 
1765   // Find out what registers are live. Note this routine is ignoring other live
1766   // registers which are only used by instructions in successor blocks.
1767   for (const MachineOperand &MO : PI->operands()) {
1768     if (!MO.isReg())
1769       continue;
1770     unsigned Reg = MO.getReg();
1771     if (!Reg)
1772       continue;
1773     if (MO.isUse()) {
1774       addRegAndItsAliases(Reg, TRI, Uses);
1775     } else {
1776       if (Uses.erase(Reg)) {
1777         if (TargetRegisterInfo::isPhysicalRegister(Reg)) {
1778           for (MCSubRegIterator SubRegs(Reg, TRI); SubRegs.isValid(); ++SubRegs)
1779             Uses.erase(*SubRegs); // Use sub-registers to be conservative
1780         }
1781       }
1782       addRegAndItsAliases(Reg, TRI, Defs);
1783     }
1784   }
1785 
1786   return PI;
1787 }
1788 
1789 /// HoistCommonCodeInSuccs - If the successors of MBB has common instruction
1790 /// sequence at the start of the function, move the instructions before MBB
1791 /// terminator if it's legal.
1792 bool BranchFolder::HoistCommonCodeInSuccs(MachineBasicBlock *MBB) {
1793   MachineBasicBlock *TBB = nullptr, *FBB = nullptr;
1794   SmallVector<MachineOperand, 4> Cond;
1795   if (TII->analyzeBranch(*MBB, TBB, FBB, Cond, true) || !TBB || Cond.empty())
1796     return false;
1797 
1798   if (!FBB) FBB = findFalseBlock(MBB, TBB);
1799   if (!FBB)
1800     // Malformed bcc? True and false blocks are the same?
1801     return false;
1802 
1803   // Restrict the optimization to cases where MBB is the only predecessor,
1804   // it is an obvious win.
1805   if (TBB->pred_size() > 1 || FBB->pred_size() > 1)
1806     return false;
1807 
1808   // Find a suitable position to hoist the common instructions to. Also figure
1809   // out which registers are used or defined by instructions from the insertion
1810   // point to the end of the block.
1811   SmallSet<unsigned, 4> Uses, Defs;
1812   MachineBasicBlock::iterator Loc =
1813     findHoistingInsertPosAndDeps(MBB, TII, TRI, Uses, Defs);
1814   if (Loc == MBB->end())
1815     return false;
1816 
1817   bool HasDups = false;
1818   SmallVector<unsigned, 4> LocalDefs;
1819   SmallSet<unsigned, 4> LocalDefsSet;
1820   MachineBasicBlock::iterator TIB = TBB->begin();
1821   MachineBasicBlock::iterator FIB = FBB->begin();
1822   MachineBasicBlock::iterator TIE = TBB->end();
1823   MachineBasicBlock::iterator FIE = FBB->end();
1824   while (TIB != TIE && FIB != FIE) {
1825     // Skip dbg_value instructions. These do not count.
1826     if (TIB->isDebugValue()) {
1827       while (TIB != TIE && TIB->isDebugValue())
1828         ++TIB;
1829       if (TIB == TIE)
1830         break;
1831     }
1832     if (FIB->isDebugValue()) {
1833       while (FIB != FIE && FIB->isDebugValue())
1834         ++FIB;
1835       if (FIB == FIE)
1836         break;
1837     }
1838     if (!TIB->isIdenticalTo(*FIB, MachineInstr::CheckKillDead))
1839       break;
1840 
1841     if (TII->isPredicated(*TIB))
1842       // Hard to reason about register liveness with predicated instruction.
1843       break;
1844 
1845     bool IsSafe = true;
1846     for (MachineOperand &MO : TIB->operands()) {
1847       // Don't attempt to hoist instructions with register masks.
1848       if (MO.isRegMask()) {
1849         IsSafe = false;
1850         break;
1851       }
1852       if (!MO.isReg())
1853         continue;
1854       unsigned Reg = MO.getReg();
1855       if (!Reg)
1856         continue;
1857       if (MO.isDef()) {
1858         if (Uses.count(Reg)) {
1859           // Avoid clobbering a register that's used by the instruction at
1860           // the point of insertion.
1861           IsSafe = false;
1862           break;
1863         }
1864 
1865         if (Defs.count(Reg) && !MO.isDead()) {
1866           // Don't hoist the instruction if the def would be clobber by the
1867           // instruction at the point insertion. FIXME: This is overly
1868           // conservative. It should be possible to hoist the instructions
1869           // in BB2 in the following example:
1870           // BB1:
1871           // r1, eflag = op1 r2, r3
1872           // brcc eflag
1873           //
1874           // BB2:
1875           // r1 = op2, ...
1876           //    = op3, r1<kill>
1877           IsSafe = false;
1878           break;
1879         }
1880       } else if (!LocalDefsSet.count(Reg)) {
1881         if (Defs.count(Reg)) {
1882           // Use is defined by the instruction at the point of insertion.
1883           IsSafe = false;
1884           break;
1885         }
1886 
1887         if (MO.isKill() && Uses.count(Reg))
1888           // Kills a register that's read by the instruction at the point of
1889           // insertion. Remove the kill marker.
1890           MO.setIsKill(false);
1891       }
1892     }
1893     if (!IsSafe)
1894       break;
1895 
1896     bool DontMoveAcrossStore = true;
1897     if (!TIB->isSafeToMove(nullptr, DontMoveAcrossStore))
1898       break;
1899 
1900     // Remove kills from LocalDefsSet, these registers had short live ranges.
1901     for (const MachineOperand &MO : TIB->operands()) {
1902       if (!MO.isReg() || !MO.isUse() || !MO.isKill())
1903         continue;
1904       unsigned Reg = MO.getReg();
1905       if (!Reg || !LocalDefsSet.count(Reg))
1906         continue;
1907       if (TargetRegisterInfo::isPhysicalRegister(Reg)) {
1908         for (MCRegAliasIterator AI(Reg, TRI, true); AI.isValid(); ++AI)
1909           LocalDefsSet.erase(*AI);
1910       } else {
1911         LocalDefsSet.erase(Reg);
1912       }
1913     }
1914 
1915     // Track local defs so we can update liveins.
1916     for (const MachineOperand &MO : TIB->operands()) {
1917       if (!MO.isReg() || !MO.isDef() || MO.isDead())
1918         continue;
1919       unsigned Reg = MO.getReg();
1920       if (!Reg || TargetRegisterInfo::isVirtualRegister(Reg))
1921         continue;
1922       LocalDefs.push_back(Reg);
1923       addRegAndItsAliases(Reg, TRI, LocalDefsSet);
1924     }
1925 
1926     HasDups = true;
1927     ++TIB;
1928     ++FIB;
1929   }
1930 
1931   if (!HasDups)
1932     return false;
1933 
1934   MBB->splice(Loc, TBB, TBB->begin(), TIB);
1935   FBB->erase(FBB->begin(), FIB);
1936 
1937   // Update livein's.
1938   for (unsigned i = 0, e = LocalDefs.size(); i != e; ++i) {
1939     unsigned Def = LocalDefs[i];
1940     if (LocalDefsSet.count(Def)) {
1941       TBB->addLiveIn(Def);
1942       FBB->addLiveIn(Def);
1943     }
1944   }
1945 
1946   ++NumHoist;
1947   return true;
1948 }
1949