1//===--- OpenCLExtensions.def - OpenCL extension list -----------*- 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// This file defines the list of supported OpenCL extensions. 10// 11//===----------------------------------------------------------------------===// 12 13// Macro OPENCLEXTNAME or OPENCL_GENERIC_EXTENSION can be defined to enumerate all 14// OpenCL extensions listed in this file. 15// 16// If extensions are to be enumerated with information about whether 17// an extension is core or optional core and minimum OpenCL version 18// when an extension becomes available, 19// define OPENCL_GENERIC_EXTENSION(ext, pragma, avail, core, opt) where 20// ext - name of the extension or optional core feature. 21// pragma - true if extension needs pragmas or false otherwise. 22// NOTE: extension pragma without any documentation detailing 23// its behavior explicitly is deprecated. Therefore the default 24// value is false. 25// avail - minimum OpenCL version supporting it. 26// core - OpenCL versions mask when the extension becomes core feature. 27// 0U indicates not a core feature. 28// opt - OpenCL versions mask when the extension becomes optional core 29// feature. 0U indicates not a optional core feature. 30// 31// If extensions are to be enumerated without any information, 32// define OPENCLEXTNAME(ext) where ext is the name of the extension. 33// 34// Difference between optional core feature and core feature is that the 35// later is unconditionally supported in specific OpenCL version. 36// 37// As per The OpenCL Extension Specification, Section 1.2, in this file, an 38// extension is defined if and only it either: 39// * affects the OpenCL language semantics or its syntax, 40// * adds built-in functions to the language. 41// 42// For such an extension, a preprocessor #define that matches the extension 43// name must be created and a #pragma is required if and only if the 44// compilation flow is impacted, e.g. due to a difference of syntax or 45// semantics in the language compared to the core standard. #pragma directive 46// has no effect for optional core and core features. 47 48#ifndef OPENCL_GENERIC_EXTENSION 49#ifndef OPENCLEXTNAME 50#pragma error "macro OPENCLEXTNAME or OPENCL_GENERIC_EXTENSION is required" 51#else 52#define OPENCL_GENERIC_EXTENSION(ext, ...) OPENCLEXTNAME(ext) 53#endif // OPENCLEXTNAME 54#endif // OPENCL_GENERIC_EXTENSION 55 56// Declaration helpers 57#define OPENCL_EXTENSION(ext, pragma, avail) OPENCL_GENERIC_EXTENSION(ext, pragma, avail, 0U, 0U) 58#define OPENCL_COREFEATURE(ext, pragma, avail, core) OPENCL_GENERIC_EXTENSION(ext, pragma, avail, core, 0U) 59#define OPENCL_OPTIONALCOREFEATURE(ext, pragma, avail, opt) OPENCL_GENERIC_EXTENSION(ext, pragma, avail, 0U, opt) 60 61// OpenCL 1.0. 62OPENCL_COREFEATURE(cl_khr_byte_addressable_store, true, 100, OCL_C_11P) 63OPENCL_COREFEATURE(cl_khr_global_int32_base_atomics, true, 100, OCL_C_11P) 64OPENCL_COREFEATURE(cl_khr_global_int32_extended_atomics, true, 100, OCL_C_11P) 65OPENCL_COREFEATURE(cl_khr_local_int32_base_atomics, true, 100, OCL_C_11P) 66OPENCL_COREFEATURE(cl_khr_local_int32_extended_atomics, true, 100, OCL_C_11P) 67OPENCL_OPTIONALCOREFEATURE(cl_khr_fp64, true, 100, OCL_C_12P) 68OPENCL_EXTENSION(cl_khr_fp16, true, 100) 69OPENCL_EXTENSION(cl_khr_int64_base_atomics, true, 100) 70OPENCL_EXTENSION(cl_khr_int64_extended_atomics, true, 100) 71OPENCL_GENERIC_EXTENSION(cl_khr_3d_image_writes, true, 100, OCL_C_20, OCL_C_30) 72 73// EMBEDDED_PROFILE 74OPENCL_EXTENSION(cles_khr_int64, true, 110) 75 76// OpenCL 1.2. 77OPENCL_EXTENSION(cl_khr_depth_images, true, 120) 78OPENCL_EXTENSION(cl_khr_gl_msaa_sharing,true, 120) 79 80// OpenCL 2.0. 81OPENCL_EXTENSION(cl_khr_mipmap_image, true, 200) 82OPENCL_EXTENSION(cl_khr_mipmap_image_writes, true, 200) 83OPENCL_EXTENSION(cl_khr_srgb_image_writes, true, 200) 84OPENCL_EXTENSION(cl_khr_subgroups, true, 200) 85 86// Clang Extensions. 87OPENCL_EXTENSION(cl_clang_storage_class_specifiers, true, 100) 88OPENCL_EXTENSION(__cl_clang_function_pointers, true, 100) 89OPENCL_EXTENSION(__cl_clang_variadic_functions, true, 100) 90OPENCL_EXTENSION(__cl_clang_non_portable_kernel_param_types, true, 100) 91OPENCL_EXTENSION(__cl_clang_bitfields, true, 100) 92 93// AMD OpenCL extensions 94OPENCL_EXTENSION(cl_amd_media_ops, true, 100) 95OPENCL_EXTENSION(cl_amd_media_ops2, true, 100) 96 97// ARM OpenCL extensions 98OPENCL_EXTENSION(cl_arm_integer_dot_product_int8, true, 120) 99OPENCL_EXTENSION(cl_arm_integer_dot_product_accumulate_int8, true, 120) 100OPENCL_EXTENSION(cl_arm_integer_dot_product_accumulate_int16, true, 120) 101OPENCL_EXTENSION(cl_arm_integer_dot_product_accumulate_saturate_int8, true, 120) 102 103// Intel OpenCL extensions 104OPENCL_EXTENSION(cl_intel_subgroups, true, 120) 105OPENCL_EXTENSION(cl_intel_subgroups_short, true, 120) 106OPENCL_EXTENSION(cl_intel_device_side_avc_motion_estimation, true, 120) 107 108// OpenCL C 3.0 features (6.2.1. Features) 109OPENCL_OPTIONALCOREFEATURE(__opencl_c_pipes, false, 300, OCL_C_30) 110OPENCL_OPTIONALCOREFEATURE(__opencl_c_generic_address_space, false, 300, OCL_C_30) 111OPENCL_OPTIONALCOREFEATURE(__opencl_c_atomic_order_acq_rel, false, 300, OCL_C_30) 112OPENCL_OPTIONALCOREFEATURE(__opencl_c_atomic_order_seq_cst, false, 300, OCL_C_30) 113OPENCL_OPTIONALCOREFEATURE(__opencl_c_subgroups, false, 300, OCL_C_30) 114OPENCL_OPTIONALCOREFEATURE(__opencl_c_3d_image_writes, false, 300, OCL_C_30) 115OPENCL_OPTIONALCOREFEATURE(__opencl_c_device_enqueue, false, 300, OCL_C_30) 116OPENCL_OPTIONALCOREFEATURE(__opencl_c_read_write_images, false, 300, OCL_C_30) 117OPENCL_OPTIONALCOREFEATURE(__opencl_c_program_scope_global_variables, false, 300, OCL_C_30) 118OPENCL_OPTIONALCOREFEATURE(__opencl_c_fp64, false, 300, OCL_C_30) 119OPENCL_OPTIONALCOREFEATURE(__opencl_c_images, false, 300, OCL_C_30) 120 121#undef OPENCL_OPTIONALCOREFEATURE 122#undef OPENCL_COREFEATURE 123#undef OPENCL_GENERIC_EXTENSION 124 125#ifdef OPENCLEXTNAME 126#undef OPENCLEXTNAME 127#endif 128