Khronos OpenCL Registry

The OpenCL registry contains formatted specifications of the OpenCL API, OpenCL C programming language, OpenCL SPIR-V environment, and OpenCL extensions.

The OpenCL registry also includes header files, links to reference pages, reference cards, and other related documentation.

The asciidoctor source for the specifications in this registry is available in the OpenCL-Docs GitHub repository.

This registry is hosted in the OpenCL-Registry GitHub repository.

OpenCL 3.0 Unified Specifications

The latest version of OpenCL is OpenCL 3.0.

The OpenCL specifications are now unified so they describe OpenCL 3.0 and all previous versions of OpenCL.

• OpenCL API Specification (HTML) (PDF) (December 18, 2020).
• OpenCL C Language Specification (HTML) (PDF) (December 18, 2020).
• OpenCL Extension Specification (HTML) (PDF) (December 18, 2020.
• OpenCL SPIR-V Environment Specification (HTML) (PDF) (December 18, 2020).
• OpenCL 3.0 Reference Guide.

Related Specifications and Resources

• C language header files for the OpenCL API are in the OpenCL-Headers GitHub repository.
• Header files providing C++ bindings for the OpenCL API are in the OpenCL-CLHPP GitHub repository.
  • Doxygen documentation for the C++ bindings is also available.
• An OpenCL Installable Client Driver (ICD) Loader can be obtained from the OpenCL-ICD-Loader GitHub repository.
  • OpenCL ICD Installation Guide Specification (HTML) (PDF)
• The Standard Portable Intermediate Representation (SPIR-V) specification is in the SPIR-V Registry.
  • The OpenCL Extended Instruction Set for SPIR-V is included as part of the SPIR-V registry.
• The SYCL specification is found in the SYCL Registry.

Older Specifications

Older versions of OpenCL are provided for reference.

OpenCL 2.2.

• OpenCL 2.2 API Specification (HTML) (PDF) (July 19, 2019).
• OpenCL Extension Specification (HTML) (PDF) (July 19, 2019).
• OpenCL SPIR-V Environment Specification (HTML) (PDF) (July 19, 2019).
• OpenCL C Language Specification (HTML) (PDF) (July 19, 2019).
• OpenCL C++ Language Specification (HTML) (PDF) (July 19, 2019).
• OpenCL 2.2 Reference Pages.
• OpenCL 2.2 Reference Guide.

OpenCL 2.1

• OpenCL 2.1 API Specification (November 11, 2015).
• OpenCL 2.1 Extensions Specification (November 5, 2015).
• OpenCL 2.1 Environment Specification.
• OpenCL 2.1 Reference Pages.
• OpenCL 2.1 Quick Reference Card.

OpenCL 2.0

• OpenCL 2.0 API Specification (July 21, 2015).
• OpenCL 2.0 C Language Specification (April 13, 2016).
• OpenCL 2.0 Extension Specification (March 11, 2016).
• OpenCL 2.0 Reference Pages.
• OpenCL 2.0 Quick Reference Card.

OpenCL 1.2

• OpenCL 1.2 API and C Language Specification (November 14, 2012).
• OpenCL 1.2 Extensions Specification (September 22, 2015).
• OpenCL 1.2 Reference Pages.
• OpenCL 1.2 Quick Reference Card.

OpenCL 1.1

• OpenCL 1.1 API and C Language Specification (revision 44, June 1, 2011). A Japanese translation of the specification is also available.
• OpenCL 1.1 Reference Pages.
• OpenCL 1.1 Reference Card.

OpenCL 1.0

• OpenCL 1.0 API and C Language Specification (revision 48, October 6, 2009).
• OpenCL 1.0 Reference Pages.
• OpenCL 1.0 Reference Card.

Providing Feedback on the Registry

Khronos welcomes comments and bug reports. To provide feedback on the OpenCL reference pages, or on the OpenCL registry itself (such as reporting missing content, bad links, etc.), file an issue in the OpenCL-Registry GitHub repository.

Feedback on related OpenCL components can be provided as follows:

• For the OpenCL API, C/C++ Language, and SPIR-V Environment Specifications, file an issue on the OpenCL-Docs GitHub repository.
• For the OpenCL C header files, file an issue in the OpenCL-Headers GitHub repository.
• For the OpenCL C++ bindings, file an issue in the OpenCL-CLHPP GitHub repository.
• For the OpenCL ICD Loader, file an issue in the OpenCL-ICD-Loader GitHub repository.

Extension Template

The extension template for writing an OpenCL extension specification shows the structure of vendor extension specifications in the registry (listed below) and serves as a guide for writing new extension specifications. The template describes the purpose of each section in an extension specification.

Enumerant and Extension Number Registry

cl.xml is the registry of reserved OpenCL API enumerant ranges. (Note that following this link will probably not render sensibly in browsers, since the file is not entirely valid XML, simply a manually updated placeholder.)

Extension Specifications

1. cl_khr_gl_sharing
2. cl_nv_d3d9_sharing
3. cl_nv_d3d10_sharing
4. cl_nv_d3d11_sharing
5. cl_khr_icd
6. cl_khr_d3d10_sharing
7. cl_amd_device_attribute_query
8. cl_amd_fp64
9. cl_amd_media_ops
10. cl_ext_migrate_memobject
11. cl_ext_device_fission
12. cl_ext_atomic_counters_32
13. cl_ext_atomic_counters_64
14. cl_intel_dx9_media_sharing
15. cl_amd_media_ops2
16. cl_intel_thread_local_exec
17. cl_nv_compiler_options
18. cl_nv_device_attribute_query
19. cl_nv_pragma_unroll
20. cl_intel_device_partition_by_names
21. cl_qcom_ext_host_ptr
22. cl_qcom_ion_host_ptr
23. cl_intel_motion_estimation
24. cl_intel_accelerator
25. cl_amd_bus_addressable_memory
26. cl_arm_core_id
27. cl_arm_printf
28. cl_altera_live_object_tracking
29. cl_altera_device_temperature
30. cl_altera_compiler_mode
31. cl_intel_d3d11_nv12_media_sharing
32. cl_qcom_android_native_buffer_host_ptr
33. cl_intel_advanced_motion_estimation
34. cl_intel_simultaneous_sharing
35. cl_intel_subgroups
36. cl_intel_va_api_media_sharing
37. cl_intel_egl_image_yuv
38. cl_arm_import_memory
39. cl_arm_non_uniform_work_group_size
40. cl_arm_shared_virtual_memory
41. cl_arm_thread_limit_hint
42. cl_intel_packed_yuv
43. cl_intel_required_subgroup_size
44. cl_img_cached_allocations
45. cl_img_use_gralloc_ptr
46. cl_img_yuv_image
47. cl_intel_driver_diagnostics
48. cl_intel_subgroups_short
49. cl_intel_planar_yuv
50. cl_intel_device_side_avc_motion_estimation
51. cl_intel_media_block_io
52. cl_arm_integer_dot_product
53. cl_qcom_ext_host_ptr_iocoherent
54. cl_amd_planar_yuv
55. cl_intel_spirv_subgroups
56. cl_intel_spirv_media_block_io
57. cl_intel_spirv_device_side_avc_motion_estimation
58. cl_arm_job_slot_selection
59. cl_intel_subgroups_char
60. cl_intel_subgroups_long
61. cl_intel_create_buffer_with_properties
62. cl_intel_mem_channel_property
63. cl_arm_scheduling_controls
64. cl_ext_cxx_for_opencl
65. cl_intel_mem_force_host_memory
66. cl_img_generate_mipmap
67. cl_img_mem_properties