LLVM  13.0.0git
Public Member Functions | Protected Member Functions | List of all members
llvm::LLVMTargetMachine Class Reference

This class describes a target machine that is implemented with the LLVM target-independent code generator. More...

#include "llvm/Target/TargetMachine.h"

Inheritance diagram for llvm::LLVMTargetMachine:
Inheritance graph
[legend]
Collaboration diagram for llvm::LLVMTargetMachine:
Collaboration graph
[legend]

Public Member Functions

TargetTransformInfo getTargetTransformInfo (const Function &F) override
 Get a TargetTransformInfo implementation for the target. More...
 
virtual TargetPassConfigcreatePassConfig (PassManagerBase &PM)
 Create a pass configuration object to be used by addPassToEmitX methods for generating a pipeline of CodeGen passes. More...
 
bool addPassesToEmitFile (PassManagerBase &PM, raw_pwrite_stream &Out, raw_pwrite_stream *DwoOut, CodeGenFileType FileType, bool DisableVerify=true, MachineModuleInfoWrapperPass *MMIWP=nullptr) override
 Add passes to the specified pass manager to get the specified file emitted. More...
 
virtual Error buildCodeGenPipeline (ModulePassManager &, MachineFunctionPassManager &, MachineFunctionAnalysisManager &, raw_pwrite_stream &, raw_pwrite_stream *, CodeGenFileType, CGPassBuilderOption, PassInstrumentationCallbacks *)
 
virtual std::pair< StringRef, bool > getPassNameFromLegacyName (StringRef)
 
bool addPassesToEmitMC (PassManagerBase &PM, MCContext *&Ctx, raw_pwrite_stream &Out, bool DisableVerify=true) override
 Add passes to the specified pass manager to get machine code emitted with the MCJIT. More...
 
virtual bool isMachineVerifierClean () const
 Returns true if the target is expected to pass all machine verifier checks. More...
 
bool addAsmPrinter (PassManagerBase &PM, raw_pwrite_stream &Out, raw_pwrite_stream *DwoOut, CodeGenFileType FileType, MCContext &Context)
 Adds an AsmPrinter pass to the pipeline that prints assembly or machine code from the MI representation. More...
 
Expected< std::unique_ptr< MCStreamer > > createMCStreamer (raw_pwrite_stream &Out, raw_pwrite_stream *DwoOut, CodeGenFileType FileType, MCContext &Ctx)
 
virtual bool usesPhysRegsForValues () const
 True if the target uses physical regs (as nearly all targets do). More...
 
virtual bool useIPRA () const
 True if the target wants to use interprocedural register allocation by default. More...
 
- Public Member Functions inherited from llvm::TargetMachine
 TargetMachine (const TargetMachine &)=delete
 
void operator= (const TargetMachine &)=delete
 
virtual ~TargetMachine ()
 
const TargetgetTarget () const
 
const TriplegetTargetTriple () const
 
StringRef getTargetCPU () const
 
StringRef getTargetFeatureString () const
 
void setTargetFeatureString (StringRef FS)
 
virtual const TargetSubtargetInfogetSubtargetImpl (const Function &) const
 Virtual method implemented by subclasses that returns a reference to that target's TargetSubtargetInfo-derived member variable. More...
 
virtual TargetLoweringObjectFilegetObjFileLowering () const
 
virtual yaml::MachineFunctionInfocreateDefaultFuncInfoYAML () const
 Allocate and return a default initialized instance of the YAML representation for the MachineFunctionInfo. More...
 
virtual yaml::MachineFunctionInfoconvertFuncInfoToYAML (const MachineFunction &MF) const
 Allocate and initialize an instance of the YAML representation of the MachineFunctionInfo. More...
 
virtual bool parseMachineFunctionInfo (const yaml::MachineFunctionInfo &, PerFunctionMIParsingState &PFS, SMDiagnostic &Error, SMRange &SourceRange) const
 Parse out the target's MachineFunctionInfo from the YAML reprsentation. More...
 
template<typename STC >
const STC & getSubtarget (const Function &F) const
 This method returns a pointer to the specified type of TargetSubtargetInfo. More...
 
