| =========================== |
| OpenMP 12.0.0 Release Notes |
| =========================== |
| |
| |
| .. warning:: |
| These are in-progress notes for the upcoming LLVM 12.0.0 release. |
| Release notes for previous releases can be found on |
| `the Download Page <https://releases.llvm.org/download.html>`_. |
| |
| |
| Introduction |
| ============ |
| |
| This document contains the release notes for the OpenMP runtime, release 12.0.0. |
| Here we describe the status of OpenMP, including major improvements |
| from the previous release. All OpenMP releases may be downloaded |
| from the `LLVM releases web site <https://llvm.org/releases/>`_. |
| |
| Non-comprehensive list of changes in this release |
| ================================================= |
| |
| - Extended the ``libomptarget`` API functions to include source location |
| information and OpenMP target mapper support. This allows ``libomptarget`` to |
| know the source location of the OpenMP region it is executing, as well as the |
| name and declarations of all the variables used inside the region. Each |
| function generated now uses its ``mapper`` variant. The old API calls now call |
| into the new API functions with ``nullptr`` arguments for backwards |
| compatibility with old binaries. Source location information for |
| ``libomptarget`` is now generated by Clang at any level of debugging |
| information. |
| |
| - Added improved error messages for ``libomptarget`` and ``CUDA`` plugins. Error |
| messages are now presented without requiring a debug build of |
| ``libomptarget``. The newly added source location information can also be used |
| to identify which OpenMP target region the failure occurred in. More |
| information can be found :ref:`here <libopenmptarget_errors>`. |
| |
| - Added additional environment variables to control output from the |
| ``libomptarget`` runtime library. ``LIBOMPTARGET_PROFILE`` to |
| generate time profile output similar to Clang's ``-ftime-trace`` option. |
| ``LIBOMPTARGET_MEMORY_MANAGER_THRESHOLD`` sets the threshold size for which |
| the ``libomptarget`` memory manager will handle the allocation. |
| ``LIBOMPTARGET_INFO`` allows the user to request certain information from the |
| ``libomptarget`` runtime using a 32-bit field. A full description of each |
| environment variable is described :ref:`here <libopenmptarget_environment_vars>`. |