From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <gcc-bugzilla@gcc.gnu.org>
Received: by sourceware.org (Postfix, from userid 48)
	id 6FA1A3858D35; Thu, 22 Jun 2023 13:01:27 +0000 (GMT)
DKIM-Filter: OpenDKIM Filter v2.11.0 sourceware.org 6FA1A3858D35
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gcc.gnu.org;
	s=default; t=1687438887;
	bh=Iq2MXc03cKuM9XlW4St/4OMY8Ipl9em04Byx3O0dYTY=;
	h=From:To:Subject:Date:From;
	b=rCaYLZFuAkPS3jURjyBWa28eew1JhiZhFZeEKVs430+O93DOz/zAUq/uRi8fGCD5f
	 YDExozs0aHD/oDTxEPObbbwFewH2A4JJkPKuDA+GfUVcdv7TfNl2S7BOtOANZPqDgK
	 BZRqfeUF71ZPmPpjxQIAOnh6F7bpg5iJ2qSIdHRc=
From: "burnus at gcc dot gnu.org" <gcc-bugzilla@gcc.gnu.org>
To: gcc-bugs@gcc.gnu.org
Subject: [Bug libgomp/110364] New: [OpenMP] Environment vars - doc and
 device-specific cleanup; make GOMP_DEBUG more useful; janitorial takes
Date: Thu, 22 Jun 2023 13:01:26 +0000
X-Bugzilla-Reason: CC
X-Bugzilla-Type: new
X-Bugzilla-Watch-Reason: None
X-Bugzilla-Product: gcc
X-Bugzilla-Component: libgomp
X-Bugzilla-Version: 14.0
X-Bugzilla-Keywords: documentation, openmp
X-Bugzilla-Severity: normal
X-Bugzilla-Who: burnus at gcc dot gnu.org
X-Bugzilla-Status: UNCONFIRMED
X-Bugzilla-Resolution: 
X-Bugzilla-Priority: P3
X-Bugzilla-Assigned-To: unassigned at gcc dot gnu.org
X-Bugzilla-Target-Milestone: ---
X-Bugzilla-Flags: 
X-Bugzilla-Changed-Fields: bug_id short_desc product version bug_status
 keywords bug_severity priority component assigned_to reporter cc
 target_milestone
Message-ID: <bug-110364-4@http.gcc.gnu.org/bugzilla/>
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable
X-Bugzilla-URL: http://gcc.gnu.org/bugzilla/
Auto-Submitted: auto-generated
MIME-Version: 1.0
List-Id: <gcc-bugs.sourceware.org>

https://gcc.gnu.org/bugzilla/show_bug.cgi?id=3D110364

            Bug ID: 110364
           Summary: [OpenMP] Environment vars - doc and device-specific
                    cleanup; make GOMP_DEBUG more useful; janitorial takes
           Product: gcc
           Version: 14.0
            Status: UNCONFIRMED
          Keywords: documentation, openmp
          Severity: normal
          Priority: P3
         Component: libgomp
          Assignee: unassigned at gcc dot gnu.org
          Reporter: burnus at gcc dot gnu.org
                CC: jakub at gcc dot gnu.org
  Target Milestone: ---

OpenMP TR11 added the _ALL, _DEV, and _DEV_<number> suffix.


After the patch work stated, the following addition was done to the spec:
=E2=80=A2 Device-specific environment variables must not specify the initia=
l device.

TODO: Implement this.


OMP_STACKSIZE_DEV etc. =E2=86=92 Make this applicable to the non-host devic=
es,
=E2=86=92 GCN_STACK_SIZE and nvptx's nvptx_stacks_size() (which is per warp=
!).


Improve the documentation (and implementation) with regards to the
device-specific ICVs - namely: which are handled, which aren't + possibly
implement some if needed.
Cross ref: PR 109620 (OMP_CANCELLATION), PR109875 (OMP_NUM_TEAMS)

(First step for the documentation bit was commit
r14-2032-g2cd0689a79498dcaaadc8cc5c1c4d0a452a4fb09)


GOMP_DEBUG: Currently, it is a 0 or all flag, it would be much more useful =
it
the numeric values could be used - either as (n) less output than (n+1) or
using some bitmap flags like 1<<0, 1<<1, 1<<2 turning on different outputs
(possibly with supporting some a comma-separated list of names for them.

In particular, plugin-nvptx outputs too much - and GCN has its own GCN_DEBU=
G.

* * *

BTW: While all OMP_* env vars are documented, the "OpenMP Runtime Library
Routines" lacks many routines there were added.

I additionally wonder whether the named-constants and kinds documentation
should be moved from Fortran's ../gcc/fortran/intrinsic.texi to libgomp and
extended to cover also the C/C++.=