LLVM  4.0.0
Public Types | Public Member Functions | Public Attributes | Protected Member Functions | Protected Attributes | List of all members
llvm::TargetMachine Class Reference

Primary interface to the complete machine description for the target machine. More...

#include <TargetMachine.h>

Inheritance diagram for llvm::TargetMachine:
[legend]
Collaboration diagram for llvm::TargetMachine:
[legend]

Public Types

enum  CodeGenFileType { CGFT_AssemblyFile, CGFT_ObjectFile, CGFT_Null }
 These enums are meant to be passed into addPassesToEmitFile to indicate what type of file to emit, and returned by it to indicate what type of file could actually be made. More...
 

Public Member Functions

 TargetMachine (const TargetMachine &)=delete
 
void operator= (const TargetMachine &)=delete
 
virtual ~TargetMachine ()
 
const TargetgetTarget () const
 
const TriplegetTargetTriple () const
 
StringRef getTargetCPU () const
 
StringRef getTargetFeatureString () const
 
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
 
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 () const
 Get the pointer size for this target. More...
 
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
 
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)
 
bool shouldPrintMachineCode () const
 
bool getUniqueSectionNames () const
 
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...
 
virtual TargetIRAnalysis getTargetIRAnalysis ()
 Get a TargetIRAnalysis appropriate for the target. More...
 
virtual void addEarlyAsPossiblePasses (PassManagerBase &)
 Add target-specific function passes that should be run as early as possible in the optimization pipeline. More...
 
virtual bool addPassesToEmitFile (PassManagerBase &, raw_pwrite_stream &, CodeGenFileType, bool=true, AnalysisID=nullptr, AnalysisID=nullptr, AnalysisID=nullptr, AnalysisID=nullptr, MachineFunctionInitializer *=nullptr)
 Add passes to the specified pass manager to get the specified file emitted. More...
 
virtual bool addPassesToEmitMC (PassManagerBase &, MCContext *&, raw_pwrite_stream &, bool=true)
 Add passes to the specified pass manager to get machine code emitted with the MCJIT. 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 bool usesPhysRegsForPEI () const
 True if the target uses physical regs at Prolog/Epilog insertion time. More...
 

Public Attributes

const TargetOptions DefaultOptions
 
TargetOptions Options
 

Protected Member Functions

 TargetMachine (const Target &T, StringRef DataLayoutString, const Triple &TargetTriple, StringRef CPU, StringRef FS, const TargetOptions &Options)
 

Protected Attributes

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::Default
 
CodeGenOpt::Level OptLevel = CodeGenOpt::Default
 
const MCAsmInfoAsmInfo
 Contains target specific asm information. More...
 
const MCRegisterInfoMRI
 
const MCInstrInfoMII
 
const MCSubtargetInfoSTI
 
unsigned RequireStructuredCFG: 1
 
unsigned O0WantsFastISel: 1
 

Detailed Description

Primary interface to the complete machine description for the target machine.

All target-specific information should be accessible through this interface.

Definition at line 56 of file Target/TargetMachine.h.

Member Enumeration Documentation

These enums are meant to be passed into addPassesToEmitFile to indicate what type of file to emit, and returned by it to indicate what type of file could actually be made.

Enumerator
CGFT_AssemblyFile 
CGFT_ObjectFile 
CGFT_Null 

Definition at line 216 of file Target/TargetMachine.h.

Constructor & Destructor Documentation

TargetMachine::TargetMachine ( const Target T,
StringRef  DataLayoutString,
const Triple TargetTriple,
StringRef  CPU,
StringRef  FS,
const TargetOptions Options 
)
protected

Definition at line 42 of file TargetMachine.cpp.

References EnableIPRA, and llvm::TargetOptions::EnableIPRA.

llvm::TargetMachine::TargetMachine ( const TargetMachine )
delete
TargetMachine::~TargetMachine ( )
virtual

Definition at line 52 of file TargetMachine.cpp.

References AsmInfo, MII, MRI, and STI.

Member Function Documentation

virtual void llvm::TargetMachine::addEarlyAsPossiblePasses ( PassManagerBase &  )
inlinevirtual

Add target-specific function passes that should be run as early as possible in the optimization pipeline.

Most TargetMachines have no such passes.

Reimplemented in llvm::NVPTXTargetMachine, and llvm::AMDGPUTargetMachine.

Definition at line 211 of file Target/TargetMachine.h.

virtual bool llvm::TargetMachine::addPassesToEmitFile ( PassManagerBase &  ,
raw_pwrite_stream ,
CodeGenFileType  ,
bool  = true,
AnalysisID  = nullptr,
AnalysisID  = nullptr,
AnalysisID  = nullptr,
AnalysisID  = nullptr,
MachineFunctionInitializer = nullptr 
)
inlinevirtual

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

