LLVM API Documentation

Main Page | Namespace List | Class Hierarchy | Alphabetical List | Class List | Directories | File List | Namespace Members | Class Members | File Members | Related Pages

InlineCost.cpp

Go to the documentation of this file.
00001 //===- InlineCoast.cpp - Cost analysis for inliner ------------------------===//
00002 //
00003 //                     The LLVM Compiler Infrastructure
00004 //
00005 // This file is distributed under the University of Illinois Open Source
00006 // License. See LICENSE.TXT for details.
00007 //
00008 //===----------------------------------------------------------------------===//
00009 //
00010 // This file implements inline cost analysis.
00011 //
00012 //===----------------------------------------------------------------------===//
00013 
00014 
00015 #include "llvm/Transforms/Utils/InlineCost.h"
00016 #include "llvm/Support/CallSite.h"
00017 #include "llvm/CallingConv.h"
00018 #include "llvm/IntrinsicInst.h"
00019 
00020 using namespace llvm;
00021 
00022 // CountCodeReductionForConstant - Figure out an approximation for how many
00023 // instructions will be constant folded if the specified value is constant.
00024 //
00025 unsigned InlineCostAnalyzer::FunctionInfo::
00026          CountCodeReductionForConstant(Value *V) {
00027   unsigned Reduction = 0;
00028   for (Value::use_iterator UI = V->use_begin(), E = V->use_end(); UI != E; ++UI)
00029     if (isa<BranchInst>(*UI))
00030       Reduction += 40;          // Eliminating a conditional branch is a big win
00031     else if (SwitchInst *SI = dyn_cast<SwitchInst>(*UI))
00032       // Eliminating a switch is a big win, proportional to the number of edges
00033       // deleted.
00034       Reduction += (SI->getNumSuccessors()-1) * 40;
00035     else if (CallInst *CI = dyn_cast<CallInst>(*UI)) {
00036       // Turning an indirect call into a direct call is a BIG win
00037       Reduction += CI->getCalledValue() == V ? 500 : 0;
00038     } else if (InvokeInst *II = dyn_cast<InvokeInst>(*UI)) {
00039       // Turning an indirect call into a direct call is a BIG win
00040       Reduction += II->getCalledValue() == V ? 500 : 0;
00041     } else {
00042       // Figure out if this instruction will be removed due to simple constant
00043       // propagation.
00044       Instruction &Inst = cast<Instruction>(**UI);
00045       bool AllOperandsConstant = true;
00046       for (unsigned i = 0, e = Inst.getNumOperands(); i != e; ++i)
00047         if (!isa<Constant>(Inst.getOperand(i)) && Inst.getOperand(i) != V) {
00048           AllOperandsConstant = false;
00049           break;
00050         }
00051 
00052       if (AllOperandsConstant) {
00053         // We will get to remove this instruction...
00054         Reduction += 7;
00055 
00056         // And any other instructions that use it which become constants
00057         // themselves.
00058         Reduction += CountCodeReductionForConstant(&Inst);
00059       }
00060     }
00061 
00062   return Reduction;
00063 }
00064 
00065 // CountCodeReductionForAlloca - Figure out an approximation of how much smaller
00066 // the function will be if it is inlined into a context where an argument
00067 // becomes an alloca.
00068 //
00069 unsigned InlineCostAnalyzer::FunctionInfo::
00070          CountCodeReductionForAlloca(Value *V) {
00071   if (!isa<PointerType>(V->getType())) return 0;  // Not a pointer
00072   unsigned Reduction = 0;
00073   for (Value::use_iterator UI = V->use_begin(), E = V->use_end(); UI != E;++UI){
00074     Instruction *I = cast<Instruction>(*UI);
00075     if (isa<LoadInst>(I) || isa<StoreInst>(I))
00076       Reduction += 10;
00077     else if (GetElementPtrInst *GEP = dyn_cast<GetElementPtrInst>(I)) {
00078       // If the GEP has variable indices, we won't be able to do much with it.
00079       for (Instruction::op_iterator I = GEP->op_begin()+1, E = GEP->op_end();
00080            I != E; ++I)
00081         if (!isa<Constant>(*I)) return 0;
00082       Reduction += CountCodeReductionForAlloca(GEP)+15;
00083     } else {
00084       // If there is some other strange instruction, we're not going to be able
00085       // to do much if we inline this.
00086       return 0;
00087     }
00088   }
00089 
00090   return Reduction;
00091 }
00092 
00093 /// analyzeFunction - Fill in the current structure with information gleaned
00094 /// from the specified function.
00095 void InlineCostAnalyzer::FunctionInfo::analyzeFunction(Function *F) {
00096   unsigned NumInsts = 0, NumBlocks = 0, NumVectorInsts = 0;
00097 
00098   // Look at the size of the callee.  Each basic block counts as 20 units, and
00099   // each instruction counts as 5.
00100   for (Function::const_iterator BB = F->begin(), E = F->end(); BB != E; ++BB) {
00101     for (BasicBlock::const_iterator II = BB->begin(), E = BB->end();
00102          II != E; ++II) {
00103       if (isa<PHINode>(II)) continue;           // PHI nodes don't count.
00104 
00105       // Special handling for calls.
00106       if (isa<CallInst>(II) || isa<InvokeInst>(II)) {
00107         if (isa<DbgInfoIntrinsic>(II))
00108           continue;  // Debug intrinsics don't count as size.
00109         
00110         CallSite CS = CallSite::get(const_cast<Instruction*>(&*II));
00111         
00112         // If this function contains a call to setjmp or _setjmp, never inline
00113         // it.  This is a hack because we depend on the user marking their local
00114         // variables as volatile if they are live across a setjmp call, and they
00115         // probably won't do this in callers.
00116         if (Function *F = CS.getCalledFunction())
00117           if (F->isDeclaration() && 
00118               (F->isName("setjmp") || F->isName("_setjmp"))) {
00119             NeverInline = true;
00120             return;
00121           }
00122         
00123         // Calls often compile into many machine instructions.  Bump up their
00124         // cost to reflect this.
00125         if (!isa<IntrinsicInst>(II))
00126           NumInsts += 5;
00127       }
00128       
00129       if (isa<ExtractElementInst>(II) || isa<VectorType>(II->getType()))
00130         ++NumVectorInsts; 
00131       
00132       // Noop casts, including ptr <-> int,  don't count.
00133       if (const CastInst *CI = dyn_cast<CastInst>(II)) {
00134         if (CI->isLosslessCast() || isa<IntToPtrInst>(CI) || 
00135             isa<PtrToIntInst>(CI))
00136           continue;
00137       } else if (const GetElementPtrInst *GEPI =
00138                  dyn_cast<GetElementPtrInst>(II)) {
00139         // If a GEP has all constant indices, it will probably be folded with
00140         // a load/store.
00141         bool AllConstant = true;
00142         for (unsigned i = 1, e = GEPI->getNumOperands(); i != e; ++i)
00143           if (!isa<ConstantInt>(GEPI->getOperand(i))) {
00144             AllConstant = false;
00145             break;
00146           }
00147         if (AllConstant) continue;
00148       }
00149       
00150       ++NumInsts;
00151     }
00152 
00153     ++NumBlocks;
00154   }
00155 
00156   this->NumBlocks      = NumBlocks;
00157   this->NumInsts       = NumInsts;
00158   this->NumVectorInsts = NumVectorInsts;
00159 
00160   // Check out all of the arguments to the function, figuring out how much
00161   // code can be eliminated if one of the arguments is a constant.
00162   for (Function::arg_iterator I = F->arg_begin(), E = F->arg_end(); I != E; ++I)
00163     ArgumentWeights.push_back(ArgInfo(CountCodeReductionForConstant(I),
00164                                       CountCodeReductionForAlloca(I)));
00165 }
00166 
00167 
00168 
00169 // getInlineCost - The heuristic used to determine if we should inline the
00170 // function call or not.
00171 //
00172 int InlineCostAnalyzer::getInlineCost(CallSite CS,
00173                                SmallPtrSet<const Function *, 16> &NeverInline) {
00174   Instruction *TheCall = CS.getInstruction();
00175   Function *Callee = CS.getCalledFunction();
00176   const Function *Caller = TheCall->getParent()->getParent();
00177   
00178   // Don't inline a directly recursive call.
00179   if (Caller == Callee ||
00180       // Don't inline functions which can be redefined at link-time to mean
00181       // something else.  link-once linkage is ok though.
00182       Callee->hasWeakLinkage() ||
00183       
00184       // Don't inline functions marked noinline.
00185       NeverInline.count(Callee))
00186     return 2000000000;
00187   
00188   // InlineCost - This value measures how good of an inline candidate this call
00189   // site is to inline.  A lower inline cost make is more likely for the call to
00190   // be inlined.  This value may go negative.
00191   //
00192   int InlineCost = 0;
00193   
00194   // If there is only one call of the function, and it has internal linkage,
00195   // make it almost guaranteed to be inlined.
00196   //
00197   if (Callee->hasInternalLinkage() && Callee->hasOneUse())
00198     InlineCost -= 15000;
00199   
00200   // If this function uses the coldcc calling convention, prefer not to inline
00201   // it.
00202   if (Callee->getCallingConv() == CallingConv::Cold)
00203     InlineCost += 2000;
00204   
00205   // If the instruction after the call, or if the normal destination of the
00206   // invoke is an unreachable instruction, the function is noreturn.  As such,
00207   // there is little point in inlining this.
00208   if (InvokeInst *II = dyn_cast<InvokeInst>(TheCall)) {
00209     if (isa<UnreachableInst>(II->getNormalDest()->begin()))
00210       InlineCost += 10000;
00211   } else if (isa<UnreachableInst>(++BasicBlock::iterator(TheCall)))
00212     InlineCost += 10000;
00213   
00214   // Get information about the callee...
00215   FunctionInfo &CalleeFI = CachedFunctionInfo[Callee];
00216   
00217   // If we haven't calculated this information yet, do so now.
00218   if (CalleeFI.NumBlocks == 0)
00219     CalleeFI.analyzeFunction(Callee);
00220   
00221   // If we should never inline this, return a huge cost.
00222   if (CalleeFI.NeverInline)
00223     return 2000000000;
00224     
00225   // Add to the inline quality for properties that make the call valuable to
00226   // inline.  This includes factors that indicate that the result of inlining
00227   // the function will be optimizable.  Currently this just looks at arguments
00228   // passed into the function.
00229   //
00230   unsigned ArgNo = 0;
00231   for (CallSite::arg_iterator I = CS.arg_begin(), E = CS.arg_end();
00232        I != E; ++I, ++ArgNo) {
00233     // Each argument passed in has a cost at both the caller and the callee
00234     // sides.  This favors functions that take many arguments over functions
00235     // that take few arguments.
00236     InlineCost -= 20;
00237     
00238     // If this is a function being passed in, it is very likely that we will be
00239     // able to turn an indirect function call into a direct function call.
00240     if (isa<Function>(I))
00241       InlineCost -= 100;
00242     
00243     // If an alloca is passed in, inlining this function is likely to allow
00244     // significant future optimization possibilities (like scalar promotion, and
00245     // scalarization), so encourage the inlining of the function.
00246     //
00247     else if (isa<AllocaInst>(I)) {
00248       if (ArgNo < CalleeFI.ArgumentWeights.size())
00249         InlineCost -= CalleeFI.ArgumentWeights[ArgNo].AllocaWeight;
00250       
00251       // If this is a constant being passed into the function, use the argument
00252       // weights calculated for the callee to determine how much will be folded
00253       // away with this information.
00254     } else if (isa<Constant>(I)) {
00255       if (ArgNo < CalleeFI.ArgumentWeights.size())
00256         InlineCost -= CalleeFI.ArgumentWeights[ArgNo].ConstantWeight;
00257     }
00258   }
00259   
00260   // Now that we have considered all of the factors that make the call site more
00261   // likely to be inlined, look at factors that make us not want to inline it.
00262   
00263   // Don't inline into something too big, which would make it bigger.
00264   //
00265   InlineCost += Caller->size()/15;
00266   
00267   // Look at the size of the callee. Each instruction counts as 5.
00268   InlineCost += CalleeFI.NumInsts*5;
00269 
00270   return InlineCost;
00271 }
00272 
00273 // getInlineFudgeFactor - Return a > 1.0 factor if the inliner should use a
00274 // higher threshold to determine if the function call should be inlined.
00275 float InlineCostAnalyzer::getInlineFudgeFactor(CallSite CS) {
00276   Function *Callee = CS.getCalledFunction();
00277   
00278   // Get information about the callee...
00279   FunctionInfo &CalleeFI = CachedFunctionInfo[Callee];
00280   
00281   // If we haven't calculated this information yet, do so now.
00282   if (CalleeFI.NumBlocks == 0)
00283     CalleeFI.analyzeFunction(Callee);
00284 
00285   float Factor = 1.0f;
00286   // Single BB functions are often written to be inlined.
00287   if (CalleeFI.NumBlocks == 1)
00288     Factor += 0.5f;
00289 
00290   // Be more aggressive if the function contains a good chunk (if it mades up
00291   // at least 10% of the instructions) of vector instructions.
00292   if (CalleeFI.NumVectorInsts > CalleeFI.NumInsts/2)
00293     Factor += 2.0f;
00294   else if (CalleeFI.NumVectorInsts > CalleeFI.NumInsts/10)
00295     Factor += 1.5f;
00296   return Factor;
00297 }



This web site is hosted by the Computer Science Department at the University of Illinois at Urbana-Champaign.