A utility class for building TargetMachines for JITs. More...

#include "llvm/ExecutionEngine/Orc/JITTargetMachineBuilder.h"

Public Member Functions
	JITTargetMachineBuilder (Triple TT)
	Create a JITTargetMachineBuilder based on the given triple. More...

Expected< std::unique_ptr< TargetMachine > >	createTargetMachine ()
	Create a TargetMachine. More...

Expected< DataLayout >	getDefaultDataLayoutForTarget ()
	Get the default DataLayout for the target. More...

JITTargetMachineBuilder &	setCPU (std::string CPU)
	Set the CPU string. More...

const std::string &	getCPU () const
	Returns the CPU string. More...

JITTargetMachineBuilder &	setRelocationModel (std::optional< Reloc::Model > RM)
	Set the relocation model. More...

const std::optional< Reloc::Model > &	getRelocationModel () const
	Get the relocation model. More...

JITTargetMachineBuilder &	setCodeModel (std::optional< CodeModel::Model > CM)
	Set the code model. More...

const std::optional< CodeModel::Model > &	getCodeModel () const
	Get the code model. More...

JITTargetMachineBuilder &	setCodeGenOptLevel (CodeGenOpt::Level OptLevel)
	Set the LLVM CodeGen optimization level. More...

JITTargetMachineBuilder &	setFeatures (StringRef FeatureString)
	Set subtarget features. More...

JITTargetMachineBuilder &	addFeatures (const std::vector< std::string > &FeatureVec)
	Add subtarget features. More...

SubtargetFeatures &	getFeatures ()
	Access subtarget features. More...

const SubtargetFeatures &	getFeatures () const
	Access subtarget features. More...

JITTargetMachineBuilder &	setOptions (TargetOptions Options)
	Set TargetOptions. More...

TargetOptions &	getOptions ()
	Access TargetOptions. More...

const TargetOptions &	getOptions () const
	Access TargetOptions. More...

Triple &	getTargetTriple ()
	Access Triple. More...

const Triple &	getTargetTriple () const
	Access Triple. More...

Static Public Member Functions
static Expected< JITTargetMachineBuilder >	detectHost ()
	Create a JITTargetMachineBuilder for the host system. More...

Friends
class	JITTargetMachineBuilderPrinter

Detailed Description

A utility class for building TargetMachines for JITs.

Definition at line 34 of file JITTargetMachineBuilder.h.

Constructor & Destructor Documentation

◆ JITTargetMachineBuilder()

llvm::orc::JITTargetMachineBuilder::JITTargetMachineBuilder ( Triple TT )

Create a JITTargetMachineBuilder based on the given triple.

Note: TargetOptions is default-constructed, then EmulatedTLS and ExplicitEmulatedTLS are set to true. If EmulatedTLS is not required, these values should be reset before calling createTargetMachine.

Definition at line 18 of file JITTargetMachineBuilder.cpp.

References llvm::TargetOptions::EmulatedTLS, llvm::TargetOptions::ExplicitEmulatedTLS, and llvm::TargetOptions::UseInitArray.

Member Function Documentation

◆ addFeatures()

JITTargetMachineBuilder & llvm::orc::JITTargetMachineBuilder::addFeatures ( const std::vector< std::string > & FeatureVec )

Add subtarget features.

Definition at line 65 of file JITTargetMachineBuilder.cpp.

References llvm::SubtargetFeatures::AddFeature(), and F.

◆ createTargetMachine()

Expected< std::unique_ptr< TargetMachine > > llvm::orc::JITTargetMachineBuilder::createTargetMachine ( )

Create a TargetMachine.

This operation will fail if the requested target is not registered, in which case see llvm/Support/TargetSelect.h. To JIT IR the Target and the target's AsmPrinter must both be registered. To JIT assembly (including inline and module level assembly) the target's AsmParser must also be registered.

Definition at line 44 of file JITTargetMachineBuilder.cpp.

References llvm::SubtargetFeatures::getString(), llvm::Triple::getTriple(), llvm::inconvertibleErrorCode(), llvm::TargetRegistry::lookupTarget(), move, and TM.

Referenced by llvm::orc::LLJIT::createCompileFunction(), getDefaultDataLayoutForTarget(), and llvm::orc::ConcurrentIRCompiler::operator()().

◆ detectHost()

Expected< JITTargetMachineBuilder > llvm::orc::JITTargetMachineBuilder::detectHost ( )

static

Create a JITTargetMachineBuilder for the host system.

Note: TargetOptions is default-constructed, then EmulatedTLS and ExplicitEmulatedTLS are set to true. If EmulatedTLS is not required, these values should be reset before calling createTargetMachine.

Definition at line 25 of file JITTargetMachineBuilder.cpp.

References llvm::SubtargetFeatures::AddFeature(), llvm::FeatureMap, getFeatures(), llvm::sys::getHostCPUFeatures(), llvm::sys::getHostCPUName(), llvm::sys::getProcessTriple(), and setCPU().

Referenced by LLVMOrcJITTargetMachineBuilderDetectHost(), and llvm::orc::LLJITBuilderState::prepareForConstruction().

◆ getCodeModel()

const std::optional<CodeModel::Model>& llvm::orc::JITTargetMachineBuilder::getCodeModel ( ) const

inline

Get the code model.

Definition at line 101 of file JITTargetMachineBuilder.h.

◆ getCPU()

const std::string& llvm::orc::JITTargetMachineBuilder::getCPU ( ) const

