llvm::SPIRV Namespace Reference

Lowers a builtin funtion call using the provided DemangledCall skeleton and external instruction Set. More...

Namespaces
namespace	AccessQualifier
namespace	AddressingModel
namespace	BuiltIn
namespace	Capability
namespace	Decoration
namespace	Dim
namespace	ExecutionMode
namespace	ExecutionModel
namespace	Extension
namespace	FPFastMathMode
namespace	FPRoundingMode
namespace	FunctionControl
namespace	FunctionParameterAttribute
namespace	GLSLExtInst
namespace	GroupOperation
namespace	ImageChannelDataType
namespace	ImageChannelOrder
namespace	ImageFormat
namespace	ImageOperand
namespace	InstructionSet
namespace	KernelEnqueueFlags
namespace	KernelProfilingInfo
namespace	LinkageType
namespace	LoopControl
namespace	MemoryModel
namespace	MemoryOperand
namespace	MemorySemantics
namespace	Opcode
namespace	OpenCLExtInst
namespace	OperandCategory
namespace	SamplerAddressingMode
namespace	SamplerFilterMode
namespace	Scope
namespace	SelectionControl
namespace	SourceLanguage
namespace	StorageClass

Classes
struct	AtomicFloatingBuiltin
struct	BuiltinType
struct	CapabilityEntry
class	ConvergenceRegion
class	ConvergenceRegionAnalyzer
class	ConvergenceRegionInfo
struct	ConvertBuiltin
struct	DemangledBuiltin
struct	DeviceEventTypeDescriptor
class	DTSortableEntry
struct	ExtendedBuiltin
struct	ExtensionEntry
struct	GetBuiltin
struct	GroupBuiltin
struct	GroupUniformBuiltin
struct	ImageQueryBuiltin
struct	ImageTypeDescriptor
struct	IncomingCall
struct	IntelSubgroupsBuiltin
struct	ModuleAnalysisInfo
struct	NativeBuiltin
struct	OpenCLType
struct	PipeTypeDescriptor
struct	PointerTypeDescriptor
struct	RequirementHandler
struct	Requirements
struct	SampledImageTypeDescriptor
struct	SamplerTypeDescriptor
struct	SpecialTypeDescriptor
struct	SymbolicOperand
struct	VectorLoadStoreBuiltin

Typedefs
using	InstrList = SmallVector< MachineInstr * >
using	LocalToGlobalRegTable = std::map< Register, Register >
using	RegisterAliasMapTy = std::map< const MachineFunction *, LocalToGlobalRegTable >

Enumerations
enum	AsmComments { ASM_PRINTER_WIDTH16 = MachineInstr::TAsmComments }
enum	ModuleSectionType {   MB_EntryPoints , MB_DebugNames , MB_DebugModuleProcessed , MB_Annotations ,   MB_TypeConstVars , MB_ExtFuncDecls , NUM_MODULE_SECTIONS }

Functions
std::optional< IntrinsicInst * >	getConvergenceToken (BasicBlock *BB)
std::optional< const IntrinsicInst * >	getConvergenceToken (const BasicBlock *BB)
ConvergenceRegionInfo	getConvergenceRegions (Function &F, DominatorTree &DT, LoopInfo &LI)
std::optional< bool >	lowerBuiltin (const StringRef DemangledCall, SPIRV::InstructionSet::InstructionSet Set, MachineIRBuilder &MIRBuilder, const Register OrigRet, const Type *OrigRetTy, const SmallVectorImpl< Register > &Args, SPIRVGlobalRegistry *GR)
Type *	parseBuiltinCallArgumentBaseType (const StringRef DemangledCall, unsigned ArgIdx, LLVMContext &Ctx)
	Parses the provided ArgIdx argument base type in the DemangledCall skeleton.
TargetExtType *	parseBuiltinTypeNameToTargetExtType (std::string TypeName, LLVMContext &Context)
	Translates a string representing a SPIR-V or OpenCL builtin type to a TargetExtType that can be further lowered with lowerBuiltinType().
SPIRVType *	lowerBuiltinType (const Type *OpaqueType, SPIRV::AccessQualifier::AccessQualifier AccessQual, MachineIRBuilder &MIRBuilder, SPIRVGlobalRegistry *GR)
std::optional< bool >	lowerBuiltin (const StringRef DemangledCall, InstructionSet::InstructionSet Set, MachineIRBuilder &MIRBuilder, const Register OrigRet, const Type *OrigRetTy, const SmallVectorImpl< Register > &Args, SPIRVGlobalRegistry *GR)
	Lowers a builtin funtion call using the provided DemangledCall skeleton and external instruction Set.
SPIRVType *	lowerBuiltinType (const Type *Type, AccessQualifier::AccessQualifier AccessQual, MachineIRBuilder &MIRBuilder, SPIRVGlobalRegistry *GR)
	Handles the translation of the provided special opaque/builtin type Type to SPIR-V type.

