1 //===- PartialInlining.cpp - Inline parts of functions --------------------===//
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 pass performs partial inlining, typically by inlining an if statement
11 // that surrounds the body of the function.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #include "llvm/Transforms/IPO/PartialInlining.h"
16 #include "llvm/ADT/DenseMap.h"
17 #include "llvm/ADT/DenseSet.h"
18 #include "llvm/ADT/None.h"
19 #include "llvm/ADT/Optional.h"
20 #include "llvm/ADT/STLExtras.h"
21 #include "llvm/ADT/SmallVector.h"
22 #include "llvm/ADT/Statistic.h"
23 #include "llvm/Analysis/BlockFrequencyInfo.h"
24 #include "llvm/Analysis/BranchProbabilityInfo.h"
25 #include "llvm/Analysis/InlineCost.h"
26 #include "llvm/Analysis/LoopInfo.h"
27 #include "llvm/Analysis/OptimizationRemarkEmitter.h"
28 #include "llvm/Analysis/ProfileSummaryInfo.h"
29 #include "llvm/Analysis/TargetLibraryInfo.h"
30 #include "llvm/Analysis/TargetTransformInfo.h"
31 #include "llvm/IR/Attributes.h"
32 #include "llvm/IR/BasicBlock.h"
33 #include "llvm/IR/CFG.h"
34 #include "llvm/IR/CallSite.h"
35 #include "llvm/IR/DebugLoc.h"
36 #include "llvm/IR/DiagnosticInfo.h"
37 #include "llvm/IR/Dominators.h"
38 #include "llvm/IR/Function.h"
39 #include "llvm/IR/InstrTypes.h"
40 #include "llvm/IR/Instruction.h"
41 #include "llvm/IR/Instructions.h"
42 #include "llvm/IR/IntrinsicInst.h"
43 #include "llvm/IR/Intrinsics.h"
44 #include "llvm/IR/Module.h"
45 #include "llvm/IR/User.h"
46 #include "llvm/Pass.h"
47 #include "llvm/Support/BlockFrequency.h"
48 #include "llvm/Support/BranchProbability.h"
49 #include "llvm/Support/Casting.h"
50 #include "llvm/Support/CommandLine.h"
51 #include "llvm/Support/ErrorHandling.h"
52 #include "llvm/Transforms/IPO.h"
53 #include "llvm/Transforms/Utils/Cloning.h"
54 #include "llvm/Transforms/Utils/CodeExtractor.h"
55 #include "llvm/Transforms/Utils/ValueMapper.h"
56 #include <algorithm>
57 #include <cassert>
58 #include <cstdint>
59 #include <functional>
60 #include <iterator>
61 #include <memory>
62 #include <tuple>
63 #include <vector>
64 
65 using namespace llvm;
66 
67 #define DEBUG_TYPE "partial-inlining"
68 
69 STATISTIC(NumPartialInlined,
70           "Number of callsites functions partially inlined into.");
71 STATISTIC(NumColdOutlinePartialInlined, "Number of times functions with "
72                                         "cold outlined regions were partially "
73                                         "inlined into its caller(s).");
74 STATISTIC(NumColdRegionsFound,
75            "Number of cold single entry/exit regions found.");
76 STATISTIC(NumColdRegionsOutlined,
77            "Number of cold single entry/exit regions outlined.");
78 
79 // Command line option to disable partial-inlining. The default is false:
80 static cl::opt<bool>
81     DisablePartialInlining("disable-partial-inlining", cl::init(false),
82                            cl::Hidden, cl::desc("Disable partial inlining"));
83 // Command line option to disable multi-region partial-inlining. The default is
84 // false:
85 static cl::opt<bool> DisableMultiRegionPartialInline(
86     "disable-mr-partial-inlining", cl::init(false), cl::Hidden,
87     cl::desc("Disable multi-region partial inlining"));
88 
89 // Command line option to force outlining in regions with live exit variables.
90 // The default is false:
91 static cl::opt<bool>
92     ForceLiveExit("pi-force-live-exit-outline", cl::init(false), cl::Hidden,
93                cl::desc("Force outline regions with live exits"));
94 
95 // Command line option to enable marking outline functions with Cold Calling
96 // Convention. The default is false:
97 static cl::opt<bool>
98     MarkOutlinedColdCC("pi-mark-coldcc", cl::init(false), cl::Hidden,
99                        cl::desc("Mark outline function calls with ColdCC"));
100 
101 #ifndef NDEBUG
102 // Command line option to debug partial-inlining. The default is none:
103 static cl::opt<bool> TracePartialInlining("trace-partial-inlining",
104                                           cl::init(false), cl::Hidden,
105                                           cl::desc("Trace partial inlining."));
106 #endif
107 
108 // This is an option used by testing:
109 static cl::opt<bool> SkipCostAnalysis("skip-partial-inlining-cost-analysis",
110                                       cl::init(false), cl::ZeroOrMore,
111                                       cl::ReallyHidden,
112                                       cl::desc("Skip Cost Analysis"));
113 // Used to determine if a cold region is worth outlining based on
114 // its inlining cost compared to the original function.  Default is set at 10%.
115 // ie. if the cold region reduces the inlining cost of the original function by
116 // at least 10%.
117 static cl::opt<float> MinRegionSizeRatio(
118     "min-region-size-ratio", cl::init(0.1), cl::Hidden,
119     cl::desc("Minimum ratio comparing relative sizes of each "
120              "outline candidate and original function"));
121 // Used to tune the minimum number of execution counts needed in the predecessor
122 // block to the cold edge. ie. confidence interval.
123 static cl::opt<unsigned>
124     MinBlockCounterExecution("min-block-execution", cl::init(100), cl::Hidden,
125                              cl::desc("Minimum block executions to consider "
126                                       "its BranchProbabilityInfo valid"));
127 // Used to determine when an edge is considered cold. Default is set to 10%. ie.
128 // if the branch probability is 10% or less, then it is deemed as 'cold'.
129 static cl::opt<float> ColdBranchRatio(
130     "cold-branch-ratio", cl::init(0.1), cl::Hidden,
131     cl::desc("Minimum BranchProbability to consider a region cold."));
132 
133 static cl::opt<unsigned> MaxNumInlineBlocks(
134     "max-num-inline-blocks", cl::init(5), cl::Hidden,
135     cl::desc("Max number of blocks to be partially inlined"));
136 
137 // Command line option to set the maximum number of partial inlining allowed
138 // for the module. The default value of -1 means no limit.
139 static cl::opt<int> MaxNumPartialInlining(
140     "max-partial-inlining", cl::init(-1), cl::Hidden, cl::ZeroOrMore,
141     cl::desc("Max number of partial inlining. The default is unlimited"));
142 
143 // Used only when PGO or user annotated branch data is absent. It is
144 // the least value that is used to weigh the outline region. If BFI
145 // produces larger value, the BFI value will be used.
146 static cl::opt<int>
147     OutlineRegionFreqPercent("outline-region-freq-percent", cl::init(75),
148                              cl::Hidden, cl::ZeroOrMore,
149                              cl::desc("Relative frequency of outline region to "
150                                       "the entry block"));
151 
152 static cl::opt<unsigned> ExtraOutliningPenalty(
153     "partial-inlining-extra-penalty", cl::init(0), cl::Hidden,
154     cl::desc("A debug option to add additional penalty to the computed one."));
155 
156 namespace {
157 
158 struct FunctionOutliningInfo {
159   FunctionOutliningInfo() = default;
160 
161   // Returns the number of blocks to be inlined including all blocks
162   // in Entries and one return block.
163   unsigned GetNumInlinedBlocks() const { return Entries.size() + 1; }
164 
165   // A set of blocks including the function entry that guard
166   // the region to be outlined.
167   SmallVector<BasicBlock *, 4> Entries;
168 
169   // The return block that is not included in the outlined region.
170   BasicBlock *ReturnBlock = nullptr;
171 
172   // The dominating block of the region to be outlined.
173   BasicBlock *NonReturnBlock = nullptr;
174 
175   // The set of blocks in Entries that that are predecessors to ReturnBlock
176   SmallVector<BasicBlock *, 4> ReturnBlockPreds;
177 };
178 
179 struct FunctionOutliningMultiRegionInfo {
180   FunctionOutliningMultiRegionInfo()
181       : ORI() {}
182 
183   // Container for outline regions
184   struct OutlineRegionInfo {
185     OutlineRegionInfo(SmallVector<BasicBlock *, 8> Region,
186                       BasicBlock *EntryBlock, BasicBlock *ExitBlock,
187                       BasicBlock *ReturnBlock)
188         : Region(Region), EntryBlock(EntryBlock), ExitBlock(ExitBlock),
189           ReturnBlock(ReturnBlock) {}
190     SmallVector<BasicBlock *, 8> Region;
191     BasicBlock *EntryBlock;
192     BasicBlock *ExitBlock;
193     BasicBlock *ReturnBlock;
194   };
195 
196   SmallVector<OutlineRegionInfo, 4> ORI;
197 };
198 
199 struct PartialInlinerImpl {
200 
201   PartialInlinerImpl(
202       std::function<AssumptionCache &(Function &)> *GetAC,
203       std::function<TargetTransformInfo &(Function &)> *GTTI,
204       Optional<function_ref<BlockFrequencyInfo &(Function &)>> GBFI,
205       ProfileSummaryInfo *ProfSI,
206       std::function<OptimizationRemarkEmitter &(Function &)> *GORE)
207       : GetAssumptionCache(GetAC), GetTTI(GTTI), GetBFI(GBFI), PSI(ProfSI),
208         GetORE(GORE) {}
209 
210   bool run(Module &M);
211   // Main part of the transformation that calls helper functions to find
212   // outlining candidates, clone & outline the function, and attempt to
213   // partially inline the resulting function. Returns true if
214   // inlining was successful, false otherwise.  Also returns the outline
215   // function (only if we partially inlined early returns) as there is a
216   // possibility to further "peel" early return statements that were left in the
217   // outline function due to code size.
218   std::pair<bool, Function *> unswitchFunction(Function *F);
219 
220   // This class speculatively clones the the function to be partial inlined.
221   // At the end of partial inlining, the remaining callsites to the cloned
222   // function that are not partially inlined will be fixed up to reference
223   // the original function, and the cloned function will be erased.
224   struct FunctionCloner {
225     // Two constructors, one for single region outlining, the other for
226     // multi-region outlining.
227     FunctionCloner(Function *F, FunctionOutliningInfo *OI,
228                    OptimizationRemarkEmitter &ORE);
229     FunctionCloner(Function *F, FunctionOutliningMultiRegionInfo *OMRI,
230                    OptimizationRemarkEmitter &ORE);
231     ~FunctionCloner();
232 
233     // Prepare for function outlining: making sure there is only
234     // one incoming edge from the extracted/outlined region to
235     // the return block.
236     void NormalizeReturnBlock();
237 
238     // Do function outlining for cold regions.
239     bool doMultiRegionFunctionOutlining();
240     // Do function outlining for region after early return block(s).
241     // NOTE: For vararg functions that do the vararg handling in the outlined
242     //       function, we temporarily generate IR that does not properly
243     //       forward varargs to the outlined function. Calling InlineFunction
244     //       will update calls to the outlined functions to properly forward
245     //       the varargs.
246     Function *doSingleRegionFunctionOutlining();
247 
248     Function *OrigFunc = nullptr;
249     Function *ClonedFunc = nullptr;
250 
251     typedef std::pair<Function *, BasicBlock *> FuncBodyCallerPair;
252     // Keep track of Outlined Functions and the basic block they're called from.
253     SmallVector<FuncBodyCallerPair, 4> OutlinedFunctions;
254 
255     // ClonedFunc is inlined in one of its callers after function
256     // outlining.
257     bool IsFunctionInlined = false;
258     // The cost of the region to be outlined.
259     int OutlinedRegionCost = 0;
260     // ClonedOI is specific to outlining non-early return blocks.
261     std::unique_ptr<FunctionOutliningInfo> ClonedOI = nullptr;
262     // ClonedOMRI is specific to outlining cold regions.
263     std::unique_ptr<FunctionOutliningMultiRegionInfo> ClonedOMRI = nullptr;
264     std::unique_ptr<BlockFrequencyInfo> ClonedFuncBFI = nullptr;
265     OptimizationRemarkEmitter &ORE;
266   };
267 
268 private:
269   int NumPartialInlining = 0;
270   std::function<AssumptionCache &(Function &)> *GetAssumptionCache;
271   std::function<TargetTransformInfo &(Function &)> *GetTTI;
272   Optional<function_ref<BlockFrequencyInfo &(Function &)>> GetBFI;
273   ProfileSummaryInfo *PSI;
274   std::function<OptimizationRemarkEmitter &(Function &)> *GetORE;
275 
276   // Return the frequency of the OutlininingBB relative to F's entry point.
277   // The result is no larger than 1 and is represented using BP.
278   // (Note that the outlined region's 'head' block can only have incoming
279   // edges from the guarding entry blocks).
280   BranchProbability getOutliningCallBBRelativeFreq(FunctionCloner &Cloner);
281 
282   // Return true if the callee of CS should be partially inlined with
283   // profit.
284   bool shouldPartialInline(CallSite CS, FunctionCloner &Cloner,
285                            BlockFrequency WeightedOutliningRcost);
286 
287   // Try to inline DuplicateFunction (cloned from F with call to
288   // the OutlinedFunction into its callers. Return true
289   // if there is any successful inlining.
290   bool tryPartialInline(FunctionCloner &Cloner);
291 
292   // Compute the mapping from use site of DuplicationFunction to the enclosing
293   // BB's profile count.
294   void computeCallsiteToProfCountMap(Function *DuplicateFunction,
295                                      DenseMap<User *, uint64_t> &SiteCountMap);
296 
297   bool IsLimitReached() {
298     return (MaxNumPartialInlining != -1 &&
299             NumPartialInlining >= MaxNumPartialInlining);
300   }
301 
302   static CallSite getCallSite(User *U) {
303     CallSite CS;
304     if (CallInst *CI = dyn_cast<CallInst>(U))
305       CS = CallSite(CI);
306     else if (InvokeInst *II = dyn_cast<InvokeInst>(U))
307       CS = CallSite(II);
308     else
309       llvm_unreachable("All uses must be calls");
310     return CS;
311   }
312 
313   static CallSite getOneCallSiteTo(Function *F) {
314     User *User = *F->user_begin();
315     return getCallSite(User);
316   }
317 
318   std::tuple<DebugLoc, BasicBlock *> getOneDebugLoc(Function *F) {
319     CallSite CS = getOneCallSiteTo(F);
320     DebugLoc DLoc = CS.getInstruction()->getDebugLoc();
321     BasicBlock *Block = CS.getParent();
322     return std::make_tuple(DLoc, Block);
323   }
324 
325   // Returns the costs associated with function outlining:
326   // - The first value is the non-weighted runtime cost for making the call
327   //   to the outlined function, including the addtional  setup cost in the
328   //    outlined function itself;
329   // - The second value is the estimated size of the new call sequence in
330   //   basic block Cloner.OutliningCallBB;
331   std::tuple<int, int> computeOutliningCosts(FunctionCloner &Cloner);
332 
333   // Compute the 'InlineCost' of block BB. InlineCost is a proxy used to
334   // approximate both the size and runtime cost (Note that in the current
335   // inline cost analysis, there is no clear distinction there either).
336   static int computeBBInlineCost(BasicBlock *BB);
337 
338   std::unique_ptr<FunctionOutliningInfo> computeOutliningInfo(Function *F);
339   std::unique_ptr<FunctionOutliningMultiRegionInfo>
340   computeOutliningColdRegionsInfo(Function *F);
341 };
342 
343 struct PartialInlinerLegacyPass : public ModulePass {
344   static char ID; // Pass identification, replacement for typeid
345 
346   PartialInlinerLegacyPass() : ModulePass(ID) {
347     initializePartialInlinerLegacyPassPass(*PassRegistry::getPassRegistry());
348   }
349 
350   void getAnalysisUsage(AnalysisUsage &AU) const override {
351     AU.addRequired<AssumptionCacheTracker>();
352     AU.addRequired<ProfileSummaryInfoWrapperPass>();
353     AU.addRequired<TargetTransformInfoWrapperPass>();
354   }
355 
356   bool runOnModule(Module &M) override {
357     if (skipModule(M))
358       return false;
359 
360     AssumptionCacheTracker *ACT = &getAnalysis<AssumptionCacheTracker>();
361     TargetTransformInfoWrapperPass *TTIWP =
362         &getAnalysis<TargetTransformInfoWrapperPass>();
363     ProfileSummaryInfo *PSI =
364         getAnalysis<ProfileSummaryInfoWrapperPass>().getPSI();
365     std::unique_ptr<OptimizationRemarkEmitter> UPORE;
366 
367     std::function<AssumptionCache &(Function &)> GetAssumptionCache =
368         [&ACT](Function &F) -> AssumptionCache & {
369       return ACT->getAssumptionCache(F);
370     };
371 
372     std::function<TargetTransformInfo &(Function &)> GetTTI =
373         [&TTIWP](Function &F) -> TargetTransformInfo & {
374       return TTIWP->getTTI(F);
375     };
376 
377     std::function<OptimizationRemarkEmitter &(Function &)> GetORE =
378         [&UPORE](Function &F) -> OptimizationRemarkEmitter & {
379       UPORE.reset(new OptimizationRemarkEmitter(&F));
380       return *UPORE.get();
381     };
382 
383     return PartialInlinerImpl(&GetAssumptionCache, &GetTTI, NoneType::None, PSI,
384                               &GetORE)
385         .run(M);
386   }
387 };
388 
389 } // end anonymous namespace
390 
391 std::unique_ptr<FunctionOutliningMultiRegionInfo>
392 PartialInlinerImpl::computeOutliningColdRegionsInfo(Function *F) {
393   BasicBlock *EntryBlock = &F->front();
394 
395   DominatorTree DT(*F);
396   LoopInfo LI(DT);
397   BranchProbabilityInfo BPI(*F, LI);
398   std::unique_ptr<BlockFrequencyInfo> ScopedBFI;
399   BlockFrequencyInfo *BFI;
400   if (!GetBFI) {
401     ScopedBFI.reset(new BlockFrequencyInfo(*F, BPI, LI));
402     BFI = ScopedBFI.get();
403   } else
404     BFI = &(*GetBFI)(*F);
405 
406   auto &ORE = (*GetORE)(*F);
407 
408   // Return if we don't have profiling information.
409   if (!PSI->hasInstrumentationProfile())
410     return std::unique_ptr<FunctionOutliningMultiRegionInfo>();
411 
412   std::unique_ptr<FunctionOutliningMultiRegionInfo> OutliningInfo =
413       llvm::make_unique<FunctionOutliningMultiRegionInfo>();
414 
415   auto IsSingleEntry = [](SmallVectorImpl<BasicBlock *> &BlockList) {
416     BasicBlock *Dom = BlockList.front();
417     return BlockList.size() > 1 &&
418            std::distance(pred_begin(Dom), pred_end(Dom)) == 1;
419   };
420 
421   auto IsSingleExit =
422       [&ORE](SmallVectorImpl<BasicBlock *> &BlockList) -> BasicBlock * {
423     BasicBlock *ExitBlock = nullptr;
424     for (auto *Block : BlockList) {
425       for (auto SI = succ_begin(Block); SI != succ_end(Block); ++SI) {
426         if (!is_contained(BlockList, *SI)) {
427           if (ExitBlock) {
428             ORE.emit([&]() {
429               return OptimizationRemarkMissed(DEBUG_TYPE, "MultiExitRegion",
430                                               &SI->front())
431                      << "Region dominated by "
432                      << ore::NV("Block", BlockList.front()->getName())
433                      << " has more than one region exit edge.";
434             });
435             return nullptr;
436           } else
437             ExitBlock = Block;
438         }
439       }
440     }
441     return ExitBlock;
442   };
443 
444   auto BBProfileCount = [BFI](BasicBlock *BB) {
445     return BFI->getBlockProfileCount(BB)
446                ? BFI->getBlockProfileCount(BB).getValue()
447                : 0;
448   };
449 
450   // Use the same computeBBInlineCost function to compute the cost savings of
451   // the outlining the candidate region.
452   int OverallFunctionCost = 0;
453   for (auto &BB : *F)
454     OverallFunctionCost += computeBBInlineCost(&BB);
455 
456 #ifndef NDEBUG
457   if (TracePartialInlining)
458     dbgs() << "OverallFunctionCost = " << OverallFunctionCost << "\n";
459 #endif
460   int MinOutlineRegionCost =
461       static_cast<int>(OverallFunctionCost * MinRegionSizeRatio);
462   BranchProbability MinBranchProbability(
463       static_cast<int>(ColdBranchRatio * MinBlockCounterExecution),
464       MinBlockCounterExecution);
465   bool ColdCandidateFound = false;
466   BasicBlock *CurrEntry = EntryBlock;
467   std::vector<BasicBlock *> DFS;
468   DenseMap<BasicBlock *, bool> VisitedMap;
469   DFS.push_back(CurrEntry);
470   VisitedMap[CurrEntry] = true;
471   // Use Depth First Search on the basic blocks to find CFG edges that are
472   // considered cold.
473   // Cold regions considered must also have its inline cost compared to the
474   // overall inline cost of the original function.  The region is outlined only
475   // if it reduced the inline cost of the function by 'MinOutlineRegionCost' or
476   // more.
477   while (!DFS.empty()) {
478     auto *thisBB = DFS.back();
479     DFS.pop_back();
480     // Only consider regions with predecessor blocks that are considered
481     // not-cold (default: part of the top 99.99% of all block counters)
482     // AND greater than our minimum block execution count (default: 100).
483     if (PSI->isColdBB(thisBB, BFI) ||
484         BBProfileCount(thisBB) < MinBlockCounterExecution)
485       continue;
486     for (auto SI = succ_begin(thisBB); SI != succ_end(thisBB); ++SI) {
487       if (VisitedMap[*SI])
488         continue;
489       VisitedMap[*SI] = true;
490       DFS.push_back(*SI);
491       // If branch isn't cold, we skip to the next one.
492       BranchProbability SuccProb = BPI.getEdgeProbability(thisBB, *SI);
493       if (SuccProb > MinBranchProbability)
494         continue;
495 #ifndef NDEBUG
496       if (TracePartialInlining) {
497         dbgs() << "Found cold edge: " << thisBB->getName() << "->"
498                << (*SI)->getName() << "\nBranch Probability = " << SuccProb
499                << "\n";
500       }
501 #endif
502       SmallVector<BasicBlock *, 8> DominateVector;
503       DT.getDescendants(*SI, DominateVector);
504       // We can only outline single entry regions (for now).
505       if (!IsSingleEntry(DominateVector))
506         continue;
507       BasicBlock *ExitBlock = nullptr;
508       // We can only outline single exit regions (for now).
509       if (!(ExitBlock = IsSingleExit(DominateVector)))
510         continue;
511       int OutlineRegionCost = 0;
512       for (auto *BB : DominateVector)
513         OutlineRegionCost += computeBBInlineCost(BB);
514 
515 #ifndef NDEBUG
516       if (TracePartialInlining)
517         dbgs() << "OutlineRegionCost = " << OutlineRegionCost << "\n";
518 #endif
519 
520       if (OutlineRegionCost < MinOutlineRegionCost) {
521         ORE.emit([&]() {
522           return OptimizationRemarkAnalysis(DEBUG_TYPE, "TooCostly",
523                                             &SI->front())
524                  << ore::NV("Callee", F) << " inline cost-savings smaller than "
525                  << ore::NV("Cost", MinOutlineRegionCost);
526         });
527         continue;
528       }
529       // For now, ignore blocks that belong to a SISE region that is a
530       // candidate for outlining.  In the future, we may want to look
531       // at inner regions because the outer region may have live-exit
532       // variables.
533       for (auto *BB : DominateVector)
534         VisitedMap[BB] = true;
535       // ReturnBlock here means the block after the outline call
536       BasicBlock *ReturnBlock = ExitBlock->getSingleSuccessor();
537       // assert(ReturnBlock && "ReturnBlock is NULL somehow!");
538       FunctionOutliningMultiRegionInfo::OutlineRegionInfo RegInfo(
539           DominateVector, DominateVector.front(), ExitBlock, ReturnBlock);
540       RegInfo.Region = DominateVector;
541       OutliningInfo->ORI.push_back(RegInfo);
542 #ifndef NDEBUG
543       if (TracePartialInlining) {
544         dbgs() << "Found Cold Candidate starting at block: "
545                << DominateVector.front()->getName() << "\n";
546       }
547 #endif
548       ColdCandidateFound = true;
549       NumColdRegionsFound++;
550     }
551   }
552   if (ColdCandidateFound)
553     return OutliningInfo;
554   else
555     return std::unique_ptr<FunctionOutliningMultiRegionInfo>();
556 }
557 
558 std::unique_ptr<FunctionOutliningInfo>
559 PartialInlinerImpl::computeOutliningInfo(Function *F) {
560   BasicBlock *EntryBlock = &F->front();
561   BranchInst *BR = dyn_cast<BranchInst>(EntryBlock->getTerminator());
562   if (!BR || BR->isUnconditional())
563     return std::unique_ptr<FunctionOutliningInfo>();
564 
565   // Returns true if Succ is BB's successor
566   auto IsSuccessor = [](BasicBlock *Succ, BasicBlock *BB) {
567     return is_contained(successors(BB), Succ);
568   };
569 
570   auto SuccSize = [](BasicBlock *BB) {
571     return std::distance(succ_begin(BB), succ_end(BB));
572   };
573 
574   auto IsReturnBlock = [](BasicBlock *BB) {
575     TerminatorInst *TI = BB->getTerminator();
576     return isa<ReturnInst>(TI);
577   };
578 
579   auto GetReturnBlock = [&](BasicBlock *Succ1, BasicBlock *Succ2) {
580     if (IsReturnBlock(Succ1))
581       return std::make_tuple(Succ1, Succ2);
582     if (IsReturnBlock(Succ2))
583       return std::make_tuple(Succ2, Succ1);
584 
585     return std::make_tuple<BasicBlock *, BasicBlock *>(nullptr, nullptr);
586   };
587 
588   // Detect a triangular shape:
589   auto GetCommonSucc = [&](BasicBlock *Succ1, BasicBlock *Succ2) {
590     if (IsSuccessor(Succ1, Succ2))
591       return std::make_tuple(Succ1, Succ2);
592     if (IsSuccessor(Succ2, Succ1))
593       return std::make_tuple(Succ2, Succ1);
594 
595     return std::make_tuple<BasicBlock *, BasicBlock *>(nullptr, nullptr);
596   };
597 
598   std::unique_ptr<FunctionOutliningInfo> OutliningInfo =
599       llvm::make_unique<FunctionOutliningInfo>();
600 
601   BasicBlock *CurrEntry = EntryBlock;
602   bool CandidateFound = false;
603   do {
604     // The number of blocks to be inlined has already reached
605     // the limit. When MaxNumInlineBlocks is set to 0 or 1, this
606     // disables partial inlining for the function.
607     if (OutliningInfo->GetNumInlinedBlocks() >= MaxNumInlineBlocks)
608       break;
609 
610     if (SuccSize(CurrEntry) != 2)
611       break;
612 
613     BasicBlock *Succ1 = *succ_begin(CurrEntry);
614     BasicBlock *Succ2 = *(succ_begin(CurrEntry) + 1);
615 
616     BasicBlock *ReturnBlock, *NonReturnBlock;
617     std::tie(ReturnBlock, NonReturnBlock) = GetReturnBlock(Succ1, Succ2);
618 
619     if (ReturnBlock) {
620       OutliningInfo->Entries.push_back(CurrEntry);
621       OutliningInfo->ReturnBlock = ReturnBlock;
622       OutliningInfo->NonReturnBlock = NonReturnBlock;
623       CandidateFound = true;
624       break;
625     }
626 
627     BasicBlock *CommSucc;
628     BasicBlock *OtherSucc;
629     std::tie(CommSucc, OtherSucc) = GetCommonSucc(Succ1, Succ2);
630 
631     if (!CommSucc)
632       break;
633 
634     OutliningInfo->Entries.push_back(CurrEntry);
635     CurrEntry = OtherSucc;
636   } while (true);
637 
638   if (!CandidateFound)
639     return std::unique_ptr<FunctionOutliningInfo>();
640 
641   // Do sanity check of the entries: threre should not
642   // be any successors (not in the entry set) other than
643   // {ReturnBlock, NonReturnBlock}
644   assert(OutliningInfo->Entries[0] == &F->front() &&
645          "Function Entry must be the first in Entries vector");
646   DenseSet<BasicBlock *> Entries;
647   for (BasicBlock *E : OutliningInfo->Entries)
648     Entries.insert(E);
649 
650   // Returns true of BB has Predecessor which is not
651   // in Entries set.
652   auto HasNonEntryPred = [Entries](BasicBlock *BB) {
653     for (auto Pred : predecessors(BB)) {
654       if (!Entries.count(Pred))
655         return true;
656     }
657     return false;
658   };
659   auto CheckAndNormalizeCandidate =
660       [Entries, HasNonEntryPred](FunctionOutliningInfo *OutliningInfo) {
661         for (BasicBlock *E : OutliningInfo->Entries) {
662           for (auto Succ : successors(E)) {
663             if (Entries.count(Succ))
664               continue;
665             if (Succ == OutliningInfo->ReturnBlock)
666               OutliningInfo->ReturnBlockPreds.push_back(E);
667             else if (Succ != OutliningInfo->NonReturnBlock)
668               return false;
669           }
670           // There should not be any outside incoming edges either:
671           if (HasNonEntryPred(E))
672             return false;
673         }
674         return true;
675       };
676 
677   if (!CheckAndNormalizeCandidate(OutliningInfo.get()))
678     return std::unique_ptr<FunctionOutliningInfo>();
679 
680   // Now further growing the candidate's inlining region by
681   // peeling off dominating blocks from the outlining region:
682   while (OutliningInfo->GetNumInlinedBlocks() < MaxNumInlineBlocks) {
683     BasicBlock *Cand = OutliningInfo->NonReturnBlock;
684     if (SuccSize(Cand) != 2)
685       break;
686 
687     if (HasNonEntryPred(Cand))
688       break;
689 
690     BasicBlock *Succ1 = *succ_begin(Cand);
691     BasicBlock *Succ2 = *(succ_begin(Cand) + 1);
692 
693     BasicBlock *ReturnBlock, *NonReturnBlock;
694     std::tie(ReturnBlock, NonReturnBlock) = GetReturnBlock(Succ1, Succ2);
695     if (!ReturnBlock || ReturnBlock != OutliningInfo->ReturnBlock)
696       break;
697 
698     if (NonReturnBlock->getSinglePredecessor() != Cand)
699       break;
700 
701     // Now grow and update OutlininigInfo:
702     OutliningInfo->Entries.push_back(Cand);
703     OutliningInfo->NonReturnBlock = NonReturnBlock;
704     OutliningInfo->ReturnBlockPreds.push_back(Cand);
705     Entries.insert(Cand);
706   }
707 
708   return OutliningInfo;
709 }
710 
711 // Check if there is PGO data or user annoated branch data:
712 static bool hasProfileData(Function *F, FunctionOutliningInfo *OI) {
713   if (F->getEntryCount())
714     return true;
715   // Now check if any of the entry block has MD_prof data:
716   for (auto *E : OI->Entries) {
717     BranchInst *BR = dyn_cast<BranchInst>(E->getTerminator());
718     if (!BR || BR->isUnconditional())
719       continue;
720     uint64_t T, F;
721     if (BR->extractProfMetadata(T, F))
722       return true;
723   }
724   return false;
725 }
726 
727 BranchProbability
728 PartialInlinerImpl::getOutliningCallBBRelativeFreq(FunctionCloner &Cloner) {
729   BasicBlock *OutliningCallBB = Cloner.OutlinedFunctions.back().second;
730   auto EntryFreq =
731       Cloner.ClonedFuncBFI->getBlockFreq(&Cloner.ClonedFunc->getEntryBlock());
732   auto OutliningCallFreq =
733       Cloner.ClonedFuncBFI->getBlockFreq(OutliningCallBB);
734   // FIXME Hackery needed because ClonedFuncBFI is based on the function BEFORE
735   // we outlined any regions, so we may encounter situations where the
736   // OutliningCallFreq is *slightly* bigger than the EntryFreq.
737   if (OutliningCallFreq.getFrequency() > EntryFreq.getFrequency()) {
738     OutliningCallFreq = EntryFreq;
739   }
740   auto OutlineRegionRelFreq = BranchProbability::getBranchProbability(
741       OutliningCallFreq.getFrequency(), EntryFreq.getFrequency());
742 
743   if (hasProfileData(Cloner.OrigFunc, Cloner.ClonedOI.get()))
744     return OutlineRegionRelFreq;
745 
746   // When profile data is not available, we need to be conservative in
747   // estimating the overall savings. Static branch prediction can usually
748   // guess the branch direction right (taken/non-taken), but the guessed
749   // branch probability is usually not biased enough. In case when the
750   // outlined region is predicted to be likely, its probability needs
751   // to be made higher (more biased) to not under-estimate the cost of
752   // function outlining. On the other hand, if the outlined region
753   // is predicted to be less likely, the predicted probablity is usually
754   // higher than the actual. For instance, the actual probability of the
755   // less likely target is only 5%, but the guessed probablity can be
756   // 40%. In the latter case, there is no need for further adjustement.
757   // FIXME: add an option for this.
758   if (OutlineRegionRelFreq < BranchProbability(45, 100))
759     return OutlineRegionRelFreq;
760 
761   OutlineRegionRelFreq = std::max(
762       OutlineRegionRelFreq, BranchProbability(OutlineRegionFreqPercent, 100));
763 
764   return OutlineRegionRelFreq;
765 }
766 
767 bool PartialInlinerImpl::shouldPartialInline(
768     CallSite CS, FunctionCloner &Cloner,
769     BlockFrequency WeightedOutliningRcost) {
770   using namespace ore;
771 
772   if (SkipCostAnalysis)
773     return true;
774 
775   Instruction *Call = CS.getInstruction();
776   Function *Callee = CS.getCalledFunction();
777   assert(Callee == Cloner.ClonedFunc);
778 
779   Function *Caller = CS.getCaller();
780   auto &CalleeTTI = (*GetTTI)(*Callee);
781   auto &ORE = (*GetORE)(*Caller);
782   InlineCost IC = getInlineCost(CS, getInlineParams(), CalleeTTI,
783                                 *GetAssumptionCache, GetBFI, PSI, &ORE);
784 
785   if (IC.isAlways()) {
786     ORE.emit([&]() {
787       return OptimizationRemarkAnalysis(DEBUG_TYPE, "AlwaysInline", Call)
788              << NV("Callee", Cloner.OrigFunc)
789              << " should always be fully inlined, not partially";
790     });
791     return false;
792   }
793 
794   if (IC.isNever()) {
795     ORE.emit([&]() {
796       return OptimizationRemarkMissed(DEBUG_TYPE, "NeverInline", Call)
797              << NV("Callee", Cloner.OrigFunc) << " not partially inlined into "
798              << NV("Caller", Caller)
799              << " because it should never be inlined (cost=never)";
800     });
801     return false;
802   }
803 
804   if (!IC) {
805     ORE.emit([&]() {
806       return OptimizationRemarkAnalysis(DEBUG_TYPE, "TooCostly", Call)
807              << NV("Callee", Cloner.OrigFunc) << " not partially inlined into "
808              << NV("Caller", Caller) << " because too costly to inline (cost="
809              << NV("Cost", IC.getCost()) << ", threshold="
810              << NV("Threshold", IC.getCostDelta() + IC.getCost()) << ")";
811     });
812     return false;
813   }
814   const DataLayout &DL = Caller->getParent()->getDataLayout();
815 
816   // The savings of eliminating the call:
817   int NonWeightedSavings = getCallsiteCost(CS, DL);
818   BlockFrequency NormWeightedSavings(NonWeightedSavings);
819 
820   // Weighted saving is smaller than weighted cost, return false
821   if (NormWeightedSavings < WeightedOutliningRcost) {
822     ORE.emit([&]() {
823       return OptimizationRemarkAnalysis(DEBUG_TYPE, "OutliningCallcostTooHigh",
824                                         Call)
825              << NV("Callee", Cloner.OrigFunc) << " not partially inlined into "
826              << NV("Caller", Caller) << " runtime overhead (overhead="
827              << NV("Overhead", (unsigned)WeightedOutliningRcost.getFrequency())
828              << ", savings="
829              << NV("Savings", (unsigned)NormWeightedSavings.getFrequency())
830              << ")"
831              << " of making the outlined call is too high";
832     });
833 
834     return false;
835   }
836 
837   ORE.emit([&]() {
838     return OptimizationRemarkAnalysis(DEBUG_TYPE, "CanBePartiallyInlined", Call)
839            << NV("Callee", Cloner.OrigFunc) << " can be partially inlined into "
840            << NV("Caller", Caller) << " with cost=" << NV("Cost", IC.getCost())
841            << " (threshold="
842            << NV("Threshold", IC.getCostDelta() + IC.getCost()) << ")";
843   });
844   return true;
845 }
846 
847 // TODO: Ideally  we should share Inliner's InlineCost Analysis code.
848 // For now use a simplified version. The returned 'InlineCost' will be used
849 // to esimate the size cost as well as runtime cost of the BB.
850 int PartialInlinerImpl::computeBBInlineCost(BasicBlock *BB) {
851   int InlineCost = 0;
852   const DataLayout &DL = BB->getParent()->getParent()->getDataLayout();
853   for (BasicBlock::iterator I = BB->begin(), E = BB->end(); I != E; ++I) {
854     if (isa<DbgInfoIntrinsic>(I))
855       continue;
856 
857     switch (I->getOpcode()) {
858     case Instruction::BitCast:
859     case Instruction::PtrToInt:
860     case Instruction::IntToPtr:
861     case Instruction::Alloca:
862       continue;
863     case Instruction::GetElementPtr:
864       if (cast<GetElementPtrInst>(I)->hasAllZeroIndices())
865         continue;
866     default:
867       break;
868     }
869 
870     IntrinsicInst *IntrInst = dyn_cast<IntrinsicInst>(I);
871     if (IntrInst) {
872       if (IntrInst->getIntrinsicID() == Intrinsic::lifetime_start ||
873           IntrInst->getIntrinsicID() == Intrinsic::lifetime_end)
874         continue;
875     }
876 
877     if (CallInst *CI = dyn_cast<CallInst>(I)) {
878       InlineCost += getCallsiteCost(CallSite(CI), DL);
879       continue;
880     }
881 
882     if (InvokeInst *II = dyn_cast<InvokeInst>(I)) {
883       InlineCost += getCallsiteCost(CallSite(II), DL);
884       continue;
885     }
886 
887     if (SwitchInst *SI = dyn_cast<SwitchInst>(I)) {
888       InlineCost += (SI->getNumCases() + 1) * InlineConstants::InstrCost;
889       continue;
890     }
891     InlineCost += InlineConstants::InstrCost;
892   }
893   return InlineCost;
894 }
895 
896 std::tuple<int, int>
897 PartialInlinerImpl::computeOutliningCosts(FunctionCloner &Cloner) {
898   int OutliningFuncCallCost = 0, OutlinedFunctionCost = 0;
899   for (auto FuncBBPair : Cloner.OutlinedFunctions) {
900     Function *OutlinedFunc = FuncBBPair.first;
901     BasicBlock* OutliningCallBB = FuncBBPair.second;
902     // Now compute the cost of the call sequence to the outlined function
903     // 'OutlinedFunction' in BB 'OutliningCallBB':
904     OutliningFuncCallCost += computeBBInlineCost(OutliningCallBB);
905 
906     // Now compute the cost of the extracted/outlined function itself:
907     for (BasicBlock &BB : *OutlinedFunc)
908       OutlinedFunctionCost += computeBBInlineCost(&BB);
909   }
910   assert(OutlinedFunctionCost >= Cloner.OutlinedRegionCost &&
911          "Outlined function cost should be no less than the outlined region");
912 
913   // The code extractor introduces a new root and exit stub blocks with
914   // additional unconditional branches. Those branches will be eliminated
915   // later with bb layout. The cost should be adjusted accordingly:
916   OutlinedFunctionCost -=
917       2 * InlineConstants::InstrCost * Cloner.OutlinedFunctions.size();
918 
919   int OutliningRuntimeOverhead =
920       OutliningFuncCallCost +
921       (OutlinedFunctionCost - Cloner.OutlinedRegionCost) +
922       ExtraOutliningPenalty;
923 
924   return std::make_tuple(OutliningFuncCallCost, OutliningRuntimeOverhead);
925 }
926 
927 // Create the callsite to profile count map which is
928 // used to update the original function's entry count,
929 // after the function is partially inlined into the callsite.
930 void PartialInlinerImpl::computeCallsiteToProfCountMap(
931     Function *DuplicateFunction,
932     DenseMap<User *, uint64_t> &CallSiteToProfCountMap) {
933   std::vector<User *> Users(DuplicateFunction->user_begin(),
934                             DuplicateFunction->user_end());
935   Function *CurrentCaller = nullptr;
936   std::unique_ptr<BlockFrequencyInfo> TempBFI;
937   BlockFrequencyInfo *CurrentCallerBFI = nullptr;
938 
939   auto ComputeCurrBFI = [&,this](Function *Caller) {
940       // For the old pass manager:
941       if (!GetBFI) {
942         DominatorTree DT(*Caller);
943         LoopInfo LI(DT);
944         BranchProbabilityInfo BPI(*Caller, LI);
945         TempBFI.reset(new BlockFrequencyInfo(*Caller, BPI, LI));
946         CurrentCallerBFI = TempBFI.get();
947       } else {
948         // New pass manager:
949         CurrentCallerBFI = &(*GetBFI)(*Caller);
950       }
951   };
952 
953   for (User *User : Users) {
954     CallSite CS = getCallSite(User);
955     Function *Caller = CS.getCaller();
956     if (CurrentCaller != Caller) {
957       CurrentCaller = Caller;
958       ComputeCurrBFI(Caller);
959     } else {
960       assert(CurrentCallerBFI && "CallerBFI is not set");
961     }
962     BasicBlock *CallBB = CS.getInstruction()->getParent();
963     auto Count = CurrentCallerBFI->getBlockProfileCount(CallBB);
964     if (Count)
965       CallSiteToProfCountMap[User] = *Count;
966     else
967       CallSiteToProfCountMap[User] = 0;
968   }
969 }
970 
971 PartialInlinerImpl::FunctionCloner::FunctionCloner(
972     Function *F, FunctionOutliningInfo *OI, OptimizationRemarkEmitter &ORE)
973     : OrigFunc(F), ORE(ORE) {
974   ClonedOI = llvm::make_unique<FunctionOutliningInfo>();
975 
976   // Clone the function, so that we can hack away on it.
977   ValueToValueMapTy VMap;
978   ClonedFunc = CloneFunction(F, VMap);
979 
980   ClonedOI->ReturnBlock = cast<BasicBlock>(VMap[OI->ReturnBlock]);
981   ClonedOI->NonReturnBlock = cast<BasicBlock>(VMap[OI->NonReturnBlock]);
982   for (BasicBlock *BB : OI->Entries) {
983     ClonedOI->Entries.push_back(cast<BasicBlock>(VMap[BB]));
984   }
985   for (BasicBlock *E : OI->ReturnBlockPreds) {
986     BasicBlock *NewE = cast<BasicBlock>(VMap[E]);
987     ClonedOI->ReturnBlockPreds.push_back(NewE);
988   }
989   // Go ahead and update all uses to the duplicate, so that we can just
990   // use the inliner functionality when we're done hacking.
991   F->replaceAllUsesWith(ClonedFunc);
992 }
993 
994 PartialInlinerImpl::FunctionCloner::FunctionCloner(
995     Function *F, FunctionOutliningMultiRegionInfo *OI,
996     OptimizationRemarkEmitter &ORE)
997     : OrigFunc(F), ORE(ORE) {
998   ClonedOMRI = llvm::make_unique<FunctionOutliningMultiRegionInfo>();
999 
1000   // Clone the function, so that we can hack away on it.
1001   ValueToValueMapTy VMap;
1002   ClonedFunc = CloneFunction(F, VMap);
1003 
1004   // Go through all Outline Candidate Regions and update all BasicBlock
1005   // information.
1006   for (FunctionOutliningMultiRegionInfo::OutlineRegionInfo RegionInfo :
1007        OI->ORI) {
1008     SmallVector<BasicBlock *, 8> Region;
1009     for (BasicBlock *BB : RegionInfo.Region) {
1010       Region.push_back(cast<BasicBlock>(VMap[BB]));
1011     }
1012     BasicBlock *NewEntryBlock = cast<BasicBlock>(VMap[RegionInfo.EntryBlock]);
1013     BasicBlock *NewExitBlock = cast<BasicBlock>(VMap[RegionInfo.ExitBlock]);
1014     BasicBlock *NewReturnBlock = nullptr;
1015     if (RegionInfo.ReturnBlock)
1016       NewReturnBlock = cast<BasicBlock>(VMap[RegionInfo.ReturnBlock]);
1017     FunctionOutliningMultiRegionInfo::OutlineRegionInfo MappedRegionInfo(
1018         Region, NewEntryBlock, NewExitBlock, NewReturnBlock);
1019     ClonedOMRI->ORI.push_back(MappedRegionInfo);
1020   }
1021   // Go ahead and update all uses to the duplicate, so that we can just
1022   // use the inliner functionality when we're done hacking.
1023   F->replaceAllUsesWith(ClonedFunc);
1024 }
1025 
1026 void PartialInlinerImpl::FunctionCloner::NormalizeReturnBlock() {
1027   auto getFirstPHI = [](BasicBlock *BB) {
1028     BasicBlock::iterator I = BB->begin();
1029     PHINode *FirstPhi = nullptr;
1030     while (I != BB->end()) {
1031       PHINode *Phi = dyn_cast<PHINode>(I);
1032       if (!Phi)
1033         break;
1034       if (!FirstPhi) {
1035         FirstPhi = Phi;
1036         break;
1037       }
1038     }
1039     return FirstPhi;
1040   };
1041 
1042   // Shouldn't need to normalize PHIs if we're not outlining non-early return
1043   // blocks.
1044   if (!ClonedOI)
1045     return;
1046 
1047   // Special hackery is needed with PHI nodes that have inputs from more than
1048   // one extracted block.  For simplicity, just split the PHIs into a two-level
1049   // sequence of PHIs, some of which will go in the extracted region, and some
1050   // of which will go outside.
1051   BasicBlock *PreReturn = ClonedOI->ReturnBlock;
1052   // only split block when necessary:
1053   PHINode *FirstPhi = getFirstPHI(PreReturn);
1054   unsigned NumPredsFromEntries = ClonedOI->ReturnBlockPreds.size();
1055 
1056   if (!FirstPhi || FirstPhi->getNumIncomingValues() <= NumPredsFromEntries + 1)
1057     return;
1058 
1059   auto IsTrivialPhi = [](PHINode *PN) -> Value * {
1060     Value *CommonValue = PN->getIncomingValue(0);
1061     if (all_of(PN->incoming_values(),
1062                [&](Value *V) { return V == CommonValue; }))
1063       return CommonValue;
1064     return nullptr;
1065   };
1066 
1067   ClonedOI->ReturnBlock = ClonedOI->ReturnBlock->splitBasicBlock(
1068       ClonedOI->ReturnBlock->getFirstNonPHI()->getIterator());
1069   BasicBlock::iterator I = PreReturn->begin();
1070   Instruction *Ins = &ClonedOI->ReturnBlock->front();
1071   SmallVector<Instruction *, 4> DeadPhis;
1072   while (I != PreReturn->end()) {
1073     PHINode *OldPhi = dyn_cast<PHINode>(I);
1074     if (!OldPhi)
1075       break;
1076 
1077     PHINode *RetPhi =
1078         PHINode::Create(OldPhi->getType(), NumPredsFromEntries + 1, "", Ins);
1079     OldPhi->replaceAllUsesWith(RetPhi);
1080     Ins = ClonedOI->ReturnBlock->getFirstNonPHI();
1081 
1082     RetPhi->addIncoming(&*I, PreReturn);
1083     for (BasicBlock *E : ClonedOI->ReturnBlockPreds) {
1084       RetPhi->addIncoming(OldPhi->getIncomingValueForBlock(E), E);
1085       OldPhi->removeIncomingValue(E);
1086     }
1087 
1088     // After incoming values splitting, the old phi may become trivial.
1089     // Keeping the trivial phi can introduce definition inside the outline
1090     // region which is live-out, causing necessary overhead (load, store
1091     // arg passing etc).
1092     if (auto *OldPhiVal = IsTrivialPhi(OldPhi)) {
1093       OldPhi->replaceAllUsesWith(OldPhiVal);
1094       DeadPhis.push_back(OldPhi);
1095     }
1096     ++I;
1097   }
1098   for (auto *DP : DeadPhis)
1099     DP->eraseFromParent();
1100 
1101   for (auto E : ClonedOI->ReturnBlockPreds) {
1102     E->getTerminator()->replaceUsesOfWith(PreReturn, ClonedOI->ReturnBlock);
1103   }
1104 }
1105 
1106 bool PartialInlinerImpl::FunctionCloner::doMultiRegionFunctionOutlining() {
1107 
1108   auto ComputeRegionCost = [](SmallVectorImpl<BasicBlock *> &Region) {
1109     int Cost = 0;
1110     for (BasicBlock* BB : Region)
1111       Cost += computeBBInlineCost(BB);
1112     return Cost;
1113   };
1114 
1115   assert(ClonedOMRI && "Expecting OutlineInfo for multi region outline");
1116 
1117   if (ClonedOMRI->ORI.empty())
1118     return false;
1119 
1120   // The CodeExtractor needs a dominator tree.
1121   DominatorTree DT;
1122   DT.recalculate(*ClonedFunc);
1123 
1124   // Manually calculate a BlockFrequencyInfo and BranchProbabilityInfo.
1125   LoopInfo LI(DT);
1126   BranchProbabilityInfo BPI(*ClonedFunc, LI);
1127   ClonedFuncBFI.reset(new BlockFrequencyInfo(*ClonedFunc, BPI, LI));
1128 
1129   SetVector<Value *> Inputs, Outputs, Sinks;
1130   for (FunctionOutliningMultiRegionInfo::OutlineRegionInfo RegionInfo :
1131        ClonedOMRI->ORI) {
1132     int CurrentOutlinedRegionCost = ComputeRegionCost(RegionInfo.Region);
1133 
1134     CodeExtractor CE(RegionInfo.Region, &DT, /*AggregateArgs*/ false,
1135                      ClonedFuncBFI.get(), &BPI, /* AllowVarargs */ false);
1136 
1137     CE.findInputsOutputs(Inputs, Outputs, Sinks);
1138 
1139 #ifndef NDEBUG
1140     if (TracePartialInlining) {
1141       dbgs() << "inputs: " << Inputs.size() << "\n";
1142       dbgs() << "outputs: " << Outputs.size() << "\n";
1143       for (Value *value : Inputs)
1144         dbgs() << "value used in func: " << *value << "\n";
1145       for (Value *output : Outputs)
1146         dbgs() << "instr used in func: " << *output << "\n";
1147     }
1148 #endif
1149     // Do not extract regions that have live exit variables.
1150     if (Outputs.size() > 0 && !ForceLiveExit)
1151       continue;
1152 
1153     Function *OutlinedFunc = CE.extractCodeRegion();
1154 
1155     if (OutlinedFunc) {
1156       CallSite OCS = PartialInlinerImpl::getOneCallSiteTo(OutlinedFunc);
1157       BasicBlock *OutliningCallBB = OCS.getInstruction()->getParent();
1158       assert(OutliningCallBB->getParent() == ClonedFunc);
1159       OutlinedFunctions.push_back(std::make_pair(OutlinedFunc,OutliningCallBB));
1160       NumColdRegionsOutlined++;
1161       OutlinedRegionCost += CurrentOutlinedRegionCost;
1162 
1163       if (MarkOutlinedColdCC) {
1164         OutlinedFunc->setCallingConv(CallingConv::Cold);
1165         OCS.setCallingConv(CallingConv::Cold);
1166       }
1167     } else
1168       ORE.emit([&]() {
1169         return OptimizationRemarkMissed(DEBUG_TYPE, "ExtractFailed",
1170                                         &RegionInfo.Region.front()->front())
1171                << "Failed to extract region at block "
1172                << ore::NV("Block", RegionInfo.Region.front());
1173       });
1174   }
1175 
1176   return !OutlinedFunctions.empty();
1177 }
1178 
1179 Function *
1180 PartialInlinerImpl::FunctionCloner::doSingleRegionFunctionOutlining() {
1181   // Returns true if the block is to be partial inlined into the caller
1182   // (i.e. not to be extracted to the out of line function)
1183   auto ToBeInlined = [&, this](BasicBlock *BB) {
1184     return BB == ClonedOI->ReturnBlock ||
1185            (std::find(ClonedOI->Entries.begin(), ClonedOI->Entries.end(), BB) !=
1186             ClonedOI->Entries.end());
1187   };
1188 
1189   assert(ClonedOI && "Expecting OutlineInfo for single region outline");
1190   // The CodeExtractor needs a dominator tree.
1191   DominatorTree DT;
1192   DT.recalculate(*ClonedFunc);
1193 
1194   // Manually calculate a BlockFrequencyInfo and BranchProbabilityInfo.
1195   LoopInfo LI(DT);
1196   BranchProbabilityInfo BPI(*ClonedFunc, LI);
1197   ClonedFuncBFI.reset(new BlockFrequencyInfo(*ClonedFunc, BPI, LI));
1198 
1199   // Gather up the blocks that we're going to extract.
1200   std::vector<BasicBlock *> ToExtract;
1201   ToExtract.push_back(ClonedOI->NonReturnBlock);
1202   OutlinedRegionCost +=
1203       PartialInlinerImpl::computeBBInlineCost(ClonedOI->NonReturnBlock);
1204   for (BasicBlock &BB : *ClonedFunc)
1205     if (!ToBeInlined(&BB) && &BB != ClonedOI->NonReturnBlock) {
1206       ToExtract.push_back(&BB);
1207       // FIXME: the code extractor may hoist/sink more code
1208       // into the outlined function which may make the outlining
1209       // overhead (the difference of the outlined function cost
1210       // and OutliningRegionCost) look larger.
1211       OutlinedRegionCost += computeBBInlineCost(&BB);
1212     }
1213 
1214   // Extract the body of the if.
1215   Function *OutlinedFunc =
1216       CodeExtractor(ToExtract, &DT, /*AggregateArgs*/ false,
1217                     ClonedFuncBFI.get(), &BPI,
1218                     /* AllowVarargs */ true)
1219           .extractCodeRegion();
1220 
1221   if (OutlinedFunc) {
1222     BasicBlock *OutliningCallBB =
1223         PartialInlinerImpl::getOneCallSiteTo(OutlinedFunc)
1224             .getInstruction()
1225             ->getParent();
1226     assert(OutliningCallBB->getParent() == ClonedFunc);
1227     OutlinedFunctions.push_back(std::make_pair(OutlinedFunc, OutliningCallBB));
1228   } else
1229     ORE.emit([&]() {
1230       return OptimizationRemarkMissed(DEBUG_TYPE, "ExtractFailed",
1231                                       &ToExtract.front()->front())
1232              << "Failed to extract region at block "
1233              << ore::NV("Block", ToExtract.front());
1234     });
1235 
1236   return OutlinedFunc;
1237 }
1238 
1239 PartialInlinerImpl::FunctionCloner::~FunctionCloner() {
1240   // Ditch the duplicate, since we're done with it, and rewrite all remaining
1241   // users (function pointers, etc.) back to the original function.
1242   ClonedFunc->replaceAllUsesWith(OrigFunc);
1243   ClonedFunc->eraseFromParent();
1244   if (!IsFunctionInlined) {
1245     // Remove each function that was speculatively created if there is no
1246     // reference.
1247     for (auto FuncBBPair : OutlinedFunctions) {
1248       Function *Func = FuncBBPair.first;
1249       Func->eraseFromParent();
1250     }
1251   }
1252 }
1253 
1254 std::pair<bool, Function *> PartialInlinerImpl::unswitchFunction(Function *F) {
1255 
1256   if (F->hasAddressTaken())
1257     return {false, nullptr};
1258 
1259   // Let inliner handle it
1260   if (F->hasFnAttribute(Attribute::AlwaysInline))
1261     return {false, nullptr};
1262 
1263   if (F->hasFnAttribute(Attribute::NoInline))
1264     return {false, nullptr};
1265 
1266   if (PSI->isFunctionEntryCold(F))
1267     return {false, nullptr};
1268 
1269   if (F->user_begin() == F->user_end())
1270     return {false, nullptr};
1271 
1272   auto &ORE = (*GetORE)(*F);
1273 
1274   // Only try to outline cold regions if we have a profile summary, which
1275   // implies we have profiling information.
1276   if (PSI->hasProfileSummary() && F->getEntryCount().hasValue() &&
1277       !DisableMultiRegionPartialInline) {
1278     std::unique_ptr<FunctionOutliningMultiRegionInfo> OMRI =
1279         computeOutliningColdRegionsInfo(F);
1280     if (OMRI) {
1281       FunctionCloner Cloner(F, OMRI.get(), ORE);
1282 
1283 #ifndef NDEBUG
1284       if (TracePartialInlining) {
1285         dbgs() << "HotCountThreshold = " << PSI->getHotCountThreshold() << "\n";
1286         dbgs() << "ColdCountThreshold = " << PSI->getColdCountThreshold()
1287                << "\n";
1288       }
1289 #endif
1290       bool DidOutline = Cloner.doMultiRegionFunctionOutlining();
1291 
1292       if (DidOutline) {
1293 #ifndef NDEBUG
1294         if (TracePartialInlining) {
1295           dbgs() << ">>>>>> Outlined (Cloned) Function >>>>>>\n";
1296           Cloner.ClonedFunc->print(dbgs());
1297           dbgs() << "<<<<<< Outlined (Cloned) Function <<<<<<\n";
1298         }
1299 #endif
1300 
1301         if (tryPartialInline(Cloner))
1302           return {true, nullptr};
1303       }
1304     }
1305   }
1306 
1307   // Fall-thru to regular partial inlining if we:
1308   //    i) can't find any cold regions to outline, or
1309   //   ii) can't inline the outlined function anywhere.
1310   std::unique_ptr<FunctionOutliningInfo> OI = computeOutliningInfo(F);
1311   if (!OI)
1312     return {false, nullptr};
1313 
1314   FunctionCloner Cloner(F, OI.get(), ORE);
1315   Cloner.NormalizeReturnBlock();
1316 
1317   Function *OutlinedFunction = Cloner.doSingleRegionFunctionOutlining();
1318 
1319   if (!OutlinedFunction)
1320     return {false, nullptr};
1321 
1322   bool AnyInline = tryPartialInline(Cloner);
1323 
1324   if (AnyInline)
1325     return {true, OutlinedFunction};
1326 
1327   return {false, nullptr};
1328 }
1329 
1330 bool PartialInlinerImpl::tryPartialInline(FunctionCloner &Cloner) {
1331   if (Cloner.OutlinedFunctions.empty())
1332     return false;
1333 
1334   int SizeCost = 0;
1335   BlockFrequency WeightedRcost;
1336   int NonWeightedRcost;
1337   std::tie(SizeCost, NonWeightedRcost) = computeOutliningCosts(Cloner);
1338 
1339   // Only calculate RelativeToEntryFreq when we are doing single region
1340   // outlining.
1341   BranchProbability RelativeToEntryFreq;
1342   if (Cloner.ClonedOI) {
1343     RelativeToEntryFreq = getOutliningCallBBRelativeFreq(Cloner);
1344   } else
1345     // RelativeToEntryFreq doesn't make sense when we have more than one
1346     // outlined call because each call will have a different relative frequency
1347     // to the entry block.  We can consider using the average, but the
1348     // usefulness of that information is questionable. For now, assume we never
1349     // execute the calls to outlined functions.
1350     RelativeToEntryFreq = BranchProbability(0, 1);
1351 
1352   WeightedRcost = BlockFrequency(NonWeightedRcost) * RelativeToEntryFreq;
1353 
1354   // The call sequence(s) to the outlined function(s) are larger than the sum of
1355   // the original outlined region size(s), it does not increase the chances of
1356   // inlining the function with outlining (The inliner uses the size increase to
1357   // model the cost of inlining a callee).
1358   if (!SkipCostAnalysis && Cloner.OutlinedRegionCost < SizeCost) {
1359     auto &ORE = (*GetORE)(*Cloner.OrigFunc);
1360     DebugLoc DLoc;
1361     BasicBlock *Block;
1362     std::tie(DLoc, Block) = getOneDebugLoc(Cloner.ClonedFunc);
1363     ORE.emit([&]() {
1364       return OptimizationRemarkAnalysis(DEBUG_TYPE, "OutlineRegionTooSmall",
1365                                         DLoc, Block)
1366              << ore::NV("Function", Cloner.OrigFunc)
1367              << " not partially inlined into callers (Original Size = "
1368              << ore::NV("OutlinedRegionOriginalSize", Cloner.OutlinedRegionCost)
1369              << ", Size of call sequence to outlined function = "
1370              << ore::NV("NewSize", SizeCost) << ")";
1371     });
1372     return false;
1373   }
1374 
1375   assert(Cloner.OrigFunc->user_begin() == Cloner.OrigFunc->user_end() &&
1376          "F's users should all be replaced!");
1377 
1378   std::vector<User *> Users(Cloner.ClonedFunc->user_begin(),
1379                             Cloner.ClonedFunc->user_end());
1380 
1381   DenseMap<User *, uint64_t> CallSiteToProfCountMap;
1382   if (Cloner.OrigFunc->getEntryCount())
1383     computeCallsiteToProfCountMap(Cloner.ClonedFunc, CallSiteToProfCountMap);
1384 
1385   auto CalleeEntryCount = Cloner.OrigFunc->getEntryCount();
1386   uint64_t CalleeEntryCountV = (CalleeEntryCount ? *CalleeEntryCount : 0);
1387 
1388   bool AnyInline = false;
1389   for (User *User : Users) {
1390     CallSite CS = getCallSite(User);
1391 
1392     if (IsLimitReached())
1393       continue;
1394 
1395 
1396     if (!shouldPartialInline(CS, Cloner, WeightedRcost))
1397       continue;
1398 
1399     auto &ORE = (*GetORE)(*CS.getCaller());
1400     // Construct remark before doing the inlining, as after successful inlining
1401     // the callsite is removed.
1402     OptimizationRemark OR(DEBUG_TYPE, "PartiallyInlined", CS.getInstruction());
1403     OR << ore::NV("Callee", Cloner.OrigFunc) << " partially inlined into "
1404        << ore::NV("Caller", CS.getCaller());
1405 
1406     InlineFunctionInfo IFI(nullptr, GetAssumptionCache, PSI);
1407     // We can only forward varargs when we outlined a single region, else we
1408     // bail on vararg functions.
1409     if (!InlineFunction(CS, IFI, nullptr, true,
1410                         (Cloner.ClonedOI ? Cloner.OutlinedFunctions.back().first
1411                                          : nullptr)))
1412       continue;
1413 
1414     ORE.emit(OR);
1415 
1416     // Now update the entry count:
1417     if (CalleeEntryCountV && CallSiteToProfCountMap.count(User)) {
1418       uint64_t CallSiteCount = CallSiteToProfCountMap[User];
1419       CalleeEntryCountV -= std::min(CalleeEntryCountV, CallSiteCount);
1420     }
1421 
1422     AnyInline = true;
1423     NumPartialInlining++;
1424     // Update the stats
1425     if (Cloner.ClonedOI)
1426       NumPartialInlined++;
1427     else
1428       NumColdOutlinePartialInlined++;
1429 
1430   }
1431 
1432   if (AnyInline) {
1433     Cloner.IsFunctionInlined = true;
1434     if (CalleeEntryCount)
1435       Cloner.OrigFunc->setEntryCount(CalleeEntryCountV);
1436     auto &ORE = (*GetORE)(*Cloner.OrigFunc);
1437     ORE.emit([&]() {
1438       return OptimizationRemark(DEBUG_TYPE, "PartiallyInlined", Cloner.OrigFunc)
1439              << "Partially inlined into at least one caller";
1440     });
1441 
1442   }
1443 
1444   return AnyInline;
1445 }
1446 
1447 bool PartialInlinerImpl::run(Module &M) {
1448   if (DisablePartialInlining)
1449     return false;
1450 
1451   std::vector<Function *> Worklist;
1452   Worklist.reserve(M.size());
1453   for (Function &F : M)
1454     if (!F.use_empty() && !F.isDeclaration())
1455       Worklist.push_back(&F);
1456 
1457   bool Changed = false;
1458   while (!Worklist.empty()) {
1459     Function *CurrFunc = Worklist.back();
1460     Worklist.pop_back();
1461 
1462     if (CurrFunc->use_empty())
1463       continue;
1464 
1465     bool Recursive = false;
1466     for (User *U : CurrFunc->users())
1467       if (Instruction *I = dyn_cast<Instruction>(U))
1468         if (I->getParent()->getParent() == CurrFunc) {
1469           Recursive = true;
1470           break;
1471         }
1472     if (Recursive)
1473       continue;
1474 
1475     std::pair<bool, Function * > Result = unswitchFunction(CurrFunc);
1476     if (Result.second)
1477       Worklist.push_back(Result.second);
1478     if (Result.first) {
1479       Changed = true;
1480     }
1481   }
1482 
1483   return Changed;
1484 }
1485 
1486 char PartialInlinerLegacyPass::ID = 0;
1487 
1488 INITIALIZE_PASS_BEGIN(PartialInlinerLegacyPass, "partial-inliner",
1489                       "Partial Inliner", false, false)
1490 INITIALIZE_PASS_DEPENDENCY(AssumptionCacheTracker)
1491 INITIALIZE_PASS_DEPENDENCY(ProfileSummaryInfoWrapperPass)
1492 INITIALIZE_PASS_DEPENDENCY(TargetTransformInfoWrapperPass)
1493 INITIALIZE_PASS_END(PartialInlinerLegacyPass, "partial-inliner",
1494                     "Partial Inliner", false, false)
1495 
1496 ModulePass *llvm::createPartialInliningPass() {
1497   return new PartialInlinerLegacyPass();
1498 }
1499 
1500 PreservedAnalyses PartialInlinerPass::run(Module &M,
1501                                           ModuleAnalysisManager &AM) {
1502   auto &FAM = AM.getResult<FunctionAnalysisManagerModuleProxy>(M).getManager();
1503 
1504   std::function<AssumptionCache &(Function &)> GetAssumptionCache =
1505       [&FAM](Function &F) -> AssumptionCache & {
1506     return FAM.getResult<AssumptionAnalysis>(F);
1507   };
1508 
1509   std::function<BlockFrequencyInfo &(Function &)> GetBFI =
1510       [&FAM](Function &F) -> BlockFrequencyInfo & {
1511     return FAM.getResult<BlockFrequencyAnalysis>(F);
1512   };
1513 
1514   std::function<TargetTransformInfo &(Function &)> GetTTI =
1515       [&FAM](Function &F) -> TargetTransformInfo & {
1516     return FAM.getResult<TargetIRAnalysis>(F);
1517   };
1518 
1519   std::function<OptimizationRemarkEmitter &(Function &)> GetORE =
1520       [&FAM](Function &F) -> OptimizationRemarkEmitter & {
1521     return FAM.getResult<OptimizationRemarkEmitterAnalysis>(F);
1522   };
1523 
1524   ProfileSummaryInfo *PSI = &AM.getResult<ProfileSummaryAnalysis>(M);
1525 
1526   if (PartialInlinerImpl(&GetAssumptionCache, &GetTTI, {GetBFI}, PSI, &GetORE)
1527           .run(M))
1528     return PreservedAnalyses::none();
1529   return PreservedAnalyses::all();
1530 }
1531