1 //===-- ControlHeightReduction.cpp - Control Height Reduction -------------===//
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 // This pass merges conditional blocks of code and reduces the number of
10 // conditional branches in the hot paths based on profiles.
12 //===----------------------------------------------------------------------===//
14 #include "llvm/Transforms/Instrumentation/ControlHeightReduction.h"
15 #include "llvm/ADT/DenseMap.h"
16 #include "llvm/ADT/DenseSet.h"
17 #include "llvm/ADT/SmallVector.h"
18 #include "llvm/ADT/StringSet.h"
19 #include "llvm/Analysis/BlockFrequencyInfo.h"
20 #include "llvm/Analysis/GlobalsModRef.h"
21 #include "llvm/Analysis/OptimizationRemarkEmitter.h"
22 #include "llvm/Analysis/ProfileSummaryInfo.h"
23 #include "llvm/Analysis/RegionInfo.h"
24 #include "llvm/Analysis/RegionIterator.h"
25 #include "llvm/Analysis/ValueTracking.h"
26 #include "llvm/IR/CFG.h"
27 #include "llvm/IR/Dominators.h"
28 #include "llvm/IR/IRBuilder.h"
29 #include "llvm/IR/IntrinsicInst.h"
30 #include "llvm/IR/MDBuilder.h"
31 #include "llvm/IR/Module.h"
32 #include "llvm/IR/PassManager.h"
33 #include "llvm/IR/ProfDataUtils.h"
34 #include "llvm/Support/BranchProbability.h"
35 #include "llvm/Support/CommandLine.h"
36 #include "llvm/Support/MemoryBuffer.h"
37 #include "llvm/Transforms/Utils/BasicBlockUtils.h"
38 #include "llvm/Transforms/Utils/Cloning.h"
39 #include "llvm/Transforms/Utils/ValueMapper.h"
47 #define DEBUG_TYPE "chr"
49 #define CHR_DEBUG(X) LLVM_DEBUG(X)
51 static cl::opt
<bool> DisableCHR("disable-chr", cl::init(false), cl::Hidden
,
52 cl::desc("Disable CHR for all functions"));
54 static cl::opt
<bool> ForceCHR("force-chr", cl::init(false), cl::Hidden
,
55 cl::desc("Apply CHR for all functions"));
57 static cl::opt
<double> CHRBiasThreshold(
58 "chr-bias-threshold", cl::init(0.99), cl::Hidden
,
59 cl::desc("CHR considers a branch bias greater than this ratio as biased"));
61 static cl::opt
<unsigned> CHRMergeThreshold(
62 "chr-merge-threshold", cl::init(2), cl::Hidden
,
63 cl::desc("CHR merges a group of N branches/selects where N >= this value"));
65 static cl::opt
<std::string
> CHRModuleList(
66 "chr-module-list", cl::init(""), cl::Hidden
,
67 cl::desc("Specify file to retrieve the list of modules to apply CHR to"));
69 static cl::opt
<std::string
> CHRFunctionList(
70 "chr-function-list", cl::init(""), cl::Hidden
,
71 cl::desc("Specify file to retrieve the list of functions to apply CHR to"));
73 static cl::opt
<unsigned> CHRDupThreshsold(
74 "chr-dup-threshold", cl::init(3), cl::Hidden
,
75 cl::desc("Max number of duplications by CHR for a region"));
77 static StringSet
<> CHRModules
;
78 static StringSet
<> CHRFunctions
;
80 static void parseCHRFilterFiles() {
81 if (!CHRModuleList
.empty()) {
82 auto FileOrErr
= MemoryBuffer::getFile(CHRModuleList
);
84 errs() << "Error: Couldn't read the chr-module-list file " << CHRModuleList
<< "\n";
87 StringRef Buf
= FileOrErr
->get()->getBuffer();
88 SmallVector
<StringRef
, 0> Lines
;
89 Buf
.split(Lines
, '\n');
90 for (StringRef Line
: Lines
) {
93 CHRModules
.insert(Line
);
96 if (!CHRFunctionList
.empty()) {
97 auto FileOrErr
= MemoryBuffer::getFile(CHRFunctionList
);
99 errs() << "Error: Couldn't read the chr-function-list file " << CHRFunctionList
<< "\n";
102 StringRef Buf
= FileOrErr
->get()->getBuffer();
103 SmallVector
<StringRef
, 0> Lines
;
104 Buf
.split(Lines
, '\n');
105 for (StringRef Line
: Lines
) {
108 CHRFunctions
.insert(Line
);
116 CHRStats() = default;
117 void print(raw_ostream
&OS
) const {
118 OS
<< "CHRStats: NumBranches " << NumBranches
119 << " NumBranchesDelta " << NumBranchesDelta
120 << " WeightedNumBranchesDelta " << WeightedNumBranchesDelta
;
122 // The original number of conditional branches / selects
123 uint64_t NumBranches
= 0;
124 // The decrease of the number of conditional branches / selects in the hot
126 uint64_t NumBranchesDelta
= 0;
127 // NumBranchesDelta weighted by the profile count at the scope entry.
128 uint64_t WeightedNumBranchesDelta
= 0;
131 // RegInfo - some properties of a Region.
134 RegInfo(Region
*RegionIn
) : R(RegionIn
) {}
136 bool HasBranch
= false;
137 SmallVector
<SelectInst
*, 8> Selects
;
140 typedef DenseMap
<Region
*, DenseSet
<Instruction
*>> HoistStopMapTy
;
142 // CHRScope - a sequence of regions to CHR together. It corresponds to a
143 // sequence of conditional blocks. It can have subscopes which correspond to
144 // nested conditional blocks. Nested CHRScopes form a tree.
147 CHRScope(RegInfo RI
) : BranchInsertPoint(nullptr) {
148 assert(RI
.R
&& "Null RegionIn");
149 RegInfos
.push_back(RI
);
152 Region
*getParentRegion() {
153 assert(RegInfos
.size() > 0 && "Empty CHRScope");
154 Region
*Parent
= RegInfos
[0].R
->getParent();
155 assert(Parent
&& "Unexpected to call this on the top-level region");
159 BasicBlock
*getEntryBlock() {
160 assert(RegInfos
.size() > 0 && "Empty CHRScope");
161 return RegInfos
.front().R
->getEntry();
164 BasicBlock
*getExitBlock() {
165 assert(RegInfos
.size() > 0 && "Empty CHRScope");
166 return RegInfos
.back().R
->getExit();
169 bool appendable(CHRScope
*Next
) {
170 // The next scope is appendable only if this scope is directly connected to
171 // it (which implies it post-dominates this scope) and this scope dominates
172 // it (no edge to the next scope outside this scope).
173 BasicBlock
*NextEntry
= Next
->getEntryBlock();
174 if (getExitBlock() != NextEntry
)
175 // Not directly connected.
177 Region
*LastRegion
= RegInfos
.back().R
;
178 for (BasicBlock
*Pred
: predecessors(NextEntry
))
179 if (!LastRegion
->contains(Pred
))
180 // There's an edge going into the entry of the next scope from outside
186 void append(CHRScope
*Next
) {
187 assert(RegInfos
.size() > 0 && "Empty CHRScope");
188 assert(Next
->RegInfos
.size() > 0 && "Empty CHRScope");
189 assert(getParentRegion() == Next
->getParentRegion() &&
191 assert(getExitBlock() == Next
->getEntryBlock() &&
193 RegInfos
.append(Next
->RegInfos
.begin(), Next
->RegInfos
.end());
194 Subs
.append(Next
->Subs
.begin(), Next
->Subs
.end());
197 void addSub(CHRScope
*SubIn
) {
199 bool IsChild
= false;
200 for (RegInfo
&RI
: RegInfos
)
201 if (RI
.R
== SubIn
->getParentRegion()) {
205 assert(IsChild
&& "Must be a child");
207 Subs
.push_back(SubIn
);
210 // Split this scope at the boundary region into two, which will belong to the
211 // tail and returns the tail.
212 CHRScope
*split(Region
*Boundary
) {
213 assert(Boundary
&& "Boundary null");
214 assert(RegInfos
.begin()->R
!= Boundary
&&
215 "Can't be split at beginning");
216 auto BoundaryIt
= llvm::find_if(
217 RegInfos
, [&Boundary
](const RegInfo
&RI
) { return Boundary
== RI
.R
; });
218 if (BoundaryIt
== RegInfos
.end())
220 ArrayRef
<RegInfo
> TailRegInfos(BoundaryIt
, RegInfos
.end());
221 DenseSet
<Region
*> TailRegionSet
;
222 for (const RegInfo
&RI
: TailRegInfos
)
223 TailRegionSet
.insert(RI
.R
);
226 std::stable_partition(Subs
.begin(), Subs
.end(), [&](CHRScope
*Sub
) {
227 assert(Sub
&& "null Sub");
228 Region
*Parent
= Sub
->getParentRegion();
229 if (TailRegionSet
.count(Parent
))
234 [&Parent
](const RegInfo
&RI
) { return Parent
== RI
.R
; }) &&
238 ArrayRef
<CHRScope
*> TailSubs(TailIt
, Subs
.end());
240 assert(HoistStopMap
.empty() && "MapHoistStops must be empty");
241 auto *Scope
= new CHRScope(TailRegInfos
, TailSubs
);
242 RegInfos
.erase(BoundaryIt
, RegInfos
.end());
243 Subs
.erase(TailIt
, Subs
.end());
247 bool contains(Instruction
*I
) const {
248 BasicBlock
*Parent
= I
->getParent();
249 for (const RegInfo
&RI
: RegInfos
)
250 if (RI
.R
->contains(Parent
))
255 void print(raw_ostream
&OS
) const;
257 SmallVector
<RegInfo
, 8> RegInfos
; // Regions that belong to this scope
258 SmallVector
<CHRScope
*, 8> Subs
; // Subscopes.
260 // The instruction at which to insert the CHR conditional branch (and hoist
261 // the dependent condition values).
262 Instruction
*BranchInsertPoint
;
264 // True-biased and false-biased regions (conditional blocks),
265 // respectively. Used only for the outermost scope and includes regions in
266 // subscopes. The rest are unbiased.
267 DenseSet
<Region
*> TrueBiasedRegions
;
268 DenseSet
<Region
*> FalseBiasedRegions
;
269 // Among the biased regions, the regions that get CHRed.
270 SmallVector
<RegInfo
, 8> CHRRegions
;
272 // True-biased and false-biased selects, respectively. Used only for the
273 // outermost scope and includes ones in subscopes.
274 DenseSet
<SelectInst
*> TrueBiasedSelects
;
275 DenseSet
<SelectInst
*> FalseBiasedSelects
;
277 // Map from one of the above regions to the instructions to stop
278 // hoisting instructions at through use-def chains.
279 HoistStopMapTy HoistStopMap
;
282 CHRScope(ArrayRef
<RegInfo
> RegInfosIn
, ArrayRef
<CHRScope
*> SubsIn
)
283 : RegInfos(RegInfosIn
), Subs(SubsIn
), BranchInsertPoint(nullptr) {}
288 CHR(Function
&Fin
, BlockFrequencyInfo
&BFIin
, DominatorTree
&DTin
,
289 ProfileSummaryInfo
&PSIin
, RegionInfo
&RIin
,
290 OptimizationRemarkEmitter
&OREin
)
291 : F(Fin
), BFI(BFIin
), DT(DTin
), PSI(PSIin
), RI(RIin
), ORE(OREin
) {}
294 for (CHRScope
*Scope
: Scopes
) {
302 // See the comments in CHR::run() for the high level flow of the algorithm and
303 // what the following functions do.
305 void findScopes(SmallVectorImpl
<CHRScope
*> &Output
) {
306 Region
*R
= RI
.getTopLevelRegion();
307 if (CHRScope
*Scope
= findScopes(R
, nullptr, nullptr, Output
)) {
308 Output
.push_back(Scope
);
311 CHRScope
*findScopes(Region
*R
, Region
*NextRegion
, Region
*ParentRegion
,
312 SmallVectorImpl
<CHRScope
*> &Scopes
);
313 CHRScope
*findScope(Region
*R
);
314 void checkScopeHoistable(CHRScope
*Scope
);
316 void splitScopes(SmallVectorImpl
<CHRScope
*> &Input
,
317 SmallVectorImpl
<CHRScope
*> &Output
);
318 SmallVector
<CHRScope
*, 8> splitScope(CHRScope
*Scope
,
320 DenseSet
<Value
*> *OuterConditionValues
,
321 Instruction
*OuterInsertPoint
,
322 SmallVectorImpl
<CHRScope
*> &Output
,
323 DenseSet
<Instruction
*> &Unhoistables
);
325 void classifyBiasedScopes(SmallVectorImpl
<CHRScope
*> &Scopes
);
326 void classifyBiasedScopes(CHRScope
*Scope
, CHRScope
*OutermostScope
);
328 void filterScopes(SmallVectorImpl
<CHRScope
*> &Input
,
329 SmallVectorImpl
<CHRScope
*> &Output
);
331 void setCHRRegions(SmallVectorImpl
<CHRScope
*> &Input
,
332 SmallVectorImpl
<CHRScope
*> &Output
);
333 void setCHRRegions(CHRScope
*Scope
, CHRScope
*OutermostScope
);
335 void sortScopes(SmallVectorImpl
<CHRScope
*> &Input
,
336 SmallVectorImpl
<CHRScope
*> &Output
);
338 void transformScopes(SmallVectorImpl
<CHRScope
*> &CHRScopes
);
339 void transformScopes(CHRScope
*Scope
, DenseSet
<PHINode
*> &TrivialPHIs
);
340 void cloneScopeBlocks(CHRScope
*Scope
,
341 BasicBlock
*PreEntryBlock
,
342 BasicBlock
*ExitBlock
,
344 ValueToValueMapTy
&VMap
);
345 BranchInst
*createMergedBranch(BasicBlock
*PreEntryBlock
,
346 BasicBlock
*EntryBlock
,
347 BasicBlock
*NewEntryBlock
,
348 ValueToValueMapTy
&VMap
);
349 void fixupBranchesAndSelects(CHRScope
*Scope
, BasicBlock
*PreEntryBlock
,
350 BranchInst
*MergedBR
, uint64_t ProfileCount
);
351 void fixupBranch(Region
*R
, CHRScope
*Scope
, IRBuilder
<> &IRB
,
352 Value
*&MergedCondition
, BranchProbability
&CHRBranchBias
);
353 void fixupSelect(SelectInst
*SI
, CHRScope
*Scope
, IRBuilder
<> &IRB
,
354 Value
*&MergedCondition
, BranchProbability
&CHRBranchBias
);
355 void addToMergedCondition(bool IsTrueBiased
, Value
*Cond
,
356 Instruction
*BranchOrSelect
, CHRScope
*Scope
,
357 IRBuilder
<> &IRB
, Value
*&MergedCondition
);
358 unsigned getRegionDuplicationCount(const Region
*R
) {
360 // Find out how many times region R is cloned. Note that if the parent
361 // of R is cloned, R is also cloned, but R's clone count is not updated
362 // from the clone of the parent. We need to accumlate all the counts
363 // from the ancestors to get the clone count.
365 Count
+= DuplicationCount
[R
];
372 BlockFrequencyInfo
&BFI
;
374 ProfileSummaryInfo
&PSI
;
376 OptimizationRemarkEmitter
&ORE
;
379 // All the true-biased regions in the function
380 DenseSet
<Region
*> TrueBiasedRegionsGlobal
;
381 // All the false-biased regions in the function
382 DenseSet
<Region
*> FalseBiasedRegionsGlobal
;
383 // All the true-biased selects in the function
384 DenseSet
<SelectInst
*> TrueBiasedSelectsGlobal
;
385 // All the false-biased selects in the function
386 DenseSet
<SelectInst
*> FalseBiasedSelectsGlobal
;
387 // A map from biased regions to their branch bias
388 DenseMap
<Region
*, BranchProbability
> BranchBiasMap
;
389 // A map from biased selects to their branch bias
390 DenseMap
<SelectInst
*, BranchProbability
> SelectBiasMap
;
392 DenseSet
<CHRScope
*> Scopes
;
393 // This maps records how many times this region is cloned.
394 DenseMap
<const Region
*, unsigned> DuplicationCount
;
397 } // end anonymous namespace
400 raw_ostream LLVM_ATTRIBUTE_UNUSED
&operator<<(raw_ostream
&OS
,
401 const CHRStats
&Stats
) {
407 raw_ostream
&operator<<(raw_ostream
&OS
, const CHRScope
&Scope
) {
412 static bool shouldApply(Function
&F
, ProfileSummaryInfo
&PSI
) {
419 if (!CHRModuleList
.empty() || !CHRFunctionList
.empty()) {
420 if (CHRModules
.count(F
.getParent()->getName()))
422 return CHRFunctions
.count(F
.getName());
425 return PSI
.isFunctionEntryHot(&F
);
428 static void LLVM_ATTRIBUTE_UNUSED
dumpIR(Function
&F
, const char *Label
,
430 StringRef FuncName
= F
.getName();
431 StringRef ModuleName
= F
.getParent()->getName();
432 (void)(FuncName
); // Unused in release build.
433 (void)(ModuleName
); // Unused in release build.
434 CHR_DEBUG(dbgs() << "CHR IR dump " << Label
<< " " << ModuleName
<< " "
437 CHR_DEBUG(dbgs() << " " << *Stats
);
438 CHR_DEBUG(dbgs() << "\n");
442 void CHRScope::print(raw_ostream
&OS
) const {
443 assert(RegInfos
.size() > 0 && "Empty CHRScope");
445 OS
<< RegInfos
.size() << ", Regions[";
446 for (const RegInfo
&RI
: RegInfos
) {
447 OS
<< RI
.R
->getNameStr();
450 if (RI
.Selects
.size() > 0)
451 OS
<< " S" << RI
.Selects
.size();
454 if (RegInfos
[0].R
->getParent()) {
455 OS
<< "], Parent " << RegInfos
[0].R
->getParent()->getNameStr();
461 for (CHRScope
*Sub
: Subs
) {
467 // Return true if the given instruction type can be hoisted by CHR.
468 static bool isHoistableInstructionType(Instruction
*I
) {
469 return isa
<BinaryOperator
>(I
) || isa
<CastInst
>(I
) || isa
<SelectInst
>(I
) ||
470 isa
<GetElementPtrInst
>(I
) || isa
<CmpInst
>(I
) ||
471 isa
<InsertElementInst
>(I
) || isa
<ExtractElementInst
>(I
) ||
472 isa
<ShuffleVectorInst
>(I
) || isa
<ExtractValueInst
>(I
) ||
473 isa
<InsertValueInst
>(I
);
476 // Return true if the given instruction can be hoisted by CHR.
477 static bool isHoistable(Instruction
*I
, DominatorTree
&DT
) {
478 if (!isHoistableInstructionType(I
))
480 return isSafeToSpeculativelyExecute(I
, nullptr, nullptr, &DT
);
483 // Recursively traverse the use-def chains of the given value and return a set
484 // of the unhoistable base values defined within the scope (excluding the
485 // first-region entry block) or the (hoistable or unhoistable) base values that
486 // are defined outside (including the first-region entry block) of the
487 // scope. The returned set doesn't include constants.
488 static const std::set
<Value
*> &
489 getBaseValues(Value
*V
, DominatorTree
&DT
,
490 DenseMap
<Value
*, std::set
<Value
*>> &Visited
) {
491 auto It
= Visited
.find(V
);
492 if (It
!= Visited
.end()) {
495 std::set
<Value
*> Result
;
496 if (auto *I
= dyn_cast
<Instruction
>(V
)) {
497 // We don't stop at a block that's not in the Scope because we would miss
498 // some instructions that are based on the same base values if we stop
500 if (!isHoistable(I
, DT
)) {
502 return Visited
.insert(std::make_pair(V
, std::move(Result
))).first
->second
;
504 // I is hoistable above the Scope.
505 for (Value
*Op
: I
->operands()) {
506 const std::set
<Value
*> &OpResult
= getBaseValues(Op
, DT
, Visited
);
507 Result
.insert(OpResult
.begin(), OpResult
.end());
509 return Visited
.insert(std::make_pair(V
, std::move(Result
))).first
->second
;
511 if (isa
<Argument
>(V
)) {
514 // We don't include others like constants because those won't lead to any
515 // chance of folding of conditions (eg two bit checks merged into one check)
517 return Visited
.insert(std::make_pair(V
, std::move(Result
))).first
->second
;
520 // Return true if V is already hoisted or can be hoisted (along with its
521 // operands) above the insert point. When it returns true and HoistStops is
522 // non-null, the instructions to stop hoisting at through the use-def chains are
523 // inserted into HoistStops.
525 checkHoistValue(Value
*V
, Instruction
*InsertPoint
, DominatorTree
&DT
,
526 DenseSet
<Instruction
*> &Unhoistables
,
527 DenseSet
<Instruction
*> *HoistStops
,
528 DenseMap
<Instruction
*, bool> &Visited
) {
529 assert(InsertPoint
&& "Null InsertPoint");
530 if (auto *I
= dyn_cast
<Instruction
>(V
)) {
531 auto It
= Visited
.find(I
);
532 if (It
!= Visited
.end()) {
535 assert(DT
.getNode(I
->getParent()) && "DT must contain I's parent block");
536 assert(DT
.getNode(InsertPoint
->getParent()) && "DT must contain Destination");
537 if (Unhoistables
.count(I
)) {
538 // Don't hoist if they are not to be hoisted.
542 if (DT
.dominates(I
, InsertPoint
)) {
543 // We are already above the insert point. Stop here.
545 HoistStops
->insert(I
);
549 // We aren't not above the insert point, check if we can hoist it above the
551 if (isHoistable(I
, DT
)) {
552 // Check operands first.
553 DenseSet
<Instruction
*> OpsHoistStops
;
554 bool AllOpsHoisted
= true;
555 for (Value
*Op
: I
->operands()) {
556 if (!checkHoistValue(Op
, InsertPoint
, DT
, Unhoistables
, &OpsHoistStops
,
558 AllOpsHoisted
= false;
563 CHR_DEBUG(dbgs() << "checkHoistValue " << *I
<< "\n");
565 HoistStops
->insert(OpsHoistStops
.begin(), OpsHoistStops
.end());
573 // Non-instructions are considered hoistable.
577 // Constructs the true and false branch probabilities if the the instruction has
578 // valid branch weights. Returns true when this was successful, false otherwise.
579 static bool extractBranchProbabilities(Instruction
*I
,
580 BranchProbability
&TrueProb
,
581 BranchProbability
&FalseProb
) {
583 uint64_t FalseWeight
;
584 if (!extractBranchWeights(*I
, TrueWeight
, FalseWeight
))
586 uint64_t SumWeight
= TrueWeight
+ FalseWeight
;
588 assert(SumWeight
>= TrueWeight
&& SumWeight
>= FalseWeight
&&
589 "Overflow calculating branch probabilities.");
591 // Guard against 0-to-0 branch weights to avoid a division-by-zero crash.
595 TrueProb
= BranchProbability::getBranchProbability(TrueWeight
, SumWeight
);
596 FalseProb
= BranchProbability::getBranchProbability(FalseWeight
, SumWeight
);
600 static BranchProbability
getCHRBiasThreshold() {
601 return BranchProbability::getBranchProbability(
602 static_cast<uint64_t>(CHRBiasThreshold
* 1000000), 1000000);
605 // A helper for CheckBiasedBranch and CheckBiasedSelect. If TrueProb >=
606 // CHRBiasThreshold, put Key into TrueSet and return true. If FalseProb >=
607 // CHRBiasThreshold, put Key into FalseSet and return true. Otherwise, return
609 template <typename K
, typename S
, typename M
>
610 static bool checkBias(K
*Key
, BranchProbability TrueProb
,
611 BranchProbability FalseProb
, S
&TrueSet
, S
&FalseSet
,
613 BranchProbability Threshold
= getCHRBiasThreshold();
614 if (TrueProb
>= Threshold
) {
616 BiasMap
[Key
] = TrueProb
;
618 } else if (FalseProb
>= Threshold
) {
619 FalseSet
.insert(Key
);
620 BiasMap
[Key
] = FalseProb
;
626 // Returns true and insert a region into the right biased set and the map if the
627 // branch of the region is biased.
628 static bool checkBiasedBranch(BranchInst
*BI
, Region
*R
,
629 DenseSet
<Region
*> &TrueBiasedRegionsGlobal
,
630 DenseSet
<Region
*> &FalseBiasedRegionsGlobal
,
631 DenseMap
<Region
*, BranchProbability
> &BranchBiasMap
) {
632 if (!BI
->isConditional())
634 BranchProbability ThenProb
, ElseProb
;
635 if (!extractBranchProbabilities(BI
, ThenProb
, ElseProb
))
637 BasicBlock
*IfThen
= BI
->getSuccessor(0);
638 BasicBlock
*IfElse
= BI
->getSuccessor(1);
639 assert((IfThen
== R
->getExit() || IfElse
== R
->getExit()) &&
641 "Invariant from findScopes");
642 if (IfThen
== R
->getExit()) {
643 // Swap them so that IfThen/ThenProb means going into the conditional code
644 // and IfElse/ElseProb means skipping it.
645 std::swap(IfThen
, IfElse
);
646 std::swap(ThenProb
, ElseProb
);
648 CHR_DEBUG(dbgs() << "BI " << *BI
<< " ");
649 CHR_DEBUG(dbgs() << "ThenProb " << ThenProb
<< " ");
650 CHR_DEBUG(dbgs() << "ElseProb " << ElseProb
<< "\n");
651 return checkBias(R
, ThenProb
, ElseProb
,
652 TrueBiasedRegionsGlobal
, FalseBiasedRegionsGlobal
,
656 // Returns true and insert a select into the right biased set and the map if the
658 static bool checkBiasedSelect(
659 SelectInst
*SI
, Region
*R
,
660 DenseSet
<SelectInst
*> &TrueBiasedSelectsGlobal
,
661 DenseSet
<SelectInst
*> &FalseBiasedSelectsGlobal
,
662 DenseMap
<SelectInst
*, BranchProbability
> &SelectBiasMap
) {
663 BranchProbability TrueProb
, FalseProb
;
664 if (!extractBranchProbabilities(SI
, TrueProb
, FalseProb
))
666 CHR_DEBUG(dbgs() << "SI " << *SI
<< " ");
667 CHR_DEBUG(dbgs() << "TrueProb " << TrueProb
<< " ");
668 CHR_DEBUG(dbgs() << "FalseProb " << FalseProb
<< "\n");
669 return checkBias(SI
, TrueProb
, FalseProb
,
670 TrueBiasedSelectsGlobal
, FalseBiasedSelectsGlobal
,
674 // Returns the instruction at which to hoist the dependent condition values and
675 // insert the CHR branch for a region. This is the terminator branch in the
676 // entry block or the first select in the entry block, if any.
677 static Instruction
* getBranchInsertPoint(RegInfo
&RI
) {
679 BasicBlock
*EntryBB
= R
->getEntry();
680 // The hoist point is by default the terminator of the entry block, which is
681 // the same as the branch instruction if RI.HasBranch is true.
682 Instruction
*HoistPoint
= EntryBB
->getTerminator();
683 for (SelectInst
*SI
: RI
.Selects
) {
684 if (SI
->getParent() == EntryBB
) {
685 // Pick the first select in Selects in the entry block. Note Selects is
686 // sorted in the instruction order within a block (asserted below).
691 assert(HoistPoint
&& "Null HoistPoint");
693 // Check that HoistPoint is the first one in Selects in the entry block,
695 DenseSet
<Instruction
*> EntryBlockSelectSet
;
696 for (SelectInst
*SI
: RI
.Selects
) {
697 if (SI
->getParent() == EntryBB
) {
698 EntryBlockSelectSet
.insert(SI
);
701 for (Instruction
&I
: *EntryBB
) {
702 if (EntryBlockSelectSet
.contains(&I
)) {
703 assert(&I
== HoistPoint
&&
704 "HoistPoint must be the first one in Selects");
712 // Find a CHR scope in the given region.
713 CHRScope
* CHR::findScope(Region
*R
) {
714 CHRScope
*Result
= nullptr;
715 BasicBlock
*Entry
= R
->getEntry();
716 BasicBlock
*Exit
= R
->getExit(); // null if top level.
717 assert(Entry
&& "Entry must not be null");
718 assert((Exit
== nullptr) == (R
->isTopLevelRegion()) &&
719 "Only top level region has a null exit");
721 CHR_DEBUG(dbgs() << "Entry " << Entry
->getName() << "\n");
723 CHR_DEBUG(dbgs() << "Entry null\n");
725 CHR_DEBUG(dbgs() << "Exit " << Exit
->getName() << "\n");
727 CHR_DEBUG(dbgs() << "Exit null\n");
728 // Exclude cases where Entry is part of a subregion (hence it doesn't belong
730 bool EntryInSubregion
= RI
.getRegionFor(Entry
) != R
;
731 if (EntryInSubregion
)
734 for (BasicBlock
*Pred
: predecessors(Entry
))
735 if (R
->contains(Pred
))
737 // If any of the basic blocks have address taken, we must skip this region
738 // because we cannot clone basic blocks that have address taken.
739 for (BasicBlock
*BB
: R
->blocks()) {
740 if (BB
->hasAddressTaken())
742 // If we encounter llvm.coro.id, skip this region because if the basic block
743 // is cloned, we end up inserting a token type PHI node to the block with
745 // FIXME: This could lead to less optimal codegen, because the region is
746 // excluded, it can prevent CHR from merging adjacent regions into bigger
747 // scope and hoisting more branches.
748 for (Instruction
&I
: *BB
)
749 if (auto *II
= dyn_cast
<IntrinsicInst
>(&I
))
750 if (II
->getIntrinsicID() == Intrinsic::coro_id
)
755 // Try to find an if-then block (check if R is an if-then).
759 auto *BI
= dyn_cast
<BranchInst
>(Entry
->getTerminator());
761 CHR_DEBUG(dbgs() << "BI.isConditional " << BI
->isConditional() << "\n");
763 CHR_DEBUG(dbgs() << "BI null\n");
764 if (BI
&& BI
->isConditional()) {
765 BasicBlock
*S0
= BI
->getSuccessor(0);
766 BasicBlock
*S1
= BI
->getSuccessor(1);
767 CHR_DEBUG(dbgs() << "S0 " << S0
->getName() << "\n");
768 CHR_DEBUG(dbgs() << "S1 " << S1
->getName() << "\n");
769 if (S0
!= S1
&& (S0
== Exit
|| S1
== Exit
)) {
771 RI
.HasBranch
= checkBiasedBranch(
772 BI
, R
, TrueBiasedRegionsGlobal
, FalseBiasedRegionsGlobal
,
774 Result
= new CHRScope(RI
);
775 Scopes
.insert(Result
);
776 CHR_DEBUG(dbgs() << "Found a region with a branch\n");
780 return OptimizationRemarkMissed(DEBUG_TYPE
, "BranchNotBiased", BI
)
781 << "Branch not biased";
788 // Try to look for selects in the direct child blocks (as opposed to in
791 // if (..) { // Some subregion
794 // if (..) { // Some subregion
800 SmallVector
<SelectInst
*, 8> Selects
;
801 for (RegionNode
*E
: R
->elements()) {
802 if (E
->isSubRegion())
804 // This returns the basic block of E if E is a direct child of R (not a
806 BasicBlock
*BB
= E
->getEntry();
807 // Need to push in the order to make it easier to find the first Select
809 for (Instruction
&I
: *BB
) {
810 if (auto *SI
= dyn_cast
<SelectInst
>(&I
)) {
811 Selects
.push_back(SI
);
816 if (Selects
.size() > 0) {
817 auto AddSelects
= [&](RegInfo
&RI
) {
818 for (auto *SI
: Selects
)
819 if (checkBiasedSelect(SI
, RI
.R
,
820 TrueBiasedSelectsGlobal
,
821 FalseBiasedSelectsGlobal
,
823 RI
.Selects
.push_back(SI
);
826 return OptimizationRemarkMissed(DEBUG_TYPE
, "SelectNotBiased", SI
)
827 << "Select not biased";
831 CHR_DEBUG(dbgs() << "Found a select-only region\n");
834 Result
= new CHRScope(RI
);
835 Scopes
.insert(Result
);
837 CHR_DEBUG(dbgs() << "Found select(s) in a region with a branch\n");
838 AddSelects(Result
->RegInfos
[0]);
844 checkScopeHoistable(Result
);
849 // Check that any of the branch and the selects in the region could be
850 // hoisted above the the CHR branch insert point (the most dominating of
851 // them, either the branch (at the end of the first block) or the first
852 // select in the first block). If the branch can't be hoisted, drop the
853 // selects in the first blocks.
855 // For example, for the following scope/region with selects, we want to insert
856 // the merged branch right before the first select in the first/entry block by
857 // hoisting c1, c2, c3, and c4.
859 // // Branch insert point here.
860 // a = c1 ? b : c; // Select 1
861 // d = c2 ? e : f; // Select 2
862 // if (c3) { // Branch
864 // c4 = foo() // A call.
865 // g = c4 ? h : i; // Select 3
868 // But suppose we can't hoist c4 because it's dependent on the preceding
869 // call. Then, we drop Select 3. Furthermore, if we can't hoist c2, we also drop
870 // Select 2. If we can't hoist c3, we drop Selects 1 & 2.
871 void CHR::checkScopeHoistable(CHRScope
*Scope
) {
872 RegInfo
&RI
= Scope
->RegInfos
[0];
874 BasicBlock
*EntryBB
= R
->getEntry();
875 auto *Branch
= RI
.HasBranch
?
876 cast
<BranchInst
>(EntryBB
->getTerminator()) : nullptr;
877 SmallVector
<SelectInst
*, 8> &Selects
= RI
.Selects
;
878 if (RI
.HasBranch
|| !Selects
.empty()) {
879 Instruction
*InsertPoint
= getBranchInsertPoint(RI
);
880 CHR_DEBUG(dbgs() << "InsertPoint " << *InsertPoint
<< "\n");
881 // Avoid a data dependence from a select or a branch to a(nother)
882 // select. Note no instruction can't data-depend on a branch (a branch
883 // instruction doesn't produce a value).
884 DenseSet
<Instruction
*> Unhoistables
;
885 // Initialize Unhoistables with the selects.
886 for (SelectInst
*SI
: Selects
) {
887 Unhoistables
.insert(SI
);
889 // Remove Selects that can't be hoisted.
890 for (auto it
= Selects
.begin(); it
!= Selects
.end(); ) {
891 SelectInst
*SI
= *it
;
892 if (SI
== InsertPoint
) {
896 DenseMap
<Instruction
*, bool> Visited
;
897 bool IsHoistable
= checkHoistValue(SI
->getCondition(), InsertPoint
,
898 DT
, Unhoistables
, nullptr, Visited
);
900 CHR_DEBUG(dbgs() << "Dropping select " << *SI
<< "\n");
902 return OptimizationRemarkMissed(DEBUG_TYPE
,
903 "DropUnhoistableSelect", SI
)
904 << "Dropped unhoistable select";
906 it
= Selects
.erase(it
);
907 // Since we are dropping the select here, we also drop it from
909 Unhoistables
.erase(SI
);
913 // Update InsertPoint after potentially removing selects.
914 InsertPoint
= getBranchInsertPoint(RI
);
915 CHR_DEBUG(dbgs() << "InsertPoint " << *InsertPoint
<< "\n");
916 if (RI
.HasBranch
&& InsertPoint
!= Branch
) {
917 DenseMap
<Instruction
*, bool> Visited
;
918 bool IsHoistable
= checkHoistValue(Branch
->getCondition(), InsertPoint
,
919 DT
, Unhoistables
, nullptr, Visited
);
921 // If the branch isn't hoistable, drop the selects in the entry
922 // block, preferring the branch, which makes the branch the hoist
924 assert(InsertPoint
!= Branch
&& "Branch must not be the hoist point");
925 CHR_DEBUG(dbgs() << "Dropping selects in entry block \n");
927 for (SelectInst
*SI
: Selects
) {
928 dbgs() << "SI " << *SI
<< "\n";
930 for (SelectInst
*SI
: Selects
) {
932 return OptimizationRemarkMissed(DEBUG_TYPE
,
933 "DropSelectUnhoistableBranch", SI
)
934 << "Dropped select due to unhoistable branch";
937 llvm::erase_if(Selects
, [EntryBB
](SelectInst
*SI
) {
938 return SI
->getParent() == EntryBB
;
940 Unhoistables
.clear();
941 InsertPoint
= Branch
;
944 CHR_DEBUG(dbgs() << "InsertPoint " << *InsertPoint
<< "\n");
947 assert(!DT
.dominates(Branch
, InsertPoint
) &&
948 "Branch can't be already above the hoist point");
949 DenseMap
<Instruction
*, bool> Visited
;
950 assert(checkHoistValue(Branch
->getCondition(), InsertPoint
,
951 DT
, Unhoistables
, nullptr, Visited
) &&
952 "checkHoistValue for branch");
954 for (auto *SI
: Selects
) {
955 assert(!DT
.dominates(SI
, InsertPoint
) &&
956 "SI can't be already above the hoist point");
957 DenseMap
<Instruction
*, bool> Visited
;
958 assert(checkHoistValue(SI
->getCondition(), InsertPoint
, DT
,
959 Unhoistables
, nullptr, Visited
) &&
960 "checkHoistValue for selects");
962 CHR_DEBUG(dbgs() << "Result\n");
964 CHR_DEBUG(dbgs() << "BI " << *Branch
<< "\n");
966 for (auto *SI
: Selects
) {
967 CHR_DEBUG(dbgs() << "SI " << *SI
<< "\n");
973 // Traverse the region tree, find all nested scopes and merge them if possible.
974 CHRScope
* CHR::findScopes(Region
*R
, Region
*NextRegion
, Region
*ParentRegion
,
975 SmallVectorImpl
<CHRScope
*> &Scopes
) {
976 CHR_DEBUG(dbgs() << "findScopes " << R
->getNameStr() << "\n");
977 CHRScope
*Result
= findScope(R
);
979 CHRScope
*ConsecutiveSubscope
= nullptr;
980 SmallVector
<CHRScope
*, 8> Subscopes
;
981 for (auto It
= R
->begin(); It
!= R
->end(); ++It
) {
982 const std::unique_ptr
<Region
> &SubR
= *It
;
983 auto NextIt
= std::next(It
);
984 Region
*NextSubR
= NextIt
!= R
->end() ? NextIt
->get() : nullptr;
985 CHR_DEBUG(dbgs() << "Looking at subregion " << SubR
.get()->getNameStr()
987 CHRScope
*SubCHRScope
= findScopes(SubR
.get(), NextSubR
, R
, Scopes
);
989 CHR_DEBUG(dbgs() << "Subregion Scope " << *SubCHRScope
<< "\n");
991 CHR_DEBUG(dbgs() << "Subregion Scope null\n");
994 if (!ConsecutiveSubscope
)
995 ConsecutiveSubscope
= SubCHRScope
;
996 else if (!ConsecutiveSubscope
->appendable(SubCHRScope
)) {
997 Subscopes
.push_back(ConsecutiveSubscope
);
998 ConsecutiveSubscope
= SubCHRScope
;
1000 ConsecutiveSubscope
->append(SubCHRScope
);
1002 if (ConsecutiveSubscope
) {
1003 Subscopes
.push_back(ConsecutiveSubscope
);
1005 ConsecutiveSubscope
= nullptr;
1008 if (ConsecutiveSubscope
) {
1009 Subscopes
.push_back(ConsecutiveSubscope
);
1011 for (CHRScope
*Sub
: Subscopes
) {
1013 // Combine it with the parent.
1014 Result
->addSub(Sub
);
1016 // Push Subscopes as they won't be combined with the parent.
1017 Scopes
.push_back(Sub
);
1023 static DenseSet
<Value
*> getCHRConditionValuesForRegion(RegInfo
&RI
) {
1024 DenseSet
<Value
*> ConditionValues
;
1026 auto *BI
= cast
<BranchInst
>(RI
.R
->getEntry()->getTerminator());
1027 ConditionValues
.insert(BI
->getCondition());
1029 for (SelectInst
*SI
: RI
.Selects
) {
1030 ConditionValues
.insert(SI
->getCondition());
1032 return ConditionValues
;
1036 // Determine whether to split a scope depending on the sets of the branch
1037 // condition values of the previous region and the current region. We split
1038 // (return true) it if 1) the condition values of the inner/lower scope can't be
1039 // hoisted up to the outer/upper scope, or 2) the two sets of the condition
1040 // values have an empty intersection (because the combined branch conditions
1041 // won't probably lead to a simpler combined condition).
1042 static bool shouldSplit(Instruction
*InsertPoint
,
1043 DenseSet
<Value
*> &PrevConditionValues
,
1044 DenseSet
<Value
*> &ConditionValues
,
1046 DenseSet
<Instruction
*> &Unhoistables
) {
1047 assert(InsertPoint
&& "Null InsertPoint");
1049 dbgs() << "shouldSplit " << *InsertPoint
<< " PrevConditionValues ";
1050 for (Value
*V
: PrevConditionValues
) {
1051 dbgs() << *V
<< ", ";
1053 dbgs() << " ConditionValues ";
1054 for (Value
*V
: ConditionValues
) {
1055 dbgs() << *V
<< ", ";
1058 // If any of Bases isn't hoistable to the hoist point, split.
1059 for (Value
*V
: ConditionValues
) {
1060 DenseMap
<Instruction
*, bool> Visited
;
1061 if (!checkHoistValue(V
, InsertPoint
, DT
, Unhoistables
, nullptr, Visited
)) {
1062 CHR_DEBUG(dbgs() << "Split. checkHoistValue false " << *V
<< "\n");
1063 return true; // Not hoistable, split.
1066 // If PrevConditionValues or ConditionValues is empty, don't split to avoid
1067 // unnecessary splits at scopes with no branch/selects. If
1068 // PrevConditionValues and ConditionValues don't intersect at all, split.
1069 if (!PrevConditionValues
.empty() && !ConditionValues
.empty()) {
1070 // Use std::set as DenseSet doesn't work with set_intersection.
1071 std::set
<Value
*> PrevBases
, Bases
;
1072 DenseMap
<Value
*, std::set
<Value
*>> Visited
;
1073 for (Value
*V
: PrevConditionValues
) {
1074 const std::set
<Value
*> &BaseValues
= getBaseValues(V
, DT
, Visited
);
1075 PrevBases
.insert(BaseValues
.begin(), BaseValues
.end());
1077 for (Value
*V
: ConditionValues
) {
1078 const std::set
<Value
*> &BaseValues
= getBaseValues(V
, DT
, Visited
);
1079 Bases
.insert(BaseValues
.begin(), BaseValues
.end());
1082 dbgs() << "PrevBases ";
1083 for (Value
*V
: PrevBases
) {
1084 dbgs() << *V
<< ", ";
1086 dbgs() << " Bases ";
1087 for (Value
*V
: Bases
) {
1088 dbgs() << *V
<< ", ";
1091 std::vector
<Value
*> Intersection
;
1092 std::set_intersection(PrevBases
.begin(), PrevBases
.end(), Bases
.begin(),
1093 Bases
.end(), std::back_inserter(Intersection
));
1094 if (Intersection
.empty()) {
1095 // Empty intersection, split.
1096 CHR_DEBUG(dbgs() << "Split. Intersection empty\n");
1100 CHR_DEBUG(dbgs() << "No split\n");
1101 return false; // Don't split.
1104 static void getSelectsInScope(CHRScope
*Scope
,
1105 DenseSet
<Instruction
*> &Output
) {
1106 for (RegInfo
&RI
: Scope
->RegInfos
)
1107 for (SelectInst
*SI
: RI
.Selects
)
1109 for (CHRScope
*Sub
: Scope
->Subs
)
1110 getSelectsInScope(Sub
, Output
);
1113 void CHR::splitScopes(SmallVectorImpl
<CHRScope
*> &Input
,
1114 SmallVectorImpl
<CHRScope
*> &Output
) {
1115 for (CHRScope
*Scope
: Input
) {
1116 assert(!Scope
->BranchInsertPoint
&&
1117 "BranchInsertPoint must not be set");
1118 DenseSet
<Instruction
*> Unhoistables
;
1119 getSelectsInScope(Scope
, Unhoistables
);
1120 splitScope(Scope
, nullptr, nullptr, nullptr, Output
, Unhoistables
);
1123 for (CHRScope
*Scope
: Output
) {
1124 assert(Scope
->BranchInsertPoint
&& "BranchInsertPoint must be set");
1129 SmallVector
<CHRScope
*, 8> CHR::splitScope(
1132 DenseSet
<Value
*> *OuterConditionValues
,
1133 Instruction
*OuterInsertPoint
,
1134 SmallVectorImpl
<CHRScope
*> &Output
,
1135 DenseSet
<Instruction
*> &Unhoistables
) {
1137 assert(OuterConditionValues
&& "Null OuterConditionValues");
1138 assert(OuterInsertPoint
&& "Null OuterInsertPoint");
1140 bool PrevSplitFromOuter
= true;
1141 DenseSet
<Value
*> PrevConditionValues
;
1142 Instruction
*PrevInsertPoint
= nullptr;
1143 SmallVector
<CHRScope
*, 8> Splits
;
1144 SmallVector
<bool, 8> SplitsSplitFromOuter
;
1145 SmallVector
<DenseSet
<Value
*>, 8> SplitsConditionValues
;
1146 SmallVector
<Instruction
*, 8> SplitsInsertPoints
;
1147 SmallVector
<RegInfo
, 8> RegInfos(Scope
->RegInfos
); // Copy
1148 for (RegInfo
&RI
: RegInfos
) {
1149 Instruction
*InsertPoint
= getBranchInsertPoint(RI
);
1150 DenseSet
<Value
*> ConditionValues
= getCHRConditionValuesForRegion(RI
);
1152 dbgs() << "ConditionValues ";
1153 for (Value
*V
: ConditionValues
) {
1154 dbgs() << *V
<< ", ";
1157 if (RI
.R
== RegInfos
[0].R
) {
1158 // First iteration. Check to see if we should split from the outer.
1160 CHR_DEBUG(dbgs() << "Outer " << *Outer
<< "\n");
1161 CHR_DEBUG(dbgs() << "Should split from outer at "
1162 << RI
.R
->getNameStr() << "\n");
1163 if (shouldSplit(OuterInsertPoint
, *OuterConditionValues
,
1164 ConditionValues
, DT
, Unhoistables
)) {
1165 PrevConditionValues
= ConditionValues
;
1166 PrevInsertPoint
= InsertPoint
;
1168 return OptimizationRemarkMissed(DEBUG_TYPE
,
1169 "SplitScopeFromOuter",
1170 RI
.R
->getEntry()->getTerminator())
1171 << "Split scope from outer due to unhoistable branch/select "
1172 << "and/or lack of common condition values";
1175 // Not splitting from the outer. Use the outer bases and insert
1176 // point. Union the bases.
1177 PrevSplitFromOuter
= false;
1178 PrevConditionValues
= *OuterConditionValues
;
1179 PrevConditionValues
.insert(ConditionValues
.begin(),
1180 ConditionValues
.end());
1181 PrevInsertPoint
= OuterInsertPoint
;
1184 CHR_DEBUG(dbgs() << "Outer null\n");
1185 PrevConditionValues
= ConditionValues
;
1186 PrevInsertPoint
= InsertPoint
;
1189 CHR_DEBUG(dbgs() << "Should split from prev at "
1190 << RI
.R
->getNameStr() << "\n");
1191 if (shouldSplit(PrevInsertPoint
, PrevConditionValues
, ConditionValues
,
1192 DT
, Unhoistables
)) {
1193 CHRScope
*Tail
= Scope
->split(RI
.R
);
1194 Scopes
.insert(Tail
);
1195 Splits
.push_back(Scope
);
1196 SplitsSplitFromOuter
.push_back(PrevSplitFromOuter
);
1197 SplitsConditionValues
.push_back(PrevConditionValues
);
1198 SplitsInsertPoints
.push_back(PrevInsertPoint
);
1200 PrevConditionValues
= ConditionValues
;
1201 PrevInsertPoint
= InsertPoint
;
1202 PrevSplitFromOuter
= true;
1204 return OptimizationRemarkMissed(DEBUG_TYPE
,
1205 "SplitScopeFromPrev",
1206 RI
.R
->getEntry()->getTerminator())
1207 << "Split scope from previous due to unhoistable branch/select "
1208 << "and/or lack of common condition values";
1211 // Not splitting. Union the bases. Keep the hoist point.
1212 PrevConditionValues
.insert(ConditionValues
.begin(), ConditionValues
.end());
1216 Splits
.push_back(Scope
);
1217 SplitsSplitFromOuter
.push_back(PrevSplitFromOuter
);
1218 SplitsConditionValues
.push_back(PrevConditionValues
);
1219 assert(PrevInsertPoint
&& "Null PrevInsertPoint");
1220 SplitsInsertPoints
.push_back(PrevInsertPoint
);
1221 assert(Splits
.size() == SplitsConditionValues
.size() &&
1222 Splits
.size() == SplitsSplitFromOuter
.size() &&
1223 Splits
.size() == SplitsInsertPoints
.size() && "Mismatching sizes");
1224 for (size_t I
= 0; I
< Splits
.size(); ++I
) {
1225 CHRScope
*Split
= Splits
[I
];
1226 DenseSet
<Value
*> &SplitConditionValues
= SplitsConditionValues
[I
];
1227 Instruction
*SplitInsertPoint
= SplitsInsertPoints
[I
];
1228 SmallVector
<CHRScope
*, 8> NewSubs
;
1229 DenseSet
<Instruction
*> SplitUnhoistables
;
1230 getSelectsInScope(Split
, SplitUnhoistables
);
1231 for (CHRScope
*Sub
: Split
->Subs
) {
1232 SmallVector
<CHRScope
*, 8> SubSplits
= splitScope(
1233 Sub
, Split
, &SplitConditionValues
, SplitInsertPoint
, Output
,
1235 llvm::append_range(NewSubs
, SubSplits
);
1237 Split
->Subs
= NewSubs
;
1239 SmallVector
<CHRScope
*, 8> Result
;
1240 for (size_t I
= 0; I
< Splits
.size(); ++I
) {
1241 CHRScope
*Split
= Splits
[I
];
1242 if (SplitsSplitFromOuter
[I
]) {
1243 // Split from the outer.
1244 Output
.push_back(Split
);
1245 Split
->BranchInsertPoint
= SplitsInsertPoints
[I
];
1246 CHR_DEBUG(dbgs() << "BranchInsertPoint " << *SplitsInsertPoints
[I
]
1249 // Connected to the outer.
1250 Result
.push_back(Split
);
1254 assert(Result
.empty() &&
1255 "If no outer (top-level), must return no nested ones");
1259 void CHR::classifyBiasedScopes(SmallVectorImpl
<CHRScope
*> &Scopes
) {
1260 for (CHRScope
*Scope
: Scopes
) {
1261 assert(Scope
->TrueBiasedRegions
.empty() && Scope
->FalseBiasedRegions
.empty() && "Empty");
1262 classifyBiasedScopes(Scope
, Scope
);
1264 dbgs() << "classifyBiasedScopes " << *Scope
<< "\n";
1265 dbgs() << "TrueBiasedRegions ";
1266 for (Region
*R
: Scope
->TrueBiasedRegions
) {
1267 dbgs() << R
->getNameStr() << ", ";
1270 dbgs() << "FalseBiasedRegions ";
1271 for (Region
*R
: Scope
->FalseBiasedRegions
) {
1272 dbgs() << R
->getNameStr() << ", ";
1275 dbgs() << "TrueBiasedSelects ";
1276 for (SelectInst
*SI
: Scope
->TrueBiasedSelects
) {
1277 dbgs() << *SI
<< ", ";
1280 dbgs() << "FalseBiasedSelects ";
1281 for (SelectInst
*SI
: Scope
->FalseBiasedSelects
) {
1282 dbgs() << *SI
<< ", ";
1288 void CHR::classifyBiasedScopes(CHRScope
*Scope
, CHRScope
*OutermostScope
) {
1289 for (RegInfo
&RI
: Scope
->RegInfos
) {
1292 if (TrueBiasedRegionsGlobal
.contains(R
))
1293 OutermostScope
->TrueBiasedRegions
.insert(R
);
1294 else if (FalseBiasedRegionsGlobal
.contains(R
))
1295 OutermostScope
->FalseBiasedRegions
.insert(R
);
1297 llvm_unreachable("Must be biased");
1299 for (SelectInst
*SI
: RI
.Selects
) {
1300 if (TrueBiasedSelectsGlobal
.contains(SI
))
1301 OutermostScope
->TrueBiasedSelects
.insert(SI
);
1302 else if (FalseBiasedSelectsGlobal
.contains(SI
))
1303 OutermostScope
->FalseBiasedSelects
.insert(SI
);
1305 llvm_unreachable("Must be biased");
1308 for (CHRScope
*Sub
: Scope
->Subs
) {
1309 classifyBiasedScopes(Sub
, OutermostScope
);
1313 static bool hasAtLeastTwoBiasedBranches(CHRScope
*Scope
) {
1314 unsigned NumBiased
= Scope
->TrueBiasedRegions
.size() +
1315 Scope
->FalseBiasedRegions
.size() +
1316 Scope
->TrueBiasedSelects
.size() +
1317 Scope
->FalseBiasedSelects
.size();
1318 return NumBiased
>= CHRMergeThreshold
;
1321 void CHR::filterScopes(SmallVectorImpl
<CHRScope
*> &Input
,
1322 SmallVectorImpl
<CHRScope
*> &Output
) {
1323 for (CHRScope
*Scope
: Input
) {
1324 // Filter out the ones with only one region and no subs.
1325 if (!hasAtLeastTwoBiasedBranches(Scope
)) {
1326 CHR_DEBUG(dbgs() << "Filtered out by biased branches truthy-regions "
1327 << Scope
->TrueBiasedRegions
.size()
1328 << " falsy-regions " << Scope
->FalseBiasedRegions
.size()
1329 << " true-selects " << Scope
->TrueBiasedSelects
.size()
1330 << " false-selects " << Scope
->FalseBiasedSelects
.size() << "\n");
1332 return OptimizationRemarkMissed(
1334 "DropScopeWithOneBranchOrSelect",
1335 Scope
->RegInfos
[0].R
->getEntry()->getTerminator())
1336 << "Drop scope with < "
1337 << ore::NV("CHRMergeThreshold", CHRMergeThreshold
)
1338 << " biased branch(es) or select(s)";
1342 Output
.push_back(Scope
);
1346 void CHR::setCHRRegions(SmallVectorImpl
<CHRScope
*> &Input
,
1347 SmallVectorImpl
<CHRScope
*> &Output
) {
1348 for (CHRScope
*Scope
: Input
) {
1349 assert(Scope
->HoistStopMap
.empty() && Scope
->CHRRegions
.empty() &&
1351 setCHRRegions(Scope
, Scope
);
1352 Output
.push_back(Scope
);
1354 dbgs() << "setCHRRegions HoistStopMap " << *Scope
<< "\n";
1355 for (auto pair
: Scope
->HoistStopMap
) {
1356 Region
*R
= pair
.first
;
1357 dbgs() << "Region " << R
->getNameStr() << "\n";
1358 for (Instruction
*I
: pair
.second
) {
1359 dbgs() << "HoistStop " << *I
<< "\n";
1362 dbgs() << "CHRRegions" << "\n";
1363 for (RegInfo
&RI
: Scope
->CHRRegions
) {
1364 dbgs() << RI
.R
->getNameStr() << "\n";
1369 void CHR::setCHRRegions(CHRScope
*Scope
, CHRScope
*OutermostScope
) {
1370 DenseSet
<Instruction
*> Unhoistables
;
1371 // Put the biased selects in Unhoistables because they should stay where they
1372 // are and constant-folded after CHR (in case one biased select or a branch
1373 // can depend on another biased select.)
1374 for (RegInfo
&RI
: Scope
->RegInfos
) {
1375 for (SelectInst
*SI
: RI
.Selects
) {
1376 Unhoistables
.insert(SI
);
1379 Instruction
*InsertPoint
= OutermostScope
->BranchInsertPoint
;
1380 for (RegInfo
&RI
: Scope
->RegInfos
) {
1382 DenseSet
<Instruction
*> HoistStops
;
1383 bool IsHoisted
= false;
1385 assert((OutermostScope
->TrueBiasedRegions
.contains(R
) ||
1386 OutermostScope
->FalseBiasedRegions
.contains(R
)) &&
1387 "Must be truthy or falsy");
1388 auto *BI
= cast
<BranchInst
>(R
->getEntry()->getTerminator());
1389 // Note checkHoistValue fills in HoistStops.
1390 DenseMap
<Instruction
*, bool> Visited
;
1391 bool IsHoistable
= checkHoistValue(BI
->getCondition(), InsertPoint
, DT
,
1392 Unhoistables
, &HoistStops
, Visited
);
1393 assert(IsHoistable
&& "Must be hoistable");
1394 (void)(IsHoistable
); // Unused in release build
1397 for (SelectInst
*SI
: RI
.Selects
) {
1398 assert((OutermostScope
->TrueBiasedSelects
.contains(SI
) ||
1399 OutermostScope
->FalseBiasedSelects
.contains(SI
)) &&
1400 "Must be true or false biased");
1401 // Note checkHoistValue fills in HoistStops.
1402 DenseMap
<Instruction
*, bool> Visited
;
1403 bool IsHoistable
= checkHoistValue(SI
->getCondition(), InsertPoint
, DT
,
1404 Unhoistables
, &HoistStops
, Visited
);
1405 assert(IsHoistable
&& "Must be hoistable");
1406 (void)(IsHoistable
); // Unused in release build
1410 OutermostScope
->CHRRegions
.push_back(RI
);
1411 OutermostScope
->HoistStopMap
[R
] = HoistStops
;
1414 for (CHRScope
*Sub
: Scope
->Subs
)
1415 setCHRRegions(Sub
, OutermostScope
);
1418 static bool CHRScopeSorter(CHRScope
*Scope1
, CHRScope
*Scope2
) {
1419 return Scope1
->RegInfos
[0].R
->getDepth() < Scope2
->RegInfos
[0].R
->getDepth();
1422 void CHR::sortScopes(SmallVectorImpl
<CHRScope
*> &Input
,
1423 SmallVectorImpl
<CHRScope
*> &Output
) {
1424 Output
.resize(Input
.size());
1425 llvm::copy(Input
, Output
.begin());
1426 llvm::stable_sort(Output
, CHRScopeSorter
);
1429 // Return true if V is already hoisted or was hoisted (along with its operands)
1430 // to the insert point.
1431 static void hoistValue(Value
*V
, Instruction
*HoistPoint
, Region
*R
,
1432 HoistStopMapTy
&HoistStopMap
,
1433 DenseSet
<Instruction
*> &HoistedSet
,
1434 DenseSet
<PHINode
*> &TrivialPHIs
,
1435 DominatorTree
&DT
) {
1436 auto IT
= HoistStopMap
.find(R
);
1437 assert(IT
!= HoistStopMap
.end() && "Region must be in hoist stop map");
1438 DenseSet
<Instruction
*> &HoistStops
= IT
->second
;
1439 if (auto *I
= dyn_cast
<Instruction
>(V
)) {
1440 if (I
== HoistPoint
)
1442 if (HoistStops
.count(I
))
1444 if (auto *PN
= dyn_cast
<PHINode
>(I
))
1445 if (TrivialPHIs
.count(PN
))
1446 // The trivial phi inserted by the previous CHR scope could replace a
1447 // non-phi in HoistStops. Note that since this phi is at the exit of a
1448 // previous CHR scope, which dominates this scope, it's safe to stop
1451 if (HoistedSet
.count(I
))
1452 // Already hoisted, return.
1454 assert(isHoistableInstructionType(I
) && "Unhoistable instruction type");
1455 assert(DT
.getNode(I
->getParent()) && "DT must contain I's block");
1456 assert(DT
.getNode(HoistPoint
->getParent()) &&
1457 "DT must contain HoistPoint block");
1458 if (DT
.dominates(I
, HoistPoint
))
1459 // We are already above the hoist point. Stop here. This may be necessary
1460 // when multiple scopes would independently hoist the same
1461 // instruction. Since an outer (dominating) scope would hoist it to its
1462 // entry before an inner (dominated) scope would to its entry, the inner
1463 // scope may see the instruction already hoisted, in which case it
1464 // potentially wrong for the inner scope to hoist it and could cause bad
1465 // IR (non-dominating def), but safe to skip hoisting it instead because
1466 // it's already in a block that dominates the inner scope.
1468 for (Value
*Op
: I
->operands()) {
1469 hoistValue(Op
, HoistPoint
, R
, HoistStopMap
, HoistedSet
, TrivialPHIs
, DT
);
1471 I
->moveBefore(HoistPoint
->getIterator());
1472 HoistedSet
.insert(I
);
1473 CHR_DEBUG(dbgs() << "hoistValue " << *I
<< "\n");
1477 // Hoist the dependent condition values of the branches and the selects in the
1478 // scope to the insert point.
1479 static void hoistScopeConditions(CHRScope
*Scope
, Instruction
*HoistPoint
,
1480 DenseSet
<PHINode
*> &TrivialPHIs
,
1481 DominatorTree
&DT
) {
1482 DenseSet
<Instruction
*> HoistedSet
;
1483 for (const RegInfo
&RI
: Scope
->CHRRegions
) {
1485 bool IsTrueBiased
= Scope
->TrueBiasedRegions
.count(R
);
1486 bool IsFalseBiased
= Scope
->FalseBiasedRegions
.count(R
);
1487 if (RI
.HasBranch
&& (IsTrueBiased
|| IsFalseBiased
)) {
1488 auto *BI
= cast
<BranchInst
>(R
->getEntry()->getTerminator());
1489 hoistValue(BI
->getCondition(), HoistPoint
, R
, Scope
->HoistStopMap
,
1490 HoistedSet
, TrivialPHIs
, DT
);
1492 for (SelectInst
*SI
: RI
.Selects
) {
1493 bool IsTrueBiased
= Scope
->TrueBiasedSelects
.count(SI
);
1494 bool IsFalseBiased
= Scope
->FalseBiasedSelects
.count(SI
);
1495 if (!(IsTrueBiased
|| IsFalseBiased
))
1497 hoistValue(SI
->getCondition(), HoistPoint
, R
, Scope
->HoistStopMap
,
1498 HoistedSet
, TrivialPHIs
, DT
);
1503 // Negate the predicate if an ICmp if it's used only by branches or selects by
1504 // swapping the operands of the branches or the selects. Returns true if success.
1505 static bool negateICmpIfUsedByBranchOrSelectOnly(ICmpInst
*ICmp
,
1506 Instruction
*ExcludedUser
,
1508 for (User
*U
: ICmp
->users()) {
1509 if (U
== ExcludedUser
)
1511 if (isa
<BranchInst
>(U
) && cast
<BranchInst
>(U
)->isConditional())
1513 if (isa
<SelectInst
>(U
) && cast
<SelectInst
>(U
)->getCondition() == ICmp
)
1517 for (User
*U
: ICmp
->users()) {
1518 if (U
== ExcludedUser
)
1520 if (auto *BI
= dyn_cast
<BranchInst
>(U
)) {
1521 assert(BI
->isConditional() && "Must be conditional");
1522 BI
->swapSuccessors();
1523 // Don't need to swap this in terms of
1524 // TrueBiasedRegions/FalseBiasedRegions because true-based/false-based
1525 // mean whehter the branch is likely go into the if-then rather than
1526 // successor0/successor1 and because we can tell which edge is the then or
1527 // the else one by comparing the destination to the region exit block.
1530 if (auto *SI
= dyn_cast
<SelectInst
>(U
)) {
1533 SI
->swapProfMetadata();
1534 if (Scope
->TrueBiasedSelects
.count(SI
)) {
1535 assert(!Scope
->FalseBiasedSelects
.contains(SI
) &&
1536 "Must not be already in");
1537 Scope
->FalseBiasedSelects
.insert(SI
);
1538 } else if (Scope
->FalseBiasedSelects
.count(SI
)) {
1539 assert(!Scope
->TrueBiasedSelects
.contains(SI
) &&
1540 "Must not be already in");
1541 Scope
->TrueBiasedSelects
.insert(SI
);
1545 llvm_unreachable("Must be a branch or a select");
1547 ICmp
->setPredicate(CmpInst::getInversePredicate(ICmp
->getPredicate()));
1551 // A helper for transformScopes. Insert a trivial phi at the scope exit block
1552 // for a value that's defined in the scope but used outside it (meaning it's
1553 // alive at the exit block).
1554 static void insertTrivialPHIs(CHRScope
*Scope
,
1555 BasicBlock
*EntryBlock
, BasicBlock
*ExitBlock
,
1556 DenseSet
<PHINode
*> &TrivialPHIs
) {
1557 SmallSetVector
<BasicBlock
*, 8> BlocksInScope
;
1558 for (RegInfo
&RI
: Scope
->RegInfos
) {
1559 for (BasicBlock
*BB
: RI
.R
->blocks()) { // This includes the blocks in the
1561 BlocksInScope
.insert(BB
);
1565 dbgs() << "Inserting redundant phis\n";
1566 for (BasicBlock
*BB
: BlocksInScope
)
1567 dbgs() << "BlockInScope " << BB
->getName() << "\n";
1569 for (BasicBlock
*BB
: BlocksInScope
) {
1570 for (Instruction
&I
: *BB
) {
1571 SmallVector
<Instruction
*, 8> Users
;
1572 for (User
*U
: I
.users()) {
1573 if (auto *UI
= dyn_cast
<Instruction
>(U
)) {
1574 if (!BlocksInScope
.contains(UI
->getParent()) &&
1575 // Unless there's already a phi for I at the exit block.
1576 !(isa
<PHINode
>(UI
) && UI
->getParent() == ExitBlock
)) {
1577 CHR_DEBUG(dbgs() << "V " << I
<< "\n");
1578 CHR_DEBUG(dbgs() << "Used outside scope by user " << *UI
<< "\n");
1579 Users
.push_back(UI
);
1580 } else if (UI
->getParent() == EntryBlock
&& isa
<PHINode
>(UI
)) {
1581 // There's a loop backedge from a block that's dominated by this
1582 // scope to the entry block.
1583 CHR_DEBUG(dbgs() << "V " << I
<< "\n");
1585 << "Used at entry block (for a back edge) by a phi user "
1587 Users
.push_back(UI
);
1591 if (Users
.size() > 0) {
1592 // Insert a trivial phi for I (phi [&I, P0], [&I, P1], ...) at
1593 // ExitBlock. Replace I with the new phi in UI unless UI is another
1594 // phi at ExitBlock.
1595 PHINode
*PN
= PHINode::Create(I
.getType(), pred_size(ExitBlock
), "");
1596 PN
->insertBefore(ExitBlock
->begin());
1597 for (BasicBlock
*Pred
: predecessors(ExitBlock
)) {
1598 PN
->addIncoming(&I
, Pred
);
1600 TrivialPHIs
.insert(PN
);
1601 CHR_DEBUG(dbgs() << "Insert phi " << *PN
<< "\n");
1602 for (Instruction
*UI
: Users
) {
1603 for (unsigned J
= 0, NumOps
= UI
->getNumOperands(); J
< NumOps
; ++J
) {
1604 if (UI
->getOperand(J
) == &I
) {
1605 UI
->setOperand(J
, PN
);
1608 CHR_DEBUG(dbgs() << "Updated user " << *UI
<< "\n");
1615 // Assert that all the CHR regions of the scope have a biased branch or select.
1616 static void LLVM_ATTRIBUTE_UNUSED
1617 assertCHRRegionsHaveBiasedBranchOrSelect(CHRScope
*Scope
) {
1619 auto HasBiasedBranchOrSelect
= [](RegInfo
&RI
, CHRScope
*Scope
) {
1620 if (Scope
->TrueBiasedRegions
.count(RI
.R
) ||
1621 Scope
->FalseBiasedRegions
.count(RI
.R
))
1623 for (SelectInst
*SI
: RI
.Selects
)
1624 if (Scope
->TrueBiasedSelects
.count(SI
) ||
1625 Scope
->FalseBiasedSelects
.count(SI
))
1629 for (RegInfo
&RI
: Scope
->CHRRegions
) {
1630 assert(HasBiasedBranchOrSelect(RI
, Scope
) &&
1631 "Must have biased branch or select");
1636 // Assert that all the condition values of the biased branches and selects have
1637 // been hoisted to the pre-entry block or outside of the scope.
1638 static void LLVM_ATTRIBUTE_UNUSED
assertBranchOrSelectConditionHoisted(
1639 CHRScope
*Scope
, BasicBlock
*PreEntryBlock
) {
1640 CHR_DEBUG(dbgs() << "Biased regions condition values \n");
1641 for (RegInfo
&RI
: Scope
->CHRRegions
) {
1643 bool IsTrueBiased
= Scope
->TrueBiasedRegions
.count(R
);
1644 bool IsFalseBiased
= Scope
->FalseBiasedRegions
.count(R
);
1645 if (RI
.HasBranch
&& (IsTrueBiased
|| IsFalseBiased
)) {
1646 auto *BI
= cast
<BranchInst
>(R
->getEntry()->getTerminator());
1647 Value
*V
= BI
->getCondition();
1648 CHR_DEBUG(dbgs() << *V
<< "\n");
1649 if (auto *I
= dyn_cast
<Instruction
>(V
)) {
1650 (void)(I
); // Unused in release build.
1651 assert((I
->getParent() == PreEntryBlock
||
1652 !Scope
->contains(I
)) &&
1653 "Must have been hoisted to PreEntryBlock or outside the scope");
1656 for (SelectInst
*SI
: RI
.Selects
) {
1657 bool IsTrueBiased
= Scope
->TrueBiasedSelects
.count(SI
);
1658 bool IsFalseBiased
= Scope
->FalseBiasedSelects
.count(SI
);
1659 if (!(IsTrueBiased
|| IsFalseBiased
))
1661 Value
*V
= SI
->getCondition();
1662 CHR_DEBUG(dbgs() << *V
<< "\n");
1663 if (auto *I
= dyn_cast
<Instruction
>(V
)) {
1664 (void)(I
); // Unused in release build.
1665 assert((I
->getParent() == PreEntryBlock
||
1666 !Scope
->contains(I
)) &&
1667 "Must have been hoisted to PreEntryBlock or outside the scope");
1673 void CHR::transformScopes(CHRScope
*Scope
, DenseSet
<PHINode
*> &TrivialPHIs
) {
1674 CHR_DEBUG(dbgs() << "transformScopes " << *Scope
<< "\n");
1676 assert(Scope
->RegInfos
.size() >= 1 && "Should have at least one Region");
1678 for (RegInfo
&RI
: Scope
->RegInfos
) {
1679 const Region
*R
= RI
.R
;
1680 unsigned Duplication
= getRegionDuplicationCount(R
);
1681 CHR_DEBUG(dbgs() << "Dup count for R=" << R
<< " is " << Duplication
1683 if (Duplication
>= CHRDupThreshsold
) {
1684 CHR_DEBUG(dbgs() << "Reached the dup threshold of " << Duplication
1685 << " for this region");
1687 return OptimizationRemarkMissed(DEBUG_TYPE
, "DupThresholdReached",
1688 R
->getEntry()->getTerminator())
1689 << "Reached the duplication threshold for the region";
1694 for (RegInfo
&RI
: Scope
->RegInfos
) {
1695 DuplicationCount
[RI
.R
]++;
1698 Region
*FirstRegion
= Scope
->RegInfos
[0].R
;
1699 BasicBlock
*EntryBlock
= FirstRegion
->getEntry();
1700 Region
*LastRegion
= Scope
->RegInfos
[Scope
->RegInfos
.size() - 1].R
;
1701 BasicBlock
*ExitBlock
= LastRegion
->getExit();
1702 std::optional
<uint64_t> ProfileCount
= BFI
.getBlockProfileCount(EntryBlock
);
1705 // Insert a trivial phi at the exit block (where the CHR hot path and the
1706 // cold path merges) for a value that's defined in the scope but used
1707 // outside it (meaning it's alive at the exit block). We will add the
1708 // incoming values for the CHR cold paths to it below. Without this, we'd
1709 // miss updating phi's for such values unless there happens to already be a
1710 // phi for that value there.
1711 insertTrivialPHIs(Scope
, EntryBlock
, ExitBlock
, TrivialPHIs
);
1714 // Split the entry block of the first region. The new block becomes the new
1715 // entry block of the first region. The old entry block becomes the block to
1716 // insert the CHR branch into. Note DT gets updated. Since DT gets updated
1717 // through the split, we update the entry of the first region after the split,
1718 // and Region only points to the entry and the exit blocks, rather than
1719 // keeping everything in a list or set, the blocks membership and the
1720 // entry/exit blocks of the region are still valid after the split.
1721 CHR_DEBUG(dbgs() << "Splitting entry block " << EntryBlock
->getName()
1722 << " at " << *Scope
->BranchInsertPoint
<< "\n");
1723 BasicBlock
*NewEntryBlock
=
1724 SplitBlock(EntryBlock
, Scope
->BranchInsertPoint
, &DT
);
1725 assert(NewEntryBlock
->getSinglePredecessor() == EntryBlock
&&
1726 "NewEntryBlock's only pred must be EntryBlock");
1727 FirstRegion
->replaceEntryRecursive(NewEntryBlock
);
1728 BasicBlock
*PreEntryBlock
= EntryBlock
;
1730 ValueToValueMapTy VMap
;
1731 // Clone the blocks in the scope (excluding the PreEntryBlock) to split into a
1732 // hot path (originals) and a cold path (clones) and update the PHIs at the
1734 cloneScopeBlocks(Scope
, PreEntryBlock
, ExitBlock
, LastRegion
, VMap
);
1736 // Replace the old (placeholder) branch with the new (merged) conditional
1738 BranchInst
*MergedBr
= createMergedBranch(PreEntryBlock
, EntryBlock
,
1739 NewEntryBlock
, VMap
);
1742 assertCHRRegionsHaveBiasedBranchOrSelect(Scope
);
1745 // Hoist the conditional values of the branches/selects.
1746 hoistScopeConditions(Scope
, PreEntryBlock
->getTerminator(), TrivialPHIs
, DT
);
1749 assertBranchOrSelectConditionHoisted(Scope
, PreEntryBlock
);
1752 // Create the combined branch condition and constant-fold the branches/selects
1754 fixupBranchesAndSelects(Scope
, PreEntryBlock
, MergedBr
,
1755 ProfileCount
.value_or(0));
1758 // A helper for transformScopes. Clone the blocks in the scope (excluding the
1759 // PreEntryBlock) to split into a hot path and a cold path and update the PHIs
1760 // at the exit block.
1761 void CHR::cloneScopeBlocks(CHRScope
*Scope
,
1762 BasicBlock
*PreEntryBlock
,
1763 BasicBlock
*ExitBlock
,
1765 ValueToValueMapTy
&VMap
) {
1766 // Clone all the blocks. The original blocks will be the hot-path
1767 // CHR-optimized code and the cloned blocks will be the original unoptimized
1768 // code. This is so that the block pointers from the
1769 // CHRScope/Region/RegionInfo can stay valid in pointing to the hot-path code
1770 // which CHR should apply to.
1771 SmallVector
<BasicBlock
*, 8> NewBlocks
;
1772 for (RegInfo
&RI
: Scope
->RegInfos
)
1773 for (BasicBlock
*BB
: RI
.R
->blocks()) { // This includes the blocks in the
1775 assert(BB
!= PreEntryBlock
&& "Don't copy the preetntry block");
1776 BasicBlock
*NewBB
= CloneBasicBlock(BB
, VMap
, ".nonchr", &F
);
1777 NewBlocks
.push_back(NewBB
);
1780 // Unreachable predecessors will not be cloned and will not have an edge
1781 // to the cloned block. As such, also remove them from any phi nodes.
1782 for (PHINode
&PN
: make_early_inc_range(NewBB
->phis()))
1783 PN
.removeIncomingValueIf([&](unsigned Idx
) {
1784 return !DT
.isReachableFromEntry(PN
.getIncomingBlock(Idx
));
1788 // Place the cloned blocks right after the original blocks (right before the
1791 F
.splice(ExitBlock
->getIterator(), &F
, NewBlocks
[0]->getIterator(),
1794 // Update the cloned blocks/instructions to refer to themselves.
1795 for (BasicBlock
*NewBB
: NewBlocks
)
1796 for (Instruction
&I
: *NewBB
)
1797 RemapInstruction(&I
, VMap
,
1798 RF_NoModuleLevelChanges
| RF_IgnoreMissingLocals
);
1800 // Add the cloned blocks to the PHIs of the exit blocks. ExitBlock is null for
1801 // the top-level region but we don't need to add PHIs. The trivial PHIs
1802 // inserted above will be updated here.
1804 for (PHINode
&PN
: ExitBlock
->phis())
1805 for (unsigned I
= 0, NumOps
= PN
.getNumIncomingValues(); I
< NumOps
;
1807 BasicBlock
*Pred
= PN
.getIncomingBlock(I
);
1808 if (LastRegion
->contains(Pred
)) {
1809 Value
*V
= PN
.getIncomingValue(I
);
1810 auto It
= VMap
.find(V
);
1811 if (It
!= VMap
.end()) V
= It
->second
;
1812 assert(VMap
.find(Pred
) != VMap
.end() && "Pred must have been cloned");
1813 PN
.addIncoming(V
, cast
<BasicBlock
>(VMap
[Pred
]));
1818 // A helper for transformScope. Replace the old (placeholder) branch with the
1819 // new (merged) conditional branch.
1820 BranchInst
*CHR::createMergedBranch(BasicBlock
*PreEntryBlock
,
1821 BasicBlock
*EntryBlock
,
1822 BasicBlock
*NewEntryBlock
,
1823 ValueToValueMapTy
&VMap
) {
1824 BranchInst
*OldBR
= cast
<BranchInst
>(PreEntryBlock
->getTerminator());
1825 assert(OldBR
->isUnconditional() && OldBR
->getSuccessor(0) == NewEntryBlock
&&
1826 "SplitBlock did not work correctly!");
1827 assert(NewEntryBlock
->getSinglePredecessor() == EntryBlock
&&
1828 "NewEntryBlock's only pred must be EntryBlock");
1829 assert(VMap
.find(NewEntryBlock
) != VMap
.end() &&
1830 "NewEntryBlock must have been copied");
1831 OldBR
->dropAllReferences();
1832 OldBR
->eraseFromParent();
1833 // The true predicate is a placeholder. It will be replaced later in
1834 // fixupBranchesAndSelects().
1835 BranchInst
*NewBR
= BranchInst::Create(NewEntryBlock
,
1836 cast
<BasicBlock
>(VMap
[NewEntryBlock
]),
1837 ConstantInt::getTrue(F
.getContext()));
1838 NewBR
->insertInto(PreEntryBlock
, PreEntryBlock
->end());
1839 assert(NewEntryBlock
->getSinglePredecessor() == EntryBlock
&&
1840 "NewEntryBlock's only pred must be EntryBlock");
1844 // A helper for transformScopes. Create the combined branch condition and
1845 // constant-fold the branches/selects in the hot path.
1846 void CHR::fixupBranchesAndSelects(CHRScope
*Scope
,
1847 BasicBlock
*PreEntryBlock
,
1848 BranchInst
*MergedBR
,
1849 uint64_t ProfileCount
) {
1850 Value
*MergedCondition
= ConstantInt::getTrue(F
.getContext());
1851 BranchProbability
CHRBranchBias(1, 1);
1852 uint64_t NumCHRedBranches
= 0;
1853 IRBuilder
<> IRB(PreEntryBlock
->getTerminator());
1854 for (RegInfo
&RI
: Scope
->CHRRegions
) {
1857 fixupBranch(R
, Scope
, IRB
, MergedCondition
, CHRBranchBias
);
1860 for (SelectInst
*SI
: RI
.Selects
) {
1861 fixupSelect(SI
, Scope
, IRB
, MergedCondition
, CHRBranchBias
);
1865 assert(NumCHRedBranches
> 0);
1866 Stats
.NumBranchesDelta
+= NumCHRedBranches
- 1;
1867 Stats
.WeightedNumBranchesDelta
+= (NumCHRedBranches
- 1) * ProfileCount
;
1869 return OptimizationRemark(DEBUG_TYPE
,
1871 // Refer to the hot (original) path
1872 MergedBR
->getSuccessor(0)->getTerminator())
1873 << "Merged " << ore::NV("NumCHRedBranches", NumCHRedBranches
)
1874 << " branches or selects";
1876 MergedBR
->setCondition(MergedCondition
);
1877 uint32_t Weights
[] = {
1878 static_cast<uint32_t>(CHRBranchBias
.scale(1000)),
1879 static_cast<uint32_t>(CHRBranchBias
.getCompl().scale(1000)),
1881 setBranchWeights(*MergedBR
, Weights
, /*IsExpected=*/false);
1882 CHR_DEBUG(dbgs() << "CHR branch bias " << Weights
[0] << ":" << Weights
[1]
1886 // A helper for fixupBranchesAndSelects. Add to the combined branch condition
1887 // and constant-fold a branch in the hot path.
1888 void CHR::fixupBranch(Region
*R
, CHRScope
*Scope
,
1890 Value
*&MergedCondition
,
1891 BranchProbability
&CHRBranchBias
) {
1892 bool IsTrueBiased
= Scope
->TrueBiasedRegions
.count(R
);
1893 assert((IsTrueBiased
|| Scope
->FalseBiasedRegions
.count(R
)) &&
1894 "Must be truthy or falsy");
1895 auto *BI
= cast
<BranchInst
>(R
->getEntry()->getTerminator());
1896 assert(BranchBiasMap
.contains(R
) && "Must be in the bias map");
1897 BranchProbability Bias
= BranchBiasMap
[R
];
1898 assert(Bias
>= getCHRBiasThreshold() && "Must be highly biased");
1900 if (CHRBranchBias
> Bias
)
1901 CHRBranchBias
= Bias
;
1902 BasicBlock
*IfThen
= BI
->getSuccessor(1);
1903 BasicBlock
*IfElse
= BI
->getSuccessor(0);
1904 BasicBlock
*RegionExitBlock
= R
->getExit();
1905 assert(RegionExitBlock
&& "Null ExitBlock");
1906 assert((IfThen
== RegionExitBlock
|| IfElse
== RegionExitBlock
) &&
1907 IfThen
!= IfElse
&& "Invariant from findScopes");
1908 if (IfThen
== RegionExitBlock
) {
1909 // Swap them so that IfThen means going into it and IfElse means skipping
1911 std::swap(IfThen
, IfElse
);
1913 CHR_DEBUG(dbgs() << "IfThen " << IfThen
->getName()
1914 << " IfElse " << IfElse
->getName() << "\n");
1915 Value
*Cond
= BI
->getCondition();
1916 BasicBlock
*HotTarget
= IsTrueBiased
? IfThen
: IfElse
;
1917 bool ConditionTrue
= HotTarget
== BI
->getSuccessor(0);
1918 addToMergedCondition(ConditionTrue
, Cond
, BI
, Scope
, IRB
,
1920 // Constant-fold the branch at ClonedEntryBlock.
1921 assert(ConditionTrue
== (HotTarget
== BI
->getSuccessor(0)) &&
1922 "The successor shouldn't change");
1923 Value
*NewCondition
= ConditionTrue
?
1924 ConstantInt::getTrue(F
.getContext()) :
1925 ConstantInt::getFalse(F
.getContext());
1926 BI
->setCondition(NewCondition
);
1929 // A helper for fixupBranchesAndSelects. Add to the combined branch condition
1930 // and constant-fold a select in the hot path.
1931 void CHR::fixupSelect(SelectInst
*SI
, CHRScope
*Scope
,
1933 Value
*&MergedCondition
,
1934 BranchProbability
&CHRBranchBias
) {
1935 bool IsTrueBiased
= Scope
->TrueBiasedSelects
.count(SI
);
1936 assert((IsTrueBiased
||
1937 Scope
->FalseBiasedSelects
.count(SI
)) && "Must be biased");
1938 assert(SelectBiasMap
.contains(SI
) && "Must be in the bias map");
1939 BranchProbability Bias
= SelectBiasMap
[SI
];
1940 assert(Bias
>= getCHRBiasThreshold() && "Must be highly biased");
1942 if (CHRBranchBias
> Bias
)
1943 CHRBranchBias
= Bias
;
1944 Value
*Cond
= SI
->getCondition();
1945 addToMergedCondition(IsTrueBiased
, Cond
, SI
, Scope
, IRB
,
1947 Value
*NewCondition
= IsTrueBiased
?
1948 ConstantInt::getTrue(F
.getContext()) :
1949 ConstantInt::getFalse(F
.getContext());
1950 SI
->setCondition(NewCondition
);
1953 // A helper for fixupBranch/fixupSelect. Add a branch condition to the merged
1955 void CHR::addToMergedCondition(bool IsTrueBiased
, Value
*Cond
,
1956 Instruction
*BranchOrSelect
, CHRScope
*Scope
,
1957 IRBuilder
<> &IRB
, Value
*&MergedCondition
) {
1958 if (!IsTrueBiased
) {
1959 // If Cond is an icmp and all users of V except for BranchOrSelect is a
1960 // branch, negate the icmp predicate and swap the branch targets and avoid
1961 // inserting an Xor to negate Cond.
1962 auto *ICmp
= dyn_cast
<ICmpInst
>(Cond
);
1964 !negateICmpIfUsedByBranchOrSelectOnly(ICmp
, BranchOrSelect
, Scope
))
1965 Cond
= IRB
.CreateXor(ConstantInt::getTrue(F
.getContext()), Cond
);
1968 // Freeze potentially poisonous conditions.
1969 if (!isGuaranteedNotToBeUndefOrPoison(Cond
))
1970 Cond
= IRB
.CreateFreeze(Cond
);
1972 // Use logical and to avoid propagating poison from later conditions.
1973 MergedCondition
= IRB
.CreateLogicalAnd(MergedCondition
, Cond
);
1976 void CHR::transformScopes(SmallVectorImpl
<CHRScope
*> &CHRScopes
) {
1978 DenseSet
<PHINode
*> TrivialPHIs
;
1979 for (CHRScope
*Scope
: CHRScopes
) {
1980 transformScopes(Scope
, TrivialPHIs
);
1982 std::ostringstream oss
;
1983 oss
<< " after transformScopes " << I
++;
1984 dumpIR(F
, oss
.str().c_str(), nullptr));
1989 static void LLVM_ATTRIBUTE_UNUSED
1990 dumpScopes(SmallVectorImpl
<CHRScope
*> &Scopes
, const char *Label
) {
1991 dbgs() << Label
<< " " << Scopes
.size() << "\n";
1992 for (CHRScope
*Scope
: Scopes
) {
1993 dbgs() << *Scope
<< "\n";
1998 if (!shouldApply(F
, PSI
))
2001 CHR_DEBUG(dumpIR(F
, "before", nullptr));
2003 bool Changed
= false;
2006 dbgs() << "RegionInfo:\n";
2009 // Recursively traverse the region tree and find regions that have biased
2010 // branches and/or selects and create scopes.
2011 SmallVector
<CHRScope
*, 8> AllScopes
;
2012 findScopes(AllScopes
);
2013 CHR_DEBUG(dumpScopes(AllScopes
, "All scopes"));
2015 // Split the scopes if 1) the conditional values of the biased
2016 // branches/selects of the inner/lower scope can't be hoisted up to the
2017 // outermost/uppermost scope entry, or 2) the condition values of the biased
2018 // branches/selects in a scope (including subscopes) don't share at least
2019 // one common value.
2020 SmallVector
<CHRScope
*, 8> SplitScopes
;
2021 splitScopes(AllScopes
, SplitScopes
);
2022 CHR_DEBUG(dumpScopes(SplitScopes
, "Split scopes"));
2024 // After splitting, set the biased regions and selects of a scope (a tree
2025 // root) that include those of the subscopes.
2026 classifyBiasedScopes(SplitScopes
);
2027 CHR_DEBUG(dbgs() << "Set per-scope bias " << SplitScopes
.size() << "\n");
2029 // Filter out the scopes that has only one biased region or select (CHR
2030 // isn't useful in such a case).
2031 SmallVector
<CHRScope
*, 8> FilteredScopes
;
2032 filterScopes(SplitScopes
, FilteredScopes
);
2033 CHR_DEBUG(dumpScopes(FilteredScopes
, "Filtered scopes"));
2035 // Set the regions to be CHR'ed and their hoist stops for each scope.
2036 SmallVector
<CHRScope
*, 8> SetScopes
;
2037 setCHRRegions(FilteredScopes
, SetScopes
);
2038 CHR_DEBUG(dumpScopes(SetScopes
, "Set CHR regions"));
2040 // Sort CHRScopes by the depth so that outer CHRScopes comes before inner
2041 // ones. We need to apply CHR from outer to inner so that we apply CHR only
2042 // to the hot path, rather than both hot and cold paths.
2043 SmallVector
<CHRScope
*, 8> SortedScopes
;
2044 sortScopes(SetScopes
, SortedScopes
);
2045 CHR_DEBUG(dumpScopes(SortedScopes
, "Sorted scopes"));
2048 dbgs() << "RegionInfo:\n";
2051 // Apply the CHR transformation.
2052 if (!SortedScopes
.empty()) {
2053 transformScopes(SortedScopes
);
2059 CHR_DEBUG(dumpIR(F
, "after", &Stats
));
2061 return OptimizationRemark(DEBUG_TYPE
, "Stats", &F
)
2062 << ore::NV("Function", &F
) << " "
2063 << "Reduced the number of branches in hot paths by "
2064 << ore::NV("NumBranchesDelta", Stats
.NumBranchesDelta
)
2066 << ore::NV("WeightedNumBranchesDelta", Stats
.WeightedNumBranchesDelta
)
2067 << " (weighted by PGO count)";
2076 ControlHeightReductionPass::ControlHeightReductionPass() {
2077 parseCHRFilterFiles();
2080 PreservedAnalyses
ControlHeightReductionPass::run(
2082 FunctionAnalysisManager
&FAM
) {
2083 auto &MAMProxy
= FAM
.getResult
<ModuleAnalysisManagerFunctionProxy
>(F
);
2084 auto PPSI
= MAMProxy
.getCachedResult
<ProfileSummaryAnalysis
>(*F
.getParent());
2085 // If there is no profile summary, we should not do CHR.
2086 if (!PPSI
|| !PPSI
->hasProfileSummary())
2087 return PreservedAnalyses::all();
2089 auto &BFI
= FAM
.getResult
<BlockFrequencyAnalysis
>(F
);
2090 auto &DT
= FAM
.getResult
<DominatorTreeAnalysis
>(F
);
2091 auto &RI
= FAM
.getResult
<RegionInfoAnalysis
>(F
);
2092 auto &ORE
= FAM
.getResult
<OptimizationRemarkEmitterAnalysis
>(F
);
2093 bool Changed
= CHR(F
, BFI
, DT
, PSI
, RI
, ORE
).run();
2095 return PreservedAnalyses::all();
2096 return PreservedAnalyses::none();