From: Thomas Schwinge <thomas@codesourcery.com>
Date: Fri, 24 Mar 2023 14:14:57 +0000 (+0100)
Subject: libgomp: Document OpenMP 'pinned' memory
X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=165b44cd22232ba7fc16dfd457322f6c95499d01;p=thirdparty%2Fgcc.git

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 22beccc3ee3b..d8a7e4760906 100644
--- 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 288e0b3a8eaa..6355ce2a37ba 100644
--- 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