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/IR/RemarkStreamer.h"
28 #include "llvm/LTO/LTOBackend.h"
29 #include "llvm/LTO/SummaryBasedOptimizations.h"
30 #include "llvm/Linker/IRMover.h"
31 #include "llvm/Object/IRObjectFile.h"
32 #include "llvm/Support/Error.h"
33 #include "llvm/Support/ManagedStatic.h"
34 #include "llvm/Support/MemoryBuffer.h"
35 #include "llvm/Support/Path.h"
36 #include "llvm/Support/SHA1.h"
37 #include "llvm/Support/SourceMgr.h"
38 #include "llvm/Support/TargetRegistry.h"
39 #include "llvm/Support/ThreadPool.h"
40 #include "llvm/Support/Threading.h"
41 #include "llvm/Support/VCSRevision.h"
42 #include "llvm/Support/raw_ostream.h"
43 #include "llvm/Target/TargetMachine.h"
44 #include "llvm/Target/TargetOptions.h"
45 #include "llvm/Transforms/IPO.h"
46 #include "llvm/Transforms/IPO/PassManagerBuilder.h"
47 #include "llvm/Transforms/IPO/WholeProgramDevirt.h"
48 #include "llvm/Transforms/Utils/FunctionImportUtils.h"
49 #include "llvm/Transforms/Utils/SplitModule.h"
55 using namespace object
;
57 #define DEBUG_TYPE "lto"
60 DumpThinCGSCCs("dump-thin-cg-sccs", cl::init(false), cl::Hidden
,
61 cl::desc("Dump the SCCs in the ThinLTO index's callgraph"));
63 /// Enable global value internalization in LTO.
64 cl::opt
<bool> EnableLTOInternalization(
65 "enable-lto-internalization", cl::init(true), cl::Hidden
,
66 cl::desc("Enable global value internalization in LTO"));
68 // Computes a unique hash for the Module considering the current list of
69 // export/import and other global analysis results.
70 // The hash is produced in \p Key.
71 void llvm::computeLTOCacheKey(
72 SmallString
<40> &Key
, const Config
&Conf
, const ModuleSummaryIndex
&Index
,
73 StringRef ModuleID
, const FunctionImporter::ImportMapTy
&ImportList
,
74 const FunctionImporter::ExportSetTy
&ExportList
,
75 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
76 const GVSummaryMapTy
&DefinedGlobals
,
77 const std::set
<GlobalValue::GUID
> &CfiFunctionDefs
,
78 const std::set
<GlobalValue::GUID
> &CfiFunctionDecls
) {
79 // Compute the unique hash for this entry.
80 // This is based on the current compiler version, the module itself, the
81 // export list, the hash for every single module in the import list, the
82 // list of ResolvedODR for the module, and the list of preserved symbols.
85 // Start with the compiler revision
86 Hasher
.update(LLVM_VERSION_STRING
);
88 Hasher
.update(LLVM_REVISION
);
91 // Include the parts of the LTO configuration that affect code generation.
92 auto AddString
= [&](StringRef Str
) {
94 Hasher
.update(ArrayRef
<uint8_t>{0});
96 auto AddUnsigned
= [&](unsigned I
) {
102 Hasher
.update(ArrayRef
<uint8_t>{Data
, 4});
104 auto AddUint64
= [&](uint64_t I
) {
114 Hasher
.update(ArrayRef
<uint8_t>{Data
, 8});
117 // FIXME: Hash more of Options. For now all clients initialize Options from
118 // command-line flags (which is unsupported in production), but may set
119 // RelaxELFRelocations. The clang driver can also pass FunctionSections,
120 // DataSections and DebuggerTuning via command line flags.
121 AddUnsigned(Conf
.Options
.RelaxELFRelocations
);
122 AddUnsigned(Conf
.Options
.FunctionSections
);
123 AddUnsigned(Conf
.Options
.DataSections
);
124 AddUnsigned((unsigned)Conf
.Options
.DebuggerTuning
);
125 for (auto &A
: Conf
.MAttrs
)
128 AddUnsigned(*Conf
.RelocModel
);
132 AddUnsigned(*Conf
.CodeModel
);
135 AddUnsigned(Conf
.CGOptLevel
);
136 AddUnsigned(Conf
.CGFileType
);
137 AddUnsigned(Conf
.OptLevel
);
138 AddUnsigned(Conf
.UseNewPM
);
139 AddUnsigned(Conf
.Freestanding
);
140 AddString(Conf
.OptPipeline
);
141 AddString(Conf
.AAPipeline
);
142 AddString(Conf
.OverrideTriple
);
143 AddString(Conf
.DefaultTriple
);
144 AddString(Conf
.DwoDir
);
146 // Include the hash for the current module
147 auto ModHash
= Index
.getModuleHash(ModuleID
);
148 Hasher
.update(ArrayRef
<uint8_t>((uint8_t *)&ModHash
[0], sizeof(ModHash
)));
149 for (auto F
: ExportList
)
150 // The export list can impact the internalization, be conservative here
151 Hasher
.update(ArrayRef
<uint8_t>((uint8_t *)&F
, sizeof(F
)));
153 // Include the hash for every module we import functions from. The set of
154 // imported symbols for each module may affect code generation and is
155 // sensitive to link order, so include that as well.
156 for (auto &Entry
: ImportList
) {
157 auto ModHash
= Index
.getModuleHash(Entry
.first());
158 Hasher
.update(ArrayRef
<uint8_t>((uint8_t *)&ModHash
[0], sizeof(ModHash
)));
160 AddUint64(Entry
.second
.size());
161 for (auto &Fn
: Entry
.second
)
165 // Include the hash for the resolved ODR.
166 for (auto &Entry
: ResolvedODR
) {
167 Hasher
.update(ArrayRef
<uint8_t>((const uint8_t *)&Entry
.first
,
168 sizeof(GlobalValue::GUID
)));
169 Hasher
.update(ArrayRef
<uint8_t>((const uint8_t *)&Entry
.second
,
170 sizeof(GlobalValue::LinkageTypes
)));
173 // Members of CfiFunctionDefs and CfiFunctionDecls that are referenced or
174 // defined in this module.
175 std::set
<GlobalValue::GUID
> UsedCfiDefs
;
176 std::set
<GlobalValue::GUID
> UsedCfiDecls
;
178 // Typeids used in this module.
179 std::set
<GlobalValue::GUID
> UsedTypeIds
;
181 auto AddUsedCfiGlobal
= [&](GlobalValue::GUID ValueGUID
) {
182 if (CfiFunctionDefs
.count(ValueGUID
))
183 UsedCfiDefs
.insert(ValueGUID
);
184 if (CfiFunctionDecls
.count(ValueGUID
))
185 UsedCfiDecls
.insert(ValueGUID
);
188 auto AddUsedThings
= [&](GlobalValueSummary
*GS
) {
190 AddUnsigned(GS
->isLive());
191 AddUnsigned(GS
->canAutoHide());
192 for (const ValueInfo
&VI
: GS
->refs()) {
193 AddUnsigned(VI
.isDSOLocal());
194 AddUsedCfiGlobal(VI
.getGUID());
196 if (auto *GVS
= dyn_cast
<GlobalVarSummary
>(GS
)) {
197 AddUnsigned(GVS
->maybeReadOnly());
198 AddUnsigned(GVS
->maybeWriteOnly());
200 if (auto *FS
= dyn_cast
<FunctionSummary
>(GS
)) {
201 for (auto &TT
: FS
->type_tests())
202 UsedTypeIds
.insert(TT
);
203 for (auto &TT
: FS
->type_test_assume_vcalls())
204 UsedTypeIds
.insert(TT
.GUID
);
205 for (auto &TT
: FS
->type_checked_load_vcalls())
206 UsedTypeIds
.insert(TT
.GUID
);
207 for (auto &TT
: FS
->type_test_assume_const_vcalls())
208 UsedTypeIds
.insert(TT
.VFunc
.GUID
);
209 for (auto &TT
: FS
->type_checked_load_const_vcalls())
210 UsedTypeIds
.insert(TT
.VFunc
.GUID
);
211 for (auto &ET
: FS
->calls()) {
212 AddUnsigned(ET
.first
.isDSOLocal());
213 AddUsedCfiGlobal(ET
.first
.getGUID());
218 // Include the hash for the linkage type to reflect internalization and weak
219 // resolution, and collect any used type identifier resolutions.
220 for (auto &GS
: DefinedGlobals
) {
221 GlobalValue::LinkageTypes Linkage
= GS
.second
->linkage();
223 ArrayRef
<uint8_t>((const uint8_t *)&Linkage
, sizeof(Linkage
)));
224 AddUsedCfiGlobal(GS
.first
);
225 AddUsedThings(GS
.second
);
228 // Imported functions may introduce new uses of type identifier resolutions,
229 // so we need to collect their used resolutions as well.
230 for (auto &ImpM
: ImportList
)
231 for (auto &ImpF
: ImpM
.second
) {
232 GlobalValueSummary
*S
= Index
.findSummaryInModule(ImpF
, ImpM
.first());
234 // If this is an alias, we also care about any types/etc. that the aliasee
236 if (auto *AS
= dyn_cast_or_null
<AliasSummary
>(S
))
237 AddUsedThings(AS
->getBaseObject());
240 auto AddTypeIdSummary
= [&](StringRef TId
, const TypeIdSummary
&S
) {
243 AddUnsigned(S
.TTRes
.TheKind
);
244 AddUnsigned(S
.TTRes
.SizeM1BitWidth
);
246 AddUint64(S
.TTRes
.AlignLog2
);
247 AddUint64(S
.TTRes
.SizeM1
);
248 AddUint64(S
.TTRes
.BitMask
);
249 AddUint64(S
.TTRes
.InlineBits
);
251 AddUint64(S
.WPDRes
.size());
252 for (auto &WPD
: S
.WPDRes
) {
253 AddUnsigned(WPD
.first
);
254 AddUnsigned(WPD
.second
.TheKind
);
255 AddString(WPD
.second
.SingleImplName
);
257 AddUint64(WPD
.second
.ResByArg
.size());
258 for (auto &ByArg
: WPD
.second
.ResByArg
) {
259 AddUint64(ByArg
.first
.size());
260 for (uint64_t Arg
: ByArg
.first
)
262 AddUnsigned(ByArg
.second
.TheKind
);
263 AddUint64(ByArg
.second
.Info
);
264 AddUnsigned(ByArg
.second
.Byte
);
265 AddUnsigned(ByArg
.second
.Bit
);
270 // Include the hash for all type identifiers used by this module.
271 for (GlobalValue::GUID TId
: UsedTypeIds
) {
272 auto TidIter
= Index
.typeIds().equal_range(TId
);
273 for (auto It
= TidIter
.first
; It
!= TidIter
.second
; ++It
)
274 AddTypeIdSummary(It
->second
.first
, It
->second
.second
);
277 AddUnsigned(UsedCfiDefs
.size());
278 for (auto &V
: UsedCfiDefs
)
281 AddUnsigned(UsedCfiDecls
.size());
282 for (auto &V
: UsedCfiDecls
)
285 if (!Conf
.SampleProfile
.empty()) {
286 auto FileOrErr
= MemoryBuffer::getFile(Conf
.SampleProfile
);
288 Hasher
.update(FileOrErr
.get()->getBuffer());
290 if (!Conf
.ProfileRemapping
.empty()) {
291 FileOrErr
= MemoryBuffer::getFile(Conf
.ProfileRemapping
);
293 Hasher
.update(FileOrErr
.get()->getBuffer());
298 Key
= toHex(Hasher
.result());
301 static void thinLTOResolvePrevailingGUID(
302 ValueInfo VI
, DenseSet
<GlobalValueSummary
*> &GlobalInvolvedWithAlias
,
303 function_ref
<bool(GlobalValue::GUID
, const GlobalValueSummary
*)>
305 function_ref
<void(StringRef
, GlobalValue::GUID
, GlobalValue::LinkageTypes
)>
307 const DenseSet
<GlobalValue::GUID
> &GUIDPreservedSymbols
) {
308 for (auto &S
: VI
.getSummaryList()) {
309 GlobalValue::LinkageTypes OriginalLinkage
= S
->linkage();
310 // Ignore local and appending linkage values since the linker
311 // doesn't resolve them.
312 if (GlobalValue::isLocalLinkage(OriginalLinkage
) ||
313 GlobalValue::isAppendingLinkage(S
->linkage()))
315 // We need to emit only one of these. The prevailing module will keep it,
316 // but turned into a weak, while the others will drop it when possible.
317 // This is both a compile-time optimization and a correctness
318 // transformation. This is necessary for correctness when we have exported
319 // a reference - we need to convert the linkonce to weak to
320 // ensure a copy is kept to satisfy the exported reference.
321 // FIXME: We may want to split the compile time and correctness
322 // aspects into separate routines.
323 if (isPrevailing(VI
.getGUID(), S
.get())) {
324 if (GlobalValue::isLinkOnceLinkage(OriginalLinkage
)) {
325 S
->setLinkage(GlobalValue::getWeakLinkage(
326 GlobalValue::isLinkOnceODRLinkage(OriginalLinkage
)));
327 // The kept copy is eligible for auto-hiding (hidden visibility) if all
328 // copies were (i.e. they were all linkonce_odr global unnamed addr).
329 // If any copy is not (e.g. it was originally weak_odr), then the symbol
330 // must remain externally available (e.g. a weak_odr from an explicitly
331 // instantiated template). Additionally, if it is in the
332 // GUIDPreservedSymbols set, that means that it is visibile outside
333 // the summary (e.g. in a native object or a bitcode file without
334 // summary), and in that case we cannot hide it as it isn't possible to
336 S
->setCanAutoHide(VI
.canAutoHide() &&
337 !GUIDPreservedSymbols
.count(VI
.getGUID()));
340 // Alias and aliasee can't be turned into available_externally.
341 else if (!isa
<AliasSummary
>(S
.get()) &&
342 !GlobalInvolvedWithAlias
.count(S
.get()))
343 S
->setLinkage(GlobalValue::AvailableExternallyLinkage
);
344 if (S
->linkage() != OriginalLinkage
)
345 recordNewLinkage(S
->modulePath(), VI
.getGUID(), S
->linkage());
349 /// Resolve linkage for prevailing symbols in the \p Index.
351 // We'd like to drop these functions if they are no longer referenced in the
352 // current module. However there is a chance that another module is still
353 // referencing them because of the import. We make sure we always emit at least
355 void llvm::thinLTOResolvePrevailingInIndex(
356 ModuleSummaryIndex
&Index
,
357 function_ref
<bool(GlobalValue::GUID
, const GlobalValueSummary
*)>
359 function_ref
<void(StringRef
, GlobalValue::GUID
, GlobalValue::LinkageTypes
)>
361 const DenseSet
<GlobalValue::GUID
> &GUIDPreservedSymbols
) {
362 // We won't optimize the globals that are referenced by an alias for now
363 // Ideally we should turn the alias into a global and duplicate the definition
365 DenseSet
<GlobalValueSummary
*> GlobalInvolvedWithAlias
;
366 for (auto &I
: Index
)
367 for (auto &S
: I
.second
.SummaryList
)
368 if (auto AS
= dyn_cast
<AliasSummary
>(S
.get()))
369 GlobalInvolvedWithAlias
.insert(&AS
->getAliasee());
371 for (auto &I
: Index
)
372 thinLTOResolvePrevailingGUID(Index
.getValueInfo(I
), GlobalInvolvedWithAlias
,
373 isPrevailing
, recordNewLinkage
,
374 GUIDPreservedSymbols
);
377 static bool isWeakObjectWithRWAccess(GlobalValueSummary
*GVS
) {
378 if (auto *VarSummary
= dyn_cast
<GlobalVarSummary
>(GVS
->getBaseObject()))
379 return !VarSummary
->maybeReadOnly() && !VarSummary
->maybeWriteOnly() &&
380 (VarSummary
->linkage() == GlobalValue::WeakODRLinkage
||
381 VarSummary
->linkage() == GlobalValue::LinkOnceODRLinkage
);
385 static void thinLTOInternalizeAndPromoteGUID(
386 GlobalValueSummaryList
&GVSummaryList
, GlobalValue::GUID GUID
,
387 function_ref
<bool(StringRef
, GlobalValue::GUID
)> isExported
,
388 function_ref
<bool(GlobalValue::GUID
, const GlobalValueSummary
*)>
390 for (auto &S
: GVSummaryList
) {
391 if (isExported(S
->modulePath(), GUID
)) {
392 if (GlobalValue::isLocalLinkage(S
->linkage()))
393 S
->setLinkage(GlobalValue::ExternalLinkage
);
394 } else if (EnableLTOInternalization
&&
395 // Ignore local and appending linkage values since the linker
396 // doesn't resolve them.
397 !GlobalValue::isLocalLinkage(S
->linkage()) &&
398 (!GlobalValue::isInterposableLinkage(S
->linkage()) ||
399 isPrevailing(GUID
, S
.get())) &&
400 S
->linkage() != GlobalValue::AppendingLinkage
&&
401 // We can't internalize available_externally globals because this
402 // can break function pointer equality.
403 S
->linkage() != GlobalValue::AvailableExternallyLinkage
&&
404 // Functions and read-only variables with linkonce_odr and
405 // weak_odr linkage can be internalized. We can't internalize
406 // linkonce_odr and weak_odr variables which are both modified
407 // and read somewhere in the program because reads and writes
408 // will become inconsistent.
409 !isWeakObjectWithRWAccess(S
.get()))
410 S
->setLinkage(GlobalValue::InternalLinkage
);
414 // Update the linkages in the given \p Index to mark exported values
415 // as external and non-exported values as internal.
416 void llvm::thinLTOInternalizeAndPromoteInIndex(
417 ModuleSummaryIndex
&Index
,
418 function_ref
<bool(StringRef
, GlobalValue::GUID
)> isExported
,
419 function_ref
<bool(GlobalValue::GUID
, const GlobalValueSummary
*)>
421 for (auto &I
: Index
)
422 thinLTOInternalizeAndPromoteGUID(I
.second
.SummaryList
, I
.first
, isExported
,
426 // Requires a destructor for std::vector<InputModule>.
427 InputFile::~InputFile() = default;
429 Expected
<std::unique_ptr
<InputFile
>> InputFile::create(MemoryBufferRef Object
) {
430 std::unique_ptr
<InputFile
> File(new InputFile
);
432 Expected
<IRSymtabFile
> FOrErr
= readIRSymtab(Object
);
434 return FOrErr
.takeError();
436 File
->TargetTriple
= FOrErr
->TheReader
.getTargetTriple();
437 File
->SourceFileName
= FOrErr
->TheReader
.getSourceFileName();
438 File
->COFFLinkerOpts
= FOrErr
->TheReader
.getCOFFLinkerOpts();
439 File
->DependentLibraries
= FOrErr
->TheReader
.getDependentLibraries();
440 File
->ComdatTable
= FOrErr
->TheReader
.getComdatTable();
442 for (unsigned I
= 0; I
!= FOrErr
->Mods
.size(); ++I
) {
443 size_t Begin
= File
->Symbols
.size();
444 for (const irsymtab::Reader::SymbolRef
&Sym
:
445 FOrErr
->TheReader
.module_symbols(I
))
446 // Skip symbols that are irrelevant to LTO. Note that this condition needs
447 // to match the one in Skip() in LTO::addRegularLTO().
448 if (Sym
.isGlobal() && !Sym
.isFormatSpecific())
449 File
->Symbols
.push_back(Sym
);
450 File
->ModuleSymIndices
.push_back({Begin
, File
->Symbols
.size()});
453 File
->Mods
= FOrErr
->Mods
;
454 File
->Strtab
= std::move(FOrErr
->Strtab
);
455 return std::move(File
);
458 StringRef
InputFile::getName() const {
459 return Mods
[0].getModuleIdentifier();
462 BitcodeModule
&InputFile::getSingleBitcodeModule() {
463 assert(Mods
.size() == 1 && "Expect only one bitcode module");
467 LTO::RegularLTOState::RegularLTOState(unsigned ParallelCodeGenParallelismLevel
,
469 : ParallelCodeGenParallelismLevel(ParallelCodeGenParallelismLevel
),
470 Ctx(Conf
), CombinedModule(std::make_unique
<Module
>("ld-temp.o", Ctx
)),
471 Mover(std::make_unique
<IRMover
>(*CombinedModule
)) {}
473 LTO::ThinLTOState::ThinLTOState(ThinBackend Backend
)
474 : Backend(Backend
), CombinedIndex(/*HaveGVs*/ false) {
477 createInProcessThinBackend(llvm::heavyweight_hardware_concurrency());
480 LTO::LTO(Config Conf
, ThinBackend Backend
,
481 unsigned ParallelCodeGenParallelismLevel
)
482 : Conf(std::move(Conf
)),
483 RegularLTO(ParallelCodeGenParallelismLevel
, this->Conf
),
484 ThinLTO(std::move(Backend
)) {}
486 // Requires a destructor for MapVector<BitcodeModule>.
487 LTO::~LTO() = default;
489 // Add the symbols in the given module to the GlobalResolutions map, and resolve
491 void LTO::addModuleToGlobalRes(ArrayRef
<InputFile::Symbol
> Syms
,
492 ArrayRef
<SymbolResolution
> Res
,
493 unsigned Partition
, bool InSummary
) {
494 auto *ResI
= Res
.begin();
495 auto *ResE
= Res
.end();
497 for (const InputFile::Symbol
&Sym
: Syms
) {
498 assert(ResI
!= ResE
);
499 SymbolResolution Res
= *ResI
++;
501 StringRef Name
= Sym
.getName();
502 Triple
TT(RegularLTO
.CombinedModule
->getTargetTriple());
503 // Strip the __imp_ prefix from COFF dllimport symbols (similar to the
504 // way they are handled by lld), otherwise we can end up with two
505 // global resolutions (one with and one for a copy of the symbol without).
506 if (TT
.isOSBinFormatCOFF() && Name
.startswith("__imp_"))
507 Name
= Name
.substr(strlen("__imp_"));
508 auto &GlobalRes
= GlobalResolutions
[Name
];
509 GlobalRes
.UnnamedAddr
&= Sym
.isUnnamedAddr();
510 if (Res
.Prevailing
) {
511 assert(!GlobalRes
.Prevailing
&&
512 "Multiple prevailing defs are not allowed");
513 GlobalRes
.Prevailing
= true;
514 GlobalRes
.IRName
= Sym
.getIRName();
515 } else if (!GlobalRes
.Prevailing
&& GlobalRes
.IRName
.empty()) {
516 // Sometimes it can be two copies of symbol in a module and prevailing
517 // symbol can have no IR name. That might happen if symbol is defined in
518 // module level inline asm block. In case we have multiple modules with
519 // the same symbol we want to use IR name of the prevailing symbol.
520 // Otherwise, if we haven't seen a prevailing symbol, set the name so that
521 // we can later use it to check if there is any prevailing copy in IR.
522 GlobalRes
.IRName
= Sym
.getIRName();
525 // Set the partition to external if we know it is re-defined by the linker
526 // with -defsym or -wrap options, used elsewhere, e.g. it is visible to a
527 // regular object, is referenced from llvm.compiler_used, or was already
528 // recorded as being referenced from a different partition.
529 if (Res
.LinkerRedefined
|| Res
.VisibleToRegularObj
|| Sym
.isUsed() ||
530 (GlobalRes
.Partition
!= GlobalResolution::Unknown
&&
531 GlobalRes
.Partition
!= Partition
)) {
532 GlobalRes
.Partition
= GlobalResolution::External
;
534 // First recorded reference, save the current partition.
535 GlobalRes
.Partition
= Partition
;
537 // Flag as visible outside of summary if visible from a regular object or
538 // from a module that does not have a summary.
539 GlobalRes
.VisibleOutsideSummary
|=
540 (Res
.VisibleToRegularObj
|| Sym
.isUsed() || !InSummary
);
544 static void writeToResolutionFile(raw_ostream
&OS
, InputFile
*Input
,
545 ArrayRef
<SymbolResolution
> Res
) {
546 StringRef Path
= Input
->getName();
548 auto ResI
= Res
.begin();
549 for (const InputFile::Symbol
&Sym
: Input
->symbols()) {
550 assert(ResI
!= Res
.end());
551 SymbolResolution Res
= *ResI
++;
553 OS
<< "-r=" << Path
<< ',' << Sym
.getName() << ',';
556 if (Res
.FinalDefinitionInLinkageUnit
)
558 if (Res
.VisibleToRegularObj
)
560 if (Res
.LinkerRedefined
)
565 assert(ResI
== Res
.end());
568 Error
LTO::add(std::unique_ptr
<InputFile
> Input
,
569 ArrayRef
<SymbolResolution
> Res
) {
570 assert(!CalledGetMaxTasks
);
572 if (Conf
.ResolutionFile
)
573 writeToResolutionFile(*Conf
.ResolutionFile
, Input
.get(), Res
);
575 if (RegularLTO
.CombinedModule
->getTargetTriple().empty())
576 RegularLTO
.CombinedModule
->setTargetTriple(Input
->getTargetTriple());
578 const SymbolResolution
*ResI
= Res
.begin();
579 for (unsigned I
= 0; I
!= Input
->Mods
.size(); ++I
)
580 if (Error Err
= addModule(*Input
, I
, ResI
, Res
.end()))
583 assert(ResI
== Res
.end());
584 return Error::success();
587 Error
LTO::addModule(InputFile
&Input
, unsigned ModI
,
588 const SymbolResolution
*&ResI
,
589 const SymbolResolution
*ResE
) {
590 Expected
<BitcodeLTOInfo
> LTOInfo
= Input
.Mods
[ModI
].getLTOInfo();
592 return LTOInfo
.takeError();
594 if (EnableSplitLTOUnit
.hasValue()) {
595 // If only some modules were split, flag this in the index so that
596 // we can skip or error on optimizations that need consistently split
597 // modules (whole program devirt and lower type tests).
598 if (EnableSplitLTOUnit
.getValue() != LTOInfo
->EnableSplitLTOUnit
)
599 ThinLTO
.CombinedIndex
.setPartiallySplitLTOUnits();
601 EnableSplitLTOUnit
= LTOInfo
->EnableSplitLTOUnit
;
603 BitcodeModule BM
= Input
.Mods
[ModI
];
604 auto ModSyms
= Input
.module_symbols(ModI
);
605 addModuleToGlobalRes(ModSyms
, {ResI
, ResE
},
606 LTOInfo
->IsThinLTO
? ThinLTO
.ModuleMap
.size() + 1 : 0,
607 LTOInfo
->HasSummary
);
609 if (LTOInfo
->IsThinLTO
)
610 return addThinLTO(BM
, ModSyms
, ResI
, ResE
);
612 Expected
<RegularLTOState::AddedModule
> ModOrErr
=
613 addRegularLTO(BM
, ModSyms
, ResI
, ResE
);
615 return ModOrErr
.takeError();
617 if (!LTOInfo
->HasSummary
)
618 return linkRegularLTO(std::move(*ModOrErr
), /*LivenessFromIndex=*/false);
620 // Regular LTO module summaries are added to a dummy module that represents
621 // the combined regular LTO module.
622 if (Error Err
= BM
.readSummary(ThinLTO
.CombinedIndex
, "", -1ull))
624 RegularLTO
.ModsWithSummaries
.push_back(std::move(*ModOrErr
));
625 return Error::success();
628 // Checks whether the given global value is in a non-prevailing comdat
629 // (comdat containing values the linker indicated were not prevailing,
630 // which we then dropped to available_externally), and if so, removes
631 // it from the comdat. This is called for all global values to ensure the
632 // comdat is empty rather than leaving an incomplete comdat. It is needed for
633 // regular LTO modules, in case we are in a mixed-LTO mode (both regular
634 // and thin LTO modules) compilation. Since the regular LTO module will be
635 // linked first in the final native link, we want to make sure the linker
636 // doesn't select any of these incomplete comdats that would be left
637 // in the regular LTO module without this cleanup.
639 handleNonPrevailingComdat(GlobalValue
&GV
,
640 std::set
<const Comdat
*> &NonPrevailingComdats
) {
641 Comdat
*C
= GV
.getComdat();
645 if (!NonPrevailingComdats
.count(C
))
648 // Additionally need to drop externally visible global values from the comdat
649 // to available_externally, so that there aren't multiply defined linker
651 if (!GV
.hasLocalLinkage())
652 GV
.setLinkage(GlobalValue::AvailableExternallyLinkage
);
654 if (auto GO
= dyn_cast
<GlobalObject
>(&GV
))
655 GO
->setComdat(nullptr);
658 // Add a regular LTO object to the link.
659 // The resulting module needs to be linked into the combined LTO module with
661 Expected
<LTO::RegularLTOState::AddedModule
>
662 LTO::addRegularLTO(BitcodeModule BM
, ArrayRef
<InputFile::Symbol
> Syms
,
663 const SymbolResolution
*&ResI
,
664 const SymbolResolution
*ResE
) {
665 RegularLTOState::AddedModule Mod
;
666 Expected
<std::unique_ptr
<Module
>> MOrErr
=
667 BM
.getLazyModule(RegularLTO
.Ctx
, /*ShouldLazyLoadMetadata*/ true,
668 /*IsImporting*/ false);
670 return MOrErr
.takeError();
671 Module
&M
= **MOrErr
;
672 Mod
.M
= std::move(*MOrErr
);
674 if (Error Err
= M
.materializeMetadata())
675 return std::move(Err
);
678 ModuleSymbolTable SymTab
;
679 SymTab
.addModule(&M
);
681 for (GlobalVariable
&GV
: M
.globals())
682 if (GV
.hasAppendingLinkage())
683 Mod
.Keep
.push_back(&GV
);
685 DenseSet
<GlobalObject
*> AliasedGlobals
;
686 for (auto &GA
: M
.aliases())
687 if (GlobalObject
*GO
= GA
.getBaseObject())
688 AliasedGlobals
.insert(GO
);
690 // In this function we need IR GlobalValues matching the symbols in Syms
691 // (which is not backed by a module), so we need to enumerate them in the same
692 // order. The symbol enumeration order of a ModuleSymbolTable intentionally
693 // matches the order of an irsymtab, but when we read the irsymtab in
694 // InputFile::create we omit some symbols that are irrelevant to LTO. The
695 // Skip() function skips the same symbols from the module as InputFile does
696 // from the symbol table.
697 auto MsymI
= SymTab
.symbols().begin(), MsymE
= SymTab
.symbols().end();
699 while (MsymI
!= MsymE
) {
700 auto Flags
= SymTab
.getSymbolFlags(*MsymI
);
701 if ((Flags
& object::BasicSymbolRef::SF_Global
) &&
702 !(Flags
& object::BasicSymbolRef::SF_FormatSpecific
))
709 std::set
<const Comdat
*> NonPrevailingComdats
;
710 for (const InputFile::Symbol
&Sym
: Syms
) {
711 assert(ResI
!= ResE
);
712 SymbolResolution Res
= *ResI
++;
714 assert(MsymI
!= MsymE
);
715 ModuleSymbolTable::Symbol Msym
= *MsymI
++;
718 if (GlobalValue
*GV
= Msym
.dyn_cast
<GlobalValue
*>()) {
719 if (Res
.Prevailing
) {
720 if (Sym
.isUndefined())
722 Mod
.Keep
.push_back(GV
);
723 // For symbols re-defined with linker -wrap and -defsym options,
724 // set the linkage to weak to inhibit IPO. The linkage will be
725 // restored by the linker.
726 if (Res
.LinkerRedefined
)
727 GV
->setLinkage(GlobalValue::WeakAnyLinkage
);
729 GlobalValue::LinkageTypes OriginalLinkage
= GV
->getLinkage();
730 if (GlobalValue::isLinkOnceLinkage(OriginalLinkage
))
731 GV
->setLinkage(GlobalValue::getWeakLinkage(
732 GlobalValue::isLinkOnceODRLinkage(OriginalLinkage
)));
733 } else if (isa
<GlobalObject
>(GV
) &&
734 (GV
->hasLinkOnceODRLinkage() || GV
->hasWeakODRLinkage() ||
735 GV
->hasAvailableExternallyLinkage()) &&
736 !AliasedGlobals
.count(cast
<GlobalObject
>(GV
))) {
737 // Any of the above three types of linkage indicates that the
738 // chosen prevailing symbol will have the same semantics as this copy of
739 // the symbol, so we may be able to link it with available_externally
740 // linkage. We will decide later whether to do that when we link this
741 // module (in linkRegularLTO), based on whether it is undefined.
742 Mod
.Keep
.push_back(GV
);
743 GV
->setLinkage(GlobalValue::AvailableExternallyLinkage
);
745 NonPrevailingComdats
.insert(GV
->getComdat());
746 cast
<GlobalObject
>(GV
)->setComdat(nullptr);
749 // Set the 'local' flag based on the linker resolution for this symbol.
750 if (Res
.FinalDefinitionInLinkageUnit
) {
751 GV
->setDSOLocal(true);
752 if (GV
->hasDLLImportStorageClass())
753 GV
->setDLLStorageClass(GlobalValue::DLLStorageClassTypes::
754 DefaultStorageClass
);
757 // Common resolution: collect the maximum size/alignment over all commons.
758 // We also record if we see an instance of a common as prevailing, so that
759 // if none is prevailing we can ignore it later.
760 if (Sym
.isCommon()) {
761 // FIXME: We should figure out what to do about commons defined by asm.
762 // For now they aren't reported correctly by ModuleSymbolTable.
763 auto &CommonRes
= RegularLTO
.Commons
[Sym
.getIRName()];
764 CommonRes
.Size
= std::max(CommonRes
.Size
, Sym
.getCommonSize());
765 CommonRes
.Align
= std::max(CommonRes
.Align
, Sym
.getCommonAlignment());
766 CommonRes
.Prevailing
|= Res
.Prevailing
;
770 if (!M
.getComdatSymbolTable().empty())
771 for (GlobalValue
&GV
: M
.global_values())
772 handleNonPrevailingComdat(GV
, NonPrevailingComdats
);
773 assert(MsymI
== MsymE
);
774 return std::move(Mod
);
777 Error
LTO::linkRegularLTO(RegularLTOState::AddedModule Mod
,
778 bool LivenessFromIndex
) {
779 std::vector
<GlobalValue
*> Keep
;
780 for (GlobalValue
*GV
: Mod
.Keep
) {
781 if (LivenessFromIndex
&& !ThinLTO
.CombinedIndex
.isGUIDLive(GV
->getGUID()))
784 if (!GV
->hasAvailableExternallyLinkage()) {
789 // Only link available_externally definitions if we don't already have a
791 GlobalValue
*CombinedGV
=
792 RegularLTO
.CombinedModule
->getNamedValue(GV
->getName());
793 if (CombinedGV
&& !CombinedGV
->isDeclaration())
799 return RegularLTO
.Mover
->move(std::move(Mod
.M
), Keep
,
800 [](GlobalValue
&, IRMover::ValueAdder
) {},
801 /* IsPerformingImport */ false);
804 // Add a ThinLTO module to the link.
805 Error
LTO::addThinLTO(BitcodeModule BM
, ArrayRef
<InputFile::Symbol
> Syms
,
806 const SymbolResolution
*&ResI
,
807 const SymbolResolution
*ResE
) {
809 BM
.readSummary(ThinLTO
.CombinedIndex
, BM
.getModuleIdentifier(),
810 ThinLTO
.ModuleMap
.size()))
813 for (const InputFile::Symbol
&Sym
: Syms
) {
814 assert(ResI
!= ResE
);
815 SymbolResolution Res
= *ResI
++;
817 if (!Sym
.getIRName().empty()) {
818 auto GUID
= GlobalValue::getGUID(GlobalValue::getGlobalIdentifier(
819 Sym
.getIRName(), GlobalValue::ExternalLinkage
, ""));
820 if (Res
.Prevailing
) {
821 ThinLTO
.PrevailingModuleForGUID
[GUID
] = BM
.getModuleIdentifier();
823 // For linker redefined symbols (via --wrap or --defsym) we want to
824 // switch the linkage to `weak` to prevent IPOs from happening.
825 // Find the summary in the module for this very GV and record the new
826 // linkage so that we can switch it when we import the GV.
827 if (Res
.LinkerRedefined
)
828 if (auto S
= ThinLTO
.CombinedIndex
.findSummaryInModule(
829 GUID
, BM
.getModuleIdentifier()))
830 S
->setLinkage(GlobalValue::WeakAnyLinkage
);
833 // If the linker resolved the symbol to a local definition then mark it
834 // as local in the summary for the module we are adding.
835 if (Res
.FinalDefinitionInLinkageUnit
) {
836 if (auto S
= ThinLTO
.CombinedIndex
.findSummaryInModule(
837 GUID
, BM
.getModuleIdentifier())) {
838 S
->setDSOLocal(true);
844 if (!ThinLTO
.ModuleMap
.insert({BM
.getModuleIdentifier(), BM
}).second
)
845 return make_error
<StringError
>(
846 "Expected at most one ThinLTO module per bitcode file",
847 inconvertibleErrorCode());
849 return Error::success();
852 unsigned LTO::getMaxTasks() const {
853 CalledGetMaxTasks
= true;
854 return RegularLTO
.ParallelCodeGenParallelismLevel
+ ThinLTO
.ModuleMap
.size();
857 // If only some of the modules were split, we cannot correctly handle
858 // code that contains type tests or type checked loads.
859 Error
LTO::checkPartiallySplit() {
860 if (!ThinLTO
.CombinedIndex
.partiallySplitLTOUnits())
861 return Error::success();
863 Function
*TypeTestFunc
= RegularLTO
.CombinedModule
->getFunction(
864 Intrinsic::getName(Intrinsic::type_test
));
865 Function
*TypeCheckedLoadFunc
= RegularLTO
.CombinedModule
->getFunction(
866 Intrinsic::getName(Intrinsic::type_checked_load
));
868 // First check if there are type tests / type checked loads in the
869 // merged regular LTO module IR.
870 if ((TypeTestFunc
&& !TypeTestFunc
->use_empty()) ||
871 (TypeCheckedLoadFunc
&& !TypeCheckedLoadFunc
->use_empty()))
872 return make_error
<StringError
>(
873 "inconsistent LTO Unit splitting (recompile with -fsplit-lto-unit)",
874 inconvertibleErrorCode());
876 // Otherwise check if there are any recorded in the combined summary from the
878 for (auto &P
: ThinLTO
.CombinedIndex
) {
879 for (auto &S
: P
.second
.SummaryList
) {
880 auto *FS
= dyn_cast
<FunctionSummary
>(S
.get());
883 if (!FS
->type_test_assume_vcalls().empty() ||
884 !FS
->type_checked_load_vcalls().empty() ||
885 !FS
->type_test_assume_const_vcalls().empty() ||
886 !FS
->type_checked_load_const_vcalls().empty() ||
887 !FS
->type_tests().empty())
888 return make_error
<StringError
>(
889 "inconsistent LTO Unit splitting (recompile with -fsplit-lto-unit)",
890 inconvertibleErrorCode());
893 return Error::success();
896 Error
LTO::run(AddStreamFn AddStream
, NativeObjectCache Cache
) {
897 // Compute "dead" symbols, we don't want to import/export these!
898 DenseSet
<GlobalValue::GUID
> GUIDPreservedSymbols
;
899 DenseMap
<GlobalValue::GUID
, PrevailingType
> GUIDPrevailingResolutions
;
900 for (auto &Res
: GlobalResolutions
) {
901 // Normally resolution have IR name of symbol. We can do nothing here
902 // otherwise. See comments in GlobalResolution struct for more details.
903 if (Res
.second
.IRName
.empty())
906 GlobalValue::GUID GUID
= GlobalValue::getGUID(
907 GlobalValue::dropLLVMManglingEscape(Res
.second
.IRName
));
909 if (Res
.second
.VisibleOutsideSummary
&& Res
.second
.Prevailing
)
910 GUIDPreservedSymbols
.insert(GUID
);
912 GUIDPrevailingResolutions
[GUID
] =
913 Res
.second
.Prevailing
? PrevailingType::Yes
: PrevailingType::No
;
916 auto isPrevailing
= [&](GlobalValue::GUID G
) {
917 auto It
= GUIDPrevailingResolutions
.find(G
);
918 if (It
== GUIDPrevailingResolutions
.end())
919 return PrevailingType::Unknown
;
922 computeDeadSymbolsWithConstProp(ThinLTO
.CombinedIndex
, GUIDPreservedSymbols
,
923 isPrevailing
, Conf
.OptLevel
> 0);
925 // Setup output file to emit statistics.
926 auto StatsFileOrErr
= setupStatsFile(Conf
.StatsFile
);
928 return StatsFileOrErr
.takeError();
929 std::unique_ptr
<ToolOutputFile
> StatsFile
= std::move(StatsFileOrErr
.get());
931 // Finalize linking of regular LTO modules containing summaries now that
932 // we have computed liveness information.
933 for (auto &M
: RegularLTO
.ModsWithSummaries
)
934 if (Error Err
= linkRegularLTO(std::move(M
),
935 /*LivenessFromIndex=*/true))
938 // Ensure we don't have inconsistently split LTO units with type tests.
939 if (Error Err
= checkPartiallySplit())
942 Error Result
= runRegularLTO(AddStream
);
944 Result
= runThinLTO(AddStream
, Cache
, GUIDPreservedSymbols
);
947 PrintStatisticsJSON(StatsFile
->os());
952 Error
LTO::runRegularLTO(AddStreamFn AddStream
) {
953 // Make sure commons have the right size/alignment: we kept the largest from
954 // all the prevailing when adding the inputs, and we apply it here.
955 const DataLayout
&DL
= RegularLTO
.CombinedModule
->getDataLayout();
956 for (auto &I
: RegularLTO
.Commons
) {
957 if (!I
.second
.Prevailing
)
958 // Don't do anything if no instance of this common was prevailing.
960 GlobalVariable
*OldGV
= RegularLTO
.CombinedModule
->getNamedGlobal(I
.first
);
961 if (OldGV
&& DL
.getTypeAllocSize(OldGV
->getValueType()) == I
.second
.Size
) {
962 // Don't create a new global if the type is already correct, just make
963 // sure the alignment is correct.
964 OldGV
->setAlignment(I
.second
.Align
);
968 ArrayType::get(Type::getInt8Ty(RegularLTO
.Ctx
), I
.second
.Size
);
969 auto *GV
= new GlobalVariable(*RegularLTO
.CombinedModule
, Ty
, false,
970 GlobalValue::CommonLinkage
,
971 ConstantAggregateZero::get(Ty
), "");
972 GV
->setAlignment(I
.second
.Align
);
974 OldGV
->replaceAllUsesWith(ConstantExpr::getBitCast(GV
, OldGV
->getType()));
976 OldGV
->eraseFromParent();
978 GV
->setName(I
.first
);
982 if (Conf
.PreOptModuleHook
&&
983 !Conf
.PreOptModuleHook(0, *RegularLTO
.CombinedModule
))
984 return Error::success();
986 if (!Conf
.CodeGenOnly
) {
987 for (const auto &R
: GlobalResolutions
) {
988 if (!R
.second
.isPrevailingIRSymbol())
990 if (R
.second
.Partition
!= 0 &&
991 R
.second
.Partition
!= GlobalResolution::External
)
995 RegularLTO
.CombinedModule
->getNamedValue(R
.second
.IRName
);
996 // Ignore symbols defined in other partitions.
997 // Also skip declarations, which are not allowed to have internal linkage.
998 if (!GV
|| GV
->hasLocalLinkage() || GV
->isDeclaration())
1000 GV
->setUnnamedAddr(R
.second
.UnnamedAddr
? GlobalValue::UnnamedAddr::Global
1001 : GlobalValue::UnnamedAddr::None
);
1002 if (EnableLTOInternalization
&& R
.second
.Partition
== 0)
1003 GV
->setLinkage(GlobalValue::InternalLinkage
);
1006 if (Conf
.PostInternalizeModuleHook
&&
1007 !Conf
.PostInternalizeModuleHook(0, *RegularLTO
.CombinedModule
))
1008 return Error::success();
1010 return backend(Conf
, AddStream
, RegularLTO
.ParallelCodeGenParallelismLevel
,
1011 std::move(RegularLTO
.CombinedModule
), ThinLTO
.CombinedIndex
);
1014 static const char *libcallRoutineNames
[] = {
1015 #define HANDLE_LIBCALL(code, name) name,
1016 #include "llvm/IR/RuntimeLibcalls.def"
1017 #undef HANDLE_LIBCALL
1020 ArrayRef
<const char*> LTO::getRuntimeLibcallSymbols() {
1021 return makeArrayRef(libcallRoutineNames
);
1024 /// This class defines the interface to the ThinLTO backend.
1025 class lto::ThinBackendProc
{
1028 ModuleSummaryIndex
&CombinedIndex
;
1029 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
;
1032 ThinBackendProc(Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1033 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
)
1034 : Conf(Conf
), CombinedIndex(CombinedIndex
),
1035 ModuleToDefinedGVSummaries(ModuleToDefinedGVSummaries
) {}
1037 virtual ~ThinBackendProc() {}
1038 virtual Error
start(
1039 unsigned Task
, BitcodeModule BM
,
1040 const FunctionImporter::ImportMapTy
&ImportList
,
1041 const FunctionImporter::ExportSetTy
&ExportList
,
1042 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
1043 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) = 0;
1044 virtual Error
wait() = 0;
1048 class InProcessThinBackend
: public ThinBackendProc
{
1049 ThreadPool BackendThreadPool
;
1050 AddStreamFn AddStream
;
1051 NativeObjectCache Cache
;
1052 std::set
<GlobalValue::GUID
> CfiFunctionDefs
;
1053 std::set
<GlobalValue::GUID
> CfiFunctionDecls
;
1055 Optional
<Error
> Err
;
1059 InProcessThinBackend(
1060 Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1061 unsigned ThinLTOParallelismLevel
,
1062 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
,
1063 AddStreamFn AddStream
, NativeObjectCache Cache
)
1064 : ThinBackendProc(Conf
, CombinedIndex
, ModuleToDefinedGVSummaries
),
1065 BackendThreadPool(ThinLTOParallelismLevel
),
1066 AddStream(std::move(AddStream
)), Cache(std::move(Cache
)) {
1067 for (auto &Name
: CombinedIndex
.cfiFunctionDefs())
1068 CfiFunctionDefs
.insert(
1069 GlobalValue::getGUID(GlobalValue::dropLLVMManglingEscape(Name
)));
1070 for (auto &Name
: CombinedIndex
.cfiFunctionDecls())
1071 CfiFunctionDecls
.insert(
1072 GlobalValue::getGUID(GlobalValue::dropLLVMManglingEscape(Name
)));
1075 Error
runThinLTOBackendThread(
1076 AddStreamFn AddStream
, NativeObjectCache Cache
, unsigned Task
,
1077 BitcodeModule BM
, ModuleSummaryIndex
&CombinedIndex
,
1078 const FunctionImporter::ImportMapTy
&ImportList
,
1079 const FunctionImporter::ExportSetTy
&ExportList
,
1080 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
1081 const GVSummaryMapTy
&DefinedGlobals
,
1082 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) {
1083 auto RunThinBackend
= [&](AddStreamFn AddStream
) {
1084 LTOLLVMContext
BackendContext(Conf
);
1085 Expected
<std::unique_ptr
<Module
>> MOrErr
= BM
.parseModule(BackendContext
);
1087 return MOrErr
.takeError();
1089 return thinBackend(Conf
, Task
, AddStream
, **MOrErr
, CombinedIndex
,
1090 ImportList
, DefinedGlobals
, ModuleMap
);
1093 auto ModuleID
= BM
.getModuleIdentifier();
1095 if (!Cache
|| !CombinedIndex
.modulePaths().count(ModuleID
) ||
1096 all_of(CombinedIndex
.getModuleHash(ModuleID
),
1097 [](uint32_t V
) { return V
== 0; }))
1098 // Cache disabled or no entry for this module in the combined index or
1100 return RunThinBackend(AddStream
);
1102 SmallString
<40> Key
;
1103 // The module may be cached, this helps handling it.
1104 computeLTOCacheKey(Key
, Conf
, CombinedIndex
, ModuleID
, ImportList
,
1105 ExportList
, ResolvedODR
, DefinedGlobals
, CfiFunctionDefs
,
1107 if (AddStreamFn CacheAddStream
= Cache(Task
, Key
))
1108 return RunThinBackend(CacheAddStream
);
1110 return Error::success();
1114 unsigned Task
, BitcodeModule BM
,
1115 const FunctionImporter::ImportMapTy
&ImportList
,
1116 const FunctionImporter::ExportSetTy
&ExportList
,
1117 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
1118 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) override
{
1119 StringRef ModulePath
= BM
.getModuleIdentifier();
1120 assert(ModuleToDefinedGVSummaries
.count(ModulePath
));
1121 const GVSummaryMapTy
&DefinedGlobals
=
1122 ModuleToDefinedGVSummaries
.find(ModulePath
)->second
;
1123 BackendThreadPool
.async(
1124 [=](BitcodeModule BM
, ModuleSummaryIndex
&CombinedIndex
,
1125 const FunctionImporter::ImportMapTy
&ImportList
,
1126 const FunctionImporter::ExportSetTy
&ExportList
,
1127 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
>
1129 const GVSummaryMapTy
&DefinedGlobals
,
1130 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) {
1131 Error E
= runThinLTOBackendThread(
1132 AddStream
, Cache
, Task
, BM
, CombinedIndex
, ImportList
, ExportList
,
1133 ResolvedODR
, DefinedGlobals
, ModuleMap
);
1135 std::unique_lock
<std::mutex
> L(ErrMu
);
1137 Err
= joinErrors(std::move(*Err
), std::move(E
));
1142 BM
, std::ref(CombinedIndex
), std::ref(ImportList
), std::ref(ExportList
),
1143 std::ref(ResolvedODR
), std::ref(DefinedGlobals
), std::ref(ModuleMap
));
1144 return Error::success();
1147 Error
wait() override
{
1148 BackendThreadPool
.wait();
1150 return std::move(*Err
);
1152 return Error::success();
1155 } // end anonymous namespace
1157 ThinBackend
lto::createInProcessThinBackend(unsigned ParallelismLevel
) {
1158 return [=](Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1159 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
,
1160 AddStreamFn AddStream
, NativeObjectCache Cache
) {
1161 return std::make_unique
<InProcessThinBackend
>(
1162 Conf
, CombinedIndex
, ParallelismLevel
, ModuleToDefinedGVSummaries
,
1167 // Given the original \p Path to an output file, replace any path
1168 // prefix matching \p OldPrefix with \p NewPrefix. Also, create the
1169 // resulting directory if it does not yet exist.
1170 std::string
lto::getThinLTOOutputFile(const std::string
&Path
,
1171 const std::string
&OldPrefix
,
1172 const std::string
&NewPrefix
) {
1173 if (OldPrefix
.empty() && NewPrefix
.empty())
1175 SmallString
<128> NewPath(Path
);
1176 llvm::sys::path::replace_path_prefix(NewPath
, OldPrefix
, NewPrefix
);
1177 StringRef ParentPath
= llvm::sys::path::parent_path(NewPath
.str());
1178 if (!ParentPath
.empty()) {
1179 // Make sure the new directory exists, creating it if necessary.
1180 if (std::error_code EC
= llvm::sys::fs::create_directories(ParentPath
))
1181 llvm::errs() << "warning: could not create directory '" << ParentPath
1182 << "': " << EC
.message() << '\n';
1184 return NewPath
.str();
1188 class WriteIndexesThinBackend
: public ThinBackendProc
{
1189 std::string OldPrefix
, NewPrefix
;
1190 bool ShouldEmitImportsFiles
;
1191 raw_fd_ostream
*LinkedObjectsFile
;
1192 lto::IndexWriteCallback OnWrite
;
1195 WriteIndexesThinBackend(
1196 Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1197 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
,
1198 std::string OldPrefix
, std::string NewPrefix
, bool ShouldEmitImportsFiles
,
1199 raw_fd_ostream
*LinkedObjectsFile
, lto::IndexWriteCallback OnWrite
)
1200 : ThinBackendProc(Conf
, CombinedIndex
, ModuleToDefinedGVSummaries
),
1201 OldPrefix(OldPrefix
), NewPrefix(NewPrefix
),
1202 ShouldEmitImportsFiles(ShouldEmitImportsFiles
),
1203 LinkedObjectsFile(LinkedObjectsFile
), OnWrite(OnWrite
) {}
1206 unsigned Task
, BitcodeModule BM
,
1207 const FunctionImporter::ImportMapTy
&ImportList
,
1208 const FunctionImporter::ExportSetTy
&ExportList
,
1209 const std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
> &ResolvedODR
,
1210 MapVector
<StringRef
, BitcodeModule
> &ModuleMap
) override
{
1211 StringRef ModulePath
= BM
.getModuleIdentifier();
1212 std::string NewModulePath
=
1213 getThinLTOOutputFile(ModulePath
, OldPrefix
, NewPrefix
);
1215 if (LinkedObjectsFile
)
1216 *LinkedObjectsFile
<< NewModulePath
<< '\n';
1218 std::map
<std::string
, GVSummaryMapTy
> ModuleToSummariesForIndex
;
1219 gatherImportedSummariesForModule(ModulePath
, ModuleToDefinedGVSummaries
,
1220 ImportList
, ModuleToSummariesForIndex
);
1223 raw_fd_ostream
OS(NewModulePath
+ ".thinlto.bc", EC
,
1224 sys::fs::OpenFlags::OF_None
);
1226 return errorCodeToError(EC
);
1227 WriteIndexToFile(CombinedIndex
, OS
, &ModuleToSummariesForIndex
);
1229 if (ShouldEmitImportsFiles
) {
1230 EC
= EmitImportsFiles(ModulePath
, NewModulePath
+ ".imports",
1231 ModuleToSummariesForIndex
);
1233 return errorCodeToError(EC
);
1237 OnWrite(ModulePath
);
1238 return Error::success();
1241 Error
wait() override
{ return Error::success(); }
1243 } // end anonymous namespace
1245 ThinBackend
lto::createWriteIndexesThinBackend(
1246 std::string OldPrefix
, std::string NewPrefix
, bool ShouldEmitImportsFiles
,
1247 raw_fd_ostream
*LinkedObjectsFile
, IndexWriteCallback OnWrite
) {
1248 return [=](Config
&Conf
, ModuleSummaryIndex
&CombinedIndex
,
1249 const StringMap
<GVSummaryMapTy
> &ModuleToDefinedGVSummaries
,
1250 AddStreamFn AddStream
, NativeObjectCache Cache
) {
1251 return std::make_unique
<WriteIndexesThinBackend
>(
1252 Conf
, CombinedIndex
, ModuleToDefinedGVSummaries
, OldPrefix
, NewPrefix
,
1253 ShouldEmitImportsFiles
, LinkedObjectsFile
, OnWrite
);
1257 Error
LTO::runThinLTO(AddStreamFn AddStream
, NativeObjectCache Cache
,
1258 const DenseSet
<GlobalValue::GUID
> &GUIDPreservedSymbols
) {
1259 if (ThinLTO
.ModuleMap
.empty())
1260 return Error::success();
1262 if (Conf
.CombinedIndexHook
&& !Conf
.CombinedIndexHook(ThinLTO
.CombinedIndex
))
1263 return Error::success();
1265 // Collect for each module the list of function it defines (GUID ->
1267 StringMap
<GVSummaryMapTy
>
1268 ModuleToDefinedGVSummaries(ThinLTO
.ModuleMap
.size());
1269 ThinLTO
.CombinedIndex
.collectDefinedGVSummariesPerModule(
1270 ModuleToDefinedGVSummaries
);
1271 // Create entries for any modules that didn't have any GV summaries
1272 // (either they didn't have any GVs to start with, or we suppressed
1273 // generation of the summaries because they e.g. had inline assembly
1274 // uses that couldn't be promoted/renamed on export). This is so
1275 // InProcessThinBackend::start can still launch a backend thread, which
1276 // is passed the map of summaries for the module, without any special
1277 // handling for this case.
1278 for (auto &Mod
: ThinLTO
.ModuleMap
)
1279 if (!ModuleToDefinedGVSummaries
.count(Mod
.first
))
1280 ModuleToDefinedGVSummaries
.try_emplace(Mod
.first
);
1282 // Synthesize entry counts for functions in the CombinedIndex.
1283 computeSyntheticCounts(ThinLTO
.CombinedIndex
);
1285 StringMap
<FunctionImporter::ImportMapTy
> ImportLists(
1286 ThinLTO
.ModuleMap
.size());
1287 StringMap
<FunctionImporter::ExportSetTy
> ExportLists(
1288 ThinLTO
.ModuleMap
.size());
1289 StringMap
<std::map
<GlobalValue::GUID
, GlobalValue::LinkageTypes
>> ResolvedODR
;
1292 ThinLTO
.CombinedIndex
.dumpSCCs(outs());
1294 std::set
<GlobalValue::GUID
> ExportedGUIDs
;
1296 // Perform index-based WPD. This will return immediately if there are
1297 // no index entries in the typeIdMetadata map (e.g. if we are instead
1298 // performing IR-based WPD in hybrid regular/thin LTO mode).
1299 std::map
<ValueInfo
, std::vector
<VTableSlotSummary
>> LocalWPDTargetsMap
;
1300 runWholeProgramDevirtOnIndex(ThinLTO
.CombinedIndex
, ExportedGUIDs
,
1301 LocalWPDTargetsMap
);
1303 if (Conf
.OptLevel
> 0)
1304 ComputeCrossModuleImport(ThinLTO
.CombinedIndex
, ModuleToDefinedGVSummaries
,
1305 ImportLists
, ExportLists
);
1307 // Figure out which symbols need to be internalized. This also needs to happen
1308 // at -O0 because summary-based DCE is implemented using internalization, and
1309 // we must apply DCE consistently with the full LTO module in order to avoid
1310 // undefined references during the final link.
1311 for (auto &Res
: GlobalResolutions
) {
1312 // If the symbol does not have external references or it is not prevailing,
1313 // then not need to mark it as exported from a ThinLTO partition.
1314 if (Res
.second
.Partition
!= GlobalResolution::External
||
1315 !Res
.second
.isPrevailingIRSymbol())
1317 auto GUID
= GlobalValue::getGUID(
1318 GlobalValue::dropLLVMManglingEscape(Res
.second
.IRName
));
1319 // Mark exported unless index-based analysis determined it to be dead.
1320 if (ThinLTO
.CombinedIndex
.isGUIDLive(GUID
))
1321 ExportedGUIDs
.insert(GUID
);
1324 // Any functions referenced by the jump table in the regular LTO object must
1326 for (auto &Def
: ThinLTO
.CombinedIndex
.cfiFunctionDefs())
1327 ExportedGUIDs
.insert(
1328 GlobalValue::getGUID(GlobalValue::dropLLVMManglingEscape(Def
)));
1330 auto isExported
= [&](StringRef ModuleIdentifier
, GlobalValue::GUID GUID
) {
1331 const auto &ExportList
= ExportLists
.find(ModuleIdentifier
);
1332 return (ExportList
!= ExportLists
.end() &&
1333 ExportList
->second
.count(GUID
)) ||
1334 ExportedGUIDs
.count(GUID
);
1337 // Update local devirtualized targets that were exported by cross-module
1338 // importing or by other devirtualizations marked in the ExportedGUIDs set.
1339 updateIndexWPDForExports(ThinLTO
.CombinedIndex
, isExported
,
1340 LocalWPDTargetsMap
);
1342 auto isPrevailing
= [&](GlobalValue::GUID GUID
,
1343 const GlobalValueSummary
*S
) {
1344 return ThinLTO
.PrevailingModuleForGUID
[GUID
] == S
->modulePath();
1346 thinLTOInternalizeAndPromoteInIndex(ThinLTO
.CombinedIndex
, isExported
,
1349 auto recordNewLinkage
= [&](StringRef ModuleIdentifier
,
1350 GlobalValue::GUID GUID
,
1351 GlobalValue::LinkageTypes NewLinkage
) {
1352 ResolvedODR
[ModuleIdentifier
][GUID
] = NewLinkage
;
1354 thinLTOResolvePrevailingInIndex(ThinLTO
.CombinedIndex
, isPrevailing
,
1355 recordNewLinkage
, GUIDPreservedSymbols
);
1357 std::unique_ptr
<ThinBackendProc
> BackendProc
=
1358 ThinLTO
.Backend(Conf
, ThinLTO
.CombinedIndex
, ModuleToDefinedGVSummaries
,
1361 // Tasks 0 through ParallelCodeGenParallelismLevel-1 are reserved for combined
1362 // module and parallel code generation partitions.
1363 unsigned Task
= RegularLTO
.ParallelCodeGenParallelismLevel
;
1364 for (auto &Mod
: ThinLTO
.ModuleMap
) {
1365 if (Error E
= BackendProc
->start(Task
, Mod
.second
, ImportLists
[Mod
.first
],
1366 ExportLists
[Mod
.first
],
1367 ResolvedODR
[Mod
.first
], ThinLTO
.ModuleMap
))
1372 return BackendProc
->wait();
1375 Expected
<std::unique_ptr
<ToolOutputFile
>>
1376 lto::setupOptimizationRemarks(LLVMContext
&Context
, StringRef RemarksFilename
,
1377 StringRef RemarksPasses
, StringRef RemarksFormat
,
1378 bool RemarksWithHotness
, int Count
) {
1379 std::string Filename
= RemarksFilename
;
1380 if (!Filename
.empty() && Count
!= -1)
1381 Filename
+= ".thin." + llvm::utostr(Count
) + ".yaml";
1383 auto ResultOrErr
= llvm::setupOptimizationRemarks(
1384 Context
, Filename
, RemarksPasses
, RemarksFormat
, RemarksWithHotness
);
1385 if (Error E
= ResultOrErr
.takeError())
1386 return std::move(E
);
1389 (*ResultOrErr
)->keep();
1394 Expected
<std::unique_ptr
<ToolOutputFile
>>
1395 lto::setupStatsFile(StringRef StatsFilename
) {
1396 // Setup output file to emit statistics.
1397 if (StatsFilename
.empty())
1400 llvm::EnableStatistics(false);
1403 std::make_unique
<ToolOutputFile
>(StatsFilename
, EC
, sys::fs::OF_None
);
1405 return errorCodeToError(EC
);
1408 return std::move(StatsFile
);