const DataLayout createDataLayout () const
 Create a DataLayout. More...
 
bool isCompatibleDataLayout (const DataLayout &Candidate) const
 Test if a DataLayout if compatible with the CodeGen for this target. More...
 
unsigned getPointerSize (unsigned AS) const
 Get the pointer size for this target. More...
 
unsigned getPointerSizeInBits (unsigned AS) const
 
unsigned getProgramPointerSize () const
 
unsigned getAllocaPointerSize () const
 
void resetTargetOptions (const Function &F) const
 Reset the target options based on the function's attributes. More...
 
const MCAsmInfogetMCAsmInfo () const
 Return target specific asm information. More...
 
const MCRegisterInfogetMCRegisterInfo () const
 
const MCInstrInfogetMCInstrInfo () const
 
const MCSubtargetInfogetMCSubtargetInfo () const
 
virtual const TargetIntrinsicInfogetIntrinsicInfo () const
 If intrinsic information is available, return it. If not, return null. More...
 
bool requiresStructuredCFG () const
 
void setRequiresStructuredCFG (bool Value)
 
Reloc::Model getRelocationModel () const
 Returns the code generation relocation model. More...
 
CodeModel::Model getCodeModel () const
 Returns the code model. More...
 
bool isPositionIndependent () const
 
bool shouldAssumeDSOLocal (const Module &M, const GlobalValue *GV) const
 
bool useEmulatedTLS () const
 Returns true if this target uses emulated TLS. More...
 
TLSModel::Model getTLSModel (const GlobalValue *GV) const
 Returns the TLS model which should be used for the given global variable. More...
 
CodeGenOpt::Level getOptLevel () const
 Returns the optimization level: None, Less, Default, or Aggressive. More...
 
void setOptLevel (CodeGenOpt::Level Level)
 Overrides the optimization level. More...
 
void setFastISel (bool Enable)
 
bool getO0WantsFastISel ()
 
void setO0WantsFastISel (bool Enable)
 
void setGlobalISel (bool Enable)
 
void setGlobalISelAbort (GlobalISelAbortMode Mode)
 
void setMachineOutliner (bool Enable)
 
void setSupportsDefaultOutlining (bool Enable)
 
void setSupportsDebugEntryValues (bool Enable)
 
bool getAIXExtendedAltivecABI () const
 
bool getUniqueSectionNames () const
 
bool getUniqueBasicBlockSectionNames () const
 Return true if unique basic block section names must be generated. More...
 
bool getDataSections () const
 Return true if data objects should be emitted into their own section, corresponds to -fdata-sections. More...
 
bool getFunctionSections () const
 Return true if functions should be emitted into their own section, corresponding to -ffunction-sections. More...
 
bool getIgnoreXCOFFVisibility () const
 Return true if visibility attribute should not be emitted in XCOFF, corresponding to -mignore-xcoff-visibility. More...
 
bool getXCOFFTracebackTable () const
 Return true if XCOFF traceback table should be emitted, corresponding to -xcoff-traceback-table. More...
 
llvm::BasicBlockSection getBBSectionsType () const
 If basic blocks should be emitted into their own section, corresponding to -fbasic-block-sections. More...
 
const MemoryBuffergetBBSectionsFuncListBuf () const
 Get the list of functions and basic block ids that need unique sections. More...
 
virtual bool isNoopAddrSpaceCast (unsigned SrcAS, unsigned DestAS) const
 Returns true if a cast between SrcAS and DestAS is a noop. More...
 
virtual unsigned getAssumedAddrSpace (const Value *V) const
 If the specified generic pointer could be assumed as a pointer to a specific address space, return that address space. More...
 
TargetIRAnalysis getTargetIRAnalysis ()
 Get a TargetIRAnalysis appropriate for the target. More...
 
virtual void adjustPassManager (PassManagerBuilder &)
 Allow the target to modify the pass manager, e.g. More...
 
virtual void registerPassBuilderCallbacks (PassBuilder &, bool DebugPassManager)
 Allow the target to modify the pass pipeline with New Pass Manager (similar to adjustPassManager for Legacy Pass manager). More...
 
