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