From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id D9C6A43010; Tue, 8 Aug 2023 23:42:38 +0200 (CEST) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B15B942B71; Tue, 8 Aug 2023 23:42:38 +0200 (CEST) Received: from EUR04-HE1-obe.outbound.protection.outlook.com (mail-he1eur04on2054.outbound.protection.outlook.com [40.107.7.54]) by mails.dpdk.org (Postfix) with ESMTP id 4FA1441148 for ; Tue, 8 Aug 2023 23:42:37 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=AgLnRN9DkqErOfiljg8coMM7TiCM/vbKDNMJnAdIuH/r3FpCzfpZcJ2pg3ajcUwu1o4u5LeOyFhPvXwRppAm49/KaN2s2YA9Onrph+azzxHBZX/Zfg3Rh9eee1W0K9x1yXE3c1V9P3yKw4G9wET05i1lkUvPtPwGv1GXXcGestP+KT8y1zGFGf+W3UqDWfggdVy2/AmX0zyV0xssjPdu/PpcY8tdAYdviMdRcWVhXFk6RS4FEBpyZfXPWy7+d3uyAgFmImsFoU+QJsQzvZkkCF7TZ11LWyOA3micITTMQB48AYgXUuKXqtSO0Z5Xge4KZlTOBP+pvBbNFQ8yZV3E9A== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=microsoft.com; s=arcselector9901; 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; bh=W6+1Ma6GdRGgQB1la1DiF0d82Xp8hsTdia6uuAZ0UtI=; b=ZrCWK4tvpPUQG3cIMWKm69Hpj1yb0d9aljP/QfUIm0ZaPWfNrWhE+AAlXrDEI3/7Mmf6WA7mOpBSEp6gcQj2ANKxu9XluhCzW4BKa/VLNy/eQUmMtz+7EMbA5pYU4GoMi2qMu/neG5D5ZC6+sqv+jtZL214ARUwvsOelWVUNJw/mexnhEq+t3Prvww5vvI3tRkHivfmKJiOcwTlcX30kLHe7anMrllj1gdpq2xuoGIzg1pE04UoUUyS7Lsg7SxNuV/YQIxgqZaDppwscFTmRyM1+j76UF3EnGMcp6ezxuJP4YQuuNkNnDbmgF+5XUBq9Ver7fs3x0hoInc1fvkglVA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=arm.com; dmarc=pass action=none header.from=arm.com; dkim=pass header.d=arm.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=armh.onmicrosoft.com; s=selector2-armh-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=W6+1Ma6GdRGgQB1la1DiF0d82Xp8hsTdia6uuAZ0UtI=; b=LuKeJ5EP4b3Bo6/j+DBVvkDH5bmKLQRNPnE45oiPjFwpTHfiAd/Ix9d7A/UNq/PLscjliSbX/T6Kp4wZCgn8/UBsdzc18P7ij5+T+/KgGxftmbvfn4RPNmYnyG2AuTHebwitQ4vdwcHTMo8UH2W6Qr9+VtcQharqa/YerAOKLeY= Received: from DBAPR08MB5814.eurprd08.prod.outlook.com (2603:10a6:10:1b1::6) by AM8PR08MB6516.eurprd08.prod.outlook.com (2603:10a6:20b:363::6) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.6652.28; Tue, 8 Aug 2023 21:42:34 +0000 Received: from DBAPR08MB5814.eurprd08.prod.outlook.com ([fe80::b3a3:eb56:481f:99c2]) by DBAPR08MB5814.eurprd08.prod.outlook.com ([fe80::b3a3:eb56:481f:99c2%4]) with mapi id 15.20.6652.026; Tue, 8 Aug 2023 21:42:34 +0000 From: Honnappa Nagarahalli To: Stephen Hemminger , "dev@dpdk.org" CC: nd , nd Subject: RE: [PATCH 08/20] rcu: remove experimental from rte_rcu_qbsr Thread-Topic: [PATCH 08/20] rcu: remove experimental from rte_rcu_qbsr Thread-Index: AQHZyh7Jw+fWDfGkEU2S7DhgnLUenq/g7g5w Date: Tue, 8 Aug 2023 21:42:34 +0000 Message-ID: References: <20230808173527.186042-1-stephen@networkplumber.org> <20230808173527.186042-9-stephen@networkplumber.org> In-Reply-To: <20230808173527.186042-9-stephen@networkplumber.org> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: x-ts-tracking-id: 7F288CA4853FC04A9F334A98F2DB1AEB.0 x-checkrecipientchecked: true authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=arm.com; x-ms-publictraffictype: Email x-ms-traffictypediagnostic: DBAPR08MB5814:EE_|AM8PR08MB6516:EE_ x-ms-office365-filtering-correlation-id: 8cf8a598-70be-48a7-b376-08db98586047 nodisclaimer: true x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: 9yoQUCQM+Bc8JvJzYDEqAORLYZI+9byyfKHsCVZkevf9ycexjGrWmXRQX9yDgu5Y1ey+YoKobmh8+awlQeqMzQrqKkf7Mu4r4ZHNCfYXFj/UsVIQ5BRxb8hTM2aq60dIr0b55TXxPiSVXhAj/Q3csjXUho4GWRDIV+9TMsyKvy/uFduvRuxonpz2QKZX2Ob+gQqX9ZrS9GB4hrZ4AcRMYNtba8Mv5F2ly9WIkj5Ti+lV14WCdenrsKMw4iD3QATThjHZG8jDqw3Hlt1DjWVrB883yx78vrFnS8B7LukXEyv2Oiuvqgb/sou0vw/G+tNiF2Ozk0LQ/RriV7C68pdnBOcDur07fDiZh3cxQYikZ7Ilf8byr/KJH5enaZCMxVYkHAbRvsRXSFwWXBsQ6szuxGkoxDokfLihG7qQMEjhZu9GMAwdOFJOZw8kWQMBlQdLY/vVYwF0DPLDYwt1S8/jYaCNIAPlSGs8kPFDzax+LBkQbqyAOjpn1vhRSMQu2i8Vi6VQcdhfJOLlbV02DSUJHvx6Qv8dVGRH55WQrK3TfTfteTB9eigm4/92KQ2DjuvMz76D8IFjcchlB0r9vOpPqMO2rN0W17eCZDaAuQBpM6U= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DBAPR08MB5814.eurprd08.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230028)(4636009)(346002)(376002)(366004)(396003)(39860400002)(136003)(1800799003)(186006)(451199021)(53546011)(6506007)(26005)(33656002)(9686003)(71200400001)(86362001)(478600001)(54906003)(110136005)(83380400001)(7696005)(316002)(66946007)(66556008)(66476007)(66446008)(64756008)(76116006)(4326008)(41300700001)(8676002)(38070700005)(5660300002)(8936002)(52536014)(122000001)(55016003)(38100700002)(2906002); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?G3aIsqRPEp1z1uKZmVnSs0z7dldMNMoe1N3/pA2Blzxldu8r428jXJb9wiSa?= =?us-ascii?Q?nVJFqQrpfMfcRvf68KDfbzVgtrV9suveXcWgHwrzasK+ecad1BadkwKav1Ts?= =?us-ascii?Q?AQcP5eHqy3tj4hmuWD4hbn8APoXeMxj1/lBc5PX0oN0SEXQDxw2zPlyQSdLp?= =?us-ascii?Q?lXut9sO/3q6ONUXhrmeLmAHpO0aBiupmKYWBTVz2A9ZHBFzq2WHcI6QpTbH8?= =?us-ascii?Q?PDR2Qcr0t+7s/C4+vTO0oz1z35LMG4AA4XW4tEk542m35bWkE8esBR6/g4Wh?= =?us-ascii?Q?UAlIbRRv/HvG2gh8FAPBiaygoBpcBh+RndQMcS8WlDNkBPAm7r4Uqji1g4e5?= =?us-ascii?Q?su/HWmTuuWUgFRh9PgJ+24VrGzwZUn+IeqQyf+DAdTNZPgiyvCK0pCVlV2kj?= =?us-ascii?Q?jUd4pmK24EVyWg5C7GwfOwjjPKPNgSa0EkYd3lLqkLauIBOgFQN0RHKJ4y5k?= =?us-ascii?Q?gEoOCH+Sm6FHESAxdcF+zF7/Td6FfJ3Of4kpGhwYM0Aw0OXSmGGdzuhIb/n6?= =?us-ascii?Q?vNJUjpbn/xs9lCuMzVLNF7Zk5DZc4GYN3oU9sBlNwAnHLIMWES/6husTDiad?= =?us-ascii?Q?LhlmlIjqDu79lGlD0uZyBsKuk7m8uqPu2GMIy8IsPQMqsy6Bi8iJolKb46g3?= =?us-ascii?Q?PWZgWCUYlj2gt28kJLfyTvbQD5SBmLmCUjpZfCcu+fBCopFN/K3e609ynBks?= =?us-ascii?Q?YA/DaJYkOLj+kStotGXjPTnESkivifG07o6YZRvphKWtCIu9DwICDC0J+LvH?= =?us-ascii?Q?07vGejkZGezOoOtk5c74ViPAGbCxljueJ18ARtNHIatJVq5Vu35WmhyKtdlM?= =?us-ascii?Q?h9Yor8BwqtIA9ScgOirAwDfY7kkSW1DEW4EQzlOX7GWybbyjfuzwzk0mo9BS?= =?us-ascii?Q?ZdpDUBm53Lhc1IuSFhhFxa0TooE9RwvwS7CBlmM5hdLrzDm3jTFBSOwtyDOG?= =?us-ascii?Q?Ty/ERPc//ljsMuy1KaVzrCrzoiKo5wfsbXl6XgK0Z7biUm2k9EMDlGFa84vD?= =?us-ascii?Q?TccpJLBMJzb/ZtH808aQ3Pw03zMPuUOficXlEHvrBbCpOQYyrtRK4jluZjBK?= =?us-ascii?Q?QDq73DTmeszZx3QOdJF3PUroe55Lkfe2PZFAIOS2Pfijrew7KHnx9IUZnjLi?= =?us-ascii?Q?EDP2TEDTZhbeTZX9nrXOmY6M+Z2ukfKsmBZu+icNgm7jEtquzgSRtUKq5NfL?= =?us-ascii?Q?y2L30KjY3Hshp/Y40ZUW7VdjftXbHlAgm8FxhdV+0ij8GcAAfi7fjsl0DjIp?= =?us-ascii?Q?0q/pAVXguiqETVjm5AfqH5eVPeIsnPX7EmOoRxCoa5Mc0gLddvTeEPz8IQYD?= =?us-ascii?Q?tOf6psMzKsi3Ln2aJzszRnoxnmwP5F4xvG604RWckx5Xkul4itxy150c+Eax?= =?us-ascii?Q?EzflOpUpguWF6SFyVhN46aDpGG+SBzsh02/3KXWuO6QhOINYHuQAeq3FloGV?= =?us-ascii?Q?yP6PExjjZ6TVLgG+jGy7dFlj3BqHHWgsumM0vKr4zX3OCaLzCxtJOUYo7pv8?= =?us-ascii?Q?rqpaw4c3IK7047SEHdKhTna7aMxTHKo3pfFcMAEUfWmhbsBzx4/CGi/8bdsd?= =?us-ascii?Q?6ritxF7Yx0rlnbTFvJ5V+OWUjWVH2jDrKNiEk3ngukRIsKVkkGVDNSiIhueI?= =?us-ascii?Q?Zg=3D=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: arm.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DBAPR08MB5814.eurprd08.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 8cf8a598-70be-48a7-b376-08db98586047 X-MS-Exchange-CrossTenant-originalarrivaltime: 08 Aug 2023 21:42:34.2430 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: f34e5979-57d9-4aaa-ad4d-b122a662184d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: gav7Qwr9jSB0svOakjUXWduDM+hhbbkEYvjF4/3s4kKJEWGANThtF7QNH4EeQ2e2f5hsYCjWdW1m0eUyTubUgprX4ogdthNbw6p1bJKU6V8= X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM8PR08MB6516 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org > -----Original Message----- > From: Stephen Hemminger > Sent: Tuesday, August 8, 2023 12:35 PM > To: dev@dpdk.org > Cc: Stephen Hemminger ; Honnappa > Nagarahalli > Subject: [PATCH 08/20] rcu: remove experimental from rte_rcu_qbsr >=20 > These functions were added back in 2020. > Remove experimental flag. >=20 > Signed-off-by: Stephen Hemminger Reviewed-by: Honnappa Nagarahalli > --- > lib/rcu/rte_rcu_qsbr.h | 20 -------------------- > lib/rcu/version.map | 15 ++++----------- > 2 files changed, 4 insertions(+), 31 deletions(-) >=20 > diff --git a/lib/rcu/rte_rcu_qsbr.h b/lib/rcu/rte_rcu_qsbr.h index > 87e1b55153b5..74ef41e0fac1 100644 > --- a/lib/rcu/rte_rcu_qsbr.h > +++ b/lib/rcu/rte_rcu_qsbr.h > @@ -10,10 +10,6 @@ > * > * RTE Quiescent State Based Reclamation (QSBR). > * > - * @warning > - * @b EXPERIMENTAL: > - * All functions in this file may be changed or removed without prior no= tice. > - * > * Quiescent State (QS) is any point in the thread execution > * where the thread does not hold a reference to a data structure > * in shared memory. While using lock-less data structures, the writer @= @ - > 727,9 +723,6 @@ int rte_rcu_qsbr_dump(FILE *f, struct rte_rcu_qsbr *v); >=20 > /** > - * @warning > - * @b EXPERIMENTAL: this API may change without prior notice > - * > * Create a queue used to store the data structure elements that can > * be freed later. This queue is referred to as 'defer queue'. > * > @@ -742,14 +735,10 @@ rte_rcu_qsbr_dump(FILE *f, struct rte_rcu_qsbr > *v); > * - EINVAL - NULL parameters are passed > * - ENOMEM - Not enough memory > */ > -__rte_experimental > struct rte_rcu_qsbr_dq * > rte_rcu_qsbr_dq_create(const struct rte_rcu_qsbr_dq_parameters *params); >=20 > /** > - * @warning > - * @b EXPERIMENTAL: this API may change without prior notice > - * > * Enqueue one resource to the defer queue and start the grace period. > * The resource will be freed later after at least one grace period > * is over. > @@ -777,14 +766,10 @@ rte_rcu_qsbr_dq_create(const struct > rte_rcu_qsbr_dq_parameters *params); > * if the defer queue size is equal (or larger) than the > * number of elements in the data structure. > */ > -__rte_experimental > int > rte_rcu_qsbr_dq_enqueue(struct rte_rcu_qsbr_dq *dq, void *e); >=20 > /** > - * @warning > - * @b EXPERIMENTAL: this API may change without prior notice > - * > * Free resources from the defer queue. > * > * This API is multi-thread safe. > @@ -806,15 +791,11 @@ rte_rcu_qsbr_dq_enqueue(struct rte_rcu_qsbr_dq > *dq, void *e); > * On error - 1 with rte_errno set to > * - EINVAL - NULL parameters are passed > */ > -__rte_experimental > int > rte_rcu_qsbr_dq_reclaim(struct rte_rcu_qsbr_dq *dq, unsigned int n, > unsigned int *freed, unsigned int *pending, unsigned int *available); >=20 > /** > - * @warning > - * @b EXPERIMENTAL: this API may change without prior notice > - * > * Delete a defer queue. > * > * It tries to reclaim all the resources on the defer queue. > @@ -832,7 +813,6 @@ rte_rcu_qsbr_dq_reclaim(struct rte_rcu_qsbr_dq *dq, > unsigned int n, > * - EAGAIN - Some of the resources have not completed at least 1 grac= e > * period, try again. > */ > -__rte_experimental > int > rte_rcu_qsbr_dq_delete(struct rte_rcu_qsbr_dq *dq); >=20 > diff --git a/lib/rcu/version.map b/lib/rcu/version.map index > 9218ed1f3399..982ffd59d9cd 100644 > --- a/lib/rcu/version.map > +++ b/lib/rcu/version.map > @@ -2,6 +2,10 @@ DPDK_24 { > global: >=20 > rte_rcu_log_type; > + rte_rcu_qsbr_dq_create; > + rte_rcu_qsbr_dq_delete; > + rte_rcu_qsbr_dq_enqueue; > + rte_rcu_qsbr_dq_reclaim; > rte_rcu_qsbr_dump; > rte_rcu_qsbr_get_memsize; > rte_rcu_qsbr_init; > @@ -11,14 +15,3 @@ DPDK_24 { >=20 > local: *; > }; > - > -EXPERIMENTAL { > - global: > - > - rte_rcu_qsbr_dq_create; > - rte_rcu_qsbr_dq_enqueue; > - rte_rcu_qsbr_dq_reclaim; > - rte_rcu_qsbr_dq_delete; > - > - local: *; > -}; > -- > 2.39.2