blob: 8512391d5ee107a2bc5f7d54476b68e1d68c4977 [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) {
118 if (isa<UnreachableInst>(TI))
119 PostDominatedByUnreachable.insert(BB);
120 return false;
121 }
122
Manman Rencf104462012-08-24 18:14:27 +0000123 SmallVector<unsigned, 4> UnreachableEdges;
124 SmallVector<unsigned, 4> ReachableEdges;
Chandler Carruth7111f452011-10-24 12:01:08 +0000125
Mehdi Aminia7978772016-04-07 21:59:28 +0000126 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
Chandler Carruth7111f452011-10-24 12:01:08 +0000127 if (PostDominatedByUnreachable.count(*I))
Manman Rencf104462012-08-24 18:14:27 +0000128 UnreachableEdges.push_back(I.getSuccessorIndex());
Chandler Carruth7111f452011-10-24 12:01:08 +0000129 else
Manman Rencf104462012-08-24 18:14:27 +0000130 ReachableEdges.push_back(I.getSuccessorIndex());
Chandler Carruth7111f452011-10-24 12:01:08 +0000131 }
132
133 // If all successors are in the set of blocks post-dominated by unreachable,
134 // this block is too.
135 if (UnreachableEdges.size() == TI->getNumSuccessors())
136 PostDominatedByUnreachable.insert(BB);
137
138 // Skip probabilities if this block has a single successor or if all were
139 // reachable.
140 if (TI->getNumSuccessors() == 1 || UnreachableEdges.empty())
141 return false;
142
Jun Bum Lima23e5f72015-12-21 22:00:51 +0000143 // If the terminator is an InvokeInst, check only the normal destination block
144 // as the unwind edge of InvokeInst is also very unlikely taken.
145 if (auto *II = dyn_cast<InvokeInst>(TI))
146 if (PostDominatedByUnreachable.count(II->getNormalDest())) {
147 PostDominatedByUnreachable.insert(BB);
148 // Return false here so that edge weights for InvokeInst could be decided
149 // in calcInvokeHeuristics().
150 return false;
151 }
152
Cong Houe93b8e12015-12-22 18:56:14 +0000153 if (ReachableEdges.empty()) {
154 BranchProbability Prob(1, UnreachableEdges.size());
155 for (unsigned SuccIdx : UnreachableEdges)
156 setEdgeProbability(BB, SuccIdx, Prob);
Chandler Carruth7111f452011-10-24 12:01:08 +0000157 return true;
Cong Houe93b8e12015-12-22 18:56:14 +0000158 }
159
160 BranchProbability UnreachableProb(UR_TAKEN_WEIGHT,
161 (UR_TAKEN_WEIGHT + UR_NONTAKEN_WEIGHT) *
162 UnreachableEdges.size());
163 BranchProbability ReachableProb(UR_NONTAKEN_WEIGHT,
164 (UR_TAKEN_WEIGHT + UR_NONTAKEN_WEIGHT) *
165 ReachableEdges.size());
166
167 for (unsigned SuccIdx : UnreachableEdges)
168 setEdgeProbability(BB, SuccIdx, UnreachableProb);
169 for (unsigned SuccIdx : ReachableEdges)
170 setEdgeProbability(BB, SuccIdx, ReachableProb);
Chandler Carruth7111f452011-10-24 12:01:08 +0000171
172 return true;
173}
174
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000175// Propagate existing explicit probabilities from either profile data or
176// 'expect' intrinsic processing.
Mehdi Aminia7978772016-04-07 21:59:28 +0000177bool BranchProbabilityInfo::calcMetadataWeights(const BasicBlock *BB) {
178 const TerminatorInst *TI = BB->getTerminator();
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000179 if (TI->getNumSuccessors() == 1)
180 return false;
181 if (!isa<BranchInst>(TI) && !isa<SwitchInst>(TI))
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000182 return false;
183
Duncan P. N. Exon Smithde36e802014-11-11 21:30:22 +0000184 MDNode *WeightsNode = TI->getMetadata(LLVMContext::MD_prof);
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000185 if (!WeightsNode)
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000186 return false;
187
Diego Novillode5b8012015-05-07 17:22:06 +0000188 // Check that the number of successors is manageable.
189 assert(TI->getNumSuccessors() < UINT32_MAX && "Too many successors");
190
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000191 // Ensure there are weights for all of the successors. Note that the first
192 // operand to the metadata node is a name, not a weight.
193 if (WeightsNode->getNumOperands() != TI->getNumSuccessors() + 1)
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000194 return false;
195
Diego Novillode5b8012015-05-07 17:22:06 +0000196 // Build up the final weights that will be used in a temporary buffer.
197 // Compute the sum of all weights to later decide whether they need to
198 // be scaled to fit in 32 bits.
199 uint64_t WeightSum = 0;
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000200 SmallVector<uint32_t, 2> Weights;
201 Weights.reserve(TI->getNumSuccessors());
202 for (unsigned i = 1, e = WeightsNode->getNumOperands(); i != e; ++i) {
Duncan P. N. Exon Smith5bf8fef2014-12-09 18:38:53 +0000203 ConstantInt *Weight =
204 mdconst::dyn_extract<ConstantInt>(WeightsNode->getOperand(i));
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000205 if (!Weight)
206 return false;
Diego Novillode5b8012015-05-07 17:22:06 +0000207 assert(Weight->getValue().getActiveBits() <= 32 &&
208 "Too many bits for uint32_t");
209 Weights.push_back(Weight->getZExtValue());
210 WeightSum += Weights.back();
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000211 }
212 assert(Weights.size() == TI->getNumSuccessors() && "Checked above");
Diego Novillode5b8012015-05-07 17:22:06 +0000213
214 // If the sum of weights does not fit in 32 bits, scale every weight down
215 // accordingly.
216 uint64_t ScalingFactor =
217 (WeightSum > UINT32_MAX) ? WeightSum / UINT32_MAX + 1 : 1;
218
219 WeightSum = 0;
220 for (unsigned i = 0, e = TI->getNumSuccessors(); i != e; ++i) {
Cong Houe93b8e12015-12-22 18:56:14 +0000221 Weights[i] /= ScalingFactor;
222 WeightSum += Weights[i];
Diego Novillode5b8012015-05-07 17:22:06 +0000223 }
Cong Hou6a2c71a2015-12-22 23:45:55 +0000224
225 if (WeightSum == 0) {
226 for (unsigned i = 0, e = TI->getNumSuccessors(); i != e; ++i)
227 setEdgeProbability(BB, i, {1, e});
228 } else {
229 for (unsigned i = 0, e = TI->getNumSuccessors(); i != e; ++i)
230 setEdgeProbability(BB, i, {Weights[i], static_cast<uint32_t>(WeightSum)});
231 }
Cong Houe93b8e12015-12-22 18:56:14 +0000232
Diego Novillode5b8012015-05-07 17:22:06 +0000233 assert(WeightSum <= UINT32_MAX &&
234 "Expected weights to scale down to 32 bits");
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000235
236 return true;
237}
238
Diego Novilloc6399532013-05-24 12:26:52 +0000239/// \brief Calculate edge weights for edges leading to cold blocks.
240///
241/// A cold block is one post-dominated by a block with a call to a
242/// cold function. Those edges are unlikely to be taken, so we give
243/// them relatively low weight.
244///
245/// Return true if we could compute the weights for cold edges.
246/// Return false, otherwise.
Mehdi Aminia7978772016-04-07 21:59:28 +0000247bool BranchProbabilityInfo::calcColdCallHeuristics(const BasicBlock *BB) {
248 const TerminatorInst *TI = BB->getTerminator();
Diego Novilloc6399532013-05-24 12:26:52 +0000249 if (TI->getNumSuccessors() == 0)
250 return false;
251
252 // Determine which successors are post-dominated by a cold block.
253 SmallVector<unsigned, 4> ColdEdges;
Diego Novilloc6399532013-05-24 12:26:52 +0000254 SmallVector<unsigned, 4> NormalEdges;
Mehdi Aminia7978772016-04-07 21:59:28 +0000255 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I)
Diego Novilloc6399532013-05-24 12:26:52 +0000256 if (PostDominatedByColdCall.count(*I))
257 ColdEdges.push_back(I.getSuccessorIndex());
258 else
259 NormalEdges.push_back(I.getSuccessorIndex());
260
261 // If all successors are in the set of blocks post-dominated by cold calls,
262 // this block is in the set post-dominated by cold calls.
263 if (ColdEdges.size() == TI->getNumSuccessors())
264 PostDominatedByColdCall.insert(BB);
265 else {
266 // Otherwise, if the block itself contains a cold function, add it to the
267 // set of blocks postdominated by a cold call.
268 assert(!PostDominatedByColdCall.count(BB));
Mehdi Aminia7978772016-04-07 21:59:28 +0000269 for (BasicBlock::const_iterator I = BB->begin(), E = BB->end(); I != E; ++I)
270 if (const CallInst *CI = dyn_cast<CallInst>(I))
Diego Novilloc6399532013-05-24 12:26:52 +0000271 if (CI->hasFnAttr(Attribute::Cold)) {
272 PostDominatedByColdCall.insert(BB);
273 break;
274 }
275 }
276
277 // Skip probabilities if this block has a single successor.
278 if (TI->getNumSuccessors() == 1 || ColdEdges.empty())
279 return false;
280
Cong Houe93b8e12015-12-22 18:56:14 +0000281 if (NormalEdges.empty()) {
282 BranchProbability Prob(1, ColdEdges.size());
283 for (unsigned SuccIdx : ColdEdges)
284 setEdgeProbability(BB, SuccIdx, Prob);
Diego Novilloc6399532013-05-24 12:26:52 +0000285 return true;
Cong Houe93b8e12015-12-22 18:56:14 +0000286 }
287
288 BranchProbability ColdProb(CC_TAKEN_WEIGHT,
289 (CC_TAKEN_WEIGHT + CC_NONTAKEN_WEIGHT) *
290 ColdEdges.size());
291 BranchProbability NormalProb(CC_NONTAKEN_WEIGHT,
292 (CC_TAKEN_WEIGHT + CC_NONTAKEN_WEIGHT) *
293 NormalEdges.size());
294
295 for (unsigned SuccIdx : ColdEdges)
296 setEdgeProbability(BB, SuccIdx, ColdProb);
297 for (unsigned SuccIdx : NormalEdges)
298 setEdgeProbability(BB, SuccIdx, NormalProb);
Diego Novilloc6399532013-05-24 12:26:52 +0000299
300 return true;
301}
302
Andrew Trick49371f32011-06-04 01:16:30 +0000303// Calculate Edge Weights using "Pointer Heuristics". Predict a comparsion
304// between two pointer or pointer and NULL will fail.
Mehdi Aminia7978772016-04-07 21:59:28 +0000305bool BranchProbabilityInfo::calcPointerHeuristics(const BasicBlock *BB) {
306 const BranchInst *BI = dyn_cast<BranchInst>(BB->getTerminator());
Andrew Trick49371f32011-06-04 01:16:30 +0000307 if (!BI || !BI->isConditional())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000308 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000309
310 Value *Cond = BI->getCondition();
311 ICmpInst *CI = dyn_cast<ICmpInst>(Cond);
Jakub Staszakabb236f2011-07-15 20:51:06 +0000312 if (!CI || !CI->isEquality())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000313 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000314
315 Value *LHS = CI->getOperand(0);
Andrew Trick49371f32011-06-04 01:16:30 +0000316
317 if (!LHS->getType()->isPointerTy())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000318 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000319
Nick Lewycky75b20532011-06-04 02:07:10 +0000320 assert(CI->getOperand(1)->getType()->isPointerTy());
Andrew Trick49371f32011-06-04 01:16:30 +0000321
Andrew Trick49371f32011-06-04 01:16:30 +0000322 // p != 0 -> isProb = true
323 // p == 0 -> isProb = false
324 // p != q -> isProb = true
325 // p == q -> isProb = false;
Manman Rencf104462012-08-24 18:14:27 +0000326 unsigned TakenIdx = 0, NonTakenIdx = 1;
Jakub Staszakabb236f2011-07-15 20:51:06 +0000327 bool isProb = CI->getPredicate() == ICmpInst::ICMP_NE;
Andrew Trick49371f32011-06-04 01:16:30 +0000328 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000329 std::swap(TakenIdx, NonTakenIdx);
Andrew Trick49371f32011-06-04 01:16:30 +0000330
Cong Houe93b8e12015-12-22 18:56:14 +0000331 BranchProbability TakenProb(PH_TAKEN_WEIGHT,
332 PH_TAKEN_WEIGHT + PH_NONTAKEN_WEIGHT);
333 setEdgeProbability(BB, TakenIdx, TakenProb);
334 setEdgeProbability(BB, NonTakenIdx, TakenProb.getCompl());
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000335 return true;
Andrew Trick49371f32011-06-04 01:16:30 +0000336}
337
338// Calculate Edge Weights using "Loop Branch Heuristics". Predict backedges
339// as taken, exiting edges as not-taken.
Mehdi Aminia7978772016-04-07 21:59:28 +0000340bool BranchProbabilityInfo::calcLoopBranchHeuristics(const BasicBlock *BB,
Cong Houab23bfb2015-07-15 22:48:29 +0000341 const LoopInfo &LI) {
342 Loop *L = LI.getLoopFor(BB);
Andrew Trick49371f32011-06-04 01:16:30 +0000343 if (!L)
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000344 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000345
Manman Rencf104462012-08-24 18:14:27 +0000346 SmallVector<unsigned, 8> BackEdges;
347 SmallVector<unsigned, 8> ExitingEdges;
348 SmallVector<unsigned, 8> InEdges; // Edges from header to the loop.
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000349
Mehdi Aminia7978772016-04-07 21:59:28 +0000350 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
Chandler Carruth32f46e72011-10-25 09:47:41 +0000351 if (!L->contains(*I))
Manman Rencf104462012-08-24 18:14:27 +0000352 ExitingEdges.push_back(I.getSuccessorIndex());
Chandler Carruth32f46e72011-10-25 09:47:41 +0000353 else if (L->getHeader() == *I)
Manman Rencf104462012-08-24 18:14:27 +0000354 BackEdges.push_back(I.getSuccessorIndex());
Chandler Carruth32f46e72011-10-25 09:47:41 +0000355 else
Manman Rencf104462012-08-24 18:14:27 +0000356 InEdges.push_back(I.getSuccessorIndex());
Andrew Trick49371f32011-06-04 01:16:30 +0000357 }
358
Akira Hatanaka5638b892014-04-14 16:56:19 +0000359 if (BackEdges.empty() && ExitingEdges.empty())
360 return false;
361
Cong Houe93b8e12015-12-22 18:56:14 +0000362 // Collect the sum of probabilities of back-edges/in-edges/exiting-edges, and
363 // normalize them so that they sum up to one.
364 SmallVector<BranchProbability, 4> Probs(3, BranchProbability::getZero());
365 unsigned Denom = (BackEdges.empty() ? 0 : LBH_TAKEN_WEIGHT) +
366 (InEdges.empty() ? 0 : LBH_TAKEN_WEIGHT) +
367 (ExitingEdges.empty() ? 0 : LBH_NONTAKEN_WEIGHT);
368 if (!BackEdges.empty())
369 Probs[0] = BranchProbability(LBH_TAKEN_WEIGHT, Denom);
370 if (!InEdges.empty())
371 Probs[1] = BranchProbability(LBH_TAKEN_WEIGHT, Denom);
372 if (!ExitingEdges.empty())
373 Probs[2] = BranchProbability(LBH_NONTAKEN_WEIGHT, Denom);
Andrew Trick49371f32011-06-04 01:16:30 +0000374
Cong Houe93b8e12015-12-22 18:56:14 +0000375 if (uint32_t numBackEdges = BackEdges.size()) {
376 auto Prob = Probs[0] / numBackEdges;
377 for (unsigned SuccIdx : BackEdges)
378 setEdgeProbability(BB, SuccIdx, Prob);
Andrew Trick49371f32011-06-04 01:16:30 +0000379 }
380
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000381 if (uint32_t numInEdges = InEdges.size()) {
Cong Houe93b8e12015-12-22 18:56:14 +0000382 auto Prob = Probs[1] / numInEdges;
383 for (unsigned SuccIdx : InEdges)
384 setEdgeProbability(BB, SuccIdx, Prob);
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000385 }
386
Chandler Carruth32f46e72011-10-25 09:47:41 +0000387 if (uint32_t numExitingEdges = ExitingEdges.size()) {
Cong Houe93b8e12015-12-22 18:56:14 +0000388 auto Prob = Probs[2] / numExitingEdges;
389 for (unsigned SuccIdx : ExitingEdges)
390 setEdgeProbability(BB, SuccIdx, Prob);
Andrew Trick49371f32011-06-04 01:16:30 +0000391 }
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000392
393 return true;
Andrew Trick49371f32011-06-04 01:16:30 +0000394}
395
Mehdi Aminia7978772016-04-07 21:59:28 +0000396bool BranchProbabilityInfo::calcZeroHeuristics(const BasicBlock *BB) {
397 const BranchInst *BI = dyn_cast<BranchInst>(BB->getTerminator());
Jakub Staszak17af66a2011-07-31 03:27:24 +0000398 if (!BI || !BI->isConditional())
399 return false;
400
401 Value *Cond = BI->getCondition();
402 ICmpInst *CI = dyn_cast<ICmpInst>(Cond);
403 if (!CI)
404 return false;
405
Jakub Staszak17af66a2011-07-31 03:27:24 +0000406 Value *RHS = CI->getOperand(1);
Jakub Staszakbfb1ae22011-07-31 04:47:20 +0000407 ConstantInt *CV = dyn_cast<ConstantInt>(RHS);
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000408 if (!CV)
Jakub Staszak17af66a2011-07-31 03:27:24 +0000409 return false;
410
Daniel Jaspera73f3d52015-04-15 06:24:07 +0000411 // If the LHS is the result of AND'ing a value with a single bit bitmask,
412 // we don't have information about probabilities.
413 if (Instruction *LHS = dyn_cast<Instruction>(CI->getOperand(0)))
414 if (LHS->getOpcode() == Instruction::And)
415 if (ConstantInt *AndRHS = dyn_cast<ConstantInt>(LHS->getOperand(1)))
416 if (AndRHS->getUniqueInteger().isPowerOf2())
417 return false;
418
Jakub Staszak17af66a2011-07-31 03:27:24 +0000419 bool isProb;
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000420 if (CV->isZero()) {
421 switch (CI->getPredicate()) {
422 case CmpInst::ICMP_EQ:
423 // X == 0 -> Unlikely
424 isProb = false;
425 break;
426 case CmpInst::ICMP_NE:
427 // X != 0 -> Likely
428 isProb = true;
429 break;
430 case CmpInst::ICMP_SLT:
431 // X < 0 -> Unlikely
432 isProb = false;
433 break;
434 case CmpInst::ICMP_SGT:
435 // X > 0 -> Likely
436 isProb = true;
437 break;
438 default:
439 return false;
440 }
441 } else if (CV->isOne() && CI->getPredicate() == CmpInst::ICMP_SLT) {
442 // InstCombine canonicalizes X <= 0 into X < 1.
443 // X <= 0 -> Unlikely
Jakub Staszak17af66a2011-07-31 03:27:24 +0000444 isProb = false;
Hal Finkel4d949302013-11-01 10:58:22 +0000445 } else if (CV->isAllOnesValue()) {
446 switch (CI->getPredicate()) {
447 case CmpInst::ICMP_EQ:
448 // X == -1 -> Unlikely
449 isProb = false;
450 break;
451 case CmpInst::ICMP_NE:
452 // X != -1 -> Likely
453 isProb = true;
454 break;
455 case CmpInst::ICMP_SGT:
456 // InstCombine canonicalizes X >= 0 into X > -1.
457 // X >= 0 -> Likely
458 isProb = true;
459 break;
460 default:
461 return false;
462 }
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000463 } else {
Jakub Staszak17af66a2011-07-31 03:27:24 +0000464 return false;
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000465 }
Jakub Staszak17af66a2011-07-31 03:27:24 +0000466
Manman Rencf104462012-08-24 18:14:27 +0000467 unsigned TakenIdx = 0, NonTakenIdx = 1;
Jakub Staszak17af66a2011-07-31 03:27:24 +0000468
469 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000470 std::swap(TakenIdx, NonTakenIdx);
Jakub Staszak17af66a2011-07-31 03:27:24 +0000471
Cong Houe93b8e12015-12-22 18:56:14 +0000472 BranchProbability TakenProb(ZH_TAKEN_WEIGHT,
473 ZH_TAKEN_WEIGHT + ZH_NONTAKEN_WEIGHT);
474 setEdgeProbability(BB, TakenIdx, TakenProb);
475 setEdgeProbability(BB, NonTakenIdx, TakenProb.getCompl());
Jakub Staszak17af66a2011-07-31 03:27:24 +0000476 return true;
477}
478
Mehdi Aminia7978772016-04-07 21:59:28 +0000479bool BranchProbabilityInfo::calcFloatingPointHeuristics(const BasicBlock *BB) {
480 const BranchInst *BI = dyn_cast<BranchInst>(BB->getTerminator());
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000481 if (!BI || !BI->isConditional())
482 return false;
483
484 Value *Cond = BI->getCondition();
485 FCmpInst *FCmp = dyn_cast<FCmpInst>(Cond);
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000486 if (!FCmp)
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000487 return false;
488
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000489 bool isProb;
490 if (FCmp->isEquality()) {
491 // f1 == f2 -> Unlikely
492 // f1 != f2 -> Likely
493 isProb = !FCmp->isTrueWhenEqual();
494 } else if (FCmp->getPredicate() == FCmpInst::FCMP_ORD) {
495 // !isnan -> Likely
496 isProb = true;
497 } else if (FCmp->getPredicate() == FCmpInst::FCMP_UNO) {
498 // isnan -> Unlikely
499 isProb = false;
500 } else {
501 return false;
502 }
503
Manman Rencf104462012-08-24 18:14:27 +0000504 unsigned TakenIdx = 0, NonTakenIdx = 1;
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000505
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000506 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000507 std::swap(TakenIdx, NonTakenIdx);
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000508
Cong Houe93b8e12015-12-22 18:56:14 +0000509 BranchProbability TakenProb(FPH_TAKEN_WEIGHT,
510 FPH_TAKEN_WEIGHT + FPH_NONTAKEN_WEIGHT);
511 setEdgeProbability(BB, TakenIdx, TakenProb);
512 setEdgeProbability(BB, NonTakenIdx, TakenProb.getCompl());
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000513 return true;
514}
Jakub Staszak17af66a2011-07-31 03:27:24 +0000515
Mehdi Aminia7978772016-04-07 21:59:28 +0000516bool BranchProbabilityInfo::calcInvokeHeuristics(const BasicBlock *BB) {
517 const InvokeInst *II = dyn_cast<InvokeInst>(BB->getTerminator());
Bill Wendlinge1c54262012-08-15 12:22:35 +0000518 if (!II)
519 return false;
520
Cong Houe93b8e12015-12-22 18:56:14 +0000521 BranchProbability TakenProb(IH_TAKEN_WEIGHT,
522 IH_TAKEN_WEIGHT + IH_NONTAKEN_WEIGHT);
523 setEdgeProbability(BB, 0 /*Index for Normal*/, TakenProb);
524 setEdgeProbability(BB, 1 /*Index for Unwind*/, TakenProb.getCompl());
Bill Wendlinge1c54262012-08-15 12:22:35 +0000525 return true;
526}
527
Pete Cooperb9d2e342015-05-28 19:43:06 +0000528void BranchProbabilityInfo::releaseMemory() {
Cong Houe93b8e12015-12-22 18:56:14 +0000529 Probs.clear();
Pete Cooperb9d2e342015-05-28 19:43:06 +0000530}
531
Cong Houab23bfb2015-07-15 22:48:29 +0000532void BranchProbabilityInfo::print(raw_ostream &OS) const {
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000533 OS << "---- Branch Probabilities ----\n";
534 // We print the probabilities from the last function the analysis ran over,
535 // or the function it is currently running over.
536 assert(LastF && "Cannot print prior to running over a function");
Duncan P. N. Exon Smith5a82c912015-10-10 00:53:03 +0000537 for (const auto &BI : *LastF) {
538 for (succ_const_iterator SI = succ_begin(&BI), SE = succ_end(&BI); SI != SE;
539 ++SI) {
540 printEdgeProbability(OS << " ", &BI, *SI);
Duncan P. N. Exon Smith6c990152014-07-21 17:06:51 +0000541 }
542 }
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000543}
544
Jakub Staszakefd94c82011-07-29 19:30:00 +0000545bool BranchProbabilityInfo::
546isEdgeHot(const BasicBlock *Src, const BasicBlock *Dst) const {
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000547 // Hot probability is at least 4/5 = 80%
Benjamin Kramer929f53f2011-10-23 11:19:14 +0000548 // FIXME: Compare against a static "hot" BranchProbability.
549 return getEdgeProbability(Src, Dst) > BranchProbability(4, 5);
Andrew Trick49371f32011-06-04 01:16:30 +0000550}
551
Mehdi Aminia7978772016-04-07 21:59:28 +0000552const BasicBlock *
553BranchProbabilityInfo::getHotSucc(const BasicBlock *BB) const {
Cong Houe93b8e12015-12-22 18:56:14 +0000554 auto MaxProb = BranchProbability::getZero();
Mehdi Aminia7978772016-04-07 21:59:28 +0000555 const BasicBlock *MaxSucc = nullptr;
Andrew Trick49371f32011-06-04 01:16:30 +0000556
Mehdi Aminia7978772016-04-07 21:59:28 +0000557 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
558 const BasicBlock *Succ = *I;
Cong Houe93b8e12015-12-22 18:56:14 +0000559 auto Prob = getEdgeProbability(BB, Succ);
560 if (Prob > MaxProb) {
561 MaxProb = Prob;
Andrew Trick49371f32011-06-04 01:16:30 +0000562 MaxSucc = Succ;
563 }
564 }
565
Benjamin Kramer929f53f2011-10-23 11:19:14 +0000566 // Hot probability is at least 4/5 = 80%
Cong Houe93b8e12015-12-22 18:56:14 +0000567 if (MaxProb > BranchProbability(4, 5))
Andrew Trick49371f32011-06-04 01:16:30 +0000568 return MaxSucc;
569
Craig Topper9f008862014-04-15 04:59:12 +0000570 return nullptr;
Andrew Trick49371f32011-06-04 01:16:30 +0000571}
572
Cong Houe93b8e12015-12-22 18:56:14 +0000573/// Get the raw edge probability for the edge. If can't find it, return a
574/// default probability 1/N where N is the number of successors. Here an edge is
575/// specified using PredBlock and an
576/// index to the successors.
577BranchProbability
578BranchProbabilityInfo::getEdgeProbability(const BasicBlock *Src,
579 unsigned IndexInSuccessors) const {
580 auto I = Probs.find(std::make_pair(Src, IndexInSuccessors));
Andrew Trick49371f32011-06-04 01:16:30 +0000581
Cong Houe93b8e12015-12-22 18:56:14 +0000582 if (I != Probs.end())
Andrew Trick49371f32011-06-04 01:16:30 +0000583 return I->second;
584
Cong Houe93b8e12015-12-22 18:56:14 +0000585 return {1,
586 static_cast<uint32_t>(std::distance(succ_begin(Src), succ_end(Src)))};
Andrew Trick49371f32011-06-04 01:16:30 +0000587}
588
Cong Houd97c1002015-12-01 05:29:22 +0000589BranchProbability
590BranchProbabilityInfo::getEdgeProbability(const BasicBlock *Src,
591 succ_const_iterator Dst) const {
592 return getEdgeProbability(Src, Dst.getSuccessorIndex());
593}
594
Cong Houe93b8e12015-12-22 18:56:14 +0000595/// Get the raw edge probability calculated for the block pair. This returns the
596/// sum of all raw edge probabilities from Src to Dst.
597BranchProbability
598BranchProbabilityInfo::getEdgeProbability(const BasicBlock *Src,
599 const BasicBlock *Dst) const {
600 auto Prob = BranchProbability::getZero();
601 bool FoundProb = false;
602 for (succ_const_iterator I = succ_begin(Src), E = succ_end(Src); I != E; ++I)
603 if (*I == Dst) {
604 auto MapI = Probs.find(std::make_pair(Src, I.getSuccessorIndex()));
605 if (MapI != Probs.end()) {
606 FoundProb = true;
607 Prob += MapI->second;
608 }
609 }
610 uint32_t succ_num = std::distance(succ_begin(Src), succ_end(Src));
611 return FoundProb ? Prob : BranchProbability(1, succ_num);
612}
613
614/// Set the edge probability for a given edge specified by PredBlock and an
615/// index to the successors.
616void BranchProbabilityInfo::setEdgeProbability(const BasicBlock *Src,
617 unsigned IndexInSuccessors,
618 BranchProbability Prob) {
619 Probs[std::make_pair(Src, IndexInSuccessors)] = Prob;
620 DEBUG(dbgs() << "set edge " << Src->getName() << " -> " << IndexInSuccessors
621 << " successor probability to " << Prob << "\n");
622}
623
Andrew Trick49371f32011-06-04 01:16:30 +0000624raw_ostream &
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000625BranchProbabilityInfo::printEdgeProbability(raw_ostream &OS,
626 const BasicBlock *Src,
627 const BasicBlock *Dst) const {
Andrew Trick49371f32011-06-04 01:16:30 +0000628
Jakub Staszak12a43bd2011-06-16 20:22:37 +0000629 const BranchProbability Prob = getEdgeProbability(Src, Dst);
Benjamin Kramer1f97a5a2011-11-15 16:27:03 +0000630 OS << "edge " << Src->getName() << " -> " << Dst->getName()
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000631 << " probability is " << Prob
632 << (isEdgeHot(Src, Dst) ? " [HOT edge]\n" : "\n");
Andrew Trick49371f32011-06-04 01:16:30 +0000633
634 return OS;
635}
Cong Houab23bfb2015-07-15 22:48:29 +0000636
Mehdi Aminia7978772016-04-07 21:59:28 +0000637void BranchProbabilityInfo::calculate(const Function &F, const LoopInfo &LI) {
Cong Houab23bfb2015-07-15 22:48:29 +0000638 DEBUG(dbgs() << "---- Branch Probability Info : " << F.getName()
639 << " ----\n\n");
640 LastF = &F; // Store the last function we ran on for printing.
641 assert(PostDominatedByUnreachable.empty());
642 assert(PostDominatedByColdCall.empty());
643
644 // Walk the basic blocks in post-order so that we can build up state about
645 // the successors of a block iteratively.
646 for (auto BB : post_order(&F.getEntryBlock())) {
647 DEBUG(dbgs() << "Computing probabilities for " << BB->getName() << "\n");
648 if (calcUnreachableHeuristics(BB))
649 continue;
650 if (calcMetadataWeights(BB))
651 continue;
652 if (calcColdCallHeuristics(BB))
653 continue;
654 if (calcLoopBranchHeuristics(BB, LI))
655 continue;
656 if (calcPointerHeuristics(BB))
657 continue;
658 if (calcZeroHeuristics(BB))
659 continue;
660 if (calcFloatingPointHeuristics(BB))
661 continue;
662 calcInvokeHeuristics(BB);
663 }
664
665 PostDominatedByUnreachable.clear();
666 PostDominatedByColdCall.clear();
667}
668
669void BranchProbabilityInfoWrapperPass::getAnalysisUsage(
670 AnalysisUsage &AU) const {
671 AU.addRequired<LoopInfoWrapperPass>();
672 AU.setPreservesAll();
673}
674
675bool BranchProbabilityInfoWrapperPass::runOnFunction(Function &F) {
676 const LoopInfo &LI = getAnalysis<LoopInfoWrapperPass>().getLoopInfo();
677 BPI.calculate(F, LI);
678 return false;
679}
680
681void BranchProbabilityInfoWrapperPass::releaseMemory() { BPI.releaseMemory(); }
682
683void BranchProbabilityInfoWrapperPass::print(raw_ostream &OS,
684 const Module *) const {
685 BPI.print(OS);
686}