inline

Returns the CPU string.

Definition at line 83 of file JITTargetMachineBuilder.h.

◆ getDefaultDataLayoutForTarget()

Expected<DataLayout> llvm::orc::JITTargetMachineBuilder::getDefaultDataLayoutForTarget ( )

inline

Get the default DataLayout for the target.

Note: This is reasonably expensive, as it creates a temporary TargetMachine instance under the hood. It is only suitable for use during JIT setup.

Definition at line 69 of file JITTargetMachineBuilder.h.

References createTargetMachine(), and TM.

◆ getFeatures() [1/2]

SubtargetFeatures& llvm::orc::JITTargetMachineBuilder::getFeatures ( )

inline

Access subtarget features.

Definition at line 120 of file JITTargetMachineBuilder.h.

Referenced by detectHost().

◆ getFeatures() [2/2]

const SubtargetFeatures& llvm::orc::JITTargetMachineBuilder::getFeatures ( ) const

inline

Access subtarget features.

Definition at line 123 of file JITTargetMachineBuilder.h.

◆ getOptions() [1/2]

TargetOptions& llvm::orc::JITTargetMachineBuilder::getOptions ( )

inline

Access TargetOptions.

Definition at line 137 of file JITTargetMachineBuilder.h.

References Options.

◆ getOptions() [2/2]

const TargetOptions& llvm::orc::JITTargetMachineBuilder::getOptions ( ) const

inline

Access TargetOptions.

Definition at line 140 of file JITTargetMachineBuilder.h.

References Options.

◆ getRelocationModel()

const std::optional<Reloc::Model>& llvm::orc::JITTargetMachineBuilder::getRelocationModel ( ) const

inline

Get the relocation model.

Definition at line 92 of file JITTargetMachineBuilder.h.

References llvm::AArch64::RM.

◆ getTargetTriple() [1/2]

Triple& llvm::orc::JITTargetMachineBuilder::getTargetTriple ( )

inline

Access Triple.

Definition at line 143 of file JITTargetMachineBuilder.h.

◆ getTargetTriple() [2/2]

const Triple& llvm::orc::JITTargetMachineBuilder::getTargetTriple ( ) const

inline

Access Triple.

Definition at line 146 of file JITTargetMachineBuilder.h.

◆ setCodeGenOptLevel()

JITTargetMachineBuilder& llvm::orc::JITTargetMachineBuilder::setCodeGenOptLevel ( CodeGenOpt::Level OptLevel )

inline

Set the LLVM CodeGen optimization level.

Definition at line 104 of file JITTargetMachineBuilder.h.

◆ setCodeModel()

JITTargetMachineBuilder& llvm::orc::JITTargetMachineBuilder::setCodeModel ( std::optional< CodeModel::Model > CM )

inline

Set the code model.

Definition at line 95 of file JITTargetMachineBuilder.h.

References move.

◆ setCPU()

JITTargetMachineBuilder& llvm::orc::JITTargetMachineBuilder::setCPU ( std::string CPU )

inline

Set the CPU string.

Definition at line 77 of file JITTargetMachineBuilder.h.

References move.

Referenced by detectHost().

◆ setFeatures()

JITTargetMachineBuilder& llvm::orc::JITTargetMachineBuilder::setFeatures ( StringRef FeatureString )

inline

Set subtarget features.

Definition at line 110 of file JITTargetMachineBuilder.h.

◆ setOptions()

JITTargetMachineBuilder& llvm::orc::JITTargetMachineBuilder::setOptions ( TargetOptions Options )

inline

Set TargetOptions.

Note: This operation will overwrite any previously configured options, including EmulatedTLS, ExplicitEmulatedTLS, and UseInitArray which the JITTargetMachineBuilder sets by default. Clients are responsible for re-enabling these overwritten options.

Definition at line 131 of file JITTargetMachineBuilder.h.

References move, and Options.

◆ setRelocationModel()

JITTargetMachineBuilder& llvm::orc::JITTargetMachineBuilder::setRelocationModel ( std::optional< Reloc::Model > RM )

inline

Set the relocation model.

Definition at line 86 of file JITTargetMachineBuilder.h.

References move, and llvm::AArch64::RM.

Friends And Related Function Documentation

◆ JITTargetMachineBuilderPrinter

friend class JITTargetMachineBuilderPrinter

friend

Definition at line 36 of file JITTargetMachineBuilder.h.

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

include/llvm/ExecutionEngine/Orc/JITTargetMachineBuilder.h
lib/ExecutionEngine/Orc/JITTargetMachineBuilder.cpp

Public Member Functions

Static Public Member Functions

Friends

Detailed Description

Constructor & Destructor Documentation

◆ JITTargetMachineBuilder()

Member Function Documentation

◆ addFeatures()

◆ createTargetMachine()

◆ detectHost()

◆ getCodeModel()

◆ getCPU()

◆ getDefaultDataLayoutForTarget()

◆ getFeatures() [1/2]

◆ getFeatures() [2/2]

◆ getOptions() [1/2]

◆ getOptions() [2/2]

◆ getRelocationModel()

◆ getTargetTriple() [1/2]

◆ getTargetTriple() [2/2]

◆ setCodeGenOptLevel()

◆ setCodeModel()

◆ setCPU()

◆ setFeatures()

◆ setOptions()

◆ setRelocationModel()

Friends And Related Function Documentation

◆ JITTargetMachineBuilderPrinter