From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from esa3.mentor.iphmx.com (esa3.mentor.iphmx.com [68.232.137.180]) by sourceware.org (Postfix) with ESMTPS id E69E93858D38 for ; Wed, 14 Jun 2023 10:34:28 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.2 sourceware.org E69E93858D38 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com X-IronPort-AV: E=Sophos;i="6.00,242,1681200000"; d="diff'?scan'208";a="8749789" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa3.mentor.iphmx.com with ESMTP; 14 Jun 2023 02:34:25 -0800 IronPort-SDR: 6zSi70i9GusRpuYrpBoUchk3CZbBatz7Crb5DYvg/IzOPHPzdPq0zm+f316OKPNmDMDkaTqJBS U1uGmqYVOnM1lVbbsJzqKZg35kVlEcIUCbghKTa/3hlrSICVwV5y1fDRT9IsS77MjL8fLgJWuD zTBWNe3GYKEkFRm6g+DczBD7Qb4gi9cqUzxvWnMZ5tAS/qVAeNSUI/9aQZun1H0RXMAmpkexjS ffl2qco8nuxr0+gc/9irovcRRitO606JhS15CH6c76oI1U5XZNkhm5Cptmg8WaXVTn5IhjjqHC tdM= Content-Type: multipart/mixed; boundary="------------20dOX6bOldKnYgxdTraUa5Oy" Message-ID: <641f281f-4ba2-0ab2-f52b-9e30fd200a14@codesourcery.com> Date: Wed, 14 Jun 2023 12:34:20 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.12.0 Content-Language: en-US To: gcc-patches , Sandra Loosemore , Jakub Jelinek From: Tobias Burnus Subject: [Patch] libgomp.texi: Document allocator + affininity env vars X-Originating-IP: [137.202.0.90] X-ClientProxiedBy: svr-ies-mbx-12.mgc.mentorg.com (139.181.222.12) To svr-ies-mbx-12.mgc.mentorg.com (139.181.222.12) X-Spam-Status: No, score=-11.3 required=5.0 tests=BAYES_00,GIT_PATCH_0,HEADER_FROM_DIFFERENT_DOMAINS,KAM_DMARC_STATUS,SPF_HELO_PASS,SPF_PASS,TXREP,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: --------------20dOX6bOldKnYgxdTraUa5Oy Content-Type: text/plain; charset="UTF-8"; format=flowed Content-Transfer-Encoding: quoted-printable Comments on the wording and/or the content? I did notice that we missed to document three OMP_* environment variables, hence, I added them. (For OMP_ALLOCATOR, I expect an update once the 5.1 extensions have been implemented.) (Some cross references could be added if we had/once we have documented the respective omp_(get,set)_... I think we lack about half of the API functions.) Tobias ----------------- Siemens Electronic Design Automation GmbH; Anschrift: Arnulfstra=C3=9Fe 201= , 80634 M=C3=BCnchen; Gesellschaft mit beschr=C3=A4nkter Haftung; Gesch=C3= =A4ftsf=C3=BChrer: Thomas Heurung, Frank Th=C3=BCrauf; Sitz der Gesellschaf= t: M=C3=BCnchen; Registergericht M=C3=BCnchen, HRB 106955 --------------20dOX6bOldKnYgxdTraUa5Oy Content-Type: text/x-patch; charset="UTF-8"; name="texi-envvars.diff" Content-Disposition: attachment; filename="texi-envvars.diff" Content-Transfer-Encoding: base64 bGliZ29tcC50ZXhpOiBEb2N1bWVudCBhbGxvY2F0b3IgKyBhZmZpbmluaXR5IGVudiB2YXJz CgpsaWJnb21wL0NoYW5nZUxvZzoKCgkqIGxpYmdvbXAudGV4aSAoT01QX0FMTE9DQVRPUiwg T01QX0FGRklOSVRZX0ZPUk1BVCwKCU9NUF9ESVNQTEFZX0FGRklOSVRZKTogTmV3LgoKZGlm ZiAtLWdpdCBhL2xpYmdvbXAvbGliZ29tcC50ZXhpIGIvbGliZ29tcC9saWJnb21wLnRleGkK aW5kZXggMjFkMzU4MmE2NjUuLjcwYjA5MDgyNGJiIDEwMDY0NAotLS0gYS9saWJnb21wL2xp YmdvbXAudGV4aQorKysgYi9saWJnb21wL2xpYmdvbXAudGV4aQpAQCAtMTkzNyw3ICsxOTM3 LDEwIEBAIHNlY3Rpb24gNCBvZiB0aGUgT3Blbk1QIHNwZWNpZmljYXRpb24gaW4gdmVyc2lv biA0LjUsIHdoaWxlIHRob3NlCiBiZWdpbm5pbmcgd2l0aCBAZW52e0dPTVBffSBhcmUgR05V IGV4dGVuc2lvbnMuCiAKIEBtZW51CisqIE9NUF9BTExPQ0FUT1I6OiAgICAgICAgICAgU2V0 IHRoZSBkZWZhdWx0IGFsbG9jYXRvcgorKiBPTVBfQUZGSU5JVFlfRk9STUFUOjogICAgIFNl dCB0aGUgZm9ybWF0IHN0cmluZyB1c2VkIGZvciBhZmZpbml0eSBkaXNwbGF5CiAqIE9NUF9D QU5DRUxMQVRJT046OiAgICAgICAgU2V0IHdoZXRoZXIgY2FuY2VsbGF0aW9uIGlzIGFjdGl2 YXRlZAorKiBPTVBfRElTUExBWV9BRkZJTklUWTo6ICAgIERpc3BsYXkgdGhyZWFkIGFmZmlu aXR5IGluZm9ybWF0aW9uCiAqIE9NUF9ESVNQTEFZX0VOVjo6ICAgICAgICAgU2hvdyBPcGVu TVAgdmVyc2lvbiBhbmQgZW52aXJvbm1lbnQgdmFyaWFibGVzCiAqIE9NUF9ERUZBVUxUX0RF VklDRTo6ICAgICAgU2V0IHRoZSBkZXZpY2UgdXNlZCBpbiB0YXJnZXQgcmVnaW9ucwogKiBP TVBfRFlOQU1JQzo6ICAgICAgICAgICAgIER5bmFtaWMgYWRqdXN0bWVudCBvZiB0aHJlYWRz CkBAIC0xOTYyLDYgKzE5NjUsODcgQEAgYmVnaW5uaW5nIHdpdGggQGVudntHT01QX30gYXJl IEdOVSBleHRlbnNpb25zLgogQGVuZCBtZW51CiAKIAorQG5vZGUgT01QX0FMTE9DQVRPUgor QHNlY3Rpb24gQGVudntPTVBfQUxMT0NBVE9SfSAtLSBTZXQgdGhlIGRlZmF1bHQgYWxsb2Nh dG9yCitAY2luZGV4IEVudmlyb25tZW50IFZhcmlhYmxlCitAdGFibGUgQGFzaXMKK0BpdGVt IEBlbXBoe0Rlc2NyaXB0aW9ufToKK1NldHMgdGhlIGRlZmF1bHQgYWxsb2NhdG9yIHRoYXQg aXMgdXNlZCB3aGVuIG5vIGFsbG9jYXRvciBoYXMgYmVlbiBzcGVjaWZpZWQKK2luIHRoZSBA Y29kZXthbGxvY2F0ZX0gb3IgQGNvZGV7YWxsb2NhdG9yfSBjbGF1c2Ugb3Igd2hlbgorQGNv ZGV7b21wX251bGxfYWxsb2NhdG9yfSBpcyB1c2VkIGFzIGFsbG9jYXRvciB3aGVuIGludm9r aW5nIGFuIE9wZW5NUCBtZW1vcnkKK3JvdXRpbmUuIFRoZSB2YWx1ZSBzaG91bGQgYmUgb25l IG9mIHRoZSBwcmVkZWZpbmVkIGFsbG9jYXRvcnMuCitJZiB1bnNldCwgQGNvZGV7b21wX2Rl ZmF1bHRfbWVtX2FsbG9jfSBpcyB1c2VkLgorCitAYyBAaXRlbSBAZW1waHtTZWUgYWxzb306 CisKK0BpdGVtIEBlbXBoe1JlZmVyZW5jZX06CitAdXJlZntodHRwczovL3d3dy5vcGVubXAu b3JnLCBPcGVuTVAgc3BlY2lmaWNhdGlvbiB2NS4wfSwgU2VjdGlvbiA2LjIxCitAZW5kIHRh YmxlCisKKworCitAbm9kZSBPTVBfQUZGSU5JVFlfRk9STUFUCitAc2VjdGlvbiBAZW52e09N UF9BRkZJTklUWV9GT1JNQVR9IC0tIFNldCB0aGUgZm9ybWF0IHN0cmluZyB1c2VkIGZvciBh ZmZpbml0eSBkaXNwbGF5CitAY2luZGV4IEVudmlyb25tZW50IFZhcmlhYmxlCitAdGFibGUg QGFzaXMKK0BpdGVtIEBlbXBoe0Rlc2NyaXB0aW9ufToKK1NldHMgdGhlIGZvcm1hdCBzdHJp bmcgdXNlZCB3aGVuIGRpc3BsYXlpbmcgT3Blbk1QIHRocmVhZCBhZmZpbml0eSBpbmZvcm1h dGlvbi4KK1NwZWNpYWwgdmFsdWVzIGFyZSBvdXRwdXQgdXNpbmcgQGNvZGV7JX0gZm9sbG93 ZWQgYnkgYW4gb3B0aW9uYWwgc2l6ZQorc3BlY2lmaWNhdGlvbiBhbmQgdGhlbiBlaXRoZXIg dGhlIHNpbmdsZS1jaGFyYWN0ZXIgZmllbGQgdHlwZSBvciBpdHMgbG9uZworbmFtZSBlbmNs b3NlZCBpbiBjdXJseSBicmFjZXM7IHVzaW5nIEBjb2RleyUlfSB3aWxsIGRpc3BsYXkgYSBs aXRlcmFsIHBlcmNlbnQuCitUaGUgc2l6ZSBzcGVjaWZpY2F0aW9uIGNvbnNpc3RzIG9mIGFu IG9wdGlvbmFsIEBjb2RlezAufSBvciBAY29kZXsufSBmb2xsb3dlZAorYnkgYSBwb3NpdGl2 ZSBpbnRlZ2VyLCBzcGVjaWZpbmcgdGhlIG1pbmltYWwgd2lkdGggb2YgdGhlIG91dHB1dC4g IFdpdGgKK0Bjb2RlezAufSBhbmQgbnVtZXJpY2FsIHZhbHVlcywgdGhlIG91dHB1dCBpcyBw YWRkZWQgd2l0aCB6ZXJvcyBvbiB0aGUgbGVmdDsKK3dpdGggQGNvZGV7Ln0sIHRoZSBvdXRw dXQgaXMgcGFkZGVkIGJ5IHNwYWNlcyBvbiB0aGUgbGVmdDsgb3RoZXJ3aXNlLCB0aGUKK291 dHB1dCBpcyBwYWRkZWQgYnkgc3BhY2VzIG9uIHRoZSByaWdodC4gIElmIHVuc2V0LCB0aGUg dmFsdWUgaXMKK2BgQGNvZGV7bGV2ZWwgJUwgdGhyZWFkICVpIGFmZmluaXR5ICVBfScnLgor CitTdXBwb3J0ZWQgZmllbGQgdHlwZXMgYXJlOgorCitAbXVsdGl0YWJsZSBAY29sdW1uZnJh Y3Rpb25zIC4xMCAuMjUgLjYwCitAaXRlbSB0IEB0YWIgdGVhbV9udW0gQHRhYiB2YWx1ZSBy ZXR1cm5lZCBieSBAY29kZXtvbXBfZ2V0X3RlYW1fbnVtfQorQGl0ZW0gVCBAdGFiIG51bV90 ZWFtcyBAdGFiIHZhbHVlIHJldHVybmVkIGJ5IEBjb2Rle29tcF9nZXRfbnVtX3RlYW1zfQor QGl0ZW0gTCBAdGFiIG5lc3RpbmdfbGV2ZWwgQHRhYiB2YWx1ZSByZXR1cm5lZCBieSBAY29k ZXtvbXBfZ2V0X2xldmVsfQorQGl0ZW0gbiBAdGFiIHRocmVhZF9udW0gQHRhYiB2YWx1ZSBy ZXR1cm5lZCBieSBAY29kZXtvbXBfZ2V0X3RocmVhZF9udW19CitAaXRlbSBOIEB0YWIgbnVt X3RocmVhZHMgQHRhYiB2YWx1ZSByZXR1cm5lZCBieSBAY29kZXtvbXBfZ2V0X251bV90aHJl YWRzfQorQGl0ZW0gYSBAdGFiIGFuY2VzdG9yX3RudW0KKyAgICAgIEB0YWIgdmFsdWUgcmV0 dXJuZWQgYnkKKyAgICAgICAgICAgQGNvZGV7b21wX2dldF9hbmNlc3Rvcl90aHJlYWRfbnVt KG9tcF9nZXRfbGV2ZWwoKS0xKX0KK0BpdGVtIEggQHRhYiBob3N0IEB0YWIgbmFtZSBvZiB0 aGUgaG9zdCB0aGF0IGV4ZWN1dGVzIHRoZSB0aHJlYWQKK0BpdGVtIFAgQHRhYiBwcm9jZXNz X2lkIEB0YWIgcHJvY2VzcyBpZGVudGnvrIFlcgorQGl0ZW0gaSBAdGFiIG5hdGl2ZV90aHJl YWRfaWQgQHRhYiBuYXRpdmUgdGhyZWFkIGlkZW50ae+sgWVyCitAaXRlbSBBIEB0YWIgdGhy ZWFkX2FmZmluaXR5CisgICAgICBAdGFiIGNvbW1hIHNlcGFyYXRlZCBsaXN0IG9mIGludGVn ZXIgdmFsdWVzIG9yIHJhbmdlcywgcmVwcmVzZW50aW5nIHRoZQorICAgICAgICAgICBwcm9j ZXNzb3JzIG9uIHdoaWNoIGEgcHJvY2VzcyBtaWdodCBleGVjdXRlLCBzdWJqZWN0IHRvIGFm ZmluaXR5CisgICAgICAgICAgIG1lY2hhbmlzbXMKK0BlbmQgbXVsdGl0YWJsZQorCitGb3Ig aW5zdGFuY2UsIGFmdGVyIHNldHRpbmcKKworQHNtYWxsZXhhbXBsZQorT01QX0FGRklOSVRZ X0ZPUk1BVD0iJTAuMmEhJW4hJS40TCElTjslLjJ0OyUwLjJUOyVAe3RlYW1fbnVtQH07JUB7 bnVtX3RlYW1zQH07JUEiCitAZW5kIHNtYWxsZXhhbXBsZQorCit3aXRoIGVpdGhlciBAY29k ZXtPTVBfRElTUExBWV9BRkZJTklUWX0gYmVpbmcgc2V0IG9yIHdoZW4gY2FsbGluZworQGNv ZGV7b21wX2Rpc3BsYXlfYWZmaW5pdHl9IHdpdGggQGNvZGV7TlVMTH0gb3IgYW4gZW1wdHkg c3RyaW5nLCB0aGUgcHJvZ3JhbQorbWlnaHQgZGlzcGxheSB0aGUgZm9sbG93aW5nOgorCitA c21hbGxleGFtcGxlCiswMCEwISAgIDEhNDsgMDswMTswOzE7MC0xMQorMDAhMyEgICAxITQ7 IDA7MDE7MDsxOzAtMTEKKzAwITIhICAgMSE0OyAwOzAxOzA7MTswLTExCiswMCExISAgIDEh NDsgMDswMTswOzE7MC0xMQorQGVuZCBzbWFsbGV4YW1wbGUKKworQGl0ZW0gQGVtcGh7U2Vl IGFsc299OgorQHJlZntPTVBfRElTUExBWV9BRkZJTklUWX0KKworQGl0ZW0gQGVtcGh7UmVm ZXJlbmNlfToKK0B1cmVme2h0dHBzOi8vd3d3Lm9wZW5tcC5vcmcsIE9wZW5NUCBzcGVjaWZp Y2F0aW9uIHY1LjB9LCBTZWN0aW9uIDYuMTQKK0BlbmQgdGFibGUKKworCisKIEBub2RlIE9N UF9DQU5DRUxMQVRJT04KIEBzZWN0aW9uIEBlbnZ7T01QX0NBTkNFTExBVElPTn0gLS0gU2V0 IHdoZXRoZXIgY2FuY2VsbGF0aW9uIGlzIGFjdGl2YXRlZAogQGNpbmRleCBFbnZpcm9ubWVu dCBWYXJpYWJsZQpAQCAtMTk3OSw2ICsyMDYzLDI2IEBAIGlmIHVuc2V0LCBjYW5jZWxsYXRp b24gaXMgZGlzYWJsZWQgYW5kIHRoZSBAY29kZXtjYW5jZWx9IGNvbnN0cnVjdCBpcyBpZ25v cmVkLgogCiAKIAorQG5vZGUgT01QX0RJU1BMQVlfQUZGSU5JVFkKK0BzZWN0aW9uIEBlbnZ7 T01QX0RJU1BMQVlfQUZGSU5JVFl9IC0tIERpc3BsYXkgdGhyZWFkIGFmZmluaXR5IGluZm9y bWF0aW9uCitAY2luZGV4IEVudmlyb25tZW50IFZhcmlhYmxlCitAdGFibGUgQGFzaXMKK0Bp dGVtIEBlbXBoe0Rlc2NyaXB0aW9ufToKK0lmIHNldCB0byBAY29kZXtGQUxTRX0gb3IgaWYg dW5zZXQsIGFmZmluaXR5IGRpc3BsYXlpbmcgaXMgZGlzYWJsZWQuCitJZiBzZXQgdG8gQGNv ZGV7VFJVRX0sIHRoZSBydW50aW1lIHdpbGwgZGlzcGxheSBhZmZpbml0eSBpbmZvcm1hdGlv biBhYm91dAorT3Blbk1QIHRocmVhZHMgaW4gYSBwYXJhbGxlbCByZWdpb24gdXBvbiBlbnRl cmluZyB0aGUgcmVnaW9uIGFuZCBldmVyeSB0aW1lCithbnkgY2hhbmdlIG9jY3Vycy4KKwor QGl0ZW0gQGVtcGh7U2VlIGFsc299OgorQHJlZntPTVBfQUZGSU5JVFlfRk9STUFUfQorCitA aXRlbSBAZW1waHtSZWZlcmVuY2V9OgorQHVyZWZ7aHR0cHM6Ly93d3cub3Blbm1wLm9yZywg T3Blbk1QIHNwZWNpZmljYXRpb24gdjUuMH0sIFNlY3Rpb24gNi4xMworQGVuZCB0YWJsZQor CisKKworCiBAbm9kZSBPTVBfRElTUExBWV9FTlYKIEBzZWN0aW9uIEBlbnZ7T01QX0RJU1BM QVlfRU5WfSAtLSBTaG93IE9wZW5NUCB2ZXJzaW9uIGFuZCBlbnZpcm9ubWVudCB2YXJpYWJs ZXMKIEBjaW5kZXggRW52aXJvbm1lbnQgVmFyaWFibGUK --------------20dOX6bOldKnYgxdTraUa5Oy--