1 //===-- EarlyIfConversion.cpp - If-conversion on SSA form machine code ----===//
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 // Early if-conversion is for out-of-order CPUs that don't have a lot of
11 // predicable instructions. The goal is to eliminate conditional branches that
12 // may mispredict.
13 //
14 // Instructions from both sides of the branch are executed specutatively, and a
15 // cmov instruction selects the result.
16 //
17 //===----------------------------------------------------------------------===//
18 
19 #include "llvm/ADT/BitVector.h"
20 #include "llvm/ADT/PostOrderIterator.h"
21 #include "llvm/ADT/SetVector.h"
22 #include "llvm/ADT/SmallPtrSet.h"
23 #include "llvm/ADT/SparseSet.h"
24 #include "llvm/ADT/Statistic.h"
25 #include "llvm/CodeGen/MachineBranchProbabilityInfo.h"
26 #include "llvm/CodeGen/MachineDominators.h"
27 #include "llvm/CodeGen/MachineFunction.h"
28 #include "llvm/CodeGen/MachineFunctionPass.h"
29 #include "llvm/CodeGen/MachineLoopInfo.h"
30 #include "llvm/CodeGen/MachineRegisterInfo.h"
31 #include "llvm/CodeGen/MachineTraceMetrics.h"
32 #include "llvm/CodeGen/Passes.h"
33 #include "llvm/Support/CommandLine.h"
34 #include "llvm/Support/Debug.h"
35 #include "llvm/Support/raw_ostream.h"
36 #include "llvm/Target/TargetInstrInfo.h"
37 #include "llvm/Target/TargetRegisterInfo.h"
38 #include "llvm/Target/TargetSubtargetInfo.h"
39 
40 using namespace llvm;
41 
42 #define DEBUG_TYPE "early-ifcvt"
43 
44 // Absolute maximum number of instructions allowed per speculated block.
45 // This bypasses all other heuristics, so it should be set fairly high.
46 static cl::opt<unsigned>
47 BlockInstrLimit("early-ifcvt-limit", cl::init(30), cl::Hidden,
48   cl::desc("Maximum number of instructions per speculated block."));
49 
50 // Stress testing mode - disable heuristics.
51 static cl::opt<bool> Stress("stress-early-ifcvt", cl::Hidden,
52   cl::desc("Turn all knobs to 11"));
53 
54 STATISTIC(NumDiamondsSeen,  "Number of diamonds");
55 STATISTIC(NumDiamondsConv,  "Number of diamonds converted");
56 STATISTIC(NumTrianglesSeen, "Number of triangles");
57 STATISTIC(NumTrianglesConv, "Number of triangles converted");
58 
59 //===----------------------------------------------------------------------===//
60 //                                 SSAIfConv
61 //===----------------------------------------------------------------------===//
62 //
63 // The SSAIfConv class performs if-conversion on SSA form machine code after
64 // determining if it is possible. The class contains no heuristics; external
65 // code should be used to determine when if-conversion is a good idea.
66 //
67 // SSAIfConv can convert both triangles and diamonds:
68 //
69 //   Triangle: Head              Diamond: Head
70 //              | \                       /  \_
71 //              |  \                     /    |
72 //              |  [TF]BB              FBB    TBB
73 //              |  /                     \    /
74 //              | /                       \  /
75 //             Tail                       Tail
76 //
77 // Instructions in the conditional blocks TBB and/or FBB are spliced into the
78 // Head block, and phis in the Tail block are converted to select instructions.
79 //
80 namespace {
81 class SSAIfConv {
82   const TargetInstrInfo *TII;
83   const TargetRegisterInfo *TRI;
84   MachineRegisterInfo *MRI;
85 
86 public:
87   /// The block containing the conditional branch.
88   MachineBasicBlock *Head;
89 
90   /// The block containing phis after the if-then-else.
91   MachineBasicBlock *Tail;
92 
93   /// The 'true' conditional block as determined by AnalyzeBranch.
94   MachineBasicBlock *TBB;
95 
96   /// The 'false' conditional block as determined by AnalyzeBranch.
97   MachineBasicBlock *FBB;
98 
99   /// isTriangle - When there is no 'else' block, either TBB or FBB will be
100   /// equal to Tail.
isTriangle() const101   bool isTriangle() const { return TBB == Tail || FBB == Tail; }
102 
103   /// Returns the Tail predecessor for the True side.
getTPred() const104   MachineBasicBlock *getTPred() const { return TBB == Tail ? Head : TBB; }
105 
106   /// Returns the Tail predecessor for the  False side.
getFPred() const107   MachineBasicBlock *getFPred() const { return FBB == Tail ? Head : FBB; }
108 
109   /// Information about each phi in the Tail block.
110   struct PHIInfo {
111     MachineInstr *PHI;
112     unsigned TReg, FReg;
113     // Latencies from Cond+Branch, TReg, and FReg to DstReg.
114     int CondCycles, TCycles, FCycles;
115 
PHIInfo__anonfc1f82480111::SSAIfConv::PHIInfo116     PHIInfo(MachineInstr *phi)
117       : PHI(phi), TReg(0), FReg(0), CondCycles(0), TCycles(0), FCycles(0) {}
118   };
119 
120   SmallVector<PHIInfo, 8> PHIs;
121 
122 private:
123   /// The branch condition determined by AnalyzeBranch.
124   SmallVector<MachineOperand, 4> Cond;
125 
126   /// Instructions in Head that define values used by the conditional blocks.
127   /// The hoisted instructions must be inserted after these instructions.
128   SmallPtrSet<MachineInstr*, 8> InsertAfter;
129 
130   /// Register units clobbered by the conditional blocks.
131   BitVector ClobberedRegUnits;
132 
133   // Scratch pad for findInsertionPoint.
134   SparseSet<unsigned> LiveRegUnits;
135 
136   /// Insertion point in Head for speculatively executed instructions form TBB
137   /// and FBB.
138   MachineBasicBlock::iterator InsertionPoint;
139 
140   /// Return true if all non-terminator instructions in MBB can be safely
141   /// speculated.
142   bool canSpeculateInstrs(MachineBasicBlock *MBB);
143 
144   /// Find a valid insertion point in Head.
145   bool findInsertionPoint();
146 
147   /// Replace PHI instructions in Tail with selects.
148   void replacePHIInstrs();
149 
150   /// Insert selects and rewrite PHI operands to use them.
151   void rewritePHIOperands();
152 
153 public:
154   /// runOnMachineFunction - Initialize per-function data structures.
runOnMachineFunction(MachineFunction & MF)155   void runOnMachineFunction(MachineFunction &MF) {
156     TII = MF.getSubtarget().getInstrInfo();
157     TRI = MF.getSubtarget().getRegisterInfo();
158     MRI = &MF.getRegInfo();
159     LiveRegUnits.clear();
160     LiveRegUnits.setUniverse(TRI->getNumRegUnits());
161     ClobberedRegUnits.clear();
162     ClobberedRegUnits.resize(TRI->getNumRegUnits());
163   }
164 
165   /// canConvertIf - If the sub-CFG headed by MBB can be if-converted,
166   /// initialize the internal state, and return true.
167   bool canConvertIf(MachineBasicBlock *MBB);
168 
169   /// convertIf - If-convert the last block passed to canConvertIf(), assuming
170   /// it is possible. Add any erased blocks to RemovedBlocks.
171   void convertIf(SmallVectorImpl<MachineBasicBlock*> &RemovedBlocks);
172 };
173 } // end anonymous namespace
174 
175 
176 /// canSpeculateInstrs - Returns true if all the instructions in MBB can safely
177 /// be speculated. The terminators are not considered.
178 ///
179 /// If instructions use any values that are defined in the head basic block,
180 /// the defining instructions are added to InsertAfter.
181 ///
182 /// Any clobbered regunits are added to ClobberedRegUnits.
183 ///
canSpeculateInstrs(MachineBasicBlock * MBB)184 bool SSAIfConv::canSpeculateInstrs(MachineBasicBlock *MBB) {
185   // Reject any live-in physregs. It's probably CPSR/EFLAGS, and very hard to
186   // get right.
187   if (!MBB->livein_empty()) {
188     DEBUG(dbgs() << "BB#" << MBB->getNumber() << " has live-ins.\n");
189     return false;
190   }
191 
192   unsigned InstrCount = 0;
193 
194   // Check all instructions, except the terminators. It is assumed that
195   // terminators never have side effects or define any used register values.
196   for (MachineBasicBlock::iterator I = MBB->begin(),
197        E = MBB->getFirstTerminator(); I != E; ++I) {
198     if (I->isDebugValue())
199       continue;
200 
201     if (++InstrCount > BlockInstrLimit && !Stress) {
202       DEBUG(dbgs() << "BB#" << MBB->getNumber() << " has more than "
203                    << BlockInstrLimit << " instructions.\n");
204       return false;
205     }
206 
207     // There shouldn't normally be any phis in a single-predecessor block.
208     if (I->isPHI()) {
209       DEBUG(dbgs() << "Can't hoist: " << *I);
210       return false;
211     }
212 
213     // Don't speculate loads. Note that it may be possible and desirable to
214     // speculate GOT or constant pool loads that are guaranteed not to trap,
215     // but we don't support that for now.
216     if (I->mayLoad()) {
217       DEBUG(dbgs() << "Won't speculate load: " << *I);
218       return false;
219     }
220 
221     // We never speculate stores, so an AA pointer isn't necessary.
222     bool DontMoveAcrossStore = true;
223     if (!I->isSafeToMove(nullptr, DontMoveAcrossStore)) {
224       DEBUG(dbgs() << "Can't speculate: " << *I);
225       return false;
226     }
227 
228     // Check for any dependencies on Head instructions.
229     for (const MachineOperand &MO : I->operands()) {
230       if (MO.isRegMask()) {
231         DEBUG(dbgs() << "Won't speculate regmask: " << *I);
232         return false;
233       }
234       if (!MO.isReg())
235         continue;
236       unsigned Reg = MO.getReg();
237 
238       // Remember clobbered regunits.
239       if (MO.isDef() && TargetRegisterInfo::isPhysicalRegister(Reg))
240         for (MCRegUnitIterator Units(Reg, TRI); Units.isValid(); ++Units)
241           ClobberedRegUnits.set(*Units);
242 
243       if (!MO.readsReg() || !TargetRegisterInfo::isVirtualRegister(Reg))
244         continue;
245       MachineInstr *DefMI = MRI->getVRegDef(Reg);
246       if (!DefMI || DefMI->getParent() != Head)
247         continue;
248       if (InsertAfter.insert(DefMI).second)
249         DEBUG(dbgs() << "BB#" << MBB->getNumber() << " depends on " << *DefMI);
250       if (DefMI->isTerminator()) {
251         DEBUG(dbgs() << "Can't insert instructions below terminator.\n");
252         return false;
253       }
254     }
255   }
256   return true;
257 }
258 
259 
260 /// Find an insertion point in Head for the speculated instructions. The
261 /// insertion point must be:
262 ///
263 /// 1. Before any terminators.
264 /// 2. After any instructions in InsertAfter.
265 /// 3. Not have any clobbered regunits live.
266 ///
267 /// This function sets InsertionPoint and returns true when successful, it
268 /// returns false if no valid insertion point could be found.
269 ///
findInsertionPoint()270 bool SSAIfConv::findInsertionPoint() {
271   // Keep track of live regunits before the current position.
272   // Only track RegUnits that are also in ClobberedRegUnits.
273   LiveRegUnits.clear();
274   SmallVector<unsigned, 8> Reads;
275   MachineBasicBlock::iterator FirstTerm = Head->getFirstTerminator();
276   MachineBasicBlock::iterator I = Head->end();
277   MachineBasicBlock::iterator B = Head->begin();
278   while (I != B) {
279     --I;
280     // Some of the conditional code depends in I.
281     if (InsertAfter.count(I)) {
282       DEBUG(dbgs() << "Can't insert code after " << *I);
283       return false;
284     }
285 
286     // Update live regunits.
287     for (const MachineOperand &MO : I->operands()) {
288       // We're ignoring regmask operands. That is conservatively correct.
289       if (!MO.isReg())
290         continue;
291       unsigned Reg = MO.getReg();
292       if (!TargetRegisterInfo::isPhysicalRegister(Reg))
293         continue;
294       // I clobbers Reg, so it isn't live before I.
295       if (MO.isDef())
296         for (MCRegUnitIterator Units(Reg, TRI); Units.isValid(); ++Units)
297           LiveRegUnits.erase(*Units);
298       // Unless I reads Reg.
299       if (MO.readsReg())
300         Reads.push_back(Reg);
301     }
302     // Anything read by I is live before I.
303     while (!Reads.empty())
304       for (MCRegUnitIterator Units(Reads.pop_back_val(), TRI); Units.isValid();
305            ++Units)
306         if (ClobberedRegUnits.test(*Units))
307           LiveRegUnits.insert(*Units);
308 
309     // We can't insert before a terminator.
310     if (I != FirstTerm && I->isTerminator())
311       continue;
312 
313     // Some of the clobbered registers are live before I, not a valid insertion
314     // point.
315     if (!LiveRegUnits.empty()) {
316       DEBUG({
317         dbgs() << "Would clobber";
318         for (SparseSet<unsigned>::const_iterator
319              i = LiveRegUnits.begin(), e = LiveRegUnits.end(); i != e; ++i)
320           dbgs() << ' ' << PrintRegUnit(*i, TRI);
321         dbgs() << " live before " << *I;
322       });
323       continue;
324     }
325 
326     // This is a valid insertion point.
327     InsertionPoint = I;
328     DEBUG(dbgs() << "Can insert before " << *I);
329     return true;
330   }
331   DEBUG(dbgs() << "No legal insertion point found.\n");
332   return false;
333 }
334 
335 
336 
337 /// canConvertIf - analyze the sub-cfg rooted in MBB, and return true if it is
338 /// a potential candidate for if-conversion. Fill out the internal state.
339 ///
canConvertIf(MachineBasicBlock * MBB)340 bool SSAIfConv::canConvertIf(MachineBasicBlock *MBB) {
341   Head = MBB;
342   TBB = FBB = Tail = nullptr;
343 
344   if (Head->succ_size() != 2)
345     return false;
346   MachineBasicBlock *Succ0 = Head->succ_begin()[0];
347   MachineBasicBlock *Succ1 = Head->succ_begin()[1];
348 
349   // Canonicalize so Succ0 has MBB as its single predecessor.
350   if (Succ0->pred_size() != 1)
351     std::swap(Succ0, Succ1);
352 
353   if (Succ0->pred_size() != 1 || Succ0->succ_size() != 1)
354     return false;
355 
356   Tail = Succ0->succ_begin()[0];
357 
358   // This is not a triangle.
359   if (Tail != Succ1) {
360     // Check for a diamond. We won't deal with any critical edges.
361     if (Succ1->pred_size() != 1 || Succ1->succ_size() != 1 ||
362         Succ1->succ_begin()[0] != Tail)
363       return false;
364     DEBUG(dbgs() << "\nDiamond: BB#" << Head->getNumber()
365                  << " -> BB#" << Succ0->getNumber()
366                  << "/BB#" << Succ1->getNumber()
367                  << " -> BB#" << Tail->getNumber() << '\n');
368 
369     // Live-in physregs are tricky to get right when speculating code.
370     if (!Tail->livein_empty()) {
371       DEBUG(dbgs() << "Tail has live-ins.\n");
372       return false;
373     }
374   } else {
375     DEBUG(dbgs() << "\nTriangle: BB#" << Head->getNumber()
376                  << " -> BB#" << Succ0->getNumber()
377                  << " -> BB#" << Tail->getNumber() << '\n');
378   }
379 
380   // This is a triangle or a diamond.
381   // If Tail doesn't have any phis, there must be side effects.
382   if (Tail->empty() || !Tail->front().isPHI()) {
383     DEBUG(dbgs() << "No phis in tail.\n");
384     return false;
385   }
386 
387   // The branch we're looking to eliminate must be analyzable.
388   Cond.clear();
389   if (TII->AnalyzeBranch(*Head, TBB, FBB, Cond)) {
390     DEBUG(dbgs() << "Branch not analyzable.\n");
391     return false;
392   }
393 
394   // This is weird, probably some sort of degenerate CFG.
395   if (!TBB) {
396     DEBUG(dbgs() << "AnalyzeBranch didn't find conditional branch.\n");
397     return false;
398   }
399 
400   // AnalyzeBranch doesn't set FBB on a fall-through branch.
401   // Make sure it is always set.
402   FBB = TBB == Succ0 ? Succ1 : Succ0;
403 
404   // Any phis in the tail block must be convertible to selects.
405   PHIs.clear();
406   MachineBasicBlock *TPred = getTPred();
407   MachineBasicBlock *FPred = getFPred();
408   for (MachineBasicBlock::iterator I = Tail->begin(), E = Tail->end();
409        I != E && I->isPHI(); ++I) {
410     PHIs.push_back(&*I);
411     PHIInfo &PI = PHIs.back();
412     // Find PHI operands corresponding to TPred and FPred.
413     for (unsigned i = 1; i != PI.PHI->getNumOperands(); i += 2) {
414       if (PI.PHI->getOperand(i+1).getMBB() == TPred)
415         PI.TReg = PI.PHI->getOperand(i).getReg();
416       if (PI.PHI->getOperand(i+1).getMBB() == FPred)
417         PI.FReg = PI.PHI->getOperand(i).getReg();
418     }
419     assert(TargetRegisterInfo::isVirtualRegister(PI.TReg) && "Bad PHI");
420     assert(TargetRegisterInfo::isVirtualRegister(PI.FReg) && "Bad PHI");
421 
422     // Get target information.
423     if (!TII->canInsertSelect(*Head, Cond, PI.TReg, PI.FReg,
424                               PI.CondCycles, PI.TCycles, PI.FCycles)) {
425       DEBUG(dbgs() << "Can't convert: " << *PI.PHI);
426       return false;
427     }
428   }
429 
430   // Check that the conditional instructions can be speculated.
431   InsertAfter.clear();
432   ClobberedRegUnits.reset();
433   if (TBB != Tail && !canSpeculateInstrs(TBB))
434     return false;
435   if (FBB != Tail && !canSpeculateInstrs(FBB))
436     return false;
437 
438   // Try to find a valid insertion point for the speculated instructions in the
439   // head basic block.
440   if (!findInsertionPoint())
441     return false;
442 
443   if (isTriangle())
444     ++NumTrianglesSeen;
445   else
446     ++NumDiamondsSeen;
447   return true;
448 }
449 
450 /// replacePHIInstrs - Completely replace PHI instructions with selects.
451 /// This is possible when the only Tail predecessors are the if-converted
452 /// blocks.
replacePHIInstrs()453 void SSAIfConv::replacePHIInstrs() {
454   assert(Tail->pred_size() == 2 && "Cannot replace PHIs");
455   MachineBasicBlock::iterator FirstTerm = Head->getFirstTerminator();
456   assert(FirstTerm != Head->end() && "No terminators");
457   DebugLoc HeadDL = FirstTerm->getDebugLoc();
458 
459   // Convert all PHIs to select instructions inserted before FirstTerm.
460   for (unsigned i = 0, e = PHIs.size(); i != e; ++i) {
461     PHIInfo &PI = PHIs[i];
462     DEBUG(dbgs() << "If-converting " << *PI.PHI);
463     unsigned DstReg = PI.PHI->getOperand(0).getReg();
464     TII->insertSelect(*Head, FirstTerm, HeadDL, DstReg, Cond, PI.TReg, PI.FReg);
465     DEBUG(dbgs() << "          --> " << *std::prev(FirstTerm));
466     PI.PHI->eraseFromParent();
467     PI.PHI = nullptr;
468   }
469 }
470 
471 /// rewritePHIOperands - When there are additional Tail predecessors, insert
472 /// select instructions in Head and rewrite PHI operands to use the selects.
473 /// Keep the PHI instructions in Tail to handle the other predecessors.
rewritePHIOperands()474 void SSAIfConv::rewritePHIOperands() {
475   MachineBasicBlock::iterator FirstTerm = Head->getFirstTerminator();
476   assert(FirstTerm != Head->end() && "No terminators");
477   DebugLoc HeadDL = FirstTerm->getDebugLoc();
478 
479   // Convert all PHIs to select instructions inserted before FirstTerm.
480   for (unsigned i = 0, e = PHIs.size(); i != e; ++i) {
481     PHIInfo &PI = PHIs[i];
482     unsigned DstReg = 0;
483 
484     DEBUG(dbgs() << "If-converting " << *PI.PHI);
485     if (PI.TReg == PI.FReg) {
486       // We do not need the select instruction if both incoming values are
487       // equal.
488       DstReg = PI.TReg;
489     } else {
490       unsigned PHIDst = PI.PHI->getOperand(0).getReg();
491       DstReg = MRI->createVirtualRegister(MRI->getRegClass(PHIDst));
492       TII->insertSelect(*Head, FirstTerm, HeadDL,
493                          DstReg, Cond, PI.TReg, PI.FReg);
494       DEBUG(dbgs() << "          --> " << *std::prev(FirstTerm));
495     }
496 
497     // Rewrite PHI operands TPred -> (DstReg, Head), remove FPred.
498     for (unsigned i = PI.PHI->getNumOperands(); i != 1; i -= 2) {
499       MachineBasicBlock *MBB = PI.PHI->getOperand(i-1).getMBB();
500       if (MBB == getTPred()) {
501         PI.PHI->getOperand(i-1).setMBB(Head);
502         PI.PHI->getOperand(i-2).setReg(DstReg);
503       } else if (MBB == getFPred()) {
504         PI.PHI->RemoveOperand(i-1);
505         PI.PHI->RemoveOperand(i-2);
506       }
507     }
508     DEBUG(dbgs() << "          --> " << *PI.PHI);
509   }
510 }
511 
512 /// convertIf - Execute the if conversion after canConvertIf has determined the
513 /// feasibility.
514 ///
515 /// Any basic blocks erased will be added to RemovedBlocks.
516 ///
convertIf(SmallVectorImpl<MachineBasicBlock * > & RemovedBlocks)517 void SSAIfConv::convertIf(SmallVectorImpl<MachineBasicBlock*> &RemovedBlocks) {
518   assert(Head && Tail && TBB && FBB && "Call canConvertIf first.");
519 
520   // Update statistics.
521   if (isTriangle())
522     ++NumTrianglesConv;
523   else
524     ++NumDiamondsConv;
525 
526   // Move all instructions into Head, except for the terminators.
527   if (TBB != Tail)
528     Head->splice(InsertionPoint, TBB, TBB->begin(), TBB->getFirstTerminator());
529   if (FBB != Tail)
530     Head->splice(InsertionPoint, FBB, FBB->begin(), FBB->getFirstTerminator());
531 
532   // Are there extra Tail predecessors?
533   bool ExtraPreds = Tail->pred_size() != 2;
534   if (ExtraPreds)
535     rewritePHIOperands();
536   else
537     replacePHIInstrs();
538 
539   // Fix up the CFG, temporarily leave Head without any successors.
540   Head->removeSuccessor(TBB);
541   Head->removeSuccessor(FBB, true);
542   if (TBB != Tail)
543     TBB->removeSuccessor(Tail, true);
544   if (FBB != Tail)
545     FBB->removeSuccessor(Tail, true);
546 
547   // Fix up Head's terminators.
548   // It should become a single branch or a fallthrough.
549   DebugLoc HeadDL = Head->getFirstTerminator()->getDebugLoc();
550   TII->RemoveBranch(*Head);
551 
552   // Erase the now empty conditional blocks. It is likely that Head can fall
553   // through to Tail, and we can join the two blocks.
554   if (TBB != Tail) {
555     RemovedBlocks.push_back(TBB);
556     TBB->eraseFromParent();
557   }
558   if (FBB != Tail) {
559     RemovedBlocks.push_back(FBB);
560     FBB->eraseFromParent();
561   }
562 
563   assert(Head->succ_empty() && "Additional head successors?");
564   if (!ExtraPreds && Head->isLayoutSuccessor(Tail)) {
565     // Splice Tail onto the end of Head.
566     DEBUG(dbgs() << "Joining tail BB#" << Tail->getNumber()
567                  << " into head BB#" << Head->getNumber() << '\n');
568     Head->splice(Head->end(), Tail,
569                      Tail->begin(), Tail->end());
570     Head->transferSuccessorsAndUpdatePHIs(Tail);
571     RemovedBlocks.push_back(Tail);
572     Tail->eraseFromParent();
573   } else {
574     // We need a branch to Tail, let code placement work it out later.
575     DEBUG(dbgs() << "Converting to unconditional branch.\n");
576     SmallVector<MachineOperand, 0> EmptyCond;
577     TII->InsertBranch(*Head, Tail, nullptr, EmptyCond, HeadDL);
578     Head->addSuccessor(Tail);
579   }
580   DEBUG(dbgs() << *Head);
581 }
582 
583 
584 //===----------------------------------------------------------------------===//
585 //                           EarlyIfConverter Pass
586 //===----------------------------------------------------------------------===//
587 
588 namespace {
589 class EarlyIfConverter : public MachineFunctionPass {
590   const TargetInstrInfo *TII;
591   const TargetRegisterInfo *TRI;
592   MCSchedModel SchedModel;
593   MachineRegisterInfo *MRI;
594   MachineDominatorTree *DomTree;
595   MachineLoopInfo *Loops;
596   MachineTraceMetrics *Traces;
597   MachineTraceMetrics::Ensemble *MinInstr;
598   SSAIfConv IfConv;
599 
600 public:
601   static char ID;
EarlyIfConverter()602   EarlyIfConverter() : MachineFunctionPass(ID) {}
603   void getAnalysisUsage(AnalysisUsage &AU) const override;
604   bool runOnMachineFunction(MachineFunction &MF) override;
getPassName() const605   const char *getPassName() const override { return "Early If-Conversion"; }
606 
607 private:
608   bool tryConvertIf(MachineBasicBlock*);
609   void updateDomTree(ArrayRef<MachineBasicBlock*> Removed);
610   void updateLoops(ArrayRef<MachineBasicBlock*> Removed);
611   void invalidateTraces();
612   bool shouldConvertIf();
613 };
614 } // end anonymous namespace
615 
616 char EarlyIfConverter::ID = 0;
617 char &llvm::EarlyIfConverterID = EarlyIfConverter::ID;
618 
619 INITIALIZE_PASS_BEGIN(EarlyIfConverter,
620                       "early-ifcvt", "Early If Converter", false, false)
INITIALIZE_PASS_DEPENDENCY(MachineBranchProbabilityInfo)621 INITIALIZE_PASS_DEPENDENCY(MachineBranchProbabilityInfo)
622 INITIALIZE_PASS_DEPENDENCY(MachineDominatorTree)
623 INITIALIZE_PASS_DEPENDENCY(MachineTraceMetrics)
624 INITIALIZE_PASS_END(EarlyIfConverter,
625                       "early-ifcvt", "Early If Converter", false, false)
626 
627 void EarlyIfConverter::getAnalysisUsage(AnalysisUsage &AU) const {
628   AU.addRequired<MachineBranchProbabilityInfo>();
629   AU.addRequired<MachineDominatorTree>();
630   AU.addPreserved<MachineDominatorTree>();
631   AU.addRequired<MachineLoopInfo>();
632   AU.addPreserved<MachineLoopInfo>();
633   AU.addRequired<MachineTraceMetrics>();
634   AU.addPreserved<MachineTraceMetrics>();
635   MachineFunctionPass::getAnalysisUsage(AU);
636 }
637 
638 /// Update the dominator tree after if-conversion erased some blocks.
updateDomTree(ArrayRef<MachineBasicBlock * > Removed)639 void EarlyIfConverter::updateDomTree(ArrayRef<MachineBasicBlock*> Removed) {
640   // convertIf can remove TBB, FBB, and Tail can be merged into Head.
641   // TBB and FBB should not dominate any blocks.
642   // Tail children should be transferred to Head.
643   MachineDomTreeNode *HeadNode = DomTree->getNode(IfConv.Head);
644   for (unsigned i = 0, e = Removed.size(); i != e; ++i) {
645     MachineDomTreeNode *Node = DomTree->getNode(Removed[i]);
646     assert(Node != HeadNode && "Cannot erase the head node");
647     while (Node->getNumChildren()) {
648       assert(Node->getBlock() == IfConv.Tail && "Unexpected children");
649       DomTree->changeImmediateDominator(Node->getChildren().back(), HeadNode);
650     }
651     DomTree->eraseNode(Removed[i]);
652   }
653 }
654 
655 /// Update LoopInfo after if-conversion.
updateLoops(ArrayRef<MachineBasicBlock * > Removed)656 void EarlyIfConverter::updateLoops(ArrayRef<MachineBasicBlock*> Removed) {
657   if (!Loops)
658     return;
659   // If-conversion doesn't change loop structure, and it doesn't mess with back
660   // edges, so updating LoopInfo is simply removing the dead blocks.
661   for (unsigned i = 0, e = Removed.size(); i != e; ++i)
662     Loops->removeBlock(Removed[i]);
663 }
664 
665 /// Invalidate MachineTraceMetrics before if-conversion.
invalidateTraces()666 void EarlyIfConverter::invalidateTraces() {
667   Traces->verifyAnalysis();
668   Traces->invalidate(IfConv.Head);
669   Traces->invalidate(IfConv.Tail);
670   Traces->invalidate(IfConv.TBB);
671   Traces->invalidate(IfConv.FBB);
672   Traces->verifyAnalysis();
673 }
674 
675 // Adjust cycles with downward saturation.
adjCycles(unsigned Cyc,int Delta)676 static unsigned adjCycles(unsigned Cyc, int Delta) {
677   if (Delta < 0 && Cyc + Delta > Cyc)
678     return 0;
679   return Cyc + Delta;
680 }
681 
682 /// Apply cost model and heuristics to the if-conversion in IfConv.
683 /// Return true if the conversion is a good idea.
684 ///
shouldConvertIf()685 bool EarlyIfConverter::shouldConvertIf() {
686   // Stress testing mode disables all cost considerations.
687   if (Stress)
688     return true;
689 
690   if (!MinInstr)
691     MinInstr = Traces->getEnsemble(MachineTraceMetrics::TS_MinInstrCount);
692 
693   MachineTraceMetrics::Trace TBBTrace = MinInstr->getTrace(IfConv.getTPred());
694   MachineTraceMetrics::Trace FBBTrace = MinInstr->getTrace(IfConv.getFPred());
695   DEBUG(dbgs() << "TBB: " << TBBTrace << "FBB: " << FBBTrace);
696   unsigned MinCrit = std::min(TBBTrace.getCriticalPath(),
697                               FBBTrace.getCriticalPath());
698 
699   // Set a somewhat arbitrary limit on the critical path extension we accept.
700   unsigned CritLimit = SchedModel.MispredictPenalty/2;
701 
702   // If-conversion only makes sense when there is unexploited ILP. Compute the
703   // maximum-ILP resource length of the trace after if-conversion. Compare it
704   // to the shortest critical path.
705   SmallVector<const MachineBasicBlock*, 1> ExtraBlocks;
706   if (IfConv.TBB != IfConv.Tail)
707     ExtraBlocks.push_back(IfConv.TBB);
708   unsigned ResLength = FBBTrace.getResourceLength(ExtraBlocks);
709   DEBUG(dbgs() << "Resource length " << ResLength
710                << ", minimal critical path " << MinCrit << '\n');
711   if (ResLength > MinCrit + CritLimit) {
712     DEBUG(dbgs() << "Not enough available ILP.\n");
713     return false;
714   }
715 
716   // Assume that the depth of the first head terminator will also be the depth
717   // of the select instruction inserted, as determined by the flag dependency.
718   // TBB / FBB data dependencies may delay the select even more.
719   MachineTraceMetrics::Trace HeadTrace = MinInstr->getTrace(IfConv.Head);
720   unsigned BranchDepth =
721     HeadTrace.getInstrCycles(IfConv.Head->getFirstTerminator()).Depth;
722   DEBUG(dbgs() << "Branch depth: " << BranchDepth << '\n');
723 
724   // Look at all the tail phis, and compute the critical path extension caused
725   // by inserting select instructions.
726   MachineTraceMetrics::Trace TailTrace = MinInstr->getTrace(IfConv.Tail);
727   for (unsigned i = 0, e = IfConv.PHIs.size(); i != e; ++i) {
728     SSAIfConv::PHIInfo &PI = IfConv.PHIs[i];
729     unsigned Slack = TailTrace.getInstrSlack(PI.PHI);
730     unsigned MaxDepth = Slack + TailTrace.getInstrCycles(PI.PHI).Depth;
731     DEBUG(dbgs() << "Slack " << Slack << ":\t" << *PI.PHI);
732 
733     // The condition is pulled into the critical path.
734     unsigned CondDepth = adjCycles(BranchDepth, PI.CondCycles);
735     if (CondDepth > MaxDepth) {
736       unsigned Extra = CondDepth - MaxDepth;
737       DEBUG(dbgs() << "Condition adds " << Extra << " cycles.\n");
738       if (Extra > CritLimit) {
739         DEBUG(dbgs() << "Exceeds limit of " << CritLimit << '\n');
740         return false;
741       }
742     }
743 
744     // The TBB value is pulled into the critical path.
745     unsigned TDepth = adjCycles(TBBTrace.getPHIDepth(PI.PHI), PI.TCycles);
746     if (TDepth > MaxDepth) {
747       unsigned Extra = TDepth - MaxDepth;
748       DEBUG(dbgs() << "TBB data adds " << Extra << " cycles.\n");
749       if (Extra > CritLimit) {
750         DEBUG(dbgs() << "Exceeds limit of " << CritLimit << '\n');
751         return false;
752       }
753     }
754 
755     // The FBB value is pulled into the critical path.
756     unsigned FDepth = adjCycles(FBBTrace.getPHIDepth(PI.PHI), PI.FCycles);
757     if (FDepth > MaxDepth) {
758       unsigned Extra = FDepth - MaxDepth;
759       DEBUG(dbgs() << "FBB data adds " << Extra << " cycles.\n");
760       if (Extra > CritLimit) {
761         DEBUG(dbgs() << "Exceeds limit of " << CritLimit << '\n');
762         return false;
763       }
764     }
765   }
766   return true;
767 }
768 
769 /// Attempt repeated if-conversion on MBB, return true if successful.
770 ///
tryConvertIf(MachineBasicBlock * MBB)771 bool EarlyIfConverter::tryConvertIf(MachineBasicBlock *MBB) {
772   bool Changed = false;
773   while (IfConv.canConvertIf(MBB) && shouldConvertIf()) {
774     // If-convert MBB and update analyses.
775     invalidateTraces();
776     SmallVector<MachineBasicBlock*, 4> RemovedBlocks;
777     IfConv.convertIf(RemovedBlocks);
778     Changed = true;
779     updateDomTree(RemovedBlocks);
780     updateLoops(RemovedBlocks);
781   }
782   return Changed;
783 }
784 
runOnMachineFunction(MachineFunction & MF)785 bool EarlyIfConverter::runOnMachineFunction(MachineFunction &MF) {
786   DEBUG(dbgs() << "********** EARLY IF-CONVERSION **********\n"
787                << "********** Function: " << MF.getName() << '\n');
788   // Only run if conversion if the target wants it.
789   const TargetSubtargetInfo &STI = MF.getSubtarget();
790   if (!STI.enableEarlyIfConversion())
791     return false;
792 
793   TII = STI.getInstrInfo();
794   TRI = STI.getRegisterInfo();
795   SchedModel = STI.getSchedModel();
796   MRI = &MF.getRegInfo();
797   DomTree = &getAnalysis<MachineDominatorTree>();
798   Loops = getAnalysisIfAvailable<MachineLoopInfo>();
799   Traces = &getAnalysis<MachineTraceMetrics>();
800   MinInstr = nullptr;
801 
802   bool Changed = false;
803   IfConv.runOnMachineFunction(MF);
804 
805   // Visit blocks in dominator tree post-order. The post-order enables nested
806   // if-conversion in a single pass. The tryConvertIf() function may erase
807   // blocks, but only blocks dominated by the head block. This makes it safe to
808   // update the dominator tree while the post-order iterator is still active.
809   for (auto DomNode : post_order(DomTree))
810     if (tryConvertIf(DomNode->getBlock()))
811       Changed = true;
812 
813   return Changed;
814 }
815