1 //===-LTO.cpp - LLVM Link Time Optimizer ----------------------------------===//
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
7 //===----------------------------------------------------------------------===//
9 // This file implements functions and classes used to support LTO.
11 //===----------------------------------------------------------------------===//
13 #include "llvm/LTO/LTO.h"
14 #include "llvm/ADT/Statistic.h"
15 #include "llvm/Analysis/TargetLibraryInfo.h"
16 #include "llvm/Analysis/TargetTransformInfo.h"
17 #include "llvm/Bitcode/BitcodeReader.h"
18 #include "llvm/Bitcode/BitcodeWriter.h"
19 #include "llvm/CodeGen/Analysis.h"
20 #include "llvm/Config/llvm-config.h"
21 #include "llvm/IR/AutoUpgrade.h"
22 #include "llvm/IR/DiagnosticPrinter.h"
23 #include "llvm/IR/Intrinsics.h"
24 #include "llvm/IR/LegacyPassManager.h"
25 #include "llvm/IR/Mangler.h"
26 #include "llvm/IR/Metadata.h"
27 #include "llvm/LTO/LTOBackend.h"
28 #include "llvm/LTO/SummaryBasedOptimizations.h"
29 #include "llvm/Linker/IRMover.h"
30 #include "llvm/Object/IRObjectFile.h"
31 #include "llvm/Support/Error.h"
32 #include "llvm/Support/ManagedStatic.h"
33 #include "llvm/Support/MemoryBuffer.h"
34 #include "llvm/Support/Path.h"
35 #include "llvm/Support/SHA1.h"
36 #include "llvm/Support/SourceMgr.h"
37 #include "llvm/Support/TargetRegistry.h"
38 #include "llvm/Support/ThreadPool.h"
39 #include "llvm/Support/Threading.h"
40 #include "llvm/Support/VCSRevision.h"
41 #include "llvm/Support/raw_ostream.h"
42 #include "llvm/Target/TargetMachine.h"
43 #include "llvm/Target/TargetOptions.h"
44 #include "llvm/Transforms/IPO.h"
45 #include "llvm/Transforms/IPO/PassManagerBuilder.h"
46 #include "llvm/Transforms/Utils/FunctionImportUtils.h"
47 #include "llvm/Transforms/Utils/SplitModule.h"
53 using namespace object
;
55 #define DEBUG_TYPE "lto"
58 DumpThinCGSCCs("dump-thin-cg-sccs", cl::init(false), cl::Hidden
,
59 cl::desc("Dump the SCCs in the ThinLTO index's callgraph"));
61 /// Enable global value internalization in LTO.
62 cl::opt
<bool> EnableLTOInternalization(
63 "enable-lto-internalization", cl::init(true), cl::Hidden
,
64 cl::desc("Enable global value internalization in LTO"));
66 // Computes a unique hash for the Module considering the current list of
67 // export/import and other global analysis results.
68 // The hash is produced in \p Key.
69 void llvm::computeLTOCacheKey(
70 SmallString
<40> &Key
, const Config
&Conf
, const ModuleSummaryIndex
&Index
,
71 StringRef ModuleID
, const FunctionImporter::ImportMapTy
&ImportList
,
72 const FunctionImporter::ExportSetTy
&ExportList
,
73 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
74 const GVSummaryMapTy
&DefinedGlobals
,
75 const std::set
<GlobalValue::GUID
> &CfiFunctionDefs
,
76 const std::set
<GlobalValue::GUID
> &CfiFunctionDecls
) {
77 // Compute the unique hash for this entry.
78 // This is based on the current compiler version, the module itself, the
79 // export list, the hash for every single module in the import list, the
80 // list of ResolvedODR for the module, and the list of preserved symbols.
83 // Start with the compiler revision
84 Hasher
.update(LLVM_VERSION_STRING
);
86 Hasher
.update(LLVM_REVISION
);
89 // Include the parts of the LTO configuration that affect code generation.
90 auto AddString
= [&](StringRef Str
) {
92 Hasher
.update(ArrayRef
<uint8_t>{0});
94 auto AddUnsigned
= [&](unsigned I
) {
100 Hasher
.update(ArrayRef
<uint8_t>{Data
, 4});
102 auto AddUint64
= [&](uint64_t I
) {
112 Hasher
.update(ArrayRef
<uint8_t>{Data
, 8});
115 // FIXME: Hash more of Options. For now all clients initialize Options from
116 // command-line flags (which is unsupported in production), but may set
117 // RelaxELFRelocations. The clang driver can also pass FunctionSections,
118 // DataSections and DebuggerTuning via command line flags.
119 AddUnsigned(Conf
.Options
.RelaxELFRelocations
);
120 AddUnsigned(Conf
.Options
.FunctionSections
);
121 AddUnsigned(Conf
.Options
.DataSections
);
122 AddUnsigned((unsigned)Conf
.Options
.DebuggerTuning
);
123 for (auto &A
: Conf
.MAttrs
)
126 AddUnsigned(*Conf
.RelocModel
);
130 AddUnsigned(*Conf
.CodeModel
);
133 AddUnsigned(Conf
.CGOptLevel
);
134 AddUnsigned(Conf
.CGFileType
);
135 AddUnsigned(Conf
.OptLevel
);
136 AddUnsigned(Conf
.UseNewPM
);
137 AddUnsigned(Conf
.Freestanding
);
138 AddString(Conf
.OptPipeline
);
139 AddString(Conf
.AAPipeline
);
140 AddString(Conf
.OverrideTriple
);
141 AddString(Conf
.DefaultTriple
);
142 AddString(Conf
.DwoDir
);
144 // Include the hash for the current module
145 auto ModHash
= Index
.getModuleHash(ModuleID
);
146 Hasher
.update(ArrayRef
<uint8_t>((uint8_t *)&ModHash
[0], sizeof(ModHash
)));
147 for (auto F
: ExportList
)
148 // The export list can impact the internalization, be conservative here
149 Hasher
.update(ArrayRef
<uint8_t>((uint8_t *)&F
, sizeof(F
)));
151 // Include the hash for every module we import functions from. The set of
152 // imported symbols for each module may affect code generation and is
153 // sensitive to link order, so include that as well.
154 for (auto &Entry
: ImportList
) {
155 auto ModHash
= Index
.getModuleHash(Entry
.first());
156 Hasher
.update(ArrayRef
<uint8_t>((uint8_t *)&ModHash
[0], sizeof(ModHash
)));
158 AddUint64(Entry
.second
.size());
159 for (auto &Fn
: Entry
.second
)
163 // Include the hash for the resolved ODR.
164 for (auto &Entry
: ResolvedODR
) {
165 Hasher
.update(ArrayRef
<uint8_t>((const uint8_t *)&Entry
.first
,
166 sizeof(GlobalValue::GUID
)));
167 Hasher
.update(ArrayRef
<uint8_t>((const uint8_t *)&Entry
.second
,
168 sizeof(GlobalValue::LinkageTypes
)));
171 // Members of CfiFunctionDefs and CfiFunctionDecls that are referenced or
172 // defined in this module.
173 std::set
<GlobalValue::GUID
> UsedCfiDefs
;
174 std::set
<GlobalValue::GUID
> UsedCfiDecls
;
176 // Typeids used in this module.
177 std::set
<GlobalValue::GUID
> UsedTypeIds
;
179 auto AddUsedCfiGlobal
= [&](GlobalValue::GUID ValueGUID
) {
180 if (CfiFunctionDefs
.count(ValueGUID
))
181 UsedCfiDefs
.insert(ValueGUID
);
182 if (CfiFunctionDecls
.count(ValueGUID
))
183 UsedCfiDecls
.insert(ValueGUID
);
186 auto AddUsedThings
= [&](GlobalValueSummary
*GS
) {
188 AddUnsigned(GS
->isLive());
189 for (const ValueInfo
&VI
: GS
->refs()) {
190 AddUnsigned(VI
.isDSOLocal());
191 AddUsedCfiGlobal(VI
.getGUID());
193 if (auto *GVS
= dyn_cast
<GlobalVarSummary
>(GS
))
194 AddUnsigned(GVS
->isReadOnly());
195 if (auto *FS
= dyn_cast
<FunctionSummary
>(GS
)) {
196 for (auto &TT
: FS
->type_tests())
197 UsedTypeIds
.insert(TT
);
198 for (auto &TT
: FS
->type_test_assume_vcalls())
199 UsedTypeIds
.insert(TT
.GUID
);
200 for (auto &TT
: FS
->type_checked_load_vcalls())
201 UsedTypeIds
.insert(TT
.GUID
);
202 for (auto &TT
: FS
->type_test_assume_const_vcalls())
203 UsedTypeIds
.insert(TT
.VFunc
.GUID
);
204 for (auto &TT
: FS
->type_checked_load_const_vcalls())
205 UsedTypeIds
.insert(TT
.VFunc
.GUID
);
206 for (auto &ET
: FS
->calls()) {
207 AddUnsigned(ET
.first
.isDSOLocal());
208 AddUsedCfiGlobal(ET
.first
.getGUID());
213 // Include the hash for the linkage type to reflect internalization and weak
214 // resolution, and collect any used type identifier resolutions.
215 for (auto &GS
: DefinedGlobals
) {
216 GlobalValue::LinkageTypes Linkage
= GS
.second
->linkage();
218 ArrayRef
<uint8_t>((const uint8_t *)&Linkage
, sizeof(Linkage
)));
219 AddUsedCfiGlobal(GS
.first
);
220 AddUsedThings(GS
.second
);
223 // Imported functions may introduce new uses of type identifier resolutions,
224 // so we need to collect their used resolutions as well.
225 for (auto &ImpM
: ImportList
)
226 for (auto &ImpF
: ImpM
.second
) {
227 GlobalValueSummary
*S
= Index
.findSummaryInModule(ImpF
, ImpM
.first());
229 // If this is an alias, we also care about any types/etc. that the aliasee
231 if (auto *AS
= dyn_cast_or_null
<AliasSummary
>(S
))
232 AddUsedThings(AS
->getBaseObject());
235 auto AddTypeIdSummary
= [&](StringRef TId
, const TypeIdSummary
&S
) {
238 AddUnsigned(S
.TTRes
.TheKind
);
239 AddUnsigned(S
.TTRes
.SizeM1BitWidth
);
241 AddUint64(S
.TTRes
.AlignLog2
);
242 AddUint64(S
.TTRes
.SizeM1
);
243 AddUint64(S
.TTRes
.BitMask
);
244 AddUint64(S
.TTRes
.InlineBits
);
246 AddUint64(S
.WPDRes
.size());
247 for (auto &WPD
: S
.WPDRes
) {
248 AddUnsigned(WPD
.first
);
249 AddUnsigned(WPD
.second
.TheKind
);
250 AddString(WPD
.second
.SingleImplName
);
252 AddUint64(WPD
.second
.ResByArg
.size());
253 for (auto &ByArg
: WPD
.second
.ResByArg
) {
254 AddUint64(ByArg
.first
.size());
255 for (uint64_t Arg
: ByArg
.first
)
257 AddUnsigned(ByArg
.second
.TheKind
);
258 AddUint64(ByArg
.second
.Info
);
259 AddUnsigned(ByArg
.second
.Byte
);
260 AddUnsigned(ByArg
.second
.Bit
);
265 // Include the hash for all type identifiers used by this module.
266 for (GlobalValue::GUID TId
: UsedTypeIds
) {
267 auto TidIter
= Index
.typeIds().equal_range(TId
);
268 for (auto It
= TidIter
.first
; It
!= TidIter
.second
; ++It
)
269 AddTypeIdSummary(It
->second
.first
, It
->second
.second
);
272 AddUnsigned(UsedCfiDefs
.size());
273 for (auto &V
: UsedCfiDefs
)
276 AddUnsigned(UsedCfiDecls
.size());
277 for (auto &V
: UsedCfiDecls
)
280 if (!Conf
.SampleProfile
.empty()) {
281 auto FileOrErr
= MemoryBuffer::getFile(Conf
.SampleProfile
);
283 Hasher
.update(FileOrErr
.get()->getBuffer());
285 if (!Conf
.ProfileRemapping
.empty()) {
286 FileOrErr
= MemoryBuffer::getFile(Conf
.ProfileRemapping
);
288 Hasher
.update(FileOrErr
.get()->getBuffer());
293 Key
= toHex(Hasher
.result());
296 static void thinLTOResolvePrevailingGUID(
297 GlobalValueSummaryList
&GVSummaryList
, GlobalValue::GUID GUID
,
298 DenseSet
<GlobalValueSummary
*> &GlobalInvolvedWithAlias
,
299 function_ref
<bool(GlobalValue::GUID
, const GlobalValueSummary
*)>
301 function_ref
<void(StringRef
, GlobalValue::GUID
, GlobalValue::LinkageTypes
)>
303 for (auto &S
: GVSummaryList
) {
304 GlobalValue::LinkageTypes OriginalLinkage
= S
->linkage();
305 // Ignore local and appending linkage values since the linker
306 // doesn't resolve them.
307 if (GlobalValue::isLocalLinkage(OriginalLinkage
) ||
308 GlobalValue::isAppendingLinkage(S
->linkage()))
310 // We need to emit only one of these. The prevailing module will keep it,
311 // but turned into a weak, while the others will drop it when possible.
312 // This is both a compile-time optimization and a correctness
313 // transformation. This is necessary for correctness when we have exported
314 // a reference - we need to convert the linkonce to weak to
315 // ensure a copy is kept to satisfy the exported reference.
316 // FIXME: We may want to split the compile time and correctness
317 // aspects into separate routines.
318 if (isPrevailing(GUID
, S
.get())) {
319 if (GlobalValue::isLinkOnceLinkage(OriginalLinkage
))
320 S
->setLinkage(GlobalValue::getWeakLinkage(
321 GlobalValue::isLinkOnceODRLinkage(OriginalLinkage
)));
323 // Alias and aliasee can't be turned into available_externally.
324 else if (!isa
<AliasSummary
>(S
.get()) &&
325 !GlobalInvolvedWithAlias
.count(S
.get()))
326 S
->setLinkage(GlobalValue::AvailableExternallyLinkage
);
327 if (S
->linkage() != OriginalLinkage
)
328 recordNewLinkage(S
->modulePath(), GUID
, S
->linkage());
332 /// Resolve linkage for prevailing symbols in the \p Index.
334 // We'd like to drop these functions if they are no longer referenced in the
335 // current module. However there is a chance that another module is still
336 // referencing them because of the import. We make sure we always emit at least
338 void llvm::thinLTOResolvePrevailingInIndex(
339 ModuleSummaryIndex
&Index
,
340 function_ref
<bool(GlobalValue::GUID
, const GlobalValueSummary
*)>
342 function_ref
<void(StringRef
, GlobalValue::GUID
, GlobalValue::LinkageTypes
)>
344 // We won't optimize the globals that are referenced by an alias for now
345 // Ideally we should turn the alias into a global and duplicate the definition
347 DenseSet
<GlobalValueSummary
*> GlobalInvolvedWithAlias
;
348 for (auto &I
: Index
)
349 for (auto &S
: I
.second
.SummaryList
)
350 if (auto AS
= dyn_cast
<AliasSummary
>(S
.get()))
351 GlobalInvolvedWithAlias
.insert(&AS
->getAliasee());
353 for (auto &I
: Index
)
354 thinLTOResolvePrevailingGUID(I
.second
.SummaryList
, I
.first
,
355 GlobalInvolvedWithAlias
, isPrevailing
,
359 static void thinLTOInternalizeAndPromoteGUID(
360 GlobalValueSummaryList
&GVSummaryList
, GlobalValue::GUID GUID
,
361 function_ref
<bool(StringRef
, GlobalValue::GUID
)> isExported
) {
362 for (auto &S
: GVSummaryList
) {
363 if (isExported(S
->modulePath(), GUID
)) {
364 if (GlobalValue::isLocalLinkage(S
->linkage()))
365 S
->setLinkage(GlobalValue::ExternalLinkage
);
366 } else if (EnableLTOInternalization
&&
367 // Ignore local and appending linkage values since the linker
368 // doesn't resolve them.
369 !GlobalValue::isLocalLinkage(S
->linkage()) &&
370 S
->linkage() != GlobalValue::AppendingLinkage
&&
371 // We can't internalize available_externally globals because this
372 // can break function pointer equality.
373 S
->linkage() != GlobalValue::AvailableExternallyLinkage
)
374 S
->setLinkage(GlobalValue::InternalLinkage
);
378 // Update the linkages in the given \p Index to mark exported values
379 // as external and non-exported values as internal.
380 void llvm::thinLTOInternalizeAndPromoteInIndex(
381 ModuleSummaryIndex
&Index
,
382 function_ref
<bool(StringRef
, GlobalValue::GUID
)> isExported
) {
383 for (auto &I
: Index
)
384 thinLTOInternalizeAndPromoteGUID(I
.second
.SummaryList
, I
.first
, isExported
);
387 // Requires a destructor for std::vector<InputModule>.
388 InputFile::~InputFile() = default;
390 Expected
<std::unique_ptr
<InputFile
>> InputFile::create(MemoryBufferRef Object
) {
391 std::unique_ptr
<InputFile
> File(new InputFile
);
393 Expected
<IRSymtabFile
> FOrErr
= readIRSymtab(Object
);
395 return FOrErr
.takeError();
397 File
->TargetTriple
= FOrErr
->TheReader
.getTargetTriple();
398 File
->SourceFileName
= FOrErr
->TheReader
.getSourceFileName();
399 File
->COFFLinkerOpts
= FOrErr
->TheReader
.getCOFFLinkerOpts();
400 File
->ComdatTable
= FOrErr
->TheReader
.getComdatTable();
402 for (unsigned I
= 0; I
!= FOrErr
->Mods
.size(); ++I
) {
403 size_t Begin
= File
->Symbols
.size();
404 for (const irsymtab::Reader::SymbolRef
&Sym
:
405 FOrErr
->TheReader
.module_symbols(I
))
406 // Skip symbols that are irrelevant to LTO. Note that this condition needs
407 // to match the one in Skip() in LTO::addRegularLTO().
408 if (Sym
.isGlobal() && !Sym
.isFormatSpecific())
409 File
->Symbols
.push_back(Sym
);
410 File
->ModuleSymIndices
.push_back({Begin
, File
->Symbols
.size()});
413 File
->Mods
= FOrErr
->Mods
;
414 File
->Strtab
= std::move(FOrErr
->Strtab
);
415 return std::move(File
);
418 StringRef
InputFile::getName() const {
419 return Mods
[0].getModuleIdentifier();
422 LTO::RegularLTOState::RegularLTOState(unsigned ParallelCodeGenParallelismLevel
,
424 : ParallelCodeGenParallelismLevel(ParallelCodeGenParallelismLevel
),
425 Ctx(Conf
), CombinedModule(llvm::make_unique
<Module
>("ld-temp.o", Ctx
)),
426 Mover(llvm::make_unique
<IRMover
>(*CombinedModule
)) {}
428 LTO::ThinLTOState::ThinLTOState(ThinBackend Backend
)
429 : Backend(Backend
), CombinedIndex(/*HaveGVs*/ false) {
432 createInProcessThinBackend(llvm::heavyweight_hardware_concurrency());
435 LTO::LTO(Config Conf
, ThinBackend Backend
,
436 unsigned ParallelCodeGenParallelismLevel
)
437 : Conf(std::move(Conf
)),
438 RegularLTO(ParallelCodeGenParallelismLevel
, this->Conf
),
439 ThinLTO(std::move(Backend
)) {}
441 // Requires a destructor for MapVector<BitcodeModule>.
442 LTO::~LTO() = default;
444 // Add the symbols in the given module to the GlobalResolutions map, and resolve
446 void LTO::addModuleToGlobalRes(ArrayRef
<InputFile::Symbol
> Syms
,
447 ArrayRef
<SymbolResolution
> Res
,
448 unsigned Partition
, bool InSummary
) {
449 auto *ResI
= Res
.begin();
450 auto *ResE
= Res
.end();
452 for (const InputFile::Symbol
&Sym
: Syms
) {
453 assert(ResI
!= ResE
);
454 SymbolResolution Res
= *ResI
++;
456 StringRef Name
= Sym
.getName();
457 Triple
TT(RegularLTO
.CombinedModule
->getTargetTriple());
458 // Strip the __imp_ prefix from COFF dllimport symbols (similar to the
459 // way they are handled by lld), otherwise we can end up with two
460 // global resolutions (one with and one for a copy of the symbol without).
461 if (TT
.isOSBinFormatCOFF() && Name
.startswith("__imp_"))
462 Name
= Name
.substr(strlen("__imp_"));
463 auto &GlobalRes
= GlobalResolutions
[Name
];
464 GlobalRes
.UnnamedAddr
&= Sym
.isUnnamedAddr();
465 if (Res
.Prevailing
) {
466 assert(!GlobalRes
.Prevailing
&&
467 "Multiple prevailing defs are not allowed");
468 GlobalRes
.Prevailing
= true;
469 GlobalRes
.IRName
= Sym
.getIRName();
470 } else if (!GlobalRes
.Prevailing
&& GlobalRes
.IRName
.empty()) {
471 // Sometimes it can be two copies of symbol in a module and prevailing
472 // symbol can have no IR name. That might happen if symbol is defined in
473 // module level inline asm block. In case we have multiple modules with
474 // the same symbol we want to use IR name of the prevailing symbol.
475 // Otherwise, if we haven't seen a prevailing symbol, set the name so that
476 // we can later use it to check if there is any prevailing copy in IR.
477 GlobalRes
.IRName
= Sym
.getIRName();
480 // Set the partition to external if we know it is re-defined by the linker
481 // with -defsym or -wrap options, used elsewhere, e.g. it is visible to a
482 // regular object, is referenced from llvm.compiler_used, or was already
483 // recorded as being referenced from a different partition.
484 if (Res
.LinkerRedefined
|| Res
.VisibleToRegularObj
|| Sym
.isUsed() ||
485 (GlobalRes
.Partition
!= GlobalResolution::Unknown
&&
486 GlobalRes
.Partition
!= Partition
)) {
487 GlobalRes
.Partition
= GlobalResolution::External
;
489 // First recorded reference, save the current partition.
490 GlobalRes
.Partition
= Partition
;
492 // Flag as visible outside of summary if visible from a regular object or
493 // from a module that does not have a summary.
494 GlobalRes
.VisibleOutsideSummary
|=
495 (Res
.VisibleToRegularObj
|| Sym
.isUsed() || !InSummary
);
499 static void writeToResolutionFile(raw_ostream
&OS
, InputFile
*Input
,
500 ArrayRef
<SymbolResolution
> Res
) {
501 StringRef Path
= Input
->getName();
503 auto ResI
= Res
.begin();
504 for (const InputFile::Symbol
&Sym
: Input
->symbols()) {
505 assert(ResI
!= Res
.end());
506 SymbolResolution Res
= *ResI
++;
508 OS
<< "-r=" << Path
<< ',' << Sym
.getName() << ',';
511 if (Res
.FinalDefinitionInLinkageUnit
)
513 if (Res
.VisibleToRegularObj
)
515 if (Res
.LinkerRedefined
)
520 assert(ResI
== Res
.end());
523 Error
LTO::add(std::unique_ptr
<InputFile
> Input
,
524 ArrayRef
<SymbolResolution
> Res
) {
525 assert(!CalledGetMaxTasks
);
527 if (Conf
.ResolutionFile
)
528 writeToResolutionFile(*Conf
.ResolutionFile
, Input
.get(), Res
);
530 if (RegularLTO
.CombinedModule
->getTargetTriple().empty())
531 RegularLTO
.CombinedModule
->setTargetTriple(Input
->getTargetTriple());
533 const SymbolResolution
*ResI
= Res
.begin();
534 for (unsigned I
= 0; I
!= Input
->Mods
.size(); ++I
)
535 if (Error Err
= addModule(*Input
, I
, ResI
, Res
.end()))
538 assert(ResI
== Res
.end());
539 return Error::success();
542 Error
LTO::addModule(InputFile
&Input
, unsigned ModI
,
543 const SymbolResolution
*&ResI
,
544 const SymbolResolution
*ResE
) {
545 Expected
<BitcodeLTOInfo
> LTOInfo
= Input
.Mods
[ModI
].getLTOInfo();
547 return LTOInfo
.takeError();
549 if (EnableSplitLTOUnit
.hasValue()) {
550 // If only some modules were split, flag this in the index so that
551 // we can skip or error on optimizations that need consistently split
552 // modules (whole program devirt and lower type tests).
553 if (EnableSplitLTOUnit
.getValue() != LTOInfo
->EnableSplitLTOUnit
)
554 ThinLTO
.CombinedIndex
.setPartiallySplitLTOUnits();
556 EnableSplitLTOUnit
= LTOInfo
->EnableSplitLTOUnit
;
558 BitcodeModule BM
= Input
.Mods
[ModI
];
559 auto ModSyms
= Input
.module_symbols(ModI
);
560 addModuleToGlobalRes(ModSyms
, {ResI
, ResE
},
561 LTOInfo
->IsThinLTO
? ThinLTO
.ModuleMap
.size() + 1 : 0,
562 LTOInfo
->HasSummary
);
564 if (LTOInfo
->IsThinLTO
)
565 return addThinLTO(BM
, ModSyms
, ResI
, ResE
);
567 Expected
<RegularLTOState::AddedModule
> ModOrErr
=
568 addRegularLTO(BM
, ModSyms
, ResI
, ResE
);
570 return ModOrErr
.takeError();
572 if (!LTOInfo
->HasSummary
)
573 return linkRegularLTO(std::move(*ModOrErr
), /*LivenessFromIndex=*/false);
575 // Regular LTO module summaries are added to a dummy module that represents
576 // the combined regular LTO module.
577 if (Error Err
= BM
.readSummary(ThinLTO
.CombinedIndex
, "", -1ull))
579 RegularLTO
.ModsWithSummaries
.push_back(std::move(*ModOrErr
));
580 return Error::success();
583 // Checks whether the given global value is in a non-prevailing comdat
584 // (comdat containing values the linker indicated were not prevailing,
585 // which we then dropped to available_externally), and if so, removes
586 // it from the comdat. This is called for all global values to ensure the
587 // comdat is empty rather than leaving an incomplete comdat. It is needed for
588 // regular LTO modules, in case we are in a mixed-LTO mode (both regular
589 // and thin LTO modules) compilation. Since the regular LTO module will be
590 // linked first in the final native link, we want to make sure the linker
591 // doesn't select any of these incomplete comdats that would be left
592 // in the regular LTO module without this cleanup.
594 handleNonPrevailingComdat(GlobalValue
&GV
,
595 std::set
<const Comdat
*> &NonPrevailingComdats
) {
596 Comdat
*C
= GV
.getComdat();
600 if (!NonPrevailingComdats
.count(C
))
603 // Additionally need to drop externally visible global values from the comdat
604 // to available_externally, so that there aren't multiply defined linker
606 if (!GV
.hasLocalLinkage())
607 GV
.setLinkage(GlobalValue::AvailableExternallyLinkage
);
609 if (auto GO
= dyn_cast
<GlobalObject
>(&GV
))
610 GO
->setComdat(nullptr);
613 // Add a regular LTO object to the link.
614 // The resulting module needs to be linked into the combined LTO module with
616 Expected
<LTO::RegularLTOState::AddedModule
>
617 LTO::addRegularLTO(BitcodeModule BM
, ArrayRef
<InputFile::Symbol
> Syms
,
618 const SymbolResolution
*&ResI
,
619 const SymbolResolution
*ResE
) {
620 RegularLTOState::AddedModule Mod
;
621 Expected
<std::unique_ptr
<Module
>> MOrErr
=
622 BM
.getLazyModule(RegularLTO
.Ctx
, /*ShouldLazyLoadMetadata*/ true,
623 /*IsImporting*/ false);
625 return MOrErr
.takeError();
626 Module
&M
= **MOrErr
;
627 Mod
.M
= std::move(*MOrErr
);
629 if (Error Err
= M
.materializeMetadata())
630 return std::move(Err
);
633 ModuleSymbolTable SymTab
;
634 SymTab
.addModule(&M
);
636 for (GlobalVariable
&GV
: M
.globals())
637 if (GV
.hasAppendingLinkage())
638 Mod
.Keep
.push_back(&GV
);
640 DenseSet
<GlobalObject
*> AliasedGlobals
;
641 for (auto &GA
: M
.aliases())
642 if (GlobalObject
*GO
= GA
.getBaseObject())
643 AliasedGlobals
.insert(GO
);
645 // In this function we need IR GlobalValues matching the symbols in Syms
646 // (which is not backed by a module), so we need to enumerate them in the same
647 // order. The symbol enumeration order of a ModuleSymbolTable intentionally
648 // matches the order of an irsymtab, but when we read the irsymtab in
649 // InputFile::create we omit some symbols that are irrelevant to LTO. The
650 // Skip() function skips the same symbols from the module as InputFile does
651 // from the symbol table.
652 auto MsymI
= SymTab
.symbols().begin(), MsymE
= SymTab
.symbols().end();
654 while (MsymI
!= MsymE
) {
655 auto Flags
= SymTab
.getSymbolFlags(*MsymI
);
656 if ((Flags
& object::BasicSymbolRef::SF_Global
) &&
657 !(Flags
& object::BasicSymbolRef::SF_FormatSpecific
))
664 std::set
<const Comdat
*> NonPrevailingComdats
;
665 for (const InputFile::Symbol
&Sym
: Syms
) {
666 assert(ResI
!= ResE
);
667 SymbolResolution Res
= *ResI
++;
669 assert(MsymI
!= MsymE
);
670 ModuleSymbolTable::Symbol Msym
= *MsymI
++;
673 if (GlobalValue
*GV
= Msym
.dyn_cast
<GlobalValue
*>()) {
674 if (Res
.Prevailing
) {
675 if (Sym
.isUndefined())
677 Mod
.Keep
.push_back(GV
);
678 // For symbols re-defined with linker -wrap and -defsym options,
679 // set the linkage to weak to inhibit IPO. The linkage will be
680 // restored by the linker.
681 if (Res
.LinkerRedefined
)
682 GV
->setLinkage(GlobalValue::WeakAnyLinkage
);
684 GlobalValue::LinkageTypes OriginalLinkage
= GV
->getLinkage();
685 if (GlobalValue::isLinkOnceLinkage(OriginalLinkage
))
686 GV
->setLinkage(GlobalValue::getWeakLinkage(
687 GlobalValue::isLinkOnceODRLinkage(OriginalLinkage
)));
688 } else if (isa
<GlobalObject
>(GV
) &&
689 (GV
->hasLinkOnceODRLinkage() || GV
->hasWeakODRLinkage() ||
690 GV
->hasAvailableExternallyLinkage()) &&
691 !AliasedGlobals
.count(cast
<GlobalObject
>(GV
))) {
692 // Any of the above three types of linkage indicates that the
693 // chosen prevailing symbol will have the same semantics as this copy of
694 // the symbol, so we may be able to link it with available_externally
695 // linkage. We will decide later whether to do that when we link this
696 // module (in linkRegularLTO), based on whether it is undefined.
697 Mod
.Keep
.push_back(GV
);
698 GV
->setLinkage(GlobalValue::AvailableExternallyLinkage
);
700 NonPrevailingComdats
.insert(GV
->getComdat());
701 cast
<GlobalObject
>(GV
)->setComdat(nullptr);
704 // Set the 'local' flag based on the linker resolution for this symbol.
705 if (Res
.FinalDefinitionInLinkageUnit
) {
706 GV
->setDSOLocal(true);
707 if (GV
->hasDLLImportStorageClass())
708 GV
->setDLLStorageClass(GlobalValue::DLLStorageClassTypes::
709 DefaultStorageClass
);
712 // Common resolution: collect the maximum size/alignment over all commons.
713 // We also record if we see an instance of a common as prevailing, so that
714 // if none is prevailing we can ignore it later.
715 if (Sym
.isCommon()) {
716 // FIXME: We should figure out what to do about commons defined by asm.
717 // For now they aren't reported correctly by ModuleSymbolTable.
718 auto &CommonRes
= RegularLTO
.Commons
[Sym
.getIRName()];
719 CommonRes
.Size
= std::max(CommonRes
.Size
, Sym
.getCommonSize());
720 CommonRes
.Align
= std::max(CommonRes
.Align
, Sym
.getCommonAlignment());
721 CommonRes
.Prevailing
|= Res
.Prevailing
;
725 if (!M
.getComdatSymbolTable().empty())
726 for (GlobalValue
&GV
: M
.global_values())
727 handleNonPrevailingComdat(GV
, NonPrevailingComdats
);
728 assert(MsymI
== MsymE
);
729 return std::move(Mod
);
732 Error
LTO::linkRegularLTO(RegularLTOState::AddedModule Mod
,
733 bool LivenessFromIndex
) {
734 std::vector
<GlobalValue
*> Keep
;
735 for (GlobalValue
*GV
: Mod
.Keep
) {
736 if (LivenessFromIndex
&& !ThinLTO
.CombinedIndex
.isGUIDLive(GV
->getGUID()))
739 if (!GV
->hasAvailableExternallyLinkage()) {
744 // Only link available_externally definitions if we don't already have a
746 GlobalValue
*CombinedGV
=
747 RegularLTO
.CombinedModule
->getNamedValue(GV
->getName());
748 if (CombinedGV
&& !CombinedGV
->isDeclaration())
754 return RegularLTO
.Mover
->move(std::move(Mod
.M
), Keep
,
755 [](GlobalValue
&, IRMover::ValueAdder
) {},
756 /* IsPerformingImport */ false);
759 // Add a ThinLTO module to the link.
760 Error
LTO::addThinLTO(BitcodeModule BM
, ArrayRef
<InputFile::Symbol
> Syms
,
761 const SymbolResolution
*&ResI
,
762 const SymbolResolution
*ResE
) {
764 BM
.readSummary(ThinLTO
.CombinedIndex
, BM
.getModuleIdentifier(),
765 ThinLTO
.ModuleMap
.size()))
768 for (const InputFile::Symbol
&Sym
: Syms
) {
769 assert(ResI
!= ResE
);
770 SymbolResolution Res
= *ResI
++;
772 if (!Sym
.getIRName().empty()) {
773 auto GUID
= GlobalValue::getGUID(GlobalValue::getGlobalIdentifier(
774 Sym
.getIRName(), GlobalValue::ExternalLinkage
, ""));
775 if (Res
.Prevailing
) {
776 ThinLTO
.PrevailingModuleForGUID
[GUID
] = BM
.getModuleIdentifier();
778 // For linker redefined symbols (via --wrap or --defsym) we want to
779 // switch the linkage to `weak` to prevent IPOs from happening.
780 // Find the summary in the module for this very GV and record the new
781 // linkage so that we can switch it when we import the GV.
782 if (Res
.LinkerRedefined
)
783 if (auto S
= ThinLTO
.CombinedIndex
.findSummaryInModule(
784 GUID
, BM
.getModuleIdentifier()))
785 S
->setLinkage(GlobalValue::WeakAnyLinkage
);
788 // If the linker resolved the symbol to a local definition then mark it
789 // as local in the summary for the module we are adding.
790 if (Res
.FinalDefinitionInLinkageUnit
) {
791 if (auto S
= ThinLTO
.CombinedIndex
.findSummaryInModule(
792 GUID
, BM
.getModuleIdentifier())) {
793 S
->setDSOLocal(true);
799 if (!ThinLTO
.ModuleMap
.insert({BM
.getModuleIdentifier(), BM
}).second
)
800 return make_error
<StringError
>(
801 "Expected at most one ThinLTO module per bitcode file",
802 inconvertibleErrorCode());
804 return Error::success();
807 unsigned LTO::getMaxTasks() const {
808 CalledGetMaxTasks
= true;
809 return RegularLTO
.ParallelCodeGenParallelismLevel
+ ThinLTO
.ModuleMap
.size();
812 // If only some of the modules were split, we cannot correctly handle
813 // code that contains type tests or type checked loads.
814 Error
LTO::checkPartiallySplit() {
815 if (!ThinLTO
.CombinedIndex
.partiallySplitLTOUnits())
816 return Error::success();
818 Function
*TypeTestFunc
= RegularLTO
.CombinedModule
->getFunction(
819 Intrinsic::getName(Intrinsic::type_test
));
820 Function
*TypeCheckedLoadFunc
= RegularLTO
.CombinedModule
->getFunction(
821 Intrinsic::getName(Intrinsic::type_checked_load
));
823 // First check if there are type tests / type checked loads in the
824 // merged regular LTO module IR.
825 if ((TypeTestFunc
&& !TypeTestFunc
->use_empty()) ||
826 (TypeCheckedLoadFunc
&& !TypeCheckedLoadFunc
->use_empty()))
827 return make_error
<StringError
>(
828 "inconsistent LTO Unit splitting (recompile with -fsplit-lto-unit)",
829 inconvertibleErrorCode());
831 // Otherwise check if there are any recorded in the combined summary from the
833 for (auto &P
: ThinLTO
.CombinedIndex
) {
834 for (auto &S
: P
.second
.SummaryList
) {
835 auto *FS
= dyn_cast
<FunctionSummary
>(S
.get());
838 if (!FS
->type_test_assume_vcalls().empty() ||
839 !FS
->type_checked_load_vcalls().empty() ||
840 !FS
->type_test_assume_const_vcalls().empty() ||
841 !FS
->type_checked_load_const_vcalls().empty() ||
842 !FS
->type_tests().empty())
843 return make_error
<StringError
>(
844 "inconsistent LTO Unit splitting (recompile with -fsplit-lto-unit)",
845 inconvertibleErrorCode());
848 return Error::success();
851 Error
LTO::run(AddStreamFn AddStream
, NativeObjectCache Cache
) {
852 // Compute "dead" symbols, we don't want to import/export these!
853 DenseSet
<GlobalValue::GUID
> GUIDPreservedSymbols
;
854 DenseMap
<GlobalValue::GUID
, PrevailingType
> GUIDPrevailingResolutions
;
855 for (auto &Res
: GlobalResolutions
) {
856 // Normally resolution have IR name of symbol. We can do nothing here
857 // otherwise. See comments in GlobalResolution struct for more details.
858 if (Res
.second
.IRName
.empty())
861 GlobalValue::GUID GUID
= GlobalValue::getGUID(
862 GlobalValue::dropLLVMManglingEscape(Res
.second
.IRName
));
864 if (Res
.second
.VisibleOutsideSummary
&& Res
.second
.Prevailing
)
865 GUIDPreservedSymbols
.insert(GlobalValue::getGUID(
866 GlobalValue::dropLLVMManglingEscape(Res
.second
.IRName
)));
868 GUIDPrevailingResolutions
[GUID
] =
869 Res
.second
.Prevailing
? PrevailingType::Yes
: PrevailingType::No
;
872 auto isPrevailing
= [&](GlobalValue::GUID G
) {
873 auto It
= GUIDPrevailingResolutions
.find(G
);
874 if (It
== GUIDPrevailingResolutions
.end())
875 return PrevailingType::Unknown
;
878 computeDeadSymbolsWithConstProp(ThinLTO
.CombinedIndex
, GUIDPreservedSymbols
,
879 isPrevailing
, Conf
.OptLevel
> 0);
881 // Setup output file to emit statistics.
882 std::unique_ptr
<ToolOutputFile
> StatsFile
= nullptr;
883 if (!Conf
.StatsFile
.empty()) {
884 EnableStatistics(false);
887 llvm::make_unique
<ToolOutputFile
>(Conf
.StatsFile
, EC
, sys::fs::F_None
);
889 return errorCodeToError(EC
);
893 // Finalize linking of regular LTO modules containing summaries now that
894 // we have computed liveness information.
895 for (auto &M
: RegularLTO
.ModsWithSummaries
)
896 if (Error Err
= linkRegularLTO(std::move(M
),
897 /*LivenessFromIndex=*/true))
900 // Ensure we don't have inconsistently split LTO units with type tests.
901 if (Error Err
= checkPartiallySplit())
904 Error Result
= runRegularLTO(AddStream
);
906 Result
= runThinLTO(AddStream
, Cache
);
909 PrintStatisticsJSON(StatsFile
->os());
914 Error
LTO::runRegularLTO(AddStreamFn AddStream
) {
915 // Make sure commons have the right size/alignment: we kept the largest from
916 // all the prevailing when adding the inputs, and we apply it here.
917 const DataLayout
&DL
= RegularLTO
.CombinedModule
->getDataLayout();
918 for (auto &I
: RegularLTO
.Commons
) {
919 if (!I
.second
.Prevailing
)
920 // Don't do anything if no instance of this common was prevailing.
922 GlobalVariable
*OldGV
= RegularLTO
.CombinedModule
->getNamedGlobal(I
.first
);
923 if (OldGV
&& DL
.getTypeAllocSize(OldGV
->getValueType()) == I
.second
.Size
) {
924 // Don't create a new global if the type is already correct, just make
925 // sure the alignment is correct.
926 OldGV
->setAlignment(I
.second
.Align
);
930 ArrayType::get(Type::getInt8Ty(RegularLTO
.Ctx
), I
.second
.Size
);
931 auto *GV
= new GlobalVariable(*RegularLTO
.CombinedModule
, Ty
, false,
932 GlobalValue::CommonLinkage
,
933 ConstantAggregateZero::get(Ty
), "");
934 GV
->setAlignment(I
.second
.Align
);
936 OldGV
->replaceAllUsesWith(ConstantExpr::getBitCast(GV
, OldGV
->getType()));
938 OldGV
->eraseFromParent();
940 GV
->setName(I
.first
);
944 if (Conf
.PreOptModuleHook
&&
945 !Conf
.PreOptModuleHook(0, *RegularLTO
.CombinedModule
))
946 return Error::success();
948 if (!Conf
.CodeGenOnly
) {
949 for (const auto &R
: GlobalResolutions
) {
950 if (!R
.second
.isPrevailingIRSymbol())
952 if (R
.second
.Partition
!= 0 &&
953 R
.second
.Partition
!= GlobalResolution::External
)
957 RegularLTO
.CombinedModule
->getNamedValue(R
.second
.IRName
);
958 // Ignore symbols defined in other partitions.
959 // Also skip declarations, which are not allowed to have internal linkage.
960 if (!GV
|| GV
->hasLocalLinkage() || GV
->isDeclaration())
962 GV
->setUnnamedAddr(R
.second
.UnnamedAddr
? GlobalValue::UnnamedAddr::Global
963 : GlobalValue::UnnamedAddr::None
);
964 if (EnableLTOInternalization
&& R
.second
.Partition
== 0)
965 GV
->setLinkage(GlobalValue::InternalLinkage
);
968 if (Conf
.PostInternalizeModuleHook
&&
969 !Conf
.PostInternalizeModuleHook(0, *RegularLTO
.CombinedModule
))
970 return Error::success();
972 return backend(Conf
, AddStream
, RegularLTO
.ParallelCodeGenParallelismLevel
,
973 std::move(RegularLTO
.CombinedModule
), ThinLTO
.CombinedIndex
);
976 /// This class defines the interface to the ThinLTO backend.
977 class lto::ThinBackendProc
{
980 ModuleSummaryIndex
&CombinedIndex
;
981 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
;
984 ThinBackendProc(Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
985 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
)
986 : Conf(Conf
), CombinedIndex(CombinedIndex
),
987 ModuleToDefinedGVSummaries(ModuleToDefinedGVSummaries
) {}
989 virtual ~ThinBackendProc() {}
991 unsigned Task
, BitcodeModule BM
,
992 const FunctionImporter::ImportMapTy
&ImportList
,
993 const FunctionImporter::ExportSetTy
&ExportList
,
994 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
995 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) = 0;
996 virtual Error
wait() = 0;
1000 class InProcessThinBackend
: public ThinBackendProc
{
1001 ThreadPool BackendThreadPool
;
1002 AddStreamFn AddStream
;
1003 NativeObjectCache Cache
;
1004 std::set
<GlobalValue::GUID
> CfiFunctionDefs
;
1005 std::set
<GlobalValue::GUID
> CfiFunctionDecls
;
1007 Optional
<Error
> Err
;
1011 InProcessThinBackend(
1012 Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1013 unsigned ThinLTOParallelismLevel
,
1014 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
,
1015 AddStreamFn AddStream
, NativeObjectCache Cache
)
1016 : ThinBackendProc(Conf
, CombinedIndex
, ModuleToDefinedGVSummaries
),
1017 BackendThreadPool(ThinLTOParallelismLevel
),
1018 AddStream(std::move(AddStream
)), Cache(std::move(Cache
)) {
1019 for (auto &Name
: CombinedIndex
.cfiFunctionDefs())
1020 CfiFunctionDefs
.insert(
1021 GlobalValue::getGUID(GlobalValue::dropLLVMManglingEscape(Name
)));
1022 for (auto &Name
: CombinedIndex
.cfiFunctionDecls())
1023 CfiFunctionDecls
.insert(
1024 GlobalValue::getGUID(GlobalValue::dropLLVMManglingEscape(Name
)));
1027 Error
runThinLTOBackendThread(
1028 AddStreamFn AddStream
, NativeObjectCache Cache
, unsigned Task
,
1029 BitcodeModule BM
, ModuleSummaryIndex
&CombinedIndex
,
1030 const FunctionImporter::ImportMapTy
&ImportList
,
1031 const FunctionImporter::ExportSetTy
&ExportList
,
1032 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
1033 const GVSummaryMapTy
&DefinedGlobals
,
1034 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) {
1035 auto RunThinBackend
= [&](AddStreamFn AddStream
) {
1036 LTOLLVMContext
BackendContext(Conf
);
1037 Expected
<std::unique_ptr
<Module
>> MOrErr
= BM
.parseModule(BackendContext
);
1039 return MOrErr
.takeError();
1041 return thinBackend(Conf
, Task
, AddStream
, **MOrErr
, CombinedIndex
,
1042 ImportList
, DefinedGlobals
, ModuleMap
);
1045 auto ModuleID
= BM
.getModuleIdentifier();
1047 if (!Cache
|| !CombinedIndex
.modulePaths().count(ModuleID
) ||
1048 all_of(CombinedIndex
.getModuleHash(ModuleID
),
1049 [](uint32_t V
) { return V
== 0; }))
1050 // Cache disabled or no entry for this module in the combined index or
1052 return RunThinBackend(AddStream
);
1054 SmallString
<40> Key
;
1055 // The module may be cached, this helps handling it.
1056 computeLTOCacheKey(Key
, Conf
, CombinedIndex
, ModuleID
, ImportList
,
1057 ExportList
, ResolvedODR
, DefinedGlobals
, CfiFunctionDefs
,
1059 if (AddStreamFn CacheAddStream
= Cache(Task
, Key
))
1060 return RunThinBackend(CacheAddStream
);
1062 return Error::success();
1066 unsigned Task
, BitcodeModule BM
,
1067 const FunctionImporter::ImportMapTy
&ImportList
,
1068 const FunctionImporter::ExportSetTy
&ExportList
,
1069 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
1070 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) override
{
1071 StringRef ModulePath
= BM
.getModuleIdentifier();
1072 assert(ModuleToDefinedGVSummaries
.count(ModulePath
));
1073 const GVSummaryMapTy
&DefinedGlobals
=
1074 ModuleToDefinedGVSummaries
.find(ModulePath
)->second
;
1075 BackendThreadPool
.async(
1076 [=](BitcodeModule BM
, ModuleSummaryIndex
&CombinedIndex
,
1077 const FunctionImporter::ImportMapTy
&ImportList
,
1078 const FunctionImporter::ExportSetTy
&ExportList
,
1079 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
>
1081 const GVSummaryMapTy
&DefinedGlobals
,
1082 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) {
1083 Error E
= runThinLTOBackendThread(
1084 AddStream
, Cache
, Task
, BM
, CombinedIndex
, ImportList
, ExportList
,
1085 ResolvedODR
, DefinedGlobals
, ModuleMap
);
1087 std::unique_lock
<std::mutex
> L(ErrMu
);
1089 Err
= joinErrors(std::move(*Err
), std::move(E
));
1094 BM
, std::ref(CombinedIndex
), std::ref(ImportList
), std::ref(ExportList
),
1095 std::ref(ResolvedODR
), std::ref(DefinedGlobals
), std::ref(ModuleMap
));
1096 return Error::success();
1099 Error
wait() override
{
1100 BackendThreadPool
.wait();
1102 return std::move(*Err
);
1104 return Error::success();
1107 } // end anonymous namespace
1109 ThinBackend
lto::createInProcessThinBackend(unsigned ParallelismLevel
) {
1110 return [=](Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1111 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
,
1112 AddStreamFn AddStream
, NativeObjectCache Cache
) {
1113 return llvm::make_unique
<InProcessThinBackend
>(
1114 Conf
, CombinedIndex
, ParallelismLevel
, ModuleToDefinedGVSummaries
,
1119 // Given the original \p Path to an output file, replace any path
1120 // prefix matching \p OldPrefix with \p NewPrefix. Also, create the
1121 // resulting directory if it does not yet exist.
1122 std::string
lto::getThinLTOOutputFile(const std::string
&Path
,
1123 const std::string
&OldPrefix
,
1124 const std::string
&NewPrefix
) {
1125 if (OldPrefix
.empty() && NewPrefix
.empty())
1127 SmallString
<128> NewPath(Path
);
1128 llvm::sys::path::replace_path_prefix(NewPath
, OldPrefix
, NewPrefix
);
1129 StringRef ParentPath
= llvm::sys::path::parent_path(NewPath
.str());
1130 if (!ParentPath
.empty()) {
1131 // Make sure the new directory exists, creating it if necessary.
1132 if (std::error_code EC
= llvm::sys::fs::create_directories(ParentPath
))
1133 llvm::errs() << "warning: could not create directory '" << ParentPath
1134 << "': " << EC
.message() << '\n';
1136 return NewPath
.str();
1140 class WriteIndexesThinBackend
: public ThinBackendProc
{
1141 std::string OldPrefix
, NewPrefix
;
1142 bool ShouldEmitImportsFiles
;
1143 raw_fd_ostream
*LinkedObjectsFile
;
1144 lto::IndexWriteCallback OnWrite
;
1147 WriteIndexesThinBackend(
1148 Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1149 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
,
1150 std::string OldPrefix
, std::string NewPrefix
, bool ShouldEmitImportsFiles
,
1151 raw_fd_ostream
*LinkedObjectsFile
, lto::IndexWriteCallback OnWrite
)
1152 : ThinBackendProc(Conf
, CombinedIndex
, ModuleToDefinedGVSummaries
),
1153 OldPrefix(OldPrefix
), NewPrefix(NewPrefix
),
1154 ShouldEmitImportsFiles(ShouldEmitImportsFiles
),
1155 LinkedObjectsFile(LinkedObjectsFile
), OnWrite(OnWrite
) {}
1158 unsigned Task
, BitcodeModule BM
,
1159 const FunctionImporter::ImportMapTy
&ImportList
,
1160 const FunctionImporter::ExportSetTy
&ExportList
,
1161 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
1162 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) override
{
1163 StringRef ModulePath
= BM
.getModuleIdentifier();
1164 std::string NewModulePath
=
1165 getThinLTOOutputFile(ModulePath
, OldPrefix
, NewPrefix
);
1167 if (LinkedObjectsFile
)
1168 *LinkedObjectsFile
<< NewModulePath
<< '\n';
1170 std::map
<std::string
, GVSummaryMapTy
> ModuleToSummariesForIndex
;
1171 gatherImportedSummariesForModule(ModulePath
, ModuleToDefinedGVSummaries
,
1172 ImportList
, ModuleToSummariesForIndex
);
1175 raw_fd_ostream
OS(NewModulePath
+ ".thinlto.bc", EC
,
1176 sys::fs::OpenFlags::F_None
);
1178 return errorCodeToError(EC
);
1179 WriteIndexToFile(CombinedIndex
, OS
, &ModuleToSummariesForIndex
);
1181 if (ShouldEmitImportsFiles
) {
1182 EC
= EmitImportsFiles(ModulePath
, NewModulePath
+ ".imports",
1183 ModuleToSummariesForIndex
);
1185 return errorCodeToError(EC
);
1189 OnWrite(ModulePath
);
1190 return Error::success();
1193 Error
wait() override
{ return Error::success(); }
1195 } // end anonymous namespace
1197 ThinBackend
lto::createWriteIndexesThinBackend(
1198 std::string OldPrefix
, std::string NewPrefix
, bool ShouldEmitImportsFiles
,
1199 raw_fd_ostream
*LinkedObjectsFile
, IndexWriteCallback OnWrite
) {
1200 return [=](Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1201 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
,
1202 AddStreamFn AddStream
, NativeObjectCache Cache
) {
1203 return llvm::make_unique
<WriteIndexesThinBackend
>(
1204 Conf
, CombinedIndex
, ModuleToDefinedGVSummaries
, OldPrefix
, NewPrefix
,
1205 ShouldEmitImportsFiles
, LinkedObjectsFile
, OnWrite
);
1209 Error
LTO::runThinLTO(AddStreamFn AddStream
, NativeObjectCache Cache
) {
1210 if (ThinLTO
.ModuleMap
.empty())
1211 return Error::success();
1213 if (Conf
.CombinedIndexHook
&& !Conf
.CombinedIndexHook(ThinLTO
.CombinedIndex
))
1214 return Error::success();
1216 // Collect for each module the list of function it defines (GUID ->
1218 StringMap
<GVSummaryMapTy
>
1219 ModuleToDefinedGVSummaries(ThinLTO
.ModuleMap
.size());
1220 ThinLTO
.CombinedIndex
.collectDefinedGVSummariesPerModule(
1221 ModuleToDefinedGVSummaries
);
1222 // Create entries for any modules that didn't have any GV summaries
1223 // (either they didn't have any GVs to start with, or we suppressed
1224 // generation of the summaries because they e.g. had inline assembly
1225 // uses that couldn't be promoted/renamed on export). This is so
1226 // InProcessThinBackend::start can still launch a backend thread, which
1227 // is passed the map of summaries for the module, without any special
1228 // handling for this case.
1229 for (auto &Mod
: ThinLTO
.ModuleMap
)
1230 if (!ModuleToDefinedGVSummaries
.count(Mod
.first
))
1231 ModuleToDefinedGVSummaries
.try_emplace(Mod
.first
);
1233 // Synthesize entry counts for functions in the CombinedIndex.
1234 computeSyntheticCounts(ThinLTO
.CombinedIndex
);
1236 StringMap
<FunctionImporter::ImportMapTy
> ImportLists(
1237 ThinLTO
.ModuleMap
.size());
1238 StringMap
<FunctionImporter::ExportSetTy
> ExportLists(
1239 ThinLTO
.ModuleMap
.size());
1240 StringMap
<std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
>> ResolvedODR
;
1243 ThinLTO
.CombinedIndex
.dumpSCCs(outs());
1245 if (Conf
.OptLevel
> 0)
1246 ComputeCrossModuleImport(ThinLTO
.CombinedIndex
, ModuleToDefinedGVSummaries
,
1247 ImportLists
, ExportLists
);
1249 // Figure out which symbols need to be internalized. This also needs to happen
1250 // at -O0 because summary-based DCE is implemented using internalization, and
1251 // we must apply DCE consistently with the full LTO module in order to avoid
1252 // undefined references during the final link.
1253 std::set
<GlobalValue::GUID
> ExportedGUIDs
;
1254 for (auto &Res
: GlobalResolutions
) {
1255 // If the symbol does not have external references or it is not prevailing,
1256 // then not need to mark it as exported from a ThinLTO partition.
1257 if (Res
.second
.Partition
!= GlobalResolution::External
||
1258 !Res
.second
.isPrevailingIRSymbol())
1260 auto GUID
= GlobalValue::getGUID(
1261 GlobalValue::dropLLVMManglingEscape(Res
.second
.IRName
));
1262 // Mark exported unless index-based analysis determined it to be dead.
1263 if (ThinLTO
.CombinedIndex
.isGUIDLive(GUID
))
1264 ExportedGUIDs
.insert(GUID
);
1267 // Any functions referenced by the jump table in the regular LTO object must
1269 for (auto &Def
: ThinLTO
.CombinedIndex
.cfiFunctionDefs())
1270 ExportedGUIDs
.insert(
1271 GlobalValue::getGUID(GlobalValue::dropLLVMManglingEscape(Def
)));
1273 auto isExported
= [&](StringRef ModuleIdentifier
, GlobalValue::GUID GUID
) {
1274 const auto &ExportList
= ExportLists
.find(ModuleIdentifier
);
1275 return (ExportList
!= ExportLists
.end() &&
1276 ExportList
->second
.count(GUID
)) ||
1277 ExportedGUIDs
.count(GUID
);
1279 thinLTOInternalizeAndPromoteInIndex(ThinLTO
.CombinedIndex
, isExported
);
1281 auto isPrevailing
= [&](GlobalValue::GUID GUID
,
1282 const GlobalValueSummary
*S
) {
1283 return ThinLTO
.PrevailingModuleForGUID
[GUID
] == S
->modulePath();
1285 auto recordNewLinkage
= [&](StringRef ModuleIdentifier
,
1286 GlobalValue::GUID GUID
,
1287 GlobalValue::LinkageTypes NewLinkage
) {
1288 ResolvedODR
[ModuleIdentifier
][GUID
] = NewLinkage
;
1290 thinLTOResolvePrevailingInIndex(ThinLTO
.CombinedIndex
, isPrevailing
,
1293 std::unique_ptr
<ThinBackendProc
> BackendProc
=
1294 ThinLTO
.Backend(Conf
, ThinLTO
.CombinedIndex
, ModuleToDefinedGVSummaries
,
1297 // Tasks 0 through ParallelCodeGenParallelismLevel-1 are reserved for combined
1298 // module and parallel code generation partitions.
1299 unsigned Task
= RegularLTO
.ParallelCodeGenParallelismLevel
;
1300 for (auto &Mod
: ThinLTO
.ModuleMap
) {
1301 if (Error E
= BackendProc
->start(Task
, Mod
.second
, ImportLists
[Mod
.first
],
1302 ExportLists
[Mod
.first
],
1303 ResolvedODR
[Mod
.first
], ThinLTO
.ModuleMap
))
1308 return BackendProc
->wait();
1311 Expected
<std::unique_ptr
<ToolOutputFile
>>
1312 lto::setupOptimizationRemarks(LLVMContext
&Context
,
1313 StringRef LTORemarksFilename
,
1314 bool LTOPassRemarksWithHotness
, int Count
) {
1315 if (LTOPassRemarksWithHotness
)
1316 Context
.setDiagnosticsHotnessRequested(true);
1317 if (LTORemarksFilename
.empty())
1320 std::string Filename
= LTORemarksFilename
;
1322 Filename
+= ".thin." + llvm::utostr(Count
) + ".yaml";
1325 auto DiagnosticFile
=
1326 llvm::make_unique
<ToolOutputFile
>(Filename
, EC
, sys::fs::F_None
);
1328 return errorCodeToError(EC
);
1329 Context
.setDiagnosticsOutputFile(
1330 llvm::make_unique
<yaml::Output
>(DiagnosticFile
->os()));
1331 DiagnosticFile
->keep();
1332 return std::move(DiagnosticFile
);