Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/139869/?format=api
{ "id": 139869, "url": "http://patches.dpdk.org/api/patches/139869/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/patch/20240505083737.118649-4-mattias.ronnblom@ericsson.com/", "project": { "id": 1, "url": "http://patches.dpdk.org/api/projects/1/?format=api", "name": "DPDK", "link_name": "dpdk", "list_id": "dev.dpdk.org", "list_email": "dev@dpdk.org", "web_url": "http://core.dpdk.org", "scm_url": "git://dpdk.org/dpdk", "webscm_url": "http://git.dpdk.org/dpdk", "list_archive_url": "https://inbox.dpdk.org/dev", "list_archive_url_format": "https://inbox.dpdk.org/dev/{}", "commit_url_format": "" }, "msgid": "<20240505083737.118649-4-mattias.ronnblom@ericsson.com>", "list_archive_url": "https://inbox.dpdk.org/dev/20240505083737.118649-4-mattias.ronnblom@ericsson.com", "date": "2024-05-05T08:37:34", "name": "[RFC,v7,3/6] eal: add exactly-once bit access functions", "commit_ref": null, "pull_url": null, "state": "new", "archived": false, "hash": "f76dc732f20b692acbcdf42c4d4a42d551e471dd", "submitter": { "id": 1077, "url": "http://patches.dpdk.org/api/people/1077/?format=api", "name": "Mattias Rönnblom", "email": "mattias.ronnblom@ericsson.com" }, "delegate": { "id": 1, "url": "http://patches.dpdk.org/api/users/1/?format=api", "username": "tmonjalo", "first_name": "Thomas", "last_name": "Monjalon", "email": "thomas@monjalon.net" }, "mbox": "http://patches.dpdk.org/project/dpdk/patch/20240505083737.118649-4-mattias.ronnblom@ericsson.com/mbox/", "series": [ { "id": 31882, "url": "http://patches.dpdk.org/api/series/31882/?format=api", "web_url": "http://patches.dpdk.org/project/dpdk/list/?series=31882", "date": "2024-05-05T08:37:31", "name": "Improve EAL bit operations API", "version": 7, "mbox": "http://patches.dpdk.org/series/31882/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/139869/comments/", "check": "warning", "checks": "http://patches.dpdk.org/api/patches/139869/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dev-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from mails.dpdk.org (mails.dpdk.org [217.70.189.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 30DB343FAE;\n\tSun, 5 May 2024 10:48:22 +0200 (CEST)", "from mails.dpdk.org (localhost [127.0.0.1])\n\tby mails.dpdk.org (Postfix) with ESMTP id 1EDD4402E7;\n\tSun, 5 May 2024 10:48:05 +0200 (CEST)", "from EUR05-DB8-obe.outbound.protection.outlook.com\n (mail-db8eur05on2047.outbound.protection.outlook.com [40.107.20.47])\n by mails.dpdk.org (Postfix) with ESMTP id AFE064028C\n for <dev@dpdk.org>; Sun, 5 May 2024 10:47:59 +0200 (CEST)", "from DB7PR05CA0042.eurprd05.prod.outlook.com (2603:10a6:10:2e::19)\n by PAXPR07MB8793.eurprd07.prod.outlook.com (2603:10a6:102:244::8) with\n Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7544.40; Sun, 5 May\n 2024 08:47:58 +0000", "from DU2PEPF0001E9C1.eurprd03.prod.outlook.com\n (2603:10a6:10:2e:cafe::42) by DB7PR05CA0042.outlook.office365.com\n (2603:10a6:10:2e::19) with Microsoft SMTP Server (version=TLS1_2,\n cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.7544.39 via Frontend\n Transport; Sun, 5 May 2024 08:47:58 +0000", "from oa.msg.ericsson.com (192.176.1.74) by\n DU2PEPF0001E9C1.mail.protection.outlook.com (10.167.8.70) with Microsoft SMTP\n Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id\n 15.20.7519.19 via Frontend Transport; Sun, 5 May 2024 08:47:58 +0000", "from seliicinfr00049.seli.gic.ericsson.se (153.88.142.248) by\n smtp-central.internal.ericsson.com (100.87.178.64) with Microsoft SMTP Server\n id 15.2.1544.9; Sun, 5 May 2024 10:47:57 +0200", "from breslau.. (seliicwb00002.seli.gic.ericsson.se [10.156.25.100])\n by seliicinfr00049.seli.gic.ericsson.se (Postfix) with ESMTP id\n 7E85038007A; Sun, 5 May 2024 10:47:57 +0200 (CEST)" ], "ARC-Seal": "i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;\n b=JxY07GRHYrtMsU+kENXt/L6b5oVqff8jnexTIL7aceb/HDjMsyollIPLFoh8h7GV52d9hcMY4RVQww6hHB6ZXss14p0oBN4cBLttiLETJnqEHVmVQc3q5glRW3eeJzhNNPvkqA9CY0Ib7ePE5c2CuD3ybkqejsceajs/oH/6dwLGcSiHQ9Bs/6WsMdJvl8dHce4ZCuGxui6C/hKt8wKWoTqf+Y/EnFritOTtfznhOqhpfrBnDnq+T+RK18MspFvngl1W9ePLuobxdx+3+frgxShE7M9+3zjGsHDcFOykz8gUHE/4VXQquPsf3un8CtE7aEi6b3z+8YWTF+xU6O83RQ==", "ARC-Message-Signature": "i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com;\n s=arcselector9901;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-AntiSpam-MessageData-ChunkCount:X-MS-Exchange-AntiSpam-MessageData-0:X-MS-Exchange-AntiSpam-MessageData-1;\n bh=2NtFc/85D5XqMWuHibOU2UGt9NdiuGqxaSS34YzRHUc=;\n b=cjvMoYsAvskAQyyrfCh/jHsWNQnUDrIth1xNXbdT06VKRkwQQ04WXfk+HoVrFI07FFbBnoDn37tlddkG6bcl17a+Dc9D7guw9UyW9fuJkblG8lx1CkSyFqWjgWL2IY3yIR6KXtj1IaRvd2SM29DsI//4TFkto4F+YMEFyT/l3gKi+HkzqF6xZZyR0ZTfE3UJu5Ukwr6jVT292u8pQQmOhvrr21klSzE2FDKbvphmbyoZJphhozFcblg/VAlWW8UiT7iXjRtoX4cnI6y46M6JhlQBjzlfq3gBOhHXttrvAZnmdEluQTGI8tp3JfVy68AkgVVt/iZ1ROtQ+zRRrsiC1Q==", "ARC-Authentication-Results": "i=1; mx.microsoft.com 1; spf=pass (sender ip is\n 192.176.1.74) smtp.rcpttodomain=dpdk.org smtp.mailfrom=ericsson.com;\n dmarc=pass (p=reject sp=reject pct=100) action=none header.from=ericsson.com;\n dkim=none (message not signed); arc=none (0)", "DKIM-Signature": "v=1; a=rsa-sha256; c=relaxed/relaxed; d=ericsson.com;\n s=selector1;\n h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck;\n bh=2NtFc/85D5XqMWuHibOU2UGt9NdiuGqxaSS34YzRHUc=;\n b=mTGL1TPLYV6/KV7F/Xm0/+QC1sdsSdcA0uGzGlHtvG894M6wbFRUdFCNDGNNSuSfIlfbXRTqskGu3izZ3OulTP4STBTApO4dZtxAaq+Lg8V49ckAoqRtStoJ0NX9XwqcH2WX62hvQxPhDSix/3BjZWsi+LhSc86X1RcCfXgBU6HbYTYKXUsbXe8fv8mpv3Vi7HSC/e0poH+U5X3mpVaojhF5lyTLiV9KTlx/fxDRKzePLpPTXi55nwOY7/DpwyKg7XMLeCf65POydy4sEMc6DFdHhYhiyegbIgqEg8GsqQN25LF0n9E7FZvw0FGd5exIPgJUKI+4Y/agq1Vf1x1lzw==", "X-MS-Exchange-Authentication-Results": "spf=pass (sender IP is 192.176.1.74)\n smtp.mailfrom=ericsson.com; dkim=none (message not signed)\n header.d=none;dmarc=pass action=none header.from=ericsson.com;", "Received-SPF": "Pass (protection.outlook.com: domain of ericsson.com designates\n 192.176.1.74 as permitted sender)\n receiver=protection.outlook.com;\n client-ip=192.176.1.74; helo=oa.msg.ericsson.com; pr=C", "From": "=?utf-8?q?Mattias_R=C3=B6nnblom?= <mattias.ronnblom@ericsson.com>", "To": "<dev@dpdk.org>", "CC": "<hofors@lysator.liu.se>, Heng Wang <heng.wang@ericsson.com>,\n \"Stephen Hemminger\" <stephen@networkplumber.org>,\n Tyler Retzlaff <roretzla@linux.microsoft.com>,\n =?utf-8?q?Morten_Br=C3=B8rup?= <mb@smartsharesystems.com>, =?utf-8?q?Mattia?=\n\t=?utf-8?q?s_R=C3=B6nnblom?= <mattias.ronnblom@ericsson.com>", "Subject": "[RFC v7 3/6] eal: add exactly-once bit access functions", "Date": "Sun, 5 May 2024 10:37:34 +0200", "Message-ID": "<20240505083737.118649-4-mattias.ronnblom@ericsson.com>", "X-Mailer": "git-send-email 2.34.1", "In-Reply-To": "<20240505083737.118649-1-mattias.ronnblom@ericsson.com>", "References": "<20240502055706.112443-2-mattias.ronnblom@ericsson.com>\n <20240505083737.118649-1-mattias.ronnblom@ericsson.com>", "MIME-Version": "1.0", "Content-Type": "text/plain; charset=\"UTF-8\"", "Content-Transfer-Encoding": "8bit", "X-EOPAttributedMessage": "0", "X-MS-PublicTrafficType": "Email", "X-MS-TrafficTypeDiagnostic": "DU2PEPF0001E9C1:EE_|PAXPR07MB8793:EE_", "X-MS-Office365-Filtering-Correlation-Id": "cf9d5499-03d0-42a5-bc26-08dc6ce0104f", "X-MS-Exchange-SenderADCheck": "1", "X-MS-Exchange-AntiSpam-Relay": "0", "X-Microsoft-Antispam": "BCL:0;\n ARA:13230031|376005|36860700004|82310400017|1800799015;", "X-Microsoft-Antispam-Message-Info": "=?utf-8?q?BiBF+zXfZaCAZV3hSUNijRZyEHNvsUO?=\n\t=?utf-8?q?Eo7UVXWyL1JGUmTWix1YRvbLM7GcoAVBEB2YuT4bnu/wZS04qQIT2KGbW/Omm1nK5?=\n\t=?utf-8?q?QXslJYWuiY2B8yi5jyTlmuhClr0a3UyI00F00XNN65bTxTeJtr/esSgspznwX4lM9?=\n\t=?utf-8?q?S6rcZgzrMXfokGLMZffrys+ZGzrdeNhPR/WJZUQzt1cJU+xBoySShp76jrVh7TUGd?=\n\t=?utf-8?q?wi/qHzJZq6CZGnuBENTKxrDd3ABE1JSKGTvDmsybBymNK8l5DZSmA6o2ghQhDoHDc?=\n\t=?utf-8?q?bd/8w6pIXU8q0JiQ5Hexx9rpS6611QnTF6koFkQbJHlRR3CY3tcVMGqH2cLQTVQTW?=\n\t=?utf-8?q?ReUifPQmg1aVo52QJ+GRmEfvlw9L6DPnEJKUtp+CLb0I9DmaAGTx7zgi9C5HvoNla?=\n\t=?utf-8?q?JrXTu2AYXS7LUgXr/petkeLYQoIyueMh1joBLOmVhjIQGKnAHm2aTIi5gyWFyz9LZ?=\n\t=?utf-8?q?c+JUmvd7rDCnbYUfMGiEhrJXENDPEYnFm2a/uqWAO1RI9vvtx8UcGHsxdNvq9aDkH?=\n\t=?utf-8?q?CONy8P/MSOK76bKdrYYPh5ArEjp69VAYAhSLp2XV4/9SAtByV8eH1NlFu3FgxoqZr?=\n\t=?utf-8?q?ndU3XG2Ab1xWzDeYVsOTVduXe0OT2UKij5/jWneTTjyikPxBmHIIqOCnRxKm2Lrj1?=\n\t=?utf-8?q?FfqTSIYcoPefTz7apumBx3dFEt2axpeVUdXlk1a6CpryT3P667D4J6E5ZdkJXh9Ut?=\n\t=?utf-8?q?6pREdbEmU5SS+zwZAJoY6dDDMLn/7H8IRaiXhj//duwkAx5D/mbxdGhhiD12qr7Oc?=\n\t=?utf-8?q?x6tUampJM+DYAMxSRGOX21UEZ5dVeIDcu6EJlTKwE7xIAusQHmp7U1NEyDIonIWbi?=\n\t=?utf-8?q?rhpsBxj0a2Ql/umzEXfzAK0NE4n8myJ3XzSQ7S9qIQljZAzNkk4JqFdqeZYd2+6uT?=\n\t=?utf-8?q?5BmBkx8QT5m0Mt8brvWVSGFQ92JJI22YwMAqzog33+A2CpULEbMEVunW+/a3ORTKy?=\n\t=?utf-8?q?NPBpCIS7EQ0uf/5gLo0yYv30hID92ExzRVau292nUbBX0wSfCYZA16JaNHZV+JqjK?=\n\t=?utf-8?q?bgWIEFg02QjHJ9WfhC8JioObpmCSm96usCGUOy2M3oDQRdsxv1nt01i2Qgq/9gfZI?=\n\t=?utf-8?q?hFLLKrPwggXew0Bb7SOnWlFQr5m0EVwbqayp3yB8adNEUUqyjx4iWck+fatzrjPoB?=\n\t=?utf-8?q?+BLFUTO3lrpnawpkly3/CuLxyCFtM+mAg/cG0Y7GlcDPU9Hcytn57STGE7FqxF60b?=\n\t=?utf-8?q?CpVSiPYSlvPMBbxkBXZU4lXxKNRBk/rXPQpkq+eWCnE0/kaXDfZLVKd2ydM3cZdvn?=\n\t=?utf-8?q?exlo6AOuf0okjE4HIAdnz93aXhrBc5NF+t5r2T4k3YG82WfX1PY7ieWDl+U8WCNfv?=\n\t=?utf-8?q?dCbQXsLHAjQx?=", "X-Forefront-Antispam-Report": "CIP:192.176.1.74; CTRY:SE; LANG:en; SCL:1; SRV:;\n IPV:NLI; SFV:NSPM; H:oa.msg.ericsson.com; PTR:office365.se.ericsson.net;\n CAT:NONE; SFS:(13230031)(376005)(36860700004)(82310400017)(1800799015);\n DIR:OUT; SFP:1101;", "X-OriginatorOrg": "ericsson.com", "X-MS-Exchange-CrossTenant-OriginalArrivalTime": "05 May 2024 08:47:58.1121 (UTC)", "X-MS-Exchange-CrossTenant-Network-Message-Id": "\n cf9d5499-03d0-42a5-bc26-08dc6ce0104f", "X-MS-Exchange-CrossTenant-Id": "92e84ceb-fbfd-47ab-be52-080c6b87953f", "X-MS-Exchange-CrossTenant-OriginalAttributedTenantConnectingIp": "\n TenantId=92e84ceb-fbfd-47ab-be52-080c6b87953f; Ip=[192.176.1.74];\n Helo=[oa.msg.ericsson.com]", "X-MS-Exchange-CrossTenant-AuthSource": "\n DU2PEPF0001E9C1.eurprd03.prod.outlook.com", "X-MS-Exchange-CrossTenant-AuthAs": "Anonymous", "X-MS-Exchange-CrossTenant-FromEntityHeader": "HybridOnPrem", "X-MS-Exchange-Transport-CrossTenantHeadersStamped": "PAXPR07MB8793", "X-BeenThere": "dev@dpdk.org", "X-Mailman-Version": "2.1.29", "Precedence": "list", "List-Id": "DPDK patches and discussions <dev.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dev>,\n <mailto:dev-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dev/>", "List-Post": "<mailto:dev@dpdk.org>", "List-Help": "<mailto:dev-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dev>,\n <mailto:dev-request@dpdk.org?subject=subscribe>", "Errors-To": "dev-bounces@dpdk.org" }, "content": "Add test/set/clear/assign/flip functions which prevents certain\ncompiler optimizations and guarantees that program-level memory loads\nand/or stores will actually occur.\n\nThese functions are useful when interacting with memory-mapped\nhardware devices.\n\nThe \"once\" family of functions does not promise atomicity and provides\nno memory ordering guarantees beyond the C11 relaxed memory model.\n\nRFC v7:\n * Fix various minor issues in documentation.\n\nRFC v6:\n * Have rte_bit_once_test() accept const-marked bitsets.\n\nRFC v3:\n * Work around lack of C++ support for _Generic (Tyler Retzlaff).\n\nSigned-off-by: Mattias Rönnblom <mattias.ronnblom@ericsson.com>\nAcked-by: Morten Brørup <mb@smartsharesystems.com>\nAcked-by: Tyler Retzlaff <roretzla@linux.microsoft.com>\n---\n lib/eal/include/rte_bitops.h | 201 +++++++++++++++++++++++++++++++++++\n 1 file changed, 201 insertions(+)", "diff": "diff --git a/lib/eal/include/rte_bitops.h b/lib/eal/include/rte_bitops.h\nindex 3297133e22..3644aa115c 100644\n--- a/lib/eal/include/rte_bitops.h\n+++ b/lib/eal/include/rte_bitops.h\n@@ -226,6 +226,183 @@ extern \"C\" {\n \t\t uint32_t *: __rte_bit_flip32,\t\t\t\t\\\n \t\t uint64_t *: __rte_bit_flip64)(addr, nr)\n \n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Generic selection macro to test exactly once the value of a bit in\n+ * a 32-bit or 64-bit word. The type of operation depends on the type\n+ * of the @c addr parameter.\n+ *\n+ * rte_bit_once_test() is guaranteed to result in exactly one memory\n+ * load (e.g., it may not be eliminate or merged by the compiler).\n+ *\n+ * \\code{.c}\n+ * rte_bit_once_set(addr, 17);\n+ * if (rte_bit_once_test(addr, 17)) {\n+ * ...\n+ * }\n+ * \\endcode\n+ *\n+ * In the above example, rte_bit_once_set() may not be removed by\n+ * the compiler, which would be allowed in case rte_bit_set() and\n+ * rte_bit_test() was used.\n+ *\n+ * \\code{.c}\n+ * while (rte_bit_once_test(addr, 17);\n+ * ;\n+ * \\endcode\n+ *\n+ * In case rte_bit_test(addr, 17) was used instead, the resulting\n+ * object code could (and in many cases would be) replaced with\n+ * the equivalent to\n+ * \\code{.c}\n+ * if (rte_bit_test(addr, 17)) {\n+ * for (;;) // spin forever\n+ * ;\n+ * }\n+ * \\endcode\n+ *\n+ * rte_bit_once_test() does not give any guarantees in regards to\n+ * memory ordering or atomicity.\n+ *\n+ * The regular bit set operations (e.g., rte_bit_test()) should be\n+ * preferred over the \"once\" family of operations (e.g.,\n+ * rte_bit_once_test()) if possible, since the latter may prevent\n+ * optimizations crucial for run-time performance.\n+ *\n+ * @param addr\n+ * A pointer to the word to query.\n+ * @param nr\n+ * The index of the bit.\n+ * @return\n+ * Returns true if the bit is set, and false otherwise.\n+ */\n+\n+#define rte_bit_once_test(addr, nr)\t\t\t\t\t\\\n+\t_Generic((addr),\t\t\t\t\t\t\\\n+\t\tuint32_t *: __rte_bit_once_test32,\t\t\t\\\n+\t\tconst uint32_t *: __rte_bit_once_test32,\t\t\\\n+\t\tuint64_t *: __rte_bit_once_test64,\t\t\t\\\n+\t\tconst uint64_t *: __rte_bit_once_test64)(addr, nr)\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Set bit in word exactly once.\n+ *\n+ * Generic selection macro to set bit specified by @c nr in the word\n+ * pointed to by @c addr to '1' exactly once.\n+ *\n+ * rte_bit_once_set() is guaranteed to result in exactly one memory\n+ * load and exactly one memory store, *or* an atomic bit set\n+ * operation.\n+ *\n+ * See rte_bit_test_once32() for more information and uses cases for\n+ * the \"once\" class of functions.\n+ *\n+ * This macro does not give any guarantees in regards to memory\n+ * ordering or atomicity.\n+ *\n+ * @param addr\n+ * A pointer to the word to modify.\n+ * @param nr\n+ * The index of the bit.\n+ */\n+\n+#define rte_bit_once_set(addr, nr)\t\t\t\t\\\n+\t_Generic((addr),\t\t\t\t\t\\\n+\t\t uint32_t *: __rte_bit_once_set32,\t\t\\\n+\t\t uint64_t *: __rte_bit_once_set64)(addr, nr)\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Clear bit in word exactly once.\n+ *\n+ * Generic selection macro to set bit specified by @c nr in the word\n+ * pointed to by @c addr to '0' exactly once.\n+ *\n+ * rte_bit_once_clear() is guaranteed to result in exactly one memory load\n+ * and exactly one memory store, *or* an atomic bit clear operation.\n+ *\n+ * See rte_bit_test_once() for more information and uses cases for\n+ * the \"once\" class of functions.\n+ *\n+ * This macro does not give any guarantees in regards to memory\n+ * ordering or atomicity.\n+ *\n+ * @param addr\n+ * A pointer to the word to modify.\n+ * @param nr\n+ * The index of the bit.\n+ */\n+#define rte_bit_once_clear(addr, nr)\t\t\t\t\\\n+\t_Generic((addr),\t\t\t\t\t\\\n+\t\t uint32_t *: __rte_bit_once_clear32,\t\t\\\n+\t\t uint64_t *: __rte_bit_once_clear64)(addr, nr)\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Assign a value to bit in a word exactly once.\n+ *\n+ * Generic selection macro to set bit specified by @c nr in the word\n+ * pointed to by @c addr to the value indicated by @c value exactly\n+ * once.\n+ *\n+ * rte_bit_once_assign() is guaranteed to result in exactly one memory\n+ * load and exactly one memory store, *or* an atomic bit clear\n+ * operation.\n+ *\n+ * This macro does not give any guarantees in regards to memory\n+ * ordering or atomicity.\n+ *\n+ * @param addr\n+ * A pointer to the word to modify.\n+ * @param nr\n+ * The index of the bit.\n+ * @param value\n+ * The new value of the bit - true for '1', or false for '0'.\n+ */\n+#define rte_bit_once_assign(addr, nr, value)\t\t\t\t\\\n+\t_Generic((addr),\t\t\t\t\t\t\\\n+\t\t uint32_t *: __rte_bit_once_assign32,\t\t\t\\\n+\t\t uint64_t *: __rte_bit_once_assign64)(addr, nr, value)\n+\n+/**\n+ * @warning\n+ * @b EXPERIMENTAL: this API may change without prior notice.\n+ *\n+ * Flip bit in word, reading and writing exactly once.\n+ *\n+ * Generic selection macro to change the value of a bit to '0' if '1'\n+ * or '1' if '0' in a 32-bit or 64-bit word. The type of operation\n+ * depends on the type of the @c addr parameter.\n+ *\n+ * rte_bit_once_flip() is guaranteed to result in exactly one memory\n+ * load and exactly one memory store, *or* an atomic bit flip\n+ * operation.\n+ *\n+ * See rte_bit_test_once() for more information and uses cases for the\n+ * \"once\" class of functions.\n+ *\n+ * This macro does not give any guarantees in regards to memory\n+ * ordering or atomicity.\n+ *\n+ * @param addr\n+ * A pointer to the word to modify.\n+ * @param nr\n+ * The index of the bit.\n+ */\n+#define rte_bit_once_flip(addr, nr)\t\t\t\t\\\n+\t_Generic((addr),\t\t\t\t\t\\\n+\t\t uint32_t *: __rte_bit_once_flip32,\t\t\\\n+\t\t uint64_t *: __rte_bit_once_flip64)(addr, nr)\n+\n #define __RTE_GEN_BIT_TEST(family, fun, qualifier, size)\t\t\\\n \t__rte_experimental\t\t\t\t\t\t\\\n \tstatic inline bool\t\t\t\t\t\t\\\n@@ -298,6 +475,18 @@ __RTE_GEN_BIT_CLEAR(, clear,, 64)\n __RTE_GEN_BIT_ASSIGN(, assign,, 64)\n __RTE_GEN_BIT_FLIP(, flip,, 64)\n \n+__RTE_GEN_BIT_TEST(once_, test, volatile, 32)\n+__RTE_GEN_BIT_SET(once_, set, volatile, 32)\n+__RTE_GEN_BIT_CLEAR(once_, clear, volatile, 32)\n+__RTE_GEN_BIT_ASSIGN(once_, assign, volatile, 32)\n+__RTE_GEN_BIT_FLIP(once_, flip, volatile, 32)\n+\n+__RTE_GEN_BIT_TEST(once_, test, volatile, 64)\n+__RTE_GEN_BIT_SET(once_, set, volatile, 64)\n+__RTE_GEN_BIT_CLEAR(once_, clear, volatile, 64)\n+__RTE_GEN_BIT_ASSIGN(once_, assign, volatile, 64)\n+__RTE_GEN_BIT_FLIP(once_, flip, volatile, 64)\n+\n /*------------------------ 32-bit relaxed operations ------------------------*/\n \n /**\n@@ -993,6 +1182,12 @@ rte_log2_u64(uint64_t v)\n #undef rte_bit_assign\n #undef rte_bit_flip\n \n+#undef rte_bit_once_test\n+#undef rte_bit_once_set\n+#undef rte_bit_once_clear\n+#undef rte_bit_once_assign\n+#undef rte_bit_once_flip\n+\n #define __RTE_BIT_OVERLOAD_SZ_2(fun, qualifier, size, arg1_type, arg1_name) \\\n \tstatic inline void\t\t\t\t\t\t\\\n \trte_bit_ ## fun(qualifier uint ## size ## _t *addr,\t\t\\\n@@ -1042,6 +1237,12 @@ __RTE_BIT_OVERLOAD_2(clear,, unsigned int, nr)\n __RTE_BIT_OVERLOAD_3(assign,, unsigned int, nr, bool, value)\n __RTE_BIT_OVERLOAD_2(flip,, unsigned int, nr)\n \n+__RTE_BIT_OVERLOAD_2R(once_test, const volatile, bool, unsigned int, nr)\n+__RTE_BIT_OVERLOAD_2(once_set, volatile, unsigned int, nr)\n+__RTE_BIT_OVERLOAD_2(once_clear, volatile, unsigned int, nr)\n+__RTE_BIT_OVERLOAD_3(once_assign, volatile, unsigned int, nr, bool, value)\n+__RTE_BIT_OVERLOAD_2(once_flip, volatile, unsigned int, nr)\n+\n #endif\n \n #endif /* _RTE_BITOPS_H_ */\n", "prefixes": [ "RFC", "v7", "3/6" ] }