This is an archive of the discontinued LLVM Phabricator instance.

Differential D119719

[Docs][OpenCL] Update OpenCL 3.0 status
ClosedPublic

Authored by Anastasia on Feb 14 2022, 7:15 AM.

Details

Reviewers
svenvh
azabaznov
Commits
rGfdd615d4f91f: [Docs][OpenCL] Update OpenCL 3.0 status in docs.
Summary

This update is intended for the main and release 14 branch.

Diff Detail

Event Timeline

Anastasia created this revision.Feb 14 2022, 7:15 AM
Herald added subscribers: Naghasan, ebevhan, yaxunl. · View Herald TranscriptFeb 14 2022, 7:15 AM
Anastasia requested review of this revision.Feb 14 2022, 7:15 AM
Harbormaster completed remote builds in B149380: Diff 408409.Feb 14 2022, 7:15 AM
azabaznov added inline comments.Feb 15 2022, 1:36 AM
clang/docs/OpenCLSupport.rst
395

These two patches are merged. So can blocks and DSE be considered as done?

407

Can this be considered as done as well? These patches were merged as well.

Anastasia updated this revision to Diff 408806.Feb 15 2022, 3:59 AM
Anastasia retitled this revision from [Docs][OpenCL] Update OpenCL 3.0 status on release 14 to [Docs][OpenCL] Update OpenCL 3.0 status.
Anastasia edited the summary of this revision. (Show Details)
Harbormaster completed remote builds in B149651: Diff 408806.Feb 15 2022, 3:59 AM
svenvh accepted this revision.Feb 15 2022, 5:44 AM

LGTM, just suggesting a minor textual improvement that can be made at commit time.

clang/docs/UsersManual.rst
3063
OpenCL v3.0 support is complete but it remains in experimental state.
More details about the experimental features are described in :doc:`OpenCLSupport`.
This revision is now accepted and ready to land.Feb 15 2022, 5:44 AM
azabaznov accepted this revision.Feb 16 2022, 2:03 AM

LGTM. Thanks!

This revision was landed with ongoing or failed builds.Feb 16 2022, 4:32 AM
Closed by commit rGfdd615d4f91f: [Docs][OpenCL] Update OpenCL 3.0 status in docs. (authored by Anastasia). · Explain Why
This revision was automatically updated to reflect the committed changes.
Anastasia added a commit: rGfdd615d4f91f: [Docs][OpenCL] Update OpenCL 3.0 status in docs..
Herald added a project: Restricted Project. · View Herald TranscriptFeb 16 2022, 4:32 AM
Herald added a subscriber: ldrumm. · View Herald Transcript

Revision Contents

PathSize
clang/
docs/
78 lines
5 lines

Diff 409208

clang/docs/OpenCLSupport.rst

