From patchwork Mon Oct 18 07:22:51 2021 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Tobias Burnus X-Patchwork-Id: 46319 Return-Path: X-Original-To: patchwork@sourceware.org Delivered-To: patchwork@sourceware.org Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id 470CC3857C4A for ; Mon, 18 Oct 2021 07:23:16 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from esa2.mentor.iphmx.com (esa2.mentor.iphmx.com [68.232.141.98]) by sourceware.org (Postfix) with ESMTPS id 00A1E3858D35 for ; Mon, 18 Oct 2021 07:22:58 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 00A1E3858D35 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com IronPort-SDR: BPtTj3CeDoBAZ+4KbLhv3Y4nVtsL5NdoQ+0iv1/j9GRHG0+aGerqonHWN2qxaee5X4q1Ix3fg5 S6rIlJ5MWwcBqAsS8Zpcw5skqBj9x0Nn+XVO3e+/yXsFeiQsX9qSB2zIZGuWQ64ARPUGFdCOdf ZZ2EfRLpu5OGtpvMlhwXOce2XOcB5oXZgmJhHTW2IxZqNnMnX9LV8wkiJmbUb/Jsqfq9TOnjjd 4mCWmReghE902Sr8IqiseboaUYOtGJsLaOaWz1WklXMJ4PhzuY7iIeOmOEruNaOnCSRPZs1eYF UfcLLNhSRbbM60ngE+iOybg0 X-IronPort-AV: E=Sophos;i="5.85,381,1624348800"; d="diff'?scan'208";a="67302451" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa2.mentor.iphmx.com with ESMTP; 17 Oct 2021 23:22:57 -0800 IronPort-SDR: kjaVF9SdAZ/SyYqatQC15vova4v5Y4SetKfObdt0am5baXtYgTDjbd/EKtrlKEbvUqWIamBB/G poYYUDhB9PwBOipiKeCurGS94jJsOz6rhGTJwXRCCfGXNFuIyPcceOT+rAkbHIDuyzYNHd6kP+ cmAeVEcnkMf8IuI1Lauab0TqHI2F6DaSg/QAKX3CT0f14xQRpWm7B9/hg+WM+6mmkN6H5ihsgU eMDPqmfDFiQ9r7+QsMVtq8KDQOnnc40WOByohvWKlodmGf7NjHIiKrRZGrrPqc27+wva+5zyec yug= Message-ID: <5baf5009-23e5-0f56-cf94-cf200caed701@codesourcery.com> Date: Mon, 18 Oct 2021 09:22:51 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:91.0) Gecko/20100101 Thunderbird/91.2.0 Content-Language: en-US To: Jakub Jelinek , gcc-patches From: Tobias Burnus Subject: [Patch] libgomp.texi: Update OMP_PLACES X-Originating-IP: [137.202.0.90] X-ClientProxiedBy: svr-ies-mbx-09.mgc.mentorg.com (139.181.222.9) To svr-ies-mbx-01.mgc.mentorg.com (139.181.222.1) X-Spam-Status: No, score=-11.6 required=5.0 tests=BAYES_00, GIT_PATCH_0, HEADER_FROM_DIFFERENT_DOMAINS, KAM_DMARC_STATUS, SPF_HELO_PASS, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.4 X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces+patchwork=sourceware.org@gcc.gnu.org Sender: "Gcc-patches" This patch updates the OMP_PLACES description for the recent OpenMP 5.1 changes. OK? I actually wonder when/whether the spec reference should be updated to OpenMP 5.1 or an additional reference to it should be added. Tobias ----------------- Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstraße 201, 80634 München; Gesellschaft mit beschränkter Haftung; Geschäftsführer: Thomas Heurung, Frank Thürauf; Sitz der Gesellschaft: München; Registergericht München, HRB 106955 libgomp.texi: Update OMP_PLACES libgomp/ChangeLog: * libgomp.texi (OMP_PLACES): Extend description for OMP 5.1 changes. diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi index e9fa8ba0bf7..58d63c50935 100644 --- a/libgomp/libgomp.texi +++ b/libgomp/libgomp.texi @@ -2031,18 +2031,22 @@ When undefined, @env{OMP_PROC_BIND} defaults to @code{TRUE} when @table @asis @item @emph{Description}: The thread placement can be either specified using an abstract name or by an -explicit list of the places. The abstract names @code{threads}, @code{cores} -and @code{sockets} can be optionally followed by a positive number in -parentheses, which denotes the how many places shall be created. With -@code{threads} each place corresponds to a single hardware thread; @code{cores} -to a single core with the corresponding number of hardware threads; and with -@code{sockets} the place corresponds to a single socket. The resulting -placement can be shown by setting the @env{OMP_DISPLAY_ENV} environment -variable. +explicit list of the places. The abstract names @code{threads}, @code{cores}, +@code{sockets}, @code{ll_caches} and @code{numa_domains} can be optionally +followed by a positive number in parentheses, which denotes the how many places +shall be created. With @code{threads} each place corresponds to a single +hardware thread; @code{cores} to a single core with the corresponding number of +hardware threads; with @code{sockets} the place corresponds to a single +socket; with @code{ll_caches} to a set of cores that shares the last level +cache on the device; and @code{numa_domains} to a set of cores for which their +closest memory on the device is the same meory and at a similar distance from +the cores. The resulting placement can be shown by setting the +@env{OMP_DISPLAY_ENV} environment variable. Alternatively, the placement can be specified explicitly as comma-separated -list of places. A place is specified by set of nonnegative numbers in curly -braces, denoting the denoting the hardware threads. The hardware threads +list of places. A place is specified by a single nonnegative number or +by a set of nonnegative numbers in curly braces, denoting the denoting +the hardware threads. The hardware threads belonging to a place can either be specified as comma-separated list of nonnegative thread numbers or using an interval. Multiple places can also be either specified by a comma-separated list of places or by an interval. To