virtual void registerDefaultAliasAnalyses (AAManager &)
 Allow the target to register alias analyses with the AAManager for use with the new pass manager. More...
 
virtual bool targetSchedulesPostRAScheduling () const
 True if subtarget inserts the final scheduling pass on its own. More...
 
void getNameWithPrefix (SmallVectorImpl< char > &Name, const GlobalValue *GV, Mangler &Mang, bool MayAlwaysUsePrivate=false) const
 
MCSymbolgetSymbol (const GlobalValue *GV) const
 
virtual unsigned getSjLjDataSize () const
 

Protected Member Functions

 LLVMTargetMachine (const Target &T, StringRef DataLayoutString, const Triple &TT, StringRef CPU, StringRef FS, const TargetOptions &Options, Reloc::Model RM, CodeModel::Model CM, CodeGenOpt::Level OL)
 
void initAsmInfo ()
 
- Protected Member Functions inherited from llvm::TargetMachine
 TargetMachine (const Target &T, StringRef DataLayoutString, const Triple &TargetTriple, StringRef CPU, StringRef FS, const TargetOptions &Options)
 

Additional Inherited Members

- Static Public Member Functions inherited from llvm::TargetMachine
static std::pair< int, intparseBinutilsVersion (StringRef Version)
 
- Public Attributes inherited from llvm::TargetMachine
const TargetOptions DefaultOptions
 
TargetOptions Options
 
- Static Public Attributes inherited from llvm::TargetMachine
static constexpr unsigned DefaultSjLjDataSize = 32
 The integer bit size to use for SjLj based exception handling. More...
 
- Protected Attributes inherited from llvm::TargetMachine
const TargetTheTarget
 The Target that this machine was created for. More...
 
const DataLayout DL
 DataLayout for the target: keep ABI type size and alignment. More...
 
Triple TargetTriple
 Triple string, CPU name, and target feature strings the TargetMachine instance is created with. More...
 
std::string TargetCPU
 
std::string TargetFS
 
Reloc::Model RM = Reloc::Static
 
CodeModel::Model CMModel = CodeModel::Small
 
CodeGenOpt::Level OptLevel = CodeGenOpt::Default
 
std::unique_ptr< const MCAsmInfoAsmInfo
 Contains target specific asm information. More...
 
std::unique_ptr< const MCRegisterInfoMRI
 
std::unique_ptr< const MCInstrInfoMII
 
std::unique_ptr< const MCSubtargetInfoSTI
 
unsigned RequireStructuredCFG: 1
 
unsigned O0WantsFastISel: 1
 

Detailed Description

This class describes a target machine that is implemented with the LLVM target-independent code generator.

Definition at line 386 of file TargetMachine.h.

Constructor & Destructor Documentation

◆ LLVMTargetMachine()

LLVMTargetMachine::LLVMTargetMachine ( const Target T,
StringRef  DataLayoutString,
const Triple TT,
StringRef  CPU,
StringRef  FS,
const TargetOptions Options,
Reloc::Model  RM,
CodeModel::Model  CM,
CodeGenOpt::Level  OL 
)
protected

Member Function Documentation

◆ addAsmPrinter()

bool LLVMTargetMachine::addAsmPrinter ( PassManagerBase PM,
raw_pwrite_stream Out,
raw_pwrite_stream DwoOut,
CodeGenFileType  FileType,
MCContext Context 
)

Adds an AsmPrinter pass to the pipeline that prints assembly or machine code from the MI representation.

Definition at line 122 of file LLVMTargetMachine.cpp.

References Context, and createMCStreamer().

Referenced by addPassesToEmitFile().

◆ addPassesToEmitFile()

bool LLVMTargetMachine::addPassesToEmitFile ( PassManagerBase PM,
raw_pwrite_stream Out,
raw_pwrite_stream DwoOut,
CodeGenFileType  FileType,
bool  DisableVerify = true,
MachineModuleInfoWrapperPass MMIWP = nullptr 
)
overridevirtual

