LLVM 19.0.0git
Go to the documentation of this file.
1//===-- SPIRVBuiltins.h - SPIR-V Built-in Functions -------------*- C++ -*-===//
3// Part of the LLVM Project, under the Apache License v2.0 with LLVM Exceptions.
4// See https://llvm.org/LICENSE.txt for license information.
5// SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
9// Lowering builtin function calls and types using their demangled names.
16#include "SPIRVGlobalRegistry.h"
20namespace llvm {
21namespace SPIRV {
22/// Lowers a builtin funtion call using the provided \p DemangledCall skeleton
23/// and external instruction \p Set.
25/// \return the lowering success status if the called function is a recognized
26/// builtin, std::nullopt otherwise.
28/// \p DemangledCall is the skeleton of the lowered builtin function call.
29/// \p Set is the external instruction set containing the given builtin.
30/// \p OrigRet is the single original virtual return register if defined,
31/// Register(0) otherwise.
32/// \p OrigRetTy is the type of the \p OrigRet.
33/// \p Args are the arguments of the lowered builtin call.
34std::optional<bool> lowerBuiltin(const StringRef DemangledCall,
35 InstructionSet::InstructionSet Set,
36 MachineIRBuilder &MIRBuilder,
37 const Register OrigRet, const Type *OrigRetTy,
38 const SmallVectorImpl<Register> &Args,
41/// Parses the provided \p ArgIdx argument base type in the \p DemangledCall
42/// skeleton. A base type is either a basic type (e.g. i32 for int), pointer
43/// element type (e.g. i8 for char*), or builtin type (TargetExtType).
45/// \return LLVM Type or nullptr if unrecognized
47/// \p DemangledCall is the skeleton of the lowered builtin function call.
48/// \p ArgIdx is the index of the argument to parse.
50 unsigned ArgIdx, LLVMContext &Ctx);
52/// Translates a string representing a SPIR-V or OpenCL builtin type to a
53/// TargetExtType that can be further lowered with lowerBuiltinType().
55/// \return A TargetExtType representing the builtin SPIR-V type.
57/// \p TypeName is the full string representation of the SPIR-V or OpenCL
58/// builtin type.
60 LLVMContext &Context);
62/// Handles the translation of the provided special opaque/builtin type \p Type
63/// to SPIR-V type. Generates the corresponding machine instructions for the
64/// target type or gets the already existing OpType<...> register from the
65/// global registry \p GR.
67/// \return A machine instruction representing the OpType<...> SPIR-V type.
69/// \p Type is the special opaque/builtin type to be lowered.
71 AccessQualifier::AccessQualifier AccessQual,
72 MachineIRBuilder &MIRBuilder,
74} // namespace SPIRV
75} // namespace llvm
This file describes how to lower LLVM calls to machine code calls.
This file declares the MachineIRBuilder class.
This is an important class for using LLVM in a threaded context.
Definition: LLVMContext.h:67
Helper class to build MachineInstr.
Representation of each machine instruction.
Definition: MachineInstr.h:69
Wrapper class representing virtual and physical registers.
Definition: Register.h:19
This class consists of common code factored out of the SmallVector class to reduce code duplication b...
Definition: SmallVector.h:586
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
Class to represent target extensions types, which are generally unintrospectable from target-independ...
Definition: DerivedTypes.h:720
The instances of the Type class are immutable: once they are created, they are never changed.
Definition: Type.h:45
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 furth...
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)
SPIRVType * lowerBuiltinType(const Type *OpaqueType, SPIRV::AccessQualifier::AccessQualifier AccessQual, MachineIRBuilder &MIRBuilder, SPIRVGlobalRegistry *GR)
This is an optimization pass for GlobalISel generic memory operations.
Definition: AddressRanges.h:18