From patchwork Sun Feb 2 09:08:31 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: Tobias Burnus X-Patchwork-Id: 1232358 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@bilbo.ozlabs.org Authentication-Results: ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org (client-ip=209.132.180.131; helo=sourceware.org; envelope-from=gcc-patches-return-518721-incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=) Authentication-Results: ozlabs.org; dmarc=none (p=none dis=none) header.from=net-b.de Authentication-Results: ozlabs.org; dkim=pass (1024-bit key; unprotected) header.d=gcc.gnu.org header.i=@gcc.gnu.org header.a=rsa-sha1 header.s=default header.b=QpaxB15o; dkim-atps=neutral Received: from sourceware.org (server1.sourceware.org [209.132.180.131]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ozlabs.org (Postfix) with ESMTPS id 489Q9q2Ztzz9sRK for ; Sun, 2 Feb 2020 20:08:44 +1100 (AEDT) DomainKey-Signature: a=rsa-sha1; c=nofws; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:to :from:subject:message-id:date:mime-version:content-type; q=dns; s=default; b=kT80K05OHWbrIM8IGeat+HhidRcGuj+8daDSsQL6uD9m5j/1vN l/qWwiYwJ5DWKy9XLZGBhZoAMC8CM2p3xyXAy+NwFyKUxZ+/sml90s1/g7X+rw2e rSRWGws7CO8O3XAZ9nfCIJZks3Kl3oVqCSeh9BdToG3vaj82pYJ3FFWgU= DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=gcc.gnu.org; h=list-id :list-unsubscribe:list-archive:list-post:list-help:sender:to :from:subject:message-id:date:mime-version:content-type; s= default; bh=lHcolZa/a9DcgWXKLqole0iyd1U=; b=QpaxB15oOKb97TuEsd1G 4tMWKQVcr+eQ/40bDG0jLeB/MZ009Ww/h1oJjMqHvtaY8i0nztCT4KyDXAM0IpGZ AXJ3lj7JLF5C+M000ib23K4xJeJhFoQg6M8fC+5adqI5Tb1LOIXVfpVdGGQyt0c0 lkDeoObymHaMCEv4TNpakoo= Received: (qmail 113304 invoked by alias); 2 Feb 2020 09:08:37 -0000 Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Unsubscribe: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Delivered-To: mailing list gcc-patches@gcc.gnu.org Received: (qmail 113289 invoked by uid 89); 2 Feb 2020 09:08:36 -0000 Authentication-Results: sourceware.org; auth=none X-Spam-SWARE-Status: No, score=-13.8 required=5.0 tests=AWL, BAYES_00, GIT_PATCH_0, GIT_PATCH_1, GIT_PATCH_2, GIT_PATCH_3, KAM_SHORT, RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.1 spammy=Answer, uploads X-HELO: mx-relay05-hz1.antispameurope.com Received: from mx-relay05-hz1.antispameurope.com (HELO mx-relay05-hz1.antispameurope.com) (94.100.132.205) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with ESMTP; Sun, 02 Feb 2020 09:08:35 +0000 Received: from s041.bre.qsc.de ([195.90.7.81]) by mx-relay05-hz1.antispameurope.com; Sun, 02 Feb 2020 10:08:32 +0100 Received: from localhost.localdomain (port-92-195-210-174.dynamic.as20676.net [92.195.210.174]) by s041.bre.qsc.de (Postfix) with ESMTPSA id 697192C0358; Sun, 2 Feb 2020 10:08:31 +0100 (CET) To: gcc-patches , fortran , Jakub Jelinek From: Tobias Burnus Subject: [Patch] [OpenMP] Add missing parameters to omp_lib documentation (PR fortran/93541) Message-ID: Date: Sun, 2 Feb 2020 10:08:31 +0100 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:68.0) Gecko/20100101 Thunderbird/68.4.1 MIME-Version: 1.0 X-cloud-security-sender: burnus@net-b.de X-cloud-security-recipient: gcc-patches@gcc.gnu.org X-cloud-security-Virusscan: CLEAN X-cloud-security-disclaimer: This E-Mail was scanned by E-Mailservice on mx-relay05-hz1.antispameurope.com with D7B391A8300 X-cloud-security-connect: s041.bre.qsc.de[195.90.7.81], TLS=1, IP=195.90.7.81 X-cloud-security: scantime:.2060 I recently stumbled over the intrinsic module documentation and wondered whether it was complete. Answer: It wasn't. Cf. https://gcc.gnu.org/onlinedocs/gfortran/OpenMP-Modules-OMP_005fLIB-and-OMP_005fLIB_005fKINDS.html Pause was added 8th Nov 2018 → GCC 9. The lock hint already 2015-10-13. Hence, the patch "as is" applies also to GCC 9 while for GCC 8, one has to remove the "pause" bit before applying. OK? – And for which branches? Tobias PR fortran/93541 * intrinisic.texi (OpenMP Modules OMP_LIB and OMP_LIB_KINDS): Add undocumented parameters from omp_lib.f90.in. diff --git a/gcc/fortran/intrinsic.texi b/gcc/fortran/intrinsic.texi index 823cb9cef30..842c88b2eba 100644 --- a/gcc/fortran/intrinsic.texi +++ b/gcc/fortran/intrinsic.texi @@ -15307,13 +15307,16 @@ below. For details refer to the actual @uref{http://www.openmp.org/wp-content/uploads/openmp-4.5.pdf, OpenMP Application Program Interface v4.5}. +And for the @code{pause}-related constants to the OpenMP 5.0 specification. @code{OMP_LIB_KINDS} provides the following scalar default-integer named constants: @table @asis @item @code{omp_lock_kind} +@item @code{omp_lock_hint_kind} @item @code{omp_nest_lock_kind} +@item @code{omp_pause_resource_kind} @item @code{omp_proc_bind_kind} @item @code{omp_sched_kind} @end table @@ -15344,6 +15347,24 @@ kind @code{omp_proc_bind_kind}: @item @code{omp_proc_bind_spread} @end table +The following scalar integer named constants are of the +kind @code{omp_lock_hint_kind}: + +@table @asis +@item @code{omp_lock_hint_none} +@item @code{omp_lock_hint_uncontended} +@item @code{omp_lock_hint_contended} +@item @code{omp_lock_hint_nonspeculative} +@item @code{omp_lock_hint_speculative} +@end table + +And the following two scalar integer named constants are of the +kind @code{omp_pause_resource_kind}: + +@table @asis +@item @code{omp_pause_soft} +@item @code{omp_pause_hard} +@end table @node OpenACC Module OPENACC