LLVM 18.0.0git
SPIRVBuiltins.h
Go to the documentation of this file.
1//===-- SPIRVBuiltins.h - SPIR-V Built-in Functions -------------*- C++ -*-===//
2//
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
6//
7//===----------------------------------------------------------------------===//
8//
9// Lowering builtin function calls and types using their demangled names.
10//
11//===----------------------------------------------------------------------===//
12
13#ifndef LLVM_LIB_TARGET_SPIRV_SPIRVBUILTINS_H
14#define LLVM_LIB_TARGET_SPIRV_SPIRVBUILTINS_H
15
16#include "SPIRVGlobalRegistry.h"
19
20namespace llvm {
21namespace SPIRV {
22/// Lowers a builtin funtion call using the provided \p DemangledCall skeleton
23/// and external instruction \p Set.
24///
25/// \return the lowering success status if the called function is a recognized
26/// builtin, std::nullopt otherwise.
27///
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,
40/// Handles the translation of the provided special opaque/builtin type \p Type
41/// to SPIR-V type. Generates the corresponding machine instructions for the
42/// target type or gets the already existing OpType<...> register from the
43/// global registry \p GR.
44///
45/// \return A machine instruction representing the OpType<...> SPIR-V type.
46///
47/// \p Type is the special opaque/builtin type to be lowered.
49 AccessQualifier::AccessQualifier AccessQual,
50 MachineIRBuilder &MIRBuilder,
52} // namespace SPIRV
53} // namespace llvm
54#endif // LLVM_LIB_TARGET_SPIRV_SPIRVBUILTINS_H
This file describes how to lower LLVM calls to machine code calls.
This file declares the MachineIRBuilder class.
Helper class to build MachineInstr.
Representation of each machine instruction.
Definition: MachineInstr.h:68
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:577
StringRef - Represent a constant reference to a string, i.e.
Definition: StringRef.h:50
The instances of the Type class are immutable: once they are created, they are never changed.
Definition: Type.h:45
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