Typically this will involve several steps of code generation. This method should return true if emission of this file type is not supported, or false on success.

Reimplemented in llvm::LLVMTargetMachine.

Definition at line 226 of file Target/TargetMachine.h.

Referenced by LLVMTargetMachineEmit().

virtual bool llvm::TargetMachine::addPassesToEmitMC ( PassManagerBase &  ,
MCContext *&  ,
raw_pwrite_stream ,
bool  = true 
)
inlinevirtual

Add passes to the specified pass manager to get machine code emitted with the MCJIT.

This method returns true if machine code is not supported. It fills the MCContext Ctx pointer which can be used to build custom MCStreamer.

Reimplemented in llvm::LLVMTargetMachine, and llvm::NVPTXTargetMachine.

Definition at line 240 of file Target/TargetMachine.h.

Referenced by llvm::orc::SimpleCompiler::operator()().

const DataLayout llvm::TargetMachine::createDataLayout ( ) const
inline

Create a DataLayout.

Definition at line 124 of file Target/TargetMachine.h.

References DL.

Referenced by llvm::ComputeSignatureVTs(), and LLVMTargetMachineEmit().

CodeModel::Model TargetMachine::getCodeModel ( ) const
bool llvm::TargetMachine::getDataSections ( ) const
inline

Return true if data objects should be emitted into their own section, corresponds to -fdata-sections.

Definition at line 191 of file Target/TargetMachine.h.

References llvm::TargetOptions::DataSections.

Referenced by llvm::TargetLoweringObjectFileCOFF::getNameWithPrefix(), llvm::TargetLoweringObjectFileELF::SelectSectionForGlobal(), and llvm::TargetLoweringObjectFileCOFF::SelectSectionForGlobal().

bool llvm::TargetMachine::getFunctionSections ( ) const
inline
virtual const TargetIntrinsicInfo* llvm::TargetMachine::getIntrinsicInfo ( ) const
inlinevirtual

If intrinsic information is available, return it. If not, return null.

Reimplemented in llvm::AMDGPUTargetMachine.

Definition at line 153 of file Target/TargetMachine.h.

Referenced by llvm::SDNode::getOperationName(), llvm::AMDGPUTTIImpl::isSourceOfDivergence(), llvm::MIPrinter::print(), and llvm::MachineInstr::print().

const MCAsmInfo* llvm::TargetMachine::getMCAsmInfo ( ) const
inline
const MCInstrInfo* llvm::TargetMachine::getMCInstrInfo ( ) const
inline
const MCRegisterInfo* llvm::TargetMachine::getMCRegisterInfo ( ) const
inline
const MCSubtargetInfo* llvm::TargetMachine::getMCSubtargetInfo ( ) const
inline
void TargetMachine::getNameWithPrefix ( SmallVectorImpl< char > &  Name,
const GlobalValue GV,
Mangler Mang,
bool  MayAlwaysUsePrivate = false 
) const
bool llvm::TargetMachine::getO0WantsFastISel ( )
inline
virtual TargetLoweringObjectFile* llvm::TargetMachine::getObjFileLowering ( ) const
inlinevirtual
CodeGenOpt::Level TargetMachine::getOptLevel ( ) const
unsigned llvm::TargetMachine::getPointerSize ( ) const
inline
Reloc::Model TargetMachine::getRelocationModel ( ) const
template<typename STC >
const STC& llvm::TargetMachine::getSubtarget ( const Function F) const
inline

This method returns a pointer to the specified type of TargetSubtargetInfo.

In debug builds, it verifies that the object being returned is of the correct type.

Definition at line 119 of file Target/TargetMachine.h.

References getSubtargetImpl().

Referenced by llvm::ComputeLegalValueVTs(), and llvm::PhysicalRegisterUsageInfo::print().

virtual const TargetSubtargetInfo* llvm::TargetMachine::getSubtargetImpl ( const Function ) const
inlinevirtual
MCSymbol * TargetMachine::getSymbol ( const GlobalValue GV) const
const Target& llvm::TargetMachine::getTarget ( ) const
inline
StringRef llvm::TargetMachine::getTargetCPU ( ) const
inline
StringRef llvm::TargetMachine::getTargetFeatureString ( ) const
inline
TargetIRAnalysis TargetMachine::getTargetIRAnalysis ( )
virtual

Get a TargetIRAnalysis appropriate for the target.

This is used to construct the new pass manager's target IR analysis pass, set up appropriately for this target machine. Even the old pass manager uses this to answer queries about the IR.

