[Openmp-commits] [openmp] 4b88bf5 - [OpenMP][docs] Update for record-and-replay

[Giorgis Georgakoudis via Openmp-commits]

Author: Giorgis Georgakoudis
Date: 2023-01-24T14:36:37-08:00
New Revision: 4b88bf5c70c351c9b6758da7026b5673c0dcc8d9

URL: https://github.com/llvm/llvm-project/commit/4b88bf5c70c351c9b6758da7026b5673c0dcc8d9
DIFF: https://github.com/llvm/llvm-project/commit/4b88bf5c70c351c9b6758da7026b5673c0dcc8d9.diff

LOG: [OpenMP][docs] Update for record-and-replay

Reviewed By: jdoerfert

Differential Revision: https://reviews.llvm.org/D142492

Added: 
    

Modified: 
    openmp/docs/ReleaseNotes.rst

Removed: 
    


################################################################################
diff  --git a/openmp/docs/ReleaseNotes.rst b/openmp/docs/ReleaseNotes.rst
index 48ae452ce9d1..994120472742 100644
--- a/openmp/docs/ReleaseNotes.rst
+++ b/openmp/docs/ReleaseNotes.rst
@@ -87,3 +87,14 @@ Non-comprehensive list of changes in this release
 * OpenMP-Opt (run as part of O1/O2/O3) will more effectively lower GPU resource
   usage and improve performance.
 
+* Support record-and-replay functionality for individual OpenMP offload kernels.
+  Enabling recording in the host OpenMP target runtime library stores per-kernel
+  the device image, device memory state, and kernel launching information. The
+  newly added command-line tool `llvm-omp-kernel-replay` replays kernel execution.
+  Environment variables control recording/replaying:
+   * LIBOMPTARGET_RECORDING=<0|1>, 0: disable recording (default), 1: enable recording
+   * LIBOMPTARGET_RR_DEVMEM_SIZE = <integer in bytes>, default 64GB, amount of device
+     memory to pre-allocate for storing/loading when recording/replaying
+   * LIBOMPTARGET_RR_SAVE_OUTPUT=<0|1>, 0: disable saving device memory post-kernel execution
+     (default), 1: enable saving device memory post-kernel execution (used for verification
+     with `llvm-omp-kernel-replay`)