Detailed Description

Lowers a builtin funtion call using the provided DemangledCall skeleton and external instruction Set.

Typedef Documentation

InstrList

using llvm::SPIRV::InstrList = typedef SmallVector<MachineInstr *>

Definition at line 126 of file SPIRVModuleAnalysis.h.

LocalToGlobalRegTable

using llvm::SPIRV::LocalToGlobalRegTable = typedef std::map<Register, Register>

Definition at line 128 of file SPIRVModuleAnalysis.h.

RegisterAliasMapTy

using llvm::SPIRV::RegisterAliasMapTy = typedef std::map<const MachineFunction *, LocalToGlobalRegTable>

Definition at line 129 of file SPIRVModuleAnalysis.h.

Enumeration Type Documentation

AsmComments

enum llvm::SPIRV::AsmComments

Enumerator
ASM_PRINTER_WIDTH16

Definition at line 58 of file SPIRVInstrInfo.h.

ModuleSectionType

enum llvm::SPIRV::ModuleSectionType

Enumerator
MB_EntryPoints
MB_DebugNames
MB_DebugModuleProcessed
MB_Annotations
MB_TypeConstVars
MB_ExtFuncDecls
NUM_MODULE_SECTIONS

Definition at line 32 of file SPIRVModuleAnalysis.h.

Function Documentation

getConvergenceRegions()

ConvergenceRegionInfo llvm::SPIRV::getConvergenceRegions	(	Function &	F,
		DominatorTree &	DT,
		LoopInfo &	LI
	)

Definition at line 316 of file SPIRVConvergenceRegionAnalysis.cpp.

References llvm::SPIRV::ConvergenceRegionAnalyzer::analyze(), and F.

Referenced by llvm::SPIRVConvergenceRegionAnalysis::run(), and llvm::SPIRVConvergenceRegionAnalysisWrapperPass::runOnFunction().

getConvergenceToken() [1/2]

std::optional< IntrinsicInst * > llvm::SPIRV::getConvergenceToken

(

BasicBlock *

BB

)

Definition at line 115 of file SPIRVConvergenceRegionAnalysis.cpp.

Referenced by llvm::SPIRV::ConvergenceRegionAnalyzer::analyze(), and llvm::SPIRV::ConvergenceRegion::ConvergenceRegion().

getConvergenceToken() [2/2]

std::optional< const IntrinsicInst * > llvm::SPIRV::getConvergenceToken

(

const BasicBlock *

BB

)

Definition at line 119 of file SPIRVConvergenceRegionAnalysis.cpp.

lowerBuiltin() [1/2]

std::optional< bool > llvm::SPIRV::lowerBuiltin	(	const StringRef	DemangledCall,
		InstructionSet::InstructionSet	Set,
		MachineIRBuilder &	MIRBuilder,
		const Register	OrigRet,
		const Type *	OrigRetTy,
		const SmallVectorImpl< Register > &	Args,
		SPIRVGlobalRegistry *	GR
	)

Lowers a builtin funtion call using the provided DemangledCall skeleton and external instruction Set.

Returns

the lowering success status if the called function is a recognized builtin, std::nullopt otherwise.

DemangledCall is the skeleton of the lowered builtin function call. Set is the external instruction set containing the given builtin. OrigRet is the single original virtual return register if defined, Register(0) otherwise. OrigRetTy is the type of the OrigRet. Args are the arguments of the lowered builtin call.

lowerBuiltin() [2/2]

std::optional< bool > llvm::SPIRV::lowerBuiltin	(	const StringRef	DemangledCall,
		SPIRV::InstructionSet::InstructionSet	Set,
		MachineIRBuilder &	MIRBuilder,
		const Register	OrigRet,
		const Type *	OrigRetTy,
		const SmallVectorImpl< Register > &	Args,
		SPIRVGlobalRegistry *	GR
	)

Definition at line 2196 of file SPIRVBuiltins.cpp.

References assert(), llvm::SPIRVGlobalRegistry::assignTypeToVReg(), llvm::MachineRegisterInfo::createVirtualRegister(), llvm::dbgs(), llvm::generateAsyncCopy(), llvm::generateAtomicFloatingInst(), llvm::generateAtomicInst(), llvm::generateBarrierInst(), llvm::generateBuiltinVar(), llvm::generateConvertInst(), llvm::generateDotOrFMulInst(), llvm::generateEnqueueInst(), llvm::generateExtInst(), llvm::generateGetQueryInst(), llvm::generateGroupInst(), llvm::generateGroupUniformInst(), llvm::generateImageMiscQueryInst(), llvm::generateImageSizeQueryInst(), llvm::generateIntelSubgroupsInst(), llvm::generateLoadStoreInst(), llvm::generateReadImageInst(), llvm::generateRelationalInst(), llvm::generateSampleImageInst(), llvm::generateSelectInst(), llvm::generateSpecConstantInst(), llvm::generateVectorLoadStoreInst(), llvm::generateWaveInst(), llvm::generateWriteImageInst(), llvm::MachineIRBuilder::getMRI(), llvm::MachineRegisterInfo::getRegClassOrNull(), llvm::Type::isVoidTy(), LLVM_DEBUG, llvm::lookupBuiltin(), llvm::LLT::scalar(), llvm::MachineRegisterInfo::setRegClass(), and llvm::MachineRegisterInfo::setType().

