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:

[legend]

Collaboration diagram for llvm::LLVMTargetMachine:

[legend]

Public Member Functions
TargetTransformInfo	getTargetTransformInfo (const Function &F) override
	Get a TargetTransformInfo implementation for the target. More...

virtual TargetPassConfig *	createPassConfig (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, MachineModuleInfo MMI=nullptr) override
	Add passes to the specified pass manager to get the specified file emitted. More...

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...

virtual bool	usesPhysRegsForPEI () const
	True if the target uses physical regs at Prolog/Epilog insertion time. 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 Target &	getTarget () const

const Triple &	getTargetTriple () const

StringRef	getTargetCPU () const

StringRef	getTargetFeatureString () const

virtual const TargetSubtargetInfo *	getSubtargetImpl (const Function &) const
	Virtual method implemented by subclasses that returns a reference to that target's TargetSubtargetInfo-derived member variable. More...

virtual TargetLoweringObjectFile *	getObjFileLowering () 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 (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 MCAsmInfo *	getMCAsmInfo () const
	Return target specific asm information. More...

const MCRegisterInfo *	getMCRegisterInfo () const

const MCInstrInfo *	getMCInstrInfo () const

const MCSubtargetInfo *	getMCSubtargetInfo () const

virtual const TargetIntrinsicInfo *	getIntrinsicInfo () 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)

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...

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 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

MCSymbol *	getSymbol (const GlobalValue *GV) 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
Public Types inherited from llvm::TargetMachine
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 Attributes inherited from llvm::TargetMachine
const TargetOptions	DefaultOptions

TargetOptions	Options

Protected Attributes inherited from llvm::TargetMachine
const Target &	TheTarget
	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 MCAsmInfo >	AsmInfo
	Contains target specific asm information. More...

std::unique_ptr< const MCRegisterInfo >	MRI

std::unique_ptr< const MCInstrInfo >	MII

std::unique_ptr< const MCSubtargetInfo >	STI

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 295 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

Definition at line 77 of file LLVMTargetMachine.cpp.

References llvm::TargetMachine::CMModel, EnableTrapUnreachable, llvm::TargetMachine::OptLevel, llvm::TargetMachine::RM, and llvm::TargetOptions::TrapUnreachable.

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 116 of file LLVMTargetMachine.cpp.

Referenced by addPassesToEmitFile().

◆ addPassesToEmitFile()

bool LLVMTargetMachine::addPassesToEmitFile	(	PassManagerBase &	PM,
		raw_pwrite_stream &	Out,
		raw_pwrite_stream *	DwoOut,
		CodeGenFileType	FileType,
		bool	DisableVerify = `true`,
		MachineModuleInfo *	MMI = `nullptr`
	)

overridevirtual

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

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

Reimplemented from llvm::TargetMachine.

Definition at line 190 of file LLVMTargetMachine.cpp.

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

◆ addPassesToEmitMC()

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

overridevirtual

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

addPassesToEmitMC - 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 from llvm::TargetMachine.

Reimplemented in llvm::NVPTXTargetMachine.

Definition at line 218 of file LLVMTargetMachine.cpp.

◆ 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.

Definition at line 444 of file TargetPassConfig.cpp.

References llvm::TargetPassConfig::TargetPassConfig().

Referenced by addPassesToGenerateCode().

◆ getTargetTransformInfo()

TargetTransformInfo LLVMTargetMachine::getTargetTransformInfo ( const Function & F )

overridevirtual

Get a TargetTransformInfo implementation for the target.

The TTI returned uses the common code generator to answer queries about the IR.

Reimplemented from llvm::TargetMachine.

Reimplemented in llvm::GCNTargetMachine, llvm::R600TargetMachine, llvm::NVPTXTargetMachine, llvm::ARMBaseTargetMachine, llvm::PPCTargetMachine, llvm::X86TargetMachine, llvm::AArch64TargetMachine, llvm::MipsTargetMachine, llvm::SystemZTargetMachine, llvm::WebAssemblyTargetMachine, llvm::XCoreTargetMachine, llvm::LanaiTargetMachine, llvm::ARCTargetMachine, and llvm::HexagonTargetMachine.

Definition at line 93 of file LLVMTargetMachine.cpp.

◆ initAsmInfo()

void LLVMTargetMachine::initAsmInfo ( )

protected

Definition at line 42 of file LLVMTargetMachine.cpp.

◆ 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::MipsTargetMachine, llvm::PPCTargetMachine, llvm::LanaiTargetMachine, and llvm::AVRTargetMachine.

Definition at line 336 of file TargetMachine.h.

References Context.

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 352 of file TargetMachine.h.

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

◆ usesPhysRegsForPEI()

virtual bool llvm::LLVMTargetMachine::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 348 of file TargetMachine.h.

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

include/llvm/Target/TargetMachine.h
lib/CodeGen/LLVMTargetMachine.cpp
lib/CodeGen/TargetPassConfig.cpp

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ LLVMTargetMachine()

Member Function Documentation

◆ addAsmPrinter()

◆ addPassesToEmitFile()

◆ addPassesToEmitMC()

◆ createPassConfig()

◆ getTargetTransformInfo()

◆ initAsmInfo()

◆ isMachineVerifierClean()

◆ useIPRA()

◆ usesPhysRegsForPEI()