LLVM: llvm::lto Namespace Reference (original) (raw)

◆ ImportsFilesContainer

◆ IndexWriteCallback

using llvm::lto::IndexWriteCallback = std::function<void(const std::string &)>

Definition at line 199 of file LTO.h.

◆ ThinBackendFunction

Initial value:

std::function<std::unique_ptr(

Class to hold module path string table and global value map, and encapsulate methods for operating on...

@ C

The default llvm calling convention, compatible with C.

std::function< Expected< std::unique_ptr< CachedFileStream > >( unsigned Task, const Twine &ModuleName)> AddStreamFn

This type defines the callback to add a file that is generated on the fly.

This type represents a file cache system that manages caching of files.

This callable defines the behavior of a ThinLTO backend after the thin-link phase.

It accepts a configuration C, a combined module summary index CombinedIndex, a map of module identifiers to global variable summaries ModuleToDefinedGVSummaries, a function to add output streams AddStream, and a file cache Cache. It returns a unique pointer to a ThinBackendProc, which can be used to launch backends in parallel.

Definition at line 264 of file LTO.h.

◆ backend()

Runs a regular LTO backend.

The regular LTO backend can also act as the regular LTO phase of ThinLTO, which may need to access the combined index.

Definition at line 559 of file LTOBackend.cpp.

References llvm::CallingConv::C, createTargetMachine(), llvm::dbgs(), initAndLookupTarget(), LLVM_DEBUG, llvm::Mod, opt(), splitCodeGen(), llvm::Error::success(), and llvm::Expected< T >::takeError().

◆ createInProcessThinBackend()

This ThinBackend runs the individual backend jobs in-process.

The default value means to use one job per hardware core (not hyper-thread). OnWrite is callback which receives module identifier and notifies LTO user that index file for the module (and optionally imports file) was created. ShouldEmitIndexFiles being true will write sharded ThinLTO index files to the same path as the input module, with suffix ".thinlto.bc" ShouldEmitImportsFiles is true it also writes a list of imported files to a similar path with ".imports" appended instead.

Definition at line 1759 of file LTO.cpp.

◆ createOutOfProcessThinBackend()

This ThinBackend generates the index shards and then runs the individual backend jobs via an external process.

It takes the same parameters as the InProcessThinBackend; however, these parameters only control the behavior when generating the index files for the modules. Additionally: LinkerOutputFile is a string that should identify this LTO invocation in the context of a wider build. It's used for naming to aid the user in identifying activity related to a specific LTO invocation. Distributor specifies the path to a process to invoke to manage the backend job execution. DistributorArgs specifies a list of arguments to be applied to the distributor. RemoteCompiler specifies the path to a Clang executable to be invoked for the backend jobs. RemoteCompilerPrependArgs specifies a list of prepend arguments to be applied to the backend compilations. RemoteCompilerArgs specifies a list of arguments to be applied to the backend compilations. SaveTemps is a debugging tool that prevents temporary files created by this backend from being cleaned up.

Definition at line 2612 of file LTO.cpp.

◆ createWriteIndexesThinBackend()

This ThinBackend writes individual module indexes to files, instead of running the individual backend jobs.

This backend is for distributed builds where separate processes will invoke the real backends.

To find the path to write the index to, the backend checks if the path has a prefix of OldPrefix; if so, it replaces that prefix with NewPrefix. It then appends ".thinlto.bc" and writes the index to that path. If ShouldEmitImportsFiles is true it also writes a list of imported files to a similar path with ".imports" appended instead. LinkedObjectsFile is an output stream to write the list of object files for the final ThinLTO linking. Can be nullptr. If LinkedObjectsFile is not nullptr and NativeObjectPrefix is not empty then it replaces the prefix of the objects with NativeObjectPrefix instead of NewPrefix. OnWrite is callback which receives module identifier and notifies LTO user that index file for the module (and optionally imports file) was created.

Definition at line 1879 of file LTO.cpp.

◆ finalizeOptimizationRemarks()

◆ findThinLTOModule() [1/2]

◆ findThinLTOModule() [2/2]

◆ generateModulesOrdering()

◆ getThinLTODefaultCPU()

◆ getThinLTOOutputFile()

◆ initImportList()

◆ opt()

Runs middle-end LTO optimizations on Mod.

Definition at line 365 of file LTOBackend.cpp.

References llvm::dbgs(), EmbedBitcode, llvm::embedBitcodeInModule(), EmbedPostMergePreOptimized, isEmptyModule(), LLVM_DEBUG, llvm::Mod, llvm::lto::Config::OptLevel, llvm::lto::Config::PostOptModuleHook, and runNewPMPasses().

Referenced by backend(), and thinBackend().

◆ setupLLVMOptimizationRemarks()

◆ setupStatsFile()

◆ thinBackend()

Runs a ThinLTO backend.

If ModuleMap is not nullptr, all the module files to be imported have already been mapped to memory and the corresponding BitcodeModule objects are saved in the ModuleMap. If ModuleMap is nullptr, module files will be mapped to memory on demand and at any given time during importing, only one source module will be kept open at the most. If CodeGenOnly is true, the backend will skip optimization and only perform code generation. If IRAddStream is not nullptr, it will be called just before code generation to serialize the optimized IR.

Definition at line 608 of file LTOBackend.cpp.

References assert(), createTargetMachine(), llvm::dbgs(), llvm::PIELevel::Default, dropDeadSymbols(), llvm::DenseMapBase< DerivedT, KeyT, ValueT, KeyInfoT, BucketT >::empty(), llvm::MapVector< KeyT, ValueT, MapType, VectorType >::end(), finalizeOptimizationRemarks(), llvm::MapVector< KeyT, ValueT, MapType, VectorType >::find(), findThinLTOModule(), llvm::ErrorOr< T >::getError(), llvm::MemoryBuffer::getFile(), I, llvm::FunctionImporter::importFunctions(), llvm::inconvertibleErrorCode(), initAndLookupTarget(), LLVM_DEBUG, llvm::make_error(), llvm::Mod, opt(), llvm::lto::Config::PostImportModuleHook, llvm::lto::Config::PostInternalizeModuleHook, llvm::lto::Config::PostPromoteModuleHook, llvm::lto::Config::PreOptModuleHook, llvm::lto::Config::RemarksFilename, llvm::lto::Config::RemarksFormat, llvm::lto::Config::RemarksHotnessThreshold, llvm::lto::Config::RemarksPasses, llvm::lto::Config::RemarksWithHotness, llvm::renameModuleForThinLTO(), llvm::cgdata::saveModuleForTwoRounds(), setupLLVMOptimizationRemarks(), llvm::Reloc::Static, llvm::Expected< T >::takeError(), ThinLTOAssumeMerged, llvm::thinLTOFinalizeInModule(), llvm::thinLTOInternalizeModule(), llvm::toString(), llvm::updatePublicTypeTestCalls(), and llvm::ModuleSummaryIndex::withWholeProgramVisibility().