1 //===- LowerExpectIntrinsic.cpp - Lower expect intrinsic ------------------===//
3 // The LLVM Compiler Infrastructure
5 // This file is distributed under the University of Illinois Open Source
6 // License. See LICENSE.TXT for details.
8 //===----------------------------------------------------------------------===//
10 // This pass lowers the 'expect' intrinsic to LLVM metadata.
12 //===----------------------------------------------------------------------===//
14 #include "llvm/Transforms/Scalar.h"
15 #include "llvm/ADT/Statistic.h"
16 #include "llvm/IR/BasicBlock.h"
17 #include "llvm/IR/Constants.h"
18 #include "llvm/IR/Function.h"
19 #include "llvm/IR/Instructions.h"
20 #include "llvm/IR/Intrinsics.h"
21 #include "llvm/IR/LLVMContext.h"
22 #include "llvm/IR/MDBuilder.h"
23 #include "llvm/IR/Metadata.h"
24 #include "llvm/Pass.h"
25 #include "llvm/Support/CommandLine.h"
26 #include "llvm/Support/Debug.h"
31 #define DEBUG_TYPE "lower-expect-intrinsic"
33 STATISTIC(IfHandled, "Number of 'expect' intrinsic instructions handled");
35 static cl::opt<uint32_t>
36 LikelyBranchWeight("likely-branch-weight", cl::Hidden, cl::init(64),
37 cl::desc("Weight of the branch likely to be taken (default = 64)"));
38 static cl::opt<uint32_t>
39 UnlikelyBranchWeight("unlikely-branch-weight", cl::Hidden, cl::init(4),
40 cl::desc("Weight of the branch unlikely to be taken (default = 4)"));
43 class LowerExpectIntrinsic : public FunctionPass {
45 bool HandleSwitchExpect(SwitchInst *SI);
47 bool HandleIfExpect(BranchInst *BI);
51 LowerExpectIntrinsic() : FunctionPass(ID) {
52 initializeLowerExpectIntrinsicPass(*PassRegistry::getPassRegistry());
55 bool runOnFunction(Function &F) override;
59 bool LowerExpectIntrinsic::HandleSwitchExpect(SwitchInst *SI) {
60 CallInst *CI = dyn_cast<CallInst>(SI->getCondition());
64 Function *Fn = CI->getCalledFunction();
65 if (!Fn || Fn->getIntrinsicID() != Intrinsic::expect)
68 Value *ArgValue = CI->getArgOperand(0);
69 ConstantInt *ExpectedValue = dyn_cast<ConstantInt>(CI->getArgOperand(1));
73 SwitchInst::CaseIt Case = SI->findCaseValue(ExpectedValue);
74 unsigned n = SI->getNumCases(); // +1 for default case.
75 std::vector<uint32_t> Weights(n + 1);
78 Case == SI->case_default() ? LikelyBranchWeight : UnlikelyBranchWeight;
79 for (unsigned i = 0; i != n; ++i)
81 i == Case.getCaseIndex() ? LikelyBranchWeight : UnlikelyBranchWeight;
83 SI->setMetadata(LLVMContext::MD_prof,
84 MDBuilder(CI->getContext()).createBranchWeights(Weights));
86 SI->setCondition(ArgValue);
90 bool LowerExpectIntrinsic::HandleIfExpect(BranchInst *BI) {
91 if (BI->isUnconditional())
94 // Handle non-optimized IR code like:
95 // %expval = call i64 @llvm.expect.i64(i64 %conv1, i64 1)
96 // %tobool = icmp ne i64 %expval, 0
97 // br i1 %tobool, label %if.then, label %if.end
99 // Or the following simpler case:
100 // %expval = call i1 @llvm.expect.i1(i1 %cmp, i1 1)
101 // br i1 %expval, label %if.then, label %if.end
105 ICmpInst *CmpI = dyn_cast<ICmpInst>(BI->getCondition());
107 CI = dyn_cast<CallInst>(BI->getCondition());
109 if (CmpI->getPredicate() != CmpInst::ICMP_NE)
111 CI = dyn_cast<CallInst>(CmpI->getOperand(0));
117 Function *Fn = CI->getCalledFunction();
118 if (!Fn || Fn->getIntrinsicID() != Intrinsic::expect)
121 Value *ArgValue = CI->getArgOperand(0);
122 ConstantInt *ExpectedValue = dyn_cast<ConstantInt>(CI->getArgOperand(1));
126 MDBuilder MDB(CI->getContext());
129 // If expect value is equal to 1 it means that we are more likely to take
130 // branch 0, in other case more likely is branch 1.
131 if (ExpectedValue->isOne())
132 Node = MDB.createBranchWeights(LikelyBranchWeight, UnlikelyBranchWeight);
134 Node = MDB.createBranchWeights(UnlikelyBranchWeight, LikelyBranchWeight);
136 BI->setMetadata(LLVMContext::MD_prof, Node);
139 CmpI->setOperand(0, ArgValue);
141 BI->setCondition(ArgValue);
145 bool LowerExpectIntrinsic::runOnFunction(Function &F) {
146 for (Function::iterator I = F.begin(), E = F.end(); I != E;) {
147 BasicBlock *BB = I++;
149 // Create "block_weights" metadata.
150 if (BranchInst *BI = dyn_cast<BranchInst>(BB->getTerminator())) {
151 if (HandleIfExpect(BI))
153 } else if (SwitchInst *SI = dyn_cast<SwitchInst>(BB->getTerminator())) {
154 if (HandleSwitchExpect(SI))
158 // remove llvm.expect intrinsics.
159 for (BasicBlock::iterator BI = BB->begin(), BE = BB->end(); BI != BE;) {
160 CallInst *CI = dyn_cast<CallInst>(BI++);
164 Function *Fn = CI->getCalledFunction();
165 if (Fn && Fn->getIntrinsicID() == Intrinsic::expect) {
166 Value *Exp = CI->getArgOperand(0);
167 CI->replaceAllUsesWith(Exp);
168 CI->eraseFromParent();
176 char LowerExpectIntrinsic::ID = 0;
177 INITIALIZE_PASS(LowerExpectIntrinsic, "lower-expect",
178 "Lower 'expect' Intrinsics", false, false)
180 FunctionPass *llvm::createLowerExpectIntrinsicPass() {
181 return new LowerExpectIntrinsic();