Reimplemented in llvm::LLVMTargetMachine, llvm::NVPTXTargetMachine, llvm::AMDGPUTargetMachine, llvm::ARMBaseTargetMachine, llvm::PPCTargetMachine, llvm::MipsTargetMachine, llvm::WebAssemblyTargetMachine, llvm::LanaiTargetMachine, llvm::AArch64TargetMachine, llvm::SystemZTargetMachine, llvm::HexagonTargetMachine, llvm::XCoreTargetMachine, and llvm::X86TargetMachine.

Definition at line 200 of file TargetMachine.cpp.

References F, llvm::Module::getDataLayout(), and llvm::GlobalValue::getParent().

const Triple& llvm::TargetMachine::getTargetTriple ( ) const
inline
TLSModel::Model TargetMachine::getTLSModel ( const GlobalValue GV) const
bool llvm::TargetMachine::getUniqueSectionNames ( ) const
inline
bool llvm::TargetMachine::isCompatibleDataLayout ( const DataLayout Candidate) const
inline

Test if a DataLayout if compatible with the CodeGen for this target.

The LLVM Module owns a DataLayout that is used for the target independent optimizations and code generation. This hook provides a target specific check on the validity of this DataLayout.

Definition at line 131 of file Target/TargetMachine.h.

References DL.

bool TargetMachine::isPositionIndependent ( ) const
void llvm::TargetMachine::operator= ( const TargetMachine )
delete
bool llvm::TargetMachine::requiresStructuredCFG ( ) const
inline
void TargetMachine::resetTargetOptions ( const Function F) const
void llvm::TargetMachine::setFastISel ( bool  Enable)
inline
void llvm::TargetMachine::setO0WantsFastISel ( bool  Enable)
inline

Definition at line 183 of file Target/TargetMachine.h.

References O0WantsFastISel.

Referenced by addPassesToGenerateCode().

void TargetMachine::setOptLevel ( CodeGenOpt::Level  Level)

Overrides the optimization level.

Definition at line 198 of file TargetMachine.cpp.

References OptLevel.

Referenced by llvm::OptLevelChanger::OptLevelChanger(), and llvm::OptLevelChanger::~OptLevelChanger().

void llvm::TargetMachine::setRequiresStructuredCFG ( bool  Value)
inline

Definition at line 158 of file Target/TargetMachine.h.

References RequireStructuredCFG.

Referenced by llvm::R600TargetMachine::R600TargetMachine().

bool TargetMachine::shouldAssumeDSOLocal ( const Module M,
const GlobalValue GV 
) const
bool llvm::TargetMachine::shouldPrintMachineCode ( ) const
inline
virtual bool llvm::TargetMachine::targetSchedulesPostRAScheduling ( ) const
inlinevirtual

True if subtarget inserts the final scheduling pass on its own.

Branch relaxation, which must happen after block placement, can on some targets (e.g. SystemZ) expose additional post-RA scheduling opportunities.

Reimplemented in llvm::SystemZTargetMachine.

Definition at line 251 of file Target/TargetMachine.h.

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

virtual bool llvm::TargetMachine::usesPhysRegsForPEI ( ) const
inlinevirtual

True if the target uses physical regs at Prolog/Epilog insertion time.

If true (most machines), all vregs must be allocated before PEI. If false (virtual-register machines), then callee-save register spilling and scavenging are not needed or used.

Reimplemented in llvm::WebAssemblyTargetMachine.

Definition at line 261 of file Target/TargetMachine.h.

Member Data Documentation

const MCAsmInfo* llvm::TargetMachine::AsmInfo
protected

Contains target specific asm information.

Definition at line 84 of file Target/TargetMachine.h.

Referenced by getMCAsmInfo(), llvm::LLVMTargetMachine::initAsmInfo(), and ~TargetMachine().

CodeModel::Model llvm::TargetMachine::CMModel = CodeModel::Default
protected
const TargetOptions llvm::TargetMachine::DefaultOptions

Definition at line 94 of file Target/TargetMachine.h.

Referenced by resetTargetOptions().

const DataLayout llvm::TargetMachine::DL
protected

DataLayout for the target: keep ABI type size and alignment.

The DataLayout is created based on the string representation provided during construction. It is kept here only to avoid reparsing the string but should not really be used during compilation, because it has an internal cache that is context specific.

Definition at line 71 of file Target/TargetMachine.h.

Referenced by createDataLayout(), getPointerSize(), and isCompatibleDataLayout().

const MCInstrInfo* llvm::TargetMachine::MII
protected
const MCRegisterInfo* llvm::TargetMachine::MRI
protected
unsigned llvm::TargetMachine::O0WantsFastISel
protected

