[clang] [OpenMP][NFC] Update OpenMP Support doc for Tools Interface (PR #193173)
Jan André Reuter via cfe-commits
cfe-commits at lists.llvm.org
Tue Apr 21 03:01:06 PDT 2026
https://github.com/Thyre created https://github.com/llvm/llvm-project/pull/193173
All enum values for OpenMP v5.1 are implemented.
Add entries for added and deprecated OpenMP Tools Interface features in OpenMP v6.0.
Also fix link to PR for `transparent clause (hull tasks)`.
>From 5f04f78c120abc47c03174f8ad40796d391c34a8 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Jan=20Andr=C3=A9=20Reuter?= <j.reuter at fz-juelich.de>
Date: Tue, 21 Apr 2026 11:48:27 +0200
Subject: [PATCH] [OpenMP][NFC] Update OpenMP Support for Tools Interface
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
All enum values for OpenMP v5.1 are implemented.
Add entries for added and deprecated features in OpenMP v6.0.
Signed-off-by: Jan André Reuter <j.reuter at fz-juelich.de>
---
clang/docs/OpenMPSupport.rst | 51 +++++++++++++++++++++++++++++++-----
1 file changed, 44 insertions(+), 7 deletions(-)
diff --git a/clang/docs/OpenMPSupport.rst b/clang/docs/OpenMPSupport.rst
index 49bc4d4e8dad8..1f0f26f871806 100644
--- a/clang/docs/OpenMPSupport.rst
+++ b/clang/docs/OpenMPSupport.rst
@@ -304,8 +304,6 @@ implementation.
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
| misc | routines for controlling and querying team regions | :part:`partial` | D95003 (libomp only) |
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
-| misc | changes to ompt_scope_endpoint_t enum | :none:`unclaimed` | |
-+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
| misc | omp_display_env routine | :good:`done` | D74956 |
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
| misc | extended OMP_PLACES syntax | :none:`unclaimed` | |
@@ -332,11 +330,13 @@ implementation.
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
| other | deprecating master construct | :none:`unclaimed` | |
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
-| OMPT | new barrier types added to ompt_sync_region_t enum | :none:`unclaimed` | |
+| OMPT | changes to ompt_scope_endpoint_t enum | :good:`done` | D90752 |
++------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
+| OMPT | new barrier types added to ompt_sync_region_t enum | :good:`done` | D90752 |
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
-| OMPT | async data transfers added to ompt_target_data_op_t enum | :none:`unclaimed` | |
+| OMPT | async data transfers added to ompt_target_data_op_t enum | :good:`done` | D90752 |
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
-| OMPT | new barrier state values added to ompt_state_t enum | :none:`unclaimed` | |
+| OMPT | new barrier state values added to ompt_state_t enum | :good:`done` | D90752 |
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
| OMPT | new 'emi' callbacks for external monitoring interfaces | :good:`done` | |
+------------------------------+--------------------------------------------------------------+--------------------------+-----------------------------------------------------------------------+
@@ -392,7 +392,9 @@ implementation.
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
| implicit map type for target enter/exit data | :none:`unclaimed` | :none:`unclaimed` | |
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
-| work OMPT type for work-sharing loop constructs | :none:`unclaimed` | :none:`unclaimed` | |
+| work OMPT type for work-sharing loop constructs | :good:`done` | :good:`done` | PR-189347, PR-97429 |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| extend ompt_dispatch_t for new enum values | :good:`done` | :good:`done` | D122107 |
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
| allocate and firstprivate on scope directive | :none:`unclaimed` | :none:`unclaimed` | |
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
@@ -494,7 +496,7 @@ implementation.
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
| memscope clause for atomic and flush | :none:`unclaimed` | :none:`unclaimed` | |
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
-| transparent clause (hull tasks) | :part:`partial` | :none:`unclaimed` | Clang parsing/sema https://github.com/llvm/llvm-project/pull/166810 |
+| transparent clause (hull tasks) | :part:`partial` | :none:`unclaimed` | Clang parsing/sema https://github.com/llvm/llvm-project/pull/174646 |
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
| rule-based compound directives | :part:`In Progress` | :part:`In Progress` | kparzysz |
| | | | Testing for Fortran missing |
@@ -609,6 +611,41 @@ implementation.
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
| defaultmap implicit-behavior 'private' | :good:`done` | :none:`unclaimed` | https://github.com/llvm/llvm-project/pull/158712 |
+-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: ompt_get_buffer_limits entry point | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: ompt_any_record_ompt_t for device tracing | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: ompt_target_data_transfer_rect(_async) & subvolume | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: ompt_target_data_transfer(_async) | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: ompt_target_data_memset(_async) | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: workdistribute work callback enum | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: transparent task flag enum (importing/exporting) | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: dependence type {out, inout}_all_memory | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: removed master callback | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: removed sync_region_barrier(_implicit) enum value | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+
+.. _OpenMP 6.0 Deprecations:
+
+OpenMP 6.0 Deprecations
+=======================
+
+
+
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| | C/C++ Status | Fortran Status | Reviews |
++=============================================================+===========================+===========================+==========================================================================+
+| OMPT: non-emi target callbacks | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
+| OMPT: transfer_to_device / transfer_from_device enums | :none:`unclaimed` | :good:`N/A` | |
++-------------------------------------------------------------+---------------------------+---------------------------+--------------------------------------------------------------------------+
.. _OpenMP 6.1 implementation details:
More information about the cfe-commits
mailing list