src/amd/common/ac_llvm_util.h

   1 /*
   2  * Copyright 2016 Bas Nieuwenhuizen
   3  *
   4  * Permission is hereby granted, free of charge, to any person obtaining a
   5  * copy of this software and associated documentation files (the
   6  * "Software"), to deal in the Software without restriction, including
   7  * without limitation the rights to use, copy, modify, merge, publish,
   8  * distribute, sub license, and/or sell copies of the Software, and to
   9  * permit persons to whom the Software is furnished to do so, subject to
  10  * the following conditions:
  11  *
  12  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  13  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  14  * FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT. IN NO EVENT SHALL
  15  * THE COPYRIGHT HOLDERS, AUTHORS AND/OR ITS SUPPLIERS BE LIABLE FOR ANY CLAIM,
  16  * DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR
  17  * OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE
  18  * USE OR OTHER DEALINGS IN THE SOFTWARE.
  19  *
  20  * The above copyright notice and this permission notice (including the
  21  * next paragraph) shall be included in all copies or substantial portions
  22  * of the Software.
  23  *
  24  */
  25
  26 #ifndef AC_LLVM_UTIL_H
  27 #define AC_LLVM_UTIL_H
  28
  29 #include <stdbool.h>
  30 #include <llvm-c/TargetMachine.h>
  31
  32 #include "amd_family.h"
  33
  34 #ifdef __cplusplus
  35 extern "C" {
  36 #endif
  37
  38 enum ac_func_attr {
  39         AC_FUNC_ATTR_ALWAYSINLINE = (1 << 0),
  40         AC_FUNC_ATTR_INREG        = (1 << 2),
  41         AC_FUNC_ATTR_NOALIAS      = (1 << 3),
  42         AC_FUNC_ATTR_NOUNWIND     = (1 << 4),
  43         AC_FUNC_ATTR_READNONE     = (1 << 5),
  44         AC_FUNC_ATTR_READONLY     = (1 << 6),
  45         AC_FUNC_ATTR_WRITEONLY    = (1 << 7),
  46         AC_FUNC_ATTR_INACCESSIBLE_MEM_ONLY = (1 << 8),
  47         AC_FUNC_ATTR_CONVERGENT = (1 << 9),
  48
  49         /* Legacy intrinsic that needs attributes on function declarations
  50          * and they must match the internal LLVM definition exactly, otherwise
  51          * intrinsic selection fails.
  52          */
  53         AC_FUNC_ATTR_LEGACY       = (1u << 31),
  54 };
  55
  56 enum ac_target_machine_options {
  57         AC_TM_SUPPORTS_SPILL = (1 << 0),
  58         AC_TM_SISCHED = (1 << 1),
  59         AC_TM_FORCE_ENABLE_XNACK = (1 << 2),
  60         AC_TM_FORCE_DISABLE_XNACK = (1 << 3),
  61         AC_TM_PROMOTE_ALLOCA_TO_SCRATCH = (1 << 4),
  62 };
  63
  64 enum ac_float_mode {
  65         AC_FLOAT_MODE_DEFAULT,
  66         AC_FLOAT_MODE_NO_SIGNED_ZEROS_FP_MATH,
  67         AC_FLOAT_MODE_UNSAFE_FP_MATH,
  68 };
  69
  70 const char *ac_get_llvm_processor_name(enum radeon_family family);
  71 LLVMTargetMachineRef ac_create_target_machine(enum radeon_family family,
  72                                               enum ac_target_machine_options tm_options,
  73                                               const char **out_triple);
  74
  75 LLVMTargetRef ac_get_llvm_target(const char *triple);
  76 void ac_add_attr_dereferenceable(LLVMValueRef val, uint64_t bytes);
  77 bool ac_is_sgpr_param(LLVMValueRef param);
  78 void ac_add_function_attr(LLVMContextRef ctx, LLVMValueRef function,
  79                           int attr_idx, enum ac_func_attr attr);
  80 void ac_add_func_attributes(LLVMContextRef ctx, LLVMValueRef function,
  81                             unsigned attrib_mask);
  82 void ac_dump_module(LLVMModuleRef module);
  83
  84 LLVMValueRef ac_llvm_get_called_value(LLVMValueRef call);
  85 bool ac_llvm_is_function(LLVMValueRef v);
  86 LLVMModuleRef ac_create_module(LLVMTargetMachineRef tm, LLVMContextRef ctx);
  87
  88 LLVMBuilderRef ac_create_builder(LLVMContextRef ctx,
  89                                  enum ac_float_mode float_mode);
  90
  91 void
  92 ac_llvm_add_target_dep_function_attr(LLVMValueRef F,
  93                                      const char *name, unsigned value);
  94
  95 static inline unsigned
  96 ac_get_load_intr_attribs(bool can_speculate)
  97 {
  98         /* READNONE means writes can't affect it, while READONLY means that
  99          * writes can affect it. */
 100         return can_speculate ? AC_FUNC_ATTR_READNONE :
 101                                AC_FUNC_ATTR_READONLY;
 102 }
 103
 104 static inline unsigned
 105 ac_get_store_intr_attribs(bool writeonly_memory)
 106 {
 107         return writeonly_memory ? AC_FUNC_ATTR_INACCESSIBLE_MEM_ONLY :
 108                                   AC_FUNC_ATTR_WRITEONLY;
 109 }
 110
 111 unsigned
 112 ac_count_scratch_private_memory(LLVMValueRef function);
 113
 114 #ifdef __cplusplus
 115 }
 116 #endif
 117
 118 #endif /* AC_LLVM_UTIL_H */