Definition at line 91 of file Target/TargetMachine.h.

Referenced by getO0WantsFastISel(), and setO0WantsFastISel().

TargetOptions llvm::TargetMachine::Options
mutable

Definition at line 95 of file Target/TargetMachine.h.

Referenced by llvm::TargetPassConfig::addISelPrepare(), llvm::TargetPassConfig::addMachinePasses(), llvm::LLVMTargetMachine::addPassesToEmitFile(), llvm::LLVMTargetMachine::addPassesToEmitMC(), addPassesToGenerateCode(), llvm::NVPTXTargetLowering::allowFMA(), llvm::ARMTargetLowering::ARMTargetLowering(), canCombineSinCosLibcall(), llvm::AArch64RegisterInfo::cannotEliminateFrame(), llvm::ARMBaseRegisterInfo::cannotEliminateFrame(), combineFMinFMax(), combineSelect(), llvm::MipsTargetLowering::createFastISel(), llvm::ARMFrameLowering::determineCalleeSaves(), llvm::PPCFrameLowering::determineCalleeSaves(), llvm::TargetFrameLowering::determineCalleeSaves(), llvm::AsmPrinter::doInitialization(), llvm::DwarfDebug::DwarfDebug(), llvm::PPCFrameLowering::eliminateCallFramePseudoInstr(), llvm::PPCFrameLowering::emitEpilogue(), llvm::AsmPrinter::EmitGlobalVariable(), llvm::X86AsmPrinter::EmitInstruction(), llvm::TargetLoweringObjectFile::getKindForGlobal(), llvm::PPCInstrInfo::getMachineCombinerPatterns(), GetNegatedExpression(), llvm::SelectionDAG::getNode(), llvm::DwarfCompileUnit::getOrCreateGlobalVariableDIE(), llvm::X86TargetMachine::getSubtargetImpl(), llvm::MipsFrameLowering::hasFP(), llvm::SparcFrameLowering::hasFP(), llvm::SystemZFrameLowering::hasFP(), llvm::ARMFrameLowering::hasFP(), llvm::MSP430FrameLowering::hasFP(), llvm::XCoreFrameLowering::hasFP(), llvm::AArch64FrameLowering::hasFP(), llvm::X86FrameLowering::hasFP(), llvm::LLVMTargetMachine::initAsmInfo(), llvm::HexagonTargetObjectFile::Initialize(), llvm::WebAssemblyTargetObjectFile::Initialize(), llvm::LanaiTargetObjectFile::Initialize(), llvm::MipsTargetObjectFile::Initialize(), llvm::AArch64InstrInfo::isAssociativeAndCommutative(), llvm::X86InstrInfo::isAssociativeAndCommutative(), isCombineInstrCandidateFP(), isFMAddSub(), llvm::isInTailCallPosition(), llvm::AArch64TargetLowering::isProfitableToHoist(), llvm::SelectionDAGBuilder::LowerDeoptimizingReturn(), llvm::SparcTargetLowering::LowerGlobalTLSAddress(), lowerUINT_TO_FP_vXi32(), llvm::PPCFrameLowering::needsFP(), llvm::OptLevelChanger::OptLevelChanger(), llvm::PPCTargetLowering::PPCTargetLowering(), llvm::PPCFrameLowering::processFunctionBeforeFrameFinalized(), promoteToConstantPool(), resetTargetOptions(), llvm::SelectionDAGISel::runOnMachineFunction(), llvm::FastISel::selectOperator(), shouldAssumeDSOLocal(), llvm::ARMSubtarget::splitFramePushPop(), llvm::TargetPassConfig::TargetPassConfig(), llvm::DwarfCompileUnit::updateSubprogramScopeDIE(), llvm::ARMSubtarget::useFastISel(), and llvm::X86TargetLowering::X86TargetLowering().

CodeGenOpt::Level llvm::TargetMachine::OptLevel = CodeGenOpt::Default
protected
unsigned llvm::TargetMachine::RequireStructuredCFG
protected

Definition at line 90 of file Target/TargetMachine.h.

Referenced by requiresStructuredCFG(), and setRequiresStructuredCFG().

Reloc::Model llvm::TargetMachine::RM = Reloc::Static
protected
const MCSubtargetInfo* llvm::TargetMachine::STI
protected
std::string llvm::TargetMachine::TargetCPU
protected
std::string llvm::TargetMachine::TargetFS
protected
Triple llvm::TargetMachine::TargetTriple
protected
const Target& llvm::TargetMachine::TheTarget
protected

The Target that this machine was created for.

Definition at line 63 of file Target/TargetMachine.h.

Referenced by getTarget(), and llvm::LLVMTargetMachine::initAsmInfo().


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