From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from dpdk.org (dpdk.org [92.243.14.124])
	by inbox.dpdk.org (Postfix) with ESMTP id B0FE2A0527;
	Thu, 23 Jul 2020 09:38:03 +0200 (CEST)
Received: from [92.243.14.124] (localhost [127.0.0.1])
	by dpdk.org (Postfix) with ESMTP id E535F1BF7B;
	Thu, 23 Jul 2020 09:38:02 +0200 (CEST)
Received: from EUR04-VI1-obe.outbound.protection.outlook.com
 (mail-eopbgr80075.outbound.protection.outlook.com [40.107.8.75])
 by dpdk.org (Postfix) with ESMTP id 1A0231BE90
 for <dev@dpdk.org>; Thu, 23 Jul 2020 09:38:02 +0200 (CEST)
ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none;
 b=JAKwxGweWYuBfCCCG7FXgZX6TlAmvMUovQ6HDjkw/qls/ymqaGhvRKnobis8UJbSSBBRSFocFWngFlf4Ni0E6zH3qzGW7F3fpg4oKj+WmHSRE2x9U9/dZNJtzb3UHHsZG8pB93bkAEK/33pmSDUWxO3XuioHHINHc1m/As348A04taogTF86lzYPpyFG+59mIKzh/qk+ERYp4VmsRd0FxN3uFUloaJsGncTQR59bEYVG7dVdl1Z8kJwS+Ac4Rp2xjypeIhCasd9cPz/xL39ITKwAmyZ103j4RDta1UX7qXrqRoB/dyAdfBvO9itD79UI4+AIyTisNSuH9FX42//Fqg==
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-SenderADCheck;
 bh=nfXTCJWkuq53hn380nLINh21dk56jhKT721e3AQ1sbU=;
 b=PnDt4oCIF9hTUFDIxMwRsvRIl7k8E6S2gjPQfw7hHiOTkYcjRqhwUnixrRu8VcZ9oJZtzX2JqliwKzcfJ4X3h5TQsJAUCy2roimc/kMQ3D6dppdiEfCrW3UMMERcIqMAqJj4N7ekmTHKzk561ViAtD7Md7hBNa0vXtvZdij3QHIVHzwOKo6gx/gNu231lC6p6EUD64Ls+XavlbJH2F+LdfX7ItWIBAcrGPVGjIKBYppbe9aDzYkZw4ySOGzqF8/Hxzt9r4K+Wv1Dz7mhc2gherBsGS2pInpvrcC/4rEM6CZXcXKYkJVGAM2xrl9ksV9uxgvQVg2MLJ/dnDLRVhcBVA==
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=nfXTCJWkuq53hn380nLINh21dk56jhKT721e3AQ1sbU=;
 b=BAjoZscQXRp1Fb488BnEqpH2m2katk3Hd4YBNPwBuRvxCpygX5M1/yLDqgDziUN50M2FHASTo3W6LQEtroiTDhG60OgA9Px/eUYI1vIcg76awOFf/ETev0sAz8HNTtqUmXCoVOidEWEUuXGBAC/pJhQEZAvM9PXHaeYh2gQp6p4=