Add passes to the specified pass manager to get the specified file emitted.

Typically this will involve several steps of code generation. MMIWP is an optional parameter that, if set to non-nullptr, will be used to set the MachineModuloInfo for this PM.

Reimplemented from llvm::TargetMachine.

Definition at line 208 of file LLVMTargetMachine.cpp.

References llvm::legacy::PassManagerBase::add(), addAsmPrinter(), addPassesToGenerateCode(), llvm::CGFT_Null, llvm::createFreeMachineFunctionPass(), llvm::createPrintMIRPass(), llvm::MachineModuleInfo::getContext(), llvm::MachineModuleInfoWrapperPass::getMMI(), and llvm::TargetPassConfig::willCompleteCodeGenPipeline().

◆ addPassesToEmitMC()

bool LLVMTargetMachine::addPassesToEmitMC ( PassManagerBase PM,
MCContext *&  Ctx,
raw_pwrite_stream Out,
bool  DisableVerify = true 
)
overridevirtual

◆ buildCodeGenPipeline()

virtual Error llvm::LLVMTargetMachine::buildCodeGenPipeline ( ModulePassManager ,
MachineFunctionPassManager ,
MachineFunctionAnalysisManager ,
raw_pwrite_stream ,
raw_pwrite_stream ,
CodeGenFileType  ,
CGPassBuilderOption  ,
PassInstrumentationCallbacks  
)
inlinevirtual

Definition at line 416 of file TargetMachine.h.

References llvm::inconvertibleErrorCode().

◆ createMCStreamer()

Expected< std::unique_ptr< MCStreamer > > LLVMTargetMachine::createMCStreamer ( raw_pwrite_stream Out,
raw_pwrite_stream DwoOut,
CodeGenFileType  FileType,
MCContext Ctx 
)

◆ createPassConfig()

TargetPassConfig * LLVMTargetMachine::createPassConfig ( PassManagerBase PM)
virtual

Create a pass configuration object to be used by addPassToEmitX methods for generating a pipeline of CodeGen passes.

createPassConfig - Create a pass configuration object to be used by addPassToEmitX methods for generating a pipeline of CodeGen passes.

Targets may override this to extend TargetPassConfig.

Reimplemented in llvm::GCNTargetMachine, llvm::R600TargetMachine, llvm::MipsTargetMachine, llvm::ARMBaseTargetMachine, llvm::NVPTXTargetMachine, llvm::PPCTargetMachine, llvm::X86TargetMachine, llvm::M68kTargetMachine, llvm::SystemZTargetMachine, llvm::VETargetMachine, llvm::AArch64TargetMachine, llvm::AVRTargetMachine, llvm::WebAssemblyTargetMachine, llvm::XCoreTargetMachine, llvm::HexagonTargetMachine, llvm::ARCTargetMachine, llvm::MSP430TargetMachine, llvm::RISCVTargetMachine, llvm::SparcTargetMachine, llvm::BPFTargetMachine, llvm::CSKYTargetMachine, and llvm::LanaiTargetMachine.

Definition at line 608 of file TargetPassConfig.cpp.

◆ getPassNameFromLegacyName()

virtual std::pair<StringRef, bool> llvm::LLVMTargetMachine::getPassNameFromLegacyName ( StringRef  )
inlinevirtual

Definition at line 426 of file TargetMachine.h.

References llvm_unreachable.

Referenced by registerPartialPipelineCallback().

◆ getTargetTransformInfo()

TargetTransformInfo LLVMTargetMachine::getTargetTransformInfo ( const Function F)
overridevirtual

◆ initAsmInfo()

void LLVMTargetMachine::initAsmInfo ( )
protected

Definition at line 41 of file LLVMTargetMachine.cpp.

