1 //===-- EarlyIfConversion.cpp - If-conversion on SSA form machine code ----===//
3 // Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4 // See https://llvm.org/LICENSE.txt for license information.
5 // SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
7 //===----------------------------------------------------------------------===//
9 // Early if-conversion is for out-of-order CPUs that don't have a lot of
10 // predicable instructions. The goal is to eliminate conditional branches that
13 // Instructions from both sides of the branch are executed specutatively, and a
14 // cmov instruction selects the result.
16 //===----------------------------------------------------------------------===//
18 #include "llvm/ADT/BitVector.h"
19 #include "llvm/ADT/PostOrderIterator.h"
20 #include "llvm/ADT/SetVector.h"
21 #include "llvm/ADT/SmallPtrSet.h"
22 #include "llvm/ADT/SparseSet.h"
23 #include "llvm/ADT/Statistic.h"
24 #include "llvm/CodeGen/MachineBranchProbabilityInfo.h"
25 #include "llvm/CodeGen/MachineDominators.h"
26 #include "llvm/CodeGen/MachineFunction.h"
27 #include "llvm/CodeGen/MachineFunctionPass.h"
28 #include "llvm/CodeGen/MachineInstr.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/CodeGen/TargetInstrInfo.h"
34 #include "llvm/CodeGen/TargetRegisterInfo.h"
35 #include "llvm/CodeGen/TargetSubtargetInfo.h"
36 #include "llvm/Support/CommandLine.h"
37 #include "llvm/Support/Debug.h"
38 #include "llvm/Support/raw_ostream.h"
42 #define DEBUG_TYPE "early-ifcvt"
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."));
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"));
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");
59 //===----------------------------------------------------------------------===//
61 //===----------------------------------------------------------------------===//
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.
67 // SSAIfConv can convert both triangles and diamonds:
69 // Triangle: Head Diamond: Head
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.
82 const TargetInstrInfo
*TII
;
83 const TargetRegisterInfo
*TRI
;
84 MachineRegisterInfo
*MRI
;
87 /// The block containing the conditional branch.
88 MachineBasicBlock
*Head
;
90 /// The block containing phis after the if-then-else.
91 MachineBasicBlock
*Tail
;
93 /// The 'true' conditional block as determined by AnalyzeBranch.
94 MachineBasicBlock
*TBB
;
96 /// The 'false' conditional block as determined by AnalyzeBranch.
97 MachineBasicBlock
*FBB
;
99 /// isTriangle - When there is no 'else' block, either TBB or FBB will be
101 bool isTriangle() const { return TBB
== Tail
|| FBB
== Tail
; }
103 /// Returns the Tail predecessor for the True side.
104 MachineBasicBlock
*getTPred() const { return TBB
== Tail
? Head
: TBB
; }
106 /// Returns the Tail predecessor for the False side.
107 MachineBasicBlock
*getFPred() const { return FBB
== Tail
? Head
: FBB
; }
109 /// Information about each phi in the Tail block.
113 // Latencies from Cond+Branch, TReg, and FReg to DstReg.
114 int CondCycles
, TCycles
, FCycles
;
116 PHIInfo(MachineInstr
*phi
)
117 : PHI(phi
), TReg(0), FReg(0), CondCycles(0), TCycles(0), FCycles(0) {}
120 SmallVector
<PHIInfo
, 8> PHIs
;
123 /// The branch condition determined by AnalyzeBranch.
124 SmallVector
<MachineOperand
, 4> Cond
;
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
;
130 /// Register units clobbered by the conditional blocks.
131 BitVector ClobberedRegUnits
;
133 // Scratch pad for findInsertionPoint.
134 SparseSet
<unsigned> LiveRegUnits
;
136 /// Insertion point in Head for speculatively executed instructions form TBB
138 MachineBasicBlock::iterator InsertionPoint
;
140 /// Return true if all non-terminator instructions in MBB can be safely
142 bool canSpeculateInstrs(MachineBasicBlock
*MBB
);
144 /// Return true if all non-terminator instructions in MBB can be safely
146 bool canPredicateInstrs(MachineBasicBlock
*MBB
);
148 /// Scan through instruction dependencies and update InsertAfter array.
149 /// Return false if any dependency is incompatible with if conversion.
150 bool InstrDependenciesAllowIfConv(MachineInstr
*I
);
152 /// Predicate all instructions of the basic block with current condition
153 /// except for terminators. Reverse the condition if ReversePredicate is set.
154 void PredicateBlock(MachineBasicBlock
*MBB
, bool ReversePredicate
);
156 /// Find a valid insertion point in Head.
157 bool findInsertionPoint();
159 /// Replace PHI instructions in Tail with selects.
160 void replacePHIInstrs();
162 /// Insert selects and rewrite PHI operands to use them.
163 void rewritePHIOperands();
166 /// runOnMachineFunction - Initialize per-function data structures.
167 void runOnMachineFunction(MachineFunction
&MF
) {
168 TII
= MF
.getSubtarget().getInstrInfo();
169 TRI
= MF
.getSubtarget().getRegisterInfo();
170 MRI
= &MF
.getRegInfo();
171 LiveRegUnits
.clear();
172 LiveRegUnits
.setUniverse(TRI
->getNumRegUnits());
173 ClobberedRegUnits
.clear();
174 ClobberedRegUnits
.resize(TRI
->getNumRegUnits());
177 /// canConvertIf - If the sub-CFG headed by MBB can be if-converted,
178 /// initialize the internal state, and return true.
179 /// If predicate is set try to predicate the block otherwise try to
180 /// speculatively execute it.
181 bool canConvertIf(MachineBasicBlock
*MBB
, bool Predicate
= false);
183 /// convertIf - If-convert the last block passed to canConvertIf(), assuming
184 /// it is possible. Add any erased blocks to RemovedBlocks.
185 void convertIf(SmallVectorImpl
<MachineBasicBlock
*> &RemovedBlocks
,
186 bool Predicate
= false);
188 } // end anonymous namespace
191 /// canSpeculateInstrs - Returns true if all the instructions in MBB can safely
192 /// be speculated. The terminators are not considered.
194 /// If instructions use any values that are defined in the head basic block,
195 /// the defining instructions are added to InsertAfter.
197 /// Any clobbered regunits are added to ClobberedRegUnits.
199 bool SSAIfConv::canSpeculateInstrs(MachineBasicBlock
*MBB
) {
200 // Reject any live-in physregs. It's probably CPSR/EFLAGS, and very hard to
202 if (!MBB
->livein_empty()) {
203 LLVM_DEBUG(dbgs() << printMBBReference(*MBB
) << " has live-ins.\n");
207 unsigned InstrCount
= 0;
209 // Check all instructions, except the terminators. It is assumed that
210 // terminators never have side effects or define any used register values.
211 for (MachineBasicBlock::iterator I
= MBB
->begin(),
212 E
= MBB
->getFirstTerminator(); I
!= E
; ++I
) {
213 if (I
->isDebugInstr())
216 if (++InstrCount
> BlockInstrLimit
&& !Stress
) {
217 LLVM_DEBUG(dbgs() << printMBBReference(*MBB
) << " has more than "
218 << BlockInstrLimit
<< " instructions.\n");
222 // There shouldn't normally be any phis in a single-predecessor block.
224 LLVM_DEBUG(dbgs() << "Can't hoist: " << *I
);
228 // Don't speculate loads. Note that it may be possible and desirable to
229 // speculate GOT or constant pool loads that are guaranteed not to trap,
230 // but we don't support that for now.
232 LLVM_DEBUG(dbgs() << "Won't speculate load: " << *I
);
236 // We never speculate stores, so an AA pointer isn't necessary.
237 bool DontMoveAcrossStore
= true;
238 if (!I
->isSafeToMove(nullptr, DontMoveAcrossStore
)) {
239 LLVM_DEBUG(dbgs() << "Can't speculate: " << *I
);
243 // Check for any dependencies on Head instructions.
244 if (!InstrDependenciesAllowIfConv(&(*I
)))
250 /// Check that there is no dependencies preventing if conversion.
252 /// If instruction uses any values that are defined in the head basic block,
253 /// the defining instructions are added to InsertAfter.
254 bool SSAIfConv::InstrDependenciesAllowIfConv(MachineInstr
*I
) {
255 for (const MachineOperand
&MO
: I
->operands()) {
256 if (MO
.isRegMask()) {
257 LLVM_DEBUG(dbgs() << "Won't speculate regmask: " << *I
);
262 Register Reg
= MO
.getReg();
264 // Remember clobbered regunits.
265 if (MO
.isDef() && Register::isPhysicalRegister(Reg
))
266 for (MCRegUnitIterator
Units(Reg
, TRI
); Units
.isValid(); ++Units
)
267 ClobberedRegUnits
.set(*Units
);
269 if (!MO
.readsReg() || !Register::isVirtualRegister(Reg
))
271 MachineInstr
*DefMI
= MRI
->getVRegDef(Reg
);
272 if (!DefMI
|| DefMI
->getParent() != Head
)
274 if (InsertAfter
.insert(DefMI
).second
)
275 LLVM_DEBUG(dbgs() << printMBBReference(*I
->getParent()) << " depends on "
277 if (DefMI
->isTerminator()) {
278 LLVM_DEBUG(dbgs() << "Can't insert instructions below terminator.\n");
285 /// canPredicateInstrs - Returns true if all the instructions in MBB can safely
286 /// be predicates. The terminators are not considered.
288 /// If instructions use any values that are defined in the head basic block,
289 /// the defining instructions are added to InsertAfter.
291 /// Any clobbered regunits are added to ClobberedRegUnits.
293 bool SSAIfConv::canPredicateInstrs(MachineBasicBlock
*MBB
) {
294 // Reject any live-in physregs. It's probably CPSR/EFLAGS, and very hard to
296 if (!MBB
->livein_empty()) {
297 LLVM_DEBUG(dbgs() << printMBBReference(*MBB
) << " has live-ins.\n");
301 unsigned InstrCount
= 0;
303 // Check all instructions, except the terminators. It is assumed that
304 // terminators never have side effects or define any used register values.
305 for (MachineBasicBlock::iterator I
= MBB
->begin(),
306 E
= MBB
->getFirstTerminator();
308 if (I
->isDebugInstr())
311 if (++InstrCount
> BlockInstrLimit
&& !Stress
) {
312 LLVM_DEBUG(dbgs() << printMBBReference(*MBB
) << " has more than "
313 << BlockInstrLimit
<< " instructions.\n");
317 // There shouldn't normally be any phis in a single-predecessor block.
319 LLVM_DEBUG(dbgs() << "Can't predicate: " << *I
);
323 // Check that instruction is predicable and that it is not already
325 if (!TII
->isPredicable(*I
) || TII
->isPredicated(*I
)) {
329 // Check for any dependencies on Head instructions.
330 if (!InstrDependenciesAllowIfConv(&(*I
)))
336 // Apply predicate to all instructions in the machine block.
337 void SSAIfConv::PredicateBlock(MachineBasicBlock
*MBB
, bool ReversePredicate
) {
338 auto Condition
= Cond
;
339 if (ReversePredicate
)
340 TII
->reverseBranchCondition(Condition
);
341 // Terminators don't need to be predicated as they will be removed.
342 for (MachineBasicBlock::iterator I
= MBB
->begin(),
343 E
= MBB
->getFirstTerminator();
345 if (I
->isDebugInstr())
347 TII
->PredicateInstruction(*I
, Condition
);
351 /// Find an insertion point in Head for the speculated instructions. The
352 /// insertion point must be:
354 /// 1. Before any terminators.
355 /// 2. After any instructions in InsertAfter.
356 /// 3. Not have any clobbered regunits live.
358 /// This function sets InsertionPoint and returns true when successful, it
359 /// returns false if no valid insertion point could be found.
361 bool SSAIfConv::findInsertionPoint() {
362 // Keep track of live regunits before the current position.
363 // Only track RegUnits that are also in ClobberedRegUnits.
364 LiveRegUnits
.clear();
365 SmallVector
<unsigned, 8> Reads
;
366 MachineBasicBlock::iterator FirstTerm
= Head
->getFirstTerminator();
367 MachineBasicBlock::iterator I
= Head
->end();
368 MachineBasicBlock::iterator B
= Head
->begin();
371 // Some of the conditional code depends in I.
372 if (InsertAfter
.count(&*I
)) {
373 LLVM_DEBUG(dbgs() << "Can't insert code after " << *I
);
377 // Update live regunits.
378 for (const MachineOperand
&MO
: I
->operands()) {
379 // We're ignoring regmask operands. That is conservatively correct.
382 Register Reg
= MO
.getReg();
383 if (!Register::isPhysicalRegister(Reg
))
385 // I clobbers Reg, so it isn't live before I.
387 for (MCRegUnitIterator
Units(Reg
, TRI
); Units
.isValid(); ++Units
)
388 LiveRegUnits
.erase(*Units
);
389 // Unless I reads Reg.
391 Reads
.push_back(Reg
);
393 // Anything read by I is live before I.
394 while (!Reads
.empty())
395 for (MCRegUnitIterator
Units(Reads
.pop_back_val(), TRI
); Units
.isValid();
397 if (ClobberedRegUnits
.test(*Units
))
398 LiveRegUnits
.insert(*Units
);
400 // We can't insert before a terminator.
401 if (I
!= FirstTerm
&& I
->isTerminator())
404 // Some of the clobbered registers are live before I, not a valid insertion
406 if (!LiveRegUnits
.empty()) {
408 dbgs() << "Would clobber";
409 for (SparseSet
<unsigned>::const_iterator
410 i
= LiveRegUnits
.begin(), e
= LiveRegUnits
.end(); i
!= e
; ++i
)
411 dbgs() << ' ' << printRegUnit(*i
, TRI
);
412 dbgs() << " live before " << *I
;
417 // This is a valid insertion point.
419 LLVM_DEBUG(dbgs() << "Can insert before " << *I
);
422 LLVM_DEBUG(dbgs() << "No legal insertion point found.\n");
428 /// canConvertIf - analyze the sub-cfg rooted in MBB, and return true if it is
429 /// a potential candidate for if-conversion. Fill out the internal state.
431 bool SSAIfConv::canConvertIf(MachineBasicBlock
*MBB
, bool Predicate
) {
433 TBB
= FBB
= Tail
= nullptr;
435 if (Head
->succ_size() != 2)
437 MachineBasicBlock
*Succ0
= Head
->succ_begin()[0];
438 MachineBasicBlock
*Succ1
= Head
->succ_begin()[1];
440 // Canonicalize so Succ0 has MBB as its single predecessor.
441 if (Succ0
->pred_size() != 1)
442 std::swap(Succ0
, Succ1
);
444 if (Succ0
->pred_size() != 1 || Succ0
->succ_size() != 1)
447 Tail
= Succ0
->succ_begin()[0];
449 // This is not a triangle.
451 // Check for a diamond. We won't deal with any critical edges.
452 if (Succ1
->pred_size() != 1 || Succ1
->succ_size() != 1 ||
453 Succ1
->succ_begin()[0] != Tail
)
455 LLVM_DEBUG(dbgs() << "\nDiamond: " << printMBBReference(*Head
) << " -> "
456 << printMBBReference(*Succ0
) << "/"
457 << printMBBReference(*Succ1
) << " -> "
458 << printMBBReference(*Tail
) << '\n');
460 // Live-in physregs are tricky to get right when speculating code.
461 if (!Tail
->livein_empty()) {
462 LLVM_DEBUG(dbgs() << "Tail has live-ins.\n");
466 LLVM_DEBUG(dbgs() << "\nTriangle: " << printMBBReference(*Head
) << " -> "
467 << printMBBReference(*Succ0
) << " -> "
468 << printMBBReference(*Tail
) << '\n');
471 // This is a triangle or a diamond.
472 // Skip if we cannot predicate and there are no phis skip as there must be
473 // side effects that can only be handled with predication.
474 if (!Predicate
&& (Tail
->empty() || !Tail
->front().isPHI())) {
475 LLVM_DEBUG(dbgs() << "No phis in tail.\n");
479 // The branch we're looking to eliminate must be analyzable.
481 if (TII
->analyzeBranch(*Head
, TBB
, FBB
, Cond
)) {
482 LLVM_DEBUG(dbgs() << "Branch not analyzable.\n");
486 // This is weird, probably some sort of degenerate CFG.
488 LLVM_DEBUG(dbgs() << "AnalyzeBranch didn't find conditional branch.\n");
492 // Make sure the analyzed branch is conditional; one of the successors
493 // could be a landing pad. (Empty landing pads can be generated on Windows.)
495 LLVM_DEBUG(dbgs() << "AnalyzeBranch found an unconditional branch.\n");
499 // AnalyzeBranch doesn't set FBB on a fall-through branch.
500 // Make sure it is always set.
501 FBB
= TBB
== Succ0
? Succ1
: Succ0
;
503 // Any phis in the tail block must be convertible to selects.
505 MachineBasicBlock
*TPred
= getTPred();
506 MachineBasicBlock
*FPred
= getFPred();
507 for (MachineBasicBlock::iterator I
= Tail
->begin(), E
= Tail
->end();
508 I
!= E
&& I
->isPHI(); ++I
) {
510 PHIInfo
&PI
= PHIs
.back();
511 // Find PHI operands corresponding to TPred and FPred.
512 for (unsigned i
= 1; i
!= PI
.PHI
->getNumOperands(); i
+= 2) {
513 if (PI
.PHI
->getOperand(i
+1).getMBB() == TPred
)
514 PI
.TReg
= PI
.PHI
->getOperand(i
).getReg();
515 if (PI
.PHI
->getOperand(i
+1).getMBB() == FPred
)
516 PI
.FReg
= PI
.PHI
->getOperand(i
).getReg();
518 assert(Register::isVirtualRegister(PI
.TReg
) && "Bad PHI");
519 assert(Register::isVirtualRegister(PI
.FReg
) && "Bad PHI");
521 // Get target information.
522 if (!TII
->canInsertSelect(*Head
, Cond
, PI
.TReg
, PI
.FReg
,
523 PI
.CondCycles
, PI
.TCycles
, PI
.FCycles
)) {
524 LLVM_DEBUG(dbgs() << "Can't convert: " << *PI
.PHI
);
529 // Check that the conditional instructions can be speculated.
531 ClobberedRegUnits
.reset();
533 if (TBB
!= Tail
&& !canPredicateInstrs(TBB
))
535 if (FBB
!= Tail
&& !canPredicateInstrs(FBB
))
538 if (TBB
!= Tail
&& !canSpeculateInstrs(TBB
))
540 if (FBB
!= Tail
&& !canSpeculateInstrs(FBB
))
544 // Try to find a valid insertion point for the speculated instructions in the
546 if (!findInsertionPoint())
556 /// replacePHIInstrs - Completely replace PHI instructions with selects.
557 /// This is possible when the only Tail predecessors are the if-converted
559 void SSAIfConv::replacePHIInstrs() {
560 assert(Tail
->pred_size() == 2 && "Cannot replace PHIs");
561 MachineBasicBlock::iterator FirstTerm
= Head
->getFirstTerminator();
562 assert(FirstTerm
!= Head
->end() && "No terminators");
563 DebugLoc HeadDL
= FirstTerm
->getDebugLoc();
565 // Convert all PHIs to select instructions inserted before FirstTerm.
566 for (unsigned i
= 0, e
= PHIs
.size(); i
!= e
; ++i
) {
567 PHIInfo
&PI
= PHIs
[i
];
568 LLVM_DEBUG(dbgs() << "If-converting " << *PI
.PHI
);
569 Register DstReg
= PI
.PHI
->getOperand(0).getReg();
570 TII
->insertSelect(*Head
, FirstTerm
, HeadDL
, DstReg
, Cond
, PI
.TReg
, PI
.FReg
);
571 LLVM_DEBUG(dbgs() << " --> " << *std::prev(FirstTerm
));
572 PI
.PHI
->eraseFromParent();
577 /// rewritePHIOperands - When there are additional Tail predecessors, insert
578 /// select instructions in Head and rewrite PHI operands to use the selects.
579 /// Keep the PHI instructions in Tail to handle the other predecessors.
580 void SSAIfConv::rewritePHIOperands() {
581 MachineBasicBlock::iterator FirstTerm
= Head
->getFirstTerminator();
582 assert(FirstTerm
!= Head
->end() && "No terminators");
583 DebugLoc HeadDL
= FirstTerm
->getDebugLoc();
585 // Convert all PHIs to select instructions inserted before FirstTerm.
586 for (unsigned i
= 0, e
= PHIs
.size(); i
!= e
; ++i
) {
587 PHIInfo
&PI
= PHIs
[i
];
590 LLVM_DEBUG(dbgs() << "If-converting " << *PI
.PHI
);
591 if (PI
.TReg
== PI
.FReg
) {
592 // We do not need the select instruction if both incoming values are
596 Register PHIDst
= PI
.PHI
->getOperand(0).getReg();
597 DstReg
= MRI
->createVirtualRegister(MRI
->getRegClass(PHIDst
));
598 TII
->insertSelect(*Head
, FirstTerm
, HeadDL
,
599 DstReg
, Cond
, PI
.TReg
, PI
.FReg
);
600 LLVM_DEBUG(dbgs() << " --> " << *std::prev(FirstTerm
));
603 // Rewrite PHI operands TPred -> (DstReg, Head), remove FPred.
604 for (unsigned i
= PI
.PHI
->getNumOperands(); i
!= 1; i
-= 2) {
605 MachineBasicBlock
*MBB
= PI
.PHI
->getOperand(i
-1).getMBB();
606 if (MBB
== getTPred()) {
607 PI
.PHI
->getOperand(i
-1).setMBB(Head
);
608 PI
.PHI
->getOperand(i
-2).setReg(DstReg
);
609 } else if (MBB
== getFPred()) {
610 PI
.PHI
->RemoveOperand(i
-1);
611 PI
.PHI
->RemoveOperand(i
-2);
614 LLVM_DEBUG(dbgs() << " --> " << *PI
.PHI
);
618 /// convertIf - Execute the if conversion after canConvertIf has determined the
621 /// Any basic blocks erased will be added to RemovedBlocks.
623 void SSAIfConv::convertIf(SmallVectorImpl
<MachineBasicBlock
*> &RemovedBlocks
,
625 assert(Head
&& Tail
&& TBB
&& FBB
&& "Call canConvertIf first.");
627 // Update statistics.
633 // Move all instructions into Head, except for the terminators.
636 PredicateBlock(TBB
, /*ReversePredicate=*/false);
637 Head
->splice(InsertionPoint
, TBB
, TBB
->begin(), TBB
->getFirstTerminator());
641 PredicateBlock(FBB
, /*ReversePredicate=*/true);
642 Head
->splice(InsertionPoint
, FBB
, FBB
->begin(), FBB
->getFirstTerminator());
644 // Are there extra Tail predecessors?
645 bool ExtraPreds
= Tail
->pred_size() != 2;
647 rewritePHIOperands();
651 // Fix up the CFG, temporarily leave Head without any successors.
652 Head
->removeSuccessor(TBB
);
653 Head
->removeSuccessor(FBB
, true);
655 TBB
->removeSuccessor(Tail
, true);
657 FBB
->removeSuccessor(Tail
, true);
659 // Fix up Head's terminators.
660 // It should become a single branch or a fallthrough.
661 DebugLoc HeadDL
= Head
->getFirstTerminator()->getDebugLoc();
662 TII
->removeBranch(*Head
);
664 // Erase the now empty conditional blocks. It is likely that Head can fall
665 // through to Tail, and we can join the two blocks.
667 RemovedBlocks
.push_back(TBB
);
668 TBB
->eraseFromParent();
671 RemovedBlocks
.push_back(FBB
);
672 FBB
->eraseFromParent();
675 assert(Head
->succ_empty() && "Additional head successors?");
676 if (!ExtraPreds
&& Head
->isLayoutSuccessor(Tail
)) {
677 // Splice Tail onto the end of Head.
678 LLVM_DEBUG(dbgs() << "Joining tail " << printMBBReference(*Tail
)
679 << " into head " << printMBBReference(*Head
) << '\n');
680 Head
->splice(Head
->end(), Tail
,
681 Tail
->begin(), Tail
->end());
682 Head
->transferSuccessorsAndUpdatePHIs(Tail
);
683 RemovedBlocks
.push_back(Tail
);
684 Tail
->eraseFromParent();
686 // We need a branch to Tail, let code placement work it out later.
687 LLVM_DEBUG(dbgs() << "Converting to unconditional branch.\n");
688 SmallVector
<MachineOperand
, 0> EmptyCond
;
689 TII
->insertBranch(*Head
, Tail
, nullptr, EmptyCond
, HeadDL
);
690 Head
->addSuccessor(Tail
);
692 LLVM_DEBUG(dbgs() << *Head
);
695 //===----------------------------------------------------------------------===//
696 // EarlyIfConverter Pass
697 //===----------------------------------------------------------------------===//
700 class EarlyIfConverter
: public MachineFunctionPass
{
701 const TargetInstrInfo
*TII
;
702 const TargetRegisterInfo
*TRI
;
703 MCSchedModel SchedModel
;
704 MachineRegisterInfo
*MRI
;
705 MachineDominatorTree
*DomTree
;
706 MachineLoopInfo
*Loops
;
707 MachineTraceMetrics
*Traces
;
708 MachineTraceMetrics::Ensemble
*MinInstr
;
713 EarlyIfConverter() : MachineFunctionPass(ID
) {}
714 void getAnalysisUsage(AnalysisUsage
&AU
) const override
;
715 bool runOnMachineFunction(MachineFunction
&MF
) override
;
716 StringRef
getPassName() const override
{ return "Early If-Conversion"; }
719 bool tryConvertIf(MachineBasicBlock
*);
720 void invalidateTraces();
721 bool shouldConvertIf();
723 } // end anonymous namespace
725 char EarlyIfConverter::ID
= 0;
726 char &llvm::EarlyIfConverterID
= EarlyIfConverter::ID
;
728 INITIALIZE_PASS_BEGIN(EarlyIfConverter
, DEBUG_TYPE
,
729 "Early If Converter", false, false)
730 INITIALIZE_PASS_DEPENDENCY(MachineBranchProbabilityInfo
)
731 INITIALIZE_PASS_DEPENDENCY(MachineDominatorTree
)
732 INITIALIZE_PASS_DEPENDENCY(MachineTraceMetrics
)
733 INITIALIZE_PASS_END(EarlyIfConverter
, DEBUG_TYPE
,
734 "Early If Converter", false, false)
736 void EarlyIfConverter::getAnalysisUsage(AnalysisUsage
&AU
) const {
737 AU
.addRequired
<MachineBranchProbabilityInfo
>();
738 AU
.addRequired
<MachineDominatorTree
>();
739 AU
.addPreserved
<MachineDominatorTree
>();
740 AU
.addRequired
<MachineLoopInfo
>();
741 AU
.addPreserved
<MachineLoopInfo
>();
742 AU
.addRequired
<MachineTraceMetrics
>();
743 AU
.addPreserved
<MachineTraceMetrics
>();
744 MachineFunctionPass::getAnalysisUsage(AU
);
748 /// Update the dominator tree after if-conversion erased some blocks.
749 void updateDomTree(MachineDominatorTree
*DomTree
, const SSAIfConv
&IfConv
,
750 ArrayRef
<MachineBasicBlock
*> Removed
) {
751 // convertIf can remove TBB, FBB, and Tail can be merged into Head.
752 // TBB and FBB should not dominate any blocks.
753 // Tail children should be transferred to Head.
754 MachineDomTreeNode
*HeadNode
= DomTree
->getNode(IfConv
.Head
);
755 for (auto B
: Removed
) {
756 MachineDomTreeNode
*Node
= DomTree
->getNode(B
);
757 assert(Node
!= HeadNode
&& "Cannot erase the head node");
758 while (Node
->getNumChildren()) {
759 assert(Node
->getBlock() == IfConv
.Tail
&& "Unexpected children");
760 DomTree
->changeImmediateDominator(Node
->getChildren().back(), HeadNode
);
762 DomTree
->eraseNode(B
);
766 /// Update LoopInfo after if-conversion.
767 void updateLoops(MachineLoopInfo
*Loops
,
768 ArrayRef
<MachineBasicBlock
*> Removed
) {
771 // If-conversion doesn't change loop structure, and it doesn't mess with back
772 // edges, so updating LoopInfo is simply removing the dead blocks.
773 for (auto B
: Removed
)
774 Loops
->removeBlock(B
);
778 /// Invalidate MachineTraceMetrics before if-conversion.
779 void EarlyIfConverter::invalidateTraces() {
780 Traces
->verifyAnalysis();
781 Traces
->invalidate(IfConv
.Head
);
782 Traces
->invalidate(IfConv
.Tail
);
783 Traces
->invalidate(IfConv
.TBB
);
784 Traces
->invalidate(IfConv
.FBB
);
785 Traces
->verifyAnalysis();
788 // Adjust cycles with downward saturation.
789 static unsigned adjCycles(unsigned Cyc
, int Delta
) {
790 if (Delta
< 0 && Cyc
+ Delta
> Cyc
)
795 /// Apply cost model and heuristics to the if-conversion in IfConv.
796 /// Return true if the conversion is a good idea.
798 bool EarlyIfConverter::shouldConvertIf() {
799 // Stress testing mode disables all cost considerations.
804 MinInstr
= Traces
->getEnsemble(MachineTraceMetrics::TS_MinInstrCount
);
806 MachineTraceMetrics::Trace TBBTrace
= MinInstr
->getTrace(IfConv
.getTPred());
807 MachineTraceMetrics::Trace FBBTrace
= MinInstr
->getTrace(IfConv
.getFPred());
808 LLVM_DEBUG(dbgs() << "TBB: " << TBBTrace
<< "FBB: " << FBBTrace
);
809 unsigned MinCrit
= std::min(TBBTrace
.getCriticalPath(),
810 FBBTrace
.getCriticalPath());
812 // Set a somewhat arbitrary limit on the critical path extension we accept.
813 unsigned CritLimit
= SchedModel
.MispredictPenalty
/2;
815 // If-conversion only makes sense when there is unexploited ILP. Compute the
816 // maximum-ILP resource length of the trace after if-conversion. Compare it
817 // to the shortest critical path.
818 SmallVector
<const MachineBasicBlock
*, 1> ExtraBlocks
;
819 if (IfConv
.TBB
!= IfConv
.Tail
)
820 ExtraBlocks
.push_back(IfConv
.TBB
);
821 unsigned ResLength
= FBBTrace
.getResourceLength(ExtraBlocks
);
822 LLVM_DEBUG(dbgs() << "Resource length " << ResLength
823 << ", minimal critical path " << MinCrit
<< '\n');
824 if (ResLength
> MinCrit
+ CritLimit
) {
825 LLVM_DEBUG(dbgs() << "Not enough available ILP.\n");
829 // Assume that the depth of the first head terminator will also be the depth
830 // of the select instruction inserted, as determined by the flag dependency.
831 // TBB / FBB data dependencies may delay the select even more.
832 MachineTraceMetrics::Trace HeadTrace
= MinInstr
->getTrace(IfConv
.Head
);
833 unsigned BranchDepth
=
834 HeadTrace
.getInstrCycles(*IfConv
.Head
->getFirstTerminator()).Depth
;
835 LLVM_DEBUG(dbgs() << "Branch depth: " << BranchDepth
<< '\n');
837 // Look at all the tail phis, and compute the critical path extension caused
838 // by inserting select instructions.
839 MachineTraceMetrics::Trace TailTrace
= MinInstr
->getTrace(IfConv
.Tail
);
840 for (unsigned i
= 0, e
= IfConv
.PHIs
.size(); i
!= e
; ++i
) {
841 SSAIfConv::PHIInfo
&PI
= IfConv
.PHIs
[i
];
842 unsigned Slack
= TailTrace
.getInstrSlack(*PI
.PHI
);
843 unsigned MaxDepth
= Slack
+ TailTrace
.getInstrCycles(*PI
.PHI
).Depth
;
844 LLVM_DEBUG(dbgs() << "Slack " << Slack
<< ":\t" << *PI
.PHI
);
846 // The condition is pulled into the critical path.
847 unsigned CondDepth
= adjCycles(BranchDepth
, PI
.CondCycles
);
848 if (CondDepth
> MaxDepth
) {
849 unsigned Extra
= CondDepth
- MaxDepth
;
850 LLVM_DEBUG(dbgs() << "Condition adds " << Extra
<< " cycles.\n");
851 if (Extra
> CritLimit
) {
852 LLVM_DEBUG(dbgs() << "Exceeds limit of " << CritLimit
<< '\n');
857 // The TBB value is pulled into the critical path.
858 unsigned TDepth
= adjCycles(TBBTrace
.getPHIDepth(*PI
.PHI
), PI
.TCycles
);
859 if (TDepth
> MaxDepth
) {
860 unsigned Extra
= TDepth
- MaxDepth
;
861 LLVM_DEBUG(dbgs() << "TBB data adds " << Extra
<< " cycles.\n");
862 if (Extra
> CritLimit
) {
863 LLVM_DEBUG(dbgs() << "Exceeds limit of " << CritLimit
<< '\n');
868 // The FBB value is pulled into the critical path.
869 unsigned FDepth
= adjCycles(FBBTrace
.getPHIDepth(*PI
.PHI
), PI
.FCycles
);
870 if (FDepth
> MaxDepth
) {
871 unsigned Extra
= FDepth
- MaxDepth
;
872 LLVM_DEBUG(dbgs() << "FBB data adds " << Extra
<< " cycles.\n");
873 if (Extra
> CritLimit
) {
874 LLVM_DEBUG(dbgs() << "Exceeds limit of " << CritLimit
<< '\n');
882 /// Attempt repeated if-conversion on MBB, return true if successful.
884 bool EarlyIfConverter::tryConvertIf(MachineBasicBlock
*MBB
) {
885 bool Changed
= false;
886 while (IfConv
.canConvertIf(MBB
) && shouldConvertIf()) {
887 // If-convert MBB and update analyses.
889 SmallVector
<MachineBasicBlock
*, 4> RemovedBlocks
;
890 IfConv
.convertIf(RemovedBlocks
);
892 updateDomTree(DomTree
, IfConv
, RemovedBlocks
);
893 updateLoops(Loops
, RemovedBlocks
);
898 bool EarlyIfConverter::runOnMachineFunction(MachineFunction
&MF
) {
899 LLVM_DEBUG(dbgs() << "********** EARLY IF-CONVERSION **********\n"
900 << "********** Function: " << MF
.getName() << '\n');
901 if (skipFunction(MF
.getFunction()))
904 // Only run if conversion if the target wants it.
905 const TargetSubtargetInfo
&STI
= MF
.getSubtarget();
906 if (!STI
.enableEarlyIfConversion())
909 TII
= STI
.getInstrInfo();
910 TRI
= STI
.getRegisterInfo();
911 SchedModel
= STI
.getSchedModel();
912 MRI
= &MF
.getRegInfo();
913 DomTree
= &getAnalysis
<MachineDominatorTree
>();
914 Loops
= getAnalysisIfAvailable
<MachineLoopInfo
>();
915 Traces
= &getAnalysis
<MachineTraceMetrics
>();
918 bool Changed
= false;
919 IfConv
.runOnMachineFunction(MF
);
921 // Visit blocks in dominator tree post-order. The post-order enables nested
922 // if-conversion in a single pass. The tryConvertIf() function may erase
923 // blocks, but only blocks dominated by the head block. This makes it safe to
924 // update the dominator tree while the post-order iterator is still active.
925 for (auto DomNode
: post_order(DomTree
))
926 if (tryConvertIf(DomNode
->getBlock()))
932 //===----------------------------------------------------------------------===//
933 // EarlyIfPredicator Pass
934 //===----------------------------------------------------------------------===//
937 class EarlyIfPredicator
: public MachineFunctionPass
{
938 const TargetInstrInfo
*TII
;
939 const TargetRegisterInfo
*TRI
;
940 TargetSchedModel SchedModel
;
941 MachineRegisterInfo
*MRI
;
942 MachineDominatorTree
*DomTree
;
943 MachineLoopInfo
*Loops
;
948 EarlyIfPredicator() : MachineFunctionPass(ID
) {}
949 void getAnalysisUsage(AnalysisUsage
&AU
) const override
;
950 bool runOnMachineFunction(MachineFunction
&MF
) override
;
951 StringRef
getPassName() const override
{ return "Early If-predicator"; }
954 bool tryConvertIf(MachineBasicBlock
*);
955 bool shouldConvertIf();
957 } // end anonymous namespace
960 #define DEBUG_TYPE "early-if-predicator"
962 char EarlyIfPredicator::ID
= 0;
963 char &llvm::EarlyIfPredicatorID
= EarlyIfPredicator::ID
;
965 INITIALIZE_PASS_BEGIN(EarlyIfPredicator
, DEBUG_TYPE
, "Early If Predicator",
967 INITIALIZE_PASS_DEPENDENCY(MachineDominatorTree
)
968 INITIALIZE_PASS_END(EarlyIfPredicator
, DEBUG_TYPE
, "Early If Predicator", false,
971 void EarlyIfPredicator::getAnalysisUsage(AnalysisUsage
&AU
) const {
972 AU
.addRequired
<MachineDominatorTree
>();
973 AU
.addPreserved
<MachineDominatorTree
>();
974 AU
.addRequired
<MachineLoopInfo
>();
975 AU
.addPreserved
<MachineLoopInfo
>();
976 MachineFunctionPass::getAnalysisUsage(AU
);
979 /// Apply the target heuristic to decide if the transformation is profitable.
980 bool EarlyIfPredicator::shouldConvertIf() {
981 if (IfConv
.isTriangle()) {
982 MachineBasicBlock
&IfBlock
=
983 (IfConv
.TBB
== IfConv
.Tail
) ? *IfConv
.FBB
: *IfConv
.TBB
;
985 unsigned ExtraPredCost
= 0;
987 for (MachineInstr
&I
: IfBlock
) {
988 unsigned NumCycles
= SchedModel
.computeInstrLatency(&I
, false);
990 Cycles
+= NumCycles
- 1;
991 ExtraPredCost
+= TII
->getPredicationCost(I
);
994 return TII
->isProfitableToIfCvt(IfBlock
, Cycles
, ExtraPredCost
,
995 BranchProbability::getUnknown());
1000 unsigned FCycle
= 0;
1001 for (MachineInstr
&I
: *IfConv
.TBB
) {
1002 unsigned NumCycles
= SchedModel
.computeInstrLatency(&I
, false);
1004 TCycle
+= NumCycles
- 1;
1005 TExtra
+= TII
->getPredicationCost(I
);
1007 for (MachineInstr
&I
: *IfConv
.FBB
) {
1008 unsigned NumCycles
= SchedModel
.computeInstrLatency(&I
, false);
1010 FCycle
+= NumCycles
- 1;
1011 FExtra
+= TII
->getPredicationCost(I
);
1013 return TII
->isProfitableToIfCvt(*IfConv
.TBB
, TCycle
, TExtra
, *IfConv
.FBB
,
1015 BranchProbability::getUnknown());
1018 /// Attempt repeated if-conversion on MBB, return true if successful.
1020 bool EarlyIfPredicator::tryConvertIf(MachineBasicBlock
*MBB
) {
1021 bool Changed
= false;
1022 while (IfConv
.canConvertIf(MBB
, /*Predicate*/ true) && shouldConvertIf()) {
1023 // If-convert MBB and update analyses.
1024 SmallVector
<MachineBasicBlock
*, 4> RemovedBlocks
;
1025 IfConv
.convertIf(RemovedBlocks
, /*Predicate*/ true);
1027 updateDomTree(DomTree
, IfConv
, RemovedBlocks
);
1028 updateLoops(Loops
, RemovedBlocks
);
1033 bool EarlyIfPredicator::runOnMachineFunction(MachineFunction
&MF
) {
1034 LLVM_DEBUG(dbgs() << "********** EARLY IF-PREDICATOR **********\n"
1035 << "********** Function: " << MF
.getName() << '\n');
1036 if (skipFunction(MF
.getFunction()))
1039 const TargetSubtargetInfo
&STI
= MF
.getSubtarget();
1040 TII
= STI
.getInstrInfo();
1041 TRI
= STI
.getRegisterInfo();
1042 MRI
= &MF
.getRegInfo();
1043 SchedModel
.init(&STI
);
1044 DomTree
= &getAnalysis
<MachineDominatorTree
>();
1045 Loops
= getAnalysisIfAvailable
<MachineLoopInfo
>();
1047 bool Changed
= false;
1048 IfConv
.runOnMachineFunction(MF
);
1050 // Visit blocks in dominator tree post-order. The post-order enables nested
1051 // if-conversion in a single pass. The tryConvertIf() function may erase
1052 // blocks, but only blocks dominated by the head block. This makes it safe to
1053 // update the dominator tree while the post-order iterator is still active.
1054 for (auto DomNode
: post_order(DomTree
))
1055 if (tryConvertIf(DomNode
->getBlock()))