Referenced by llvm::SPIRVCallLowering::lowerCall().

lowerBuiltinType() [1/2]

SPIRVType * llvm::SPIRV::lowerBuiltinType	(	const Type *	OpaqueType,
		SPIRV::AccessQualifier::AccessQualifier	AccessQual,
		MachineIRBuilder &	MIRBuilder,
		SPIRVGlobalRegistry *	GR
	)

Definition at line 2488 of file SPIRVBuiltins.cpp.

References llvm::buildOpName(), llvm::dbgs(), llvm::MachineIRBuilder::getContext(), llvm::getImageType(), llvm::MachineIRBuilder::getMRI(), llvm::getNonParameterizedType(), llvm::MachineRegisterInfo::getNumVirtRegs(), llvm::SPIRVGlobalRegistry::getOrCreateOpTypeDeviceEvent(), llvm::getPipeType(), llvm::getSampledImageType(), llvm::getSamplerType(), llvm::SPIRVGlobalRegistry::getSPIRVTypeID(), llvm::Type::getStructName(), LLVM_DEBUG, Name, llvm::SPIRV::BuiltinType::Opcode, parseBuiltinTypeNameToTargetExtType(), llvm::report_fatal_error(), and llvm::StringRef::str().

lowerBuiltinType() [2/2]

SPIRVType * llvm::SPIRV::lowerBuiltinType	(	const Type *	Type,
		AccessQualifier::AccessQualifier	AccessQual,
		MachineIRBuilder &	MIRBuilder,
		SPIRVGlobalRegistry *	GR
	)

Handles the translation of the provided special opaque/builtin type Type to SPIR-V type.

Generates the corresponding machine instructions for the target type or gets the already existing OpType<...> register from the global registry GR.

Returns

A machine instruction representing the OpType<...> SPIR-V type.

Type is the special opaque/builtin type to be lowered.

parseBuiltinCallArgumentBaseType()

Type * llvm::SPIRV::parseBuiltinCallArgumentBaseType	(	const StringRef	DemangledCall,
		unsigned	ArgIdx,
		LLVMContext &	Ctx
	)

Parses the provided ArgIdx argument base type in the DemangledCall skeleton.

A base type is either a basic type (e.g. i32 for int), pointer element type (e.g. i8 for char*), or builtin type (TargetExtType).

Returns

LLVM Type or nullptr if unrecognized

DemangledCall is the skeleton of the lowered builtin function call. ArgIdx is the index of the argument to parse.

Definition at line 2286 of file SPIRVBuiltins.cpp.

References assert(), llvm::StringRef::consume_back(), llvm::StringRef::consume_front(), llvm::StringRef::ends_with(), llvm::StringRef::find(), llvm::StringRef::find_first_of(), llvm::VectorType::get(), llvm::StringRef::getAsInteger(), llvm::Type::getInt8Ty(), llvm::hasBuiltinTypePrefix(), llvm::parseBasicTypeName(), parseBuiltinTypeNameToTargetExtType(), llvm::SmallVectorBase< Size_T >::size(), llvm::StringRef::slice(), llvm::StringRef::split(), llvm::StringRef::str(), and llvm::StringRef::substr().

parseBuiltinTypeNameToTargetExtType()

TargetExtType * llvm::SPIRV::parseBuiltinTypeNameToTargetExtType	(	std::string	TypeName,
		LLVMContext &	Context
	)

Translates a string representing a SPIR-V or OpenCL builtin type to a TargetExtType that can be further lowered with lowerBuiltinType().

Returns

A TargetExtType representing the builtin SPIR-V type.

TypeName is the full string representation of the SPIR-V or OpenCL builtin type.

Definition at line 2439 of file SPIRVBuiltins.cpp.

References assert(), llvm::StringRef::contains(), Context, llvm::StringRef::find(), llvm::TargetExtType::get(), isDigit(), llvm::parseTypeString(), llvm::SmallVectorTemplateBase< T, bool >::push_back(), llvm::report_fatal_error(), llvm::SPIRV::OpenCLType::SpirvTypeLiteral, llvm::StringRef::starts_with(), and llvm::StringRef::substr().

Referenced by llvm::SPIRVGlobalRegistry::getOrCreateSPIRVTypeByName(), lowerBuiltinType(), and parseBuiltinCallArgumentBaseType().