[wwwdocs] gcc-13/changes.html + projects/gomp: OpenMP GCC 13 update

[wwwdocs] gcc-13/changes.html + projects/gomp: OpenMP GCC 13 update

[Tobias Burnus]

[-- Attachment #1: Type: text/plain, Size: 835 bytes --]

This patch updates the OpenMP implementation status, based on libgomp.texi.
For the release notes, it also moves 'non-rectangular loop nests' up as that's
a 5.0 not a 5.1 feature.
And in line with libgomp.texi, it adds to projects/gomp/ the items for TR11,
a OpenMP 6.0 preview. (Hence, the id="omp6.0" to have a fixed id even when
the list is updated to TR12 and later OpenMP 6.0.)

Comments? Suggestions? OK?

Tobias

PS: There will be surely more updates before GCC 13 is released; I hope/assume
the next change will be for nvptx reverse offload...
-----------------
Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstraße 201, 80634 München; Gesellschaft mit beschränkter Haftung; Geschäftsführer: Thomas Heurung, Frank Thürauf; Sitz der Gesellschaft: München; Registergericht München, HRB 106955

[-- Attachment #2: committed.diff --]
[-- Type: text/x-patch, Size: 1559 bytes --]

commit 9f80367e539839fff1df2c85fc2640638199fc9e
Author: Tobias Burnus <tobias@codesourcery.com>
Date:   Tue Dec 6 09:49:30 2022 +0100

    libgomp.texi: Fix a OpenMP 5.2 and a TR11 impl-status item
    
    libgomp/
            * libgomp.texi (OpenMP 5.2): Add missing 'the'.
            (TR11): Add missing '@tab N @tab'.
---
 libgomp/libgomp.texi | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi
index 4caac497506..efa7d956a33 100644
--- a/libgomp/libgomp.texi
+++ b/libgomp/libgomp.texi
@@ -406,7 +406,7 @@ to address of matching mapped list item per 5.1, Sect. 2.21.7.2 @tab N @tab
 @item @code{allocate} and @code{firstprivate} clauses on @code{scope}
       @tab Y @tab
 @item @code{ompt_callback_work} @tab N @tab
-@item Default map-type for @code{map} clause in @code{target enter/exit data}
+@item Default map-type for the @code{map} clause in @code{target enter/exit data}
       @tab Y @tab
 @item New @code{doacross} clause as alias for @code{depend} with
       @code{source}/@code{sink} modifier @tab Y @tab
@@ -463,6 +463,7 @@ Technical Report (TR) 11 is the first preview for OpenMP 6.0.
 @item @code{access} allocator trait changes @tab N @tab
 @item Extension of @code{interop} operation of @code{append_args}, allowing all
       modifiers of the @code{init} clause
+      @tab N @tab
 @item @code{interop} clause to @code{dispatch} @tab N @tab
 @item @code{apply} code to loop-transforming constructs @tab N @tab
 @item @code{omp_curr_progress_width} identifier @tab N @tab

Re: [wwwdocs] gcc-13/changes.html + projects/gomp: OpenMP GCC 13 update

[Jakub Jelinek]

On Tue, Dec 06, 2022 at 09:59:17AM +0100, Tobias Burnus wrote:
> This patch updates the OpenMP implementation status, based on libgomp.texi.
> For the release notes, it also moves 'non-rectangular loop nests' up as that's
> a 5.0 not a 5.1 feature.
> And in line with libgomp.texi, it adds to projects/gomp/ the items for TR11,
> a OpenMP 6.0 preview. (Hence, the id="omp6.0" to have a fixed id even when
> the list is updated to TR12 and later OpenMP 6.0.)

The posted patch is certainly good, but doesn't do what you wrote above.

> PS: There will be surely more updates before GCC 13 is released; I hope/assume
> the next change will be for nvptx reverse offload...
> -----------------
> Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstraße 201, 80634 München; Gesellschaft mit beschränkter Haftung; Geschäftsführer: Thomas Heurung, Frank Thürauf; Sitz der Gesellschaft: München; Registergericht München, HRB 106955

> commit 9f80367e539839fff1df2c85fc2640638199fc9e
> Author: Tobias Burnus <tobias@codesourcery.com>
> Date:   Tue Dec 6 09:49:30 2022 +0100
> 
>     libgomp.texi: Fix a OpenMP 5.2 and a TR11 impl-status item
>     
>     libgomp/
>             * libgomp.texi (OpenMP 5.2): Add missing 'the'.
>             (TR11): Add missing '@tab N @tab'.
> ---
>  libgomp/libgomp.texi | 3 ++-
>  1 file changed, 2 insertions(+), 1 deletion(-)
> 
> diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi
> index 4caac497506..efa7d956a33 100644
> --- a/libgomp/libgomp.texi
> +++ b/libgomp/libgomp.texi
> @@ -406,7 +406,7 @@ to address of matching mapped list item per 5.1, Sect. 2.21.7.2 @tab N @tab
>  @item @code{allocate} and @code{firstprivate} clauses on @code{scope}
>        @tab Y @tab
>  @item @code{ompt_callback_work} @tab N @tab
> -@item Default map-type for @code{map} clause in @code{target enter/exit data}
> +@item Default map-type for the @code{map} clause in @code{target enter/exit data}
>        @tab Y @tab
>  @item New @code{doacross} clause as alias for @code{depend} with
>        @code{source}/@code{sink} modifier @tab Y @tab
> @@ -463,6 +463,7 @@ Technical Report (TR) 11 is the first preview for OpenMP 6.0.
>  @item @code{access} allocator trait changes @tab N @tab
>  @item Extension of @code{interop} operation of @code{append_args}, allowing all
>        modifiers of the @code{init} clause
> +      @tab N @tab
>  @item @code{interop} clause to @code{dispatch} @tab N @tab
>  @item @code{apply} code to loop-transforming constructs @tab N @tab
>  @item @code{omp_curr_progress_width} identifier @tab N @tab


	Jakub

Re: [wwwdocs] gcc-13/changes.html + projects/gomp: OpenMP GCC 13 update

[Tobias Burnus]

[-- Attachment #1: Type: text/plain, Size: 1049 bytes --]

On 06.12.22 10:15, Jakub Jelinek wrote:
> On Tue, Dec 06, 2022 at 09:59:17AM +0100, Tobias Burnus wrote:
>> This patch updates the OpenMP implementation status, based on libgomp.texi.
>> For the release notes, it also moves 'non-rectangular loop nests' up as that's
>> a 5.0 not a 5.1 feature.
>> And in line with libgomp.texi, it adds to projects/gomp/ the items for TR11,
>> a OpenMP 6.0 preview. (Hence, the id="omp6.0" to have a fixed id even when
>> the list is updated to TR12 and later OpenMP 6.0.)
> The posted patch is certainly good, but doesn't do what you wrote above.

Next try  – how about this one?

Tobias

>> PS: There will be surely more updates before GCC 13 is released; I hope/assume
>> the next change will be for nvptx reverse offload...
-----------------
Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstraße 201, 80634 München; Gesellschaft mit beschränkter Haftung; Geschäftsführer: Thomas Heurung, Frank Thürauf; Sitz der Gesellschaft: München; Registergericht München, HRB 106955

[-- Attachment #2: wwwdocs-gomp-up.diff --]
[-- Type: text/x-patch, Size: 13545 bytes --]

gcc-13/changes.html + projects/gomp: OpenMP GCC 13 update

 htdocs/gcc-13/changes.html      |  21 ++--
 htdocs/projects/gomp/index.html | 227 ++++++++++++++++++++++++++++++++++++----
 2 files changed, 223 insertions(+), 25 deletions(-)

diff --git a/htdocs/gcc-13/changes.html b/htdocs/gcc-13/changes.html
index 689178f9..59cb7a8d 100644
--- a/htdocs/gcc-13/changes.html
+++ b/htdocs/gcc-13/changes.html
@@ -46,14 +46,15 @@ a work-in-progress.</p>
 <h2 id="general">General Improvements</h2>
 
 <ul>
-  <li><a href="https://gcc.gnu.org/projects/gomp/">OpenMP</a>
+  <li id="openmp"><a href="https://gcc.gnu.org/projects/gomp/">OpenMP</a>
   <ul>
     <li>
       Reverse offload is now supported and the all clauses to the
       <code>requires</code> directive are now accepted; however, the
       <code>requires_offload</code>, <code>unified_address</code>
       and <code>unified_shared_memory</code> clauses cause that the
-      only available device is the initial device (the host).
+      only available device is the initial device (the host). Fortran now
+      supports non-rectangular loop nests, which were added for C/C++ in GCC 11.
     </li>
     <li>
       The following OpenMP 5.1 features have been added: the
@@ -62,9 +63,10 @@ a work-in-progress.</p>
       clause for the <code>taskwait</code> directive and the
       <code>omp_target_is_accessible</code>, <code>omp_target_memcpy_async</code>,
       <code>omp_target_memcpy_rect_async</code> and
-      <code>omp_get_mapped_ptr</code> API routines. Fortran now supports
-      non-rectangular loop nests, which were added for C/C++ in GCC 11.
-    </li>
+      <code>omp_get_mapped_ptr</code> API routines. The assume and assumes
+      directives, the <code>begin/end declare target</code> syntax in C/C++
+      and device-specific ICV settings with environment variables are now
+      supported.</li>
     <li>
       Initial support for OpenMP 5.2 features have been added: Support for
       <code>firstprivate</code> and <code>allocate</code> clauses on the
@@ -73,7 +75,14 @@ a work-in-progress.</p>
       <code>omp_initial_device</code> and <code>omp_invalid_device</code>; and
       optionally omitting the map-type in <code>target enter/exit data</code>.
       The <code>enter</code> clause (as alias for <code>to</code>) has been added
-      to the <code>declare target</code> directive.
+      to the <code>declare target</code> directive. Also added has been the
+      <code>omp_in_explicit_task</code> routine and the <code>doacross<code>
+      clause as alias for <code>depend</code> with <code>source/sink</code>
+      modifier.
+    </li>
+    <li>
+      The <code>_ALL</code> suffix to the device-scope environment variables,
+      added in Technical Report (TR11) is already handled.
     </li>
     <li>
       For user defined allocators requesting high bandwidth or large capacity
diff --git a/htdocs/projects/gomp/index.html b/htdocs/projects/gomp/index.html
index 87903289..114bcde6 100644
--- a/htdocs/projects/gomp/index.html
+++ b/htdocs/projects/gomp/index.html
@@ -28,7 +28,8 @@ OpenMP and OpenACC are supported with GCC's C, C++ and Fortran compilers.</p>
   <a href="#omp2.5">2.5</a> · <a href="#omp3.0">3.0</a> ·
   <a href="#omp3.1">3.1</a> · <a href="#omp4.0">4.0</a> ·
   <a href="#omp4.5">4.5</a> · <a href="#omp5.0">5.0</a> ·
-  <a href="#omp5.1">5.1</a> · <a href="#omp5.2">5.2</a></li>
+  <a href="#omp5.1">5.1</a> · <a href="#omp5.2">5.2</a> ·
+  <a href="#omp6.0">TR 11</a></li>
   <li><a href="#omp-status">OpenMP Releases and Status</a></li>
 </ul>
 
@@ -620,6 +621,16 @@ than listed, depending on resolved corner cases and optimizations.</p>
     <td class="supported"><a href="../../gcc-12/changes.html#languages">GCC&nbsp;12</a></td>
     <td></td>
   </tr>
+  <tr>
+    <td>device-specific ICV settings with environment variables</td>
+    <td class="supported"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>assume directive</td>
+    <td class="supported"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
+    <td></td>
+  </tr>
   <tr>
     <td><code>inoutset</code> argument to the <code>depend</code> clause</td>
     <td class="supported"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
@@ -650,6 +661,11 @@ than listed, depending on resolved corner cases and optimizations.</p>
     <td class="supported"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
     <td></td>
   </tr>
+  <tr>
+    <td>Support <code>begin/end declare target</code> syntax in C/C++</td>
+    <td class="supported"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
+    <td></td>
+  </tr>
   <tr>
     <td><em>target_device trait</em> in OpenMP Context</td>
     <td class="unsupported">No</td>
@@ -675,16 +691,6 @@ than listed, depending on resolved corner cases and optimizations.</p>
     <td class="unsupported">No</td>
     <td></td>
   </tr>
-  <tr>
-    <td>device-specific ICV settings with environment variables</td>
-    <td class="supported"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
-    <td></td>
-  </tr>
-  <tr>
-    <td>assume directive</td>
-    <td class="unsupported">No</td>
-    <td></td>
-  </tr>
   <tr>
     <td>Loop transformation constructs</td>
     <td class="unsupported">No</td>
@@ -727,27 +733,28 @@ than listed, depending on resolved corner cases and optimizations.</p>
     <td></td>
   </tr>
   <tr>
-    <td><code>ompt_sync_region_t</code> enum additions</td>
+    <td>For Fortran, diagnose placing declarative before/between <code>USE</code>,
+      <code>IMPORT</code>, and <code>IMPLICIT</code> as invalid
     <td class="unsupported">No</td>
     <td></td>
   </tr>
   <tr>
-    <td><code>ompt_state_t</code> enum: <code>ompt_state_wait_barrier_implementation</code> and <code>ompt_state_wait_barrier_teams</code></td>
+    <td><code>ompt_sync_region_t</code> enum additions</td>
     <td class="unsupported">No</td>
     <td></td>
   </tr>
   <tr>
-    <td><code>ompt_callback_target_data_op_emi_t</code>, <code>ompt_callback_target_emi_t</code>, <code>ompt_callback_target_map_emi_t</code> and <code>ompt_callback_target_submit_emi_t</code></td>
+    <td><code>ompt_state_t</code> enum: <code>ompt_state_wait_barrier_implementation</code> and <code>ompt_state_wait_barrier_teams</code></td>
     <td class="unsupported">No</td>
     <td></td>
   </tr>
   <tr>
-    <td><code>ompt_callback_error_t</code> type</td>
+    <td><code>ompt_callback_target_data_op_emi_t</code>, <code>ompt_callback_target_emi_t</code>, <code>ompt_callback_target_map_emi_t</code> and <code>ompt_callback_target_submit_emi_t</code></td>
     <td class="unsupported">No</td>
     <td></td>
   </tr>
   <tr>
-    <td>Support <code>begin/end declare target</code> syntax in C/C++</td>
+    <td><code>ompt_callback_error_t</code> type</td>
     <td class="unsupported">No</td>
     <td></td>
   </tr>
@@ -768,7 +775,7 @@ than listed, depending on resolved corner cases and optimizations.</p>
 <tbody>
     <tr>
     <td><code>omp_in_explicit_task</code> routine and <em>implicit-task-var</em> ICV</td>
-    <td class="unsupported">No</td>
+    <td class="supported"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
     <td></td>
   </tr>
   <tr id="impl-omp52-ompx">
@@ -832,7 +839,7 @@ than listed, depending on resolved corner cases and optimizations.</p>
     <td></td>
   </tr>
   <tr>
-    <td>Deprecation of <code>allocator</code> directive for Fortran allocatables/pointers</td>
+    <td>Deprecation of <code>allocate</code> directive for Fortran allocatables/pointers</td>
     <td class="unsupported">No</td>
     <td></td>
   </tr>
@@ -882,7 +889,7 @@ than listed, depending on resolved corner cases and optimizations.</p>
     <td></td>
   </tr>
   <tr>
-    <td>Default map-type for <code>map</code> clause in <code>target enter/exit data</code></td>
+    <td>Default map-type for the <code>map</code> clause in <code>target enter/exit data</code></td>
     <td class="supported"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
     <td></td>
   </tr>
@@ -933,6 +940,188 @@ code, the <code>omx</code> sentinel is warned for with <code>-Wsurprising</code>
 (enabled by <code>-Wall</code>). Unknown clauses are always rejected with an
 error.</p>
 
+<h3 id="omp6.0">OpenMP Technical Report 11</h3>
+
+<p>Technical Report (TR) 11 is the first preview for OpenMP 6.0.</p>
+
+<table class="ompstatus">
+<thead>
+  <tr>
+    <th>Feature</th>
+    <th>GCC Version</th>
+    <th>Comments</th>
+  </tr>
+</thead>
+<tbody>
+  <tr>
+    <td>Features deprecated in versions 5.2, 5.1 and 5.0 were removed</td>
+    <td class="other">N/A</td</td>
+    <td>Backward compatibility</td>
+  </tr>
+  <tr>
+    <td>The <code>decl</code> attribute was added to the C++ attribute syntax
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>_ALL</code> suffix to the device-scope environment variables
+    <td class="partial"><a href="../../gcc-13/changes.html#languages">GCC&nbsp;13</a></td>
+    <td>Host device number wrongly accepted</td>
+  </tr>
+  <tr>
+    <td>For Fortran, <em>locator list</em> can be also function reference with
+      data pointer result
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Ref-count change for <code>use_device_ptr</code>/<code>use_device_addr</code>
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Implicit reduction identifiers of C++ classes
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Change of the <em>map-type</em> property from <em>ultimate</em> to
+      <em>default</em>
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Concept of <em>assumed-size arrays</em> in C and C++
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Mapping of <em>assumed-size arrays</em> in C, C++ and Fortran
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>groupprivate</code> directive
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>local</code> clause to declare target directive
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>part_size</code> allocator trait
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>pin_device</code>, <code>preferred_device</code> and <code>target_access</code>
+      allocator traits
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>access</code> allocator trait changes
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Extension of <code>interop</code> operation of <code>append_args</code>, allowing all
+      modifiers of the <code>init</code> clause
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>interop</code> clause to <code>dispatch</code>
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>apply</code> code to loop-transforming constructs
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>omp_curr_progress_width</code> identifier
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>safesync</code> clause to the <code>parallel</code> construct
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>omp_get_max_progress_width</code> runtime routine
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>strict</code> modifier keyword to <code>num_threads</code>, <code>num_tasks</code>
+      and <code>grainsize</code>
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>memscope</code> clause to <code>atomic</code> and <code>flush</code>
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Routines for obtaining memory spaces/allocators for shared/device memory
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>omp_get_memspace_num_resources</code> routine
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>omp_get_submemspace</code> routine
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>ompt_get_buffer_limits</code> OMPT routine
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Extension of <code>OMP_DEFAULT_DEVICE</code> and new
+      <code>OMP_AVAILABLE_DEVICES</code> environment vars
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Supporting increments with abstract names in <code>OMP_PLACES</code>
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Relaxed Fortran restrictions to the <code>aligned</code> clause
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>Mapping lambda captures
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td>For Fortran, atomic compare with storing the comparison result
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+  <tr>
+    <td><code>aligned</code> clause changes for <code>simd</code> and <code>declare simd</code>
+    <td class="unsupported">No</td>
+    <td></td>
+  </tr>
+</tbody>
+</table>
+
 <h2 id="omp-status">OpenMP Releases and Status</h2>
 <dl>
 <dt><b>November 9, 2022</b></dt>

Re: [wwwdocs] gcc-13/changes.html + projects/gomp: OpenMP GCC 13 update

[Jakub Jelinek]

On Tue, Dec 06, 2022 at 10:32:40AM +0100, Tobias Burnus wrote:
> +      <code>omp_get_mapped_ptr</code> API routines. The assume and assumes

<code>assume</code> and <code>assumes</code> please

> +      directives, the <code>begin/end declare target</code> syntax in C/C++
> +      and device-specific ICV settings with environment variables are now
> +      supported.</li>
>      <li>
>        Initial support for OpenMP 5.2 features have been added: Support for
>        <code>firstprivate</code> and <code>allocate</code> clauses on the
> @@ -73,7 +75,14 @@ a work-in-progress.</p>
>        <code>omp_initial_device</code> and <code>omp_invalid_device</code>; and
>        optionally omitting the map-type in <code>target enter/exit data</code>.
>        The <code>enter</code> clause (as alias for <code>to</code>) has been added
> -      to the <code>declare target</code> directive.
> +      to the <code>declare target</code> directive. Also added has been the
> +      <code>omp_in_explicit_task</code> routine and the <code>doacross<code>
> +      clause as alias for <code>depend</code> with <code>source/sink</code>

<code>source</code>/<code>sink</code>

Otherwise LGTM.

	Jakub