[OpenMP][docs] Update for record-and-replay
authorGiorgis Georgakoudis <georgakoudis1@llnl.gov>
Tue, 24 Jan 2023 22:33:44 +0000 (14:33 -0800)
committerGiorgis Georgakoudis <georgakoudis1@llnl.gov>
Tue, 24 Jan 2023 22:36:37 +0000 (14:36 -0800)
Reviewed By: jdoerfert

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

openmp/docs/ReleaseNotes.rst

index 48ae452..9941204 100644 (file)
@@ -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`)