References llvm::TargetMachine::AsmInfo, assert(), llvm::TargetOptions::BinutilsVersion, llvm::TargetOptions::CompressDebugSections, llvm::Target::createMCAsmInfo(), llvm::Target::createMCInstrInfo(), llvm::Target::createMCRegInfo(), llvm::Target::createMCSubtargetInfo(), llvm::TargetOptions::DisableIntegratedAS, llvm::TargetOptions::ExceptionModel, llvm::TargetMachine::getTargetCPU(), llvm::TargetMachine::getTargetFeatureString(), llvm::TargetMachine::getTargetTriple(), llvm::TargetOptions::MCOptions, llvm::TargetMachine::MII, llvm::TargetMachine::MRI, llvm::None, llvm::TargetMachine::Options, llvm::MCTargetOptions::PreserveAsmComments, llvm::TargetOptions::RelaxELFRelocations, llvm::MCAsmInfo::setBinutilsVersion(), llvm::MCAsmInfo::setCompressDebugSections(), llvm::MCAsmInfo::setExceptionsType(), llvm::MCAsmInfo::setPreserveAsmComments(), llvm::MCAsmInfo::setRelaxELFRelocations(), llvm::MCAsmInfo::setUseIntegratedAssembler(), llvm::TargetMachine::STI, and llvm::TargetMachine::TheTarget.

Referenced by llvm::AArch64TargetMachine::AArch64TargetMachine(), llvm::AMDGPUTargetMachine::AMDGPUTargetMachine(), llvm::ARCTargetMachine::ARCTargetMachine(), llvm::ARMBaseTargetMachine::ARMBaseTargetMachine(), llvm::AVRTargetMachine::AVRTargetMachine(), llvm::BPFTargetMachine::BPFTargetMachine(), llvm::CSKYTargetMachine::CSKYTargetMachine(), llvm::HexagonTargetMachine::HexagonTargetMachine(), llvm::LanaiTargetMachine::LanaiTargetMachine(), llvm::M68kTargetMachine::M68kTargetMachine(), llvm::MipsTargetMachine::MipsTargetMachine(), llvm::MSP430TargetMachine::MSP430TargetMachine(), llvm::NVPTXTargetMachine::NVPTXTargetMachine(), llvm::PPCTargetMachine::PPCTargetMachine(), llvm::RISCVTargetMachine::RISCVTargetMachine(), llvm::SparcTargetMachine::SparcTargetMachine(), llvm::SystemZTargetMachine::SystemZTargetMachine(), llvm::VETargetMachine::VETargetMachine(), llvm::WebAssemblyTargetMachine::WebAssemblyTargetMachine(), llvm::X86TargetMachine::X86TargetMachine(), and llvm::XCoreTargetMachine::XCoreTargetMachine().

◆ isMachineVerifierClean()

virtual bool llvm::LLVMTargetMachine::isMachineVerifierClean ( ) const
inlinevirtual

Returns true if the target is expected to pass all machine verifier checks.

This is a stopgap measure to fix targets one by one. We will remove this at some point and always enable the verifier when EXPENSIVE_CHECKS is enabled.

Reimplemented in llvm::R600TargetMachine, llvm::NVPTXTargetMachine, llvm::LanaiTargetMachine, llvm::VETargetMachine, and llvm::AVRTargetMachine.

Definition at line 443 of file TargetMachine.h.

Referenced by llvm::TargetPassConfig::addVerifyPass().

◆ useIPRA()

virtual bool llvm::LLVMTargetMachine::useIPRA ( ) const
inlinevirtual

True if the target wants to use interprocedural register allocation by default.

The -enable-ipra flag can be used to override this.

Reimplemented in llvm::GCNTargetMachine.

Definition at line 465 of file TargetMachine.h.

Referenced by llvm::TargetPassConfig::TargetPassConfig().

◆ usesPhysRegsForValues()

virtual bool llvm::LLVMTargetMachine::usesPhysRegsForValues ( ) const
inlinevirtual

True if the target uses physical regs (as nearly all targets do).

False for stack machines such as WebAssembly and other virtual-register machines. If true, all vregs must be allocated before PEI. If false, then callee-save register spilling and scavenging are not needed or used. If false, implicitly defined registers will still be assumed to be physical registers, except that variadic defs will be allocated vregs.

Reimplemented in llvm::WebAssemblyTargetMachine.

Definition at line 461 of file TargetMachine.h.


The documentation for this class was generated from the following files: