1 /*******************************************************************************
2 * Copyright (c) 2008-2019 The Khronos Group Inc.
4 * Permission is hereby granted, free of charge, to any person obtaining a
5 * copy of this software and/or associated documentation files (the
6 * "Materials"), to deal in the Materials without restriction, including
7 * without limitation the rights to use, copy, modify, merge, publish,
8 * distribute, sublicense, and/or sell copies of the Materials, and to
9 * permit persons to whom the Materials are furnished to do so, subject to
10 * the following conditions:
12 * The above copyright notice and this permission notice shall be included
13 * in all copies or substantial portions of the Materials.
15 * MODIFICATIONS TO THIS FILE MAY MEAN IT NO LONGER ACCURATELY REFLECTS
16 * KHRONOS STANDARDS. THE UNMODIFIED, NORMATIVE VERSIONS OF KHRONOS
17 * SPECIFICATIONS AND HEADER INFORMATION ARE LOCATED AT
18 * https://www.khronos.org/registry/
20 * THE MATERIALS ARE PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
21 * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
22 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
23 * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
24 * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
25 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
26 * MATERIALS OR THE USE OR OTHER DEALINGS IN THE MATERIALS.
27 ******************************************************************************/
29 /* cl_ext.h contains OpenCL extensions which don't have external */
30 /* (OpenGL, D3D) dependencies. */
41 /* cl_khr_fp64 extension - no extension #define since it has no functions */
42 /* CL_DEVICE_DOUBLE_FP_CONFIG is defined in CL.h for OpenCL >= 120 */
44 #if CL_TARGET_OPENCL_VERSION <= 110
45 #define CL_DEVICE_DOUBLE_FP_CONFIG 0x1032
48 /* cl_khr_fp16 extension - no extension #define since it has no functions */
49 #define CL_DEVICE_HALF_FP_CONFIG 0x1033
51 /* Memory object destruction
53 * Apple extension for use to manage externally allocated buffers used with cl_mem objects with CL_MEM_USE_HOST_PTR
55 * Registers a user callback function that will be called when the memory object is deleted and its resources
56 * freed. Each call to clSetMemObjectCallbackFn registers the specified user callback function on a callback
57 * stack associated with memobj. The registered user callback functions are called in the reverse order in
58 * which they were registered. The user callback functions are called and then the memory object is deleted
59 * and its resources freed. This provides a mechanism for the application (and libraries) using memobj to be
60 * notified when the memory referenced by host_ptr, specified when the memory object is created and used as
61 * the storage bits for the memory object, can be reused or freed.
63 * The application may not call CL api's with the cl_mem object passed to the pfn_notify.
65 * Please check for the "cl_APPLE_SetMemObjectDestructor" extension using clGetDeviceInfo(CL_DEVICE_EXTENSIONS)
68 #define cl_APPLE_SetMemObjectDestructor 1
69 cl_int CL_API_ENTRY
clSetMemObjectDestructorAPPLE( cl_mem memobj
,
70 void (* pfn_notify
)(cl_mem memobj
, void * user_data
),
71 void * user_data
) CL_EXT_SUFFIX__VERSION_1_0
;
74 /* Context Logging Functions
76 * The next three convenience functions are intended to be used as the pfn_notify parameter to clCreateContext().
77 * Please check for the "cl_APPLE_ContextLoggingFunctions" extension using clGetDeviceInfo(CL_DEVICE_EXTENSIONS)
80 * clLogMessagesToSystemLog forwards on all log messages to the Apple System Logger
82 #define cl_APPLE_ContextLoggingFunctions 1
83 extern void CL_API_ENTRY
clLogMessagesToSystemLogAPPLE( const char * errstr
,
84 const void * private_info
,
86 void * user_data
) CL_EXT_SUFFIX__VERSION_1_0
;
88 /* clLogMessagesToStdout sends all log messages to the file descriptor stdout */
89 extern void CL_API_ENTRY
clLogMessagesToStdoutAPPLE( const char * errstr
,
90 const void * private_info
,
92 void * user_data
) CL_EXT_SUFFIX__VERSION_1_0
;
94 /* clLogMessagesToStderr sends all log messages to the file descriptor stderr */
95 extern void CL_API_ENTRY
clLogMessagesToStderrAPPLE( const char * errstr
,
96 const void * private_info
,
98 void * user_data
) CL_EXT_SUFFIX__VERSION_1_0
;
101 /************************
102 * cl_khr_icd extension *
103 ************************/
106 /* cl_platform_info */
107 #define CL_PLATFORM_ICD_SUFFIX_KHR 0x0920
109 /* Additional Error Codes */
110 #define CL_PLATFORM_NOT_FOUND_KHR -1001
112 extern CL_API_ENTRY cl_int CL_API_CALL
113 clIcdGetPlatformIDsKHR(cl_uint num_entries
,
114 cl_platform_id
* platforms
,
115 cl_uint
* num_platforms
);
117 typedef CL_API_ENTRY cl_int
118 (CL_API_CALL
*clIcdGetPlatformIDsKHR_fn
)(cl_uint num_entries
,
119 cl_platform_id
* platforms
,
120 cl_uint
* num_platforms
);
123 /*******************************
124 * cl_khr_il_program extension *
125 *******************************/
126 #define cl_khr_il_program 1
128 /* New property to clGetDeviceInfo for retrieving supported intermediate
131 #define CL_DEVICE_IL_VERSION_KHR 0x105B
133 /* New property to clGetProgramInfo for retrieving for retrieving the IL of a
136 #define CL_PROGRAM_IL_KHR 0x1169
138 extern CL_API_ENTRY cl_program CL_API_CALL
139 clCreateProgramWithILKHR(cl_context context
,
142 cl_int
* errcode_ret
);
144 typedef CL_API_ENTRY cl_program
145 (CL_API_CALL
*clCreateProgramWithILKHR_fn
)(cl_context context
,
148 cl_int
* errcode_ret
) CL_EXT_SUFFIX__VERSION_1_2
;
150 /* Extension: cl_khr_image2d_from_buffer
152 * This extension allows a 2D image to be created from a cl_mem buffer without
153 * a copy. The type associated with a 2D image created from a buffer in an
154 * OpenCL program is image2d_t. Both the sampler and sampler-less read_image
155 * built-in functions are supported for 2D images and 2D images created from
156 * a buffer. Similarly, the write_image built-ins are also supported for 2D
157 * images created from a buffer.
159 * When the 2D image from buffer is created, the client must specify the
160 * width, height, image format (i.e. channel order and channel data type)
161 * and optionally the row pitch.
163 * The pitch specified must be a multiple of
164 * CL_DEVICE_IMAGE_PITCH_ALIGNMENT_KHR pixels.
165 * The base address of the buffer must be aligned to
166 * CL_DEVICE_IMAGE_BASE_ADDRESS_ALIGNMENT_KHR pixels.
169 #define CL_DEVICE_IMAGE_PITCH_ALIGNMENT_KHR 0x104A
170 #define CL_DEVICE_IMAGE_BASE_ADDRESS_ALIGNMENT_KHR 0x104B
173 /**************************************
174 * cl_khr_initialize_memory extension *
175 **************************************/
177 #define CL_CONTEXT_MEMORY_INITIALIZE_KHR 0x2030
180 /**************************************
181 * cl_khr_terminate_context extension *
182 **************************************/
184 #define CL_DEVICE_TERMINATE_CAPABILITY_KHR 0x2031
185 #define CL_CONTEXT_TERMINATE_KHR 0x2032
187 #define cl_khr_terminate_context 1
188 extern CL_API_ENTRY cl_int CL_API_CALL
189 clTerminateContextKHR(cl_context context
) CL_EXT_SUFFIX__VERSION_1_2
;
191 typedef CL_API_ENTRY cl_int
192 (CL_API_CALL
*clTerminateContextKHR_fn
)(cl_context context
) CL_EXT_SUFFIX__VERSION_1_2
;
196 * Extension: cl_khr_spir
198 * This extension adds support to create an OpenCL program object from a
199 * Standard Portable Intermediate Representation (SPIR) instance
202 #define CL_DEVICE_SPIR_VERSIONS 0x40E0
203 #define CL_PROGRAM_BINARY_TYPE_INTERMEDIATE 0x40E1
206 /*****************************************
207 * cl_khr_create_command_queue extension *
208 *****************************************/
209 #define cl_khr_create_command_queue 1
211 typedef cl_bitfield cl_queue_properties_khr
;
213 extern CL_API_ENTRY cl_command_queue CL_API_CALL
214 clCreateCommandQueueWithPropertiesKHR(cl_context context
,
216 const cl_queue_properties_khr
* properties
,
217 cl_int
* errcode_ret
) CL_EXT_SUFFIX__VERSION_1_2
;
219 typedef CL_API_ENTRY cl_command_queue
220 (CL_API_CALL
*clCreateCommandQueueWithPropertiesKHR_fn
)(cl_context context
,
222 const cl_queue_properties_khr
* properties
,
223 cl_int
* errcode_ret
) CL_EXT_SUFFIX__VERSION_1_2
;
226 /******************************************
227 * cl_nv_device_attribute_query extension *
228 ******************************************/
230 /* cl_nv_device_attribute_query extension - no extension #define since it has no functions */
231 #define CL_DEVICE_COMPUTE_CAPABILITY_MAJOR_NV 0x4000
232 #define CL_DEVICE_COMPUTE_CAPABILITY_MINOR_NV 0x4001
233 #define CL_DEVICE_REGISTERS_PER_BLOCK_NV 0x4002
234 #define CL_DEVICE_WARP_SIZE_NV 0x4003
235 #define CL_DEVICE_GPU_OVERLAP_NV 0x4004
236 #define CL_DEVICE_KERNEL_EXEC_TIMEOUT_NV 0x4005
237 #define CL_DEVICE_INTEGRATED_MEMORY_NV 0x4006
240 /*********************************
241 * cl_amd_device_attribute_query *
242 *********************************/
244 #define CL_DEVICE_PROFILING_TIMER_OFFSET_AMD 0x4036
247 /*********************************
248 * cl_arm_printf extension
249 *********************************/
251 #define CL_PRINTF_CALLBACK_ARM 0x40B0
252 #define CL_PRINTF_BUFFERSIZE_ARM 0x40B1
255 /***********************************
256 * cl_ext_device_fission extension
257 ***********************************/
258 #define cl_ext_device_fission 1
260 extern CL_API_ENTRY cl_int CL_API_CALL
261 clReleaseDeviceEXT(cl_device_id device
) CL_EXT_SUFFIX__VERSION_1_1
;
263 typedef CL_API_ENTRY cl_int
264 (CL_API_CALL
*clReleaseDeviceEXT_fn
)(cl_device_id device
) CL_EXT_SUFFIX__VERSION_1_1
;
266 extern CL_API_ENTRY cl_int CL_API_CALL
267 clRetainDeviceEXT(cl_device_id device
) CL_EXT_SUFFIX__VERSION_1_1
;
269 typedef CL_API_ENTRY cl_int
270 (CL_API_CALL
*clRetainDeviceEXT_fn
)(cl_device_id device
) CL_EXT_SUFFIX__VERSION_1_1
;
272 typedef cl_ulong cl_device_partition_property_ext
;
273 extern CL_API_ENTRY cl_int CL_API_CALL
274 clCreateSubDevicesEXT(cl_device_id in_device
,
275 const cl_device_partition_property_ext
* properties
,
277 cl_device_id
* out_devices
,
278 cl_uint
* num_devices
) CL_EXT_SUFFIX__VERSION_1_1
;
280 typedef CL_API_ENTRY cl_int
281 (CL_API_CALL
* clCreateSubDevicesEXT_fn
)(cl_device_id in_device
,
282 const cl_device_partition_property_ext
* properties
,
284 cl_device_id
* out_devices
,
285 cl_uint
* num_devices
) CL_EXT_SUFFIX__VERSION_1_1
;
287 /* cl_device_partition_property_ext */
288 #define CL_DEVICE_PARTITION_EQUALLY_EXT 0x4050
289 #define CL_DEVICE_PARTITION_BY_COUNTS_EXT 0x4051
290 #define CL_DEVICE_PARTITION_BY_NAMES_EXT 0x4052
291 #define CL_DEVICE_PARTITION_BY_AFFINITY_DOMAIN_EXT 0x4053
293 /* clDeviceGetInfo selectors */
294 #define CL_DEVICE_PARENT_DEVICE_EXT 0x4054
295 #define CL_DEVICE_PARTITION_TYPES_EXT 0x4055
296 #define CL_DEVICE_AFFINITY_DOMAINS_EXT 0x4056
297 #define CL_DEVICE_REFERENCE_COUNT_EXT 0x4057
298 #define CL_DEVICE_PARTITION_STYLE_EXT 0x4058
301 #define CL_DEVICE_PARTITION_FAILED_EXT -1057
302 #define CL_INVALID_PARTITION_COUNT_EXT -1058
303 #define CL_INVALID_PARTITION_NAME_EXT -1059
305 /* CL_AFFINITY_DOMAINs */
306 #define CL_AFFINITY_DOMAIN_L1_CACHE_EXT 0x1
307 #define CL_AFFINITY_DOMAIN_L2_CACHE_EXT 0x2
308 #define CL_AFFINITY_DOMAIN_L3_CACHE_EXT 0x3
309 #define CL_AFFINITY_DOMAIN_L4_CACHE_EXT 0x4
310 #define CL_AFFINITY_DOMAIN_NUMA_EXT 0x10
311 #define CL_AFFINITY_DOMAIN_NEXT_FISSIONABLE_EXT 0x100
313 /* cl_device_partition_property_ext list terminators */
314 #define CL_PROPERTIES_LIST_END_EXT ((cl_device_partition_property_ext) 0)
315 #define CL_PARTITION_BY_COUNTS_LIST_END_EXT ((cl_device_partition_property_ext) 0)
316 #define CL_PARTITION_BY_NAMES_LIST_END_EXT ((cl_device_partition_property_ext) 0 - 1)
319 /***********************************
320 * cl_ext_migrate_memobject extension definitions
321 ***********************************/
322 #define cl_ext_migrate_memobject 1
324 typedef cl_bitfield cl_mem_migration_flags_ext
;
326 #define CL_MIGRATE_MEM_OBJECT_HOST_EXT 0x1
328 #define CL_COMMAND_MIGRATE_MEM_OBJECT_EXT 0x4040
330 extern CL_API_ENTRY cl_int CL_API_CALL
331 clEnqueueMigrateMemObjectEXT(cl_command_queue command_queue
,
332 cl_uint num_mem_objects
,
333 const cl_mem
* mem_objects
,
334 cl_mem_migration_flags_ext flags
,
335 cl_uint num_events_in_wait_list
,
336 const cl_event
* event_wait_list
,
339 typedef CL_API_ENTRY cl_int
340 (CL_API_CALL
*clEnqueueMigrateMemObjectEXT_fn
)(cl_command_queue command_queue
,
341 cl_uint num_mem_objects
,
342 const cl_mem
* mem_objects
,
343 cl_mem_migration_flags_ext flags
,
344 cl_uint num_events_in_wait_list
,
345 const cl_event
* event_wait_list
,
349 /*********************************
350 * cl_qcom_ext_host_ptr extension
351 *********************************/
352 #define cl_qcom_ext_host_ptr 1
354 #define CL_MEM_EXT_HOST_PTR_QCOM (1 << 29)
356 #define CL_DEVICE_EXT_MEM_PADDING_IN_BYTES_QCOM 0x40A0
357 #define CL_DEVICE_PAGE_SIZE_QCOM 0x40A1
358 #define CL_IMAGE_ROW_ALIGNMENT_QCOM 0x40A2
359 #define CL_IMAGE_SLICE_ALIGNMENT_QCOM 0x40A3
360 #define CL_MEM_HOST_UNCACHED_QCOM 0x40A4
361 #define CL_MEM_HOST_WRITEBACK_QCOM 0x40A5
362 #define CL_MEM_HOST_WRITETHROUGH_QCOM 0x40A6
363 #define CL_MEM_HOST_WRITE_COMBINING_QCOM 0x40A7
365 typedef cl_uint cl_image_pitch_info_qcom
;
367 extern CL_API_ENTRY cl_int CL_API_CALL
368 clGetDeviceImageInfoQCOM(cl_device_id device
,
371 const cl_image_format
*image_format
,
372 cl_image_pitch_info_qcom param_name
,
373 size_t param_value_size
,
375 size_t *param_value_size_ret
);
377 typedef struct _cl_mem_ext_host_ptr
379 /* Type of external memory allocation. */
380 /* Legal values will be defined in layered extensions. */
381 cl_uint allocation_type
;
383 /* Host cache policy for this external memory allocation. */
384 cl_uint host_cache_policy
;
386 } cl_mem_ext_host_ptr
;
389 /*******************************************
390 * cl_qcom_ext_host_ptr_iocoherent extension
391 ********************************************/
393 /* Cache policy specifying io-coherence */
394 #define CL_MEM_HOST_IOCOHERENT_QCOM 0x40A9
397 /*********************************
398 * cl_qcom_ion_host_ptr extension
399 *********************************/
401 #define CL_MEM_ION_HOST_PTR_QCOM 0x40A8
403 typedef struct _cl_mem_ion_host_ptr
405 /* Type of external memory allocation. */
406 /* Must be CL_MEM_ION_HOST_PTR_QCOM for ION allocations. */
407 cl_mem_ext_host_ptr ext_host_ptr
;
409 /* ION file descriptor */
412 /* Host pointer to the ION allocated memory */
415 } cl_mem_ion_host_ptr
;
418 /*********************************
419 * cl_qcom_android_native_buffer_host_ptr extension
420 *********************************/
422 #define CL_MEM_ANDROID_NATIVE_BUFFER_HOST_PTR_QCOM 0x40C6
424 typedef struct _cl_mem_android_native_buffer_host_ptr
426 /* Type of external memory allocation. */
427 /* Must be CL_MEM_ANDROID_NATIVE_BUFFER_HOST_PTR_QCOM for Android native buffers. */
428 cl_mem_ext_host_ptr ext_host_ptr
;
430 /* Virtual pointer to the android native buffer */
433 } cl_mem_android_native_buffer_host_ptr
;
436 /******************************************
437 * cl_img_yuv_image extension *
438 ******************************************/
440 /* Image formats used in clCreateImage */
441 #define CL_NV21_IMG 0x40D0
442 #define CL_YV12_IMG 0x40D1
445 /******************************************
446 * cl_img_cached_allocations extension *
447 ******************************************/
449 /* Flag values used by clCreateBuffer */
450 #define CL_MEM_USE_UNCACHED_CPU_MEMORY_IMG (1 << 26)
451 #define CL_MEM_USE_CACHED_CPU_MEMORY_IMG (1 << 27)
454 /******************************************
455 * cl_img_use_gralloc_ptr extension *
456 ******************************************/
457 #define cl_img_use_gralloc_ptr 1
459 /* Flag values used by clCreateBuffer */
460 #define CL_MEM_USE_GRALLOC_PTR_IMG (1 << 28)
462 /* To be used by clGetEventInfo: */
463 #define CL_COMMAND_ACQUIRE_GRALLOC_OBJECTS_IMG 0x40D2
464 #define CL_COMMAND_RELEASE_GRALLOC_OBJECTS_IMG 0x40D3
466 /* Error code from clEnqueueReleaseGrallocObjectsIMG */
467 #define CL_GRALLOC_RESOURCE_NOT_ACQUIRED_IMG 0x40D4
469 extern CL_API_ENTRY cl_int CL_API_CALL
470 clEnqueueAcquireGrallocObjectsIMG(cl_command_queue command_queue
,
472 const cl_mem
* mem_objects
,
473 cl_uint num_events_in_wait_list
,
474 const cl_event
* event_wait_list
,
475 cl_event
* event
) CL_EXT_SUFFIX__VERSION_1_2
;
477 extern CL_API_ENTRY cl_int CL_API_CALL
478 clEnqueueReleaseGrallocObjectsIMG(cl_command_queue command_queue
,
480 const cl_mem
* mem_objects
,
481 cl_uint num_events_in_wait_list
,
482 const cl_event
* event_wait_list
,
483 cl_event
* event
) CL_EXT_SUFFIX__VERSION_1_2
;
486 /*********************************
487 * cl_khr_subgroups extension
488 *********************************/
489 #define cl_khr_subgroups 1
491 #if !defined(CL_VERSION_2_1)
492 /* For OpenCL 2.1 and newer, cl_kernel_sub_group_info is declared in CL.h.
493 In hindsight, there should have been a khr suffix on this type for
494 the extension, but keeping it un-suffixed to maintain backwards
496 typedef cl_uint cl_kernel_sub_group_info
;
499 /* cl_kernel_sub_group_info */
500 #define CL_KERNEL_MAX_SUB_GROUP_SIZE_FOR_NDRANGE_KHR 0x2033
501 #define CL_KERNEL_SUB_GROUP_COUNT_FOR_NDRANGE_KHR 0x2034
503 extern CL_API_ENTRY cl_int CL_API_CALL
504 clGetKernelSubGroupInfoKHR(cl_kernel in_kernel
,
505 cl_device_id in_device
,
506 cl_kernel_sub_group_info param_name
,
507 size_t input_value_size
,
508 const void * input_value
,
509 size_t param_value_size
,
511 size_t * param_value_size_ret
) CL_EXT_SUFFIX__VERSION_2_0_DEPRECATED
;
513 typedef CL_API_ENTRY cl_int
514 (CL_API_CALL
* clGetKernelSubGroupInfoKHR_fn
)(cl_kernel in_kernel
,
515 cl_device_id in_device
,
516 cl_kernel_sub_group_info param_name
,
517 size_t input_value_size
,
518 const void * input_value
,
519 size_t param_value_size
,
521 size_t * param_value_size_ret
) CL_EXT_SUFFIX__VERSION_2_0_DEPRECATED
;
524 /*********************************
525 * cl_khr_mipmap_image extension
526 *********************************/
528 /* cl_sampler_properties */
529 #define CL_SAMPLER_MIP_FILTER_MODE_KHR 0x1155
530 #define CL_SAMPLER_LOD_MIN_KHR 0x1156
531 #define CL_SAMPLER_LOD_MAX_KHR 0x1157
534 /*********************************
535 * cl_khr_priority_hints extension
536 *********************************/
537 /* This extension define is for backwards compatibility.
538 It shouldn't be required since this extension has no new functions. */
539 #define cl_khr_priority_hints 1
541 typedef cl_uint cl_queue_priority_khr
;
543 /* cl_command_queue_properties */
544 #define CL_QUEUE_PRIORITY_KHR 0x1096
546 /* cl_queue_priority_khr */
547 #define CL_QUEUE_PRIORITY_HIGH_KHR (1<<0)
548 #define CL_QUEUE_PRIORITY_MED_KHR (1<<1)
549 #define CL_QUEUE_PRIORITY_LOW_KHR (1<<2)
552 /*********************************
553 * cl_khr_throttle_hints extension
554 *********************************/
555 /* This extension define is for backwards compatibility.
556 It shouldn't be required since this extension has no new functions. */
557 #define cl_khr_throttle_hints 1
559 typedef cl_uint cl_queue_throttle_khr
;
561 /* cl_command_queue_properties */
562 #define CL_QUEUE_THROTTLE_KHR 0x1097
564 /* cl_queue_throttle_khr */
565 #define CL_QUEUE_THROTTLE_HIGH_KHR (1<<0)
566 #define CL_QUEUE_THROTTLE_MED_KHR (1<<1)
567 #define CL_QUEUE_THROTTLE_LOW_KHR (1<<2)
570 /*********************************
571 * cl_khr_subgroup_named_barrier
572 *********************************/
573 /* This extension define is for backwards compatibility.
574 It shouldn't be required since this extension has no new functions. */
575 #define cl_khr_subgroup_named_barrier 1
578 #define CL_DEVICE_MAX_NAMED_BARRIER_COUNT_KHR 0x2035
581 /*********************************
582 * cl_khr_extended_versioning
583 *********************************/
585 #define CL_VERSION_MAJOR_BITS_KHR (10)
586 #define CL_VERSION_MINOR_BITS_KHR (10)
587 #define CL_VERSION_PATCH_BITS_KHR (12)
589 #define CL_VERSION_MAJOR_MASK_KHR ((1 << CL_VERSION_MAJOR_BITS_KHR) - 1)
590 #define CL_VERSION_MINOR_MASK_KHR ((1 << CL_VERSION_MINOR_BITS_KHR) - 1)
591 #define CL_VERSION_PATCH_MASK_KHR ((1 << CL_VERSION_PATCH_BITS_KHR) - 1)
593 #define CL_VERSION_MAJOR_KHR(version) ((version) >> (CL_VERSION_MINOR_BITS_KHR + CL_VERSION_PATCH_BITS_KHR))
594 #define CL_VERSION_MINOR_KHR(version) (((version) >> CL_VERSION_PATCH_BITS_KHR) & CL_VERSION_MINOR_MASK_KHR)
595 #define CL_VERSION_PATCH_KHR(version) ((version) & CL_VERSION_PATCH_MASK_KHR)
597 #define CL_MAKE_VERSION_KHR(major, minor, patch) \
598 ((((major) & CL_VERSION_MAJOR_MASK_KHR) << (CL_VERSION_MINOR_BITS_KHR + CL_VERSION_PATCH_BITS_KHR)) | \
599 (((minor) & CL_VERSION_MINOR_MASK_KHR) << CL_VERSION_PATCH_BITS_KHR) | \
600 ((patch) & CL_VERSION_PATCH_MASK_KHR))
602 typedef cl_uint cl_version_khr
;
604 #define CL_NAME_VERSION_MAX_NAME_SIZE_KHR 64
606 typedef struct _cl_name_version_khr
608 cl_version_khr version
;
609 char name
[CL_NAME_VERSION_MAX_NAME_SIZE_KHR
];
610 } cl_name_version_khr
;
612 /* cl_platform_info */
613 #define CL_PLATFORM_NUMERIC_VERSION_KHR 0x0906
614 #define CL_PLATFORM_EXTENSIONS_WITH_VERSION_KHR 0x0907
617 #define CL_DEVICE_NUMERIC_VERSION_KHR 0x105E
618 #define CL_DEVICE_OPENCL_C_NUMERIC_VERSION_KHR 0x105F
619 #define CL_DEVICE_EXTENSIONS_WITH_VERSION_KHR 0x1060
620 #define CL_DEVICE_ILS_WITH_VERSION_KHR 0x1061
621 #define CL_DEVICE_BUILT_IN_KERNELS_WITH_VERSION_KHR 0x1062
624 /**********************************
625 * cl_arm_import_memory extension *
626 **********************************/
627 #define cl_arm_import_memory 1
629 typedef intptr_t cl_import_properties_arm
;
631 /* Default and valid proporties name for cl_arm_import_memory */
632 #define CL_IMPORT_TYPE_ARM 0x40B2
634 /* Host process memory type default value for CL_IMPORT_TYPE_ARM property */
635 #define CL_IMPORT_TYPE_HOST_ARM 0x40B3
637 /* DMA BUF memory type value for CL_IMPORT_TYPE_ARM property */
638 #define CL_IMPORT_TYPE_DMA_BUF_ARM 0x40B4
640 /* Protected DMA BUF memory type value for CL_IMPORT_TYPE_ARM property */
641 #define CL_IMPORT_TYPE_PROTECTED_ARM 0x40B5
643 /* Android hardware buffer type value for CL_IMPORT_TYPE_ARM property */
644 #define CL_IMPORT_TYPE_ANDROID_HARDWARE_BUFFER_ARM 0x41E2
646 /* Import memory size value to indicate a size for the whole buffer */
647 #define CL_IMPORT_MEMORY_WHOLE_ALLOCATION_ARM SIZE_MAX
649 /* This extension adds a new function that allows for direct memory import into
650 * OpenCL via the clImportMemoryARM function.
652 * Memory imported through this interface will be mapped into the device's page
653 * tables directly, providing zero copy access. It will never fall back to copy
654 * operations and aliased buffers.
656 * Types of memory supported for import are specified as additional extension
659 * This extension produces cl_mem allocations which are compatible with all other
660 * users of cl_mem in the standard API.
662 * This extension maps pages with the same properties as the normal buffer creation
663 * function clCreateBuffer.
665 extern CL_API_ENTRY cl_mem CL_API_CALL
666 clImportMemoryARM( cl_context context
,
668 const cl_import_properties_arm
*properties
,
671 cl_int
*errcode_ret
) CL_EXT_SUFFIX__VERSION_1_0
;
674 /******************************************
675 * cl_arm_shared_virtual_memory extension *
676 ******************************************/
677 #define cl_arm_shared_virtual_memory 1
679 /* Used by clGetDeviceInfo */
680 #define CL_DEVICE_SVM_CAPABILITIES_ARM 0x40B6
682 /* Used by clGetMemObjectInfo */
683 #define CL_MEM_USES_SVM_POINTER_ARM 0x40B7
685 /* Used by clSetKernelExecInfoARM: */
686 #define CL_KERNEL_EXEC_INFO_SVM_PTRS_ARM 0x40B8
687 #define CL_KERNEL_EXEC_INFO_SVM_FINE_GRAIN_SYSTEM_ARM 0x40B9
689 /* To be used by clGetEventInfo: */
690 #define CL_COMMAND_SVM_FREE_ARM 0x40BA
691 #define CL_COMMAND_SVM_MEMCPY_ARM 0x40BB
692 #define CL_COMMAND_SVM_MEMFILL_ARM 0x40BC
693 #define CL_COMMAND_SVM_MAP_ARM 0x40BD
694 #define CL_COMMAND_SVM_UNMAP_ARM 0x40BE
696 /* Flag values returned by clGetDeviceInfo with CL_DEVICE_SVM_CAPABILITIES_ARM as the param_name. */
697 #define CL_DEVICE_SVM_COARSE_GRAIN_BUFFER_ARM (1 << 0)
698 #define CL_DEVICE_SVM_FINE_GRAIN_BUFFER_ARM (1 << 1)
699 #define CL_DEVICE_SVM_FINE_GRAIN_SYSTEM_ARM (1 << 2)
700 #define CL_DEVICE_SVM_ATOMICS_ARM (1 << 3)
702 /* Flag values used by clSVMAllocARM: */
703 #define CL_MEM_SVM_FINE_GRAIN_BUFFER_ARM (1 << 10)
704 #define CL_MEM_SVM_ATOMICS_ARM (1 << 11)
706 typedef cl_bitfield cl_svm_mem_flags_arm
;
707 typedef cl_uint cl_kernel_exec_info_arm
;
708 typedef cl_bitfield cl_device_svm_capabilities_arm
;
710 extern CL_API_ENTRY
void * CL_API_CALL
711 clSVMAllocARM(cl_context context
,
712 cl_svm_mem_flags_arm flags
,
714 cl_uint alignment
) CL_EXT_SUFFIX__VERSION_1_2
;
716 extern CL_API_ENTRY
void CL_API_CALL
717 clSVMFreeARM(cl_context context
,
718 void * svm_pointer
) CL_EXT_SUFFIX__VERSION_1_2
;
720 extern CL_API_ENTRY cl_int CL_API_CALL
721 clEnqueueSVMFreeARM(cl_command_queue command_queue
,
722 cl_uint num_svm_pointers
,
723 void * svm_pointers
[],
724 void (CL_CALLBACK
* pfn_free_func
)(cl_command_queue queue
,
725 cl_uint num_svm_pointers
,
726 void * svm_pointers
[],
729 cl_uint num_events_in_wait_list
,
730 const cl_event
* event_wait_list
,
731 cl_event
* event
) CL_EXT_SUFFIX__VERSION_1_2
;
733 extern CL_API_ENTRY cl_int CL_API_CALL
734 clEnqueueSVMMemcpyARM(cl_command_queue command_queue
,
735 cl_bool blocking_copy
,
737 const void * src_ptr
,
739 cl_uint num_events_in_wait_list
,
740 const cl_event
* event_wait_list
,
741 cl_event
* event
) CL_EXT_SUFFIX__VERSION_1_2
;
743 extern CL_API_ENTRY cl_int CL_API_CALL
744 clEnqueueSVMMemFillARM(cl_command_queue command_queue
,
746 const void * pattern
,
749 cl_uint num_events_in_wait_list
,
750 const cl_event
* event_wait_list
,
751 cl_event
* event
) CL_EXT_SUFFIX__VERSION_1_2
;
753 extern CL_API_ENTRY cl_int CL_API_CALL
754 clEnqueueSVMMapARM(cl_command_queue command_queue
,
755 cl_bool blocking_map
,
759 cl_uint num_events_in_wait_list
,
760 const cl_event
* event_wait_list
,
761 cl_event
* event
) CL_EXT_SUFFIX__VERSION_1_2
;
763 extern CL_API_ENTRY cl_int CL_API_CALL
764 clEnqueueSVMUnmapARM(cl_command_queue command_queue
,
766 cl_uint num_events_in_wait_list
,
767 const cl_event
* event_wait_list
,
768 cl_event
* event
) CL_EXT_SUFFIX__VERSION_1_2
;
770 extern CL_API_ENTRY cl_int CL_API_CALL
771 clSetKernelArgSVMPointerARM(cl_kernel kernel
,
773 const void * arg_value
) CL_EXT_SUFFIX__VERSION_1_2
;
775 extern CL_API_ENTRY cl_int CL_API_CALL
776 clSetKernelExecInfoARM(cl_kernel kernel
,
777 cl_kernel_exec_info_arm param_name
,
778 size_t param_value_size
,
779 const void * param_value
) CL_EXT_SUFFIX__VERSION_1_2
;
781 /********************************
782 * cl_arm_get_core_id extension *
783 ********************************/
785 #ifdef CL_VERSION_1_2
787 #define cl_arm_get_core_id 1
789 /* Device info property for bitfield of cores present */
790 #define CL_DEVICE_COMPUTE_UNITS_BITFIELD_ARM 0x40BF
792 #endif /* CL_VERSION_1_2 */
794 /*********************************
795 * cl_arm_job_slot_selection
796 *********************************/
798 #define cl_arm_job_slot_selection 1
801 #define CL_DEVICE_JOB_SLOTS_ARM 0x41E0
803 /* cl_command_queue_properties */
804 #define CL_QUEUE_JOB_SLOT_ARM 0x41E1
811 #endif /* __CL_EXT_H */