From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1643) id 63B113858D37; Mon, 3 Apr 2023 14:38:05 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 63B113858D37 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org; s=default; t=1680532685; bh=nGZ69lpAYRdcWlBYQdwKzTSA+gLHaytTIt/1Q5L37GQ=; h=From:To:Subject:Date:From; b=USRAcsLyWwhY1c0USYJ2UXoBG68JlqV9Mr54OqCWvNyAVCbNzoAA9CRq/uxHqijz8 iOTRnciSx0wxo/unZNA8/bavCeg3FXi6aup9IG5LSalWNJ+pr82U28Vh1hcQVM1w0Q xZuM6dbivdSVy4fJiN+y+BmAsLY+UPsvGDorS9/E= Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Thomas Schwinge To: gcc-cvs@gcc.gnu.org Subject: [gcc/devel/omp/gcc-12] libgomp: Document OpenMP 'pinned' memory X-Act-Checkin: gcc X-Git-Author: Thomas Schwinge X-Git-Refname: refs/heads/devel/omp/gcc-12 X-Git-Oldrev: 472783f3137475b82baadac31cca31021b69aba9 X-Git-Newrev: 165b44cd22232ba7fc16dfd457322f6c95499d01 Message-Id: <20230403143805.63B113858D37@sourceware.org> Date: Mon, 3 Apr 2023 14:38:05 +0000 (GMT) List-Id: https://gcc.gnu.org/g:165b44cd22232ba7fc16dfd457322f6c95499d01 commit 165b44cd22232ba7fc16dfd457322f6c95499d01 Author: Thomas Schwinge Date: Fri Mar 24 15:14:57 2023 +0100 libgomp: Document OpenMP 'pinned' memory libgomp/ * libgomp.texi (AMD Radeon, nvptx): Document OpenMP 'pinned' memory. Diff: --- libgomp/ChangeLog.omp | 5 +++++ libgomp/libgomp.texi | 8 ++++++++ 2 files changed, 13 insertions(+) diff --git a/libgomp/ChangeLog.omp b/libgomp/ChangeLog.omp index 22beccc3ee3..d8a7e476090 100644 --- a/libgomp/ChangeLog.omp +++ b/libgomp/ChangeLog.omp @@ -1,3 +1,8 @@ +2023-04-03 Thomas Schwinge + + * libgomp.texi (AMD Radeon, nvptx): Document OpenMP 'pinned' + memory. + 2023-03-27 Julian Brown * testsuite/libgomp.c++/static-aggr-constructor-destructor-1.C: New diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi index 288e0b3a8ea..6355ce2a37b 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