LLVM 19.0.0git
Go to the documentation of this file.
1//===-LTOBackend.h - LLVM Link Time Optimizer Backend ---------------------===//
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
9// This file implements the "backend" phase of LTO, i.e. it performs
10// optimization and code generation on a loaded module. It is generally used
11// internally by the LTO class but can also be used independently, for example
12// to implement a standalone ThinLTO backend.
19#include "llvm/ADT/MapVector.h"
22#include "llvm/LTO/LTO.h"
27namespace llvm {
29class BitcodeModule;
30class Error;
31class Module;
32class Target;
34namespace lto {
36/// Runs middle-end LTO optimizations on \p Mod.
37bool opt(const Config &Conf, TargetMachine *TM, unsigned Task, Module &Mod,
38 bool IsThinLTO, ModuleSummaryIndex *ExportSummary,
39 const ModuleSummaryIndex *ImportSummary,
40 const std::vector<uint8_t> &CmdArgs);
42/// Runs a regular LTO backend. The regular LTO backend can also act as the
43/// regular LTO phase of ThinLTO, which may need to access the combined index.
44Error backend(const Config &C, AddStreamFn AddStream,
45 unsigned ParallelCodeGenParallelismLevel, Module &M,
46 ModuleSummaryIndex &CombinedIndex);
48/// Runs a ThinLTO backend.
49/// If \p ModuleMap is not nullptr, all the module files to be imported have
50/// already been mapped to memory and the corresponding BitcodeModule objects
51/// are saved in the ModuleMap. If \p ModuleMap is nullptr, module files will
52/// be mapped to memory on demand and at any given time during importing, only
53/// one source module will be kept open at the most.
54Error thinBackend(const Config &C, unsigned Task, AddStreamFn AddStream,
55 Module &M, const ModuleSummaryIndex &CombinedIndex,
56 const FunctionImporter::ImportMapTy &ImportList,
57 const GVSummaryMapTy &DefinedGlobals,
58 MapVector<StringRef, BitcodeModule> *ModuleMap,
59 const std::vector<uint8_t> &CmdArgs = std::vector<uint8_t>());
62 std::unique_ptr<ToolOutputFile> DiagOutputFile);
64/// Returns the BitcodeModule that is ThinLTO.
65BitcodeModule *findThinLTOModule(MutableArrayRef<BitcodeModule> BMs);
67/// Variant of the above.
68Expected<BitcodeModule> findThinLTOModule(MemoryBufferRef MBRef);
70/// Distributed ThinLTO: collect the referenced modules based on
71/// module summary and initialize ImportList. Returns false if the
72/// operation failed.
73bool initImportList(const Module &M, const ModuleSummaryIndex &CombinedIndex,
arm prera ldst opt
Machine Check Debug Module
This file implements a map that provides insertion order iteration.
ModuleSummaryIndex.h This file contains the declarations the classes that hold the module index and s...
const char LLVMTargetMachineRef TM
DenseMap< StringRef, FunctionsToImportTy > ImportMapTy
The map contains an entry for every module to import from, the key being the module identifier to pas...
@ C
The default llvm calling convention, compatible with C.
Definition: CallingConv.h:34
Error thinBackend(const Config &C, unsigned Task, AddStreamFn AddStream, Module &M, const ModuleSummaryIndex &CombinedIndex, const FunctionImporter::ImportMapTy &ImportList, const GVSummaryMapTy &DefinedGlobals, MapVector< StringRef, BitcodeModule > *ModuleMap, const std::vector< uint8_t > &CmdArgs=std::vector< uint8_t >())
Runs a ThinLTO backend.
Definition: LTOBackend.cpp:553
BitcodeModule * findThinLTOModule(MutableArrayRef< BitcodeModule > BMs)
Returns the BitcodeModule that is ThinLTO.
Definition: LTOBackend.cpp:673
Error backend(const Config &C, AddStreamFn AddStream, unsigned ParallelCodeGenParallelismLevel, Module &M, ModuleSummaryIndex &CombinedIndex)
Runs a regular LTO backend.
Definition: LTOBackend.cpp:506
Error finalizeOptimizationRemarks(std::unique_ptr< ToolOutputFile > DiagOutputFile)
Definition: LTOBackend.cpp:495
bool initImportList(const Module &M, const ModuleSummaryIndex &CombinedIndex, FunctionImporter::ImportMapTy &ImportList)
Distributed ThinLTO: collect the referenced modules based on module summary and initialize ImportList...
Definition: LTOBackend.cpp:699
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18
std::function< Expected< std::unique_ptr< CachedFileStream > >(unsigned Task, const Twine &ModuleName)> AddStreamFn
This type defines the callback to add a file that is generated on the fly.
Definition: Caching.h:42
@ Mod
The access may modify the value stored in memory.
DenseMap< GlobalValue::GUID, GlobalValueSummary * > GVSummaryMapTy
Map of global value GUID to its summary, used to identify values defined in a particular module,...