Show All 11 Lines
.. contents:: .. contents::
:local: :local:
================== ==================
OpenCL Support OpenCL Support
================== ==================
Clang has complete support of OpenCL C versions from 1.0 to 2.0. Clang has complete support of OpenCL C versions from 1.0 to 3.0.
There is an ongoing work to support :ref:`OpenCL 3.0 <opencl_300>`. Support for OpenCL 3.0 is in experimental phase (:ref:`OpenCL 3.0 <opencl_300>`).
Clang also supports :ref:`the C++ for OpenCL kernel language <cxx_for_opencl_impl>`. Clang also supports :ref:`the C++ for OpenCL kernel language <cxx_for_opencl_impl>`.
There are also other :ref:`new and experimental features <opencl_experimenal>` There are also other :ref:`new and experimental features <opencl_experimenal>`
available. available.
For general issues and bugs with OpenCL in clang refer to `the GitHub issue For general issues and bugs with OpenCL in clang refer to `the GitHub issue
list list
▲ Show 20 Lines • Show All 336 Lines • ▼ Show 20 Lines
OpenCL C 3.0 Implementation Status OpenCL C 3.0 Implementation Status
---------------------------------- ----------------------------------
The following table provides an overview of features in OpenCL C 3.0 and their The following table provides an overview of features in OpenCL C 3.0 and their
implementation status. implementation status.
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Category | Feature | Status | Reviews | | Category | Feature | Status | Reviews |
+==============================+=========================+=========================================+======================+==============================================================================================+ +==============================+=========================+=========================================+======================+================================================================================================================================+
| Command line interface | New value for ``-cl-std`` flag | :good:`done` | https://reviews.llvm.org/D88300 | | Command line interface | New value for ``-cl-std`` flag | :good:`done` | https://reviews.llvm.org/D88300 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Predefined macros | New version macro | :good:`done` | https://reviews.llvm.org/D88300 | | Predefined macros | New version macro | :good:`done` | https://reviews.llvm.org/D88300 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Predefined macros | Feature macros | :good:`done` | https://reviews.llvm.org/D95776 | | Predefined macros | Feature macros | :good:`done` | https://reviews.llvm.org/D95776 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | Generic address space | :good:`done` | https://reviews.llvm.org/D95778 and https://reviews.llvm.org/D103401 | | Feature optionality | Generic address space | :good:`done` | https://reviews.llvm.org/D95778 and https://reviews.llvm.org/D103401 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | Builtin function overloads with generic address space | :good:`done` | https://reviews.llvm.org/D105526 and https://reviews.llvm.org/D107769 | | Feature optionality | Builtin function overloads with generic address space | :good:`done` | https://reviews.llvm.org/D105526, https://reviews.llvm.org/D107769 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | Program scope variables in global memory | :good:`done` | https://reviews.llvm.org/D103191 | | Feature optionality | Program scope variables in global memory | :good:`done` | https://reviews.llvm.org/D103191 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | 3D image writes including builtin functions | :part:`worked on` | https://reviews.llvm.org/D106260 (frontend) | | Feature optionality | 3D image writes including builtin functions | :good:`done` | https://reviews.llvm.org/D106260 (frontend) |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | read_write images including builtin functions | :good:`done` | https://reviews.llvm.org/D104915 (frontend) and https://reviews.llvm.org/D107539 (functions) | | Feature optionality | read_write images including builtin functions | :good:`done` | https://reviews.llvm.org/D104915 (frontend) and https://reviews.llvm.org/D107539, https://reviews.llvm.org/D117899 (functions) |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | C11 atomics memory scopes, ordering and builtin function | :good:`done` | https://reviews.llvm.org/D106111 | | Feature optionality | C11 atomics memory scopes, ordering and builtin function | :good:`done` | https://reviews.llvm.org/D106111, https://reviews.llvm.org/D119420 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | Blocks and Device-side kernel enqueue including builtin functions | :part:`worked on` | https://reviews.llvm.org/D118605 | | Feature optionality | Blocks and Device-side kernel enqueue including builtin functions | :good:`done` | https://reviews.llvm.org/D115640, https://reviews.llvm.org/D118605 |
azabaznovUnsubmitted
Not Done
ReplyInline Actions

These two patches are merged. So can blocks and DSE be considered as done?

