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

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

Public Member Functions
LLVM_ABI	JITTargetMachineBuilder (Triple TT)
	Create a JITTargetMachineBuilder based on the given triple.
LLVM_ABI Expected< std::unique_ptr< TargetMachine > >	createTargetMachine ()
	Create a TargetMachine.
Expected< DataLayout >	getDefaultDataLayoutForTarget () const
	Get the default DataLayout for the target.
JITTargetMachineBuilder &	setCPU (std::string CPU)
	Set the CPU string.
const std::string &	getCPU () const
	Returns the CPU string.
JITTargetMachineBuilder &	setRelocationModel (std::optional< Reloc::Model > RM)
	Set the relocation model.
const std::optional< Reloc::Model > &	getRelocationModel () const
	Get the relocation model.
JITTargetMachineBuilder &	setCodeModel (std::optional< CodeModel::Model > CM)
	Set the code model.
const std::optional< CodeModel::Model > &	getCodeModel () const
	Get the code model.
JITTargetMachineBuilder &	setCodeGenOptLevel (CodeGenOptLevel OptLevel)
	Set the LLVM CodeGen optimization level.
JITTargetMachineBuilder &	setFeatures (StringRef FeatureString)
	Set subtarget features.
LLVM_ABI JITTargetMachineBuilder &	addFeatures (const std::vector< std::string > &FeatureVec)
	Add subtarget features.
SubtargetFeatures &	getFeatures ()
	Access subtarget features.
const SubtargetFeatures &	getFeatures () const
	Access subtarget features.
JITTargetMachineBuilder &	setOptions (TargetOptions Options)
	Set TargetOptions.
TargetOptions &	getOptions ()
	Access TargetOptions.
const TargetOptions &	getOptions () const
	Access TargetOptions.
Triple &	getTargetTriple ()
	Access Triple.
const Triple &	getTargetTriple () const
	Access Triple.

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

Friends
class	JITTargetMachineBuilderPrinter

Detailed Description

A utility class for building TargetMachines for JITs.

Definition at line 36 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 is 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::move().

Referenced by addFeatures(), detectHost(), setCodeGenOptLevel(), setCodeModel(), setCPU(), setFeatures(), setOptions(), and setRelocationModel().

Member Function Documentation

◆ addFeatures()

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

Add subtarget features.

Definition at line 59 of file JITTargetMachineBuilder.cpp.

References F, and JITTargetMachineBuilder().

◆ 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 39 of file JITTargetMachineBuilder.cpp.

References llvm::inconvertibleErrorCode(), llvm::TargetRegistry::lookupTarget(), and llvm::make_error().

Referenced by llvm::orc::LLJIT::createCompileFunction().

◆ detectHost()

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

static

Create a JITTargetMachineBuilder for the host system.

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

Definition at line 24 of file JITTargetMachineBuilder.cpp.

References llvm::SubtargetFeatures::AddFeature(), getFeatures(), llvm::sys::getHostCPUFeatures(), llvm::sys::getHostCPUName(), llvm::sys::getProcessTriple(), JITTargetMachineBuilder(), 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 98 of file JITTargetMachineBuilder.h.

◆ getCPU()

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

inline

Returns the CPU string.

Definition at line 80 of file JITTargetMachineBuilder.h.

◆ getDefaultDataLayoutForTarget()

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

inline

Get the default DataLayout for the target.

Note: This is reasonably expensive. It is only suitable for use during JIT setup.

Definition at line 68 of file JITTargetMachineBuilder.h.

References llvm::DataLayout::parse().

◆ getFeatures() [1/2]

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

inline

Access subtarget features.

Definition at line 117 of file JITTargetMachineBuilder.h.

Referenced by detectHost().

◆ getFeatures() [2/2]

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

inline

Access subtarget features.

Definition at line 120 of file JITTargetMachineBuilder.h.

◆ getOptions() [1/2]

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

inline

Access TargetOptions.

Definition at line 134 of file JITTargetMachineBuilder.h.

◆ getOptions() [2/2]

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

inline

Access TargetOptions.

Definition at line 137 of file JITTargetMachineBuilder.h.

◆ getRelocationModel()

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

inline

Get the relocation model.

Definition at line 89 of file JITTargetMachineBuilder.h.

◆ getTargetTriple() [1/2]

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

inline

Access Triple.

Definition at line 140 of file JITTargetMachineBuilder.h.

◆ getTargetTriple() [2/2]

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

inline

Access Triple.

Definition at line 143 of file JITTargetMachineBuilder.h.

◆ setCodeGenOptLevel()

JITTargetMachineBuilder & llvm::orc::JITTargetMachineBuilder::setCodeGenOptLevel ( CodeGenOptLevel OptLevel )

inline

Set the LLVM CodeGen optimization level.

Definition at line 101 of file JITTargetMachineBuilder.h.

References JITTargetMachineBuilder().

◆ setCodeModel()

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

inline

Set the code model.

Definition at line 92 of file JITTargetMachineBuilder.h.

References JITTargetMachineBuilder().

◆ setCPU()

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

inline

Set the CPU string.

Definition at line 74 of file JITTargetMachineBuilder.h.

References JITTargetMachineBuilder().

Referenced by detectHost().

◆ setFeatures()

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

inline

Set subtarget features.

Definition at line 107 of file JITTargetMachineBuilder.h.

References JITTargetMachineBuilder().

◆ setOptions()

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

inline

Set TargetOptions.

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

Definition at line 128 of file JITTargetMachineBuilder.h.

References JITTargetMachineBuilder().

◆ setRelocationModel()

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

inline

Set the relocation model.

Definition at line 83 of file JITTargetMachineBuilder.h.

References JITTargetMachineBuilder().

◆ JITTargetMachineBuilderPrinter

friend class JITTargetMachineBuilderPrinter

friend

Definition at line 38 of file JITTargetMachineBuilder.h.

References JITTargetMachineBuilderPrinter, and LLVM_ABI.

Referenced by JITTargetMachineBuilderPrinter.

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

◆ JITTargetMachineBuilderPrinter