Remove extra parameter.
[oota-llvm.git] / lib / Analysis / InlineCost.cpp
1 //===- InlineCost.cpp - Cost analysis for inliner -------------------------===//
2 //
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 // This file implements inline cost analysis.
11 //
12 //===----------------------------------------------------------------------===//
13
14 #include "llvm/Analysis/InlineCost.h"
15 #include "llvm/Support/CallSite.h"
16 #include "llvm/CallingConv.h"
17 #include "llvm/IntrinsicInst.h"
18 #include "llvm/ADT/SmallPtrSet.h"
19 using namespace llvm;
20
21 // CountCodeReductionForConstant - Figure out an approximation for how many
22 // instructions will be constant folded if the specified value is constant.
23 //
24 unsigned InlineCostAnalyzer::FunctionInfo::
25 CountCodeReductionForConstant(Value *V) {
26   unsigned Reduction = 0;
27   for (Value::use_iterator UI = V->use_begin(), E = V->use_end(); UI != E; ++UI)
28     if (isa<BranchInst>(*UI) || isa<SwitchInst>(*UI)) {
29       // We will be able to eliminate all but one of the successors.
30       const TerminatorInst &TI = cast<TerminatorInst>(**UI);
31       const unsigned NumSucc = TI.getNumSuccessors();
32       unsigned Instrs = 0;
33       for (unsigned I = 0; I != NumSucc; ++I)
34         Instrs += Metrics.NumBBInsts[TI.getSuccessor(I)];
35       // We don't know which blocks will be eliminated, so use the average size.
36       Reduction += InlineConstants::InstrCost*Instrs*(NumSucc-1)/NumSucc;
37     } else if (CallInst *CI = dyn_cast<CallInst>(*UI)) {
38       // Turning an indirect call into a direct call is a BIG win
39       if (CI->getCalledValue() == V)
40         Reduction += InlineConstants::IndirectCallBonus;
41     } else if (InvokeInst *II = dyn_cast<InvokeInst>(*UI)) {
42       // Turning an indirect call into a direct call is a BIG win
43       if (II->getCalledValue() == V)
44         Reduction += InlineConstants::IndirectCallBonus;
45     } else {
46       // Figure out if this instruction will be removed due to simple constant
47       // propagation.
48       Instruction &Inst = cast<Instruction>(**UI);
49
50       // We can't constant propagate instructions which have effects or
51       // read memory.
52       //
53       // FIXME: It would be nice to capture the fact that a load from a
54       // pointer-to-constant-global is actually a *really* good thing to zap.
55       // Unfortunately, we don't know the pointer that may get propagated here,
56       // so we can't make this decision.
57       if (Inst.mayReadFromMemory() || Inst.mayHaveSideEffects() ||
58           isa<AllocaInst>(Inst))
59         continue;
60
61       bool AllOperandsConstant = true;
62       for (unsigned i = 0, e = Inst.getNumOperands(); i != e; ++i)
63         if (!isa<Constant>(Inst.getOperand(i)) && Inst.getOperand(i) != V) {
64           AllOperandsConstant = false;
65           break;
66         }
67
68       if (AllOperandsConstant) {
69         // We will get to remove this instruction...
70         Reduction += InlineConstants::InstrCost;
71
72         // And any other instructions that use it which become constants
73         // themselves.
74         Reduction += CountCodeReductionForConstant(&Inst);
75       }
76     }
77
78   return Reduction;
79 }
80
81 // CountCodeReductionForAlloca - Figure out an approximation of how much smaller
82 // the function will be if it is inlined into a context where an argument
83 // becomes an alloca.
84 //
85 unsigned InlineCostAnalyzer::FunctionInfo::
86          CountCodeReductionForAlloca(Value *V) {
87   if (!V->getType()->isPointerTy()) return 0;  // Not a pointer
88   unsigned Reduction = 0;
89   for (Value::use_iterator UI = V->use_begin(), E = V->use_end(); UI != E;++UI){
90     Instruction *I = cast<Instruction>(*UI);
91     if (isa<LoadInst>(I) || isa<StoreInst>(I))
92       Reduction += InlineConstants::InstrCost;
93     else if (GetElementPtrInst *GEP = dyn_cast<GetElementPtrInst>(I)) {
94       // If the GEP has variable indices, we won't be able to do much with it.
95       if (GEP->hasAllConstantIndices())
96         Reduction += CountCodeReductionForAlloca(GEP);
97     } else if (BitCastInst *BCI = dyn_cast<BitCastInst>(I)) {
98       // Track pointer through bitcasts.
99       Reduction += CountCodeReductionForAlloca(BCI);
100     } else {
101       // If there is some other strange instruction, we're not going to be able
102       // to do much if we inline this.
103       return 0;
104     }
105   }
106
107   return Reduction;
108 }
109
110 // callIsSmall - If a call is likely to lower to a single target instruction, or
111 // is otherwise deemed small return true.
112 // TODO: Perhaps calls like memcpy, strcpy, etc?
113 static bool callIsSmall(const Function *F) {
114   if (!F) return false;
115   
116   if (F->hasLocalLinkage()) return false;
117   
118   if (!F->hasName()) return false;
119   
120   StringRef Name = F->getName();
121   
122   // These will all likely lower to a single selection DAG node.
123   if (Name == "copysign" || Name == "copysignf" ||
124       Name == "fabs" || Name == "fabsf" || Name == "fabsl" ||
125       Name == "sin" || Name == "sinf" || Name == "sinl" ||
126       Name == "cos" || Name == "cosf" || Name == "cosl" ||
127       Name == "sqrt" || Name == "sqrtf" || Name == "sqrtl" )
128     return true;
129   
130   // These are all likely to be optimized into something smaller.
131   if (Name == "pow" || Name == "powf" || Name == "powl" ||
132       Name == "exp2" || Name == "exp2l" || Name == "exp2f" ||
133       Name == "floor" || Name == "floorf" || Name == "ceil" ||
134       Name == "round" || Name == "ffs" || Name == "ffsl" ||
135       Name == "abs" || Name == "labs" || Name == "llabs")
136     return true;
137   
138   return false;
139 }
140
141 /// analyzeBasicBlock - Fill in the current structure with information gleaned
142 /// from the specified block.
143 void CodeMetrics::analyzeBasicBlock(const BasicBlock *BB) {
144   ++NumBlocks;
145   unsigned NumInstsInThisBB = 0;
146   for (BasicBlock::const_iterator II = BB->begin(), E = BB->end();
147        II != E; ++II) {
148     if (isa<PHINode>(II)) continue;           // PHI nodes don't count.
149
150     // Special handling for calls.
151     if (isa<CallInst>(II) || isa<InvokeInst>(II)) {
152       if (isa<DbgInfoIntrinsic>(II))
153         continue;  // Debug intrinsics don't count as size.
154       
155       CallSite CS = CallSite::get(const_cast<Instruction*>(&*II));
156       
157       // If this function contains a call to setjmp or _setjmp, never inline
158       // it.  This is a hack because we depend on the user marking their local
159       // variables as volatile if they are live across a setjmp call, and they
160       // probably won't do this in callers.
161       if (Function *F = CS.getCalledFunction())
162         if (F->isDeclaration() && 
163             (F->getName() == "setjmp" || F->getName() == "_setjmp"))
164           NeverInline = true;
165
166       if (!isa<IntrinsicInst>(II) && !callIsSmall(CS.getCalledFunction())) {
167         // Each argument to a call takes on average one instruction to set up.
168         NumInsts += CS.arg_size();
169         ++NumCalls;
170       }
171     }
172     
173     if (const AllocaInst *AI = dyn_cast<AllocaInst>(II)) {
174       if (!AI->isStaticAlloca())
175         this->usesDynamicAlloca = true;
176     }
177
178     if (isa<ExtractElementInst>(II) || II->getType()->isVectorTy())
179       ++NumVectorInsts; 
180     
181     if (const CastInst *CI = dyn_cast<CastInst>(II)) {
182       // Noop casts, including ptr <-> int,  don't count.
183       if (CI->isLosslessCast() || isa<IntToPtrInst>(CI) || 
184           isa<PtrToIntInst>(CI))
185         continue;
186       // Result of a cmp instruction is often extended (to be used by other
187       // cmp instructions, logical or return instructions). These are usually
188       // nop on most sane targets.
189       if (isa<CmpInst>(CI->getOperand(0)))
190         continue;
191     } else if (const GetElementPtrInst *GEPI = dyn_cast<GetElementPtrInst>(II)){
192       // If a GEP has all constant indices, it will probably be folded with
193       // a load/store.
194       if (GEPI->hasAllConstantIndices())
195         continue;
196     }
197
198     ++NumInsts;
199     ++NumInstsInThisBB;
200   }
201   
202   if (isa<ReturnInst>(BB->getTerminator()))
203     ++NumRets;
204   
205   // We never want to inline functions that contain an indirectbr.  This is
206   // incorrect because all the blockaddress's (in static global initializers
207   // for example) would be referring to the original function, and this indirect
208   // jump would jump from the inlined copy of the function into the original
209   // function which is extremely undefined behavior.
210   if (isa<IndirectBrInst>(BB->getTerminator()))
211     NeverInline = true;
212
213   // Remember NumInsts for this BB.
214   NumBBInsts[BB] = NumInstsInThisBB;
215 }
216
217 /// analyzeFunction - Fill in the current structure with information gleaned
218 /// from the specified function.
219 void CodeMetrics::analyzeFunction(Function *F) {
220   // Look at the size of the callee.
221   for (Function::const_iterator BB = F->begin(), E = F->end(); BB != E; ++BB)
222     analyzeBasicBlock(&*BB);
223 }
224
225 /// analyzeFunction - Fill in the current structure with information gleaned
226 /// from the specified function.
227 void InlineCostAnalyzer::FunctionInfo::analyzeFunction(Function *F) {
228   Metrics.analyzeFunction(F);
229
230   // A function with exactly one return has it removed during the inlining
231   // process (see InlineFunction), so don't count it.
232   // FIXME: This knowledge should really be encoded outside of FunctionInfo.
233   if (Metrics.NumRets==1)
234     --Metrics.NumInsts;
235
236   // Don't bother calculating argument weights if we are never going to inline
237   // the function anyway.
238   if (Metrics.NeverInline)
239     return;
240
241   // Check out all of the arguments to the function, figuring out how much
242   // code can be eliminated if one of the arguments is a constant.
243   ArgumentWeights.reserve(F->arg_size());
244   for (Function::arg_iterator I = F->arg_begin(), E = F->arg_end(); I != E; ++I)
245     ArgumentWeights.push_back(ArgInfo(CountCodeReductionForConstant(I),
246                                       CountCodeReductionForAlloca(I)));
247 }
248
249 // getInlineCost - The heuristic used to determine if we should inline the
250 // function call or not.
251 //
252 InlineCost InlineCostAnalyzer::getInlineCost(CallSite CS,
253                                SmallPtrSet<const Function *, 16> &NeverInline) {
254   Instruction *TheCall = CS.getInstruction();
255   Function *Callee = CS.getCalledFunction();
256   Function *Caller = TheCall->getParent()->getParent();
257
258   // Don't inline functions which can be redefined at link-time to mean
259   // something else.  Don't inline functions marked noinline.
260   if (Callee->mayBeOverridden() ||
261       Callee->hasFnAttr(Attribute::NoInline) || NeverInline.count(Callee))
262     return llvm::InlineCost::getNever();
263
264   // InlineCost - This value measures how good of an inline candidate this call
265   // site is to inline.  A lower inline cost make is more likely for the call to
266   // be inlined.  This value may go negative.
267   //
268   int InlineCost = 0;
269   
270   // If there is only one call of the function, and it has internal linkage,
271   // make it almost guaranteed to be inlined.
272   //
273   if (Callee->hasLocalLinkage() && Callee->hasOneUse())
274     InlineCost += InlineConstants::LastCallToStaticBonus;
275   
276   // If this function uses the coldcc calling convention, prefer not to inline
277   // it.
278   if (Callee->getCallingConv() == CallingConv::Cold)
279     InlineCost += InlineConstants::ColdccPenalty;
280   
281   // If the instruction after the call, or if the normal destination of the
282   // invoke is an unreachable instruction, the function is noreturn.  As such,
283   // there is little point in inlining this.
284   if (InvokeInst *II = dyn_cast<InvokeInst>(TheCall)) {
285     if (isa<UnreachableInst>(II->getNormalDest()->begin()))
286       InlineCost += InlineConstants::NoreturnPenalty;
287   } else if (isa<UnreachableInst>(++BasicBlock::iterator(TheCall)))
288     InlineCost += InlineConstants::NoreturnPenalty;
289   
290   // Get information about the callee...
291   FunctionInfo &CalleeFI = CachedFunctionInfo[Callee];
292   
293   // If we haven't calculated this information yet, do so now.
294   if (CalleeFI.Metrics.NumBlocks == 0)
295     CalleeFI.analyzeFunction(Callee);
296
297   // If we should never inline this, return a huge cost.
298   if (CalleeFI.Metrics.NeverInline)
299     return InlineCost::getNever();
300
301   // FIXME: It would be nice to kill off CalleeFI.NeverInline. Then we
302   // could move this up and avoid computing the FunctionInfo for
303   // things we are going to just return always inline for. This
304   // requires handling setjmp somewhere else, however.
305   if (!Callee->isDeclaration() && Callee->hasFnAttr(Attribute::AlwaysInline))
306     return InlineCost::getAlways();
307     
308   if (CalleeFI.Metrics.usesDynamicAlloca) {
309     // Get infomation about the caller...
310     FunctionInfo &CallerFI = CachedFunctionInfo[Caller];
311
312     // If we haven't calculated this information yet, do so now.
313     if (CallerFI.Metrics.NumBlocks == 0)
314       CallerFI.analyzeFunction(Caller);
315
316     // Don't inline a callee with dynamic alloca into a caller without them.
317     // Functions containing dynamic alloca's are inefficient in various ways;
318     // don't create more inefficiency.
319     if (!CallerFI.Metrics.usesDynamicAlloca)
320       return InlineCost::getNever();
321   }
322
323   // Add to the inline quality for properties that make the call valuable to
324   // inline.  This includes factors that indicate that the result of inlining
325   // the function will be optimizable.  Currently this just looks at arguments
326   // passed into the function.
327   //
328   unsigned ArgNo = 0;
329   for (CallSite::arg_iterator I = CS.arg_begin(), E = CS.arg_end();
330        I != E; ++I, ++ArgNo) {
331     // Each argument passed in has a cost at both the caller and the callee
332     // sides.  Measurements show that each argument costs about the same as an
333     // instruction.
334     InlineCost -= InlineConstants::InstrCost;
335
336     // If an alloca is passed in, inlining this function is likely to allow
337     // significant future optimization possibilities (like scalar promotion, and
338     // scalarization), so encourage the inlining of the function.
339     //
340     if (isa<AllocaInst>(I)) {
341       if (ArgNo < CalleeFI.ArgumentWeights.size())
342         InlineCost -= CalleeFI.ArgumentWeights[ArgNo].AllocaWeight;
343
344       // If this is a constant being passed into the function, use the argument
345       // weights calculated for the callee to determine how much will be folded
346       // away with this information.
347     } else if (isa<Constant>(I)) {
348       if (ArgNo < CalleeFI.ArgumentWeights.size())
349         InlineCost -= CalleeFI.ArgumentWeights[ArgNo].ConstantWeight;
350     }
351   }
352   
353   // Now that we have considered all of the factors that make the call site more
354   // likely to be inlined, look at factors that make us not want to inline it.
355
356   // Calls usually take a long time, so they make the inlining gain smaller.
357   InlineCost += CalleeFI.Metrics.NumCalls * InlineConstants::CallPenalty;
358
359   // Look at the size of the callee. Each instruction counts as 5.
360   InlineCost += CalleeFI.Metrics.NumInsts*InlineConstants::InstrCost;
361
362   return llvm::InlineCost::get(InlineCost);
363 }
364
365 // getInlineFudgeFactor - Return a > 1.0 factor if the inliner should use a
366 // higher threshold to determine if the function call should be inlined.
367 float InlineCostAnalyzer::getInlineFudgeFactor(CallSite CS) {
368   Function *Callee = CS.getCalledFunction();
369   
370   // Get information about the callee...
371   FunctionInfo &CalleeFI = CachedFunctionInfo[Callee];
372   
373   // If we haven't calculated this information yet, do so now.
374   if (CalleeFI.Metrics.NumBlocks == 0)
375     CalleeFI.analyzeFunction(Callee);
376
377   float Factor = 1.0f;
378   // Single BB functions are often written to be inlined.
379   if (CalleeFI.Metrics.NumBlocks == 1)
380     Factor += 0.5f;
381
382   // Be more aggressive if the function contains a good chunk (if it mades up
383   // at least 10% of the instructions) of vector instructions.
384   if (CalleeFI.Metrics.NumVectorInsts > CalleeFI.Metrics.NumInsts/2)
385     Factor += 2.0f;
386   else if (CalleeFI.Metrics.NumVectorInsts > CalleeFI.Metrics.NumInsts/10)
387     Factor += 1.5f;
388   return Factor;
389 }
390
391 /// growCachedCostInfo - update the cached cost info for Caller after Callee has
392 /// been inlined.
393 void
394 InlineCostAnalyzer::growCachedCostInfo(Function* Caller, Function* Callee) {
395   FunctionInfo &CallerFI = CachedFunctionInfo[Caller];
396
397   // For small functions we prefer to recalculate the cost for better accuracy.
398   if (CallerFI.Metrics.NumBlocks < 10 || CallerFI.Metrics.NumInsts < 1000) {
399     resetCachedCostInfo(Caller);
400     return;
401   }
402
403   // For large functions, we can save a lot of computation time by skipping
404   // recalculations.
405   if (CallerFI.Metrics.NumCalls > 0)
406     --CallerFI.Metrics.NumCalls;
407
408   if (Callee) {
409     FunctionInfo &CalleeFI = CachedFunctionInfo[Callee];
410     if (!CalleeFI.Metrics.NumBlocks) {
411       resetCachedCostInfo(Caller);
412       return;
413     }
414     CallerFI.Metrics.NeverInline |= CalleeFI.Metrics.NeverInline;
415     CallerFI.Metrics.usesDynamicAlloca |= CalleeFI.Metrics.usesDynamicAlloca;
416
417     CallerFI.Metrics.NumInsts += CalleeFI.Metrics.NumInsts;
418     CallerFI.Metrics.NumBlocks += CalleeFI.Metrics.NumBlocks;
419     CallerFI.Metrics.NumCalls += CalleeFI.Metrics.NumCalls;
420     CallerFI.Metrics.NumVectorInsts += CalleeFI.Metrics.NumVectorInsts;
421     CallerFI.Metrics.NumRets += CalleeFI.Metrics.NumRets;
422
423     // analyzeBasicBlock counts each function argument as an inst.
424     if (CallerFI.Metrics.NumInsts >= Callee->arg_size())
425       CallerFI.Metrics.NumInsts -= Callee->arg_size();
426     else
427       CallerFI.Metrics.NumInsts = 0;
428   }
429   // We are not updating the argumentweights. We have already determined that
430   // Caller is a fairly large function, so we accept the loss of precision.
431 }