libgomp/doc/openmp-implementation-status/openmp-52.rst

   1 ..
   2   Copyright 1988-2022 Free Software Foundation, Inc.
   3   This is part of the GCC manual.
   4   For copying conditions, see the copyright.rst file.
   5
   6 .. _openmp-5.2:
   7
   8 OpenMP 5.2
   9 **********
  10
  11 New features listed in Appendix B of the OpenMP specification
  12 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
  13
  14 .. list-table::
  15    :header-rows: 1
  16    :widths: 50 10 25
  17
  18    * - Description
  19      - Status
  20      - Comments
  21
  22    * - ``omp_in_explicit_task`` routine and *explicit-task-var* ICV
  23      - Y
  24      -
  25    * - ``omp`` / ``ompx`` / ``omx`` sentinels and ``omp_`` / ``ompx_`` namespaces
  26      - N/A
  27      - warning for ``ompx/omx`` sentinels [#f1]_
  28    * - Clauses on ``end`` directive can be on directive
  29      - N
  30      -
  31    * - Deprecation of no-argument ``destroy`` clause on ``depobj``
  32      - N
  33      -
  34    * - ``linear`` clause syntax changes and ``step`` modifier
  35      - Y
  36      -
  37    * - Deprecation of minus operator for reductions
  38      - N
  39      -
  40    * - Deprecation of separating ``map`` modifiers without comma
  41      - N
  42      -
  43    * - ``declare mapper`` with iterator and ``present`` modifiers
  44      - N
  45      -
  46    * - If a matching mapped list item is not found in the data environment, the pointer retains its original value
  47      - N
  48      -
  49    * - New ``enter`` clause as alias for ``to`` on declare target directive
  50      - Y
  51      -
  52    * - Deprecation of ``to`` clause on declare target directive
  53      - N
  54      -
  55    * - Extended list of directives permitted in Fortran pure procedures
  56      - N
  57      -
  58    * - New ``allocators`` directive for Fortran
  59      - N
  60      -
  61    * - Deprecation of ``allocate`` directive for Fortran allocatables/pointers
  62      - N
  63      -
  64    * - Optional paired ``end`` directive with ``dispatch``
  65      - N
  66      -
  67    * - New ``memspace`` and ``traits`` modifiers for ``uses_allocators``
  68      - N
  69      -
  70    * - Deprecation of traits array following the allocator_handle expression in ``uses_allocators``
  71      - N
  72      -
  73    * - New ``otherwise`` clause as alias for ``default`` on metadirectives
  74      - N
  75      -
  76    * - Deprecation of ``default`` clause on metadirectives
  77      - N
  78      -
  79    * - Deprecation of delimited form of ``declare target``
  80      - N
  81      -
  82    * - Reproducible semantics changed for ``order(concurrent)``
  83      - N
  84      -
  85    * - ``allocate`` and ``firstprivate`` clauses on ``scope``
  86      - Y
  87      -
  88    * - ``ompt_callback_work``
  89      - N
  90      -
  91    * - Default map-type for ``map`` clause in ``target enter/exit data``
  92      - Y
  93      -
  94    * - New ``doacross`` clause as alias for ``depend`` with ``source`` / ``sink`` modifier
  95      - Y
  96      -
  97    * - Deprecation of ``depend`` with ``source`` / ``sink`` modifier
  98      - N
  99      -
 100    * - ``omp_cur_iteration`` keyword
 101      - Y
 102      -
 103
 104 .. [#f1] The ``ompx`` sentinel as C/C++ pragma and C++ attributes are warned for with ``-Wunknown-pragmas`` (implied by ``-Wall``) and ``-Wattributes`` (enabled by default), respectively; for Fortran free-source code, there is a warning enabled by default and, for fixed-source code, the ``omx`` sentinel is warned for with with ``-Wsurprising`` (enabled by ``-Wall``).  Unknown clauses are always rejected with an error.
 105
 106 Other new OpenMP 5.2 features
 107 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 108
 109 .. list-table::
 110    :header-rows: 1
 111    :widths: 50 10 25
 112
 113    * - Description
 114      - Status
 115      - Comments
 116
 117    * - For Fortran, optional comma between directive and clause
 118      - N
 119      -
 120    * - Conforming device numbers and ``omp_initial_device`` and ``omp_invalid_device`` enum/PARAMETER
 121      - Y
 122      -
 123    * - Initial value of *default-device-var* ICV with ``OMP_TARGET_OFFLOAD=mandatory``
 124      - N
 125      -
 126    * - *interop_types* in any position of the modifier list for the ``init`` clause of the ``interop`` construct
 127      - N
 128      -
 129
 130 .. -
 131    OpenMP Runtime Library Routines
 132    -