LLVM 23.0.0git
LTO.cpp
Go to the documentation of this file.
1//===-LTO.cpp - LLVM Link Time Optimizer ----------------------------------===//
2//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
6//
7//===----------------------------------------------------------------------===//
8//
9// This file implements functions and classes used to support LTO.
10//
11//===----------------------------------------------------------------------===//
12
13#include "llvm/LTO/LTO.h"
14#include "llvm/ADT/ArrayRef.h"
15#include "llvm/ADT/ScopeExit.h"
16#include "llvm/ADT/SmallSet.h"
18#include "llvm/ADT/Statistic.h"
27#include "llvm/Config/llvm-config.h"
28#include "llvm/IR/AutoUpgrade.h"
30#include "llvm/IR/Intrinsics.h"
33#include "llvm/IR/Mangler.h"
34#include "llvm/IR/Metadata.h"
36#include "llvm/LTO/LTOBackend.h"
37#include "llvm/Linker/IRMover.h"
43#include "llvm/Support/Error.h"
45#include "llvm/Support/JSON.h"
47#include "llvm/Support/Path.h"
49#include "llvm/Support/SHA1.h"
56#include "llvm/Support/VCSRevision.h"
59#include "llvm/Transforms/IPO.h"
64
65#include <optional>
66#include <set>
67
68using namespace llvm;
69using namespace lto;
70using namespace object;
71
72#define DEBUG_TYPE "lto"
73
74static cl::opt<bool>
75 DumpThinCGSCCs("dump-thin-cg-sccs", cl::init(false), cl::Hidden,
76 cl::desc("Dump the SCCs in the ThinLTO index's callgraph"));
77
78namespace llvm {
81} // end namespace llvm
82
83namespace llvm {
84/// Enable global value internalization in LTO.
86 "enable-lto-internalization", cl::init(true), cl::Hidden,
87 cl::desc("Enable global value internalization in LTO"));
88
89static cl::opt<bool>
90 LTOKeepSymbolCopies("lto-keep-symbol-copies", cl::init(false), cl::Hidden,
91 cl::desc("Keep copies of symbols in LTO indexing"));
92
93/// Indicate we are linking with an allocator that supports hot/cold operator
94/// new interfaces.
96
97/// Enable MemProf context disambiguation for thin link.
99} // namespace llvm
100
101// Computes a unique hash for the Module considering the current list of
102// export/import and other global analysis results.
103// Returns the hash in its hexadecimal representation.
105 const Config &Conf, const ModuleSummaryIndex &Index, StringRef ModuleID,
106 const FunctionImporter::ImportMapTy &ImportList,
107 const FunctionImporter::ExportSetTy &ExportList,
108 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
109 const GVSummaryMapTy &DefinedGlobals,
110 const DenseSet<GlobalValue::GUID> &CfiFunctionDefs,
111 const DenseSet<GlobalValue::GUID> &CfiFunctionDecls) {
112 // Compute the unique hash for this entry.
113 // This is based on the current compiler version, the module itself, the
114 // export list, the hash for every single module in the import list, the
115 // list of ResolvedODR for the module, and the list of preserved symbols.
116 SHA1 Hasher;
117
118 // Start with the compiler revision
119 Hasher.update(LLVM_VERSION_STRING);
120#ifdef LLVM_REVISION
121 Hasher.update(LLVM_REVISION);
122#endif
123
124 // Include the parts of the LTO configuration that affect code generation.
125 auto AddString = [&](StringRef Str) {
126 Hasher.update(Str);
127 Hasher.update(ArrayRef<uint8_t>{0});
128 };
129 auto AddUnsigned = [&](unsigned I) {
130 uint8_t Data[4];
132 Hasher.update(Data);
133 };
134 auto AddUint64 = [&](uint64_t I) {
135 uint8_t Data[8];
137 Hasher.update(Data);
138 };
139 auto AddUint8 = [&](const uint8_t I) {
140 Hasher.update(ArrayRef<uint8_t>(&I, 1));
141 };
142 AddString(Conf.CPU);
143 // FIXME: Hash more of Options. For now all clients initialize Options from
144 // command-line flags (which is unsupported in production), but may set
145 // X86RelaxRelocations. The clang driver can also pass FunctionSections,
146 // DataSections and DebuggerTuning via command line flags.
147 AddUnsigned(Conf.Options.MCOptions.X86RelaxRelocations);
148 AddUnsigned(Conf.Options.FunctionSections);
149 AddUnsigned(Conf.Options.DataSections);
150 AddUnsigned((unsigned)Conf.Options.DebuggerTuning);
151 for (auto &A : Conf.MAttrs)
152 AddString(A);
153 if (Conf.RelocModel)
154 AddUnsigned(*Conf.RelocModel);
155 else
156 AddUnsigned(-1);
157 if (Conf.CodeModel)
158 AddUnsigned(*Conf.CodeModel);
159 else
160 AddUnsigned(-1);
161 for (const auto &S : Conf.MllvmArgs)
162 AddString(S);
163 AddUnsigned(static_cast<int>(Conf.CGOptLevel));
164 AddUnsigned(static_cast<int>(Conf.CGFileType));
165 AddUnsigned(Conf.OptLevel);
166 AddUnsigned(Conf.Freestanding);
167 AddString(Conf.OptPipeline);
168 AddString(Conf.AAPipeline);
169 AddString(Conf.OverrideTriple);
170 AddString(Conf.DefaultTriple);
171 AddString(Conf.DwoDir);
172 AddUint8(Conf.Dtlto);
173
174 // Include the hash for the current module
175 auto ModHash = Index.getModuleHash(ModuleID);
176 Hasher.update(ArrayRef<uint8_t>((uint8_t *)&ModHash[0], sizeof(ModHash)));
177
178 // TODO: `ExportList` is determined by `ImportList`. Since `ImportList` is
179 // used to compute cache key, we could omit hashing `ExportList` here.
180 std::vector<uint64_t> ExportsGUID;
181 ExportsGUID.reserve(ExportList.size());
182 for (const auto &VI : ExportList)
183 ExportsGUID.push_back(VI.getGUID());
184
185 // Sort the export list elements GUIDs.
186 llvm::sort(ExportsGUID);
187 for (auto GUID : ExportsGUID)
188 Hasher.update(ArrayRef<uint8_t>((uint8_t *)&GUID, sizeof(GUID)));
189
190 // Order using module hash, to be both independent of module name and
191 // module order.
192 auto Comp = [&](const std::pair<StringRef, GlobalValue::GUID> &L,
193 const std::pair<StringRef, GlobalValue::GUID> &R) {
194 return std::make_pair(Index.getModule(L.first)->second, L.second) <
195 std::make_pair(Index.getModule(R.first)->second, R.second);
196 };
197 FunctionImporter::SortedImportList SortedImportList(ImportList, Comp);
198
199 // Count the number of imports for each source module.
200 DenseMap<StringRef, unsigned> ModuleToNumImports;
201 for (const auto &[FromModule, GUID, Type] : SortedImportList)
202 ++ModuleToNumImports[FromModule];
203
204 std::optional<StringRef> LastModule;
205 for (const auto &[FromModule, GUID, Type] : SortedImportList) {
206 if (LastModule != FromModule) {
207 // Include the hash for every module we import functions from. The set of
208 // imported symbols for each module may affect code generation and is
209 // sensitive to link order, so include that as well.
210 LastModule = FromModule;
211 auto ModHash = Index.getModule(FromModule)->second;
212 Hasher.update(ArrayRef<uint8_t>((uint8_t *)&ModHash[0], sizeof(ModHash)));
213 AddUint64(ModuleToNumImports[FromModule]);
214 }
215 AddUint64(GUID);
216 AddUint8(Type);
217 }
218
219 // Include the hash for the resolved ODR.
220 for (auto &Entry : ResolvedODR) {
221 Hasher.update(ArrayRef<uint8_t>((const uint8_t *)&Entry.first,
222 sizeof(GlobalValue::GUID)));
223 Hasher.update(ArrayRef<uint8_t>((const uint8_t *)&Entry.second,
225 }
226
227 // Members of CfiFunctionDefs and CfiFunctionDecls that are referenced or
228 // defined in this module.
229 std::set<GlobalValue::GUID> UsedCfiDefs;
230 std::set<GlobalValue::GUID> UsedCfiDecls;
231
232 // Typeids used in this module.
233 std::set<GlobalValue::GUID> UsedTypeIds;
234
235 auto AddUsedCfiGlobal = [&](GlobalValue::GUID ValueGUID) {
236 if (CfiFunctionDefs.contains(ValueGUID))
237 UsedCfiDefs.insert(ValueGUID);
238 if (CfiFunctionDecls.contains(ValueGUID))
239 UsedCfiDecls.insert(ValueGUID);
240 };
241
242 auto AddUsedThings = [&](GlobalValueSummary *GS) {
243 if (!GS) return;
244 AddUnsigned(GS->getVisibility());
245 AddUnsigned(GS->isLive());
246 AddUnsigned(GS->canAutoHide());
247 for (const ValueInfo &VI : GS->refs()) {
248 AddUnsigned(VI.isDSOLocal(Index.withDSOLocalPropagation()));
249 AddUsedCfiGlobal(VI.getGUID());
250 }
251 if (auto *GVS = dyn_cast<GlobalVarSummary>(GS)) {
252 AddUnsigned(GVS->maybeReadOnly());
253 AddUnsigned(GVS->maybeWriteOnly());
254 }
255 if (auto *FS = dyn_cast<FunctionSummary>(GS)) {
256 for (auto &TT : FS->type_tests())
257 UsedTypeIds.insert(TT);
258 for (auto &TT : FS->type_test_assume_vcalls())
259 UsedTypeIds.insert(TT.GUID);
260 for (auto &TT : FS->type_checked_load_vcalls())
261 UsedTypeIds.insert(TT.GUID);
262 for (auto &TT : FS->type_test_assume_const_vcalls())
263 UsedTypeIds.insert(TT.VFunc.GUID);
264 for (auto &TT : FS->type_checked_load_const_vcalls())
265 UsedTypeIds.insert(TT.VFunc.GUID);
266 for (auto &ET : FS->calls()) {
267 AddUnsigned(ET.first.isDSOLocal(Index.withDSOLocalPropagation()));
268 AddUsedCfiGlobal(ET.first.getGUID());
269 }
270 }
271 };
272
273 // Include the hash for the linkage type to reflect internalization and weak
274 // resolution, and collect any used type identifier resolutions.
275 for (auto &GS : DefinedGlobals) {
276 GlobalValue::LinkageTypes Linkage = GS.second->linkage();
277 Hasher.update(
278 ArrayRef<uint8_t>((const uint8_t *)&Linkage, sizeof(Linkage)));
279 AddUsedCfiGlobal(GS.first);
280 AddUsedThings(GS.second);
281 }
282
283 // Imported functions may introduce new uses of type identifier resolutions,
284 // so we need to collect their used resolutions as well.
285 for (const auto &[FromModule, GUID, Type] : SortedImportList) {
286 GlobalValueSummary *S = Index.findSummaryInModule(GUID, FromModule);
287 AddUsedThings(S);
288 // If this is an alias, we also care about any types/etc. that the aliasee
289 // may reference.
290 if (auto *AS = dyn_cast_or_null<AliasSummary>(S))
291 AddUsedThings(AS->getBaseObject());
292 }
293
294 auto AddTypeIdSummary = [&](StringRef TId, const TypeIdSummary &S) {
295 AddString(TId);
296
297 AddUnsigned(S.TTRes.TheKind);
298 AddUnsigned(S.TTRes.SizeM1BitWidth);
299
300 AddUint64(S.TTRes.AlignLog2);
301 AddUint64(S.TTRes.SizeM1);
302 AddUint64(S.TTRes.BitMask);
303 AddUint64(S.TTRes.InlineBits);
304
305 AddUint64(S.WPDRes.size());
306 for (auto &WPD : S.WPDRes) {
307 AddUnsigned(WPD.first);
308 AddUnsigned(WPD.second.TheKind);
309 AddString(WPD.second.SingleImplName);
310
311 AddUint64(WPD.second.ResByArg.size());
312 for (auto &ByArg : WPD.second.ResByArg) {
313 AddUint64(ByArg.first.size());
314 for (uint64_t Arg : ByArg.first)
315 AddUint64(Arg);
316 AddUnsigned(ByArg.second.TheKind);
317 AddUint64(ByArg.second.Info);
318 AddUnsigned(ByArg.second.Byte);
319 AddUnsigned(ByArg.second.Bit);
320 }
321 }
322 };
323
324 // Include the hash for all type identifiers used by this module.
325 for (GlobalValue::GUID TId : UsedTypeIds) {
326 auto TidIter = Index.typeIds().equal_range(TId);
327 for (const auto &I : make_range(TidIter))
328 AddTypeIdSummary(I.second.first, I.second.second);
329 }
330
331 AddUnsigned(UsedCfiDefs.size());
332 for (auto &V : UsedCfiDefs)
333 AddUint64(V);
334
335 AddUnsigned(UsedCfiDecls.size());
336 for (auto &V : UsedCfiDecls)
337 AddUint64(V);
338
339 if (!Conf.SampleProfile.empty()) {
340 auto FileOrErr = MemoryBuffer::getFile(Conf.SampleProfile);
341 if (FileOrErr) {
342 Hasher.update(FileOrErr.get()->getBuffer());
343
344 if (!Conf.ProfileRemapping.empty()) {
345 FileOrErr = MemoryBuffer::getFile(Conf.ProfileRemapping);
346 if (FileOrErr)
347 Hasher.update(FileOrErr.get()->getBuffer());
348 }
349 }
350 }
351
352 return toHex(Hasher.result());
353}
354
355std::string llvm::recomputeLTOCacheKey(const std::string &Key,
356 StringRef ExtraID) {
357 SHA1 Hasher;
358
359 auto AddString = [&](StringRef Str) {
360 Hasher.update(Str);
361 Hasher.update(ArrayRef<uint8_t>{0});
362 };
363 AddString(Key);
364 AddString(ExtraID);
365
366 return toHex(Hasher.result());
367}
368
370 const Config &C, ValueInfo VI,
371 DenseSet<GlobalValueSummary *> &GlobalInvolvedWithAlias,
373 isPrevailing,
375 recordNewLinkage,
376 const DenseSet<GlobalValue::GUID> &GUIDPreservedSymbols) {
378 C.VisibilityScheme == Config::ELF ? VI.getELFVisibility()
380 for (auto &S : VI.getSummaryList()) {
381 GlobalValue::LinkageTypes OriginalLinkage = S->linkage();
382 // Ignore local and appending linkage values since the linker
383 // doesn't resolve them.
384 if (GlobalValue::isLocalLinkage(OriginalLinkage) ||
386 continue;
387 // We need to emit only one of these. The prevailing module will keep it,
388 // but turned into a weak, while the others will drop it when possible.
389 // This is both a compile-time optimization and a correctness
390 // transformation. This is necessary for correctness when we have exported
391 // a reference - we need to convert the linkonce to weak to
392 // ensure a copy is kept to satisfy the exported reference.
393 // FIXME: We may want to split the compile time and correctness
394 // aspects into separate routines.
395 if (isPrevailing(VI.getGUID(), S.get())) {
396 if (GlobalValue::isLinkOnceLinkage(OriginalLinkage)) {
397 S->setLinkage(GlobalValue::getWeakLinkage(
398 GlobalValue::isLinkOnceODRLinkage(OriginalLinkage)));
399 // The kept copy is eligible for auto-hiding (hidden visibility) if all
400 // copies were (i.e. they were all linkonce_odr global unnamed addr).
401 // If any copy is not (e.g. it was originally weak_odr), then the symbol
402 // must remain externally available (e.g. a weak_odr from an explicitly
403 // instantiated template). Additionally, if it is in the
404 // GUIDPreservedSymbols set, that means that it is visibile outside
405 // the summary (e.g. in a native object or a bitcode file without
406 // summary), and in that case we cannot hide it as it isn't possible to
407 // check all copies.
408 S->setCanAutoHide(VI.canAutoHide() &&
409 !GUIDPreservedSymbols.count(VI.getGUID()));
410 }
411 if (C.VisibilityScheme == Config::FromPrevailing)
412 Visibility = S->getVisibility();
413 }
414 // Alias and aliasee can't be turned into available_externally.
415 // When force-import-all is used, it indicates that object linking is not
416 // supported by the target. In this case, we can't change the linkage as
417 // well in case the global is converted to declaration.
418 else if (!isa<AliasSummary>(S.get()) &&
419 !GlobalInvolvedWithAlias.count(S.get()) && !ForceImportAll)
421
422 // For ELF, set visibility to the computed visibility from summaries. We
423 // don't track visibility from declarations so this may be more relaxed than
424 // the most constraining one.
425 if (C.VisibilityScheme == Config::ELF)
426 S->setVisibility(Visibility);
427
428 if (S->linkage() != OriginalLinkage)
429 recordNewLinkage(S->modulePath(), VI.getGUID(), S->linkage());
430 }
431
432 if (C.VisibilityScheme == Config::FromPrevailing) {
433 for (auto &S : VI.getSummaryList()) {
434 GlobalValue::LinkageTypes OriginalLinkage = S->linkage();
435 if (GlobalValue::isLocalLinkage(OriginalLinkage) ||
437 continue;
438 S->setVisibility(Visibility);
439 }
440 }
441}
442
443/// Resolve linkage for prevailing symbols in the \p Index.
444//
445// We'd like to drop these functions if they are no longer referenced in the
446// current module. However there is a chance that another module is still
447// referencing them because of the import. We make sure we always emit at least
448// one copy.
450 const Config &C, ModuleSummaryIndex &Index,
452 isPrevailing,
454 recordNewLinkage,
455 const DenseSet<GlobalValue::GUID> &GUIDPreservedSymbols) {
456 // We won't optimize the globals that are referenced by an alias for now
457 // Ideally we should turn the alias into a global and duplicate the definition
458 // when needed.
459 DenseSet<GlobalValueSummary *> GlobalInvolvedWithAlias;
460 for (auto &I : Index)
461 for (auto &S : I.second.getSummaryList())
462 if (auto AS = dyn_cast<AliasSummary>(S.get()))
463 GlobalInvolvedWithAlias.insert(&AS->getAliasee());
464
465 for (auto &I : Index)
466 thinLTOResolvePrevailingGUID(C, Index.getValueInfo(I),
467 GlobalInvolvedWithAlias, isPrevailing,
468 recordNewLinkage, GUIDPreservedSymbols);
469}
470
472 ValueInfo VI, function_ref<bool(StringRef, ValueInfo)> isExported,
474 isPrevailing) {
475 // Before performing index-based internalization and promotion for this GUID,
476 // the local flag should be consistent with the summary list linkage types.
477 VI.verifyLocal();
478
479 const bool SingleExternallyVisibleCopy =
480 VI.getSummaryList().size() == 1 &&
481 !GlobalValue::isLocalLinkage(VI.getSummaryList().front()->linkage());
482
483 for (auto &S : VI.getSummaryList()) {
484 // First see if we need to promote an internal value because it is not
485 // exported.
486 if (isExported(S->modulePath(), VI)) {
487 if (GlobalValue::isLocalLinkage(S->linkage()))
488 S->setLinkage(GlobalValue::ExternalLinkage);
489 continue;
490 }
491
492 // Otherwise, see if we can internalize.
494 continue;
495
496 // Non-exported values with external linkage can be internalized.
497 if (GlobalValue::isExternalLinkage(S->linkage())) {
498 S->setLinkage(GlobalValue::InternalLinkage);
499 continue;
500 }
501
502 // Non-exported function and variable definitions with a weak-for-linker
503 // linkage can be internalized in certain cases. The minimum legality
504 // requirements would be that they are not address taken to ensure that we
505 // don't break pointer equality checks, and that variables are either read-
506 // or write-only. For functions, this is the case if either all copies are
507 // [local_]unnamed_addr, or we can propagate reference edge attributes
508 // (which is how this is guaranteed for variables, when analyzing whether
509 // they are read or write-only).
510 //
511 // However, we only get to this code for weak-for-linkage values in one of
512 // two cases:
513 // 1) The prevailing copy is not in IR (it is in native code).
514 // 2) The prevailing copy in IR is not exported from its module.
515 // Additionally, at least for the new LTO API, case 2 will only happen if
516 // there is exactly one definition of the value (i.e. in exactly one
517 // module), as duplicate defs are result in the value being marked exported.
518 // Likely, users of the legacy LTO API are similar, however, currently there
519 // are llvm-lto based tests of the legacy LTO API that do not mark
520 // duplicate linkonce_odr copies as exported via the tool, so we need
521 // to handle that case below by checking the number of copies.
522 //
523 // Generally, we only want to internalize a weak-for-linker value in case
524 // 2, because in case 1 we cannot see how the value is used to know if it
525 // is read or write-only. We also don't want to bloat the binary with
526 // multiple internalized copies of non-prevailing linkonce/weak functions.
527 // Note if we don't internalize, we will convert non-prevailing copies to
528 // available_externally anyway, so that we drop them after inlining. The
529 // only reason to internalize such a function is if we indeed have a single
530 // copy, because internalizing it won't increase binary size, and enables
531 // use of inliner heuristics that are more aggressive in the face of a
532 // single call to a static (local). For variables, internalizing a read or
533 // write only variable can enable more aggressive optimization. However, we
534 // already perform this elsewhere in the ThinLTO backend handling for
535 // read or write-only variables (processGlobalForThinLTO).
536 //
537 // Therefore, only internalize linkonce/weak if there is a single copy, that
538 // is prevailing in this IR module. We can do so aggressively, without
539 // requiring the address to be insignificant, or that a variable be read or
540 // write-only.
541 if (!GlobalValue::isWeakForLinker(S->linkage()) ||
543 continue;
544
545 // We may have a single summary copy that is externally visible but not
546 // prevailing if the prevailing copy is in a native object.
547 if (SingleExternallyVisibleCopy && isPrevailing(VI.getGUID(), S.get()))
548 S->setLinkage(GlobalValue::InternalLinkage);
549 }
550}
551
552// Update the linkages in the given \p Index to mark exported values
553// as external and non-exported values as internal.
555 ModuleSummaryIndex &Index,
556 function_ref<bool(StringRef, ValueInfo)> isExported,
558 isPrevailing) {
559 assert(!Index.withInternalizeAndPromote());
560 for (auto &I : Index)
561 thinLTOInternalizeAndPromoteGUID(Index.getValueInfo(I), isExported,
562 isPrevailing);
563 Index.setWithInternalizeAndPromote();
564}
565
566// Requires a destructor for std::vector<InputModule>.
567InputFile::~InputFile() = default;
568
570 std::unique_ptr<InputFile> File(new InputFile);
571
572 Expected<IRSymtabFile> FOrErr = readIRSymtab(Object);
573 if (!FOrErr)
574 return FOrErr.takeError();
575
576 File->TargetTriple = FOrErr->TheReader.getTargetTriple();
577 File->SourceFileName = FOrErr->TheReader.getSourceFileName();
578 File->COFFLinkerOpts = FOrErr->TheReader.getCOFFLinkerOpts();
579 File->DependentLibraries = FOrErr->TheReader.getDependentLibraries();
580 File->ComdatTable = FOrErr->TheReader.getComdatTable();
581 File->MbRef =
582 Object; // Save a memory buffer reference to an input file object.
583
584 for (unsigned I = 0; I != FOrErr->Mods.size(); ++I) {
585 size_t Begin = File->Symbols.size();
586 for (const irsymtab::Reader::SymbolRef &Sym :
587 FOrErr->TheReader.module_symbols(I))
588 // Skip symbols that are irrelevant to LTO. Note that this condition needs
589 // to match the one in Skip() in LTO::addRegularLTO().
590 if (Sym.isGlobal() && !Sym.isFormatSpecific())
591 File->Symbols.push_back(Sym);
592 File->ModuleSymIndices.push_back({Begin, File->Symbols.size()});
593 }
594
595 File->Mods = FOrErr->Mods;
596 File->Strtab = std::move(FOrErr->Strtab);
597 return std::move(File);
598}
599
601 return Mods[0].getModuleIdentifier();
602}
603
605 assert(Mods.size() == 1 && "Expect only one bitcode module");
606 return Mods[0];
607}
608
610
611LTO::RegularLTOState::RegularLTOState(unsigned ParallelCodeGenParallelismLevel,
612 const Config &Conf)
613 : ParallelCodeGenParallelismLevel(ParallelCodeGenParallelismLevel),
614 Ctx(Conf), CombinedModule(std::make_unique<Module>("ld-temp.o", Ctx)),
615 Mover(std::make_unique<IRMover>(*CombinedModule)) {}
616
617LTO::ThinLTOState::ThinLTOState(ThinBackend BackendParam)
618 : Backend(std::move(BackendParam)), CombinedIndex(/*HaveGVs*/ false) {
619 if (!Backend.isValid())
620 Backend =
622}
623
625 unsigned ParallelCodeGenParallelismLevel, LTOKind LTOMode)
626 : Conf(std::move(Conf)),
627 RegularLTO(ParallelCodeGenParallelismLevel, this->Conf),
628 ThinLTO(std::move(Backend)),
629 GlobalResolutions(
630 std::make_unique<DenseMap<StringRef, GlobalResolution>>()),
631 LTOMode(LTOMode) {
632 if (Conf.KeepSymbolNameCopies || LTOKeepSymbolCopies) {
633 Alloc = std::make_unique<BumpPtrAllocator>();
634 GlobalResolutionSymbolSaver = std::make_unique<llvm::StringSaver>(*Alloc);
635 }
636}
637
638// Requires a destructor for MapVector<BitcodeModule>.
639LTO::~LTO() = default;
640
641// Add the symbols in the given module to the GlobalResolutions map, and resolve
642// their partitions.
643void LTO::addModuleToGlobalRes(ArrayRef<InputFile::Symbol> Syms,
645 unsigned Partition, bool InSummary) {
646 llvm::TimeTraceScope timeScope("LTO add module to global resolution");
647 auto *ResI = Res.begin();
648 auto *ResE = Res.end();
649 (void)ResE;
650 for (const InputFile::Symbol &Sym : Syms) {
651 assert(ResI != ResE);
652 SymbolResolution Res = *ResI++;
653
654 StringRef SymbolName = Sym.getName();
655 // Keep copies of symbols if the client of LTO says so.
656 if (GlobalResolutionSymbolSaver && !GlobalResolutions->contains(SymbolName))
657 SymbolName = GlobalResolutionSymbolSaver->save(SymbolName);
658
659 auto &GlobalRes = (*GlobalResolutions)[SymbolName];
660 GlobalRes.UnnamedAddr &= Sym.isUnnamedAddr();
661 if (Res.Prevailing) {
662 assert(!GlobalRes.Prevailing &&
663 "Multiple prevailing defs are not allowed");
664 GlobalRes.Prevailing = true;
665 GlobalRes.IRName = std::string(Sym.getIRName());
666 } else if (!GlobalRes.Prevailing && GlobalRes.IRName.empty()) {
667 // Sometimes it can be two copies of symbol in a module and prevailing
668 // symbol can have no IR name. That might happen if symbol is defined in
669 // module level inline asm block. In case we have multiple modules with
670 // the same symbol we want to use IR name of the prevailing symbol.
671 // Otherwise, if we haven't seen a prevailing symbol, set the name so that
672 // we can later use it to check if there is any prevailing copy in IR.
673 GlobalRes.IRName = std::string(Sym.getIRName());
674 }
675
676 // In rare occasion, the symbol used to initialize GlobalRes has a different
677 // IRName from the inspected Symbol. This can happen on macOS + iOS, when a
678 // symbol is referenced through its mangled name, say @"\01_symbol" while
679 // the IRName is @symbol (the prefix underscore comes from MachO mangling).
680 // In that case, we have the same actual Symbol that can get two different
681 // GUID, leading to some invalid internalization. Workaround this by marking
682 // the GlobalRes external.
683
684 // FIXME: instead of this check, it would be desirable to compute GUIDs
685 // based on mangled name, but this requires an access to the Target Triple
686 // and would be relatively invasive on the codebase.
687 if (GlobalRes.IRName != Sym.getIRName()) {
688 GlobalRes.Partition = GlobalResolution::External;
689 GlobalRes.VisibleOutsideSummary = true;
690 }
691
692 // Set the partition to external if we know it is re-defined by the linker
693 // with -defsym or -wrap options, used elsewhere, e.g. it is visible to a
694 // regular object, is referenced from llvm.compiler.used/llvm.used, or was
695 // already recorded as being referenced from a different partition.
696 if (Res.LinkerRedefined || Res.VisibleToRegularObj || Sym.isUsed() ||
697 (GlobalRes.Partition != GlobalResolution::Unknown &&
698 GlobalRes.Partition != Partition)) {
699 GlobalRes.Partition = GlobalResolution::External;
700 } else
701 // First recorded reference, save the current partition.
702 GlobalRes.Partition = Partition;
703
704 // Flag as visible outside of summary if visible from a regular object or
705 // from a module that does not have a summary.
706 GlobalRes.VisibleOutsideSummary |=
707 (Res.VisibleToRegularObj || Sym.isUsed() || !InSummary);
708
709 GlobalRes.ExportDynamic |= Res.ExportDynamic;
710 }
711}
712
713void LTO::releaseGlobalResolutionsMemory() {
714 // Release GlobalResolutions dense-map itself.
715 GlobalResolutions.reset();
716 // Release the string saver memory.
717 GlobalResolutionSymbolSaver.reset();
718 Alloc.reset();
719}
720
723 StringRef Path = Input->getName();
724 OS << Path << '\n';
725 auto ResI = Res.begin();
726 for (const InputFile::Symbol &Sym : Input->symbols()) {
727 assert(ResI != Res.end());
728 SymbolResolution Res = *ResI++;
729
730 OS << "-r=" << Path << ',' << Sym.getName() << ',';
731 if (Res.Prevailing)
732 OS << 'p';
734 OS << 'l';
735 if (Res.VisibleToRegularObj)
736 OS << 'x';
737 if (Res.LinkerRedefined)
738 OS << 'r';
739 OS << '\n';
740 }
741 OS.flush();
742 assert(ResI == Res.end());
743}
744
745Error LTO::add(std::unique_ptr<InputFile> InputPtr,
747 llvm::TimeTraceScope timeScope("LTO add input", InputPtr->getName());
748 assert(!CalledGetMaxTasks);
749
751 addInput(std::move(InputPtr));
752 if (!InputOrErr)
753 return InputOrErr.takeError();
754 InputFile *Input = (*InputOrErr).get();
755
756 if (Conf.ResolutionFile)
757 writeToResolutionFile(*Conf.ResolutionFile, Input, Res);
758
759 if (RegularLTO.CombinedModule->getTargetTriple().empty()) {
760 Triple InputTriple(Input->getTargetTriple());
761 RegularLTO.CombinedModule->setTargetTriple(InputTriple);
762 if (InputTriple.isOSBinFormatELF())
763 Conf.VisibilityScheme = Config::ELF;
764 }
765
766 ArrayRef<SymbolResolution> InputRes = Res;
767 for (unsigned I = 0; I != Input->Mods.size(); ++I) {
768 if (auto Err = addModule(*Input, InputRes, I, Res).moveInto(Res))
769 return Err;
770 }
771
772 assert(Res.empty());
773 return Error::success();
774}
775
777LTO::addModule(InputFile &Input, ArrayRef<SymbolResolution> InputRes,
778 unsigned ModI, ArrayRef<SymbolResolution> Res) {
779 llvm::TimeTraceScope timeScope("LTO add module", Input.getName());
780 Expected<BitcodeLTOInfo> LTOInfo = Input.Mods[ModI].getLTOInfo();
781 if (!LTOInfo)
782 return LTOInfo.takeError();
783
784 if (EnableSplitLTOUnit) {
785 // If only some modules were split, flag this in the index so that
786 // we can skip or error on optimizations that need consistently split
787 // modules (whole program devirt and lower type tests).
788 if (*EnableSplitLTOUnit != LTOInfo->EnableSplitLTOUnit)
789 ThinLTO.CombinedIndex.setPartiallySplitLTOUnits();
790 } else
791 EnableSplitLTOUnit = LTOInfo->EnableSplitLTOUnit;
792
793 BitcodeModule BM = Input.Mods[ModI];
794
795 if ((LTOMode == LTOK_UnifiedRegular || LTOMode == LTOK_UnifiedThin) &&
796 !LTOInfo->UnifiedLTO)
798 "unified LTO compilation must use "
799 "compatible bitcode modules (use -funified-lto)",
801
802 if (LTOInfo->UnifiedLTO && LTOMode == LTOK_Default)
803 LTOMode = LTOK_UnifiedThin;
804
805 bool IsThinLTO = LTOInfo->IsThinLTO && (LTOMode != LTOK_UnifiedRegular);
806 // If any of the modules inside of a input bitcode file was compiled with
807 // ThinLTO, we assume that the whole input file also was compiled with
808 // ThinLTO.
809 Input.IsThinLTO |= IsThinLTO;
810
811 auto ModSyms = Input.module_symbols(ModI);
812 addModuleToGlobalRes(ModSyms, Res,
813 IsThinLTO ? ThinLTO.ModuleMap.size() + 1 : 0,
814 LTOInfo->HasSummary);
815
816 if (IsThinLTO)
817 return addThinLTO(BM, ModSyms, Res);
818
819 RegularLTO.EmptyCombinedModule = false;
820 auto ModOrErr = addRegularLTO(Input, InputRes, BM, ModSyms, Res);
821 if (!ModOrErr)
822 return ModOrErr.takeError();
823 Res = ModOrErr->second;
824
825 if (!LTOInfo->HasSummary) {
826 if (Error Err = linkRegularLTO(std::move(ModOrErr->first),
827 /*LivenessFromIndex=*/false))
828 return Err;
829 return Res;
830 }
831
832 // Regular LTO module summaries are added to a dummy module that represents
833 // the combined regular LTO module.
834 if (Error Err = BM.readSummary(ThinLTO.CombinedIndex, ""))
835 return Err;
836 RegularLTO.ModsWithSummaries.push_back(std::move(ModOrErr->first));
837 return Res;
838}
839
840// Checks whether the given global value is in a non-prevailing comdat
841// (comdat containing values the linker indicated were not prevailing,
842// which we then dropped to available_externally), and if so, removes
843// it from the comdat. This is called for all global values to ensure the
844// comdat is empty rather than leaving an incomplete comdat. It is needed for
845// regular LTO modules, in case we are in a mixed-LTO mode (both regular
846// and thin LTO modules) compilation. Since the regular LTO module will be
847// linked first in the final native link, we want to make sure the linker
848// doesn't select any of these incomplete comdats that would be left
849// in the regular LTO module without this cleanup.
850static void
852 std::set<const Comdat *> &NonPrevailingComdats) {
853 Comdat *C = GV.getComdat();
854 if (!C)
855 return;
856
857 if (!NonPrevailingComdats.count(C))
858 return;
859
860 // Additionally need to drop all global values from the comdat to
861 // available_externally, to satisfy the COMDAT requirement that all members
862 // are discarded as a unit. The non-local linkage global values avoid
863 // duplicate definition linker errors.
865
866 if (auto GO = dyn_cast<GlobalObject>(&GV))
867 GO->setComdat(nullptr);
868}
869
870// Add a regular LTO object to the link.
871// The resulting module needs to be linked into the combined LTO module with
872// linkRegularLTO.
873Expected<
874 std::pair<LTO::RegularLTOState::AddedModule, ArrayRef<SymbolResolution>>>
875LTO::addRegularLTO(InputFile &Input, ArrayRef<SymbolResolution> InputRes,
876 BitcodeModule BM, ArrayRef<InputFile::Symbol> Syms,
878 llvm::TimeTraceScope timeScope("LTO add regular LTO");
880 Expected<std::unique_ptr<Module>> MOrErr =
881 BM.getLazyModule(RegularLTO.Ctx, /*ShouldLazyLoadMetadata*/ true,
882 /*IsImporting*/ false);
883 if (!MOrErr)
884 return MOrErr.takeError();
885 Module &M = **MOrErr;
886 Mod.M = std::move(*MOrErr);
887
888 if (Error Err = M.materializeMetadata())
889 return std::move(Err);
890
891 if (LTOMode == LTOK_UnifiedRegular) {
892 // cfi.functions metadata is intended to be used with ThinLTO and may
893 // trigger invalid IR transformations if they are present when doing regular
894 // LTO, so delete it.
895 if (NamedMDNode *CfiFunctionsMD = M.getNamedMetadata("cfi.functions"))
896 M.eraseNamedMetadata(CfiFunctionsMD);
897 } else if (NamedMDNode *AliasesMD = M.getNamedMetadata("aliases")) {
898 // Delete aliases entries for non-prevailing symbols on the ThinLTO side of
899 // this input file.
900 DenseSet<StringRef> Prevailing;
901 for (auto [I, R] : zip(Input.symbols(), InputRes))
902 if (R.Prevailing && !I.getIRName().empty())
903 Prevailing.insert(I.getIRName());
904 std::vector<MDNode *> AliasGroups;
905 for (MDNode *AliasGroup : AliasesMD->operands()) {
906 std::vector<Metadata *> Aliases;
907 for (Metadata *Alias : AliasGroup->operands()) {
908 if (isa<MDString>(Alias) &&
909 Prevailing.count(cast<MDString>(Alias)->getString()))
910 Aliases.push_back(Alias);
911 }
912 if (Aliases.size() > 1)
913 AliasGroups.push_back(MDTuple::get(RegularLTO.Ctx, Aliases));
914 }
915 AliasesMD->clearOperands();
916 for (MDNode *G : AliasGroups)
917 AliasesMD->addOperand(G);
918 }
919
921
922 ModuleSymbolTable SymTab;
923 SymTab.addModule(&M);
924
925 for (GlobalVariable &GV : M.globals())
926 if (GV.hasAppendingLinkage())
927 Mod.Keep.push_back(&GV);
928
929 DenseSet<GlobalObject *> AliasedGlobals;
930 for (auto &GA : M.aliases())
931 if (GlobalObject *GO = GA.getAliaseeObject())
932 AliasedGlobals.insert(GO);
933
934 // In this function we need IR GlobalValues matching the symbols in Syms
935 // (which is not backed by a module), so we need to enumerate them in the same
936 // order. The symbol enumeration order of a ModuleSymbolTable intentionally
937 // matches the order of an irsymtab, but when we read the irsymtab in
938 // InputFile::create we omit some symbols that are irrelevant to LTO. The
939 // Skip() function skips the same symbols from the module as InputFile does
940 // from the symbol table.
941 auto MsymI = SymTab.symbols().begin(), MsymE = SymTab.symbols().end();
942 auto Skip = [&]() {
943 while (MsymI != MsymE) {
944 auto Flags = SymTab.getSymbolFlags(*MsymI);
945 if ((Flags & object::BasicSymbolRef::SF_Global) &&
947 return;
948 ++MsymI;
949 }
950 };
951 Skip();
952
953 std::set<const Comdat *> NonPrevailingComdats;
954 SmallSet<StringRef, 2> NonPrevailingAsmSymbols;
955 for (const InputFile::Symbol &Sym : Syms) {
956 assert(!Res.empty());
957 const SymbolResolution &R = Res.consume_front();
958
959 assert(MsymI != MsymE);
960 ModuleSymbolTable::Symbol Msym = *MsymI++;
961 Skip();
962
963 if (GlobalValue *GV = dyn_cast_if_present<GlobalValue *>(Msym)) {
964 if (R.Prevailing) {
965 if (Sym.isUndefined())
966 continue;
967 Mod.Keep.push_back(GV);
968 // For symbols re-defined with linker -wrap and -defsym options,
969 // set the linkage to weak to inhibit IPO. The linkage will be
970 // restored by the linker.
971 if (R.LinkerRedefined)
972 GV->setLinkage(GlobalValue::WeakAnyLinkage);
973
974 GlobalValue::LinkageTypes OriginalLinkage = GV->getLinkage();
975 if (GlobalValue::isLinkOnceLinkage(OriginalLinkage))
976 GV->setLinkage(GlobalValue::getWeakLinkage(
977 GlobalValue::isLinkOnceODRLinkage(OriginalLinkage)));
978 } else if (isa<GlobalObject>(GV) &&
979 (GV->hasLinkOnceODRLinkage() || GV->hasWeakODRLinkage() ||
980 GV->hasAvailableExternallyLinkage()) &&
981 !AliasedGlobals.count(cast<GlobalObject>(GV))) {
982 // Any of the above three types of linkage indicates that the
983 // chosen prevailing symbol will have the same semantics as this copy of
984 // the symbol, so we may be able to link it with available_externally
985 // linkage. We will decide later whether to do that when we link this
986 // module (in linkRegularLTO), based on whether it is undefined.
987 Mod.Keep.push_back(GV);
989 if (GV->hasComdat())
990 NonPrevailingComdats.insert(GV->getComdat());
991 cast<GlobalObject>(GV)->setComdat(nullptr);
992 }
993
994 // Set the 'local' flag based on the linker resolution for this symbol.
995 if (R.FinalDefinitionInLinkageUnit) {
996 GV->setDSOLocal(true);
997 if (GV->hasDLLImportStorageClass())
998 GV->setDLLStorageClass(GlobalValue::DLLStorageClassTypes::
999 DefaultStorageClass);
1000 }
1001 } else if (auto *AS =
1003 // Collect non-prevailing symbols.
1004 if (!R.Prevailing)
1005 NonPrevailingAsmSymbols.insert(AS->first);
1006 } else {
1007 llvm_unreachable("unknown symbol type");
1008 }
1009
1010 // Common resolution: collect the maximum size/alignment over all commons.
1011 // We also record if we see an instance of a common as prevailing, so that
1012 // if none is prevailing we can ignore it later.
1013 if (Sym.isCommon()) {
1014 // FIXME: We should figure out what to do about commons defined by asm.
1015 // For now they aren't reported correctly by ModuleSymbolTable.
1016 auto &CommonRes = RegularLTO.Commons[std::string(Sym.getIRName())];
1017 CommonRes.Size = std::max(CommonRes.Size, Sym.getCommonSize());
1018 if (uint32_t SymAlignValue = Sym.getCommonAlignment()) {
1019 CommonRes.Alignment =
1020 std::max(Align(SymAlignValue), CommonRes.Alignment);
1021 }
1022 CommonRes.Prevailing |= R.Prevailing;
1023 }
1024 }
1025
1026 if (!M.getComdatSymbolTable().empty())
1027 for (GlobalValue &GV : M.global_values())
1028 handleNonPrevailingComdat(GV, NonPrevailingComdats);
1029
1030 // Prepend ".lto_discard <sym>, <sym>*" directive to each module inline asm
1031 // block.
1032 if (!M.getModuleInlineAsm().empty()) {
1033 std::string NewIA = ".lto_discard";
1034 if (!NonPrevailingAsmSymbols.empty()) {
1035 // Don't dicard a symbol if there is a live .symver for it.
1037 M, [&](StringRef Name, StringRef Alias) {
1038 if (!NonPrevailingAsmSymbols.count(Alias))
1039 NonPrevailingAsmSymbols.erase(Name);
1040 });
1041 NewIA += " " + llvm::join(NonPrevailingAsmSymbols, ", ");
1042 }
1043 NewIA += "\n";
1044 M.setModuleInlineAsm(NewIA + M.getModuleInlineAsm());
1045 }
1046
1047 assert(MsymI == MsymE);
1048 return std::make_pair(std::move(Mod), Res);
1049}
1050
1051Error LTO::linkRegularLTO(RegularLTOState::AddedModule Mod,
1052 bool LivenessFromIndex) {
1053 llvm::TimeTraceScope timeScope("LTO link regular LTO");
1054 std::vector<GlobalValue *> Keep;
1055 for (GlobalValue *GV : Mod.Keep) {
1056 if (LivenessFromIndex && !ThinLTO.CombinedIndex.isGUIDLive(GV->getGUID())) {
1057 if (Function *F = dyn_cast<Function>(GV)) {
1058 if (DiagnosticOutputFile) {
1059 if (Error Err = F->materialize())
1060 return Err;
1061 OptimizationRemarkEmitter ORE(F, nullptr);
1062 ORE.emit(OptimizationRemark(DEBUG_TYPE, "deadfunction", F)
1063 << ore::NV("Function", F)
1064 << " not added to the combined module ");
1065 }
1066 }
1067 continue;
1068 }
1069
1070 if (!GV->hasAvailableExternallyLinkage()) {
1071 Keep.push_back(GV);
1072 continue;
1073 }
1074
1075 // Only link available_externally definitions if we don't already have a
1076 // definition.
1077 GlobalValue *CombinedGV =
1078 RegularLTO.CombinedModule->getNamedValue(GV->getName());
1079 if (CombinedGV && !CombinedGV->isDeclaration())
1080 continue;
1081
1082 Keep.push_back(GV);
1083 }
1084
1085 return RegularLTO.Mover->move(std::move(Mod.M), Keep, nullptr,
1086 /* IsPerformingImport */ false);
1087}
1088
1089// Add a ThinLTO module to the link.
1090Expected<ArrayRef<SymbolResolution>>
1091LTO::addThinLTO(BitcodeModule BM, ArrayRef<InputFile::Symbol> Syms,
1093 llvm::TimeTraceScope timeScope("LTO add thin LTO");
1094 const auto BMID = BM.getModuleIdentifier();
1095 ArrayRef<SymbolResolution> ResTmp = Res;
1096 for (const InputFile::Symbol &Sym : Syms) {
1097 assert(!ResTmp.empty());
1098 const SymbolResolution &R = ResTmp.consume_front();
1099
1100 if (!Sym.getIRName().empty() && R.Prevailing) {
1102 GlobalValue::getGlobalIdentifier(Sym.getIRName(),
1104 ThinLTO.setPrevailingModuleForGUID(GUID, BMID);
1105 }
1106 }
1107
1108 if (Error Err = BM.readSummary(
1109 ThinLTO.CombinedIndex, BMID, [&](GlobalValue::GUID GUID) {
1110 return ThinLTO.isPrevailingModuleForGUID(GUID, BMID);
1111 }))
1112 return Err;
1113 LLVM_DEBUG(dbgs() << "Module " << BMID << "\n");
1114
1115 for (const InputFile::Symbol &Sym : Syms) {
1116 assert(!Res.empty());
1117 const SymbolResolution &R = Res.consume_front();
1118
1119 if (!Sym.getIRName().empty() &&
1120 (R.Prevailing || R.FinalDefinitionInLinkageUnit)) {
1122 GlobalValue::getGlobalIdentifier(Sym.getIRName(),
1124 if (R.Prevailing) {
1125 assert(ThinLTO.isPrevailingModuleForGUID(GUID, BMID));
1126
1127 // For linker redefined symbols (via --wrap or --defsym) we want to
1128 // switch the linkage to `weak` to prevent IPOs from happening.
1129 // Find the summary in the module for this very GV and record the new
1130 // linkage so that we can switch it when we import the GV.
1131 if (R.LinkerRedefined)
1132 if (auto S = ThinLTO.CombinedIndex.findSummaryInModule(GUID, BMID))
1133 S->setLinkage(GlobalValue::WeakAnyLinkage);
1134 }
1135
1136 // If the linker resolved the symbol to a local definition then mark it
1137 // as local in the summary for the module we are adding.
1138 if (R.FinalDefinitionInLinkageUnit) {
1139 if (auto S = ThinLTO.CombinedIndex.findSummaryInModule(GUID, BMID)) {
1140 S->setDSOLocal(true);
1141 }
1142 }
1143 }
1144 }
1145
1146 if (!ThinLTO.ModuleMap.insert({BMID, BM}).second)
1148 "Expected at most one ThinLTO module per bitcode file",
1150
1151 if (!Conf.ThinLTOModulesToCompile.empty()) {
1152 if (!ThinLTO.ModulesToCompile)
1153 ThinLTO.ModulesToCompile = ModuleMapType();
1154 // This is a fuzzy name matching where only modules with name containing the
1155 // specified switch values are going to be compiled.
1156 for (const std::string &Name : Conf.ThinLTOModulesToCompile) {
1157 if (BMID.contains(Name)) {
1158 ThinLTO.ModulesToCompile->insert({BMID, BM});
1159 LLVM_DEBUG(dbgs() << "[ThinLTO] Selecting " << BMID << " to compile\n");
1160 break;
1161 }
1162 }
1163 }
1164
1165 return Res;
1166}
1167
1168unsigned LTO::getMaxTasks() const {
1169 CalledGetMaxTasks = true;
1170 auto ModuleCount = ThinLTO.ModulesToCompile ? ThinLTO.ModulesToCompile->size()
1171 : ThinLTO.ModuleMap.size();
1172 return RegularLTO.ParallelCodeGenParallelismLevel + ModuleCount;
1173}
1174
1175// If only some of the modules were split, we cannot correctly handle
1176// code that contains type tests or type checked loads.
1177Error LTO::checkPartiallySplit() {
1178 if (!ThinLTO.CombinedIndex.partiallySplitLTOUnits())
1179 return Error::success();
1180
1181 const Module *Combined = RegularLTO.CombinedModule.get();
1182 Function *TypeTestFunc =
1183 Intrinsic::getDeclarationIfExists(Combined, Intrinsic::type_test);
1184 Function *TypeCheckedLoadFunc =
1185 Intrinsic::getDeclarationIfExists(Combined, Intrinsic::type_checked_load);
1186 Function *TypeCheckedLoadRelativeFunc = Intrinsic::getDeclarationIfExists(
1187 Combined, Intrinsic::type_checked_load_relative);
1188
1189 // First check if there are type tests / type checked loads in the
1190 // merged regular LTO module IR.
1191 if ((TypeTestFunc && !TypeTestFunc->use_empty()) ||
1192 (TypeCheckedLoadFunc && !TypeCheckedLoadFunc->use_empty()) ||
1193 (TypeCheckedLoadRelativeFunc &&
1194 !TypeCheckedLoadRelativeFunc->use_empty()))
1196 "inconsistent LTO Unit splitting (recompile with -fsplit-lto-unit)",
1198
1199 // Otherwise check if there are any recorded in the combined summary from the
1200 // ThinLTO modules.
1201 for (auto &P : ThinLTO.CombinedIndex) {
1202 for (auto &S : P.second.getSummaryList()) {
1203 auto *FS = dyn_cast<FunctionSummary>(S.get());
1204 if (!FS)
1205 continue;
1206 if (!FS->type_test_assume_vcalls().empty() ||
1207 !FS->type_checked_load_vcalls().empty() ||
1208 !FS->type_test_assume_const_vcalls().empty() ||
1209 !FS->type_checked_load_const_vcalls().empty() ||
1210 !FS->type_tests().empty())
1212 "inconsistent LTO Unit splitting (recompile with -fsplit-lto-unit)",
1214 }
1215 }
1216 return Error::success();
1217}
1218
1220 llvm::scope_exit CleanUp([this]() { cleanup(); });
1221
1222 if (Error EC = handleArchiveInputs())
1223 return EC;
1224
1225 // Compute "dead" symbols, we don't want to import/export these!
1226 DenseSet<GlobalValue::GUID> GUIDPreservedSymbols;
1227 DenseMap<GlobalValue::GUID, PrevailingType> GUIDPrevailingResolutions;
1228 for (auto &Res : *GlobalResolutions) {
1229 // Normally resolution have IR name of symbol. We can do nothing here
1230 // otherwise. See comments in GlobalResolution struct for more details.
1231 if (Res.second.IRName.empty())
1232 continue;
1233
1235 GlobalValue::dropLLVMManglingEscape(Res.second.IRName));
1236
1237 if (Res.second.VisibleOutsideSummary && Res.second.Prevailing)
1238 GUIDPreservedSymbols.insert(GUID);
1239
1240 if (Res.second.ExportDynamic)
1241 DynamicExportSymbols.insert(GUID);
1242
1243 GUIDPrevailingResolutions[GUID] =
1244 Res.second.Prevailing ? PrevailingType::Yes : PrevailingType::No;
1245 }
1246
1247 auto isPrevailing = [&](GlobalValue::GUID G) {
1248 auto It = GUIDPrevailingResolutions.find(G);
1249 if (It == GUIDPrevailingResolutions.end())
1251 return It->second;
1252 };
1253 computeDeadSymbolsWithConstProp(ThinLTO.CombinedIndex, GUIDPreservedSymbols,
1254 isPrevailing, Conf.OptLevel > 0);
1255
1256 // Setup output file to emit statistics.
1257 auto StatsFileOrErr = setupStatsFile(Conf.StatsFile);
1258 if (!StatsFileOrErr)
1259 return StatsFileOrErr.takeError();
1260 std::unique_ptr<ToolOutputFile> StatsFile = std::move(StatsFileOrErr.get());
1261
1262 // TODO: Ideally this would be controlled automatically by detecting that we
1263 // are linking with an allocator that supports these interfaces, rather than
1264 // an internal option (which would still be needed for tests, however). For
1265 // example, if the library exported a symbol like __malloc_hot_cold the linker
1266 // could recognize that and set a flag in the lto::Config.
1268 ThinLTO.CombinedIndex.setWithSupportsHotColdNew();
1269
1270 Error Result = runRegularLTO(AddStream);
1271 if (!Result)
1272 // This will reset the GlobalResolutions optional once done with it to
1273 // reduce peak memory before importing.
1274 Result = runThinLTO(AddStream, Cache, GUIDPreservedSymbols);
1275
1276 if (StatsFile)
1277 PrintStatisticsJSON(StatsFile->os());
1278
1279 return Result;
1280}
1281
1282Error LTO::runRegularLTO(AddStreamFn AddStream) {
1283 llvm::TimeTraceScope timeScope("Run regular LTO");
1284 LLVMContext &CombinedCtx = RegularLTO.CombinedModule->getContext();
1285 // Setup optimization remarks.
1286 auto DiagFileOrErr = lto::setupLLVMOptimizationRemarks(
1287 CombinedCtx, Conf.RemarksFilename, Conf.RemarksPasses, Conf.RemarksFormat,
1289 LLVM_DEBUG(dbgs() << "Running regular LTO\n");
1290 if (!DiagFileOrErr)
1291 return DiagFileOrErr.takeError();
1292 DiagnosticOutputFile = std::move(*DiagFileOrErr);
1293
1294 // Finalize linking of regular LTO modules containing summaries now that
1295 // we have computed liveness information.
1296 {
1297 llvm::TimeTraceScope timeScope("Link regular LTO");
1298 for (auto &M : RegularLTO.ModsWithSummaries)
1299 if (Error Err = linkRegularLTO(std::move(M), /*LivenessFromIndex=*/true))
1300 return Err;
1301 }
1302
1303 // Ensure we don't have inconsistently split LTO units with type tests.
1304 // FIXME: this checks both LTO and ThinLTO. It happens to work as we take
1305 // this path both cases but eventually this should be split into two and
1306 // do the ThinLTO checks in `runThinLTO`.
1307 if (Error Err = checkPartiallySplit())
1308 return Err;
1309
1310 // Make sure commons have the right size/alignment: we kept the largest from
1311 // all the prevailing when adding the inputs, and we apply it here.
1312 const DataLayout &DL = RegularLTO.CombinedModule->getDataLayout();
1313 for (auto &I : RegularLTO.Commons) {
1314 if (!I.second.Prevailing)
1315 // Don't do anything if no instance of this common was prevailing.
1316 continue;
1317 GlobalVariable *OldGV = RegularLTO.CombinedModule->getNamedGlobal(I.first);
1318 if (OldGV && DL.getTypeAllocSize(OldGV->getValueType()) == I.second.Size) {
1319 // Don't create a new global if the type is already correct, just make
1320 // sure the alignment is correct.
1321 OldGV->setAlignment(I.second.Alignment);
1322 continue;
1323 }
1324 ArrayType *Ty =
1325 ArrayType::get(Type::getInt8Ty(RegularLTO.Ctx), I.second.Size);
1326 auto *GV = new GlobalVariable(*RegularLTO.CombinedModule, Ty, false,
1329 GV->setAlignment(I.second.Alignment);
1330 if (OldGV) {
1331 OldGV->replaceAllUsesWith(GV);
1332 GV->takeName(OldGV);
1333 OldGV->eraseFromParent();
1334 } else {
1335 GV->setName(I.first);
1336 }
1337 }
1338
1339 bool WholeProgramVisibilityEnabledInLTO =
1340 Conf.HasWholeProgramVisibility &&
1341 // If validation is enabled, upgrade visibility only when all vtables
1342 // have typeinfos.
1343 (!Conf.ValidateAllVtablesHaveTypeInfos || Conf.AllVtablesHaveTypeInfos);
1344
1345 // This returns true when the name is local or not defined. Locals are
1346 // expected to be handled separately.
1347 auto IsVisibleToRegularObj = [&](StringRef name) {
1348 auto It = GlobalResolutions->find(name);
1349 return (It == GlobalResolutions->end() ||
1350 It->second.VisibleOutsideSummary || !It->second.Prevailing);
1351 };
1352
1353 // If allowed, upgrade public vcall visibility metadata to linkage unit
1354 // visibility before whole program devirtualization in the optimizer.
1356 *RegularLTO.CombinedModule, WholeProgramVisibilityEnabledInLTO,
1357 DynamicExportSymbols, Conf.ValidateAllVtablesHaveTypeInfos,
1358 IsVisibleToRegularObj);
1359 updatePublicTypeTestCalls(*RegularLTO.CombinedModule,
1360 WholeProgramVisibilityEnabledInLTO);
1361
1362 if (Conf.PreOptModuleHook &&
1363 !Conf.PreOptModuleHook(0, *RegularLTO.CombinedModule))
1364 return finalizeOptimizationRemarks(std::move(DiagnosticOutputFile));
1365
1366 if (!Conf.CodeGenOnly) {
1367 for (const auto &R : *GlobalResolutions) {
1368 GlobalValue *GV =
1369 RegularLTO.CombinedModule->getNamedValue(R.second.IRName);
1370 if (!R.second.isPrevailingIRSymbol())
1371 continue;
1372 if (R.second.Partition != 0 &&
1373 R.second.Partition != GlobalResolution::External)
1374 continue;
1375
1376 // Ignore symbols defined in other partitions.
1377 // Also skip declarations, which are not allowed to have internal linkage.
1378 if (!GV || GV->hasLocalLinkage() || GV->isDeclaration())
1379 continue;
1380
1381 // Symbols that are marked DLLImport or DLLExport should not be
1382 // internalized, as they are either externally visible or referencing
1383 // external symbols. Symbols that have AvailableExternally or Appending
1384 // linkage might be used by future passes and should be kept as is.
1385 // These linkages are seen in Unified regular LTO, because the process
1386 // of creating split LTO units introduces symbols with that linkage into
1387 // one of the created modules. Normally, only the ThinLTO backend would
1388 // compile this module, but Unified Regular LTO processes both
1389 // modules created by the splitting process as regular LTO modules.
1390 if ((LTOMode == LTOKind::LTOK_UnifiedRegular) &&
1393 continue;
1394
1395 GV->setUnnamedAddr(R.second.UnnamedAddr ? GlobalValue::UnnamedAddr::Global
1397 if (EnableLTOInternalization && R.second.Partition == 0)
1399 }
1400
1401 if (Conf.PostInternalizeModuleHook &&
1402 !Conf.PostInternalizeModuleHook(0, *RegularLTO.CombinedModule))
1403 return finalizeOptimizationRemarks(std::move(DiagnosticOutputFile));
1404 }
1405
1406 if (!RegularLTO.EmptyCombinedModule || Conf.AlwaysEmitRegularLTOObj) {
1407 if (Error Err =
1408 backend(Conf, AddStream, RegularLTO.ParallelCodeGenParallelismLevel,
1409 *RegularLTO.CombinedModule, ThinLTO.CombinedIndex))
1410 return Err;
1411 }
1412
1413 return finalizeOptimizationRemarks(std::move(DiagnosticOutputFile));
1414}
1415
1417 RTLIB::RuntimeLibcallsInfo Libcalls(TT);
1418 SmallVector<const char *> LibcallSymbols;
1419 LibcallSymbols.reserve(Libcalls.getNumAvailableLibcallImpls());
1420
1421 for (RTLIB::LibcallImpl Impl : RTLIB::libcall_impls()) {
1422 if (Libcalls.isAvailable(Impl))
1423 LibcallSymbols.push_back(Libcalls.getLibcallImplName(Impl).data());
1424 }
1425
1426 return LibcallSymbols;
1427}
1428
1430 const FunctionImporter::ImportMapTy &ImportList, llvm::StringRef ModulePath,
1431 const std::string &NewModulePath) const {
1432 return emitFiles(ImportList, ModulePath, NewModulePath,
1433 NewModulePath + ".thinlto.bc",
1434 /*ImportsFiles=*/std::nullopt);
1435}
1436
1438 const FunctionImporter::ImportMapTy &ImportList, llvm::StringRef ModulePath,
1439 const std::string &NewModulePath, StringRef SummaryPath,
1440 std::optional<std::reference_wrapper<ImportsFilesContainer>> ImportsFiles)
1441 const {
1442 ModuleToSummariesForIndexTy ModuleToSummariesForIndex;
1443 GVSummaryPtrSet DeclarationSummaries;
1444
1445 std::error_code EC;
1447 ImportList, ModuleToSummariesForIndex,
1448 DeclarationSummaries);
1449
1450 raw_fd_ostream OS(SummaryPath, EC, sys::fs::OpenFlags::OF_None);
1451 if (EC)
1452 return createFileError("cannot open " + Twine(SummaryPath), EC);
1453
1454 writeIndexToFile(CombinedIndex, OS, &ModuleToSummariesForIndex,
1455 &DeclarationSummaries);
1456
1458 Error ImportsFilesError = EmitImportsFiles(
1459 ModulePath, NewModulePath + ".imports", ModuleToSummariesForIndex);
1460 if (ImportsFilesError)
1461 return ImportsFilesError;
1462 }
1463
1464 // Optionally, store the imports files.
1465 if (ImportsFiles)
1467 ModulePath, ModuleToSummariesForIndex,
1468 [&](StringRef M) { ImportsFiles->get().push_back(M.str()); });
1469
1470 return Error::success();
1471}
1472
1473namespace {
1474/// Base class for ThinLTO backends that perform code generation and insert the
1475/// generated files back into the link.
1476class CGThinBackend : public ThinBackendProc {
1477protected:
1478 AddStreamFn AddStream;
1479 DenseSet<GlobalValue::GUID> CfiFunctionDefs;
1480 DenseSet<GlobalValue::GUID> CfiFunctionDecls;
1481 bool ShouldEmitIndexFiles;
1482
1483public:
1484 CGThinBackend(
1485 const Config &Conf, ModuleSummaryIndex &CombinedIndex,
1486 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
1487 AddStreamFn AddStream, lto::IndexWriteCallback OnWrite,
1488 bool ShouldEmitIndexFiles, bool ShouldEmitImportsFiles,
1489 ThreadPoolStrategy ThinLTOParallelism)
1490 : ThinBackendProc(Conf, CombinedIndex, ModuleToDefinedGVSummaries,
1491 OnWrite, ShouldEmitImportsFiles, ThinLTOParallelism),
1492 AddStream(std::move(AddStream)),
1493 ShouldEmitIndexFiles(ShouldEmitIndexFiles) {
1494 auto &Defs = CombinedIndex.cfiFunctionDefs();
1495 CfiFunctionDefs.insert_range(Defs.guids());
1496 auto &Decls = CombinedIndex.cfiFunctionDecls();
1497 CfiFunctionDecls.insert_range(Decls.guids());
1498 }
1499};
1500
1501/// This backend performs code generation by scheduling a job to run on
1502/// an in-process thread when invoked for each task.
1503class InProcessThinBackend : public CGThinBackend {
1504protected:
1505 FileCache Cache;
1506
1507public:
1508 InProcessThinBackend(
1509 const Config &Conf, ModuleSummaryIndex &CombinedIndex,
1510 ThreadPoolStrategy ThinLTOParallelism,
1511 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
1512 AddStreamFn AddStream, FileCache Cache, lto::IndexWriteCallback OnWrite,
1513 bool ShouldEmitIndexFiles, bool ShouldEmitImportsFiles)
1514 : CGThinBackend(Conf, CombinedIndex, ModuleToDefinedGVSummaries,
1515 AddStream, OnWrite, ShouldEmitIndexFiles,
1516 ShouldEmitImportsFiles, ThinLTOParallelism),
1517 Cache(std::move(Cache)) {}
1518
1519 virtual Error runThinLTOBackendThread(
1520 AddStreamFn AddStream, FileCache Cache, unsigned Task, BitcodeModule BM,
1521 ModuleSummaryIndex &CombinedIndex,
1522 const FunctionImporter::ImportMapTy &ImportList,
1523 const FunctionImporter::ExportSetTy &ExportList,
1524 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
1525 const GVSummaryMapTy &DefinedGlobals,
1526 MapVector<StringRef, BitcodeModule> &ModuleMap) {
1527 auto ModuleID = BM.getModuleIdentifier();
1528 llvm::TimeTraceScope timeScope("Run ThinLTO backend thread (in-process)",
1529 ModuleID);
1530 auto RunThinBackend = [&](AddStreamFn AddStream) {
1531 LTOLLVMContext BackendContext(Conf);
1532 Expected<std::unique_ptr<Module>> MOrErr = BM.parseModule(BackendContext);
1533 if (!MOrErr)
1534 return MOrErr.takeError();
1535
1536 return thinBackend(Conf, Task, AddStream, **MOrErr, CombinedIndex,
1537 ImportList, DefinedGlobals, &ModuleMap,
1538 Conf.CodeGenOnly);
1539 };
1540 if (ShouldEmitIndexFiles) {
1541 if (auto E = emitFiles(ImportList, ModuleID, ModuleID.str()))
1542 return E;
1543 }
1544
1545 if (!Cache.isValid() || !CombinedIndex.modulePaths().count(ModuleID) ||
1546 all_of(CombinedIndex.getModuleHash(ModuleID),
1547 [](uint32_t V) { return V == 0; }))
1548 // Cache disabled or no entry for this module in the combined index or
1549 // no module hash.
1550 return RunThinBackend(AddStream);
1551
1552 // The module may be cached, this helps handling it.
1553 std::string Key = computeLTOCacheKey(
1554 Conf, CombinedIndex, ModuleID, ImportList, ExportList, ResolvedODR,
1555 DefinedGlobals, CfiFunctionDefs, CfiFunctionDecls);
1556 Expected<AddStreamFn> CacheAddStreamOrErr = Cache(Task, Key, ModuleID);
1557 if (Error Err = CacheAddStreamOrErr.takeError())
1558 return Err;
1559 AddStreamFn &CacheAddStream = *CacheAddStreamOrErr;
1560 if (CacheAddStream)
1561 return RunThinBackend(CacheAddStream);
1562
1563 return Error::success();
1564 }
1565
1566 Error start(
1567 unsigned Task, BitcodeModule BM,
1568 const FunctionImporter::ImportMapTy &ImportList,
1569 const FunctionImporter::ExportSetTy &ExportList,
1570 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
1571 MapVector<StringRef, BitcodeModule> &ModuleMap) override {
1572 StringRef ModulePath = BM.getModuleIdentifier();
1573 assert(ModuleToDefinedGVSummaries.count(ModulePath));
1574 const GVSummaryMapTy &DefinedGlobals =
1575 ModuleToDefinedGVSummaries.find(ModulePath)->second;
1576 BackendThreadPool.async(
1577 [=](BitcodeModule BM, ModuleSummaryIndex &CombinedIndex,
1578 const FunctionImporter::ImportMapTy &ImportList,
1579 const FunctionImporter::ExportSetTy &ExportList,
1580 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes>
1581 &ResolvedODR,
1582 const GVSummaryMapTy &DefinedGlobals,
1583 MapVector<StringRef, BitcodeModule> &ModuleMap) {
1584 if (LLVM_ENABLE_THREADS && Conf.TimeTraceEnabled)
1586 "thin backend");
1587 Error E = runThinLTOBackendThread(
1588 AddStream, Cache, Task, BM, CombinedIndex, ImportList, ExportList,
1589 ResolvedODR, DefinedGlobals, ModuleMap);
1590 if (E) {
1591 std::unique_lock<std::mutex> L(ErrMu);
1592 if (Err)
1593 Err = joinErrors(std::move(*Err), std::move(E));
1594 else
1595 Err = std::move(E);
1596 }
1597 if (LLVM_ENABLE_THREADS && Conf.TimeTraceEnabled)
1599 },
1600 BM, std::ref(CombinedIndex), std::ref(ImportList), std::ref(ExportList),
1601 std::ref(ResolvedODR), std::ref(DefinedGlobals), std::ref(ModuleMap));
1602
1603 if (OnWrite)
1604 OnWrite(std::string(ModulePath));
1605 return Error::success();
1606 }
1607};
1608
1609/// This backend is utilized in the first round of a two-codegen round process.
1610/// It first saves optimized bitcode files to disk before the codegen process
1611/// begins. After codegen, it stores the resulting object files in a scratch
1612/// buffer. Note the codegen data stored in the scratch buffer will be extracted
1613/// and merged in the subsequent step.
1614class FirstRoundThinBackend : public InProcessThinBackend {
1615 AddStreamFn IRAddStream;
1616 FileCache IRCache;
1617
1618public:
1619 FirstRoundThinBackend(
1620 const Config &Conf, ModuleSummaryIndex &CombinedIndex,
1621 ThreadPoolStrategy ThinLTOParallelism,
1622 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
1623 AddStreamFn CGAddStream, FileCache CGCache, AddStreamFn IRAddStream,
1624 FileCache IRCache)
1625 : InProcessThinBackend(Conf, CombinedIndex, ThinLTOParallelism,
1626 ModuleToDefinedGVSummaries, std::move(CGAddStream),
1627 std::move(CGCache), /*OnWrite=*/nullptr,
1628 /*ShouldEmitIndexFiles=*/false,
1629 /*ShouldEmitImportsFiles=*/false),
1630 IRAddStream(std::move(IRAddStream)), IRCache(std::move(IRCache)) {}
1631
1632 Error runThinLTOBackendThread(
1633 AddStreamFn CGAddStream, FileCache CGCache, unsigned Task,
1634 BitcodeModule BM, ModuleSummaryIndex &CombinedIndex,
1635 const FunctionImporter::ImportMapTy &ImportList,
1636 const FunctionImporter::ExportSetTy &ExportList,
1637 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
1638 const GVSummaryMapTy &DefinedGlobals,
1639 MapVector<StringRef, BitcodeModule> &ModuleMap) override {
1640 auto ModuleID = BM.getModuleIdentifier();
1641 llvm::TimeTraceScope timeScope("Run ThinLTO backend thread (first round)",
1642 ModuleID);
1643 auto RunThinBackend = [&](AddStreamFn CGAddStream,
1644 AddStreamFn IRAddStream) {
1645 LTOLLVMContext BackendContext(Conf);
1646 Expected<std::unique_ptr<Module>> MOrErr = BM.parseModule(BackendContext);
1647 if (!MOrErr)
1648 return MOrErr.takeError();
1649
1650 return thinBackend(Conf, Task, CGAddStream, **MOrErr, CombinedIndex,
1651 ImportList, DefinedGlobals, &ModuleMap,
1652 Conf.CodeGenOnly, IRAddStream);
1653 };
1654 // Like InProcessThinBackend, we produce index files as needed for
1655 // FirstRoundThinBackend. However, these files are not generated for
1656 // SecondRoundThinBackend.
1657 if (ShouldEmitIndexFiles) {
1658 if (auto E = emitFiles(ImportList, ModuleID, ModuleID.str()))
1659 return E;
1660 }
1661
1662 assert((CGCache.isValid() == IRCache.isValid()) &&
1663 "Both caches for CG and IR should have matching availability");
1664 if (!CGCache.isValid() || !CombinedIndex.modulePaths().count(ModuleID) ||
1665 all_of(CombinedIndex.getModuleHash(ModuleID),
1666 [](uint32_t V) { return V == 0; }))
1667 // Cache disabled or no entry for this module in the combined index or
1668 // no module hash.
1669 return RunThinBackend(CGAddStream, IRAddStream);
1670
1671 // Get CGKey for caching object in CGCache.
1672 std::string CGKey = computeLTOCacheKey(
1673 Conf, CombinedIndex, ModuleID, ImportList, ExportList, ResolvedODR,
1674 DefinedGlobals, CfiFunctionDefs, CfiFunctionDecls);
1675 Expected<AddStreamFn> CacheCGAddStreamOrErr =
1676 CGCache(Task, CGKey, ModuleID);
1677 if (Error Err = CacheCGAddStreamOrErr.takeError())
1678 return Err;
1679 AddStreamFn &CacheCGAddStream = *CacheCGAddStreamOrErr;
1680
1681 // Get IRKey for caching (optimized) IR in IRCache with an extra ID.
1682 std::string IRKey = recomputeLTOCacheKey(CGKey, /*ExtraID=*/"IR");
1683 Expected<AddStreamFn> CacheIRAddStreamOrErr =
1684 IRCache(Task, IRKey, ModuleID);
1685 if (Error Err = CacheIRAddStreamOrErr.takeError())
1686 return Err;
1687 AddStreamFn &CacheIRAddStream = *CacheIRAddStreamOrErr;
1688
1689 // Ideally, both CG and IR caching should be synchronized. However, in
1690 // practice, their availability may differ due to different expiration
1691 // times. Therefore, if either cache is missing, the backend process is
1692 // triggered.
1693 if (CacheCGAddStream || CacheIRAddStream) {
1694 LLVM_DEBUG(dbgs() << "[FirstRound] Cache Miss for "
1695 << BM.getModuleIdentifier() << "\n");
1696 return RunThinBackend(CacheCGAddStream ? CacheCGAddStream : CGAddStream,
1697 CacheIRAddStream ? CacheIRAddStream : IRAddStream);
1698 }
1699
1700 return Error::success();
1701 }
1702};
1703
1704/// This backend operates in the second round of a two-codegen round process.
1705/// It starts by reading the optimized bitcode files that were saved during the
1706/// first round. The backend then executes the codegen only to further optimize
1707/// the code, utilizing the codegen data merged from the first round. Finally,
1708/// it writes the resulting object files as usual.
1709class SecondRoundThinBackend : public InProcessThinBackend {
1710 std::unique_ptr<SmallVector<StringRef>> IRFiles;
1711 stable_hash CombinedCGDataHash;
1712
1713public:
1714 SecondRoundThinBackend(
1715 const Config &Conf, ModuleSummaryIndex &CombinedIndex,
1716 ThreadPoolStrategy ThinLTOParallelism,
1717 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
1718 AddStreamFn AddStream, FileCache Cache,
1719 std::unique_ptr<SmallVector<StringRef>> IRFiles,
1720 stable_hash CombinedCGDataHash)
1721 : InProcessThinBackend(Conf, CombinedIndex, ThinLTOParallelism,
1722 ModuleToDefinedGVSummaries, std::move(AddStream),
1723 std::move(Cache),
1724 /*OnWrite=*/nullptr,
1725 /*ShouldEmitIndexFiles=*/false,
1726 /*ShouldEmitImportsFiles=*/false),
1727 IRFiles(std::move(IRFiles)), CombinedCGDataHash(CombinedCGDataHash) {}
1728
1729 Error runThinLTOBackendThread(
1730 AddStreamFn AddStream, FileCache Cache, unsigned Task, BitcodeModule BM,
1731 ModuleSummaryIndex &CombinedIndex,
1732 const FunctionImporter::ImportMapTy &ImportList,
1733 const FunctionImporter::ExportSetTy &ExportList,
1734 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
1735 const GVSummaryMapTy &DefinedGlobals,
1736 MapVector<StringRef, BitcodeModule> &ModuleMap) override {
1737 auto ModuleID = BM.getModuleIdentifier();
1738 llvm::TimeTraceScope timeScope("Run ThinLTO backend thread (second round)",
1739 ModuleID);
1740 auto RunThinBackend = [&](AddStreamFn AddStream) {
1741 LTOLLVMContext BackendContext(Conf);
1742 std::unique_ptr<Module> LoadedModule =
1743 cgdata::loadModuleForTwoRounds(BM, Task, BackendContext, *IRFiles);
1744
1745 return thinBackend(Conf, Task, AddStream, *LoadedModule, CombinedIndex,
1746 ImportList, DefinedGlobals, &ModuleMap,
1747 /*CodeGenOnly=*/true);
1748 };
1749 if (!Cache.isValid() || !CombinedIndex.modulePaths().count(ModuleID) ||
1750 all_of(CombinedIndex.getModuleHash(ModuleID),
1751 [](uint32_t V) { return V == 0; }))
1752 // Cache disabled or no entry for this module in the combined index or
1753 // no module hash.
1754 return RunThinBackend(AddStream);
1755
1756 // Get Key for caching the final object file in Cache with the combined
1757 // CGData hash.
1758 std::string Key = computeLTOCacheKey(
1759 Conf, CombinedIndex, ModuleID, ImportList, ExportList, ResolvedODR,
1760 DefinedGlobals, CfiFunctionDefs, CfiFunctionDecls);
1762 /*ExtraID=*/std::to_string(CombinedCGDataHash));
1763 Expected<AddStreamFn> CacheAddStreamOrErr = Cache(Task, Key, ModuleID);
1764 if (Error Err = CacheAddStreamOrErr.takeError())
1765 return Err;
1766 AddStreamFn &CacheAddStream = *CacheAddStreamOrErr;
1767
1768 if (CacheAddStream) {
1769 LLVM_DEBUG(dbgs() << "[SecondRound] Cache Miss for "
1770 << BM.getModuleIdentifier() << "\n");
1771 return RunThinBackend(CacheAddStream);
1772 }
1773
1774 return Error::success();
1775 }
1776};
1777} // end anonymous namespace
1778
1781 bool ShouldEmitIndexFiles,
1782 bool ShouldEmitImportsFiles) {
1783 auto Func =
1784 [=](const Config &Conf, ModuleSummaryIndex &CombinedIndex,
1785 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
1786 AddStreamFn AddStream, FileCache Cache) {
1787 return std::make_unique<InProcessThinBackend>(
1788 Conf, CombinedIndex, Parallelism, ModuleToDefinedGVSummaries,
1789 AddStream, Cache, OnWrite, ShouldEmitIndexFiles,
1790 ShouldEmitImportsFiles);
1791 };
1792 return ThinBackend(Func, Parallelism);
1793}
1794
1796 if (!TheTriple.isOSDarwin())
1797 return "";
1798 if (TheTriple.getArch() == Triple::x86_64)
1799 return "core2";
1800 if (TheTriple.getArch() == Triple::x86)
1801 return "yonah";
1802 if (TheTriple.isArm64e())
1803 return "apple-a12";
1804 if (TheTriple.getArch() == Triple::aarch64 ||
1805 TheTriple.getArch() == Triple::aarch64_32)
1806 return "cyclone";
1807 return "";
1808}
1809
1810// Given the original \p Path to an output file, replace any path
1811// prefix matching \p OldPrefix with \p NewPrefix. Also, create the
1812// resulting directory if it does not yet exist.
1814 StringRef NewPrefix) {
1815 if (OldPrefix.empty() && NewPrefix.empty())
1816 return std::string(Path);
1817 SmallString<128> NewPath(Path);
1818 llvm::sys::path::replace_path_prefix(NewPath, OldPrefix, NewPrefix);
1819 StringRef ParentPath = llvm::sys::path::parent_path(NewPath.str());
1820 if (!ParentPath.empty()) {
1821 // Make sure the new directory exists, creating it if necessary.
1822 if (std::error_code EC = llvm::sys::fs::create_directories(ParentPath))
1823 llvm::errs() << "warning: could not create directory '" << ParentPath
1824 << "': " << EC.message() << '\n';
1825 }
1826 return std::string(NewPath);
1827}
1828
1829namespace {
1830class WriteIndexesThinBackend : public ThinBackendProc {
1831 std::string OldPrefix, NewPrefix, NativeObjectPrefix;
1832 raw_fd_ostream *LinkedObjectsFile;
1833
1834public:
1835 WriteIndexesThinBackend(
1836 const Config &Conf, ModuleSummaryIndex &CombinedIndex,
1837 ThreadPoolStrategy ThinLTOParallelism,
1838 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
1839 std::string OldPrefix, std::string NewPrefix,
1840 std::string NativeObjectPrefix, bool ShouldEmitImportsFiles,
1841 raw_fd_ostream *LinkedObjectsFile, lto::IndexWriteCallback OnWrite)
1842 : ThinBackendProc(Conf, CombinedIndex, ModuleToDefinedGVSummaries,
1843 OnWrite, ShouldEmitImportsFiles, ThinLTOParallelism),
1844 OldPrefix(OldPrefix), NewPrefix(NewPrefix),
1845 NativeObjectPrefix(NativeObjectPrefix),
1846 LinkedObjectsFile(LinkedObjectsFile) {}
1847
1848 Error start(
1849 unsigned Task, BitcodeModule BM,
1850 const FunctionImporter::ImportMapTy &ImportList,
1851 const FunctionImporter::ExportSetTy &ExportList,
1852 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
1853 MapVector<StringRef, BitcodeModule> &ModuleMap) override {
1854 StringRef ModulePath = BM.getModuleIdentifier();
1855
1856 // The contents of this file may be used as input to a native link, and must
1857 // therefore contain the processed modules in a determinstic order that
1858 // match the order they are provided on the command line. For that reason,
1859 // we cannot include this in the asynchronously executed lambda below.
1860 if (LinkedObjectsFile) {
1861 std::string ObjectPrefix =
1862 NativeObjectPrefix.empty() ? NewPrefix : NativeObjectPrefix;
1863 std::string LinkedObjectsFilePath =
1864 getThinLTOOutputFile(ModulePath, OldPrefix, ObjectPrefix);
1865 *LinkedObjectsFile << LinkedObjectsFilePath << '\n';
1866 }
1867
1868 BackendThreadPool.async(
1869 [this](const StringRef ModulePath,
1870 const FunctionImporter::ImportMapTy &ImportList,
1871 const std::string &OldPrefix, const std::string &NewPrefix) {
1872 std::string NewModulePath =
1873 getThinLTOOutputFile(ModulePath, OldPrefix, NewPrefix);
1874 auto E = emitFiles(ImportList, ModulePath, NewModulePath);
1875 if (E) {
1876 std::unique_lock<std::mutex> L(ErrMu);
1877 if (Err)
1878 Err = joinErrors(std::move(*Err), std::move(E));
1879 else
1880 Err = std::move(E);
1881 return;
1882 }
1883 },
1884 ModulePath, ImportList, OldPrefix, NewPrefix);
1885
1886 if (OnWrite)
1887 OnWrite(std::string(ModulePath));
1888 return Error::success();
1889 }
1890
1891 bool isSensitiveToInputOrder() override {
1892 // The order which modules are written to LinkedObjectsFile should be
1893 // deterministic and match the order they are passed on the command line.
1894 return true;
1895 }
1896};
1897} // end anonymous namespace
1898
1900 ThreadPoolStrategy Parallelism, std::string OldPrefix,
1901 std::string NewPrefix, std::string NativeObjectPrefix,
1902 bool ShouldEmitImportsFiles, raw_fd_ostream *LinkedObjectsFile,
1903 IndexWriteCallback OnWrite) {
1904 auto Func =
1905 [=](const Config &Conf, ModuleSummaryIndex &CombinedIndex,
1906 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
1907 AddStreamFn AddStream, FileCache Cache) {
1908 return std::make_unique<WriteIndexesThinBackend>(
1909 Conf, CombinedIndex, Parallelism, ModuleToDefinedGVSummaries,
1910 OldPrefix, NewPrefix, NativeObjectPrefix, ShouldEmitImportsFiles,
1911 LinkedObjectsFile, OnWrite);
1912 };
1913 return ThinBackend(Func, Parallelism);
1914}
1915
1916Error LTO::runThinLTO(AddStreamFn AddStream, FileCache Cache,
1917 const DenseSet<GlobalValue::GUID> &GUIDPreservedSymbols) {
1918 llvm::TimeTraceScope timeScope("Run ThinLTO");
1919 LLVM_DEBUG(dbgs() << "Running ThinLTO\n");
1920 ThinLTO.CombinedIndex.releaseTemporaryMemory();
1921 timeTraceProfilerBegin("ThinLink", StringRef(""));
1922 llvm::scope_exit TimeTraceScopeExit([]() {
1925 });
1926 if (ThinLTO.ModuleMap.empty())
1927 return Error::success();
1928
1929 if (ThinLTO.ModulesToCompile && ThinLTO.ModulesToCompile->empty()) {
1930 llvm::errs() << "warning: [ThinLTO] No module compiled\n";
1931 return Error::success();
1932 }
1933
1934 if (Conf.CombinedIndexHook &&
1935 !Conf.CombinedIndexHook(ThinLTO.CombinedIndex, GUIDPreservedSymbols))
1936 return Error::success();
1937
1938 // Collect for each module the list of function it defines (GUID ->
1939 // Summary).
1940 DenseMap<StringRef, GVSummaryMapTy> ModuleToDefinedGVSummaries(
1941 ThinLTO.ModuleMap.size());
1942 ThinLTO.CombinedIndex.collectDefinedGVSummariesPerModule(
1943 ModuleToDefinedGVSummaries);
1944 // Create entries for any modules that didn't have any GV summaries
1945 // (either they didn't have any GVs to start with, or we suppressed
1946 // generation of the summaries because they e.g. had inline assembly
1947 // uses that couldn't be promoted/renamed on export). This is so
1948 // InProcessThinBackend::start can still launch a backend thread, which
1949 // is passed the map of summaries for the module, without any special
1950 // handling for this case.
1951 for (auto &Mod : ThinLTO.ModuleMap)
1952 if (!ModuleToDefinedGVSummaries.count(Mod.first))
1953 ModuleToDefinedGVSummaries.try_emplace(Mod.first);
1954
1955 FunctionImporter::ImportListsTy ImportLists(ThinLTO.ModuleMap.size());
1956 DenseMap<StringRef, FunctionImporter::ExportSetTy> ExportLists(
1957 ThinLTO.ModuleMap.size());
1958 StringMap<std::map<GlobalValue::GUID, GlobalValue::LinkageTypes>> ResolvedODR;
1959
1960 if (DumpThinCGSCCs)
1961 ThinLTO.CombinedIndex.dumpSCCs(outs());
1962
1963 std::set<GlobalValue::GUID> ExportedGUIDs;
1964
1965 bool WholeProgramVisibilityEnabledInLTO =
1966 Conf.HasWholeProgramVisibility &&
1967 // If validation is enabled, upgrade visibility only when all vtables
1968 // have typeinfos.
1969 (!Conf.ValidateAllVtablesHaveTypeInfos || Conf.AllVtablesHaveTypeInfos);
1970 if (hasWholeProgramVisibility(WholeProgramVisibilityEnabledInLTO))
1971 ThinLTO.CombinedIndex.setWithWholeProgramVisibility();
1972
1973 // If we're validating, get the vtable symbols that should not be
1974 // upgraded because they correspond to typeIDs outside of index-based
1975 // WPD info.
1976 DenseSet<GlobalValue::GUID> VisibleToRegularObjSymbols;
1977 if (WholeProgramVisibilityEnabledInLTO &&
1978 Conf.ValidateAllVtablesHaveTypeInfos) {
1979 // This returns true when the name is local or not defined. Locals are
1980 // expected to be handled separately.
1981 auto IsVisibleToRegularObj = [&](StringRef name) {
1982 auto It = GlobalResolutions->find(name);
1983 return (It == GlobalResolutions->end() ||
1984 It->second.VisibleOutsideSummary || !It->second.Prevailing);
1985 };
1986
1987 getVisibleToRegularObjVtableGUIDs(ThinLTO.CombinedIndex,
1988 VisibleToRegularObjSymbols,
1989 IsVisibleToRegularObj);
1990 }
1991
1992 // If allowed, upgrade public vcall visibility to linkage unit visibility in
1993 // the summaries before whole program devirtualization below.
1995 ThinLTO.CombinedIndex, WholeProgramVisibilityEnabledInLTO,
1996 DynamicExportSymbols, VisibleToRegularObjSymbols);
1997
1998 // Perform index-based WPD. This will return immediately if there are
1999 // no index entries in the typeIdMetadata map (e.g. if we are instead
2000 // performing IR-based WPD in hybrid regular/thin LTO mode).
2001 std::map<ValueInfo, std::vector<VTableSlotSummary>> LocalWPDTargetsMap;
2002 runWholeProgramDevirtOnIndex(ThinLTO.CombinedIndex, ExportedGUIDs,
2003 LocalWPDTargetsMap);
2004
2005 auto isPrevailing = [&](GlobalValue::GUID GUID, const GlobalValueSummary *S) {
2006 return ThinLTO.isPrevailingModuleForGUID(GUID, S->modulePath());
2007 };
2009 MemProfContextDisambiguation ContextDisambiguation;
2010 ContextDisambiguation.run(ThinLTO.CombinedIndex, isPrevailing);
2011 }
2012
2013 // Figure out which symbols need to be internalized. This also needs to happen
2014 // at -O0 because summary-based DCE is implemented using internalization, and
2015 // we must apply DCE consistently with the full LTO module in order to avoid
2016 // undefined references during the final link.
2017 for (auto &Res : *GlobalResolutions) {
2018 // If the symbol does not have external references or it is not prevailing,
2019 // then not need to mark it as exported from a ThinLTO partition.
2020 if (Res.second.Partition != GlobalResolution::External ||
2021 !Res.second.isPrevailingIRSymbol())
2022 continue;
2024 GlobalValue::dropLLVMManglingEscape(Res.second.IRName));
2025 // Mark exported unless index-based analysis determined it to be dead.
2026 if (ThinLTO.CombinedIndex.isGUIDLive(GUID))
2027 ExportedGUIDs.insert(GUID);
2028 }
2029
2030 // Reset the GlobalResolutions to deallocate the associated memory, as there
2031 // are no further accesses. We specifically want to do this before computing
2032 // cross module importing, which adds to peak memory via the computed import
2033 // and export lists.
2034 releaseGlobalResolutionsMemory();
2035
2036 if (Conf.OptLevel > 0)
2037 ComputeCrossModuleImport(ThinLTO.CombinedIndex, ModuleToDefinedGVSummaries,
2038 isPrevailing, ImportLists, ExportLists);
2039
2040 // Any functions referenced by the jump table in the regular LTO object must
2041 // be exported.
2042 auto &Defs = ThinLTO.CombinedIndex.cfiFunctionDefs();
2043 ExportedGUIDs.insert(Defs.guid_begin(), Defs.guid_end());
2044 auto &Decls = ThinLTO.CombinedIndex.cfiFunctionDecls();
2045 ExportedGUIDs.insert(Decls.guid_begin(), Decls.guid_end());
2046
2047 auto isExported = [&](StringRef ModuleIdentifier, ValueInfo VI) {
2048 const auto &ExportList = ExportLists.find(ModuleIdentifier);
2049 return (ExportList != ExportLists.end() && ExportList->second.count(VI)) ||
2050 ExportedGUIDs.count(VI.getGUID());
2051 };
2052
2053 // Update local devirtualized targets that were exported by cross-module
2054 // importing or by other devirtualizations marked in the ExportedGUIDs set.
2055 updateIndexWPDForExports(ThinLTO.CombinedIndex, isExported,
2056 LocalWPDTargetsMap);
2057
2058 thinLTOInternalizeAndPromoteInIndex(ThinLTO.CombinedIndex, isExported,
2059 isPrevailing);
2060
2061 auto recordNewLinkage = [&](StringRef ModuleIdentifier,
2063 GlobalValue::LinkageTypes NewLinkage) {
2064 ResolvedODR[ModuleIdentifier][GUID] = NewLinkage;
2065 };
2066 thinLTOResolvePrevailingInIndex(Conf, ThinLTO.CombinedIndex, isPrevailing,
2067 recordNewLinkage, GUIDPreservedSymbols);
2068
2069 thinLTOPropagateFunctionAttrs(ThinLTO.CombinedIndex, isPrevailing);
2070
2071 generateParamAccessSummary(ThinLTO.CombinedIndex);
2072
2075
2076 TimeTraceScopeExit.release();
2077
2078 auto &ModuleMap =
2079 ThinLTO.ModulesToCompile ? *ThinLTO.ModulesToCompile : ThinLTO.ModuleMap;
2080
2081 auto RunBackends = [&](ThinBackendProc *BackendProcess) -> Error {
2082 auto ProcessOneModule = [&](int I) -> Error {
2083 auto &Mod = *(ModuleMap.begin() + I);
2084 // Tasks 0 through ParallelCodeGenParallelismLevel-1 are reserved for
2085 // combined module and parallel code generation partitions.
2086 return BackendProcess->start(
2087 RegularLTO.ParallelCodeGenParallelismLevel + I, Mod.second,
2088 ImportLists[Mod.first], ExportLists[Mod.first],
2089 ResolvedODR[Mod.first], ThinLTO.ModuleMap);
2090 };
2091
2092 BackendProcess->setup(ModuleMap.size(),
2093 RegularLTO.ParallelCodeGenParallelismLevel,
2094 RegularLTO.CombinedModule->getTargetTriple());
2095
2096 if (BackendProcess->getThreadCount() == 1 ||
2097 BackendProcess->isSensitiveToInputOrder()) {
2098 // Process the modules in the order they were provided on the
2099 // command-line. It is important for this codepath to be used for
2100 // WriteIndexesThinBackend, to ensure the emitted LinkedObjectsFile lists
2101 // ThinLTO objects in the same order as the inputs, which otherwise would
2102 // affect the final link order.
2103 for (int I = 0, E = ModuleMap.size(); I != E; ++I)
2104 if (Error E = ProcessOneModule(I))
2105 return E;
2106 } else {
2107 // When executing in parallel, process largest bitsize modules first to
2108 // improve parallelism, and avoid starving the thread pool near the end.
2109 // This saves about 15 sec on a 36-core machine while link `clang.exe`
2110 // (out of 100 sec).
2111 std::vector<BitcodeModule *> ModulesVec;
2112 ModulesVec.reserve(ModuleMap.size());
2113 for (auto &Mod : ModuleMap)
2114 ModulesVec.push_back(&Mod.second);
2115 for (int I : generateModulesOrdering(ModulesVec))
2116 if (Error E = ProcessOneModule(I))
2117 return E;
2118 }
2119 return BackendProcess->wait();
2120 };
2121
2123 std::unique_ptr<ThinBackendProc> BackendProc =
2124 ThinLTO.Backend(Conf, ThinLTO.CombinedIndex, ModuleToDefinedGVSummaries,
2125 AddStream, Cache);
2126 return RunBackends(BackendProc.get());
2127 }
2128
2129 // Perform two rounds of code generation for ThinLTO:
2130 // 1. First round: Perform optimization and code generation, outputting to
2131 // temporary scratch objects.
2132 // 2. Merge code generation data extracted from the temporary scratch objects.
2133 // 3. Second round: Execute code generation again using the merged data.
2134 LLVM_DEBUG(dbgs() << "[TwoRounds] Initializing ThinLTO two-codegen rounds\n");
2135
2136 unsigned MaxTasks = getMaxTasks();
2137 auto Parallelism = ThinLTO.Backend.getParallelism();
2138 // Set up two additional streams and caches for storing temporary scratch
2139 // objects and optimized IRs, using the same cache directory as the original.
2140 cgdata::StreamCacheData CG(MaxTasks, Cache, "CG"), IR(MaxTasks, Cache, "IR");
2141
2142 // First round: Execute optimization and code generation, outputting to
2143 // temporary scratch objects. Serialize the optimized IRs before initiating
2144 // code generation.
2145 LLVM_DEBUG(dbgs() << "[TwoRounds] Running the first round of codegen\n");
2146 auto FirstRoundLTO = std::make_unique<FirstRoundThinBackend>(
2147 Conf, ThinLTO.CombinedIndex, Parallelism, ModuleToDefinedGVSummaries,
2148 CG.AddStream, CG.Cache, IR.AddStream, IR.Cache);
2149 if (Error E = RunBackends(FirstRoundLTO.get()))
2150 return E;
2151
2152 LLVM_DEBUG(dbgs() << "[TwoRounds] Merging codegen data\n");
2153 auto CombinedHashOrErr = cgdata::mergeCodeGenData(*CG.getResult());
2154 if (Error E = CombinedHashOrErr.takeError())
2155 return E;
2156 auto CombinedHash = *CombinedHashOrErr;
2157 LLVM_DEBUG(dbgs() << "[TwoRounds] CGData hash: " << CombinedHash << "\n");
2158
2159 // Second round: Read the optimized IRs and execute code generation using the
2160 // merged data.
2161 LLVM_DEBUG(dbgs() << "[TwoRounds] Running the second round of codegen\n");
2162 auto SecondRoundLTO = std::make_unique<SecondRoundThinBackend>(
2163 Conf, ThinLTO.CombinedIndex, Parallelism, ModuleToDefinedGVSummaries,
2164 AddStream, Cache, IR.getResult(), CombinedHash);
2165 return RunBackends(SecondRoundLTO.get());
2166}
2167
2171 std::optional<uint64_t> RemarksHotnessThreshold, int Count) {
2172 std::string Filename = std::string(RemarksFilename);
2173 // For ThinLTO, file.opt.<format> becomes
2174 // file.opt.<format>.thin.<num>.<format>.
2175 if (!Filename.empty() && Count != -1)
2176 Filename =
2177 (Twine(Filename) + ".thin." + llvm::utostr(Count) + "." + RemarksFormat)
2178 .str();
2179
2180 auto ResultOrErr = llvm::setupLLVMOptimizationRemarks(
2183 if (Error E = ResultOrErr.takeError())
2184 return std::move(E);
2185
2186 if (*ResultOrErr)
2187 (*ResultOrErr)->keep();
2188
2189 return ResultOrErr;
2190}
2191
2194 // Setup output file to emit statistics.
2195 if (StatsFilename.empty())
2196 return nullptr;
2197
2199 std::error_code EC;
2200 auto StatsFile =
2201 std::make_unique<ToolOutputFile>(StatsFilename, EC, sys::fs::OF_None);
2202 if (EC)
2203 return errorCodeToError(EC);
2204
2205 StatsFile->keep();
2206 return std::move(StatsFile);
2207}
2208
2209// Compute the ordering we will process the inputs: the rough heuristic here
2210// is to sort them per size so that the largest module get schedule as soon as
2211// possible. This is purely a compile-time optimization.
2213 auto Seq = llvm::seq<int>(0, R.size());
2214 std::vector<int> ModulesOrdering(Seq.begin(), Seq.end());
2215 llvm::sort(ModulesOrdering, [&](int LeftIndex, int RightIndex) {
2216 auto LSize = R[LeftIndex]->getBuffer().size();
2217 auto RSize = R[RightIndex]->getBuffer().size();
2218 return LSize > RSize;
2219 });
2220 return ModulesOrdering;
2221}
2222
2223namespace {
2224/// This out-of-process backend does not perform code generation when invoked
2225/// for each task. Instead, it generates the necessary information (e.g., the
2226/// summary index shard, import list, etc.) to enable code generation to be
2227/// performed externally, similar to WriteIndexesThinBackend. The backend's
2228/// `wait` function then invokes an external distributor process to carry out
2229/// the backend compilations.
2230class OutOfProcessThinBackend : public CGThinBackend {
2231 using SString = SmallString<128>;
2232
2234 StringSaver Saver{Alloc};
2235
2236 SString LinkerOutputFile;
2237
2238 SString DistributorPath;
2239 ArrayRef<StringRef> DistributorArgs;
2240
2241 SString RemoteCompiler;
2242 ArrayRef<StringRef> RemoteCompilerPrependArgs;
2243 ArrayRef<StringRef> RemoteCompilerArgs;
2244
2245 bool SaveTemps;
2246
2247 SmallVector<StringRef, 0> CodegenOptions;
2248 DenseSet<StringRef> CommonInputs;
2249 // Number of the object files that have been already cached.
2250 std::atomic<size_t> CachedJobs{0};
2251 // Information specific to individual backend compilation job.
2252 struct Job {
2253 unsigned Task;
2254 StringRef ModuleID;
2255 StringRef NativeObjectPath;
2256 StringRef SummaryIndexPath;
2257 ImportsFilesContainer ImportsFiles;
2258 std::string CacheKey;
2259 AddStreamFn CacheAddStream;
2260 bool Cached = false;
2261 };
2262 // The set of backend compilations jobs.
2263 SmallVector<Job> Jobs;
2264
2265 // A unique string to identify the current link.
2266 SmallString<8> UID;
2267
2268 // The offset to the first ThinLTO task.
2269 unsigned ThinLTOTaskOffset;
2270
2271 // The target triple to supply for backend compilations.
2272 llvm::Triple Triple;
2273
2274 // Cache
2275 FileCache Cache;
2276
2277public:
2278 OutOfProcessThinBackend(
2279 const Config &Conf, ModuleSummaryIndex &CombinedIndex,
2280 ThreadPoolStrategy ThinLTOParallelism,
2281 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
2282 AddStreamFn AddStream, FileCache CacheFn, lto::IndexWriteCallback OnWrite,
2283 bool ShouldEmitIndexFiles, bool ShouldEmitImportsFiles,
2284 StringRef LinkerOutputFile, StringRef Distributor,
2285 ArrayRef<StringRef> DistributorArgs, StringRef RemoteCompiler,
2286 ArrayRef<StringRef> RemoteCompilerPrependArgs,
2287 ArrayRef<StringRef> RemoteCompilerArgs, bool SaveTemps)
2288 : CGThinBackend(Conf, CombinedIndex, ModuleToDefinedGVSummaries,
2289 AddStream, OnWrite, ShouldEmitIndexFiles,
2290 ShouldEmitImportsFiles, ThinLTOParallelism),
2291 LinkerOutputFile(LinkerOutputFile), DistributorPath(Distributor),
2292 DistributorArgs(DistributorArgs), RemoteCompiler(RemoteCompiler),
2293 RemoteCompilerPrependArgs(RemoteCompilerPrependArgs),
2294 RemoteCompilerArgs(RemoteCompilerArgs), SaveTemps(SaveTemps),
2295 Cache(std::move(CacheFn)) {}
2296
2297 void setup(unsigned ThinLTONumTasks, unsigned ThinLTOTaskOffset,
2298 llvm::Triple Triple) override {
2300 Jobs.resize((size_t)ThinLTONumTasks);
2301 this->ThinLTOTaskOffset = ThinLTOTaskOffset;
2302 this->Triple = Triple;
2303 this->Conf.Dtlto = 1;
2304 }
2305
2306 virtual Error runThinLTOBackendThread(
2307 Job &J, const FunctionImporter::ImportMapTy &ImportList,
2308 const FunctionImporter::ExportSetTy &ExportList,
2309 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes>
2310 &ResolvedODR) {
2311 {
2312 TimeTraceScope TimeScope("Emit individual index for DTLTO",
2313 J.SummaryIndexPath);
2314 if (auto E = emitFiles(ImportList, J.ModuleID, J.ModuleID.str(),
2315 J.SummaryIndexPath, J.ImportsFiles))
2316 return E;
2317 }
2318
2319 if (!Cache.isValid() || !CombinedIndex.modulePaths().count(J.ModuleID) ||
2320 all_of(CombinedIndex.getModuleHash(J.ModuleID),
2321 [](uint32_t V) { return V == 0; }))
2322 // Cache disabled or no entry for this module in the combined index or
2323 // no module hash.
2324 return Error::success();
2325
2326 TimeTraceScope TimeScope("Check cache for DTLTO", J.SummaryIndexPath);
2327 const GVSummaryMapTy &DefinedGlobals =
2328 ModuleToDefinedGVSummaries.find(J.ModuleID)->second;
2329
2330 // The module may be cached, this helps handling it.
2331 J.CacheKey = computeLTOCacheKey(Conf, CombinedIndex, J.ModuleID, ImportList,
2332 ExportList, ResolvedODR, DefinedGlobals,
2333 CfiFunctionDefs, CfiFunctionDecls);
2334
2335 // The module may be cached, this helps handling it.
2336 auto CacheAddStreamExp = Cache(J.Task, J.CacheKey, J.ModuleID);
2337 if (Error Err = CacheAddStreamExp.takeError())
2338 return Err;
2339 AddStreamFn &CacheAddStream = *CacheAddStreamExp;
2340 // If CacheAddStream is null, we have a cache hit and at this point
2341 // object file is already passed back to the linker.
2342 if (!CacheAddStream) {
2343 J.Cached = true; // Cache hit, mark the job as cached.
2344 CachedJobs.fetch_add(1);
2345 } else {
2346 // If CacheAddStream is not null, we have a cache miss and we need to
2347 // run the backend for codegen. Save cache 'add stream'
2348 // function for a later use.
2349 J.CacheAddStream = std::move(CacheAddStream);
2350 }
2351 return Error::success();
2352 }
2353
2354 Error start(
2355 unsigned Task, BitcodeModule BM,
2356 const FunctionImporter::ImportMapTy &ImportList,
2357 const FunctionImporter::ExportSetTy &ExportList,
2358 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes> &ResolvedODR,
2359 MapVector<StringRef, BitcodeModule> &ModuleMap) override {
2360
2361 StringRef ModulePath = BM.getModuleIdentifier();
2362
2363 SString ObjFilePath = sys::path::parent_path(LinkerOutputFile);
2364 sys::path::append(ObjFilePath, sys::path::stem(ModulePath) + "." +
2365 itostr(Task) + "." + UID + ".native.o");
2366
2367 Job &J = Jobs[Task - ThinLTOTaskOffset];
2368 J = {Task,
2369 ModulePath,
2370 Saver.save(ObjFilePath.str()),
2371 Saver.save(ObjFilePath.str() + ".thinlto.bc"),
2372 {}, // Filled in by emitFiles below.
2373 "", /*CacheKey=*/
2374 nullptr,
2375 false};
2376
2377 // Cleanup per-job temporary files on abnormal process exit.
2378 if (!SaveTemps) {
2379 llvm::sys::RemoveFileOnSignal(J.NativeObjectPath);
2380 if (!ShouldEmitIndexFiles)
2381 llvm::sys::RemoveFileOnSignal(J.SummaryIndexPath);
2382 }
2383
2384 assert(ModuleToDefinedGVSummaries.count(ModulePath));
2385
2386 // The BackendThreadPool is only used here to write the sharded index files
2387 // (similar to WriteIndexesThinBackend).
2388 BackendThreadPool.async(
2389 [=](Job &J, const FunctionImporter::ImportMapTy &ImportList,
2390 const FunctionImporter::ExportSetTy &ExportList,
2391 const std::map<GlobalValue::GUID, GlobalValue::LinkageTypes>
2392 &ResolvedODR) {
2393 if (LLVM_ENABLE_THREADS && Conf.TimeTraceEnabled)
2396 "Emit individual index and check cache for DTLTO");
2397 Error E =
2398 runThinLTOBackendThread(J, ImportList, ExportList, ResolvedODR);
2399 if (E) {
2400 std::unique_lock<std::mutex> L(ErrMu);
2401 if (Err)
2402 Err = joinErrors(std::move(*Err), std::move(E));
2403 else
2404 Err = std::move(E);
2405 }
2406 if (LLVM_ENABLE_THREADS && Conf.TimeTraceEnabled)
2408 },
2409 std::ref(J), std::ref(ImportList), std::ref(ExportList),
2410 std::ref(ResolvedODR));
2411
2412 return Error::success();
2413 }
2414
2415 // Derive a set of Clang options that will be shared/common for all DTLTO
2416 // backend compilations. We are intentionally minimal here as these options
2417 // must remain synchronized with the behavior of Clang. DTLTO does not support
2418 // all the features available with in-process LTO. More features are expected
2419 // to be added over time. Users can specify Clang options directly if a
2420 // feature is not supported. Note that explicitly specified options that imply
2421 // additional input or output file dependencies must be communicated to the
2422 // distribution system, potentially by setting extra options on the
2423 // distributor program.
2424 void buildCommonRemoteCompilerOptions() {
2425 const lto::Config &C = Conf;
2426 auto &Ops = CodegenOptions;
2427
2428 Ops.push_back(Saver.save("-O" + Twine(C.OptLevel)));
2429
2430 if (C.Options.EmitAddrsig)
2431 Ops.push_back("-faddrsig");
2432 if (C.Options.FunctionSections)
2433 Ops.push_back("-ffunction-sections");
2434 if (C.Options.DataSections)
2435 Ops.push_back("-fdata-sections");
2436
2437 if (C.RelocModel == Reloc::PIC_)
2438 // Clang doesn't have -fpic for all triples.
2439 if (!Triple.isOSBinFormatCOFF())
2440 Ops.push_back("-fpic");
2441
2442 // Turn on/off warnings about profile cfg mismatch (default on)
2443 // --lto-pgo-warn-mismatch.
2444 if (!C.PGOWarnMismatch) {
2445 Ops.push_back("-mllvm");
2446 Ops.push_back("-no-pgo-warn-mismatch");
2447 }
2448
2449 // Enable sample-based profile guided optimizations.
2450 // Sample profile file path --lto-sample-profile=<value>.
2451 if (!C.SampleProfile.empty()) {
2452 Ops.push_back(
2453 Saver.save("-fprofile-sample-use=" + Twine(C.SampleProfile)));
2454 CommonInputs.insert(C.SampleProfile);
2455 }
2456
2457 // We don't know which of options will be used by Clang.
2458 Ops.push_back("-Wno-unused-command-line-argument");
2459
2460 // Forward any supplied options.
2461 if (!RemoteCompilerArgs.empty())
2462 for (auto &a : RemoteCompilerArgs)
2463 Ops.push_back(a);
2464 }
2465
2466 // Generates a JSON file describing the backend compilations, for the
2467 // distributor.
2468 bool emitDistributorJson(StringRef DistributorJson) {
2469 using json::Array;
2470 std::error_code EC;
2471 raw_fd_ostream OS(DistributorJson, EC);
2472 if (EC)
2473 return false;
2474
2475 json::OStream JOS(OS);
2476 JOS.object([&]() {
2477 // Information common to all jobs.
2478 JOS.attributeObject("common", [&]() {
2479 JOS.attribute("linker_output", LinkerOutputFile);
2480
2481 JOS.attributeArray("args", [&]() {
2482 JOS.value(RemoteCompiler);
2483
2484 // Forward any supplied prepend options.
2485 if (!RemoteCompilerPrependArgs.empty())
2486 for (auto &A : RemoteCompilerPrependArgs)
2487 JOS.value(A);
2488
2489 JOS.value("-c");
2490
2491 JOS.value(Saver.save("--target=" + Triple.str()));
2492
2493 for (const auto &A : CodegenOptions)
2494 JOS.value(A);
2495 });
2496
2497 JOS.attribute("inputs", Array(CommonInputs));
2498 });
2499
2500 // Per-compilation-job information.
2501 JOS.attributeArray("jobs", [&]() {
2502 for (const auto &J : Jobs) {
2503 assert(J.Task != 0);
2504 if (J.Cached) {
2505 assert(!Cache.getCacheDirectoryPath().empty());
2506 continue;
2507 }
2508
2510 SmallVector<StringRef, 1> Outputs;
2511
2512 JOS.object([&]() {
2513 JOS.attributeArray("args", [&]() {
2514 JOS.value(J.ModuleID);
2515 Inputs.push_back(J.ModuleID);
2516
2517 JOS.value(
2518 Saver.save("-fthinlto-index=" + Twine(J.SummaryIndexPath)));
2519 Inputs.push_back(J.SummaryIndexPath);
2520
2521 JOS.value("-o");
2522 JOS.value(J.NativeObjectPath);
2523 Outputs.push_back(J.NativeObjectPath);
2524 });
2525
2526 // Add the bitcode files from which imports will be made. These do
2527 // not explicitly appear on the backend compilation command lines
2528 // but are recorded in the summary index shards.
2529 llvm::append_range(Inputs, J.ImportsFiles);
2530 JOS.attribute("inputs", Array(Inputs));
2531
2532 JOS.attribute("outputs", Array(Outputs));
2533 });
2534 }
2535 });
2536 });
2537
2538 return true;
2539 }
2540
2541 void removeFile(StringRef FileName) {
2542 std::error_code EC = sys::fs::remove(FileName, true);
2543 if (EC && EC != std::make_error_code(std::errc::no_such_file_or_directory))
2544 errs() << "warning: could not remove the file '" << FileName
2545 << "': " << EC.message() << "\n";
2546 }
2547
2548 Error wait() override {
2549 // Wait for the information on the required backend compilations to be
2550 // gathered.
2551 BackendThreadPool.wait();
2552 if (Err)
2553 return std::move(*Err);
2554
2555 llvm::scope_exit CleanPerJobFiles([&] {
2556 llvm::TimeTraceScope TimeScope("Remove DTLTO temporary files");
2557 if (!SaveTemps)
2558 for (auto &Job : Jobs) {
2559 removeFile(Job.NativeObjectPath);
2560 if (!ShouldEmitIndexFiles)
2561 removeFile(Job.SummaryIndexPath);
2562 }
2563 });
2564
2565 const StringRef BCError = "DTLTO backend compilation: ";
2566
2567 buildCommonRemoteCompilerOptions();
2568
2569 SString JsonFile = sys::path::parent_path(LinkerOutputFile);
2570 {
2571 llvm::TimeTraceScope TimeScope("Emit DTLTO JSON");
2572 sys::path::append(JsonFile, sys::path::stem(LinkerOutputFile) + "." +
2573 UID + ".dist-file.json");
2574 // Cleanup DTLTO JSON file on abnormal process exit.
2575 if (!SaveTemps)
2577 if (!emitDistributorJson(JsonFile))
2579 BCError + "failed to generate distributor JSON script: " + JsonFile,
2581 }
2582 llvm::scope_exit CleanJson([&] {
2583 if (!SaveTemps)
2584 removeFile(JsonFile);
2585 });
2586
2587 {
2588 llvm::TimeTraceScope TimeScope("Execute DTLTO distributor",
2589 DistributorPath);
2590 // Checks if we have any jobs that don't have corresponding cache entries.
2591 if (CachedJobs.load() < Jobs.size()) {
2592 SmallVector<StringRef, 3> Args = {DistributorPath};
2593 llvm::append_range(Args, DistributorArgs);
2594 Args.push_back(JsonFile);
2595 std::string ErrMsg;
2596 if (sys::ExecuteAndWait(Args[0], Args,
2597 /*Env=*/std::nullopt, /*Redirects=*/{},
2598 /*SecondsToWait=*/0, /*MemoryLimit=*/0,
2599 &ErrMsg)) {
2601 BCError + "distributor execution failed" +
2602 (!ErrMsg.empty() ? ": " + ErrMsg + Twine(".") : Twine(".")),
2604 }
2605 }
2606 }
2607
2608 {
2609 llvm::TimeTraceScope FilesScope("Add DTLTO files to the link");
2610 for (auto &Job : Jobs) {
2611 if (!Job.CacheKey.empty() && Job.Cached) {
2612 assert(Cache.isValid());
2613 continue;
2614 }
2615 // Load the native object from a file into a memory buffer
2616 // and store its contents in the output buffer.
2617 auto ObjFileMbOrErr =
2618 MemoryBuffer::getFile(Job.NativeObjectPath, /*IsText=*/false,
2619 /*RequiresNullTerminator=*/false);
2620 if (std::error_code EC = ObjFileMbOrErr.getError())
2622 BCError + "cannot open native object file: " +
2623 Job.NativeObjectPath + ": " + EC.message(),
2625
2626 MemoryBufferRef ObjFileMbRef = ObjFileMbOrErr->get()->getMemBufferRef();
2627 if (Cache.isValid()) {
2628 // Cache hits are taken care of earlier. At this point, we could only
2629 // have cache misses.
2630 assert(Job.CacheAddStream);
2631 // Obtain a file stream for a storing a cache entry.
2632 auto CachedFileStreamOrErr =
2633 Job.CacheAddStream(Job.Task, Job.ModuleID);
2634 if (!CachedFileStreamOrErr)
2635 return joinErrors(
2636 CachedFileStreamOrErr.takeError(),
2638 "Cannot get a cache file stream: %s",
2639 Job.NativeObjectPath.data()));
2640 // Store a file buffer into the cache stream.
2641 auto &CacheStream = *(CachedFileStreamOrErr->get());
2642 *(CacheStream.OS) << ObjFileMbRef.getBuffer();
2643 if (Error Err = CacheStream.commit())
2644 return Err;
2645 } else {
2646 auto StreamOrErr = AddStream(Job.Task, Job.ModuleID);
2647 if (Error Err = StreamOrErr.takeError())
2648 report_fatal_error(std::move(Err));
2649 auto &Stream = *StreamOrErr->get();
2650 *Stream.OS << ObjFileMbRef.getBuffer();
2651 if (Error Err = Stream.commit())
2652 report_fatal_error(std::move(Err));
2653 }
2654 }
2655 }
2656 return Error::success();
2657 }
2658};
2659} // end anonymous namespace
2660
2662 ThreadPoolStrategy Parallelism, lto::IndexWriteCallback OnWrite,
2663 bool ShouldEmitIndexFiles, bool ShouldEmitImportsFiles,
2664 StringRef LinkerOutputFile, StringRef Distributor,
2665 ArrayRef<StringRef> DistributorArgs, StringRef RemoteCompiler,
2666 ArrayRef<StringRef> RemoteCompilerPrependArgs,
2667 ArrayRef<StringRef> RemoteCompilerArgs, bool SaveTemps) {
2668 auto Func =
2669 [=](const Config &Conf, ModuleSummaryIndex &CombinedIndex,
2670 const DenseMap<StringRef, GVSummaryMapTy> &ModuleToDefinedGVSummaries,
2671 AddStreamFn AddStream, FileCache Cache) {
2672 return std::make_unique<OutOfProcessThinBackend>(
2673 Conf, CombinedIndex, Parallelism, ModuleToDefinedGVSummaries,
2674 AddStream, Cache, OnWrite, ShouldEmitIndexFiles,
2675 ShouldEmitImportsFiles, LinkerOutputFile, Distributor,
2676 DistributorArgs, RemoteCompiler, RemoteCompilerPrependArgs,
2677 RemoteCompilerArgs, SaveTemps);
2678 };
2679 return ThinBackend(Func, Parallelism);
2680}
assert(UImm &&(UImm !=~static_cast< T >(0)) &&"Invalid immediate!")
MachineBasicBlock MachineBasicBlock::iterator DebugLoc DL
Function Alias Analysis false
static GCRegistry::Add< ErlangGC > A("erlang", "erlang-compatible garbage collector")
static GCRegistry::Add< CoreCLRGC > E("coreclr", "CoreCLR-compatible GC")
dxil translate DXIL Translate Metadata
#define DEBUG_TYPE
const AbstractManglingParser< Derived, Alloc >::OperatorInfo AbstractManglingParser< Derived, Alloc >::Ops[]
This file supports working with JSON data.
static void writeToResolutionFile(raw_ostream &OS, InputFile *Input, ArrayRef< SymbolResolution > Res)
Definition LTO.cpp:721
static void thinLTOResolvePrevailingGUID(const Config &C, ValueInfo VI, DenseSet< GlobalValueSummary * > &GlobalInvolvedWithAlias, function_ref< bool(GlobalValue::GUID, const GlobalValueSummary *)> isPrevailing, function_ref< void(StringRef, GlobalValue::GUID, GlobalValue::LinkageTypes)> recordNewLinkage, const DenseSet< GlobalValue::GUID > &GUIDPreservedSymbols)
Definition LTO.cpp:369
static void handleNonPrevailingComdat(GlobalValue &GV, std::set< const Comdat * > &NonPrevailingComdats)
Definition LTO.cpp:851
static cl::opt< bool > DumpThinCGSCCs("dump-thin-cg-sccs", cl::init(false), cl::Hidden, cl::desc("Dump the SCCs in the ThinLTO index's callgraph"))
static void thinLTOInternalizeAndPromoteGUID(ValueInfo VI, function_ref< bool(StringRef, ValueInfo)> isExported, function_ref< bool(GlobalValue::GUID, const GlobalValueSummary *)> isPrevailing)
Definition LTO.cpp:471
Legalize the Machine IR a function s Machine IR
Definition Legalizer.cpp:81
#define F(x, y, z)
Definition MD5.cpp:54
#define I(x, y, z)
Definition MD5.cpp:57
#define G(x, y, z)
Definition MD5.cpp:55
Machine Check Debug Module
This file contains the declarations for metadata subclasses.
static constexpr StringLiteral Filename
#define P(N)
Provides a library for accessing information about this process and other processes on the operating ...
static const char * name
This file defines the make_scope_exit function, which executes user-defined cleanup logic at scope ex...
This file defines the SmallSet class.
This file defines the 'Statistic' class, which is designed to be an easy way to expose various metric...
This file contains some functions that are useful when dealing with strings.
#define LLVM_DEBUG(...)
Definition Debug.h:114
This pass exposes codegen information to IR-level passes.
The Input class is used to parse a yaml document into in-memory structs and vectors.
ArrayRef - Represent a constant reference to an array (0 or more elements consecutively in memory),...
Definition ArrayRef.h:40
iterator end() const
Definition ArrayRef.h:131
iterator begin() const
Definition ArrayRef.h:130
bool empty() const
empty - Check if the array is empty.
Definition ArrayRef.h:137
const T & consume_front()
consume_front() - Returns the first element and drops it from ArrayRef.
Definition ArrayRef.h:157
static LLVM_ABI ArrayType * get(Type *ElementType, uint64_t NumElements)
This static method is the primary way to construct an ArrayType.
Represents a module in a bitcode file.
StringRef getModuleIdentifier() const
LLVM_ABI Error readSummary(ModuleSummaryIndex &CombinedIndex, StringRef ModulePath, std::function< bool(GlobalValue::GUID)> IsPrevailing=nullptr)
Parse the specified bitcode buffer and merge its module summary index into CombinedIndex.
LLVM_ABI Expected< std::unique_ptr< Module > > parseModule(LLVMContext &Context, ParserCallbacks Callbacks={})
Read the entire bitcode module and return it.
LLVM_ABI Expected< std::unique_ptr< Module > > getLazyModule(LLVMContext &Context, bool ShouldLazyLoadMetadata, bool IsImporting, ParserCallbacks Callbacks={})
Read the bitcode module and prepare for lazy deserialization of function bodies.
static LLVM_ABI ConstantAggregateZero * get(Type *Ty)
A parsed version of the target data layout string in and methods for querying it.
Definition DataLayout.h:64
iterator find(const_arg_type_t< KeyT > Val)
Definition DenseMap.h:178
std::pair< iterator, bool > try_emplace(KeyT &&Key, Ts &&...Args)
Definition DenseMap.h:256
size_type count(const_arg_type_t< KeyT > Val) const
Return 1 if the specified key is in the map, 0 otherwise.
Definition DenseMap.h:174
iterator end()
Definition DenseMap.h:81
Implements a dense probed hash-table based set.
Definition DenseSet.h:279
Lightweight error class with error context and mandatory checking.
Definition Error.h:159
static ErrorSuccess success()
Create a success value.
Definition Error.h:336
Tagged union holding either a T or a Error.
Definition Error.h:485
Error takeError()
Take ownership of the stored error.
Definition Error.h:612
The map maintains the list of imports.
DenseSet< ValueInfo > ExportSetTy
The set contains an entry for every global value that the module exports.
Function and variable summary information to aid decisions and implementation of importing.
static bool isAppendingLinkage(LinkageTypes Linkage)
static LLVM_ABI GUID getGUIDAssumingExternalLinkage(StringRef GlobalName)
Return a 64-bit global unique ID constructed from the name of a global symbol.
Definition Globals.cpp:77
static bool isExternalWeakLinkage(LinkageTypes Linkage)
static bool isLocalLinkage(LinkageTypes Linkage)
LLVM_ABI bool isDeclaration() const
Return true if the primary definition of this global value is outside of the current translation unit...
Definition Globals.cpp:328
void setUnnamedAddr(UnnamedAddr Val)
uint64_t GUID
Declare a type to represent a global unique identifier for a global value.
bool hasLocalLinkage() const
static StringRef dropLLVMManglingEscape(StringRef Name)
If the given string begins with the GlobalValue name mangling escape character '\1',...
LLVM_ABI const Comdat * getComdat() const
Definition Globals.cpp:201
static bool isLinkOnceLinkage(LinkageTypes Linkage)
void setLinkage(LinkageTypes LT)
DLLStorageClassTypes
Storage classes of global values for PE targets.
Definition GlobalValue.h:74
GUID getGUID() const
Return a 64-bit global unique ID constructed from global value name (i.e.
static bool isExternalLinkage(LinkageTypes Linkage)
VisibilityTypes
An enumeration for the kinds of visibility of global values.
Definition GlobalValue.h:67
@ DefaultVisibility
The GV is visible.
Definition GlobalValue.h:68
static LLVM_ABI std::string getGlobalIdentifier(StringRef Name, GlobalValue::LinkageTypes Linkage, StringRef FileName)
Return the modified name for a global value suitable to be used as the key for a global lookup (e....
Definition Globals.cpp:161
static LinkageTypes getWeakLinkage(bool ODR)
static bool isWeakForLinker(LinkageTypes Linkage)
Whether the definition of this global may be replaced at link time.
bool hasAppendingLinkage() const
bool hasAvailableExternallyLinkage() const
LinkageTypes
An enumeration for the kinds of linkage for global values.
Definition GlobalValue.h:52
@ CommonLinkage
Tentative definitions.
Definition GlobalValue.h:63
@ InternalLinkage
Rename collisions when linking (static functions).
Definition GlobalValue.h:60
@ ExternalLinkage
Externally visible function.
Definition GlobalValue.h:53
@ WeakAnyLinkage
Keep one copy of named function when linking (weak)
Definition GlobalValue.h:57
@ AvailableExternallyLinkage
Available for inspection, not emission.
Definition GlobalValue.h:54
DLLStorageClassTypes getDLLStorageClass() const
Type * getValueType() const
static bool isLinkOnceODRLinkage(LinkageTypes Linkage)
LLVM_ABI void eraseFromParent()
eraseFromParent - This method unlinks 'this' from the containing module and deletes it.
Definition Globals.cpp:529
void setAlignment(Align Align)
Sets the alignment attribute of the GlobalVariable.
This is an important class for using LLVM in a threaded context.
Definition LLVMContext.h:68
static MDTuple * get(LLVMContext &Context, ArrayRef< Metadata * > MDs)
Definition Metadata.h:1526
This class implements a map that also provides access to all stored values in a deterministic order.
Definition MapVector.h:36
bool empty() const
Definition MapVector.h:77
iterator begin()
Definition MapVector.h:65
size_type size() const
Definition MapVector.h:56
PreservedAnalyses run(Module &M, ModuleAnalysisManager &AM)
StringRef getBuffer() const
static ErrorOr< std::unique_ptr< MemoryBuffer > > getFile(const Twine &Filename, bool IsText=false, bool RequiresNullTerminator=true, bool IsVolatile=false, std::optional< Align > Alignment=std::nullopt)
Open the specified file as a MemoryBuffer, returning a new MemoryBuffer if successful,...
Class to hold module path string table and global value map, and encapsulate methods for operating on...
CfiFunctionIndex & cfiFunctionDecls()
const ModuleHash & getModuleHash(const StringRef ModPath) const
Get the module SHA1 hash recorded for the given module path.
const StringMap< ModuleHash > & modulePaths() const
Table of modules, containing module hash and id.
CfiFunctionIndex & cfiFunctionDefs()
LLVM_ABI void addModule(Module *M)
static LLVM_ABI void CollectAsmSymvers(const Module &M, function_ref< void(StringRef, StringRef)> AsmSymver)
Parse inline ASM and collect the symvers directives that are defined in the current module.
PointerUnion< GlobalValue *, AsmSymbol * > Symbol
LLVM_ABI uint32_t getSymbolFlags(Symbol S) const
ArrayRef< Symbol > symbols() const
A Module instance is used to store all the information related to an LLVM module.
Definition Module.h:67
A class that wrap the SHA1 algorithm.
Definition SHA1.h:27
LLVM_ABI void update(ArrayRef< uint8_t > Data)
Digest more data.
Definition SHA1.cpp:208
LLVM_ABI std::array< uint8_t, 20 > result()
Return the current raw 160-bits SHA1 for the digested data since the last call to init().
Definition SHA1.cpp:288
size_type count(const T &V) const
count - Return 1 if the element is in the set, 0 otherwise.
Definition SmallSet.h:175
bool empty() const
Definition SmallSet.h:168
bool erase(const T &V)
Definition SmallSet.h:199
std::pair< const_iterator, bool > insert(const T &V)
insert - Insert an element into the set if it isn't already there.
Definition SmallSet.h:183
SmallString - A SmallString is just a SmallVector with methods and accessors that make it work better...
Definition SmallString.h:26
StringRef str() const
Explicit conversion to StringRef.
void reserve(size_type N)
void resize(size_type N)
void push_back(const T &Elt)
This is a 'vector' (really, a variable-sized array), optimized for the case when the array is small.
A wrapper around a string literal that serves as a proxy for constructing global tables of StringRefs...
Definition StringRef.h:864
size_type count(StringRef Key) const
count - Return 1 if the element is in the map, 0 otherwise.
Definition StringMap.h:285
StringRef - Represent a constant reference to a string, i.e.
Definition StringRef.h:55
constexpr bool empty() const
empty - Check if the string is empty.
Definition StringRef.h:143
constexpr const char * data() const
data - Get a pointer to the start of the string (which may not be null terminated).
Definition StringRef.h:140
Saves strings in the provided stable storage and returns a StringRef with a stable character pointer.
Definition StringSaver.h:22
StringRef save(const char *S)
Definition StringSaver.h:31
MCTargetOptions MCOptions
Machine level options.
DebuggerKind DebuggerTuning
Which debugger to tune for.
unsigned FunctionSections
Emit functions into separate sections.
unsigned DataSections
Emit data into separate sections.
This tells how a thread pool will be used.
Definition Threading.h:115
The TimeTraceScope is a helper class to call the begin and end functions of the time trace profiler.
Triple - Helper class for working with autoconf configuration names.
Definition Triple.h:47
bool isArm64e() const
Tests whether the target is the Apple "arm64e" AArch64 subarch.
Definition Triple.h:1164
ArchType getArch() const
Get the parsed architecture type of this triple.
Definition Triple.h:418
bool isOSBinFormatCOFF() const
Tests whether the OS uses the COFF binary format.
Definition Triple.h:796
const std::string & str() const
Definition Triple.h:485
bool isOSDarwin() const
Is this a "Darwin" OS (macOS, iOS, tvOS, watchOS, DriverKit, XROS, or bridgeOS).
Definition Triple.h:632
bool isOSBinFormatELF() const
Tests whether the OS uses the ELF binary format.
Definition Triple.h:791
Twine - A lightweight data structure for efficiently representing the concatenation of temporary valu...
Definition Twine.h:82
The instances of the Type class are immutable: once they are created, they are never changed.
Definition Type.h:45
static LLVM_ABI IntegerType * getInt8Ty(LLVMContext &C)
Definition Type.cpp:294
LLVM_ABI void setName(const Twine &Name)
Change the name of the value.
Definition Value.cpp:397
LLVM_ABI void replaceAllUsesWith(Value *V)
Change all uses of this to point to a new Value.
Definition Value.cpp:553
bool use_empty() const
Definition Value.h:346
LLVM_ABI StringRef getName() const
Return a constant reference to the value's name.
Definition Value.cpp:322
LLVM_ABI void takeName(Value *V)
Transfer the name from V to this value.
Definition Value.cpp:403
std::pair< iterator, bool > insert(const ValueT &V)
Definition DenseSet.h:202
iterator find(const_arg_type_t< ValueT > V)
Definition DenseSet.h:167
void insert_range(Range &&R)
Definition DenseSet.h:228
size_type size() const
Definition DenseSet.h:87
bool contains(const_arg_type_t< ValueT > V) const
Check if the set contains the given element.
Definition DenseSet.h:175
size_type count(const_arg_type_t< ValueT > V) const
Return 1 if the specified key is in the set, 0 otherwise.
Definition DenseSet.h:180
An efficient, type-erasing, non-owning reference to a callable.
Ephemeral symbols produced by Reader::symbols() and Reader::module_symbols().
Definition IRSymtab.h:316
An input file.
Definition LTO.h:113
LLVM_ABI BitcodeModule & getPrimaryBitcodeModule()
Definition LTO.cpp:609
static LLVM_ABI Expected< std::unique_ptr< InputFile > > create(MemoryBufferRef Object)
Create an InputFile.
Definition LTO.cpp:569
ArrayRef< Symbol > symbols() const
A range over the symbols in this InputFile.
Definition LTO.h:173
LLVM_ABI StringRef getName() const
Returns the path to the InputFile.
Definition LTO.cpp:600
LLVM_ABI BitcodeModule & getSingleBitcodeModule()
Definition LTO.cpp:604
LLVM_ABI LTO(Config Conf, ThinBackend Backend={}, unsigned ParallelCodeGenParallelismLevel=1, LTOKind LTOMode=LTOK_Default)
Create an LTO object.
Definition LTO.cpp:624
LLVM_ABI Error add(std::unique_ptr< InputFile > Obj, ArrayRef< SymbolResolution > Res)
Add an input file to the LTO link, using the provided symbol resolutions.
Definition LTO.cpp:745
static LLVM_ABI SmallVector< const char * > getRuntimeLibcallSymbols(const Triple &TT)
Static method that returns a list of libcall symbols that can be generated by LTO but might not be vi...
Definition LTO.cpp:1416
virtual Error handleArchiveInputs()
Definition LTO.h:450
virtual Expected< std::shared_ptr< lto::InputFile > > addInput(std::unique_ptr< lto::InputFile > InputPtr)
Definition LTO.h:629
LTOKind
Unified LTO modes.
Definition LTO.h:401
@ LTOK_UnifiedRegular
Regular LTO, with Unified LTO enabled.
Definition LTO.h:406
@ LTOK_Default
Any LTO mode without Unified LTO. The default mode.
Definition LTO.h:403
@ LTOK_UnifiedThin
ThinLTO, with Unified LTO enabled.
Definition LTO.h:409
virtual LLVM_ABI ~LTO()
virtual void cleanup()
Definition LTO.h:453
LLVM_ABI unsigned getMaxTasks() const
Returns an upper bound on the number of tasks that the client may expect.
Definition LTO.cpp:1168
LLVM_ABI Error run(AddStreamFn AddStream, FileCache Cache={})
Runs the LTO pipeline.
Definition LTO.cpp:1219
This class defines the interface to the ThinLTO backend.
Definition LTO.h:229
const DenseMap< StringRef, GVSummaryMapTy > & ModuleToDefinedGVSummaries
Definition LTO.h:233
LLVM_ABI Error emitFiles(const FunctionImporter::ImportMapTy &ImportList, StringRef ModulePath, const std::string &NewModulePath) const
Definition LTO.cpp:1429
ModuleSummaryIndex & CombinedIndex
Definition LTO.h:232
A raw_ostream that writes to a file descriptor.
This class implements an extremely fast bulk output stream that can only output to a stream.
Definition raw_ostream.h:53
static LLVM_ABI Pid getProcessId()
Get the process's identifier.
#define llvm_unreachable(msg)
Marks that the current location is not supposed to be reachable.
constexpr char Align[]
Key for Kernel::Arg::Metadata::mAlign.
constexpr char Args[]
Key for Kernel::Metadata::mArgs.
@ C
The default llvm calling convention, compatible with C.
Definition CallingConv.h:34
LLVM_ABI Function * getDeclarationIfExists(const Module *M, ID id)
Look up the Function declaration of the intrinsic id in the Module M and return it if it exists.
static auto libcall_impls()
LLVM_ABI Expected< stable_hash > mergeCodeGenData(ArrayRef< StringRef > ObjectFiles)
Merge the codegen data from the scratch objects ObjectFiles from the first codegen round.
LLVM_ABI std::unique_ptr< Module > loadModuleForTwoRounds(BitcodeModule &OrigModule, unsigned Task, LLVMContext &Context, ArrayRef< StringRef > IRFiles)
Load the optimized bitcode module for the second codegen round.
initializer< Ty > init(const Ty &Val)
LLVM_ABI ThinBackend createInProcessThinBackend(ThreadPoolStrategy Parallelism, IndexWriteCallback OnWrite=nullptr, bool ShouldEmitIndexFiles=false, bool ShouldEmitImportsFiles=false)
This ThinBackend runs the individual backend jobs in-process.
Definition LTO.cpp:1779
LLVM_ABI std::string getThinLTOOutputFile(StringRef Path, StringRef OldPrefix, StringRef NewPrefix)
Given the original Path to an output file, replace any path prefix matching OldPrefix with NewPrefix.
Definition LTO.cpp:1813
LLVM_ABI StringLiteral getThinLTODefaultCPU(const Triple &TheTriple)
Definition LTO.cpp:1795
LLVM_ABI Expected< std::unique_ptr< ToolOutputFile > > setupStatsFile(StringRef StatsFilename)
Setups the output file for saving statistics.
Definition LTO.cpp:2193
LLVM_ABI ThinBackend createOutOfProcessThinBackend(ThreadPoolStrategy Parallelism, IndexWriteCallback OnWrite, bool ShouldEmitIndexFiles, bool ShouldEmitImportsFiles, StringRef LinkerOutputFile, StringRef Distributor, ArrayRef< StringRef > DistributorArgs, StringRef RemoteCompiler, ArrayRef< StringRef > RemoteCompilerPrependArgs, ArrayRef< StringRef > RemoteCompilerArgs, bool SaveTemps)
This ThinBackend generates the index shards and then runs the individual backend jobs via an external...
Definition LTO.cpp:2661
LLVM_ABI Error backend(const Config &C, AddStreamFn AddStream, unsigned ParallelCodeGenParallelismLevel, Module &M, ModuleSummaryIndex &CombinedIndex)
Runs a regular LTO backend.
std::function< void(const std::string &)> IndexWriteCallback
Definition LTO.h:224
LLVM_ABI Error finalizeOptimizationRemarks(LLVMRemarkFileHandle DiagOutputFile)
LLVM_ABI ThinBackend createWriteIndexesThinBackend(ThreadPoolStrategy Parallelism, std::string OldPrefix, std::string NewPrefix, std::string NativeObjectPrefix, bool ShouldEmitImportsFiles, raw_fd_ostream *LinkedObjectsFile, IndexWriteCallback OnWrite)
This ThinBackend writes individual module indexes to files, instead of running the individual backend...
Definition LTO.cpp:1899
LLVM_ABI Expected< LLVMRemarkFileHandle > setupLLVMOptimizationRemarks(LLVMContext &Context, StringRef RemarksFilename, StringRef RemarksPasses, StringRef RemarksFormat, bool RemarksWithHotness, std::optional< uint64_t > RemarksHotnessThreshold=0, int Count=-1)
Setup optimization remarks.
Definition LTO.cpp:2168
LLVM_ABI std::vector< int > generateModulesOrdering(ArrayRef< BitcodeModule * > R)
Produces a container ordering for optimal multi-threaded processing.
Definition LTO.cpp:2212
LLVM_ABI Error thinBackend(const Config &C, unsigned Task, AddStreamFn AddStream, Module &M, const ModuleSummaryIndex &CombinedIndex, const FunctionImporter::ImportMapTy &ImportList, const GVSummaryMapTy &DefinedGlobals, MapVector< StringRef, BitcodeModule > *ModuleMap, bool CodeGenOnly, AddStreamFn IRAddStream=nullptr, const std::vector< uint8_t > &CmdArgs=std::vector< uint8_t >())
Runs a ThinLTO backend.
llvm::SmallVector< std::string > ImportsFilesContainer
Definition LTO.h:226
LLVM_ABI Expected< IRSymtabFile > readIRSymtab(MemoryBufferRef MBRef)
Reads a bitcode file, creating its irsymtab if necessary.
DiagnosticInfoOptimizationBase::Argument NV
void write64le(void *P, uint64_t V)
Definition Endian.h:478
void write32le(void *P, uint32_t V)
Definition Endian.h:475
LLVM_ABI std::error_code remove(const Twine &path, bool IgnoreNonExisting=true)
Remove path.
LLVM_ABI std::error_code create_directories(const Twine &path, bool IgnoreExisting=true, perms Perms=owner_all|group_all)
Create all the non-existent directories in path.
Definition Path.cpp:976
LLVM_ABI StringRef stem(StringRef path LLVM_LIFETIME_BOUND, Style style=Style::native)
Get stem.
Definition Path.cpp:580
LLVM_ABI StringRef parent_path(StringRef path LLVM_LIFETIME_BOUND, Style style=Style::native)
Get parent path.
Definition Path.cpp:468
LLVM_ABI bool replace_path_prefix(SmallVectorImpl< char > &Path, StringRef OldPrefix, StringRef NewPrefix, Style style=Style::native)
Replace matching path prefix with another path.
Definition Path.cpp:519
LLVM_ABI void append(SmallVectorImpl< char > &path, const Twine &a, const Twine &b="", const Twine &c="", const Twine &d="")
Append to path.
Definition Path.cpp:457
LLVM_ABI bool RemoveFileOnSignal(StringRef Filename, std::string *ErrMsg=nullptr)
This function registers signal handlers to ensure that if a signal gets delivered that the named file...
LLVM_ABI int ExecuteAndWait(StringRef Program, ArrayRef< StringRef > Args, std::optional< ArrayRef< StringRef > > Env=std::nullopt, ArrayRef< std::optional< StringRef > > Redirects={}, unsigned SecondsToWait=0, unsigned MemoryLimit=0, std::string *ErrMsg=nullptr, bool *ExecutionFailed=nullptr, std::optional< ProcessStatistics > *ProcStat=nullptr, BitVector *AffinityMask=nullptr)
This function executes the program using the arguments provided.
Definition Program.cpp:32
This is an optimization pass for GlobalISel generic memory operations.
Definition Types.h:26
ThreadPoolStrategy heavyweight_hardware_concurrency(unsigned ThreadCount=0)
Returns a thread strategy for tasks requiring significant memory or other resources.
Definition Threading.h:167
detail::zippy< detail::zip_shortest, T, U, Args... > zip(T &&t, U &&u, Args &&...args)
zip iterator for two or more iteratable types.
Definition STLExtras.h:829
cl::opt< std::string > RemarksFormat("lto-pass-remarks-format", cl::desc("The format used for serializing remarks (default: YAML)"), cl::value_desc("format"), cl::init("yaml"))
bool all_of(R &&range, UnaryPredicate P)
Provide wrappers to std::all_of which take ranges instead of having to pass begin/end explicitly.
Definition STLExtras.h:1737
Error createFileError(const Twine &F, Error E)
Concatenate a source file path and/or name with an Error.
Definition Error.h:1399
std::unordered_set< GlobalValueSummary * > GVSummaryPtrSet
A set of global value summary pointers.
decltype(auto) dyn_cast(const From &Val)
dyn_cast<X> - Return the argument parameter cast to the specified type.
Definition Casting.h:643
void generateParamAccessSummary(ModuleSummaryIndex &Index)
cl::opt< bool > CodeGenDataThinLTOTwoRounds("codegen-data-thinlto-two-rounds", cl::init(false), cl::Hidden, cl::desc("Enable two-round ThinLTO code generation. The first round " "emits codegen data, while the second round uses the emitted " "codegen data for further optimizations."))
Definition LTO.cpp:79
LLVM_ABI Expected< LLVMRemarkFileHandle > setupLLVMOptimizationRemarks(LLVMContext &Context, StringRef RemarksFilename, StringRef RemarksPasses, StringRef RemarksFormat, bool RemarksWithHotness, std::optional< uint64_t > RemarksHotnessThreshold=0)
Set up optimization remarks that output to a file.
scope_exit(Callable) -> scope_exit< Callable >
cl::opt< std::string > RemarksPasses("lto-pass-remarks-filter", cl::desc("Only record optimization remarks from passes whose " "names match the given regular expression"), cl::value_desc("regex"))
LLVM_ABI std::error_code inconvertibleErrorCode()
The value returned by this function can be returned from convertToErrorCode for Error values where no...
Definition Error.cpp:94
LLVM_ABI raw_fd_ostream & outs()
This returns a reference to a raw_fd_ostream for standard output.
DenseMap< GlobalValue::GUID, GlobalValueSummary * > GVSummaryMapTy
Map of global value GUID to its summary, used to identify values defined in a particular module,...
auto dyn_cast_if_present(const Y &Val)
dyn_cast_if_present<X> - Functionally identical to dyn_cast, except that a null (or none in the case ...
Definition Casting.h:732
iterator_range< T > make_range(T x, T y)
Convenience function for iterating over sub-ranges.
void append_range(Container &C, Range &&R)
Wrapper function to append range R to container C.
Definition STLExtras.h:2198
uint64_t stable_hash
An opaque object representing a stable hash code.
std::string utostr(uint64_t X, bool isNeg=false)
LLVM_ABI bool thinLTOPropagateFunctionAttrs(ModuleSummaryIndex &Index, function_ref< bool(GlobalValue::GUID, const GlobalValueSummary *)> isPrevailing)
Propagate function attributes for function summaries along the index's callgraph during thinlink.
Error createStringError(std::error_code EC, char const *Fmt, const Ts &... Vals)
Create formatted StringError object.
Definition Error.h:1305
LLVM_ABI bool hasWholeProgramVisibility(bool WholeProgramVisibilityEnabledInLTO)
LLVM_ABI void writeIndexToFile(const ModuleSummaryIndex &Index, raw_ostream &Out, const ModuleToSummariesForIndexTy *ModuleToSummariesForIndex=nullptr, const GVSummaryPtrSet *DecSummaries=nullptr)
Write the specified module summary index to the given raw output stream, where it will be written in ...
LLVM_ABI void ComputeCrossModuleImport(const ModuleSummaryIndex &Index, const DenseMap< StringRef, GVSummaryMapTy > &ModuleToDefinedGVSummaries, function_ref< bool(GlobalValue::GUID, const GlobalValueSummary *)> isPrevailing, FunctionImporter::ImportListsTy &ImportLists, DenseMap< StringRef, FunctionImporter::ExportSetTy > &ExportLists)
Compute all the imports and exports for every module in the Index.
auto dyn_cast_or_null(const Y &Val)
Definition Casting.h:753
LLVM_ABI void EnableStatistics(bool DoPrintOnExit=true)
Enable the collection and printing of statistics.
LLVM_ABI void thinLTOInternalizeAndPromoteInIndex(ModuleSummaryIndex &Index, function_ref< bool(StringRef, ValueInfo)> isExported, function_ref< bool(GlobalValue::GUID, const GlobalValueSummary *)> isPrevailing)
Update the linkages in the given Index to mark exported values as external and non-exported values as...
Definition LTO.cpp:554
LLVM_ABI void timeTraceProfilerInitialize(unsigned TimeTraceGranularity, StringRef ProcName, bool TimeTraceVerbose=false)
Initialize the time trace profiler.
LLVM_ABI void timeTraceProfilerFinishThread()
Finish a time trace profiler running on a worker thread.
LLVM_ABI std::string recomputeLTOCacheKey(const std::string &Key, StringRef ExtraID)
Recomputes the LTO cache key for a given key with an extra identifier.
Definition LTO.cpp:355
Error joinErrors(Error E1, Error E2)
Concatenate errors.
Definition Error.h:442
LLVM_ABI void updatePublicTypeTestCalls(Module &M, bool WholeProgramVisibilityEnabledInLTO)
LLVM_ABI void getVisibleToRegularObjVtableGUIDs(ModuleSummaryIndex &Index, DenseSet< GlobalValue::GUID > &VisibleToRegularObjSymbols, function_ref< bool(StringRef)> IsVisibleToRegularObj)
Based on typeID string, get all associated vtable GUIDS that are visible to regular objects.
void sort(IteratorTy Start, IteratorTy End)
Definition STLExtras.h:1634
bool timeTraceProfilerEnabled()
Is the time trace profiler enabled, i.e. initialized?
LLVM_ABI raw_ostream & dbgs()
dbgs() - This returns a reference to a raw_ostream for debugging messages.
Definition Debug.cpp:207
LLVM_ABI void report_fatal_error(Error Err, bool gen_crash_diag=true)
Definition Error.cpp:163
FunctionAddr VTableAddr Count
Definition InstrProf.h:139
std::map< std::string, GVSummaryMapTy, std::less<> > ModuleToSummariesForIndexTy
Map of a module name to the GUIDs and summaries we will import from that module.
LLVM_ABI cl::opt< bool > EnableLTOInternalization
Enable global value internalization in LTO.
cl::opt< bool > RemarksWithHotness("lto-pass-remarks-with-hotness", cl::desc("With PGO, include profile count in optimization remarks"), cl::Hidden)
LLVM_ABI void timeTraceProfilerEnd()
Manually end the last time section.
cl::opt< std::string > RemarksFilename("lto-pass-remarks-output", cl::desc("Output filename for pass remarks"), cl::value_desc("filename"))
cl::opt< bool > SupportsHotColdNew
Indicate we are linking with an allocator that supports hot/cold operator new interfaces.
LLVM_ABI void updateIndexWPDForExports(ModuleSummaryIndex &Summary, function_ref< bool(StringRef, ValueInfo)> isExported, std::map< ValueInfo, std::vector< VTableSlotSummary > > &LocalWPDTargetsMap)
Call after cross-module importing to update the recorded single impl devirt target names for any loca...
class LLVM_GSL_OWNER SmallVector
Forward declaration of SmallVector so that calculateSmallVectorDefaultInlinedElements can reference s...
LLVM_ABI void thinLTOResolvePrevailingInIndex(const lto::Config &C, ModuleSummaryIndex &Index, function_ref< bool(GlobalValue::GUID, const GlobalValueSummary *)> isPrevailing, function_ref< void(StringRef, GlobalValue::GUID, GlobalValue::LinkageTypes)> recordNewLinkage, const DenseSet< GlobalValue::GUID > &GUIDPreservedSymbols)
Resolve linkage for prevailing symbols in the Index.
Definition LTO.cpp:449
bool isa(const From &Val)
isa<X> - Return true if the parameter to the template is an instance of one of the template type argu...
Definition Casting.h:547
LLVM_ATTRIBUTE_VISIBILITY_DEFAULT AnalysisKey InnerAnalysisManagerProxy< AnalysisManagerT, IRUnitT, ExtraArgTs... >::Key
Error make_error(ArgTs &&... Args)
Make a Error instance representing failure using the given error info type.
Definition Error.h:340
LLVM_ABI raw_fd_ostream & errs()
This returns a reference to a raw_ostream for standard error.
@ Mod
The access may modify the value stored in memory.
Definition ModRef.h:34
std::string join(IteratorT Begin, IteratorT End, StringRef Separator)
Joins the strings in the range [Begin, End), adding Separator between the elements.
FunctionAddr VTableAddr uintptr_t uintptr_t Data
Definition InstrProf.h:189
cl::opt< bool > EnableMemProfContextDisambiguation
Enable MemProf context disambiguation for thin link.
LLVM_ABI void runWholeProgramDevirtOnIndex(ModuleSummaryIndex &Summary, std::set< GlobalValue::GUID > &ExportedGUIDs, std::map< ValueInfo, std::vector< VTableSlotSummary > > &LocalWPDTargetsMap)
Perform index-based whole program devirtualization on the Summary index.
cl::opt< bool > ForceImportAll
LLVM_ABI void gatherImportedSummariesForModule(StringRef ModulePath, const DenseMap< StringRef, GVSummaryMapTy > &ModuleToDefinedGVSummaries, const FunctionImporter::ImportMapTy &ImportList, ModuleToSummariesForIndexTy &ModuleToSummariesForIndex, GVSummaryPtrSet &DecSummaries)
Compute the set of summaries needed for a ThinLTO backend compilation of ModulePath.
ArrayRef(const T &OneElt) -> ArrayRef< T >
void toHex(ArrayRef< uint8_t > Input, bool LowerCase, SmallVectorImpl< char > &Output)
Convert buffer Input to its hexadecimal representation. The returned string is double the size of Inp...
OutputIt move(R &&Range, OutputIt Out)
Provide wrappers to std::move which take ranges instead of having to pass begin/end explicitly.
Definition STLExtras.h:1915
LLVM_ABI void processImportsFiles(StringRef ModulePath, const ModuleToSummariesForIndexTy &ModuleToSummariesForIndex, function_ref< void(const std::string &)> F)
Call F passing each of the files module ModulePath will import from.
cl::opt< std::optional< uint64_t >, false, remarks::HotnessThresholdParser > RemarksHotnessThreshold("lto-pass-remarks-hotness-threshold", cl::desc("Minimum profile count required for an " "optimization remark to be output." " Use 'auto' to apply the threshold from profile summary."), cl::value_desc("uint or 'auto'"), cl::init(0), cl::Hidden)
decltype(auto) cast(const From &Val)
cast<X> - Return the argument parameter cast to the specified type.
Definition Casting.h:559
LLVM_ABI std::string computeLTOCacheKey(const lto::Config &Conf, const ModuleSummaryIndex &Index, StringRef ModuleID, const FunctionImporter::ImportMapTy &ImportList, const FunctionImporter::ExportSetTy &ExportList, const std::map< GlobalValue::GUID, GlobalValue::LinkageTypes > &ResolvedODR, const GVSummaryMapTy &DefinedGlobals, const DenseSet< GlobalValue::GUID > &CfiFunctionDefs={}, const DenseSet< GlobalValue::GUID > &CfiFunctionDecls={})
Computes a unique hash for the Module considering the current list of export/import and other global ...
Definition LTO.cpp:104
LLVM_ABI Error errorCodeToError(std::error_code EC)
Helper for converting an std::error_code to a Error.
Definition Error.cpp:107
static cl::opt< bool > LTOKeepSymbolCopies("lto-keep-symbol-copies", cl::init(false), cl::Hidden, cl::desc("Keep copies of symbols in LTO indexing"))
LLVM_ABI bool UpgradeDebugInfo(Module &M)
Check the debug info version number, if it is out-dated, drop the debug info.
auto seq(T Begin, T End)
Iterate over an integral type from Begin up to - but not including - End.
Definition Sequence.h:305
BumpPtrAllocatorImpl<> BumpPtrAllocator
The standard BumpPtrAllocator which just uses the default template parameters.
Definition Allocator.h:383
std::function< Expected< std::unique_ptr< CachedFileStream > >( unsigned Task, const Twine &ModuleName)> AddStreamFn
This type defines the callback to add a file that is generated on the fly.
Definition Caching.h:58
LLVM_ABI void PrintStatisticsJSON(raw_ostream &OS)
Print statistics in JSON format.
LLVM_ABI void computeDeadSymbolsWithConstProp(ModuleSummaryIndex &Index, const DenseSet< GlobalValue::GUID > &GUIDPreservedSymbols, function_ref< PrevailingType(GlobalValue::GUID)> isPrevailing, bool ImportEnabled)
Compute dead symbols and run constant propagation in combined index after that.
LLVM_ABI Error EmitImportsFiles(StringRef ModulePath, StringRef OutputFilename, const ModuleToSummariesForIndexTy &ModuleToSummariesForIndex)
Emit into OutputFilename the files module ModulePath will import from.
@ Keep
No function return thunk.
Definition CodeGen.h:162
std::string itostr(int64_t X)
LLVM_ABI void updateVCallVisibilityInModule(Module &M, bool WholeProgramVisibilityEnabledInLTO, const DenseSet< GlobalValue::GUID > &DynamicExportSymbols, bool ValidateAllVtablesHaveTypeInfos, function_ref< bool(StringRef)> IsVisibleToRegularObj)
If whole program visibility asserted, then upgrade all public vcall visibility metadata on vtable def...
LLVM_ABI TimeTraceProfilerEntry * timeTraceProfilerBegin(StringRef Name, StringRef Detail)
Manually begin a time section, with the given Name and Detail.
LLVM_ABI void updateVCallVisibilityInIndex(ModuleSummaryIndex &Index, bool WholeProgramVisibilityEnabledInLTO, const DenseSet< GlobalValue::GUID > &DynamicExportSymbols, const DenseSet< GlobalValue::GUID > &VisibleToRegularObjSymbols)
If whole program visibility asserted, then upgrade all public vcall visibility metadata on vtable def...
Implement std::hash so that hash_code can be used in STL containers.
Definition BitVector.h:870
This type represents a file cache system that manages caching of files.
Definition Caching.h:84
const std::string & getCacheDirectoryPath() const
Definition Caching.h:94
bool isValid() const
Definition Caching.h:97
A simple container for information about the supported runtime calls.
unsigned getNumAvailableLibcallImpls() const
bool isAvailable(RTLIB::LibcallImpl Impl) const
static StringRef getLibcallImplName(RTLIB::LibcallImpl CallImpl)
Get the libcall routine name for the specified libcall implementation.
Struct that holds a reference to a particular GUID in a global value summary.
LTO configuration.
Definition Config.h:42
std::optional< uint64_t > RemarksHotnessThreshold
The minimum hotness value a diagnostic needs in order to be included in optimization diagnostics.
Definition Config.h:171
std::optional< CodeModel::Model > CodeModel
Definition Config.h:57
std::string AAPipeline
Definition Config.h:116
bool CodeGenOnly
Disable entirely the optimizer, including importing for ThinLTO.
Definition Config.h:69
std::vector< std::string > MAttrs
Definition Config.h:51
std::vector< std::string > MllvmArgs
Definition Config.h:52
CodeGenOptLevel CGOptLevel
Definition Config.h:58
bool Dtlto
This flag is used as one of parameters to calculate cache entries and to ensure that in-process cache...
Definition Config.h:100
std::string DefaultTriple
Setting this field will replace unspecified target triples in input files with this triple.
Definition Config.h:124
std::string CPU
Definition Config.h:49
std::string DwoDir
The directory to store .dwo files.
Definition Config.h:136
std::string RemarksFilename
Optimization remarks file path.
Definition Config.h:150
std::string OverrideTriple
Setting this field will replace target triples in input files with this triple.
Definition Config.h:120
std::string ProfileRemapping
Name remapping file for profile data.
Definition Config.h:133
TargetOptions Options
Definition Config.h:50
bool TimeTraceEnabled
Time trace enabled.
Definition Config.h:186
std::string RemarksPasses
Optimization remarks pass filter.
Definition Config.h:153
std::string OptPipeline
If this field is set, the set of passes run in the middle-end optimizer will be the one specified by ...
Definition Config.h:111
unsigned TimeTraceGranularity
Time trace granularity.
Definition Config.h:189
unsigned OptLevel
Definition Config.h:60
bool RemarksWithHotness
Whether to emit optimization remarks with hotness informations.
Definition Config.h:156
std::optional< Reloc::Model > RelocModel
Definition Config.h:56
CodeGenFileType CGFileType
Definition Config.h:59
bool Freestanding
Flag to indicate that the optimizer should not assume builtins are present on the target.
Definition Config.h:66
std::string SampleProfile
Sample PGO profile path.
Definition Config.h:130
std::string RemarksFormat
The format used for serializing remarks (default: YAML).
Definition Config.h:174
The purpose of this struct is to only expose the symbol information that an LTO client should need in...
Definition LTO.h:148
The resolution for a symbol.
Definition LTO.h:636
unsigned FinalDefinitionInLinkageUnit
The definition of this symbol is unpreemptable at runtime and is known to be in this linkage unit.
Definition LTO.h:646
unsigned ExportDynamic
The symbol was exported dynamically, and therefore could be referenced by a shared library not visibl...
Definition LTO.h:653
unsigned Prevailing
The linker has chosen this definition of the symbol.
Definition LTO.h:642
unsigned LinkerRedefined
Linker redefined version of the symbol which appeared in -wrap or -defsym linker option.
Definition LTO.h:657
unsigned VisibleToRegularObj
The definition of this symbol is visible outside of the LTO unit.
Definition LTO.h:649
This type defines the behavior following the thin-link phase during ThinLTO.
Definition LTO.h:299