1 //===- ModuleSummaryAnalysis.cpp - Module summary index builder -----------===//
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 builds a ModuleSummaryIndex object for the module, to be written
11 // to bitcode or LLVM assembly.
12 //
13 //===----------------------------------------------------------------------===//
14 
15 #include "llvm/Analysis/ModuleSummaryAnalysis.h"
16 #include "llvm/ADT/ArrayRef.h"
17 #include "llvm/ADT/DenseSet.h"
18 #include "llvm/ADT/MapVector.h"
19 #include "llvm/ADT/STLExtras.h"
20 #include "llvm/ADT/SetVector.h"
21 #include "llvm/ADT/SmallPtrSet.h"
22 #include "llvm/ADT/SmallVector.h"
23 #include "llvm/ADT/StringRef.h"
24 #include "llvm/Analysis/BlockFrequencyInfo.h"
25 #include "llvm/Analysis/BranchProbabilityInfo.h"
26 #include "llvm/Analysis/IndirectCallPromotionAnalysis.h"
27 #include "llvm/Analysis/LoopInfo.h"
28 #include "llvm/Analysis/ProfileSummaryInfo.h"
29 #include "llvm/Analysis/TypeMetadataUtils.h"
30 #include "llvm/IR/Attributes.h"
31 #include "llvm/IR/BasicBlock.h"
32 #include "llvm/IR/CallSite.h"
33 #include "llvm/IR/Constant.h"
34 #include "llvm/IR/Constants.h"
35 #include "llvm/IR/Dominators.h"
36 #include "llvm/IR/Function.h"
37 #include "llvm/IR/GlobalAlias.h"
38 #include "llvm/IR/GlobalValue.h"
39 #include "llvm/IR/GlobalVariable.h"
40 #include "llvm/IR/Instructions.h"
41 #include "llvm/IR/IntrinsicInst.h"
42 #include "llvm/IR/Intrinsics.h"
43 #include "llvm/IR/Metadata.h"
44 #include "llvm/IR/Module.h"
45 #include "llvm/IR/ModuleSummaryIndex.h"
46 #include "llvm/IR/Use.h"
47 #include "llvm/IR/User.h"
48 #include "llvm/Object/ModuleSymbolTable.h"
49 #include "llvm/Object/SymbolicFile.h"
50 #include "llvm/Pass.h"
51 #include "llvm/Support/Casting.h"
52 #include "llvm/Support/CommandLine.h"
53 #include <algorithm>
54 #include <cassert>
55 #include <cstdint>
56 #include <vector>
57 
58 using namespace llvm;
59 
60 #define DEBUG_TYPE "module-summary-analysis"
61 
62 // Option to force edges cold which will block importing when the
63 // -import-cold-multiplier is set to 0. Useful for debugging.
64 FunctionSummary::ForceSummaryHotnessType ForceSummaryEdgesCold =
65     FunctionSummary::FSHT_None;
66 cl::opt<FunctionSummary::ForceSummaryHotnessType, true> FSEC(
67     "force-summary-edges-cold", cl::Hidden, cl::location(ForceSummaryEdgesCold),
68     cl::desc("Force all edges in the function summary to cold"),
69     cl::values(clEnumValN(FunctionSummary::FSHT_None, "none", "None."),
70                clEnumValN(FunctionSummary::FSHT_AllNonCritical,
71                           "all-non-critical", "All non-critical edges."),
72                clEnumValN(FunctionSummary::FSHT_All, "all", "All edges.")));
73 
74 // Walk through the operands of a given User via worklist iteration and populate
75 // the set of GlobalValue references encountered. Invoked either on an
76 // Instruction or a GlobalVariable (which walks its initializer).
77 // Return true if any of the operands contains blockaddress. This is important
78 // to know when computing summary for global var, because if global variable
79 // references basic block address we can't import it separately from function
80 // containing that basic block. For simplicity we currently don't import such
81 // global vars at all. When importing function we aren't interested if any
82 // instruction in it takes an address of any basic block, because instruction
83 // can only take an address of basic block located in the same function.
84 static bool findRefEdges(ModuleSummaryIndex &Index, const User *CurUser,
85                          SetVector<ValueInfo> &RefEdges,
86                          SmallPtrSet<const User *, 8> &Visited) {
87   bool HasBlockAddress = false;
88   SmallVector<const User *, 32> Worklist;
89   Worklist.push_back(CurUser);
90 
91   while (!Worklist.empty()) {
92     const User *U = Worklist.pop_back_val();
93 
94     if (!Visited.insert(U).second)
95       continue;
96 
97     ImmutableCallSite CS(U);
98 
99     for (const auto &OI : U->operands()) {
100       const User *Operand = dyn_cast<User>(OI);
101       if (!Operand)
102         continue;
103       if (isa<BlockAddress>(Operand)) {
104         HasBlockAddress = true;
105         continue;
106       }
107       if (auto *GV = dyn_cast<GlobalValue>(Operand)) {
108         // We have a reference to a global value. This should be added to
109         // the reference set unless it is a callee. Callees are handled
110         // specially by WriteFunction and are added to a separate list.
111         if (!(CS && CS.isCallee(&OI)))
112           RefEdges.insert(Index.getOrInsertValueInfo(GV));
113         continue;
114       }
115       Worklist.push_back(Operand);
116     }
117   }
118   return HasBlockAddress;
119 }
120 
121 static CalleeInfo::HotnessType getHotness(uint64_t ProfileCount,
122                                           ProfileSummaryInfo *PSI) {
123   if (!PSI)
124     return CalleeInfo::HotnessType::Unknown;
125   if (PSI->isHotCount(ProfileCount))
126     return CalleeInfo::HotnessType::Hot;
127   if (PSI->isColdCount(ProfileCount))
128     return CalleeInfo::HotnessType::Cold;
129   return CalleeInfo::HotnessType::None;
130 }
131 
132 static bool isNonRenamableLocal(const GlobalValue &GV) {
133   return GV.hasSection() && GV.hasLocalLinkage();
134 }
135 
136 /// Determine whether this call has all constant integer arguments (excluding
137 /// "this") and summarize it to VCalls or ConstVCalls as appropriate.
138 static void addVCallToSet(DevirtCallSite Call, GlobalValue::GUID Guid,
139                           SetVector<FunctionSummary::VFuncId> &VCalls,
140                           SetVector<FunctionSummary::ConstVCall> &ConstVCalls) {
141   std::vector<uint64_t> Args;
142   // Start from the second argument to skip the "this" pointer.
143   for (auto &Arg : make_range(Call.CS.arg_begin() + 1, Call.CS.arg_end())) {
144     auto *CI = dyn_cast<ConstantInt>(Arg);
145     if (!CI || CI->getBitWidth() > 64) {
146       VCalls.insert({Guid, Call.Offset});
147       return;
148     }
149     Args.push_back(CI->getZExtValue());
150   }
151   ConstVCalls.insert({{Guid, Call.Offset}, std::move(Args)});
152 }
153 
154 /// If this intrinsic call requires that we add information to the function
155 /// summary, do so via the non-constant reference arguments.
156 static void addIntrinsicToSummary(
157     const CallInst *CI, SetVector<GlobalValue::GUID> &TypeTests,
158     SetVector<FunctionSummary::VFuncId> &TypeTestAssumeVCalls,
159     SetVector<FunctionSummary::VFuncId> &TypeCheckedLoadVCalls,
160     SetVector<FunctionSummary::ConstVCall> &TypeTestAssumeConstVCalls,
161     SetVector<FunctionSummary::ConstVCall> &TypeCheckedLoadConstVCalls,
162     DominatorTree &DT) {
163   switch (CI->getCalledFunction()->getIntrinsicID()) {
164   case Intrinsic::type_test: {
165     auto *TypeMDVal = cast<MetadataAsValue>(CI->getArgOperand(1));
166     auto *TypeId = dyn_cast<MDString>(TypeMDVal->getMetadata());
167     if (!TypeId)
168       break;
169     GlobalValue::GUID Guid = GlobalValue::getGUID(TypeId->getString());
170 
171     // Produce a summary from type.test intrinsics. We only summarize type.test
172     // intrinsics that are used other than by an llvm.assume intrinsic.
173     // Intrinsics that are assumed are relevant only to the devirtualization
174     // pass, not the type test lowering pass.
175     bool HasNonAssumeUses = llvm::any_of(CI->uses(), [](const Use &CIU) {
176       auto *AssumeCI = dyn_cast<CallInst>(CIU.getUser());
177       if (!AssumeCI)
178         return true;
179       Function *F = AssumeCI->getCalledFunction();
180       return !F || F->getIntrinsicID() != Intrinsic::assume;
181     });
182     if (HasNonAssumeUses)
183       TypeTests.insert(Guid);
184 
185     SmallVector<DevirtCallSite, 4> DevirtCalls;
186     SmallVector<CallInst *, 4> Assumes;
187     findDevirtualizableCallsForTypeTest(DevirtCalls, Assumes, CI, DT);
188     for (auto &Call : DevirtCalls)
189       addVCallToSet(Call, Guid, TypeTestAssumeVCalls,
190                     TypeTestAssumeConstVCalls);
191 
192     break;
193   }
194 
195   case Intrinsic::type_checked_load: {
196     auto *TypeMDVal = cast<MetadataAsValue>(CI->getArgOperand(2));
197     auto *TypeId = dyn_cast<MDString>(TypeMDVal->getMetadata());
198     if (!TypeId)
199       break;
200     GlobalValue::GUID Guid = GlobalValue::getGUID(TypeId->getString());
201 
202     SmallVector<DevirtCallSite, 4> DevirtCalls;
203     SmallVector<Instruction *, 4> LoadedPtrs;
204     SmallVector<Instruction *, 4> Preds;
205     bool HasNonCallUses = false;
206     findDevirtualizableCallsForTypeCheckedLoad(DevirtCalls, LoadedPtrs, Preds,
207                                                HasNonCallUses, CI, DT);
208     // Any non-call uses of the result of llvm.type.checked.load will
209     // prevent us from optimizing away the llvm.type.test.
210     if (HasNonCallUses)
211       TypeTests.insert(Guid);
212     for (auto &Call : DevirtCalls)
213       addVCallToSet(Call, Guid, TypeCheckedLoadVCalls,
214                     TypeCheckedLoadConstVCalls);
215 
216     break;
217   }
218   default:
219     break;
220   }
221 }
222 
223 static void computeFunctionSummary(
224     ModuleSummaryIndex &Index, const Module &M, const Function &F,
225     BlockFrequencyInfo *BFI, ProfileSummaryInfo *PSI, DominatorTree &DT,
226     bool HasLocalsInUsedOrAsm, DenseSet<GlobalValue::GUID> &CantBePromoted) {
227   // Summary not currently supported for anonymous functions, they should
228   // have been named.
229   assert(F.hasName());
230 
231   unsigned NumInsts = 0;
232   // Map from callee ValueId to profile count. Used to accumulate profile
233   // counts for all static calls to a given callee.
234   MapVector<ValueInfo, CalleeInfo> CallGraphEdges;
235   SetVector<ValueInfo> RefEdges;
236   SetVector<GlobalValue::GUID> TypeTests;
237   SetVector<FunctionSummary::VFuncId> TypeTestAssumeVCalls,
238       TypeCheckedLoadVCalls;
239   SetVector<FunctionSummary::ConstVCall> TypeTestAssumeConstVCalls,
240       TypeCheckedLoadConstVCalls;
241   ICallPromotionAnalysis ICallAnalysis;
242   SmallPtrSet<const User *, 8> Visited;
243 
244   // Add personality function, prefix data and prologue data to function's ref
245   // list.
246   findRefEdges(Index, &F, RefEdges, Visited);
247 
248   bool HasInlineAsmMaybeReferencingInternal = false;
249   bool InitsVarArgs = false;
250   for (const BasicBlock &BB : F)
251     for (const Instruction &I : BB) {
252       if (isa<DbgInfoIntrinsic>(I))
253         continue;
254       if (const IntrinsicInst *II = dyn_cast<IntrinsicInst>(&I)) {
255         if (II->getIntrinsicID() == Intrinsic::vastart)
256           InitsVarArgs = true;
257       }
258       ++NumInsts;
259       findRefEdges(Index, &I, RefEdges, Visited);
260       auto CS = ImmutableCallSite(&I);
261       if (!CS)
262         continue;
263 
264       const auto *CI = dyn_cast<CallInst>(&I);
265       // Since we don't know exactly which local values are referenced in inline
266       // assembly, conservatively mark the function as possibly referencing
267       // a local value from inline assembly to ensure we don't export a
268       // reference (which would require renaming and promotion of the
269       // referenced value).
270       if (HasLocalsInUsedOrAsm && CI && CI->isInlineAsm())
271         HasInlineAsmMaybeReferencingInternal = true;
272 
273       auto *CalledValue = CS.getCalledValue();
274       auto *CalledFunction = CS.getCalledFunction();
275       if (CalledValue && !CalledFunction) {
276         CalledValue = CalledValue->stripPointerCastsNoFollowAliases();
277         // Stripping pointer casts can reveal a called function.
278         CalledFunction = dyn_cast<Function>(CalledValue);
279       }
280       // Check if this is an alias to a function. If so, get the
281       // called aliasee for the checks below.
282       if (auto *GA = dyn_cast<GlobalAlias>(CalledValue)) {
283         assert(!CalledFunction && "Expected null called function in callsite for alias");
284         CalledFunction = dyn_cast<Function>(GA->getBaseObject());
285       }
286       // Check if this is a direct call to a known function or a known
287       // intrinsic, or an indirect call with profile data.
288       if (CalledFunction) {
289         if (CI && CalledFunction->isIntrinsic()) {
290           addIntrinsicToSummary(
291               CI, TypeTests, TypeTestAssumeVCalls, TypeCheckedLoadVCalls,
292               TypeTestAssumeConstVCalls, TypeCheckedLoadConstVCalls, DT);
293           continue;
294         }
295         // We should have named any anonymous globals
296         assert(CalledFunction->hasName());
297         auto ScaledCount = PSI->getProfileCount(&I, BFI);
298         auto Hotness = ScaledCount ? getHotness(ScaledCount.getValue(), PSI)
299                                    : CalleeInfo::HotnessType::Unknown;
300         if (ForceSummaryEdgesCold != FunctionSummary::FSHT_None)
301           Hotness = CalleeInfo::HotnessType::Cold;
302 
303         // Use the original CalledValue, in case it was an alias. We want
304         // to record the call edge to the alias in that case. Eventually
305         // an alias summary will be created to associate the alias and
306         // aliasee.
307         auto &ValueInfo = CallGraphEdges[Index.getOrInsertValueInfo(
308             cast<GlobalValue>(CalledValue))];
309         ValueInfo.updateHotness(Hotness);
310         // Add the relative block frequency to CalleeInfo if there is no profile
311         // information.
312         if (BFI != nullptr && Hotness == CalleeInfo::HotnessType::Unknown) {
313           uint64_t BBFreq = BFI->getBlockFreq(&BB).getFrequency();
314           uint64_t EntryFreq = BFI->getEntryFreq();
315           ValueInfo.updateRelBlockFreq(BBFreq, EntryFreq);
316         }
317       } else {
318         // Skip inline assembly calls.
319         if (CI && CI->isInlineAsm())
320           continue;
321         // Skip direct calls.
322         if (!CalledValue || isa<Constant>(CalledValue))
323           continue;
324 
325         // Check if the instruction has a callees metadata. If so, add callees
326         // to CallGraphEdges to reflect the references from the metadata, and
327         // to enable importing for subsequent indirect call promotion and
328         // inlining.
329         if (auto *MD = I.getMetadata(LLVMContext::MD_callees)) {
330           for (auto &Op : MD->operands()) {
331             Function *Callee = mdconst::extract_or_null<Function>(Op);
332             if (Callee)
333               CallGraphEdges[Index.getOrInsertValueInfo(Callee)];
334           }
335         }
336 
337         uint32_t NumVals, NumCandidates;
338         uint64_t TotalCount;
339         auto CandidateProfileData =
340             ICallAnalysis.getPromotionCandidatesForInstruction(
341                 &I, NumVals, TotalCount, NumCandidates);
342         for (auto &Candidate : CandidateProfileData)
343           CallGraphEdges[Index.getOrInsertValueInfo(Candidate.Value)]
344               .updateHotness(getHotness(Candidate.Count, PSI));
345       }
346     }
347 
348   // Explicit add hot edges to enforce importing for designated GUIDs for
349   // sample PGO, to enable the same inlines as the profiled optimized binary.
350   for (auto &I : F.getImportGUIDs())
351     CallGraphEdges[Index.getOrInsertValueInfo(I)].updateHotness(
352         ForceSummaryEdgesCold == FunctionSummary::FSHT_All
353             ? CalleeInfo::HotnessType::Cold
354             : CalleeInfo::HotnessType::Critical);
355 
356   bool NonRenamableLocal = isNonRenamableLocal(F);
357   bool NotEligibleForImport =
358       NonRenamableLocal || HasInlineAsmMaybeReferencingInternal;
359   GlobalValueSummary::GVFlags Flags(F.getLinkage(), NotEligibleForImport,
360                                     /* Live = */ false, F.isDSOLocal());
361   FunctionSummary::FFlags FunFlags{
362       F.hasFnAttribute(Attribute::ReadNone),
363       F.hasFnAttribute(Attribute::ReadOnly),
364       F.hasFnAttribute(Attribute::NoRecurse), F.returnDoesNotAlias(),
365       // Inliner doesn't handle variadic functions with va_start calls.
366       // FIXME: refactor this to use the same code that inliner is using.
367       InitsVarArgs ||
368           // Don't try to import functions with noinline attribute.
369           F.getAttributes().hasFnAttribute(Attribute::NoInline)};
370   auto FuncSummary = llvm::make_unique<FunctionSummary>(
371       Flags, NumInsts, FunFlags, RefEdges.takeVector(),
372       CallGraphEdges.takeVector(), TypeTests.takeVector(),
373       TypeTestAssumeVCalls.takeVector(), TypeCheckedLoadVCalls.takeVector(),
374       TypeTestAssumeConstVCalls.takeVector(),
375       TypeCheckedLoadConstVCalls.takeVector());
376   if (NonRenamableLocal)
377     CantBePromoted.insert(F.getGUID());
378   Index.addGlobalValueSummary(F, std::move(FuncSummary));
379 }
380 
381 static void
382 computeVariableSummary(ModuleSummaryIndex &Index, const GlobalVariable &V,
383                        DenseSet<GlobalValue::GUID> &CantBePromoted) {
384   SetVector<ValueInfo> RefEdges;
385   SmallPtrSet<const User *, 8> Visited;
386   bool HasBlockAddress = findRefEdges(Index, &V, RefEdges, Visited);
387   bool NonRenamableLocal = isNonRenamableLocal(V);
388   GlobalValueSummary::GVFlags Flags(V.getLinkage(), NonRenamableLocal,
389                                     /* Live = */ false, V.isDSOLocal());
390   auto GVarSummary =
391       llvm::make_unique<GlobalVarSummary>(Flags, RefEdges.takeVector());
392   if (NonRenamableLocal)
393     CantBePromoted.insert(V.getGUID());
394   if (HasBlockAddress)
395     GVarSummary->setNotEligibleToImport();
396   Index.addGlobalValueSummary(V, std::move(GVarSummary));
397 }
398 
399 static void
400 computeAliasSummary(ModuleSummaryIndex &Index, const GlobalAlias &A,
401                     DenseSet<GlobalValue::GUID> &CantBePromoted) {
402   bool NonRenamableLocal = isNonRenamableLocal(A);
403   GlobalValueSummary::GVFlags Flags(A.getLinkage(), NonRenamableLocal,
404                                     /* Live = */ false, A.isDSOLocal());
405   auto AS = llvm::make_unique<AliasSummary>(Flags);
406   auto *Aliasee = A.getBaseObject();
407   auto *AliaseeSummary = Index.getGlobalValueSummary(*Aliasee);
408   assert(AliaseeSummary && "Alias expects aliasee summary to be parsed");
409   AS->setAliasee(AliaseeSummary);
410   if (NonRenamableLocal)
411     CantBePromoted.insert(A.getGUID());
412   Index.addGlobalValueSummary(A, std::move(AS));
413 }
414 
415 // Set LiveRoot flag on entries matching the given value name.
416 static void setLiveRoot(ModuleSummaryIndex &Index, StringRef Name) {
417   if (ValueInfo VI = Index.getValueInfo(GlobalValue::getGUID(Name)))
418     for (auto &Summary : VI.getSummaryList())
419       Summary->setLive(true);
420 }
421 
422 ModuleSummaryIndex llvm::buildModuleSummaryIndex(
423     const Module &M,
424     std::function<BlockFrequencyInfo *(const Function &F)> GetBFICallback,
425     ProfileSummaryInfo *PSI) {
426   assert(PSI);
427   ModuleSummaryIndex Index(/*HaveGVs=*/true);
428 
429   // Identify the local values in the llvm.used and llvm.compiler.used sets,
430   // which should not be exported as they would then require renaming and
431   // promotion, but we may have opaque uses e.g. in inline asm. We collect them
432   // here because we use this information to mark functions containing inline
433   // assembly calls as not importable.
434   SmallPtrSet<GlobalValue *, 8> LocalsUsed;
435   SmallPtrSet<GlobalValue *, 8> Used;
436   // First collect those in the llvm.used set.
437   collectUsedGlobalVariables(M, Used, /*CompilerUsed*/ false);
438   // Next collect those in the llvm.compiler.used set.
439   collectUsedGlobalVariables(M, Used, /*CompilerUsed*/ true);
440   DenseSet<GlobalValue::GUID> CantBePromoted;
441   for (auto *V : Used) {
442     if (V->hasLocalLinkage()) {
443       LocalsUsed.insert(V);
444       CantBePromoted.insert(V->getGUID());
445     }
446   }
447 
448   bool HasLocalInlineAsmSymbol = false;
449   if (!M.getModuleInlineAsm().empty()) {
450     // Collect the local values defined by module level asm, and set up
451     // summaries for these symbols so that they can be marked as NoRename,
452     // to prevent export of any use of them in regular IR that would require
453     // renaming within the module level asm. Note we don't need to create a
454     // summary for weak or global defs, as they don't need to be flagged as
455     // NoRename, and defs in module level asm can't be imported anyway.
456     // Also, any values used but not defined within module level asm should
457     // be listed on the llvm.used or llvm.compiler.used global and marked as
458     // referenced from there.
459     ModuleSymbolTable::CollectAsmSymbols(
460         M, [&](StringRef Name, object::BasicSymbolRef::Flags Flags) {
461           // Symbols not marked as Weak or Global are local definitions.
462           if (Flags & (object::BasicSymbolRef::SF_Weak |
463                        object::BasicSymbolRef::SF_Global))
464             return;
465           HasLocalInlineAsmSymbol = true;
466           GlobalValue *GV = M.getNamedValue(Name);
467           if (!GV)
468             return;
469           assert(GV->isDeclaration() && "Def in module asm already has definition");
470           GlobalValueSummary::GVFlags GVFlags(GlobalValue::InternalLinkage,
471                                               /* NotEligibleToImport = */ true,
472                                               /* Live = */ true,
473                                               /* Local */ GV->isDSOLocal());
474           CantBePromoted.insert(GV->getGUID());
475           // Create the appropriate summary type.
476           if (Function *F = dyn_cast<Function>(GV)) {
477             std::unique_ptr<FunctionSummary> Summary =
478                 llvm::make_unique<FunctionSummary>(
479                     GVFlags, 0,
480                     FunctionSummary::FFlags{
481                         F->hasFnAttribute(Attribute::ReadNone),
482                         F->hasFnAttribute(Attribute::ReadOnly),
483                         F->hasFnAttribute(Attribute::NoRecurse),
484                         F->returnDoesNotAlias(),
485                         /* NoInline = */ false},
486                     ArrayRef<ValueInfo>{}, ArrayRef<FunctionSummary::EdgeTy>{},
487                     ArrayRef<GlobalValue::GUID>{},
488                     ArrayRef<FunctionSummary::VFuncId>{},
489                     ArrayRef<FunctionSummary::VFuncId>{},
490                     ArrayRef<FunctionSummary::ConstVCall>{},
491                     ArrayRef<FunctionSummary::ConstVCall>{});
492             Index.addGlobalValueSummary(*GV, std::move(Summary));
493           } else {
494             std::unique_ptr<GlobalVarSummary> Summary =
495                 llvm::make_unique<GlobalVarSummary>(GVFlags,
496                                                     ArrayRef<ValueInfo>{});
497             Index.addGlobalValueSummary(*GV, std::move(Summary));
498           }
499         });
500   }
501 
502   // Compute summaries for all functions defined in module, and save in the
503   // index.
504   for (auto &F : M) {
505     if (F.isDeclaration())
506       continue;
507 
508     DominatorTree DT(const_cast<Function &>(F));
509     BlockFrequencyInfo *BFI = nullptr;
510     std::unique_ptr<BlockFrequencyInfo> BFIPtr;
511     if (GetBFICallback)
512       BFI = GetBFICallback(F);
513     else if (F.hasProfileData()) {
514       LoopInfo LI{DT};
515       BranchProbabilityInfo BPI{F, LI};
516       BFIPtr = llvm::make_unique<BlockFrequencyInfo>(F, BPI, LI);
517       BFI = BFIPtr.get();
518     }
519 
520     computeFunctionSummary(Index, M, F, BFI, PSI, DT,
521                            !LocalsUsed.empty() || HasLocalInlineAsmSymbol,
522                            CantBePromoted);
523   }
524 
525   // Compute summaries for all variables defined in module, and save in the
526   // index.
527   for (const GlobalVariable &G : M.globals()) {
528     if (G.isDeclaration())
529       continue;
530     computeVariableSummary(Index, G, CantBePromoted);
531   }
532 
533   // Compute summaries for all aliases defined in module, and save in the
534   // index.
535   for (const GlobalAlias &A : M.aliases())
536     computeAliasSummary(Index, A, CantBePromoted);
537 
538   for (auto *V : LocalsUsed) {
539     auto *Summary = Index.getGlobalValueSummary(*V);
540     assert(Summary && "Missing summary for global value");
541     Summary->setNotEligibleToImport();
542   }
543 
544   // The linker doesn't know about these LLVM produced values, so we need
545   // to flag them as live in the index to ensure index-based dead value
546   // analysis treats them as live roots of the analysis.
547   setLiveRoot(Index, "llvm.used");
548   setLiveRoot(Index, "llvm.compiler.used");
549   setLiveRoot(Index, "llvm.global_ctors");
550   setLiveRoot(Index, "llvm.global_dtors");
551   setLiveRoot(Index, "llvm.global.annotations");
552 
553   bool IsThinLTO = true;
554   if (auto *MD =
555           mdconst::extract_or_null<ConstantInt>(M.getModuleFlag("ThinLTO")))
556     IsThinLTO = MD->getZExtValue();
557 
558   for (auto &GlobalList : Index) {
559     // Ignore entries for references that are undefined in the current module.
560     if (GlobalList.second.SummaryList.empty())
561       continue;
562 
563     assert(GlobalList.second.SummaryList.size() == 1 &&
564            "Expected module's index to have one summary per GUID");
565     auto &Summary = GlobalList.second.SummaryList[0];
566     if (!IsThinLTO) {
567       Summary->setNotEligibleToImport();
568       continue;
569     }
570 
571     bool AllRefsCanBeExternallyReferenced =
572         llvm::all_of(Summary->refs(), [&](const ValueInfo &VI) {
573           return !CantBePromoted.count(VI.getGUID());
574         });
575     if (!AllRefsCanBeExternallyReferenced) {
576       Summary->setNotEligibleToImport();
577       continue;
578     }
579 
580     if (auto *FuncSummary = dyn_cast<FunctionSummary>(Summary.get())) {
581       bool AllCallsCanBeExternallyReferenced = llvm::all_of(
582           FuncSummary->calls(), [&](const FunctionSummary::EdgeTy &Edge) {
583             return !CantBePromoted.count(Edge.first.getGUID());
584           });
585       if (!AllCallsCanBeExternallyReferenced)
586         Summary->setNotEligibleToImport();
587     }
588   }
589 
590   return Index;
591 }
592 
593 AnalysisKey ModuleSummaryIndexAnalysis::Key;
594 
595 ModuleSummaryIndex
596 ModuleSummaryIndexAnalysis::run(Module &M, ModuleAnalysisManager &AM) {
597   ProfileSummaryInfo &PSI = AM.getResult<ProfileSummaryAnalysis>(M);
598   auto &FAM = AM.getResult<FunctionAnalysisManagerModuleProxy>(M).getManager();
599   return buildModuleSummaryIndex(
600       M,
601       [&FAM](const Function &F) {
602         return &FAM.getResult<BlockFrequencyAnalysis>(
603             *const_cast<Function *>(&F));
604       },
605       &PSI);
606 }
607 
608 char ModuleSummaryIndexWrapperPass::ID = 0;
609 
610 INITIALIZE_PASS_BEGIN(ModuleSummaryIndexWrapperPass, "module-summary-analysis",
611                       "Module Summary Analysis", false, true)
612 INITIALIZE_PASS_DEPENDENCY(BlockFrequencyInfoWrapperPass)
613 INITIALIZE_PASS_DEPENDENCY(ProfileSummaryInfoWrapperPass)
614 INITIALIZE_PASS_END(ModuleSummaryIndexWrapperPass, "module-summary-analysis",
615                     "Module Summary Analysis", false, true)
616 
617 ModulePass *llvm::createModuleSummaryIndexWrapperPass() {
618   return new ModuleSummaryIndexWrapperPass();
619 }
620 
621 ModuleSummaryIndexWrapperPass::ModuleSummaryIndexWrapperPass()
622     : ModulePass(ID) {
623   initializeModuleSummaryIndexWrapperPassPass(*PassRegistry::getPassRegistry());
624 }
625 
626 bool ModuleSummaryIndexWrapperPass::runOnModule(Module &M) {
627   auto &PSI = *getAnalysis<ProfileSummaryInfoWrapperPass>().getPSI();
628   Index.emplace(buildModuleSummaryIndex(
629       M,
630       [this](const Function &F) {
631         return &(this->getAnalysis<BlockFrequencyInfoWrapperPass>(
632                          *const_cast<Function *>(&F))
633                      .getBFI());
634       },
635       &PSI));
636   return false;
637 }
638 
639 bool ModuleSummaryIndexWrapperPass::doFinalization(Module &M) {
640   Index.reset();
641   return false;
642 }
643 
644 void ModuleSummaryIndexWrapperPass::getAnalysisUsage(AnalysisUsage &AU) const {
645   AU.setPreservesAll();
646   AU.addRequired<BlockFrequencyInfoWrapperPass>();
647   AU.addRequired<ProfileSummaryInfoWrapperPass>();
648 }
649