blob: b431e62162266d1458a5c1cfd6cc1418647ae59c [file] [log] [blame]
Bill Wendlinge1c54262012-08-15 12:22:35 +00001//===-- BranchProbabilityInfo.cpp - Branch Probability Analysis -----------===//
Andrew Trick49371f32011-06-04 01:16:30 +00002//
3// The LLVM Compiler Infrastructure
4//
5// This file is distributed under the University of Illinois Open Source
6// License. See LICENSE.TXT for details.
7//
8//===----------------------------------------------------------------------===//
9//
10// Loops should be simplified before this analysis.
11//
12//===----------------------------------------------------------------------===//
13
Chandler Carruthed0881b2012-12-03 16:50:05 +000014#include "llvm/Analysis/BranchProbabilityInfo.h"
15#include "llvm/ADT/PostOrderIterator.h"
16#include "llvm/Analysis/LoopInfo.h"
Chandler Carruth1305dc32014-03-04 11:45:46 +000017#include "llvm/IR/CFG.h"
Chandler Carruth9fb823b2013-01-02 11:36:10 +000018#include "llvm/IR/Constants.h"
19#include "llvm/IR/Function.h"
20#include "llvm/IR/Instructions.h"
21#include "llvm/IR/LLVMContext.h"
22#include "llvm/IR/Metadata.h"
Andrew Trick3d4e64b2011-06-11 01:05:22 +000023#include "llvm/Support/Debug.h"
Benjamin Kramer16132e62015-03-23 18:07:13 +000024#include "llvm/Support/raw_ostream.h"
Andrew Trick49371f32011-06-04 01:16:30 +000025
26using namespace llvm;
27
Chandler Carruthf1221bd2014-04-22 02:48:03 +000028#define DEBUG_TYPE "branch-prob"
29
Cong Houab23bfb2015-07-15 22:48:29 +000030INITIALIZE_PASS_BEGIN(BranchProbabilityInfoWrapperPass, "branch-prob",
Andrew Trick49371f32011-06-04 01:16:30 +000031 "Branch Probability Analysis", false, true)
Chandler Carruth4f8f3072015-01-17 14:16:18 +000032INITIALIZE_PASS_DEPENDENCY(LoopInfoWrapperPass)
Cong Houab23bfb2015-07-15 22:48:29 +000033INITIALIZE_PASS_END(BranchProbabilityInfoWrapperPass, "branch-prob",
Andrew Trick49371f32011-06-04 01:16:30 +000034 "Branch Probability Analysis", false, true)
35
Cong Houab23bfb2015-07-15 22:48:29 +000036char BranchProbabilityInfoWrapperPass::ID = 0;
Andrew Trick49371f32011-06-04 01:16:30 +000037
Chandler Carruth7a0094a2011-10-24 01:40:45 +000038// Weights are for internal use only. They are used by heuristics to help to
39// estimate edges' probability. Example:
40//
41// Using "Loop Branch Heuristics" we predict weights of edges for the
42// block BB2.
43// ...
44// |
45// V
46// BB1<-+
47// | |
48// | | (Weight = 124)
49// V |
50// BB2--+
51// |
52// | (Weight = 4)
53// V
54// BB3
55//
56// Probability of the edge BB2->BB1 = 124 / (124 + 4) = 0.96875
57// Probability of the edge BB2->BB3 = 4 / (124 + 4) = 0.03125
58static const uint32_t LBH_TAKEN_WEIGHT = 124;
59static const uint32_t LBH_NONTAKEN_WEIGHT = 4;
Andrew Trick49371f32011-06-04 01:16:30 +000060
Chandler Carruth7111f452011-10-24 12:01:08 +000061/// \brief Unreachable-terminating branch taken weight.
62///
63/// This is the weight for a branch being taken to a block that terminates
64/// (eventually) in unreachable. These are predicted as unlikely as possible.
65static const uint32_t UR_TAKEN_WEIGHT = 1;
66
67/// \brief Unreachable-terminating branch not-taken weight.
68///
69/// This is the weight for a branch not being taken toward a block that
70/// terminates (eventually) in unreachable. Such a branch is essentially never
Chandler Carruthb024aa02011-12-22 09:26:37 +000071/// taken. Set the weight to an absurdly high value so that nested loops don't
72/// easily subsume it.
73static const uint32_t UR_NONTAKEN_WEIGHT = 1024*1024 - 1;
Andrew Trick49371f32011-06-04 01:16:30 +000074
Diego Novilloc6399532013-05-24 12:26:52 +000075/// \brief Weight for a branch taken going into a cold block.
76///
77/// This is the weight for a branch taken toward a block marked
78/// cold. A block is marked cold if it's postdominated by a
79/// block containing a call to a cold function. Cold functions
80/// are those marked with attribute 'cold'.
81static const uint32_t CC_TAKEN_WEIGHT = 4;
82
83/// \brief Weight for a branch not-taken into a cold block.
84///
85/// This is the weight for a branch not taken toward a block marked
86/// cold.
87static const uint32_t CC_NONTAKEN_WEIGHT = 64;
88
Chandler Carruth7a0094a2011-10-24 01:40:45 +000089static const uint32_t PH_TAKEN_WEIGHT = 20;
90static const uint32_t PH_NONTAKEN_WEIGHT = 12;
Andrew Trick49371f32011-06-04 01:16:30 +000091
Chandler Carruth7a0094a2011-10-24 01:40:45 +000092static const uint32_t ZH_TAKEN_WEIGHT = 20;
93static const uint32_t ZH_NONTAKEN_WEIGHT = 12;
Andrew Trick49371f32011-06-04 01:16:30 +000094
Chandler Carruth7a0094a2011-10-24 01:40:45 +000095static const uint32_t FPH_TAKEN_WEIGHT = 20;
96static const uint32_t FPH_NONTAKEN_WEIGHT = 12;
Andrew Trick49371f32011-06-04 01:16:30 +000097
Bill Wendlinge1c54262012-08-15 12:22:35 +000098/// \brief Invoke-terminating normal branch taken weight
99///
100/// This is the weight for branching to the normal destination of an invoke
101/// instruction. We expect this to happen most of the time. Set the weight to an
102/// absurdly high value so that nested loops subsume it.
103static const uint32_t IH_TAKEN_WEIGHT = 1024 * 1024 - 1;
104
105/// \brief Invoke-terminating normal branch not-taken weight.
106///
107/// This is the weight for branching to the unwind destination of an invoke
108/// instruction. This is essentially never taken.
109static const uint32_t IH_NONTAKEN_WEIGHT = 1;
110
Chandler Carruth7111f452011-10-24 12:01:08 +0000111/// \brief Calculate edge weights for successors lead to unreachable.
112///
113/// Predict that a successor which leads necessarily to an
114/// unreachable-terminated block as extremely unlikely.
Mehdi Aminia7978772016-04-07 21:59:28 +0000115bool BranchProbabilityInfo::calcUnreachableHeuristics(const BasicBlock *BB) {
116 const TerminatorInst *TI = BB->getTerminator();
Chandler Carruth7111f452011-10-24 12:01:08 +0000117 if (TI->getNumSuccessors() == 0) {
Sanjoy Das432c1c32016-04-18 19:01:28 +0000118 if (isa<UnreachableInst>(TI) ||
119 // If this block is terminated by a call to
120 // @llvm.experimental.deoptimize then treat it like an unreachable since
121 // the @llvm.experimental.deoptimize call is expected to practically
122 // never execute.
123 BB->getTerminatingDeoptimizeCall())
Chandler Carruth7111f452011-10-24 12:01:08 +0000124 PostDominatedByUnreachable.insert(BB);
125 return false;
126 }
127
Manman Rencf104462012-08-24 18:14:27 +0000128 SmallVector<unsigned, 4> UnreachableEdges;
129 SmallVector<unsigned, 4> ReachableEdges;
Chandler Carruth7111f452011-10-24 12:01:08 +0000130
Mehdi Aminia7978772016-04-07 21:59:28 +0000131 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
Chandler Carruth7111f452011-10-24 12:01:08 +0000132 if (PostDominatedByUnreachable.count(*I))
Manman Rencf104462012-08-24 18:14:27 +0000133 UnreachableEdges.push_back(I.getSuccessorIndex());
Chandler Carruth7111f452011-10-24 12:01:08 +0000134 else
Manman Rencf104462012-08-24 18:14:27 +0000135 ReachableEdges.push_back(I.getSuccessorIndex());
Chandler Carruth7111f452011-10-24 12:01:08 +0000136 }
137
138 // If all successors are in the set of blocks post-dominated by unreachable,
139 // this block is too.
140 if (UnreachableEdges.size() == TI->getNumSuccessors())
141 PostDominatedByUnreachable.insert(BB);
142
143 // Skip probabilities if this block has a single successor or if all were
144 // reachable.
145 if (TI->getNumSuccessors() == 1 || UnreachableEdges.empty())
146 return false;
147
Jun Bum Lima23e5f72015-12-21 22:00:51 +0000148 // If the terminator is an InvokeInst, check only the normal destination block
149 // as the unwind edge of InvokeInst is also very unlikely taken.
150 if (auto *II = dyn_cast<InvokeInst>(TI))
151 if (PostDominatedByUnreachable.count(II->getNormalDest())) {
152 PostDominatedByUnreachable.insert(BB);
153 // Return false here so that edge weights for InvokeInst could be decided
154 // in calcInvokeHeuristics().
155 return false;
156 }
157
Cong Houe93b8e12015-12-22 18:56:14 +0000158 if (ReachableEdges.empty()) {
159 BranchProbability Prob(1, UnreachableEdges.size());
160 for (unsigned SuccIdx : UnreachableEdges)
161 setEdgeProbability(BB, SuccIdx, Prob);
Chandler Carruth7111f452011-10-24 12:01:08 +0000162 return true;
Cong Houe93b8e12015-12-22 18:56:14 +0000163 }
164
165 BranchProbability UnreachableProb(UR_TAKEN_WEIGHT,
166 (UR_TAKEN_WEIGHT + UR_NONTAKEN_WEIGHT) *
167 UnreachableEdges.size());
168 BranchProbability ReachableProb(UR_NONTAKEN_WEIGHT,
169 (UR_TAKEN_WEIGHT + UR_NONTAKEN_WEIGHT) *
170 ReachableEdges.size());
171
172 for (unsigned SuccIdx : UnreachableEdges)
173 setEdgeProbability(BB, SuccIdx, UnreachableProb);
174 for (unsigned SuccIdx : ReachableEdges)
175 setEdgeProbability(BB, SuccIdx, ReachableProb);
Chandler Carruth7111f452011-10-24 12:01:08 +0000176
177 return true;
178}
179
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000180// Propagate existing explicit probabilities from either profile data or
181// 'expect' intrinsic processing.
Mehdi Aminia7978772016-04-07 21:59:28 +0000182bool BranchProbabilityInfo::calcMetadataWeights(const BasicBlock *BB) {
183 const TerminatorInst *TI = BB->getTerminator();
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000184 if (TI->getNumSuccessors() == 1)
185 return false;
186 if (!isa<BranchInst>(TI) && !isa<SwitchInst>(TI))
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000187 return false;
188
Duncan P. N. Exon Smithde36e802014-11-11 21:30:22 +0000189 MDNode *WeightsNode = TI->getMetadata(LLVMContext::MD_prof);
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000190 if (!WeightsNode)
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000191 return false;
192
Diego Novillode5b8012015-05-07 17:22:06 +0000193 // Check that the number of successors is manageable.
194 assert(TI->getNumSuccessors() < UINT32_MAX && "Too many successors");
195
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000196 // Ensure there are weights for all of the successors. Note that the first
197 // operand to the metadata node is a name, not a weight.
198 if (WeightsNode->getNumOperands() != TI->getNumSuccessors() + 1)
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000199 return false;
200
Diego Novillode5b8012015-05-07 17:22:06 +0000201 // Build up the final weights that will be used in a temporary buffer.
202 // Compute the sum of all weights to later decide whether they need to
203 // be scaled to fit in 32 bits.
204 uint64_t WeightSum = 0;
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000205 SmallVector<uint32_t, 2> Weights;
206 Weights.reserve(TI->getNumSuccessors());
207 for (unsigned i = 1, e = WeightsNode->getNumOperands(); i != e; ++i) {
Duncan P. N. Exon Smith5bf8fef2014-12-09 18:38:53 +0000208 ConstantInt *Weight =
209 mdconst::dyn_extract<ConstantInt>(WeightsNode->getOperand(i));
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000210 if (!Weight)
211 return false;
Diego Novillode5b8012015-05-07 17:22:06 +0000212 assert(Weight->getValue().getActiveBits() <= 32 &&
213 "Too many bits for uint32_t");
214 Weights.push_back(Weight->getZExtValue());
215 WeightSum += Weights.back();
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000216 }
217 assert(Weights.size() == TI->getNumSuccessors() && "Checked above");
Diego Novillode5b8012015-05-07 17:22:06 +0000218
219 // If the sum of weights does not fit in 32 bits, scale every weight down
220 // accordingly.
221 uint64_t ScalingFactor =
222 (WeightSum > UINT32_MAX) ? WeightSum / UINT32_MAX + 1 : 1;
223
224 WeightSum = 0;
225 for (unsigned i = 0, e = TI->getNumSuccessors(); i != e; ++i) {
Cong Houe93b8e12015-12-22 18:56:14 +0000226 Weights[i] /= ScalingFactor;
227 WeightSum += Weights[i];
Diego Novillode5b8012015-05-07 17:22:06 +0000228 }
Cong Hou6a2c71a2015-12-22 23:45:55 +0000229
230 if (WeightSum == 0) {
231 for (unsigned i = 0, e = TI->getNumSuccessors(); i != e; ++i)
232 setEdgeProbability(BB, i, {1, e});
233 } else {
234 for (unsigned i = 0, e = TI->getNumSuccessors(); i != e; ++i)
235 setEdgeProbability(BB, i, {Weights[i], static_cast<uint32_t>(WeightSum)});
236 }
Cong Houe93b8e12015-12-22 18:56:14 +0000237
Diego Novillode5b8012015-05-07 17:22:06 +0000238 assert(WeightSum <= UINT32_MAX &&
239 "Expected weights to scale down to 32 bits");
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000240
241 return true;
242}
243
Diego Novilloc6399532013-05-24 12:26:52 +0000244/// \brief Calculate edge weights for edges leading to cold blocks.
245///
246/// A cold block is one post-dominated by a block with a call to a
247/// cold function. Those edges are unlikely to be taken, so we give
248/// them relatively low weight.
249///
250/// Return true if we could compute the weights for cold edges.
251/// Return false, otherwise.
Mehdi Aminia7978772016-04-07 21:59:28 +0000252bool BranchProbabilityInfo::calcColdCallHeuristics(const BasicBlock *BB) {
253 const TerminatorInst *TI = BB->getTerminator();
Diego Novilloc6399532013-05-24 12:26:52 +0000254 if (TI->getNumSuccessors() == 0)
255 return false;
256
257 // Determine which successors are post-dominated by a cold block.
258 SmallVector<unsigned, 4> ColdEdges;
Diego Novilloc6399532013-05-24 12:26:52 +0000259 SmallVector<unsigned, 4> NormalEdges;
Mehdi Aminia7978772016-04-07 21:59:28 +0000260 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I)
Diego Novilloc6399532013-05-24 12:26:52 +0000261 if (PostDominatedByColdCall.count(*I))
262 ColdEdges.push_back(I.getSuccessorIndex());
263 else
264 NormalEdges.push_back(I.getSuccessorIndex());
265
266 // If all successors are in the set of blocks post-dominated by cold calls,
267 // this block is in the set post-dominated by cold calls.
268 if (ColdEdges.size() == TI->getNumSuccessors())
269 PostDominatedByColdCall.insert(BB);
270 else {
271 // Otherwise, if the block itself contains a cold function, add it to the
272 // set of blocks postdominated by a cold call.
273 assert(!PostDominatedByColdCall.count(BB));
Mehdi Aminia7978772016-04-07 21:59:28 +0000274 for (BasicBlock::const_iterator I = BB->begin(), E = BB->end(); I != E; ++I)
275 if (const CallInst *CI = dyn_cast<CallInst>(I))
Diego Novilloc6399532013-05-24 12:26:52 +0000276 if (CI->hasFnAttr(Attribute::Cold)) {
277 PostDominatedByColdCall.insert(BB);
278 break;
279 }
280 }
281
282 // Skip probabilities if this block has a single successor.
283 if (TI->getNumSuccessors() == 1 || ColdEdges.empty())
284 return false;
285
Cong Houe93b8e12015-12-22 18:56:14 +0000286 if (NormalEdges.empty()) {
287 BranchProbability Prob(1, ColdEdges.size());
288 for (unsigned SuccIdx : ColdEdges)
289 setEdgeProbability(BB, SuccIdx, Prob);
Diego Novilloc6399532013-05-24 12:26:52 +0000290 return true;
Cong Houe93b8e12015-12-22 18:56:14 +0000291 }
292
293 BranchProbability ColdProb(CC_TAKEN_WEIGHT,
294 (CC_TAKEN_WEIGHT + CC_NONTAKEN_WEIGHT) *
295 ColdEdges.size());
296 BranchProbability NormalProb(CC_NONTAKEN_WEIGHT,
297 (CC_TAKEN_WEIGHT + CC_NONTAKEN_WEIGHT) *
298 NormalEdges.size());
299
300 for (unsigned SuccIdx : ColdEdges)
301 setEdgeProbability(BB, SuccIdx, ColdProb);
302 for (unsigned SuccIdx : NormalEdges)
303 setEdgeProbability(BB, SuccIdx, NormalProb);
Diego Novilloc6399532013-05-24 12:26:52 +0000304
305 return true;
306}
307
Andrew Trick49371f32011-06-04 01:16:30 +0000308// Calculate Edge Weights using "Pointer Heuristics". Predict a comparsion
309// between two pointer or pointer and NULL will fail.
Mehdi Aminia7978772016-04-07 21:59:28 +0000310bool BranchProbabilityInfo::calcPointerHeuristics(const BasicBlock *BB) {
311 const BranchInst *BI = dyn_cast<BranchInst>(BB->getTerminator());
Andrew Trick49371f32011-06-04 01:16:30 +0000312 if (!BI || !BI->isConditional())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000313 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000314
315 Value *Cond = BI->getCondition();
316 ICmpInst *CI = dyn_cast<ICmpInst>(Cond);
Jakub Staszakabb236f2011-07-15 20:51:06 +0000317 if (!CI || !CI->isEquality())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000318 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000319
320 Value *LHS = CI->getOperand(0);
Andrew Trick49371f32011-06-04 01:16:30 +0000321
322 if (!LHS->getType()->isPointerTy())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000323 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000324
Nick Lewycky75b20532011-06-04 02:07:10 +0000325 assert(CI->getOperand(1)->getType()->isPointerTy());
Andrew Trick49371f32011-06-04 01:16:30 +0000326
Andrew Trick49371f32011-06-04 01:16:30 +0000327 // p != 0 -> isProb = true
328 // p == 0 -> isProb = false
329 // p != q -> isProb = true
330 // p == q -> isProb = false;
Manman Rencf104462012-08-24 18:14:27 +0000331 unsigned TakenIdx = 0, NonTakenIdx = 1;
Jakub Staszakabb236f2011-07-15 20:51:06 +0000332 bool isProb = CI->getPredicate() == ICmpInst::ICMP_NE;
Andrew Trick49371f32011-06-04 01:16:30 +0000333 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000334 std::swap(TakenIdx, NonTakenIdx);
Andrew Trick49371f32011-06-04 01:16:30 +0000335
Cong Houe93b8e12015-12-22 18:56:14 +0000336 BranchProbability TakenProb(PH_TAKEN_WEIGHT,
337 PH_TAKEN_WEIGHT + PH_NONTAKEN_WEIGHT);
338 setEdgeProbability(BB, TakenIdx, TakenProb);
339 setEdgeProbability(BB, NonTakenIdx, TakenProb.getCompl());
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000340 return true;
Andrew Trick49371f32011-06-04 01:16:30 +0000341}
342
343// Calculate Edge Weights using "Loop Branch Heuristics". Predict backedges
344// as taken, exiting edges as not-taken.
Mehdi Aminia7978772016-04-07 21:59:28 +0000345bool BranchProbabilityInfo::calcLoopBranchHeuristics(const BasicBlock *BB,
Cong Houab23bfb2015-07-15 22:48:29 +0000346 const LoopInfo &LI) {
347 Loop *L = LI.getLoopFor(BB);
Andrew Trick49371f32011-06-04 01:16:30 +0000348 if (!L)
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000349 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000350
Manman Rencf104462012-08-24 18:14:27 +0000351 SmallVector<unsigned, 8> BackEdges;
352 SmallVector<unsigned, 8> ExitingEdges;
353 SmallVector<unsigned, 8> InEdges; // Edges from header to the loop.
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000354
Mehdi Aminia7978772016-04-07 21:59:28 +0000355 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
Chandler Carruth32f46e72011-10-25 09:47:41 +0000356 if (!L->contains(*I))
Manman Rencf104462012-08-24 18:14:27 +0000357 ExitingEdges.push_back(I.getSuccessorIndex());
Chandler Carruth32f46e72011-10-25 09:47:41 +0000358 else if (L->getHeader() == *I)
Manman Rencf104462012-08-24 18:14:27 +0000359 BackEdges.push_back(I.getSuccessorIndex());
Chandler Carruth32f46e72011-10-25 09:47:41 +0000360 else
Manman Rencf104462012-08-24 18:14:27 +0000361 InEdges.push_back(I.getSuccessorIndex());
Andrew Trick49371f32011-06-04 01:16:30 +0000362 }
363
Akira Hatanaka5638b892014-04-14 16:56:19 +0000364 if (BackEdges.empty() && ExitingEdges.empty())
365 return false;
366
Cong Houe93b8e12015-12-22 18:56:14 +0000367 // Collect the sum of probabilities of back-edges/in-edges/exiting-edges, and
368 // normalize them so that they sum up to one.
369 SmallVector<BranchProbability, 4> Probs(3, BranchProbability::getZero());
370 unsigned Denom = (BackEdges.empty() ? 0 : LBH_TAKEN_WEIGHT) +
371 (InEdges.empty() ? 0 : LBH_TAKEN_WEIGHT) +
372 (ExitingEdges.empty() ? 0 : LBH_NONTAKEN_WEIGHT);
373 if (!BackEdges.empty())
374 Probs[0] = BranchProbability(LBH_TAKEN_WEIGHT, Denom);
375 if (!InEdges.empty())
376 Probs[1] = BranchProbability(LBH_TAKEN_WEIGHT, Denom);
377 if (!ExitingEdges.empty())
378 Probs[2] = BranchProbability(LBH_NONTAKEN_WEIGHT, Denom);
Andrew Trick49371f32011-06-04 01:16:30 +0000379
Cong Houe93b8e12015-12-22 18:56:14 +0000380 if (uint32_t numBackEdges = BackEdges.size()) {
381 auto Prob = Probs[0] / numBackEdges;
382 for (unsigned SuccIdx : BackEdges)
383 setEdgeProbability(BB, SuccIdx, Prob);
Andrew Trick49371f32011-06-04 01:16:30 +0000384 }
385
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000386 if (uint32_t numInEdges = InEdges.size()) {
Cong Houe93b8e12015-12-22 18:56:14 +0000387 auto Prob = Probs[1] / numInEdges;
388 for (unsigned SuccIdx : InEdges)
389 setEdgeProbability(BB, SuccIdx, Prob);
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000390 }
391
Chandler Carruth32f46e72011-10-25 09:47:41 +0000392 if (uint32_t numExitingEdges = ExitingEdges.size()) {
Cong Houe93b8e12015-12-22 18:56:14 +0000393 auto Prob = Probs[2] / numExitingEdges;
394 for (unsigned SuccIdx : ExitingEdges)
395 setEdgeProbability(BB, SuccIdx, Prob);
Andrew Trick49371f32011-06-04 01:16:30 +0000396 }
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000397
398 return true;
Andrew Trick49371f32011-06-04 01:16:30 +0000399}
400
Mehdi Aminia7978772016-04-07 21:59:28 +0000401bool BranchProbabilityInfo::calcZeroHeuristics(const BasicBlock *BB) {
402 const BranchInst *BI = dyn_cast<BranchInst>(BB->getTerminator());
Jakub Staszak17af66a2011-07-31 03:27:24 +0000403 if (!BI || !BI->isConditional())
404 return false;
405
406 Value *Cond = BI->getCondition();
407 ICmpInst *CI = dyn_cast<ICmpInst>(Cond);
408 if (!CI)
409 return false;
410
Jakub Staszak17af66a2011-07-31 03:27:24 +0000411 Value *RHS = CI->getOperand(1);
Jakub Staszakbfb1ae22011-07-31 04:47:20 +0000412 ConstantInt *CV = dyn_cast<ConstantInt>(RHS);
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000413 if (!CV)
Jakub Staszak17af66a2011-07-31 03:27:24 +0000414 return false;
415
Daniel Jaspera73f3d52015-04-15 06:24:07 +0000416 // If the LHS is the result of AND'ing a value with a single bit bitmask,
417 // we don't have information about probabilities.
418 if (Instruction *LHS = dyn_cast<Instruction>(CI->getOperand(0)))
419 if (LHS->getOpcode() == Instruction::And)
420 if (ConstantInt *AndRHS = dyn_cast<ConstantInt>(LHS->getOperand(1)))
421 if (AndRHS->getUniqueInteger().isPowerOf2())
422 return false;
423
Jakub Staszak17af66a2011-07-31 03:27:24 +0000424 bool isProb;
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000425 if (CV->isZero()) {
426 switch (CI->getPredicate()) {
427 case CmpInst::ICMP_EQ:
428 // X == 0 -> Unlikely
429 isProb = false;
430 break;
431 case CmpInst::ICMP_NE:
432 // X != 0 -> Likely
433 isProb = true;
434 break;
435 case CmpInst::ICMP_SLT:
436 // X < 0 -> Unlikely
437 isProb = false;
438 break;
439 case CmpInst::ICMP_SGT:
440 // X > 0 -> Likely
441 isProb = true;
442 break;
443 default:
444 return false;
445 }
446 } else if (CV->isOne() && CI->getPredicate() == CmpInst::ICMP_SLT) {
447 // InstCombine canonicalizes X <= 0 into X < 1.
448 // X <= 0 -> Unlikely
Jakub Staszak17af66a2011-07-31 03:27:24 +0000449 isProb = false;
Hal Finkel4d949302013-11-01 10:58:22 +0000450 } else if (CV->isAllOnesValue()) {
451 switch (CI->getPredicate()) {
452 case CmpInst::ICMP_EQ:
453 // X == -1 -> Unlikely
454 isProb = false;
455 break;
456 case CmpInst::ICMP_NE:
457 // X != -1 -> Likely
458 isProb = true;
459 break;
460 case CmpInst::ICMP_SGT:
461 // InstCombine canonicalizes X >= 0 into X > -1.
462 // X >= 0 -> Likely
463 isProb = true;
464 break;
465 default:
466 return false;
467 }
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000468 } else {
Jakub Staszak17af66a2011-07-31 03:27:24 +0000469 return false;
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000470 }
Jakub Staszak17af66a2011-07-31 03:27:24 +0000471
Manman Rencf104462012-08-24 18:14:27 +0000472 unsigned TakenIdx = 0, NonTakenIdx = 1;
Jakub Staszak17af66a2011-07-31 03:27:24 +0000473
474 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000475 std::swap(TakenIdx, NonTakenIdx);
Jakub Staszak17af66a2011-07-31 03:27:24 +0000476
Cong Houe93b8e12015-12-22 18:56:14 +0000477 BranchProbability TakenProb(ZH_TAKEN_WEIGHT,
478 ZH_TAKEN_WEIGHT + ZH_NONTAKEN_WEIGHT);
479 setEdgeProbability(BB, TakenIdx, TakenProb);
480 setEdgeProbability(BB, NonTakenIdx, TakenProb.getCompl());
Jakub Staszak17af66a2011-07-31 03:27:24 +0000481 return true;
482}
483
Mehdi Aminia7978772016-04-07 21:59:28 +0000484bool BranchProbabilityInfo::calcFloatingPointHeuristics(const BasicBlock *BB) {
485 const BranchInst *BI = dyn_cast<BranchInst>(BB->getTerminator());
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000486 if (!BI || !BI->isConditional())
487 return false;
488
489 Value *Cond = BI->getCondition();
490 FCmpInst *FCmp = dyn_cast<FCmpInst>(Cond);
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000491 if (!FCmp)
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000492 return false;
493
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000494 bool isProb;
495 if (FCmp->isEquality()) {
496 // f1 == f2 -> Unlikely
497 // f1 != f2 -> Likely
498 isProb = !FCmp->isTrueWhenEqual();
499 } else if (FCmp->getPredicate() == FCmpInst::FCMP_ORD) {
500 // !isnan -> Likely
501 isProb = true;
502 } else if (FCmp->getPredicate() == FCmpInst::FCMP_UNO) {
503 // isnan -> Unlikely
504 isProb = false;
505 } else {
506 return false;
507 }
508
Manman Rencf104462012-08-24 18:14:27 +0000509 unsigned TakenIdx = 0, NonTakenIdx = 1;
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000510
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000511 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000512 std::swap(TakenIdx, NonTakenIdx);
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000513
Cong Houe93b8e12015-12-22 18:56:14 +0000514 BranchProbability TakenProb(FPH_TAKEN_WEIGHT,
515 FPH_TAKEN_WEIGHT + FPH_NONTAKEN_WEIGHT);
516 setEdgeProbability(BB, TakenIdx, TakenProb);
517 setEdgeProbability(BB, NonTakenIdx, TakenProb.getCompl());
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000518 return true;
519}
Jakub Staszak17af66a2011-07-31 03:27:24 +0000520
Mehdi Aminia7978772016-04-07 21:59:28 +0000521bool BranchProbabilityInfo::calcInvokeHeuristics(const BasicBlock *BB) {
522 const InvokeInst *II = dyn_cast<InvokeInst>(BB->getTerminator());
Bill Wendlinge1c54262012-08-15 12:22:35 +0000523 if (!II)
524 return false;
525
Cong Houe93b8e12015-12-22 18:56:14 +0000526 BranchProbability TakenProb(IH_TAKEN_WEIGHT,
527 IH_TAKEN_WEIGHT + IH_NONTAKEN_WEIGHT);
528 setEdgeProbability(BB, 0 /*Index for Normal*/, TakenProb);
529 setEdgeProbability(BB, 1 /*Index for Unwind*/, TakenProb.getCompl());
Bill Wendlinge1c54262012-08-15 12:22:35 +0000530 return true;
531}
532
Pete Cooperb9d2e342015-05-28 19:43:06 +0000533void BranchProbabilityInfo::releaseMemory() {
Cong Houe93b8e12015-12-22 18:56:14 +0000534 Probs.clear();
Pete Cooperb9d2e342015-05-28 19:43:06 +0000535}
536
Cong Houab23bfb2015-07-15 22:48:29 +0000537void BranchProbabilityInfo::print(raw_ostream &OS) const {
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000538 OS << "---- Branch Probabilities ----\n";
539 // We print the probabilities from the last function the analysis ran over,
540 // or the function it is currently running over.
541 assert(LastF && "Cannot print prior to running over a function");
Duncan P. N. Exon Smith5a82c912015-10-10 00:53:03 +0000542 for (const auto &BI : *LastF) {
543 for (succ_const_iterator SI = succ_begin(&BI), SE = succ_end(&BI); SI != SE;
544 ++SI) {
545 printEdgeProbability(OS << " ", &BI, *SI);
Duncan P. N. Exon Smith6c990152014-07-21 17:06:51 +0000546 }
547 }
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000548}
549
Jakub Staszakefd94c82011-07-29 19:30:00 +0000550bool BranchProbabilityInfo::
551isEdgeHot(const BasicBlock *Src, const BasicBlock *Dst) const {
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000552 // Hot probability is at least 4/5 = 80%
Benjamin Kramer929f53f2011-10-23 11:19:14 +0000553 // FIXME: Compare against a static "hot" BranchProbability.
554 return getEdgeProbability(Src, Dst) > BranchProbability(4, 5);
Andrew Trick49371f32011-06-04 01:16:30 +0000555}
556
Mehdi Aminia7978772016-04-07 21:59:28 +0000557const BasicBlock *
558BranchProbabilityInfo::getHotSucc(const BasicBlock *BB) const {
Cong Houe93b8e12015-12-22 18:56:14 +0000559 auto MaxProb = BranchProbability::getZero();
Mehdi Aminia7978772016-04-07 21:59:28 +0000560 const BasicBlock *MaxSucc = nullptr;
Andrew Trick49371f32011-06-04 01:16:30 +0000561
Mehdi Aminia7978772016-04-07 21:59:28 +0000562 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
563 const BasicBlock *Succ = *I;
Cong Houe93b8e12015-12-22 18:56:14 +0000564 auto Prob = getEdgeProbability(BB, Succ);
565 if (Prob > MaxProb) {
566 MaxProb = Prob;
Andrew Trick49371f32011-06-04 01:16:30 +0000567 MaxSucc = Succ;
568 }
569 }
570
Benjamin Kramer929f53f2011-10-23 11:19:14 +0000571 // Hot probability is at least 4/5 = 80%
Cong Houe93b8e12015-12-22 18:56:14 +0000572 if (MaxProb > BranchProbability(4, 5))
Andrew Trick49371f32011-06-04 01:16:30 +0000573 return MaxSucc;
574
Craig Topper9f008862014-04-15 04:59:12 +0000575 return nullptr;
Andrew Trick49371f32011-06-04 01:16:30 +0000576}
577
Cong Houe93b8e12015-12-22 18:56:14 +0000578/// Get the raw edge probability for the edge. If can't find it, return a
579/// default probability 1/N where N is the number of successors. Here an edge is
580/// specified using PredBlock and an
581/// index to the successors.
582BranchProbability
583BranchProbabilityInfo::getEdgeProbability(const BasicBlock *Src,
584 unsigned IndexInSuccessors) const {
585 auto I = Probs.find(std::make_pair(Src, IndexInSuccessors));
Andrew Trick49371f32011-06-04 01:16:30 +0000586
Cong Houe93b8e12015-12-22 18:56:14 +0000587 if (I != Probs.end())
Andrew Trick49371f32011-06-04 01:16:30 +0000588 return I->second;
589
Cong Houe93b8e12015-12-22 18:56:14 +0000590 return {1,
591 static_cast<uint32_t>(std::distance(succ_begin(Src), succ_end(Src)))};
Andrew Trick49371f32011-06-04 01:16:30 +0000592}
593
Cong Houd97c1002015-12-01 05:29:22 +0000594BranchProbability
595BranchProbabilityInfo::getEdgeProbability(const BasicBlock *Src,
596 succ_const_iterator Dst) const {
597 return getEdgeProbability(Src, Dst.getSuccessorIndex());
598}
599
Cong Houe93b8e12015-12-22 18:56:14 +0000600/// Get the raw edge probability calculated for the block pair. This returns the
601/// sum of all raw edge probabilities from Src to Dst.
602BranchProbability
603BranchProbabilityInfo::getEdgeProbability(const BasicBlock *Src,
604 const BasicBlock *Dst) const {
605 auto Prob = BranchProbability::getZero();
606 bool FoundProb = false;
607 for (succ_const_iterator I = succ_begin(Src), E = succ_end(Src); I != E; ++I)
608 if (*I == Dst) {
609 auto MapI = Probs.find(std::make_pair(Src, I.getSuccessorIndex()));
610 if (MapI != Probs.end()) {
611 FoundProb = true;
612 Prob += MapI->second;
613 }
614 }
615 uint32_t succ_num = std::distance(succ_begin(Src), succ_end(Src));
616 return FoundProb ? Prob : BranchProbability(1, succ_num);
617}
618
619/// Set the edge probability for a given edge specified by PredBlock and an
620/// index to the successors.
621void BranchProbabilityInfo::setEdgeProbability(const BasicBlock *Src,
622 unsigned IndexInSuccessors,
623 BranchProbability Prob) {
624 Probs[std::make_pair(Src, IndexInSuccessors)] = Prob;
625 DEBUG(dbgs() << "set edge " << Src->getName() << " -> " << IndexInSuccessors
626 << " successor probability to " << Prob << "\n");
627}
628
Andrew Trick49371f32011-06-04 01:16:30 +0000629raw_ostream &
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000630BranchProbabilityInfo::printEdgeProbability(raw_ostream &OS,
631 const BasicBlock *Src,
632 const BasicBlock *Dst) const {
Andrew Trick49371f32011-06-04 01:16:30 +0000633
Jakub Staszak12a43bd2011-06-16 20:22:37 +0000634 const BranchProbability Prob = getEdgeProbability(Src, Dst);
Benjamin Kramer1f97a5a2011-11-15 16:27:03 +0000635 OS << "edge " << Src->getName() << " -> " << Dst->getName()
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000636 << " probability is " << Prob
637 << (isEdgeHot(Src, Dst) ? " [HOT edge]\n" : "\n");
Andrew Trick49371f32011-06-04 01:16:30 +0000638
639 return OS;
640}
Cong Houab23bfb2015-07-15 22:48:29 +0000641
Mehdi Aminia7978772016-04-07 21:59:28 +0000642void BranchProbabilityInfo::calculate(const Function &F, const LoopInfo &LI) {
Cong Houab23bfb2015-07-15 22:48:29 +0000643 DEBUG(dbgs() << "---- Branch Probability Info : " << F.getName()
644 << " ----\n\n");
645 LastF = &F; // Store the last function we ran on for printing.
646 assert(PostDominatedByUnreachable.empty());
647 assert(PostDominatedByColdCall.empty());
648
649 // Walk the basic blocks in post-order so that we can build up state about
650 // the successors of a block iteratively.
651 for (auto BB : post_order(&F.getEntryBlock())) {
652 DEBUG(dbgs() << "Computing probabilities for " << BB->getName() << "\n");
653 if (calcUnreachableHeuristics(BB))
654 continue;
655 if (calcMetadataWeights(BB))
656 continue;
657 if (calcColdCallHeuristics(BB))
658 continue;
659 if (calcLoopBranchHeuristics(BB, LI))
660 continue;
661 if (calcPointerHeuristics(BB))
662 continue;
663 if (calcZeroHeuristics(BB))
664 continue;
665 if (calcFloatingPointHeuristics(BB))
666 continue;
667 calcInvokeHeuristics(BB);
668 }
669
670 PostDominatedByUnreachable.clear();
671 PostDominatedByColdCall.clear();
672}
673
674void BranchProbabilityInfoWrapperPass::getAnalysisUsage(
675 AnalysisUsage &AU) const {
676 AU.addRequired<LoopInfoWrapperPass>();
677 AU.setPreservesAll();
678}
679
680bool BranchProbabilityInfoWrapperPass::runOnFunction(Function &F) {
681 const LoopInfo &LI = getAnalysis<LoopInfoWrapperPass>().getLoopInfo();
682 BPI.calculate(F, LI);
683 return false;
684}
685
686void BranchProbabilityInfoWrapperPass::releaseMemory() { BPI.releaseMemory(); }
687
688void BranchProbabilityInfoWrapperPass::print(raw_ostream &OS,
689 const Module *) const {
690 BPI.print(OS);
691}