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 59953A0032; Wed, 13 Jul 2022 14:37:17 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id F1E7A4282D; Wed, 13 Jul 2022 14:37:16 +0200 (CEST) Received: from NAM10-DM6-obe.outbound.protection.outlook.com (mail-dm6nam10on2062.outbound.protection.outlook.com [40.107.93.62]) by mails.dpdk.org (Postfix) with ESMTP id 88F284280D for ; Wed, 13 Jul 2022 14:37:15 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=F+C/OffgxG36mIKodMNvBzPUR4ZmNWQbeDV0HKtj+8/pH8JhubIpYYQbTk9vrxZGqFhd/0q9eRLSxJw6qoCy/9SHfQvmbJwkARp4SjpQtItjOXGxJZMUdu0d8uGOb/jDnXJKsdqcyxVh6HnLROX5UBbTiQYShkadcvawCiPhW+QR/XH1eDOesr9vpwPvXbWxhiDXAkifcRbLbZh4sTC43XT+0HA/Fb+TYB0icX31LpODzrjkwyUQyusTGDNkHb7VK6aKZhr9e3bkcVHmzKyTOPJHF0XUafJrNolZkM7km2Y+pWT9PPaPS5BlusaD7/NvFNpgMRXeGh7Mx5q2WuYLQw== 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=pVhDq3sOmxBpDnr89piiCPn/2aZdZ3k6dvsPwbvqGyA=; b=kmM9XGyY8lo7QGKUy4t69Ks3sVj+0q5VNRRgifyyo/3fqqB9aRnzVBNShM3WStgfDyDTEfrNP3IYJf+lssw3LO81/TCfb6posx4ELhtHda38fTtga9ADkwdu9rcJnxgoNFMqY5V9ejXOILnqdoROdeeApXiPcMos/bEjWfZWSPae8rMTtmpgx2qGpCvRhU7wx3Xx7TlO4IIaqwL0TcCmSwibRAxvWp63VVUDzQ0YcZZ0nd75U0iVTa1HscrWJPeOX0UjB8hTRwnjzmnsgHdWOdgTS49RZCi05CMbBzVAx43sPI81PxbMctR4MVqdzMBMIamItC1ynAf4BR2Mpak2Mg== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=nvidia.com; dmarc=pass action=none header.from=nvidia.com; dkim=pass header.d=nvidia.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Nvidia.com; s=selector2; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=pVhDq3sOmxBpDnr89piiCPn/2aZdZ3k6dvsPwbvqGyA=; b=CaEQ76ovd+Y/zGMRBowI20QGhoeGpinKK9b4/NQOAcMb8Tx/tETBEDM1gEjXXe5OwcUcpi+KRnHykNOJnh9wvRkU9eVt0cIGjnbFtjnhA5vLnDn7K45mWVKFFQvTmgYMJKMqB2KcIwbL0F/ef45etjgvhREJM7fIjPBnceQugRMNLcDfA4hfzVlzYhWSmkC/zpD+gDrMQywH0YAGSnvNQu+2Lb94bo6ZJWuNyJIOUt75cO/ZRBTsj6NINcQ5VzkBXeuAr7tV/thBOCEykhfAixnSeK0unWI7214cVrsd93mA7YoHFfUOnWqmPu72Qx7IQklinKMlLt3SDn/ZuNokXA== Received: from DM4PR12MB5389.namprd12.prod.outlook.com (2603:10b6:5:39e::8) by SN6PR12MB2752.namprd12.prod.outlook.com (2603:10b6:805:78::21) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.5417.16; Wed, 13 Jul 2022 12:37:13 +0000 Received: from DM4PR12MB5389.namprd12.prod.outlook.com ([fe80::bc12:9556:e6af:a1d7]) by DM4PR12MB5389.namprd12.prod.outlook.com ([fe80::bc12:9556:e6af:a1d7%5]) with mapi id 15.20.5417.026; Wed, 13 Jul 2022 12:37:13 +0000 From: Matan Azrad To: "NBU-Contact-Thomas Monjalon (EXTERNAL)" , "dev@dpdk.org" CC: "david.marchand@redhat.com" , "andrew.rybchenko@oktetlabs.ru" , "maxime.coquelin@redhat.com" , "chenbo.xia@intel.com" , "mdr@ashroe.eu" , "xiao.w.wang@intel.com" , "vsrivast@xilinx.com" , "ferruh.yigit@xilinx.com" Subject: RE: [PATCH v2] doc: announce transition to vDPA device name function Thread-Topic: [PATCH v2] doc: announce transition to vDPA device name function Thread-Index: AQHYlfRfoUgXsaeGXk+oQUsMCImKCK18Pm6g Date: Wed, 13 Jul 2022 12:37:13 +0000 Message-ID: References: <20210518073441.2749096-1-thomas@monjalon.net> <20220712133610.4175033-1-thomas@monjalon.net> In-Reply-To: <20220712133610.4175033-1-thomas@monjalon.net> 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=nvidia.com; x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: 92e7e52d-d567-4b1a-2ae4-08da64cc69ad x-ms-traffictypediagnostic: SN6PR12MB2752:EE_ x-ld-processed: 43083d15-7273-40c1-b7db-39efd9ccc17a,ExtAddr x-ms-exchange-senderadcheck: 1 x-ms-exchange-antispam-relay: 0 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: nCufYfPTa76psVhj5wyEgzVAZinmBqNzmyqO/qYQ45Ieer3Q7pFr2MuKQbRqeG0hU2qMfbrz/m2RlfyxKc/BZRLhHSgI2ZsMKBQdLCzTUg+KDjnNXnYdCTjAMhSv4ma/Q/AoukaprsfrHy7HWJ6ccxFdHO+K43qF1YT0WHEZL41aq+U3N4S0tpYH/2gVOwnhShCxKPtO6T9OWECicWQ3REPvA3zL0eZwxFlT2EJsslctIaFgkXq+bR9V+1OU8UNdirvgGaR9ycnJAFKfhGu8lh2gUrLA6QuN6V1B6orPJDjoGEiY7nZMK/zZiiITDC60Sa9TdpkiqvCd57Q95NROuURVeta57ZZy/HYKBeOksbbrdprabtATeQZ+7gVe4eZRca+9VeSU3ep+4eZ7m4IGBU9XpQV9s6sd9eE3Oo6rNwZUtTh//i4MgLdNWFHoNIrZ9EjaVL4nADz65GrlVD2RVWH+UiW1GvLcD1l3yjuM4KwaTJxGu/soIOUXhrN8cTgVeiWstRK/YRuQBTCL8THWyxFq/+DeeLV/ag5X7ZkwboFQ0SbbXv6L+YFYtJWWskaGrhuJ+PVF6kB9fBIgytBNXLNJD7Kt5v/EFyWg0eMHBNnvk2YDHdGVM1uwRdTinDK84lFraJmBqTj+yf/hjTk70p+seLSAIZ/5mEVPOjwAn8w5IhtXnKPkDFe34HkMgNTUWxRDQdS5RfO3oZ8eKjh4rybO0rmaGmFkEc9cmrrWtBRYMvXTjswSllajfCgETJSNwxSUHwKhdnSdb2LhfiMBIc9Y9G02siBn0Z+0uiGTTAWtlCDs+ZGVWqXTWAAz+BSk x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:DM4PR12MB5389.namprd12.prod.outlook.com; PTR:; CAT:NONE; SFS:(13230016)(4636009)(136003)(39860400002)(346002)(366004)(396003)(376002)(64756008)(76116006)(66946007)(66556008)(8676002)(66446008)(66476007)(478600001)(4326008)(7696005)(71200400001)(41300700001)(83380400001)(122000001)(26005)(38100700002)(6506007)(9686003)(33656002)(7416002)(5660300002)(2906002)(316002)(38070700005)(86362001)(186003)(52536014)(54906003)(8936002)(55016003)(110136005); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata-chunkcount: 1 x-ms-exchange-antispam-messagedata-0: =?us-ascii?Q?Mh/vFet5CJMYsRTR/gEvBPFFya11z+GDr5cBwc3miHfVDg7374hnUT9DjalQ?= =?us-ascii?Q?qZtNOmQEbUL+Y69ygWMlyJlj9RlxIdjaaLoZtlx2GXSPxJoM/bQtJZ5JJzIt?= =?us-ascii?Q?alYVx+0CA074J2Q/I3J6JnCt/E+NAMfGVfi1ruh92RT+dIZ5fZzNs0JP36Vc?= =?us-ascii?Q?zAeQzl8IRTISnh35Ry0yTWKfWSFM+ePpH/s1lBbQuSNfp7bTC4XNcIhTPm1o?= =?us-ascii?Q?kbdqhyNXJGXcJH/FI+PDEMdOFZ2USbLn8vbzjH2ZbqEIMB/+Hkzangm/Y5eA?= =?us-ascii?Q?ymA36VF9va3ka5RQeeJ7zYIgUogcvSvuG6Kc5lNIQ7PKi00Nj8vt/qsqgw1t?= =?us-ascii?Q?IUaRuArlqb/bMcmZWZxvPMfxEZ6MAFbDOqPk/T1O6VhvU069dHeYpZwrp3ts?= =?us-ascii?Q?w5PZiVjTJaFVbRJ2DnqV3XuQl5kbbItGabzWLFQ/ldzE2nNoFCZJztOXs2Qr?= =?us-ascii?Q?nI1c7j5JYTh7jXBz9Z7iyli61vrz+pHo15MGmN9XVQURlAQi4Ddc4GgEDgrZ?= =?us-ascii?Q?ljXGVAvQXpen07qe3jgNQPgLozDpRJ7pGgbhXfNRqoJWVZ3jqIWJRHP/46xa?= =?us-ascii?Q?d0bm+uh2FbbLUV7b6M9gBrXZVaTh7FDOI6MB2jGykX6yy+hVtwSutTX+6jWs?= =?us-ascii?Q?z2AF2BtEa2VdVYxPvqLqDk+bzHnBLEViGyExemRaBx2oCzeXj6dbghQTtkLV?= =?us-ascii?Q?y6V4HoM9+qIg5QEN/1WqQ9+xrO0cAR4QK1bTEjRtb/LN8rH8v+WK5kg1w65b?= =?us-ascii?Q?ssysgB82DH5YjsJI/H8eF/0gtq2/3qvYy0gv6KYGQ0KCK4QFy3pJoaKLLBZe?= =?us-ascii?Q?XLUcXOLwPkkFXpitG0X6Koyz1yUs/4pKk8IALv09nJxNa/WXpNUl7P9gxTEV?= =?us-ascii?Q?FG36GaO3cQsmufdi1rmXLzMtLCLvrAzSMdNNTRBdXFcEnCd0F/xxutTT8f5h?= =?us-ascii?Q?6mnGpP8qIUHqrGd6OxmLj+DABaMYAb0Vs2D6yPX2+T/1BWHkLXl09q1Lc5kd?= =?us-ascii?Q?zo9ygdtuZ201m1XBG/vDWvao6xuaMrRrJmUvwoc0DxKtspASEzxHgkNqE6Sw?= =?us-ascii?Q?G8kH6U9ymK6HwoEsD6xXi25ncSnqJodteflDOAZHbD4LvJvt3es7oYAaO9Zp?= =?us-ascii?Q?fo1JwJRlylbYqdAWnFMwjtRYU7+7b/yErW+KAi8scMdxvuax4b31r5XWWo6y?= =?us-ascii?Q?B68kjC89KaeWwocPrgFlESm/MukEVJpzAGGMMSMKCnHqFbWlzpm+WHDGErWy?= =?us-ascii?Q?1hqO0ESub/BBeWHmcE3x1PcqqMy+ztV5fEWNsYS4CFZOQDFFpUFR8+gS6X9q?= =?us-ascii?Q?zaPJj6KcJCpbhAQG4dwOLTlgA57ahXtoGMMoGSPpWY8vnxJalX7wzc62YFet?= =?us-ascii?Q?1WHAf3ve9Vctl7Pu8iEWheXTZjbtm4seVV/YgGGfhoVs5Yt0MmXJ/NHIMwBz?= =?us-ascii?Q?WPfqviMi2nULlv2XrmT1bXussROoHHQPKR7p1XMHbZOSh1yQwOER0tRxXtpD?= =?us-ascii?Q?zVrtJYwMbrw1IMJZJEfbC4IlOKnTBGgm/7/zxq63YSH3hqg4IOh8Z8mYggBI?= =?us-ascii?Q?Rw8fSIGhC9FHqveEYr0=3D?= Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: Nvidia.com X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: DM4PR12MB5389.namprd12.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: 92e7e52d-d567-4b1a-2ae4-08da64cc69ad X-MS-Exchange-CrossTenant-originalarrivaltime: 13 Jul 2022 12:37:13.4940 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 43083d15-7273-40c1-b7db-39efd9ccc17a X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: sYxhBC5h8EovojCeUVJd4taKsKmHHlmJhBAu/x7VtdAAv7LxiMLEW2/5FlIfciiiI36/APID5ABY+Cf87TUfmg== X-MS-Exchange-Transport-CrossTenantHeadersStamped: SN6PR12MB2752 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 From: Thomas Monjalon=20 > There is a layer violation in the vDPA API for getting the device name. > Instead of providing the name at vDPA level, a function returns the low-l= evel > device object. > The plan is to introduce a new function in 22.11, promote in 23.07, and r= emove > rte_vdpa_get_rte_device() in 23.11. >=20 > Signed-off-by: Thomas Monjalon > --- > v2: one year passed, update with a new plan > v1 was proposing a close function, only device name is needed > --- > doc/guides/rel_notes/deprecation.rst | 7 +++++++ > 1 file changed, 7 insertions(+) >=20 > diff --git a/doc/guides/rel_notes/deprecation.rst > b/doc/guides/rel_notes/deprecation.rst > index 4e5b23c53d..0f7fefbf6a 100644 > --- a/doc/guides/rel_notes/deprecation.rst > +++ b/doc/guides/rel_notes/deprecation.rst > @@ -107,6 +107,13 @@ Deprecation Notices > alternative is implemented. > The legacy actions should be removed in DPDK 22.11. >=20 > +* vdpa: The vDPA API should not try to manipulate or export > + any ``rte_device`` object, which belongs to the bus layer. > + The function ``rte_vdpa_get_rte_device()`` will be deprecated in > +23.07, > + when its usage will be replaced with ``rte_vdpa_get_device_name()``. > + The new function should enter in 22.11 and get promoted to stable in 2= 3.07. > + The target is to remove ``rte_vdpa_get_rte_device()`` in 23.11. > + > * cryptodev: Hide structures ``rte_cryptodev_sym_session`` and > ``rte_cryptodev_asym_session`` to remove unnecessary indirection betwe= en > session and the private data of session. An opaque pointer can be expo= sed > -- > 2.36.1 Acked-by: Matan Azrad