1/**************************************************************************
2 *
3 * Copyright 2009 VMware, Inc.
4 * All Rights Reserved.
5 *
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
13 *
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
16 * of the Software.
17 *
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL VMWARE AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 *
26 **************************************************************************/
27
28/**
29 * @file
30 * Helper functions for calling intrinsics.
31 *
32 * @author Jose Fonseca <jfonseca@vmware.com>
33 */
34
35
36#ifndef LP_BLD_INTR_H
37#define LP_BLD_INTR_H
38
39
40#include "gallivm/lp_bld.h"
41#include "gallivm/lp_bld_init.h"
42
43
44/**
45 * Max number of arguments in an intrinsic.
46 */
47#define LP_MAX_FUNC_ARGS 32
48
49enum lp_func_attr {
50   LP_FUNC_ATTR_ALWAYSINLINE = (1 << 0),
51   LP_FUNC_ATTR_INREG        = (1 << 2),
52   LP_FUNC_ATTR_NOALIAS      = (1 << 3),
53   LP_FUNC_ATTR_NOUNWIND     = (1 << 4),
54   LP_FUNC_ATTR_READNONE     = (1 << 5),
55   LP_FUNC_ATTR_READONLY     = (1 << 6),
56   LP_FUNC_ATTR_WRITEONLY    = HAVE_LLVM >= 0x0400 ? (1 << 7) : 0,
57   LP_FUNC_ATTR_INACCESSIBLE_MEM_ONLY = HAVE_LLVM >= 0x0400 ? (1 << 8) : 0,
58   LP_FUNC_ATTR_CONVERGENT   = HAVE_LLVM >= 0x0400 ? (1 << 9) : 0,
59
60   /* Legacy intrinsic that needs attributes on function declarations
61    * and they must match the internal LLVM definition exactly, otherwise
62    * intrinsic selection fails.
63    */
64   LP_FUNC_ATTR_LEGACY       = (1u << 31),
65};
66
67void
68lp_format_intrinsic(char *name,
69                    size_t size,
70                    const char *name_root,
71                    LLVMTypeRef type);
72
73LLVMValueRef
74lp_declare_intrinsic(LLVMModuleRef module,
75                     const char *name,
76                     LLVMTypeRef ret_type,
77                     LLVMTypeRef *arg_types,
78                     unsigned num_args);
79
80void
81lp_add_function_attr(LLVMValueRef function_or_call,
82                     int attr_idx, enum lp_func_attr attr);
83
84LLVMValueRef
85lp_build_intrinsic(LLVMBuilderRef builder,
86                   const char *name,
87                   LLVMTypeRef ret_type,
88                   LLVMValueRef *args,
89                   unsigned num_args,
90                   unsigned attr_mask);
91
92
93LLVMValueRef
94lp_build_intrinsic_unary(LLVMBuilderRef builder,
95                         const char *name,
96                         LLVMTypeRef ret_type,
97                         LLVMValueRef a);
98
99
100LLVMValueRef
101lp_build_intrinsic_binary(LLVMBuilderRef builder,
102                          const char *name,
103                          LLVMTypeRef ret_type,
104                          LLVMValueRef a,
105                          LLVMValueRef b);
106
107
108LLVMValueRef
109lp_build_intrinsic_binary_anylength(struct gallivm_state *gallivm,
110                                    const char *name,
111                                    struct lp_type src_type,
112                                    unsigned intr_size,
113                                    LLVMValueRef a,
114                                    LLVMValueRef b);
115
116
117LLVMValueRef
118lp_build_intrinsic_map(struct gallivm_state *gallivm,
119                       const char *name,
120                       LLVMTypeRef ret_type,
121                       LLVMValueRef *args,
122                       unsigned num_args);
123
124
125LLVMValueRef
126lp_build_intrinsic_map_unary(struct gallivm_state *gallivm,
127                             const char *name,
128                             LLVMTypeRef ret_type,
129                             LLVMValueRef a);
130
131
132LLVMValueRef
133lp_build_intrinsic_map_binary(struct gallivm_state *gallivm,
134                              const char *name,
135                              LLVMTypeRef ret_type,
136                              LLVMValueRef a,
137                              LLVMValueRef b);
138
139
140#endif /* !LP_BLD_INTR_H */
141