Received: from AM6PR04MB4456.eurprd04.prod.outlook.com (2603:10a6:20b:22::25)
 by AM7PR04MB7079.eurprd04.prod.outlook.com (2603:10a6:20b:11d::13)
 with Microsoft SMTP Server (version=TLS1_2,
 cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3216.24; Thu, 23 Jul
 2020 07:38:01 +0000
Received: from AM6PR04MB4456.eurprd04.prod.outlook.com
 ([fe80::50d:1b5:ef9f:655c]) by AM6PR04MB4456.eurprd04.prod.outlook.com
 ([fe80::50d:1b5:ef9f:655c%7]) with mapi id 15.20.3216.024; Thu, 23 Jul 2020
 07:38:01 +0000
From: Hemant Agrawal <hemant.agrawal@nxp.com>
To: "Xu, Rosen" <rosen.xu@intel.com>, "Richardson, Bruce"
 <bruce.richardson@intel.com>, "dev@dpdk.org" <dev@dpdk.org>
CC: "Richardson, Bruce" <bruce.richardson@intel.com>, Nipun Gupta
 <nipun.gupta@nxp.com>
Thread-Topic: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of
 rawdev APIs
Thread-Index: AQHWYJRfM0ZdHbvdikSM5zjKtNg6rqkUxybg
Date: Thu, 23 Jul 2020 07:38:01 +0000
Message-ID: <AM6PR04MB445635298BD9AF9AE25A5CBF89760@AM6PR04MB4456.eurprd04.prod.outlook.com>
References: <20200713123105.513960-1-bruce.richardson@intel.com>
 <20200713123105.513960-3-bruce.richardson@intel.com>
 <BYAPR11MB290115BAC1428CA8B8AD84DE89760@BYAPR11MB2901.namprd11.prod.outlook.com>
In-Reply-To: <BYAPR11MB290115BAC1428CA8B8AD84DE89760@BYAPR11MB2901.namprd11.prod.outlook.com>
Accept-Language: en-US
Content-Language: en-US
X-MS-Has-Attach: 
X-MS-TNEF-Correlator: 
authentication-results: intel.com; dkim=none (message not signed)
 header.d=none;intel.com; dmarc=none action=none header.from=nxp.com;
x-originating-ip: [182.68.21.63]
x-ms-publictraffictype: Email
x-ms-office365-filtering-ht: Tenant
x-ms-office365-filtering-correlation-id: 6b5aab66-fb36-4a9c-2585-08d82edb53d4
x-ms-traffictypediagnostic: AM7PR04MB7079:
x-ms-exchange-transport-forked: True
x-microsoft-antispam-prvs: <AM7PR04MB70799DA020E6362D21694E9889760@AM7PR04MB7079.eurprd04.prod.outlook.com>
x-ms-oob-tlc-oobclassifiers: OLM:3513;
x-ms-exchange-senderadcheck: 1
x-microsoft-antispam: BCL:0;
x-microsoft-antispam-message-info: uubxIbozNFf2gKyyKzs6gK+xWuEv34fgfcq73wq88kCvXKO2LxkTaIBkqYeBWKLGj9epkUMNyIAM72amjuapN/fa9OQy+cWMLLF+4FYn/v1USjR1IjM0TYCFqhzekWhy9hem/bIafpzeUgB2tqX34cXgOJ+wwHY30J2WFvDf4fefn69w8FnJfl7BJpTWc7cCskOo59HoyZpqGQ6coXdUyF5Zc4iBjT4wmPcadoe4Q2G9zNAVGjzPqVpfkBowFr4RsLqCg0cj7cMxwOYc898YPm+d7HO1gwiWiouEsaYj9Jzomv2oxvtHI0HMvKe8tWu3lQoah/gJF+BxUm0u/bzDA5iGpIU0ogazJAMBPkxgO/6Cq0ykXY6xrXENLfdSh7KplUBohuMVPlFXdzSG7NlEtQ==
x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:;
 IPV:NLI; SFV:NSPM; H:AM6PR04MB4456.eurprd04.prod.outlook.com; PTR:; CAT:NONE;
 SFTY:;
 SFS:(4636009)(346002)(376002)(396003)(39860400002)(366004)(136003)(186003)(2906002)(45080400002)(8936002)(44832011)(64756008)(66556008)(66476007)(478600001)(83380400001)(5660300002)(15650500001)(7696005)(66446008)(66946007)(316002)(33656002)(76116006)(52536014)(26005)(110136005)(54906003)(9686003)(6506007)(86362001)(71200400001)(4326008)(53546011)(966005)(55016002);
 DIR:OUT; SFP:1101; 
x-ms-exchange-antispam-messagedata: DqebgxAVTUq8QHBYRezzWvoJ6JkQcWONqhJBNa6w5XYYs5QOmLJ4ox0zLDqpq4BEv/qm/2zLYO4wNcWrKROOOHNWVmY1NznS55Cn6Bx4E1GNZkVdYxZNovn0ygqasqqessUDGbbvjbOboQuf6yMGkcwPSNbCC25ClZV3J7oLj53wrZDjyHhFjJ9pa0VfnJGucWqIoPJ4fvm0gUrCDcLSxmWlsxpwgcgWZu9mWam4Z/SxCvsCKx6sSaXIbTJAJ9wdRATVhUxwVxkKTZz4VxjCIhyODd64D2U7PBNmz/ZVQjMLEbwpohzyx6YTy5NugR2haTUUEFo/X7h84dTbyvB50QaNGsoLdiYacxI//JNIxq81rDoN2gWATt1dLoPRMJN7yxZHHSPNOaO2zn/+EklflMc4uIjCI0AeggjssRrsdvL5b6ZmWc4dUHosvyidrsbDI6VqJ9YSlY9IMDAngoMm3REpN/Pd+jWw1cHf6JaRink=
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: AM6PR04MB4456.eurprd04.prod.outlook.com
X-MS-Exchange-CrossTenant-Network-Message-Id: 6b5aab66-fb36-4a9c-2585-08d82edb53d4
X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Jul 2020 07:38:01.1533 (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: WVY1o64Q9k9GhPg4cefqlXYejHgKOVAC/XGrPxrk0ZjSAq9z9NsLEsk1zxss6myK+fuF5qs0d4iHcT60IMDFgQ==
X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM7PR04MB7079
Subject: Re: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change
	of	rawdev APIs
X-BeenThere: dev@dpdk.org
X-Mailman-Version: 2.1.15
Precedence: list
List-Id: DPDK patches and discussions <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <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>,
 <mailto:dev-request@dpdk.org?subject=subscribe>
Errors-To: dev-bounces@dpdk.org
Sender: "dev" <dev-bounces@dpdk.org>

Acked-by: Hemant Agrawal <hemant.agrawal@nxp.com>

-----Original Message-----
From: Xu, Rosen <rosen.xu@intel.com>=20
Sent: Thursday, July 23, 2020 7:26 AM
To: Richardson, Bruce <bruce.richardson@intel.com>; dev@dpdk.org
Cc: Richardson, Bruce <bruce.richardson@intel.com>; Nipun Gupta <nipun.gupt=
a@nxp.com>; Hemant Agrawal <hemant.agrawal@nxp.com>
Subject: RE: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change =
of rawdev APIs
Importance: High

Hi,

-----Original Message-----
From: dev <dev-bounces@dpdk.org> On Behalf Of Bruce Richardson
Sent: Monday, July 13, 2020 8:31 PM
To: dev@dpdk.org
Cc: Richardson, Bruce <bruce.richardson@intel.com>; Nipun Gupta <nipun.gupt=
a@nxp.com>; Hemant Agrawal <hemant.agrawal@nxp.com>
Subject: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of r=
awdev APIs

Add to the documentation for 20.08 a notice about the changes of rawdev API=
s proposed by patchset [1].

[1] https://eur01.safelinks.protection.outlook.com/?url=3Dhttp%3A%2F%2Finbo=
x.dpdk.org%2Fdev%2F20200709152047.167730-1-bruce.richardson%40intel.com%2F&=
amp;data=3D02%7C01%7Chemant.agrawal%40nxp.com%7Cad3a0b27e46648a250d108d82ea=
b80a3%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C637310661421942508&amp;s=
data=3DDdzY9DbZwYzLjQasNhDKxxSSpFgbCc%2Foh9NZR1ksuB8%3D&amp;reserved=3D0

Cc: Nipun Gupta <nipun.gupta@nxp.com>
Cc: Hemant Agrawal <hemant.agrawal@nxp.com>

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/de=
precation.rst
index ead7cbe43..21b00103e 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -117,6 +117,13 @@ Deprecation Notices
   break the ABI checks, that is why change is planned for 20.11.
   The list of internal APIs are mainly ones listed in ``rte_ethdev_driver.=
h``.
=20
+* rawdev: The rawdev APIs which take a device-specific structure as
+  parameter directly, or indirectly via a "private" pointer inside=20
+another
+  structure, will be modified to take an additional parameter of the
+  structure size. The affected APIs will include=20
+``rte_rawdev_info_get``,
+  ``rte_rawdev_configure``, ``rte_rawdev_queue_conf_get`` and
+  ``rte_rawdev_queue_setup``.
+
 * traffic manager: All traffic manager API's in ``rte_tm.h`` were mistaken=
ly made
   ABI stable in the v19.11 release. The TM maintainer and other contributo=
rs have
   agreed to keep the TM APIs as experimental in expectation of additional =
spec
--
2.25.1

Acked-by: Rosen Xu <rosen.xu@intel.com>