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 181B8A054D; Thu, 9 Jun 2022 07:15:02 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id B039340689; Thu, 9 Jun 2022 07:15:01 +0200 (CEST) Received: from EUR03-AM5-obe.outbound.protection.outlook.com (mail-eopbgr30089.outbound.protection.outlook.com [40.107.3.89]) by mails.dpdk.org (Postfix) with ESMTP id 274F740220 for ; Thu, 9 Jun 2022 07:15:00 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=UziOwcgJNHg/78H5bCM4IgF7/n8EsRPM1ruO9ROLGlKVHwUd2HfSjySSgFhxvYyLA73KWAeeZDM2tzDCKFU1ZpRm8CPf439K1JnyHKgHx6oybEYiSW44AfV3c00/WKnnE3WZ+h87oJkSYwKRwuoQTCmsxEr6oQCLpdLczyVd4GAUpEDrjRaX4UuMfq7do3Qpgt16YYm/Ob8nrrEWi+DqqaAJwZxNqxu6QevX2VixOclPg3mYlThkcmX86c6It6F6PMe1/Sglfr/A7P2trxKCHC2DFGitUROIJFaceAHhqsS99Anr83C1shFNiLhBnGCSxPYH/0vHT7CgsNQfqK+zbA== 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=zsYfqkokQSRNzWu3Fe5yIZ+xSx33h/hJq66h4jGwO30=; b=YlXpl4hQt7FCqnMkKAPkGHybsM2UxYOIlRiKNyC5zaWWN1fg414VPbMWE6Bq6vHX1FWlms/4Ka6ONZ0O9VUTEd4BmTSDadiG4gRoscqOtn0grWbEIDQH2RPMKVWICvknfRvH2+3BIvmPtrPvKf4AP8rIOm7pjj0z7MeNSpiClE16B1SZz2iAyJ1AtTCf2t8CTEvEzWbgBh35CO3bywHmUGw7od2aXb7sy/Zp2fewYFDHTgwv8Acx6FPsWDqre6gI2ScC0NRke8P6rO/bz6xtNf2nhI1yUhFIOB5JBLiWZlSDpzntMBBMvddav9vDwcaJytmEIHaxqJ2A/LR/rPocoQ== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nxp.com; dmarc=pass action=none header.from=nxp.com; dkim=pass header.d=nxp.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=nxp.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=zsYfqkokQSRNzWu3Fe5yIZ+xSx33h/hJq66h4jGwO30=; b=C1gYnzh5+S3RKvMmFp9BFbSS26+HvpHUpXy7lgadz/7utc8QVu8euzExWUrGmj0muh6T5UTb3aB4Pa1YX6pQoEz5BsuElIJ4c7ZyGdYu3SDtfC0wQqG3jpfvks4yfUP+ycbup5+PznCNLdxL1ypYqtr08zYp3M4pwqKzG/rg7C0= Received: from AS8PR04MB9064.eurprd04.prod.outlook.com (2603:10a6:20b:447::17) by VI1PR04MB3167.eurprd04.prod.outlook.com (2603:10a6:802:8::24) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5332.11; Thu, 9 Jun 2022 05:14:58 +0000 Received: from AS8PR04MB9064.eurprd04.prod.outlook.com ([fe80::7441:a97b:6d91:2943]) by AS8PR04MB9064.eurprd04.prod.outlook.com ([fe80::7441:a97b:6d91:2943%9]) with mapi id 15.20.5332.013; Thu, 9 Jun 2022 05:14:58 +0000 From: Hemant Agrawal To: Nicolas Chautru , "dev@dpdk.org" , "gakhil@marvell.com" , "thomas@monjalon.net" , "maxime.coquelin@redhat.com" CC: "trix@redhat.com" , "ray.kinsella@intel.com" , "bruce.richardson@intel.com" , "david.marchand@redhat.com" , "stephen@networkplumber.org" Subject: RE: [PATCH v4] doc: announce changes in bbdev related to enum extension Thread-Topic: [PATCH v4] doc: announce changes in bbdev related to enum extension Thread-Index: AQHYe5owyyCCt31nC0ayOYnGqkfn061GOigAgABOOjA= Date: Thu, 9 Jun 2022 05:14:58 +0000 Message-ID: References: <1647542252-35727-2-git-send-email-nicolas.chautru@intel.com> <1654734870-131398-1-git-send-email-nicolas.chautru@intel.com> <1654734870-131398-2-git-send-email-nicolas.chautru@intel.com> In-Reply-To: <1654734870-131398-2-git-send-email-nicolas.chautru@intel.com> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: dkim=none (message not signed) header.d=none;dmarc=none action=none header.from=nxp.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 801ff7ad-d45f-4f2c-5efa-08da49d6ff8b x-ms-traffictypediagnostic: VI1PR04MB3167:EE_ x-microsoft-antispam-prvs: x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: xoWpFbX7R7VE1a/1UP+tY8pka0xgGjW9LN+w/j0HPalMY9ydJSwAlSSIXsgcgMNIvGDOpdMm9455x3onFSSx7pQwIxJWrS4I9QWnqmRXVn+olge2Hj9S0sEX7G1yHMcremwU22W93O3e/2g/zGqzhBMsQdPCdrALDUGTGMH7+WMsSvYqym6f8krCt6PbIFStbsxRI8hjwVfFaYS2MJWjbBEhi4QYL0KbHFtOmm6FeekcHgR4I3uFZ7kwx/4HNLy/JJd2Z2TDz+kR1KoQ4UCxEiY0s4X1vxv5XEha0Rtg5kD9bPa6nFxm+5s2waUDUxfGz10UOYqhsBGDFbgIwA/3rCXAFc4QQWf8lBbgdcFEmsA4Mkx+MjjfRFWGcBYtUKZ5dxhUuTS+XJlb8ID8BPH1BVA3ww4reMLJPq4OIWu96OXXQUk9x6MccuZp/YU9NO86yVNaRsEM6DBLsq2m/XrFvCtV1Zr33PY3GZpW5xWUS8Xa1hUZi94NinVGRXqjYbSmRM+u8YQNu/xCR1pem5oex1djmpxG7guprZtM54dNCN7g9TDlZlcoUSHUHPgXfWIztCBEy620ueULbsv6H7R/EP5d9bFBww+t5zOcFyMDtp40MWNtW0HvcQPNwahescUTMZ3d+cLMCOa38yK1yGm9yLKSvbGkWQxKimgjC1I0V0q+q5fW1vPlQRc+Gh7l4h3iGoIc3KgfdmZqXVFr3jOdKX6LwgT3pG2J7EjWR0bhxJdClQ6/I/eb88p8tPJXwOQH318C7HcMH5XL89r4+aKz/WJHxyWjmlWmwzc3uXSqdGo= x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:AS8PR04MB9064.eurprd04.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230001)(4636009)(366004)(6506007)(86362001)(45080400002)(53546011)(186003)(508600001)(38070700005)(38100700002)(83380400001)(71200400001)(26005)(9686003)(7696005)(122000001)(55016003)(110136005)(44832011)(8936002)(33656002)(7416002)(316002)(54906003)(64756008)(66556008)(8676002)(66446008)(66946007)(2906002)(52536014)(5660300002)(76116006)(66476007)(4326008); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?ZiuIN2D2x8DIg5oSoaPr0KVokkPtppuL6HgFZuKxX1mcUrl9SUiPQoo59Kva?= =?us-ascii?Q?Kl+mzdDvKvj0I1T3gVawmw4jAYKFLS+EnBCPeuhcQ76h4nMRlkKnFVQ2l44m?= =?us-ascii?Q?1ulDcF0+f4ECF9x/BNNSONpegXAkPLWYpibPzOouAKn2IVAnG0QEcYwtxau2?= =?us-ascii?Q?A5jEzGBClfvClKtqvPnEoUkq21yZ3Y2pVLhHDgzJ7dpzmDf/susA8QSMh0lT?= =?us-ascii?Q?10EL6LFkM5r6NCjMxAPNfab8/+slWoNocSkHmVRBx1dkbDVngwW7WyxbKWW8?= =?us-ascii?Q?lLBoCMR2zy5laDw8PErwYT6lSUbG3nthBEc9OkqPP/M5ezhE7pOykXWr8fdL?= =?us-ascii?Q?bZy8TRKR/KQ3G3Hw2/liNkL+NC0tjbmfqrmlX0WL0SmtP4nac7Y96tYCxieO?= =?us-ascii?Q?zEAFs75MEwvLF7BzG/TNP03Yr7+er5kQi5TGADVpcJSz9FnTkoz9eM0AT2te?= =?us-ascii?Q?LBs+XH+bjywvQaKeT1CmMGN3bYown6qYAqFvF8TxXawIm/n3OXOtaI3dvRVF?= =?us-ascii?Q?Z5ojN14imW3QUpW1McqTEmhZ9sg91c0q6pSiBecf83cE+g6epOCvFEMTvyLC?= =?us-ascii?Q?NcHXnSPxMzGE4/6c9Kv7tCMA/iTrpH0IkYnun1Btxk3FsO8mR5466iJA23/a?= =?us-ascii?Q?B6rF3YFINrcnc35uLYbyLeV+m2kn4f6CTmulRyNZlVTq+Rc6jih+E7LsES+u?= =?us-ascii?Q?O3i+55UeqsNdUeuXhM5Z+btUMaaHWGbeXJbn9+ZGdvhXvgqsWJKC+D/L3WBK?= =?us-ascii?Q?W7Zlscf8wnoS8Y1Ky6HzvrO5KjANGBG+xIjNADoWR4BxV1m17paTqx7vKyTw?= =?us-ascii?Q?0ia+IZscYxpDHpLgm0C7JEl0B2g7fzI3ZdYxNTEaHYrfiedFSfua8wqTzpro?= =?us-ascii?Q?AgFvHcBLy6QOs8Npm7C3wZbtOYL+xqQ/kRQXf0wY8lF81FY4b96O0e03gMgX?= =?us-ascii?Q?07GsSZ2Ui5AuCSzZY6ujjQh26YytO/cK+FzbtfQ5aXPdZWV36zpLjfpWdOru?= =?us-ascii?Q?1PhEVRufn6p4S0jheCVx4zZJtO55Hv0KSX8apc6UfE3ZSq+n5b0BGEEkq7NC?= =?us-ascii?Q?ghyUoSQ2PbgpI4QCpECpVR1xMMuqqxu77itDeFcuc5Q3fK/4VUn0S1JKDHj1?= =?us-ascii?Q?j36XtRbpGfCTlc4Ai/eLCesZZfGqfQv1+9KSJCO+y/f5aFggRu8w0QDLV3Fh?= =?us-ascii?Q?hLKueKBoxT+cZWM9Ot39Tc49EuS3qOtsIEcQnXx7j3WRHCyCTyZbS0GWeKMo?= =?us-ascii?Q?cCBBni3Oh0RJUJvPFC5vSldC455AvVz12nl2xIzYMuJcNjTAy+1ehp7nJSxl?= =?us-ascii?Q?kiCm0b6SP4yeNgNXeoYS1BP/90BFf0crEtP5LlkHCniCspDn911FnwlOwp4T?= =?us-ascii?Q?DnCXQsuUyDYApDPp9GviMep7yb/SyXA6yw1S9K33j6he8rlTsYfun4wLycwO?= =?us-ascii?Q?MPOfvWKc6bltfinqtEXKt5QJmvq2KhUD1g8n1trfImIfBEygGYkhWkSqmBbp?= =?us-ascii?Q?QYvkTkJOKZw+FmQnqr1ymlFcB4Mp9eoJPxS63xIa02X4OcMw7M1awTDh0N3o?= =?us-ascii?Q?1MDjezxhlkDce1Cv5DTkaIfaklXpwtBFjKbJsd0UHB1kLCJJS+vJny0RemAi?= =?us-ascii?Q?hRcSOOI5IDoevpBedvI6nZQXipjViPrTs4Hv5RhK8bvRgsw0nzQ/Imv8yXV3?= =?us-ascii?Q?7luHqab1H7R9cwppGjcGMCNQUfC1tRFxAgjv5FDG5ziiDflFaMeUC6Wpp28E?= =?us-ascii?Q?kEZDnplSCg=3D=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: nxp.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: AS8PR04MB9064.eurprd04.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 801ff7ad-d45f-4f2c-5efa-08da49d6ff8b X-MS-Exchange-CrossTenant-originalarrivaltime: 09 Jun 2022 05:14:58.5030 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 686ea1d3-bc2b-4c6f-a92c-d99c5c301635 X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: uDeSnPwQKv5a1M6XUxZEyRYuyyVbwUy9hoJr82d00zEB6yUAXZbk9I7CGR7w+6lM/YX5WtTcwUNqqjMCz0D92w== X-MS-Exchange-Transport-CrossTenantHeadersStamped: VI1PR04MB3167 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: Nicolas Chautru > Sent: Thursday, June 9, 2022 6:05 AM > To: dev@dpdk.org; gakhil@marvell.com; thomas@monjalon.net; > maxime.coquelin@redhat.com > Cc: trix@redhat.com; ray.kinsella@intel.com; bruce.richardson@intel.com; > Hemant Agrawal ; > david.marchand@redhat.com; stephen@networkplumber.org; Nicolas > Chautru > Subject: [PATCH v4] doc: announce changes in bbdev related to enum > extension > Importance: High >=20 > Intent to resolve in DPDK 22.11 historical usage which prevents graceful > extension of enum and API without troublesome ABI breakage as well as > extending API RTE_BBDEV_OP_FFT for new operation type in bbdev as well > as other new members in existing structures. >=20 > Signed-off-by: Nicolas Chautru > --- > doc/guides/rel_notes/deprecation.rst | 11 +++++++++++ > 1 file changed, 11 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index 4e5b23c..c8ab1ec 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -112,6 +112,17 @@ Deprecation Notices > session and the private data of session. An opaque pointer can be expo= sed > directly to application which can be attached to the ``rte_crypto_op``= . >=20 > +* bbdev: ``RTE_BBDEV_OP_TYPE_COUNT`` terminating the > +``rte_bbdev_op_type`` > + enum will be deprecated and instead use fixed array size when > +required to allow for > + future enum extension. > + Will extend API to support new operation type ``RTE_BBDEV_OP_FFT`` as > +per this > + RFC > +https://eur01.safelinks.protection.outlook.com/?url=3Dhttps%3A%2F%2Fpatc > h > +work.dpdk.org%2Fproject%2Fdpdk%2Flist%2F%3Fseries%3D22111&da > ta=3D05%7 > +C01%7Chemant.agrawal%40nxp.com%7Ce8c1b946f9ba4152d02d08da49b1 > 5297%7C686 > +ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C637903323196944926%7C > Unknown%7C > +TWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwi > LCJXVCI > +6Mn0%3D%7C3000%7C%7C%7C&sdata=3DzDwsoIF4tF0eP2py43nwUHUz > pS3XlDTQDiRMd > +JxBqwg%3D&reserved=3D0 > + New members will be added in ``rte_bbdev_driver_info`` to expose PMD > +queue topology inspired > + by this RFC > +https://eur01.safelinks.protection.outlook.com/?url=3Dhttps%3A%2F%2Fpatc > h > +es.dpdk.org%2Fproject%2Fdpdk%2Flist%2F%3Fseries%3D22076&data=3D > 05%7C0 > +1%7Chemant.agrawal%40nxp.com%7Ce8c1b946f9ba4152d02d08da49b152 > 97%7C686ea > +1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C637903323196944926%7CUn > known%7CTW > +FpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJ > XVCI6M > +n0%3D%7C3000%7C%7C%7C&sdata=3Dtx8iueWoLEbbCyFQFQHKsvs9nkib > c0ANem5dyai > +mspQ%3D&reserved=3D0 > + New member will be added in ``rte_bbdev_driver_info`` to expose the > +device status as per > + this RFC > +https://eur01.safelinks.protection.outlook.com/?url=3Dhttps%3A%2F%2Fpatc > h > +es.dpdk.org%2Fproject%2Fdpdk%2Flist%2F%3Fseries%3D23367&data=3D > 05%7C0 > +1%7Chemant.agrawal%40nxp.com%7Ce8c1b946f9ba4152d02d08da49b152 > 97%7C686ea > +1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C637903323196944926%7CUn > known%7CTW > +FpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJ > XVCI6M > +n0%3D%7C3000%7C%7C%7C&sdata=3DrHnuL7B63SoFIIo1M4kdRnnDm0 > xqmCwML8CEo%2 > +BsxDBA%3D&reserved=3D0 > + This should be updated in DPDK 22.11. > + > * security: Hide structure ``rte_security_session`` and expose an opaque > pointer for the private data to the application which can be attached > to the packet while enqueuing. >=20 Acked-by: Hemant Agrawal