libgomp: Document OpenMP 'pinned' memory

	libgomp/
	* libgomp.texi (AMD Radeon, nvptx): Document OpenMP 'pinned'
	memory.

diff --git a/libgomp/ChangeLog.omp b/libgomp/ChangeLog.omp
index 22beccc3ee3b121a03277a8586f7f07eebbc8080..d8a7e4760906e623f68dfb0a1eb923b7d7eee024 100644 (file)
--- a/libgomp/ChangeLog.omp
+++ b/libgomp/ChangeLog.omp
@@ -1,3 +1,8 @@
+2023-04-03  Thomas Schwinge  <thomas@codesourcery.com>
+
+       * libgomp.texi (AMD Radeon, nvptx): Document OpenMP 'pinned'
+       memory.
+
 2023-03-27  Julian Brown  <julian@codesourcery.com>
 
        * testsuite/libgomp.c++/static-aggr-constructor-destructor-1.C: New

diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi
index 288e0b3a8eaadf739ec7bb105d186318e78affbc..6355ce2a37ba99260eb675cbdd2435b9f6242178 100644 (file)
--- a/libgomp/libgomp.texi
+++ b/libgomp/libgomp.texi
@@ -4456,6 +4456,9 @@ The implementation remark:
 @item OpenMP code that has a requires directive with @code{unified_address} or
       @code{unified_shared_memory} will remove any GCN device from the list of
       available devices (``host fallback'').
+@item OpenMP @emph{pinned} memory (@code{omp_atk_pinned},
+      @code{ompx_pinned_mem_alloc}, for example)
+      is allocated via @code{mmap}, @code{mlock}.
 @end itemize
 
 
@@ -4518,6 +4521,11 @@ The implementation remark:
 @item OpenMP code that has a requires directive with @code{unified_address}
       or @code{unified_shared_memory} will remove any nvptx device from the
       list of available devices (``host fallback'').
+@item OpenMP @emph{pinned} memory (@code{omp_atk_pinned},
+      @code{ompx_pinned_mem_alloc}, for example)
+      is allocated via @code{cuMemHostAlloc} (CUDA Driver API).
+      This potentially helps optimization of host <-> device data
+      transfers.
 @end itemize