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"
17 #include "llvm/CodeGen/GlobalISel/CallLowering.h"
18 #include "llvm/CodeGen/GlobalISel/MachineIRBuilder.h"
19 
20 namespace llvm {
21 namespace 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.
34 std::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,
39                                  SPIRVGlobalRegistry *GR);
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.
48 SPIRVType *lowerBuiltinType(const StructType *Type,
49                             AccessQualifier::AccessQualifier AccessQual,
50                             MachineIRBuilder &MIRBuilder,
51                             SPIRVGlobalRegistry *GR);
52 } // namespace SPIRV
53 } // namespace llvm
54 #endif // LLVM_LIB_TARGET_SPIRV_SPIRVBUILTINS_H
55