From patchwork Mon Aug 5 07:26:12 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Tobias Burnus X-Patchwork-Id: 1968914 Return-Path: X-Original-To: incoming@patchwork.ozlabs.org Delivered-To: patchwork-incoming@legolas.ozlabs.org Authentication-Results: legolas.ozlabs.org; dkim=pass (2048-bit key; unprotected) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.a=rsa-sha256 header.s=20230601 header.b=YDYta4Qp; dkim-atps=neutral Authentication-Results: legolas.ozlabs.org; spf=pass (sender SPF authorized) smtp.mailfrom=gcc.gnu.org (client-ip=2620:52:3:1:0:246e:9693:128c; helo=server2.sourceware.org; envelope-from=gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org; receiver=patchwork.ozlabs.org) Received: from server2.sourceware.org (server2.sourceware.org [IPv6:2620:52:3:1:0:246e:9693:128c]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (secp384r1) server-digest SHA384) (No client certificate requested) by legolas.ozlabs.org (Postfix) with ESMTPS id 4Wcp0G4BT9z1yYD for ; Mon, 5 Aug 2024 17:26:37 +1000 (AEST) Received: from server2.sourceware.org (localhost [IPv6:::1]) by sourceware.org (Postfix) with ESMTP id B5F7C385DDE9 for ; Mon, 5 Aug 2024 07:26:35 +0000 (GMT) X-Original-To: gcc-patches@gcc.gnu.org Delivered-To: gcc-patches@gcc.gnu.org Received: from mail-wm1-x332.google.com (mail-wm1-x332.google.com [IPv6:2a00:1450:4864:20::332]) by sourceware.org (Postfix) with ESMTPS id 8C03D385841C for ; Mon, 5 Aug 2024 07:26:15 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org 8C03D385841C Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=baylibre.com ARC-Filter: OpenARC Filter v1.0.0 sourceware.org 8C03D385841C Authentication-Results: server2.sourceware.org; arc=none smtp.remote-ip=2a00:1450:4864:20::332 ARC-Seal: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1722842778; cv=none; b=AI4T2A/4UfcFuujBlDBcd4biIBmWwyjIH6fvWmDz5VM+TW4t0AUuNhaiN8SqbgfYDITPzL306MIX9eziF/zEm1w80sxMrhrBtyHWy9FOh1wV5QLHJNN0CGS/LBTeQokg5umRflHlZ3irmB8e9o8FlMrYUI+yoCgXEunpKXblo0s= ARC-Message-Signature: i=1; a=rsa-sha256; d=sourceware.org; s=key; t=1722842778; c=relaxed/simple; bh=RraKLU5D5eDgBdlX/Lr738WhgDHAQ0Ib3WwRjni75O4=; h=DKIM-Signature:Message-ID:Date:MIME-Version:To:From:Subject; b=vxD9Vk7kWZkHmhJVugmXN/+k7h6LXoyDtY9BLxnCRXbBkC2gjAbMHKAA1imiyDkNFEcXor4YnNsVBw0HuPeffsHH5+Bx7ASQ2AC2qgBp3gk0dhXUgEVhfRzuwlo8OfiLOKCM01e/ch0knpqz5BmIOtwzZkJBz8KOmYR7234QduI= ARC-Authentication-Results: i=1; server2.sourceware.org Received: by mail-wm1-x332.google.com with SMTP id 5b1f17b1804b1-42809d6e719so70635715e9.3 for ; Mon, 05 Aug 2024 00:26:15 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1722842774; x=1723447574; darn=gcc.gnu.org; h=subject:from:to:content-language:user-agent:mime-version:date :message-id:from:to:cc:subject:date:message-id:reply-to; bh=jCEopVRYKVzMORBPanaGfI/WZxT4ttvPMHAn/Hlxp5E=; b=YDYta4QpAGX6sZKc6D4trlytYVr/Xhb5xAKFC40PxpazlyDXJFc0wjiVWp6hfV363W XrXG7dhOIdg8Fz4Cq50qXk4gSXDxNhnH7SDDFISdUjau5HtjYTSQFok1yYFAorAIJaBN k2hARKNZTyrdUrufgg8T//PRO6HxIBtJJWSOchtZ4+gDjM12glMusOGZMBr64L7SZOIC R891/uIkdo5v87W7FU5oSOUm6Dzhb3oz7oJO1CvdVfA0RT/BKjbkni6G2T5Bfjasiw2R xQ3Ancz9P7hGpPSx9Xgoy1zCD16qkmhg/bGMLQTtn+BV72CDwUGKmE+ex67zaWpYGFeW sDpw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1722842774; x=1723447574; h=subject:from:to:content-language:user-agent:mime-version:date :message-id:x-gm-message-state:from:to:cc:subject:date:message-id :reply-to; bh=jCEopVRYKVzMORBPanaGfI/WZxT4ttvPMHAn/Hlxp5E=; b=KbfZESkwFrsbgI3DyS8Zfo891m6zhPu/+fI5mej1shBIh0B2TBwwGBt2A13+l5hzs8 aPatjXsBnNgR96dD2Xs3xkUOZDd70dY9GIFQcsl8a8EVis4cdoX6jnCDnDqXF9rXIowU QqH0BC1xpuP2uNzL0CUTD3e8QcHBqxeRufOw72VGX1nyUH/8bSFHDh2ji6xbsmxT/bne Uy+QkA8XAZwXdWC6i/qOrbaMslo7VVRgcU0cvBPN+l5PJfKajkCXi5byFN6lh9g0NhF4 zSpC0/LT0ZaPpkPm1oijgTE64ZP3r5Zrv/ZAq7xd9bgNVXVyvczzjeaRQlwJ3y0BgwyA qNRw== X-Gm-Message-State: AOJu0YyozzGpGd0YwxKQeVPHnlS0/04Qr1mkTTQ7smrFiTJTzhZ+AwXS gM00ePt2/QWRq4owNH/jbhVfTai/aebgwJoe/RVILqjldhpfxllQMnckhISinM01nNmsrFUIcco D X-Google-Smtp-Source: AGHT+IE/6XoBQks/nmSRk2elpYFqxYk8N28zGm4v5QHFwEggRZ/spnqumf+eN8LSghJJhz5mQ4Jp+g== X-Received: by 2002:a05:6000:c0c:b0:368:420e:b7a4 with SMTP id ffacd0b85a97d-36bbc0a750bmr6969054f8f.4.1722842773783; Mon, 05 Aug 2024 00:26:13 -0700 (PDT) Received: from ?IPV6:2001:16b8:265b:ab00:e2c2:e453:ce9f:a55? (200116b8265bab00e2c2e453ce9f0a55.dip.versatel-1u1.de. [2001:16b8:265b:ab00:e2c2:e453:ce9f:a55]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-36bbcf0c348sm8879756f8f.24.2024.08.05.00.26.13 (version=TLS1_3 cipher=TLS_AES_128_GCM_SHA256 bits=128/128); Mon, 05 Aug 2024 00:26:13 -0700 (PDT) Message-ID: Date: Mon, 5 Aug 2024 09:26:12 +0200 MIME-Version: 1.0 User-Agent: Mozilla Thunderbird Content-Language: en-US To: gcc-patches From: Tobias Burnus Subject: [committed] libgomp.texi: Add OpenMP TR13 routines to @menu (commented out) X-Spam-Status: No, score=-11.9 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, GIT_PATCH_0, RCVD_IN_DNSWL_NONE, SPF_HELO_NONE, SPF_PASS, TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org X-BeenThere: gcc-patches@gcc.gnu.org X-Mailman-Version: 2.1.30 Precedence: list List-Id: Gcc-patches mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: gcc-patches-bounces~incoming=patchwork.ozlabs.org@gcc.gnu.org Not user visible but I use this to keep track of both implemented OpenMP runtime routines that still have to be documented and of still to be implemented (and then documented) routines. This commit (r15-2713-g1a5734135d265a) adds those routines added in OpenMP's third 6.0 preview (Technical Report 13). Tobias PS: The routines are again reordered in OpenMP; the question is whether we want to follow suit or keep the current ordering. I only reordered the undocumented ones inside @menu and only those @menu that I modified. commit 1a5734135d265a7b363ead9f821676a2a358969b Author: Tobias Burnus Date: Mon Aug 5 09:18:29 2024 +0200 libgomp.texi: Add OpenMP TR13 routines to @menu (commented out) To keep track of missing routine documentation (both implemented and not), the libgomp.texi file contains all non-OMPT routines as commented items in @menu. This commit adds the routines added in TR13 as commented fixme items. libgomp/ChangeLog: * libgomp.texi (OpenMP Runtime Library Routines): Add TR13 routines to @menu (commented out). --- libgomp/libgomp.texi | 27 +++++++++++++++++++++++++-- 1 file changed, 25 insertions(+), 2 deletions(-) diff --git a/libgomp/libgomp.texi b/libgomp/libgomp.texi index 07cd75124b0..c6759dd03bc 100644 --- a/libgomp/libgomp.texi +++ b/libgomp/libgomp.texi @@ -1591,12 +1591,18 @@ They have C linkage and do not throw exceptions. @menu * omp_get_num_procs:: Number of processors online @c * omp_get_max_progress_width:: /TR11 +@c * omp_get_device_from_uid:: /TR13 +@c * omp_get_uid_from_device:: /TR13 * omp_set_default_device:: Set the default device for target regions * omp_get_default_device:: Get the default device for target regions * omp_get_num_devices:: Number of target devices * omp_get_device_num:: Get device that current thread is running on * omp_is_initial_device:: Whether executing on the host device * omp_get_initial_device:: Device number of host device +@c * omp_get_device_num_teams:: /TR13 +@c * omp_set_device_num_teams:: /TR13 +@c * omp_get_device_teams_thread_limit:: /TR13 +@c * omp_set_device_teams_thread_limit:: /TR13 @end menu @@ -2813,8 +2819,27 @@ Routines to manage and allocate memory on the current device. They have C linkage and do not throw exceptions. @menu +@c * omp_get_devices_memspace:: /TR13 +@c * omp_get_device_memspace:: /TR13 +@c * omp_get_devices_and_host_memspace:: /TR13 +@c * omp_get_device_and_host_memspace:: /TR13 +@c * omp_get_devices_all_memspace:: /TR13 +@c * omp_get_memspace_num_resources:: /TR11 +@c * omp_get_memspace_pagesize:: /TR13 +@c * omp_get_submemspace:: /TR11 +@c * omp_init_mempartitioner:: /TR13 +@c * omp_destroy_mempartitioner:: /TR13 +@c * omp_init_mempartition:: /TR13 +@c * omp_destroy_mempartition:: /TR13 +@c * omp_mempartition_set_part:: /TR13 +@c * omp_mempartition_get_user_data:: /TR13 * omp_init_allocator:: Create an allocator * omp_destroy_allocator:: Destroy an allocator +@c * omp_get_devices_allocator:: /TR13 +@c * omp_get_device_allocator:: /TR13 +@c * omp_get_devices_and_host_allocator:: /TR13 +@c * omp_get_device_and_host_allocator:: /TR13 +@c * omp_get_devices_all_allocator:: /TR13 * omp_set_default_allocator:: Set the default allocator * omp_get_default_allocator:: Get the default allocator * omp_alloc:: Memory allocation with an allocator @@ -2823,8 +2848,6 @@ They have C linkage and do not throw exceptions. * omp_calloc:: Allocate nullified memory with an allocator * omp_aligned_calloc:: Allocate nullified aligned memory with an allocator * omp_realloc:: Reallocate memory allocated with OpenMP routines -@c * omp_get_memspace_num_resources:: /TR11 -@c * omp_get_submemspace:: /TR11 @end menu