xref: /llvm-project-15.0.7/llvm/lib/LTO/LTO.cpp (revision ccf18131)
1 //===-LTO.cpp - LLVM Link Time Optimizer ----------------------------------===//
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 functions and classes used to support LTO.
11 //
12 //===----------------------------------------------------------------------===//
13 
14 #include "llvm/LTO/LTO.h"
15 #include "llvm/Analysis/TargetLibraryInfo.h"
16 #include "llvm/Analysis/TargetTransformInfo.h"
17 #include "llvm/Bitcode/BitcodeReader.h"
18 #include "llvm/Bitcode/BitcodeWriter.h"
19 #include "llvm/CodeGen/Analysis.h"
20 #include "llvm/IR/AutoUpgrade.h"
21 #include "llvm/IR/DiagnosticPrinter.h"
22 #include "llvm/IR/LegacyPassManager.h"
23 #include "llvm/LTO/LTOBackend.h"
24 #include "llvm/Linker/IRMover.h"
25 #include "llvm/Object/ModuleSummaryIndexObjectFile.h"
26 #include "llvm/Support/ManagedStatic.h"
27 #include "llvm/Support/MemoryBuffer.h"
28 #include "llvm/Support/Path.h"
29 #include "llvm/Support/SHA1.h"
30 #include "llvm/Support/SourceMgr.h"
31 #include "llvm/Support/TargetRegistry.h"
32 #include "llvm/Support/ThreadPool.h"
33 #include "llvm/Support/Threading.h"
34 #include "llvm/Support/raw_ostream.h"
35 #include "llvm/Target/TargetMachine.h"
36 #include "llvm/Target/TargetOptions.h"
37 #include "llvm/Transforms/IPO.h"
38 #include "llvm/Transforms/IPO/PassManagerBuilder.h"
39 #include "llvm/Transforms/Utils/SplitModule.h"
40 
41 #include <set>
42 
43 using namespace llvm;
44 using namespace lto;
45 using namespace object;
46 
47 #define DEBUG_TYPE "lto"
48 
49 // Returns a unique hash for the Module considering the current list of
50 // export/import and other global analysis results.
51 // The hash is produced in \p Key.
52 static void computeCacheKey(
53     SmallString<40> &Key, const Config &Conf, const ModuleSummaryIndex &Index,
54     StringRef ModuleID, const FunctionImporter::ImportMapTy &ImportList,
55     const FunctionImporter::ExportSetTy &ExportList,
56     const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
57     const GVSummaryMapTy &DefinedGlobals) {
58   // Compute the unique hash for this entry.
59   // This is based on the current compiler version, the module itself, the
60   // export list, the hash for every single module in the import list, the
61   // list of ResolvedODR for the module, and the list of preserved symbols.
62   SHA1 Hasher;
63 
64   // Start with the compiler revision
65   Hasher.update(LLVM_VERSION_STRING);
66 #ifdef HAVE_LLVM_REVISION
67   Hasher.update(LLVM_REVISION);
68 #endif
69 
70   // Include the parts of the LTO configuration that affect code generation.
71   auto AddString = [&](StringRef Str) {
72     Hasher.update(Str);
73     Hasher.update(ArrayRef<uint8_t>{0});
74   };
75   auto AddUnsigned = [&](unsigned I) {
76     uint8_t Data[4];
77     Data[0] = I;
78     Data[1] = I >> 8;
79     Data[2] = I >> 16;
80     Data[3] = I >> 24;
81     Hasher.update(ArrayRef<uint8_t>{Data, 4});
82   };
83   AddString(Conf.CPU);
84   // FIXME: Hash more of Options. For now all clients initialize Options from
85   // command-line flags (which is unsupported in production), but may set
86   // RelaxELFRelocations. The clang driver can also pass FunctionSections,
87   // DataSections and DebuggerTuning via command line flags.
88   AddUnsigned(Conf.Options.RelaxELFRelocations);
89   AddUnsigned(Conf.Options.FunctionSections);
90   AddUnsigned(Conf.Options.DataSections);
91   AddUnsigned((unsigned)Conf.Options.DebuggerTuning);
92   for (auto &A : Conf.MAttrs)
93     AddString(A);
94   AddUnsigned(Conf.RelocModel);
95   AddUnsigned(Conf.CodeModel);
96   AddUnsigned(Conf.CGOptLevel);
97   AddUnsigned(Conf.OptLevel);
98   AddString(Conf.OptPipeline);
99   AddString(Conf.AAPipeline);
100   AddString(Conf.OverrideTriple);
101   AddString(Conf.DefaultTriple);
102 
103   // Include the hash for the current module
104   auto ModHash = Index.getModuleHash(ModuleID);
105   Hasher.update(ArrayRef<uint8_t>((uint8_t *)&ModHash[0], sizeof(ModHash)));
106   for (auto F : ExportList)
107     // The export list can impact the internalization, be conservative here
108     Hasher.update(ArrayRef<uint8_t>((uint8_t *)&F, sizeof(F)));
109 
110   // Include the hash for every module we import functions from
111   for (auto &Entry : ImportList) {
112     auto ModHash = Index.getModuleHash(Entry.first());
113     Hasher.update(ArrayRef<uint8_t>((uint8_t *)&ModHash[0], sizeof(ModHash)));
114   }
115 
116   // Include the hash for the resolved ODR.
117   for (auto &Entry : ResolvedODR) {
118     Hasher.update(ArrayRef<uint8_t>((const uint8_t *)&Entry.first,
119                                     sizeof(GlobalValue::GUID)));
120     Hasher.update(ArrayRef<uint8_t>((const uint8_t *)&Entry.second,
121                                     sizeof(GlobalValue::LinkageTypes)));
122   }
123 
124   // Include the hash for the linkage type to reflect internalization and weak
125   // resolution.
126   for (auto &GS : DefinedGlobals) {
127     GlobalValue::LinkageTypes Linkage = GS.second->linkage();
128     Hasher.update(
129         ArrayRef<uint8_t>((const uint8_t *)&Linkage, sizeof(Linkage)));
130   }
131 
132   if (!Conf.SampleProfile.empty()) {
133     auto FileOrErr = MemoryBuffer::getFile(Conf.SampleProfile);
134     if (FileOrErr)
135       Hasher.update(FileOrErr.get()->getBuffer());
136   }
137 
138   Key = toHex(Hasher.result());
139 }
140 
141 static void thinLTOResolveWeakForLinkerGUID(
142     GlobalValueSummaryList &GVSummaryList, GlobalValue::GUID GUID,
143     DenseSet<GlobalValueSummary *> &GlobalInvolvedWithAlias,
144     function_ref<bool(GlobalValue::GUID, const GlobalValueSummary *)>
145         isPrevailing,
146     function_ref<void(StringRef, GlobalValue::GUID, GlobalValue::LinkageTypes)>
147         recordNewLinkage) {
148   for (auto &S : GVSummaryList) {
149     GlobalValue::LinkageTypes OriginalLinkage = S->linkage();
150     if (!GlobalValue::isWeakForLinker(OriginalLinkage))
151       continue;
152     // We need to emit only one of these. The prevailing module will keep it,
153     // but turned into a weak, while the others will drop it when possible.
154     // This is both a compile-time optimization and a correctness
155     // transformation. This is necessary for correctness when we have exported
156     // a reference - we need to convert the linkonce to weak to
157     // ensure a copy is kept to satisfy the exported reference.
158     // FIXME: We may want to split the compile time and correctness
159     // aspects into separate routines.
160     if (isPrevailing(GUID, S.get())) {
161       if (GlobalValue::isLinkOnceLinkage(OriginalLinkage))
162         S->setLinkage(GlobalValue::getWeakLinkage(
163             GlobalValue::isLinkOnceODRLinkage(OriginalLinkage)));
164     }
165     // Alias and aliasee can't be turned into available_externally.
166     else if (!isa<AliasSummary>(S.get()) &&
167              !GlobalInvolvedWithAlias.count(S.get()) &&
168              (GlobalValue::isLinkOnceODRLinkage(OriginalLinkage) ||
169               GlobalValue::isWeakODRLinkage(OriginalLinkage)))
170       S->setLinkage(GlobalValue::AvailableExternallyLinkage);
171     if (S->linkage() != OriginalLinkage)
172       recordNewLinkage(S->modulePath(), GUID, S->linkage());
173   }
174 }
175 
176 // Resolve Weak and LinkOnce values in the \p Index.
177 //
178 // We'd like to drop these functions if they are no longer referenced in the
179 // current module. However there is a chance that another module is still
180 // referencing them because of the import. We make sure we always emit at least
181 // one copy.
182 void llvm::thinLTOResolveWeakForLinkerInIndex(
183     ModuleSummaryIndex &Index,
184     function_ref<bool(GlobalValue::GUID, const GlobalValueSummary *)>
185         isPrevailing,
186     function_ref<void(StringRef, GlobalValue::GUID, GlobalValue::LinkageTypes)>
187         recordNewLinkage) {
188   // We won't optimize the globals that are referenced by an alias for now
189   // Ideally we should turn the alias into a global and duplicate the definition
190   // when needed.
191   DenseSet<GlobalValueSummary *> GlobalInvolvedWithAlias;
192   for (auto &I : Index)
193     for (auto &S : I.second)
194       if (auto AS = dyn_cast<AliasSummary>(S.get()))
195         GlobalInvolvedWithAlias.insert(&AS->getAliasee());
196 
197   for (auto &I : Index)
198     thinLTOResolveWeakForLinkerGUID(I.second, I.first, GlobalInvolvedWithAlias,
199                                     isPrevailing, recordNewLinkage);
200 }
201 
202 static void thinLTOInternalizeAndPromoteGUID(
203     GlobalValueSummaryList &GVSummaryList, GlobalValue::GUID GUID,
204     function_ref<bool(StringRef, GlobalValue::GUID)> isExported) {
205   for (auto &S : GVSummaryList) {
206     if (isExported(S->modulePath(), GUID)) {
207       if (GlobalValue::isLocalLinkage(S->linkage()))
208         S->setLinkage(GlobalValue::ExternalLinkage);
209     } else if (!GlobalValue::isLocalLinkage(S->linkage()))
210       S->setLinkage(GlobalValue::InternalLinkage);
211   }
212 }
213 
214 // Update the linkages in the given \p Index to mark exported values
215 // as external and non-exported values as internal.
216 void llvm::thinLTOInternalizeAndPromoteInIndex(
217     ModuleSummaryIndex &Index,
218     function_ref<bool(StringRef, GlobalValue::GUID)> isExported) {
219   for (auto &I : Index)
220     thinLTOInternalizeAndPromoteGUID(I.second, I.first, isExported);
221 }
222 
223 struct InputFile::InputModule {
224   BitcodeModule BM;
225   std::unique_ptr<Module> Mod;
226 
227   // The range of ModuleSymbolTable entries for this input module.
228   size_t SymBegin, SymEnd;
229 };
230 
231 // Requires a destructor for std::vector<InputModule>.
232 InputFile::~InputFile() = default;
233 
234 Expected<std::unique_ptr<InputFile>> InputFile::create(MemoryBufferRef Object) {
235   std::unique_ptr<InputFile> File(new InputFile);
236 
237   ErrorOr<MemoryBufferRef> BCOrErr =
238       IRObjectFile::findBitcodeInMemBuffer(Object);
239   if (!BCOrErr)
240     return errorCodeToError(BCOrErr.getError());
241 
242   Expected<std::vector<BitcodeModule>> BMsOrErr =
243       getBitcodeModuleList(*BCOrErr);
244   if (!BMsOrErr)
245     return BMsOrErr.takeError();
246 
247   if (BMsOrErr->empty())
248     return make_error<StringError>("Bitcode file does not contain any modules",
249                                    inconvertibleErrorCode());
250 
251   // Create an InputModule for each module in the InputFile, and add it to the
252   // ModuleSymbolTable.
253   for (auto BM : *BMsOrErr) {
254     Expected<std::unique_ptr<Module>> MOrErr =
255         BM.getLazyModule(File->Ctx, /*ShouldLazyLoadMetadata*/ true,
256                          /*IsImporting*/ false);
257     if (!MOrErr)
258       return MOrErr.takeError();
259 
260     size_t SymBegin = File->SymTab.symbols().size();
261     File->SymTab.addModule(MOrErr->get());
262     size_t SymEnd = File->SymTab.symbols().size();
263 
264     for (const auto &C : (*MOrErr)->getComdatSymbolTable()) {
265       auto P = File->ComdatMap.insert(
266           std::make_pair(&C.second, File->Comdats.size()));
267       assert(P.second);
268       (void)P;
269       File->Comdats.push_back(C.first());
270     }
271 
272     File->Mods.push_back({BM, std::move(*MOrErr), SymBegin, SymEnd});
273   }
274 
275   return std::move(File);
276 }
277 
278 Expected<int> InputFile::Symbol::getComdatIndex() const {
279   if (!isGV())
280     return -1;
281   const GlobalObject *GO = getGV()->getBaseObject();
282   if (!GO)
283     return make_error<StringError>("Unable to determine comdat of alias!",
284                                    inconvertibleErrorCode());
285   if (const Comdat *C = GO->getComdat()) {
286     auto I = File->ComdatMap.find(C);
287     assert(I != File->ComdatMap.end());
288     return I->second;
289   }
290   return -1;
291 }
292 
293 StringRef InputFile::getName() const {
294   return Mods[0].BM.getModuleIdentifier();
295 }
296 
297 StringRef InputFile::getSourceFileName() const {
298   return Mods[0].Mod->getSourceFileName();
299 }
300 
301 iterator_range<InputFile::symbol_iterator>
302 InputFile::module_symbols(InputModule &IM) {
303   return llvm::make_range(
304       symbol_iterator(SymTab.symbols().data() + IM.SymBegin, SymTab, this),
305       symbol_iterator(SymTab.symbols().data() + IM.SymEnd, SymTab, this));
306 }
307 
308 LTO::RegularLTOState::RegularLTOState(unsigned ParallelCodeGenParallelismLevel,
309                                       Config &Conf)
310     : ParallelCodeGenParallelismLevel(ParallelCodeGenParallelismLevel),
311       Ctx(Conf) {}
312 
313 LTO::ThinLTOState::ThinLTOState(ThinBackend Backend) : Backend(Backend) {
314   if (!Backend)
315     this->Backend =
316         createInProcessThinBackend(llvm::heavyweight_hardware_concurrency());
317 }
318 
319 LTO::LTO(Config Conf, ThinBackend Backend,
320          unsigned ParallelCodeGenParallelismLevel)
321     : Conf(std::move(Conf)),
322       RegularLTO(ParallelCodeGenParallelismLevel, this->Conf),
323       ThinLTO(std::move(Backend)) {}
324 
325 // Requires a destructor for MapVector<BitcodeModule>.
326 LTO::~LTO() = default;
327 
328 // Add the given symbol to the GlobalResolutions map, and resolve its partition.
329 void LTO::addSymbolToGlobalRes(SmallPtrSet<GlobalValue *, 8> &Used,
330                                const InputFile::Symbol &Sym,
331                                SymbolResolution Res, unsigned Partition) {
332   GlobalValue *GV = Sym.isGV() ? Sym.getGV() : nullptr;
333 
334   auto &GlobalRes = GlobalResolutions[Sym.getName()];
335   if (GV) {
336     GlobalRes.UnnamedAddr &= GV->hasGlobalUnnamedAddr();
337     if (Res.Prevailing)
338       GlobalRes.IRName = GV->getName();
339   }
340   // Set the partition to external if we know it is used elsewhere, e.g.
341   // it is visible to a regular object, is referenced from llvm.compiler_used,
342   // or was already recorded as being referenced from a different partition.
343   if (Res.VisibleToRegularObj || (GV && Used.count(GV)) ||
344       (GlobalRes.Partition != GlobalResolution::Unknown &&
345        GlobalRes.Partition != Partition)) {
346     GlobalRes.Partition = GlobalResolution::External;
347   } else
348     // First recorded reference, save the current partition.
349     GlobalRes.Partition = Partition;
350 
351   // Flag as visible outside of ThinLTO if visible from a regular object or
352   // if this is a reference in the regular LTO partition.
353   GlobalRes.VisibleOutsideThinLTO |=
354       (Res.VisibleToRegularObj || (Partition == GlobalResolution::RegularLTO));
355 }
356 
357 static void writeToResolutionFile(raw_ostream &OS, InputFile *Input,
358                                   ArrayRef<SymbolResolution> Res) {
359   StringRef Path = Input->getName();
360   OS << Path << '\n';
361   auto ResI = Res.begin();
362   for (const InputFile::Symbol &Sym : Input->symbols()) {
363     assert(ResI != Res.end());
364     SymbolResolution Res = *ResI++;
365 
366     OS << "-r=" << Path << ',' << Sym.getName() << ',';
367     if (Res.Prevailing)
368       OS << 'p';
369     if (Res.FinalDefinitionInLinkageUnit)
370       OS << 'l';
371     if (Res.VisibleToRegularObj)
372       OS << 'x';
373     OS << '\n';
374   }
375   OS.flush();
376   assert(ResI == Res.end());
377 }
378 
379 Error LTO::add(std::unique_ptr<InputFile> Input,
380                ArrayRef<SymbolResolution> Res) {
381   assert(!CalledGetMaxTasks);
382 
383   if (Conf.ResolutionFile)
384     writeToResolutionFile(*Conf.ResolutionFile, Input.get(), Res);
385 
386   const SymbolResolution *ResI = Res.begin();
387   for (InputFile::InputModule &IM : Input->Mods)
388     if (Error Err = addModule(*Input, IM, ResI, Res.end()))
389       return Err;
390 
391   assert(ResI == Res.end());
392   return Error::success();
393 }
394 
395 Error LTO::addModule(InputFile &Input, InputFile::InputModule &IM,
396                      const SymbolResolution *&ResI,
397                      const SymbolResolution *ResE) {
398   // FIXME: move to backend
399   Module &M = *IM.Mod;
400 
401   if (M.getDataLayoutStr().empty())
402     return make_error<StringError>("input module has no datalayout",
403                                     inconvertibleErrorCode());
404 
405   if (!Conf.OverrideTriple.empty())
406     M.setTargetTriple(Conf.OverrideTriple);
407   else if (M.getTargetTriple().empty())
408     M.setTargetTriple(Conf.DefaultTriple);
409 
410   Expected<bool> HasThinLTOSummary = IM.BM.hasSummary();
411   if (!HasThinLTOSummary)
412     return HasThinLTOSummary.takeError();
413 
414   if (*HasThinLTOSummary)
415     return addThinLTO(IM.BM, M, Input.module_symbols(IM), ResI, ResE);
416   else
417     return addRegularLTO(IM.BM, ResI, ResE);
418 }
419 
420 // Add a regular LTO object to the link.
421 Error LTO::addRegularLTO(BitcodeModule BM, const SymbolResolution *&ResI,
422                          const SymbolResolution *ResE) {
423   if (!RegularLTO.CombinedModule) {
424     RegularLTO.CombinedModule =
425         llvm::make_unique<Module>("ld-temp.o", RegularLTO.Ctx);
426     RegularLTO.Mover = llvm::make_unique<IRMover>(*RegularLTO.CombinedModule);
427   }
428   Expected<std::unique_ptr<Module>> MOrErr =
429       BM.getLazyModule(RegularLTO.Ctx, /*ShouldLazyLoadMetadata*/ true,
430                        /*IsImporting*/ false);
431   if (!MOrErr)
432     return MOrErr.takeError();
433 
434   Module &M = **MOrErr;
435   if (Error Err = M.materializeMetadata())
436     return Err;
437   UpgradeDebugInfo(M);
438 
439   ModuleSymbolTable SymTab;
440   SymTab.addModule(&M);
441 
442   SmallPtrSet<GlobalValue *, 8> Used;
443   collectUsedGlobalVariables(M, Used, /*CompilerUsed*/ false);
444 
445   std::vector<GlobalValue *> Keep;
446 
447   for (GlobalVariable &GV : M.globals())
448     if (GV.hasAppendingLinkage())
449       Keep.push_back(&GV);
450 
451   for (const InputFile::Symbol &Sym :
452        make_range(InputFile::symbol_iterator(SymTab.symbols().begin(), SymTab,
453                                              nullptr),
454                   InputFile::symbol_iterator(SymTab.symbols().end(), SymTab,
455                                              nullptr))) {
456     assert(ResI != ResE);
457     SymbolResolution Res = *ResI++;
458     addSymbolToGlobalRes(Used, Sym, Res, 0);
459 
460     if (Sym.getFlags() & object::BasicSymbolRef::SF_Undefined)
461       continue;
462     if (Res.Prevailing && Sym.isGV()) {
463       GlobalValue *GV = Sym.getGV();
464       Keep.push_back(GV);
465       switch (GV->getLinkage()) {
466       default:
467         break;
468       case GlobalValue::LinkOnceAnyLinkage:
469         GV->setLinkage(GlobalValue::WeakAnyLinkage);
470         break;
471       case GlobalValue::LinkOnceODRLinkage:
472         GV->setLinkage(GlobalValue::WeakODRLinkage);
473         break;
474       }
475     }
476     // Common resolution: collect the maximum size/alignment over all commons.
477     // We also record if we see an instance of a common as prevailing, so that
478     // if none is prevailing we can ignore it later.
479     if (Sym.getFlags() & object::BasicSymbolRef::SF_Common) {
480       // FIXME: We should figure out what to do about commons defined by asm.
481       // For now they aren't reported correctly by ModuleSymbolTable.
482       auto &CommonRes = RegularLTO.Commons[Sym.getGV()->getName()];
483       CommonRes.Size = std::max(CommonRes.Size, Sym.getCommonSize());
484       CommonRes.Align = std::max(CommonRes.Align, Sym.getCommonAlignment());
485       CommonRes.Prevailing |= Res.Prevailing;
486     }
487 
488     // FIXME: use proposed local attribute for FinalDefinitionInLinkageUnit.
489   }
490 
491   return RegularLTO.Mover->move(std::move(*MOrErr), Keep,
492                                 [](GlobalValue &, IRMover::ValueAdder) {},
493                                 /* LinkModuleInlineAsm */ true,
494                                 /* IsPerformingImport */ false);
495 }
496 
497 // Add a ThinLTO object to the link.
498 // FIXME: This function should not need to take as many parameters once we have
499 // a bitcode symbol table.
500 Error LTO::addThinLTO(BitcodeModule BM, Module &M,
501                       iterator_range<InputFile::symbol_iterator> Syms,
502                       const SymbolResolution *&ResI,
503                       const SymbolResolution *ResE) {
504   SmallPtrSet<GlobalValue *, 8> Used;
505   collectUsedGlobalVariables(M, Used, /*CompilerUsed*/ false);
506 
507   Expected<std::unique_ptr<ModuleSummaryIndex>> SummaryOrErr = BM.getSummary();
508   if (!SummaryOrErr)
509     return SummaryOrErr.takeError();
510   ThinLTO.CombinedIndex.mergeFrom(std::move(*SummaryOrErr),
511                                   ThinLTO.ModuleMap.size());
512 
513   for (const InputFile::Symbol &Sym : Syms) {
514     assert(ResI != ResE);
515     SymbolResolution Res = *ResI++;
516     addSymbolToGlobalRes(Used, Sym, Res, ThinLTO.ModuleMap.size() + 1);
517 
518     if (Res.Prevailing && Sym.isGV())
519       ThinLTO.PrevailingModuleForGUID[Sym.getGV()->getGUID()] =
520           BM.getModuleIdentifier();
521   }
522 
523   if (!ThinLTO.ModuleMap.insert({BM.getModuleIdentifier(), BM}).second)
524     return make_error<StringError>(
525         "Expected at most one ThinLTO module per bitcode file",
526         inconvertibleErrorCode());
527 
528   return Error::success();
529 }
530 
531 unsigned LTO::getMaxTasks() const {
532   CalledGetMaxTasks = true;
533   return RegularLTO.ParallelCodeGenParallelismLevel + ThinLTO.ModuleMap.size();
534 }
535 
536 Error LTO::run(AddStreamFn AddStream, NativeObjectCache Cache) {
537   // Save the status of having a regularLTO combined module, as
538   // this is needed for generating the ThinLTO Task ID, and
539   // the CombinedModule will be moved at the end of runRegularLTO.
540   bool HasRegularLTO = RegularLTO.CombinedModule != nullptr;
541   // Invoke regular LTO if there was a regular LTO module to start with.
542   if (HasRegularLTO)
543     if (auto E = runRegularLTO(AddStream))
544       return E;
545   return runThinLTO(AddStream, Cache, HasRegularLTO);
546 }
547 
548 Error LTO::runRegularLTO(AddStreamFn AddStream) {
549   // Make sure commons have the right size/alignment: we kept the largest from
550   // all the prevailing when adding the inputs, and we apply it here.
551   const DataLayout &DL = RegularLTO.CombinedModule->getDataLayout();
552   for (auto &I : RegularLTO.Commons) {
553     if (!I.second.Prevailing)
554       // Don't do anything if no instance of this common was prevailing.
555       continue;
556     GlobalVariable *OldGV = RegularLTO.CombinedModule->getNamedGlobal(I.first);
557     if (OldGV && DL.getTypeAllocSize(OldGV->getValueType()) == I.second.Size) {
558       // Don't create a new global if the type is already correct, just make
559       // sure the alignment is correct.
560       OldGV->setAlignment(I.second.Align);
561       continue;
562     }
563     ArrayType *Ty =
564         ArrayType::get(Type::getInt8Ty(RegularLTO.Ctx), I.second.Size);
565     auto *GV = new GlobalVariable(*RegularLTO.CombinedModule, Ty, false,
566                                   GlobalValue::CommonLinkage,
567                                   ConstantAggregateZero::get(Ty), "");
568     GV->setAlignment(I.second.Align);
569     if (OldGV) {
570       OldGV->replaceAllUsesWith(ConstantExpr::getBitCast(GV, OldGV->getType()));
571       GV->takeName(OldGV);
572       OldGV->eraseFromParent();
573     } else {
574       GV->setName(I.first);
575     }
576   }
577 
578   if (Conf.PreOptModuleHook &&
579       !Conf.PreOptModuleHook(0, *RegularLTO.CombinedModule))
580     return Error::success();
581 
582   if (!Conf.CodeGenOnly) {
583     for (const auto &R : GlobalResolutions) {
584       if (R.second.IRName.empty())
585         continue;
586       if (R.second.Partition != 0 &&
587           R.second.Partition != GlobalResolution::External)
588         continue;
589 
590       GlobalValue *GV =
591           RegularLTO.CombinedModule->getNamedValue(R.second.IRName);
592       // Ignore symbols defined in other partitions.
593       if (!GV || GV->hasLocalLinkage())
594         continue;
595       GV->setUnnamedAddr(R.second.UnnamedAddr ? GlobalValue::UnnamedAddr::Global
596                                               : GlobalValue::UnnamedAddr::None);
597       if (R.second.Partition == 0)
598         GV->setLinkage(GlobalValue::InternalLinkage);
599     }
600 
601     if (Conf.PostInternalizeModuleHook &&
602         !Conf.PostInternalizeModuleHook(0, *RegularLTO.CombinedModule))
603       return Error::success();
604   }
605   return backend(Conf, AddStream, RegularLTO.ParallelCodeGenParallelismLevel,
606                  std::move(RegularLTO.CombinedModule));
607 }
608 
609 /// This class defines the interface to the ThinLTO backend.
610 class lto::ThinBackendProc {
611 protected:
612   Config &Conf;
613   ModuleSummaryIndex &CombinedIndex;
614   const StringMap<GVSummaryMapTy> &ModuleToDefinedGVSummaries;
615 
616 public:
617   ThinBackendProc(Config &Conf, ModuleSummaryIndex &CombinedIndex,
618                   const StringMap<GVSummaryMapTy> &ModuleToDefinedGVSummaries)
619       : Conf(Conf), CombinedIndex(CombinedIndex),
620         ModuleToDefinedGVSummaries(ModuleToDefinedGVSummaries) {}
621 
622   virtual ~ThinBackendProc() {}
623   virtual Error start(
624       unsigned Task, BitcodeModule BM,
625       const FunctionImporter::ImportMapTy &ImportList,
626       const FunctionImporter::ExportSetTy &ExportList,
627       const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
628       MapVector<StringRef, BitcodeModule> &ModuleMap) = 0;
629   virtual Error wait() = 0;
630 };
631 
632 namespace {
633 class InProcessThinBackend : public ThinBackendProc {
634   ThreadPool BackendThreadPool;
635   AddStreamFn AddStream;
636   NativeObjectCache Cache;
637 
638   Optional<Error> Err;
639   std::mutex ErrMu;
640 
641 public:
642   InProcessThinBackend(
643       Config &Conf, ModuleSummaryIndex &CombinedIndex,
644       unsigned ThinLTOParallelismLevel,
645       const StringMap<GVSummaryMapTy> &ModuleToDefinedGVSummaries,
646       AddStreamFn AddStream, NativeObjectCache Cache)
647       : ThinBackendProc(Conf, CombinedIndex, ModuleToDefinedGVSummaries),
648         BackendThreadPool(ThinLTOParallelismLevel),
649         AddStream(std::move(AddStream)), Cache(std::move(Cache)) {}
650 
651   Error runThinLTOBackendThread(
652       AddStreamFn AddStream, NativeObjectCache Cache, unsigned Task,
653       BitcodeModule BM, ModuleSummaryIndex &CombinedIndex,
654       const FunctionImporter::ImportMapTy &ImportList,
655       const FunctionImporter::ExportSetTy &ExportList,
656       const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
657       const GVSummaryMapTy &DefinedGlobals,
658       MapVector<StringRef, BitcodeModule> &ModuleMap) {
659     auto RunThinBackend = [&](AddStreamFn AddStream) {
660       LTOLLVMContext BackendContext(Conf);
661       Expected<std::unique_ptr<Module>> MOrErr = BM.parseModule(BackendContext);
662       if (!MOrErr)
663         return MOrErr.takeError();
664 
665       return thinBackend(Conf, Task, AddStream, **MOrErr, CombinedIndex,
666                          ImportList, DefinedGlobals, ModuleMap);
667     };
668 
669     auto ModuleID = BM.getModuleIdentifier();
670 
671     if (!Cache || !CombinedIndex.modulePaths().count(ModuleID) ||
672         all_of(CombinedIndex.getModuleHash(ModuleID),
673                [](uint32_t V) { return V == 0; }))
674       // Cache disabled or no entry for this module in the combined index or
675       // no module hash.
676       return RunThinBackend(AddStream);
677 
678     SmallString<40> Key;
679     // The module may be cached, this helps handling it.
680     computeCacheKey(Key, Conf, CombinedIndex, ModuleID, ImportList, ExportList,
681                     ResolvedODR, DefinedGlobals);
682     if (AddStreamFn CacheAddStream = Cache(Task, Key))
683       return RunThinBackend(CacheAddStream);
684 
685     return Error::success();
686   }
687 
688   Error start(
689       unsigned Task, BitcodeModule BM,
690       const FunctionImporter::ImportMapTy &ImportList,
691       const FunctionImporter::ExportSetTy &ExportList,
692       const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
693       MapVector<StringRef, BitcodeModule> &ModuleMap) override {
694     StringRef ModulePath = BM.getModuleIdentifier();
695     assert(ModuleToDefinedGVSummaries.count(ModulePath));
696     const GVSummaryMapTy &DefinedGlobals =
697         ModuleToDefinedGVSummaries.find(ModulePath)->second;
698     BackendThreadPool.async(
699         [=](BitcodeModule BM, ModuleSummaryIndex &CombinedIndex,
700             const FunctionImporter::ImportMapTy &ImportList,
701             const FunctionImporter::ExportSetTy &ExportList,
702             const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes>
703                 &ResolvedODR,
704             const GVSummaryMapTy &DefinedGlobals,
705             MapVector<StringRef, BitcodeModule> &ModuleMap) {
706           Error E = runThinLTOBackendThread(
707               AddStream, Cache, Task, BM, CombinedIndex, ImportList,
708               ExportList, ResolvedODR, DefinedGlobals, ModuleMap);
709           if (E) {
710             std::unique_lock<std::mutex> L(ErrMu);
711             if (Err)
712               Err = joinErrors(std::move(*Err), std::move(E));
713             else
714               Err = std::move(E);
715           }
716         },
717         BM, std::ref(CombinedIndex), std::ref(ImportList),
718         std::ref(ExportList), std::ref(ResolvedODR), std::ref(DefinedGlobals),
719         std::ref(ModuleMap));
720     return Error::success();
721   }
722 
723   Error wait() override {
724     BackendThreadPool.wait();
725     if (Err)
726       return std::move(*Err);
727     else
728       return Error::success();
729   }
730 };
731 } // end anonymous namespace
732 
733 ThinBackend lto::createInProcessThinBackend(unsigned ParallelismLevel) {
734   return [=](Config &Conf, ModuleSummaryIndex &CombinedIndex,
735              const StringMap<GVSummaryMapTy> &ModuleToDefinedGVSummaries,
736              AddStreamFn AddStream, NativeObjectCache Cache) {
737     return llvm::make_unique<InProcessThinBackend>(
738         Conf, CombinedIndex, ParallelismLevel, ModuleToDefinedGVSummaries,
739         AddStream, Cache);
740   };
741 }
742 
743 // Given the original \p Path to an output file, replace any path
744 // prefix matching \p OldPrefix with \p NewPrefix. Also, create the
745 // resulting directory if it does not yet exist.
746 std::string lto::getThinLTOOutputFile(const std::string &Path,
747                                       const std::string &OldPrefix,
748                                       const std::string &NewPrefix) {
749   if (OldPrefix.empty() && NewPrefix.empty())
750     return Path;
751   SmallString<128> NewPath(Path);
752   llvm::sys::path::replace_path_prefix(NewPath, OldPrefix, NewPrefix);
753   StringRef ParentPath = llvm::sys::path::parent_path(NewPath.str());
754   if (!ParentPath.empty()) {
755     // Make sure the new directory exists, creating it if necessary.
756     if (std::error_code EC = llvm::sys::fs::create_directories(ParentPath))
757       llvm::errs() << "warning: could not create directory '" << ParentPath
758                    << "': " << EC.message() << '\n';
759   }
760   return NewPath.str();
761 }
762 
763 namespace {
764 class WriteIndexesThinBackend : public ThinBackendProc {
765   std::string OldPrefix, NewPrefix;
766   bool ShouldEmitImportsFiles;
767 
768   std::string LinkedObjectsFileName;
769   std::unique_ptr<llvm::raw_fd_ostream> LinkedObjectsFile;
770 
771 public:
772   WriteIndexesThinBackend(
773       Config &Conf, ModuleSummaryIndex &CombinedIndex,
774       const StringMap<GVSummaryMapTy> &ModuleToDefinedGVSummaries,
775       std::string OldPrefix, std::string NewPrefix, bool ShouldEmitImportsFiles,
776       std::string LinkedObjectsFileName)
777       : ThinBackendProc(Conf, CombinedIndex, ModuleToDefinedGVSummaries),
778         OldPrefix(OldPrefix), NewPrefix(NewPrefix),
779         ShouldEmitImportsFiles(ShouldEmitImportsFiles),
780         LinkedObjectsFileName(LinkedObjectsFileName) {}
781 
782   Error start(
783       unsigned Task, BitcodeModule BM,
784       const FunctionImporter::ImportMapTy &ImportList,
785       const FunctionImporter::ExportSetTy &ExportList,
786       const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
787       MapVector<StringRef, BitcodeModule> &ModuleMap) override {
788     StringRef ModulePath = BM.getModuleIdentifier();
789     std::string NewModulePath =
790         getThinLTOOutputFile(ModulePath, OldPrefix, NewPrefix);
791 
792     std::error_code EC;
793     if (!LinkedObjectsFileName.empty()) {
794       if (!LinkedObjectsFile) {
795         LinkedObjectsFile = llvm::make_unique<raw_fd_ostream>(
796             LinkedObjectsFileName, EC, sys::fs::OpenFlags::F_None);
797         if (EC)
798           return errorCodeToError(EC);
799       }
800       *LinkedObjectsFile << NewModulePath << '\n';
801     }
802 
803     std::map<std::string, GVSummaryMapTy> ModuleToSummariesForIndex;
804     gatherImportedSummariesForModule(ModulePath, ModuleToDefinedGVSummaries,
805                                      ImportList, ModuleToSummariesForIndex);
806 
807     raw_fd_ostream OS(NewModulePath + ".thinlto.bc", EC,
808                       sys::fs::OpenFlags::F_None);
809     if (EC)
810       return errorCodeToError(EC);
811     WriteIndexToFile(CombinedIndex, OS, &ModuleToSummariesForIndex);
812 
813     if (ShouldEmitImportsFiles)
814       return errorCodeToError(
815           EmitImportsFiles(ModulePath, NewModulePath + ".imports", ImportList));
816     return Error::success();
817   }
818 
819   Error wait() override { return Error::success(); }
820 };
821 } // end anonymous namespace
822 
823 ThinBackend lto::createWriteIndexesThinBackend(std::string OldPrefix,
824                                                std::string NewPrefix,
825                                                bool ShouldEmitImportsFiles,
826                                                std::string LinkedObjectsFile) {
827   return [=](Config &Conf, ModuleSummaryIndex &CombinedIndex,
828              const StringMap<GVSummaryMapTy> &ModuleToDefinedGVSummaries,
829              AddStreamFn AddStream, NativeObjectCache Cache) {
830     return llvm::make_unique<WriteIndexesThinBackend>(
831         Conf, CombinedIndex, ModuleToDefinedGVSummaries, OldPrefix, NewPrefix,
832         ShouldEmitImportsFiles, LinkedObjectsFile);
833   };
834 }
835 
836 Error LTO::runThinLTO(AddStreamFn AddStream, NativeObjectCache Cache,
837                       bool HasRegularLTO) {
838   if (ThinLTO.ModuleMap.empty())
839     return Error::success();
840 
841   if (Conf.CombinedIndexHook && !Conf.CombinedIndexHook(ThinLTO.CombinedIndex))
842     return Error::success();
843 
844   // Collect for each module the list of function it defines (GUID ->
845   // Summary).
846   StringMap<std::map<GlobalValue::GUID, GlobalValueSummary *>>
847       ModuleToDefinedGVSummaries(ThinLTO.ModuleMap.size());
848   ThinLTO.CombinedIndex.collectDefinedGVSummariesPerModule(
849       ModuleToDefinedGVSummaries);
850   // Create entries for any modules that didn't have any GV summaries
851   // (either they didn't have any GVs to start with, or we suppressed
852   // generation of the summaries because they e.g. had inline assembly
853   // uses that couldn't be promoted/renamed on export). This is so
854   // InProcessThinBackend::start can still launch a backend thread, which
855   // is passed the map of summaries for the module, without any special
856   // handling for this case.
857   for (auto &Mod : ThinLTO.ModuleMap)
858     if (!ModuleToDefinedGVSummaries.count(Mod.first))
859       ModuleToDefinedGVSummaries.try_emplace(Mod.first);
860 
861   // Compute "dead" symbols, we don't want to import/export these!
862   DenseSet<GlobalValue::GUID> GUIDPreservedSymbols;
863   for (auto &Res : GlobalResolutions) {
864     if (Res.second.VisibleOutsideThinLTO &&
865         // IRName will be defined if we have seen the prevailing copy of
866         // this value. If not, no need to preserve any ThinLTO copies.
867         !Res.second.IRName.empty())
868       GUIDPreservedSymbols.insert(GlobalValue::getGUID(Res.second.IRName));
869   }
870 
871   auto DeadSymbols =
872       computeDeadSymbols(ThinLTO.CombinedIndex, GUIDPreservedSymbols);
873 
874   StringMap<FunctionImporter::ImportMapTy> ImportLists(
875       ThinLTO.ModuleMap.size());
876   StringMap<FunctionImporter::ExportSetTy> ExportLists(
877       ThinLTO.ModuleMap.size());
878   StringMap<std::map<GlobalValue::GUID, GlobalValue::LinkageTypes>> ResolvedODR;
879 
880   if (Conf.OptLevel > 0) {
881     ComputeCrossModuleImport(ThinLTO.CombinedIndex, ModuleToDefinedGVSummaries,
882                              ImportLists, ExportLists, &DeadSymbols);
883 
884     std::set<GlobalValue::GUID> ExportedGUIDs;
885     for (auto &Res : GlobalResolutions) {
886       // First check if the symbol was flagged as having external references.
887       if (Res.second.Partition != GlobalResolution::External)
888         continue;
889       // IRName will be defined if we have seen the prevailing copy of
890       // this value. If not, no need to mark as exported from a ThinLTO
891       // partition (and we can't get the GUID).
892       if (Res.second.IRName.empty())
893         continue;
894       auto GUID = GlobalValue::getGUID(Res.second.IRName);
895       // Mark exported unless index-based analysis determined it to be dead.
896       if (!DeadSymbols.count(GUID))
897         ExportedGUIDs.insert(GlobalValue::getGUID(Res.second.IRName));
898     }
899 
900     auto isPrevailing = [&](GlobalValue::GUID GUID,
901                             const GlobalValueSummary *S) {
902       return ThinLTO.PrevailingModuleForGUID[GUID] == S->modulePath();
903     };
904     auto isExported = [&](StringRef ModuleIdentifier, GlobalValue::GUID GUID) {
905       const auto &ExportList = ExportLists.find(ModuleIdentifier);
906       return (ExportList != ExportLists.end() &&
907               ExportList->second.count(GUID)) ||
908              ExportedGUIDs.count(GUID);
909     };
910     thinLTOInternalizeAndPromoteInIndex(ThinLTO.CombinedIndex, isExported);
911 
912     auto recordNewLinkage = [&](StringRef ModuleIdentifier,
913                                 GlobalValue::GUID GUID,
914                                 GlobalValue::LinkageTypes NewLinkage) {
915       ResolvedODR[ModuleIdentifier][GUID] = NewLinkage;
916     };
917 
918     thinLTOResolveWeakForLinkerInIndex(ThinLTO.CombinedIndex, isPrevailing,
919                                        recordNewLinkage);
920   }
921 
922   std::unique_ptr<ThinBackendProc> BackendProc =
923       ThinLTO.Backend(Conf, ThinLTO.CombinedIndex, ModuleToDefinedGVSummaries,
924                       AddStream, Cache);
925 
926   // Task numbers start at ParallelCodeGenParallelismLevel if an LTO
927   // module is present, as tasks 0 through ParallelCodeGenParallelismLevel-1
928   // are reserved for parallel code generation partitions.
929   unsigned Task =
930       HasRegularLTO ? RegularLTO.ParallelCodeGenParallelismLevel : 0;
931   for (auto &Mod : ThinLTO.ModuleMap) {
932     if (Error E = BackendProc->start(Task, Mod.second, ImportLists[Mod.first],
933                                      ExportLists[Mod.first],
934                                      ResolvedODR[Mod.first], ThinLTO.ModuleMap))
935       return E;
936     ++Task;
937   }
938 
939   return BackendProc->wait();
940 }
941