blob: a0d6123b5835fad20a3d1e210f203b5e3d951981 [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 Carruth7a0094a2011-10-24 01:40:45 +0000111// Standard weight value. Used when none of the heuristics set weight for
112// the edge.
113static const uint32_t NORMAL_WEIGHT = 16;
Andrew Trick49371f32011-06-04 01:16:30 +0000114
Chandler Carruth7a0094a2011-10-24 01:40:45 +0000115// Minimum weight of an edge. Please note, that weight is NEVER 0.
116static const uint32_t MIN_WEIGHT = 1;
Andrew Trick49371f32011-06-04 01:16:30 +0000117
Chandler Carruth7111f452011-10-24 12:01:08 +0000118/// \brief Calculate edge weights for successors lead to unreachable.
119///
120/// Predict that a successor which leads necessarily to an
121/// unreachable-terminated block as extremely unlikely.
122bool BranchProbabilityInfo::calcUnreachableHeuristics(BasicBlock *BB) {
123 TerminatorInst *TI = BB->getTerminator();
124 if (TI->getNumSuccessors() == 0) {
125 if (isa<UnreachableInst>(TI))
126 PostDominatedByUnreachable.insert(BB);
127 return false;
128 }
129
Manman Rencf104462012-08-24 18:14:27 +0000130 SmallVector<unsigned, 4> UnreachableEdges;
131 SmallVector<unsigned, 4> ReachableEdges;
Chandler Carruth7111f452011-10-24 12:01:08 +0000132
133 for (succ_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
134 if (PostDominatedByUnreachable.count(*I))
Manman Rencf104462012-08-24 18:14:27 +0000135 UnreachableEdges.push_back(I.getSuccessorIndex());
Chandler Carruth7111f452011-10-24 12:01:08 +0000136 else
Manman Rencf104462012-08-24 18:14:27 +0000137 ReachableEdges.push_back(I.getSuccessorIndex());
Chandler Carruth7111f452011-10-24 12:01:08 +0000138 }
139
140 // If all successors are in the set of blocks post-dominated by unreachable,
141 // this block is too.
142 if (UnreachableEdges.size() == TI->getNumSuccessors())
143 PostDominatedByUnreachable.insert(BB);
144
145 // Skip probabilities if this block has a single successor or if all were
146 // reachable.
147 if (TI->getNumSuccessors() == 1 || UnreachableEdges.empty())
148 return false;
149
Jun Bum Lima23e5f72015-12-21 22:00:51 +0000150 // If the terminator is an InvokeInst, check only the normal destination block
151 // as the unwind edge of InvokeInst is also very unlikely taken.
152 if (auto *II = dyn_cast<InvokeInst>(TI))
153 if (PostDominatedByUnreachable.count(II->getNormalDest())) {
154 PostDominatedByUnreachable.insert(BB);
155 // Return false here so that edge weights for InvokeInst could be decided
156 // in calcInvokeHeuristics().
157 return false;
158 }
159
Chandler Carruth7111f452011-10-24 12:01:08 +0000160 uint32_t UnreachableWeight =
Manman Rencf104462012-08-24 18:14:27 +0000161 std::max(UR_TAKEN_WEIGHT / (unsigned)UnreachableEdges.size(), MIN_WEIGHT);
Craig Topperaf0dea12013-07-04 01:31:24 +0000162 for (SmallVectorImpl<unsigned>::iterator I = UnreachableEdges.begin(),
163 E = UnreachableEdges.end();
Chandler Carruth7111f452011-10-24 12:01:08 +0000164 I != E; ++I)
165 setEdgeWeight(BB, *I, UnreachableWeight);
166
167 if (ReachableEdges.empty())
168 return true;
169 uint32_t ReachableWeight =
Manman Rencf104462012-08-24 18:14:27 +0000170 std::max(UR_NONTAKEN_WEIGHT / (unsigned)ReachableEdges.size(),
171 NORMAL_WEIGHT);
Craig Topperaf0dea12013-07-04 01:31:24 +0000172 for (SmallVectorImpl<unsigned>::iterator I = ReachableEdges.begin(),
173 E = ReachableEdges.end();
Chandler Carruth7111f452011-10-24 12:01:08 +0000174 I != E; ++I)
175 setEdgeWeight(BB, *I, ReachableWeight);
176
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.
Chandler Carruth7a0094a2011-10-24 01:40:45 +0000182bool BranchProbabilityInfo::calcMetadataWeights(BasicBlock *BB) {
Chandler Carruthdeac50c2011-10-19 10:32:19 +0000183 TerminatorInst *TI = BB->getTerminator();
184 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) {
226 uint32_t W = Weights[i] / ScalingFactor;
227 WeightSum += W;
228 setEdgeWeight(BB, i, W);
229 }
230 assert(WeightSum <= UINT32_MAX &&
231 "Expected weights to scale down to 32 bits");
Chandler Carruthd27a7a92011-10-19 10:30:30 +0000232
233 return true;
234}
235
Diego Novilloc6399532013-05-24 12:26:52 +0000236/// \brief Calculate edge weights for edges leading to cold blocks.
237///
238/// A cold block is one post-dominated by a block with a call to a
239/// cold function. Those edges are unlikely to be taken, so we give
240/// them relatively low weight.
241///
242/// Return true if we could compute the weights for cold edges.
243/// Return false, otherwise.
244bool BranchProbabilityInfo::calcColdCallHeuristics(BasicBlock *BB) {
245 TerminatorInst *TI = BB->getTerminator();
246 if (TI->getNumSuccessors() == 0)
247 return false;
248
249 // Determine which successors are post-dominated by a cold block.
250 SmallVector<unsigned, 4> ColdEdges;
Diego Novilloc6399532013-05-24 12:26:52 +0000251 SmallVector<unsigned, 4> NormalEdges;
Diego Novilloc6399532013-05-24 12:26:52 +0000252 for (succ_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I)
253 if (PostDominatedByColdCall.count(*I))
254 ColdEdges.push_back(I.getSuccessorIndex());
255 else
256 NormalEdges.push_back(I.getSuccessorIndex());
257
258 // If all successors are in the set of blocks post-dominated by cold calls,
259 // this block is in the set post-dominated by cold calls.
260 if (ColdEdges.size() == TI->getNumSuccessors())
261 PostDominatedByColdCall.insert(BB);
262 else {
263 // Otherwise, if the block itself contains a cold function, add it to the
264 // set of blocks postdominated by a cold call.
265 assert(!PostDominatedByColdCall.count(BB));
266 for (BasicBlock::iterator I = BB->begin(), E = BB->end(); I != E; ++I)
267 if (CallInst *CI = dyn_cast<CallInst>(I))
268 if (CI->hasFnAttr(Attribute::Cold)) {
269 PostDominatedByColdCall.insert(BB);
270 break;
271 }
272 }
273
274 // Skip probabilities if this block has a single successor.
275 if (TI->getNumSuccessors() == 1 || ColdEdges.empty())
276 return false;
277
278 uint32_t ColdWeight =
279 std::max(CC_TAKEN_WEIGHT / (unsigned) ColdEdges.size(), MIN_WEIGHT);
Craig Topperaf0dea12013-07-04 01:31:24 +0000280 for (SmallVectorImpl<unsigned>::iterator I = ColdEdges.begin(),
281 E = ColdEdges.end();
Diego Novilloc6399532013-05-24 12:26:52 +0000282 I != E; ++I)
283 setEdgeWeight(BB, *I, ColdWeight);
284
285 if (NormalEdges.empty())
286 return true;
287 uint32_t NormalWeight = std::max(
288 CC_NONTAKEN_WEIGHT / (unsigned) NormalEdges.size(), NORMAL_WEIGHT);
Craig Topperaf0dea12013-07-04 01:31:24 +0000289 for (SmallVectorImpl<unsigned>::iterator I = NormalEdges.begin(),
290 E = NormalEdges.end();
Diego Novilloc6399532013-05-24 12:26:52 +0000291 I != E; ++I)
292 setEdgeWeight(BB, *I, NormalWeight);
293
294 return true;
295}
296
Andrew Trick49371f32011-06-04 01:16:30 +0000297// Calculate Edge Weights using "Pointer Heuristics". Predict a comparsion
298// between two pointer or pointer and NULL will fail.
Chandler Carruth7a0094a2011-10-24 01:40:45 +0000299bool BranchProbabilityInfo::calcPointerHeuristics(BasicBlock *BB) {
Andrew Trick49371f32011-06-04 01:16:30 +0000300 BranchInst * BI = dyn_cast<BranchInst>(BB->getTerminator());
301 if (!BI || !BI->isConditional())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000302 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000303
304 Value *Cond = BI->getCondition();
305 ICmpInst *CI = dyn_cast<ICmpInst>(Cond);
Jakub Staszakabb236f2011-07-15 20:51:06 +0000306 if (!CI || !CI->isEquality())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000307 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000308
309 Value *LHS = CI->getOperand(0);
Andrew Trick49371f32011-06-04 01:16:30 +0000310
311 if (!LHS->getType()->isPointerTy())
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000312 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000313
Nick Lewycky75b20532011-06-04 02:07:10 +0000314 assert(CI->getOperand(1)->getType()->isPointerTy());
Andrew Trick49371f32011-06-04 01:16:30 +0000315
Andrew Trick49371f32011-06-04 01:16:30 +0000316 // p != 0 -> isProb = true
317 // p == 0 -> isProb = false
318 // p != q -> isProb = true
319 // p == q -> isProb = false;
Manman Rencf104462012-08-24 18:14:27 +0000320 unsigned TakenIdx = 0, NonTakenIdx = 1;
Jakub Staszakabb236f2011-07-15 20:51:06 +0000321 bool isProb = CI->getPredicate() == ICmpInst::ICMP_NE;
Andrew Trick49371f32011-06-04 01:16:30 +0000322 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000323 std::swap(TakenIdx, NonTakenIdx);
Andrew Trick49371f32011-06-04 01:16:30 +0000324
Manman Rencf104462012-08-24 18:14:27 +0000325 setEdgeWeight(BB, TakenIdx, PH_TAKEN_WEIGHT);
326 setEdgeWeight(BB, NonTakenIdx, PH_NONTAKEN_WEIGHT);
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000327 return true;
Andrew Trick49371f32011-06-04 01:16:30 +0000328}
329
330// Calculate Edge Weights using "Loop Branch Heuristics". Predict backedges
331// as taken, exiting edges as not-taken.
Cong Houab23bfb2015-07-15 22:48:29 +0000332bool BranchProbabilityInfo::calcLoopBranchHeuristics(BasicBlock *BB,
333 const LoopInfo &LI) {
334 Loop *L = LI.getLoopFor(BB);
Andrew Trick49371f32011-06-04 01:16:30 +0000335 if (!L)
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000336 return false;
Andrew Trick49371f32011-06-04 01:16:30 +0000337
Manman Rencf104462012-08-24 18:14:27 +0000338 SmallVector<unsigned, 8> BackEdges;
339 SmallVector<unsigned, 8> ExitingEdges;
340 SmallVector<unsigned, 8> InEdges; // Edges from header to the loop.
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000341
Andrew Trick49371f32011-06-04 01:16:30 +0000342 for (succ_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
Chandler Carruth32f46e72011-10-25 09:47:41 +0000343 if (!L->contains(*I))
Manman Rencf104462012-08-24 18:14:27 +0000344 ExitingEdges.push_back(I.getSuccessorIndex());
Chandler Carruth32f46e72011-10-25 09:47:41 +0000345 else if (L->getHeader() == *I)
Manman Rencf104462012-08-24 18:14:27 +0000346 BackEdges.push_back(I.getSuccessorIndex());
Chandler Carruth32f46e72011-10-25 09:47:41 +0000347 else
Manman Rencf104462012-08-24 18:14:27 +0000348 InEdges.push_back(I.getSuccessorIndex());
Andrew Trick49371f32011-06-04 01:16:30 +0000349 }
350
Akira Hatanaka5638b892014-04-14 16:56:19 +0000351 if (BackEdges.empty() && ExitingEdges.empty())
352 return false;
353
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000354 if (uint32_t numBackEdges = BackEdges.size()) {
355 uint32_t backWeight = LBH_TAKEN_WEIGHT / numBackEdges;
Andrew Trick49371f32011-06-04 01:16:30 +0000356 if (backWeight < NORMAL_WEIGHT)
357 backWeight = NORMAL_WEIGHT;
358
Craig Topperaf0dea12013-07-04 01:31:24 +0000359 for (SmallVectorImpl<unsigned>::iterator EI = BackEdges.begin(),
Andrew Trick49371f32011-06-04 01:16:30 +0000360 EE = BackEdges.end(); EI != EE; ++EI) {
Manman Rencf104462012-08-24 18:14:27 +0000361 setEdgeWeight(BB, *EI, backWeight);
Andrew Trick49371f32011-06-04 01:16:30 +0000362 }
363 }
364
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000365 if (uint32_t numInEdges = InEdges.size()) {
366 uint32_t inWeight = LBH_TAKEN_WEIGHT / numInEdges;
367 if (inWeight < NORMAL_WEIGHT)
368 inWeight = NORMAL_WEIGHT;
369
Craig Topperaf0dea12013-07-04 01:31:24 +0000370 for (SmallVectorImpl<unsigned>::iterator EI = InEdges.begin(),
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000371 EE = InEdges.end(); EI != EE; ++EI) {
Manman Rencf104462012-08-24 18:14:27 +0000372 setEdgeWeight(BB, *EI, inWeight);
Jakub Staszakbcb3c652011-07-28 21:33:46 +0000373 }
374 }
375
Chandler Carruth32f46e72011-10-25 09:47:41 +0000376 if (uint32_t numExitingEdges = ExitingEdges.size()) {
377 uint32_t exitWeight = LBH_NONTAKEN_WEIGHT / numExitingEdges;
Andrew Trick49371f32011-06-04 01:16:30 +0000378 if (exitWeight < MIN_WEIGHT)
379 exitWeight = MIN_WEIGHT;
380
Craig Topperaf0dea12013-07-04 01:31:24 +0000381 for (SmallVectorImpl<unsigned>::iterator EI = ExitingEdges.begin(),
Andrew Trick49371f32011-06-04 01:16:30 +0000382 EE = ExitingEdges.end(); EI != EE; ++EI) {
Manman Rencf104462012-08-24 18:14:27 +0000383 setEdgeWeight(BB, *EI, exitWeight);
Andrew Trick49371f32011-06-04 01:16:30 +0000384 }
385 }
Jakub Staszakd07b2e12011-07-28 21:45:07 +0000386
387 return true;
Andrew Trick49371f32011-06-04 01:16:30 +0000388}
389
Chandler Carruth7a0094a2011-10-24 01:40:45 +0000390bool BranchProbabilityInfo::calcZeroHeuristics(BasicBlock *BB) {
Jakub Staszak17af66a2011-07-31 03:27:24 +0000391 BranchInst * BI = dyn_cast<BranchInst>(BB->getTerminator());
392 if (!BI || !BI->isConditional())
393 return false;
394
395 Value *Cond = BI->getCondition();
396 ICmpInst *CI = dyn_cast<ICmpInst>(Cond);
397 if (!CI)
398 return false;
399
Jakub Staszak17af66a2011-07-31 03:27:24 +0000400 Value *RHS = CI->getOperand(1);
Jakub Staszakbfb1ae22011-07-31 04:47:20 +0000401 ConstantInt *CV = dyn_cast<ConstantInt>(RHS);
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000402 if (!CV)
Jakub Staszak17af66a2011-07-31 03:27:24 +0000403 return false;
404
Daniel Jaspera73f3d52015-04-15 06:24:07 +0000405 // If the LHS is the result of AND'ing a value with a single bit bitmask,
406 // we don't have information about probabilities.
407 if (Instruction *LHS = dyn_cast<Instruction>(CI->getOperand(0)))
408 if (LHS->getOpcode() == Instruction::And)
409 if (ConstantInt *AndRHS = dyn_cast<ConstantInt>(LHS->getOperand(1)))
410 if (AndRHS->getUniqueInteger().isPowerOf2())
411 return false;
412
Jakub Staszak17af66a2011-07-31 03:27:24 +0000413 bool isProb;
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000414 if (CV->isZero()) {
415 switch (CI->getPredicate()) {
416 case CmpInst::ICMP_EQ:
417 // X == 0 -> Unlikely
418 isProb = false;
419 break;
420 case CmpInst::ICMP_NE:
421 // X != 0 -> Likely
422 isProb = true;
423 break;
424 case CmpInst::ICMP_SLT:
425 // X < 0 -> Unlikely
426 isProb = false;
427 break;
428 case CmpInst::ICMP_SGT:
429 // X > 0 -> Likely
430 isProb = true;
431 break;
432 default:
433 return false;
434 }
435 } else if (CV->isOne() && CI->getPredicate() == CmpInst::ICMP_SLT) {
436 // InstCombine canonicalizes X <= 0 into X < 1.
437 // X <= 0 -> Unlikely
Jakub Staszak17af66a2011-07-31 03:27:24 +0000438 isProb = false;
Hal Finkel4d949302013-11-01 10:58:22 +0000439 } else if (CV->isAllOnesValue()) {
440 switch (CI->getPredicate()) {
441 case CmpInst::ICMP_EQ:
442 // X == -1 -> Unlikely
443 isProb = false;
444 break;
445 case CmpInst::ICMP_NE:
446 // X != -1 -> Likely
447 isProb = true;
448 break;
449 case CmpInst::ICMP_SGT:
450 // InstCombine canonicalizes X >= 0 into X > -1.
451 // X >= 0 -> Likely
452 isProb = true;
453 break;
454 default:
455 return false;
456 }
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000457 } else {
Jakub Staszak17af66a2011-07-31 03:27:24 +0000458 return false;
Benjamin Kramer0ca1ad02011-09-04 23:53:04 +0000459 }
Jakub Staszak17af66a2011-07-31 03:27:24 +0000460
Manman Rencf104462012-08-24 18:14:27 +0000461 unsigned TakenIdx = 0, NonTakenIdx = 1;
Jakub Staszak17af66a2011-07-31 03:27:24 +0000462
463 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000464 std::swap(TakenIdx, NonTakenIdx);
Jakub Staszak17af66a2011-07-31 03:27:24 +0000465
Manman Rencf104462012-08-24 18:14:27 +0000466 setEdgeWeight(BB, TakenIdx, ZH_TAKEN_WEIGHT);
467 setEdgeWeight(BB, NonTakenIdx, ZH_NONTAKEN_WEIGHT);
Jakub Staszak17af66a2011-07-31 03:27:24 +0000468
469 return true;
470}
471
Chandler Carruth7a0094a2011-10-24 01:40:45 +0000472bool BranchProbabilityInfo::calcFloatingPointHeuristics(BasicBlock *BB) {
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000473 BranchInst *BI = dyn_cast<BranchInst>(BB->getTerminator());
474 if (!BI || !BI->isConditional())
475 return false;
476
477 Value *Cond = BI->getCondition();
478 FCmpInst *FCmp = dyn_cast<FCmpInst>(Cond);
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000479 if (!FCmp)
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000480 return false;
481
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000482 bool isProb;
483 if (FCmp->isEquality()) {
484 // f1 == f2 -> Unlikely
485 // f1 != f2 -> Likely
486 isProb = !FCmp->isTrueWhenEqual();
487 } else if (FCmp->getPredicate() == FCmpInst::FCMP_ORD) {
488 // !isnan -> Likely
489 isProb = true;
490 } else if (FCmp->getPredicate() == FCmpInst::FCMP_UNO) {
491 // isnan -> Unlikely
492 isProb = false;
493 } else {
494 return false;
495 }
496
Manman Rencf104462012-08-24 18:14:27 +0000497 unsigned TakenIdx = 0, NonTakenIdx = 1;
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000498
Benjamin Kramer606a50a2011-10-21 21:13:47 +0000499 if (!isProb)
Manman Rencf104462012-08-24 18:14:27 +0000500 std::swap(TakenIdx, NonTakenIdx);
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000501
Manman Rencf104462012-08-24 18:14:27 +0000502 setEdgeWeight(BB, TakenIdx, FPH_TAKEN_WEIGHT);
503 setEdgeWeight(BB, NonTakenIdx, FPH_NONTAKEN_WEIGHT);
Benjamin Kramer1e731a12011-10-21 20:12:47 +0000504
505 return true;
506}
Jakub Staszak17af66a2011-07-31 03:27:24 +0000507
Bill Wendlinge1c54262012-08-15 12:22:35 +0000508bool BranchProbabilityInfo::calcInvokeHeuristics(BasicBlock *BB) {
509 InvokeInst *II = dyn_cast<InvokeInst>(BB->getTerminator());
510 if (!II)
511 return false;
512
Manman Rencf104462012-08-24 18:14:27 +0000513 setEdgeWeight(BB, 0/*Index for Normal*/, IH_TAKEN_WEIGHT);
514 setEdgeWeight(BB, 1/*Index for Unwind*/, IH_NONTAKEN_WEIGHT);
Bill Wendlinge1c54262012-08-15 12:22:35 +0000515 return true;
516}
517
Pete Cooperb9d2e342015-05-28 19:43:06 +0000518void BranchProbabilityInfo::releaseMemory() {
519 Weights.clear();
520}
521
Cong Houab23bfb2015-07-15 22:48:29 +0000522void BranchProbabilityInfo::print(raw_ostream &OS) const {
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000523 OS << "---- Branch Probabilities ----\n";
524 // We print the probabilities from the last function the analysis ran over,
525 // or the function it is currently running over.
526 assert(LastF && "Cannot print prior to running over a function");
Duncan P. N. Exon Smith5a82c912015-10-10 00:53:03 +0000527 for (const auto &BI : *LastF) {
528 for (succ_const_iterator SI = succ_begin(&BI), SE = succ_end(&BI); SI != SE;
529 ++SI) {
530 printEdgeProbability(OS << " ", &BI, *SI);
Duncan P. N. Exon Smith6c990152014-07-21 17:06:51 +0000531 }
532 }
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000533}
534
Jakub Staszakefd94c82011-07-29 19:30:00 +0000535uint32_t BranchProbabilityInfo::getSumForBlock(const BasicBlock *BB) const {
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000536 uint32_t Sum = 0;
537
Jakub Staszakefd94c82011-07-29 19:30:00 +0000538 for (succ_const_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
Manman Rencf104462012-08-24 18:14:27 +0000539 uint32_t Weight = getEdgeWeight(BB, I.getSuccessorIndex());
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000540 uint32_t PrevSum = Sum;
Andrew Trick49371f32011-06-04 01:16:30 +0000541
542 Sum += Weight;
Diego Novillo14f94de2015-05-06 17:55:11 +0000543 assert(Sum >= PrevSum); (void) PrevSum;
Andrew Trick49371f32011-06-04 01:16:30 +0000544 }
545
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000546 return Sum;
547}
548
Jakub Staszakefd94c82011-07-29 19:30:00 +0000549bool BranchProbabilityInfo::
550isEdgeHot(const BasicBlock *Src, const BasicBlock *Dst) const {
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000551 // Hot probability is at least 4/5 = 80%
Benjamin Kramer929f53f2011-10-23 11:19:14 +0000552 // FIXME: Compare against a static "hot" BranchProbability.
553 return getEdgeProbability(Src, Dst) > BranchProbability(4, 5);
Andrew Trick49371f32011-06-04 01:16:30 +0000554}
555
556BasicBlock *BranchProbabilityInfo::getHotSucc(BasicBlock *BB) const {
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000557 uint32_t Sum = 0;
558 uint32_t MaxWeight = 0;
Craig Topper9f008862014-04-15 04:59:12 +0000559 BasicBlock *MaxSucc = nullptr;
Andrew Trick49371f32011-06-04 01:16:30 +0000560
Duncan P. N. Exon Smith6c990152014-07-21 17:06:51 +0000561 for (succ_iterator I = succ_begin(BB), E = succ_end(BB); I != E; ++I) {
562 BasicBlock *Succ = *I;
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000563 uint32_t Weight = getEdgeWeight(BB, Succ);
564 uint32_t PrevSum = Sum;
Andrew Trick49371f32011-06-04 01:16:30 +0000565
566 Sum += Weight;
567 assert(Sum > PrevSum); (void) PrevSum;
568
569 if (Weight > MaxWeight) {
570 MaxWeight = Weight;
571 MaxSucc = Succ;
572 }
573 }
574
Benjamin Kramer929f53f2011-10-23 11:19:14 +0000575 // Hot probability is at least 4/5 = 80%
576 if (BranchProbability(MaxWeight, Sum) > BranchProbability(4, 5))
Andrew Trick49371f32011-06-04 01:16:30 +0000577 return MaxSucc;
578
Craig Topper9f008862014-04-15 04:59:12 +0000579 return nullptr;
Andrew Trick49371f32011-06-04 01:16:30 +0000580}
581
Manman Rencf104462012-08-24 18:14:27 +0000582/// Get the raw edge weight for the edge. If can't find it, return
583/// DEFAULT_WEIGHT value. Here an edge is specified using PredBlock and an index
584/// to the successors.
Jakub Staszakefd94c82011-07-29 19:30:00 +0000585uint32_t BranchProbabilityInfo::
Manman Rencf104462012-08-24 18:14:27 +0000586getEdgeWeight(const BasicBlock *Src, unsigned IndexInSuccessors) const {
587 DenseMap<Edge, uint32_t>::const_iterator I =
588 Weights.find(std::make_pair(Src, IndexInSuccessors));
Andrew Trick49371f32011-06-04 01:16:30 +0000589
590 if (I != Weights.end())
591 return I->second;
592
593 return DEFAULT_WEIGHT;
594}
595
Duncan P. N. Exon Smith37bd5292014-04-11 23:20:52 +0000596uint32_t BranchProbabilityInfo::getEdgeWeight(const BasicBlock *Src,
597 succ_const_iterator Dst) const {
598 return getEdgeWeight(Src, Dst.getSuccessorIndex());
Michael Gottesmanfb9164f2013-12-14 02:24:25 +0000599}
600
Manman Rencf104462012-08-24 18:14:27 +0000601/// Get the raw edge weight calculated for the block pair. This returns the sum
602/// of all raw edge weights from Src to Dst.
603uint32_t BranchProbabilityInfo::
604getEdgeWeight(const BasicBlock *Src, const BasicBlock *Dst) const {
605 uint32_t Weight = 0;
Diego Novillo14f94de2015-05-06 17:55:11 +0000606 bool FoundWeight = false;
Manman Rencf104462012-08-24 18:14:27 +0000607 DenseMap<Edge, uint32_t>::const_iterator MapI;
608 for (succ_const_iterator I = succ_begin(Src), E = succ_end(Src); I != E; ++I)
609 if (*I == Dst) {
610 MapI = Weights.find(std::make_pair(Src, I.getSuccessorIndex()));
Diego Novillo14f94de2015-05-06 17:55:11 +0000611 if (MapI != Weights.end()) {
612 FoundWeight = true;
Manman Rencf104462012-08-24 18:14:27 +0000613 Weight += MapI->second;
Diego Novillo14f94de2015-05-06 17:55:11 +0000614 }
Manman Rencf104462012-08-24 18:14:27 +0000615 }
Diego Novillo14f94de2015-05-06 17:55:11 +0000616 return (!FoundWeight) ? DEFAULT_WEIGHT : Weight;
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000617}
618
Manman Rencf104462012-08-24 18:14:27 +0000619/// Set the edge weight for a given edge specified by PredBlock and an index
620/// to the successors.
621void BranchProbabilityInfo::
622setEdgeWeight(const BasicBlock *Src, unsigned IndexInSuccessors,
623 uint32_t Weight) {
624 Weights[std::make_pair(Src, IndexInSuccessors)] = Weight;
625 DEBUG(dbgs() << "set edge " << Src->getName() << " -> "
626 << IndexInSuccessors << " successor weight to "
627 << Weight << "\n");
628}
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000629
Manman Rencf104462012-08-24 18:14:27 +0000630/// Get an edge's probability, relative to other out-edges from Src.
631BranchProbability BranchProbabilityInfo::
632getEdgeProbability(const BasicBlock *Src, unsigned IndexInSuccessors) const {
633 uint32_t N = getEdgeWeight(Src, IndexInSuccessors);
634 uint32_t D = getSumForBlock(Src);
635
Cong Houfff8ccf2015-10-26 18:00:17 +0000636 // It is possible that the edge weight on the only successor edge of Src is
637 // zero, in which case we return 100%.
638 if (N == 0 && D == 0)
639 return BranchProbability::getOne();
640
Manman Rencf104462012-08-24 18:14:27 +0000641 return BranchProbability(N, D);
642}
643
644/// Get the probability of going from Src to Dst. It returns the sum of all
645/// probabilities for edges from Src to Dst.
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000646BranchProbability BranchProbabilityInfo::
Jakub Staszakefd94c82011-07-29 19:30:00 +0000647getEdgeProbability(const BasicBlock *Src, const BasicBlock *Dst) const {
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000648
649 uint32_t N = getEdgeWeight(Src, Dst);
650 uint32_t D = getSumForBlock(Src);
651
Cong Houfff8ccf2015-10-26 18:00:17 +0000652 // It is possible that the edge weight on the only successor edge of Src is
653 // zero, in which case we return 100%.
654 if (N == 0 && D == 0)
655 return BranchProbability::getOne();
656
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000657 return BranchProbability(N, D);
Andrew Trick49371f32011-06-04 01:16:30 +0000658}
659
Cong Houd97c1002015-12-01 05:29:22 +0000660BranchProbability
661BranchProbabilityInfo::getEdgeProbability(const BasicBlock *Src,
662 succ_const_iterator Dst) const {
663 return getEdgeProbability(Src, Dst.getSuccessorIndex());
664}
665
Andrew Trick49371f32011-06-04 01:16:30 +0000666raw_ostream &
Chandler Carruth1c8ace02011-10-23 21:21:50 +0000667BranchProbabilityInfo::printEdgeProbability(raw_ostream &OS,
668 const BasicBlock *Src,
669 const BasicBlock *Dst) const {
Andrew Trick49371f32011-06-04 01:16:30 +0000670
Jakub Staszak12a43bd2011-06-16 20:22:37 +0000671 const BranchProbability Prob = getEdgeProbability(Src, Dst);
Benjamin Kramer1f97a5a2011-11-15 16:27:03 +0000672 OS << "edge " << Src->getName() << " -> " << Dst->getName()
Andrew Trick3d4e64b2011-06-11 01:05:22 +0000673 << " probability is " << Prob
674 << (isEdgeHot(Src, Dst) ? " [HOT edge]\n" : "\n");
Andrew Trick49371f32011-06-04 01:16:30 +0000675
676 return OS;
677}
Cong Houab23bfb2015-07-15 22:48:29 +0000678
679void BranchProbabilityInfo::calculate(Function &F, const LoopInfo& LI) {
680 DEBUG(dbgs() << "---- Branch Probability Info : " << F.getName()
681 << " ----\n\n");
682 LastF = &F; // Store the last function we ran on for printing.
683 assert(PostDominatedByUnreachable.empty());
684 assert(PostDominatedByColdCall.empty());
685
686 // Walk the basic blocks in post-order so that we can build up state about
687 // the successors of a block iteratively.
688 for (auto BB : post_order(&F.getEntryBlock())) {
689 DEBUG(dbgs() << "Computing probabilities for " << BB->getName() << "\n");
690 if (calcUnreachableHeuristics(BB))
691 continue;
692 if (calcMetadataWeights(BB))
693 continue;
694 if (calcColdCallHeuristics(BB))
695 continue;
696 if (calcLoopBranchHeuristics(BB, LI))
697 continue;
698 if (calcPointerHeuristics(BB))
699 continue;
700 if (calcZeroHeuristics(BB))
701 continue;
702 if (calcFloatingPointHeuristics(BB))
703 continue;
704 calcInvokeHeuristics(BB);
705 }
706
707 PostDominatedByUnreachable.clear();
708 PostDominatedByColdCall.clear();
709}
710
711void BranchProbabilityInfoWrapperPass::getAnalysisUsage(
712 AnalysisUsage &AU) const {
713 AU.addRequired<LoopInfoWrapperPass>();
714 AU.setPreservesAll();
715}
716
717bool BranchProbabilityInfoWrapperPass::runOnFunction(Function &F) {
718 const LoopInfo &LI = getAnalysis<LoopInfoWrapperPass>().getLoopInfo();
719 BPI.calculate(F, LI);
720 return false;
721}
722
723void BranchProbabilityInfoWrapperPass::releaseMemory() { BPI.releaseMemory(); }
724
725void BranchProbabilityInfoWrapperPass::print(raw_ostream &OS,
726 const Module *) const {
727 BPI.print(OS);
728}