azabaznov: These two patches are merged. So can blocks and DSE be considered as done?
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | Pipes including builtin functions | :good:`done` | https://reviews.llvm.org/D107154 (frontend) and https://reviews.llvm.org/D105858 (functions) | | Feature optionality | Pipes including builtin functions | :good:`done` | https://reviews.llvm.org/D107154 (frontend) and https://reviews.llvm.org/D105858 (functions) |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | Work group collective builtin functions | :good:`done` | https://reviews.llvm.org/D105858 | | Feature optionality | Work group collective builtin functions | :good:`done` | https://reviews.llvm.org/D105858 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | Image types and builtin functions | :good:`done` | https://reviews.llvm.org/D103911 (frontend) and https://reviews.llvm.org/D107539 (functions) | | Feature optionality | Image types and builtin functions | :good:`done` | https://reviews.llvm.org/D103911 (frontend) and https://reviews.llvm.org/D107539 (functions) |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| Feature optionality | Double precision floating point type | :good:`done` | https://reviews.llvm.org/D96524 | | Feature optionality | Double precision floating point type | :good:`done` | https://reviews.llvm.org/D96524 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| New functionality | RGBA vector components | :good:`done` | https://reviews.llvm.org/D99969 | | New functionality | RGBA vector components | :good:`done` | https://reviews.llvm.org/D99969 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| New functionality | Subgroup functions | :part:`worked on` | https://reviews.llvm.org/D105858 | | New functionality | Subgroup functions | :good:`done` | https://reviews.llvm.org/D105858, https://reviews.llvm.org/D118999 |
azabaznovUnsubmitted
Not Done
ReplyInline Actions

Can this be considered as done as well? These patches were merged as well.

azabaznov: Can this be considered as done as well? These patches were merged as well.
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
| New functionality | Atomic mem scopes: subgroup, all devices including functions | :part:`worked on` | https://reviews.llvm.org/D103241 | | New functionality | Atomic mem scopes: subgroup, all devices including functions | :good:`done` | https://reviews.llvm.org/D103241 |
+------------------------------+-------------------------+-----------------------------------------+----------------------+----------------------------------------------------------------------------------------------+ +------------------------------+-------------------------+-----------------------------------------+----------------------+--------------------------------------------------------------------------------------------------------------------------------+
.. _opencl_experimenal: .. _opencl_experimenal:
Experimental features Experimental features
===================== =====================
Clang provides the following new WIP features for the developers to experiment Clang provides the following new WIP features for the developers to experiment
and provide early feedback or contribute with further improvements. and provide early feedback or contribute with further improvements.
▲ Show 20 Lines • Show All 55 Lines • Show Last 20 Lines

clang/docs/UsersManual.rst

Show First 20 Lines • Show All 3,054 Lines • ▼ Show 20 Lines
<https://github.com/KhronosGroup/OpenCL-Guide/blob/main/chapters/os_tooling.md>`_. <https://github.com/KhronosGroup/OpenCL-Guide/blob/main/chapters/os_tooling.md>`_.
Clang currently supports OpenCL C language standards up to v2.0. Clang mainly Clang currently supports OpenCL C language standards up to v2.0. Clang mainly
supports full profile. There is only very limited support of the embedded supports full profile. There is only very limited support of the embedded
profile. profile.
Starting from clang 9 a C++ mode is available for OpenCL (see Starting from clang 9 a C++ mode is available for OpenCL (see
:ref:`C++ for OpenCL <cxx_for_opencl>`). :ref:`C++ for OpenCL <cxx_for_opencl>`).
There is ongoing support for OpenCL v3.0 that is documented along with other OpenCL v3.0 support is complete but it remains in experimental state, see more
svenvhUnsubmitted
Not Done
ReplyInline Actions
OpenCL v3.0 support is complete but it remains in experimental state.
More details about the experimental features are described in :doc:`OpenCLSupport`.
svenvh: ``` OpenCL v3.0 support is complete but it remains in experimental state. More details about…
experimental functionality and features in development on :doc:`OpenCLSupport` details about the experimental features in :doc:`OpenCLSupport` page.
page.
OpenCL Specific Options OpenCL Specific Options
----------------------- -----------------------
Most of the OpenCL build options from `the specification v2.0 section 5.8.4 Most of the OpenCL build options from `the specification v2.0 section 5.8.4
<https://www.khronos.org/registry/cl/specs/opencl-2.0.pdf#200>`_ are available. <https://www.khronos.org/registry/cl/specs/opencl-2.0.pdf#200>`_ are available.
Examples: Examples:
▲ Show 20 Lines • Show All 1,048 Lines • Show Last 20 Lines