From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: by sourceware.org (Postfix, from userid 1534) id 961FB385AE4F; Mon, 4 Jul 2022 20:11:31 +0000 (GMT) DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 961FB385AE4F Content-Type: text/plain; charset="us-ascii" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit From: Tobias Burnus To: gcc-cvs@gcc.gnu.org Subject: [gcc/devel/omp/gcc-12] libgomp.texi: Document OpenMP context selectors X-Act-Checkin: gcc X-Git-Author: Tobias Burnus X-Git-Refname: refs/heads/devel/omp/gcc-12 X-Git-Oldrev: d02972a2dab719f00520ab07476d11340cf76192 X-Git-Newrev: bf4e0a66d0027fc20f216afc8e84d8ae35baf0ca Message-Id: <20220704201131.961FB385AE4F@sourceware.org> Date: Mon, 4 Jul 2022 20:11:31 +0000 (GMT) X-BeenThere: gcc-cvs@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-cvs mailing list List-Unsubscribe: , List-Archive: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 04 Jul 2022 20:11:31 -0000 https://gcc.gnu.org/g:bf4e0a66d0027fc20f216afc8e84d8ae35baf0ca commit bf4e0a66d0027fc20f216afc8e84d8ae35baf0ca Author: Tobias Burnus Date: Mon Jul 4 21:45:43 2022 +0200 libgomp.texi: Document OpenMP context selectors libgomp/ * libgomp.texi (Offload-Target Specifics): New chapter; add section to document OpenMP context selectors. (cherry picked from commit 61fe7b7d463f2f6bbeb175c345a68b844b396d56) Diff: --- libgomp/ChangeLog.omp | 8 ++++++++ libgomp/libgomp.texi | 32 ++++++++++++++++++++++++++++++++ 2 files changed, 40 insertions(+) diff --git a/libgomp/ChangeLog.omp b/libgomp/ChangeLog.omp index 5e1997de255..be874675d35 100644 --- a/libgomp/ChangeLog.omp +++ b/libgomp/ChangeLog.omp @@ -1,3 +1,11 @@ +2022-07-04 Tobias Burnus + + Backport from mainline: + 2022-05-17 Tobias Burnus + + * libgomp.texi (Offload-Target Specifics): New chapter; add section + to document OpenMP context selectors. + 2022-07-04 Tobias Burnus Backport from mainline: diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi index 4c25da345a6..93b9523a662 100644 --- a/libgomp/libgomp.texi +++ b/libgomp/libgomp.texi @@ -113,6 +113,7 @@ changed to GNU Offloading and Multi Processing Runtime Library. * OpenACC Library Interoperability:: OpenACC library interoperability with the NVIDIA CUBLAS library. * OpenACC Profiling Interface:: +* Offload-Target Specifics:: Notes on offload-target specific internals * The libgomp ABI:: Notes on the external ABI presented by libgomp. * Reporting Bugs:: How to report bugs in the GNU Offloading and Multi Processing Runtime Library. @@ -4249,6 +4250,37 @@ offloading devices (it's not clear if they should be): @item @code{acc_memcpy_from_device}, @code{acc_memcpy_from_device_async} @end itemize +@c --------------------------------------------------------------------- +@c Offload-Target Specifics +@c --------------------------------------------------------------------- + +@node Offload-Target Specifics +@chapter Offload-Target Specifics + +The following sections present notes on the offload-target specifics. + +@menu +* OpenMP Context Selectors:: +@end menu + +@node OpenMP Context Selectors +@section OpenMP Context Selectors + +@code{vendor} is always @code{gnu}. References are to the GCC manual. + +@multitable @columnfractions .60 .10 .25 +@headitem @code{arch} @tab @code{kind} @tab @code{isa} +@item @code{intel_mic}, @code{x86}, @code{x86_64}, @code{i386}, @code{i486}, + @code{i586}, @code{i686}, @code{ia32} + @tab @code{host} + @tab See @code{-m...} flags in ``x86 Options'' (without @code{-m}) +@item @code{amdgcn} @code{gcn} + @tab @code{gpu} + @tab See @code{-march=} in ``AMD GCN Options'' +@item @code{nvptx} + @tab @code{gpu} + @tab See @code{-misa=} in ``Nvidia PTX Options'' +@end multitable @c ---------------------------------------------------------------------