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 47E67A0540; Mon, 13 Jul 2020 14:48:26 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 71F7E1D6D0; Mon, 13 Jul 2020 14:48:25 +0200 (CEST) Received: from EUR05-AM6-obe.outbound.protection.outlook.com (mail-am6eur05on2053.outbound.protection.outlook.com [40.107.22.53]) by dpdk.org (Postfix) with ESMTP id 084671D6CE for <dev@dpdk.org>; Mon, 13 Jul 2020 14:48:23 +0200 (CEST) ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=l5r+eArAgev4vn903aMqIgyO1qnDnMOdkFZ+9O584GUr+rYhfyjhEihtN/qep3+tljXuksSnussWSW7AxOlCLLgfEF/KUSh3GG9SdhwkvrKLXEvq+zzTbmv9rxgJ7whOblh2Pwp5ynKCNN8YupNmb9Pu7OXPmiJPHPXFqsl7Xwp9M/EaxpVUTGLc9y0TKtboMkfCa2CK1k35c/NJGAqws83hzC7DsJjfS3vFgjWBiIO7lt8P703WRDl/KU52vD51tACHpqwtn/cnz6vOa0O6R6w9YXYZZedjclhiUcX2sNVg1DnnBHZkTMZBpUjy2tZZ7/7d3orjO0hQPg4wJkS8Pw== 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=kte9Dt4Ht1r4PbYujJsms0tNamvwr33W3wKawT3UW3M=; b=lK9v8KwbcCzUMtbTfNx9Tc/lG0ilVC8wzEl4R8kQjKXgdVpZUAgFtMrpYgTRe1QmuDHbUqhpsSkIs2ux9JYoDBu4t1DFaMoa5BmcTna0rCcBydmpuN4/mv1JIajrL7eO/44RrNZJ2U4ISx2B9XHo4qXbfS99CWjyYwmF+9lYCmFcNtPOZbGjXn1q9IzCFrScLNKiUlqnMf98wwD8ITKdprwTzVDCfUv18CK05RfWSYJ7tr43EihsTYRXcrGRHhEHDigf8pNK0fNWZWDCQZ9f367LEJFvByK9gpDCdwjRJDHRHRdt0CGOyN3ss0jeOKGlb2SBNNwTGbCLFaKf6LK8Mg== 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=kte9Dt4Ht1r4PbYujJsms0tNamvwr33W3wKawT3UW3M=; b=b97a+rLiMIqpBrDzlGuOTcwJcBPjRVgl19LcDwBnlyLRVGIyG6bYTf6oLwzCuUxJk+WTe8O/5aZSlKb3o3egW9oVVtSZULah3IULJtggvYW3Ho1eeBXXnSdkwPFwDO4u2ZVwbC3TVCOMpXrryFkD2fCsYIVybzI5Y2LMLEZNMdE= Received: from AM6PR04MB4456.eurprd04.prod.outlook.com (2603:10a6:20b:22::25) by AM6PR04MB5720.eurprd04.prod.outlook.com (2603:10a6:20b:a7::10) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3174.22; Mon, 13 Jul 2020 12:48:22 +0000 Received: from AM6PR04MB4456.eurprd04.prod.outlook.com ([fe80::52:2324:96c9:f3ae]) by AM6PR04MB4456.eurprd04.prod.outlook.com ([fe80::52:2324:96c9:f3ae%7]) with mapi id 15.20.3174.025; Mon, 13 Jul 2020 12:48:22 +0000 From: Hemant Agrawal <hemant.agrawal@nxp.com> To: Bruce Richardson <bruce.richardson@intel.com>, "dev@dpdk.org" <dev@dpdk.org> CC: Nipun Gupta <nipun.gupta@nxp.com> Thread-Topic: [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs Thread-Index: AQHWWRGHoXlZW/GN5EuqCX3r/LPXN6kFdZwg Date: Mon, 13 Jul 2020 12:48:22 +0000 Message-ID: <AM6PR04MB44564D002B8E25999A20895B89600@AM6PR04MB4456.eurprd04.prod.outlook.com> References: <20200713123105.513960-1-bruce.richardson@intel.com> <20200713123105.513960-3-bruce.richardson@intel.com> In-Reply-To: <20200713123105.513960-3-bruce.richardson@intel.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.69.104.93] x-ms-publictraffictype: Email x-ms-office365-filtering-ht: Tenant x-ms-office365-filtering-correlation-id: 9ec4bae0-7eab-44fb-b26d-08d8272b06f9 x-ms-traffictypediagnostic: AM6PR04MB5720: x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: <AM6PR04MB5720AFD4C5BD8D0B09E4340589600@AM6PR04MB5720.eurprd04.prod.outlook.com> x-ms-oob-tlc-oobclassifiers: OLM:6790; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: VcLChIhn1vxTrOxVn49aY/Js0q407I7lHhfeDgo7Ym2AU9QTh0VGDbcO4FPxd8g9XtH/M7LErDJeaL3xzpJy5IpTS9T2TRrBKris7s2iDZ7oJp5it6K43DcsMkyoRKkrYpj77G9uNx74O/Bj7nAAm3nKedvfe2LRzdilOQnJCb0fEWE7A47YNQqgXeQ0N6mrcFoKL/EQ1ePvqyBoCTeUQ27bCejnHXGsBeDyjlTiPCtDy3BqvYnodRWu1v7ckZTBw1x8m+hM/8VPBxVJ2Rv/aNSfk0R2uuyWV19hpQ954mG7L7Lo2nynMd/BPkedcdOmQP9ej5bxt79bxaaEY86ziM3OBLSXHxRgO66fvhlRA8xgz7lt7RzhOlIZEeho+F5oUmcNyY/4VZRFuNeTh7FMzw== 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)(39860400002)(346002)(366004)(396003)(136003)(376002)(66556008)(64756008)(66476007)(76116006)(66446008)(33656002)(8936002)(186003)(4326008)(15650500001)(86362001)(44832011)(110136005)(2906002)(6506007)(53546011)(71200400001)(45080400002)(66946007)(8676002)(5660300002)(7696005)(52536014)(26005)(478600001)(316002)(83380400001)(55016002)(966005)(9686003); DIR:OUT; SFP:1101; x-ms-exchange-antispam-messagedata: nSTyz7m9+x7PP42K2e6Y1Qv8LLmBuE0+h6uVXvRCozInuvapG6JypT9gZaZxwDJEsRoH5zUPg0+0OK0VCobctflH9m9KO2umAdbg7YUYJLt1XA5wY2l2Tp5eILM/g+sU7mPFXGlYORyYhKNRBxA0+HizUvj6SDaJesWaFvxU+bZt1ir0GEx8St3GgI6KI0eBfEo5Qk+8xoISL73p+kPjLNeENszjShM+xR4huIQLdWAzA5Qe36GqNQGLJ6M9DUscAYh7onp+YzSZELog3mphxgjlYIwBWKIb/r1+quSucd3jrYldBZrnKtqJD/6i6yir4pcvXiX+e2Mvz+RG3ReIJPAsNrlKr0075mKXmV0y0oFkObOGaZQwrMmac/5KvAP+fPpYDhPa9AxNuoQX2w+s8LCNYC0TuB3vaho1I7s5J5O5vgDZhDNLlMm/fh7Wlyj6w91OHZxKHiMNEw4a/QBvhjoo04VrqJ6p3LInALKAzo8BVnIMuK2E2UVOVXGSeetC 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: 9ec4bae0-7eab-44fb-b26d-08d8272b06f9 X-MS-Exchange-CrossTenant-originalarrivaltime: 13 Jul 2020 12:48:22.5820 (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: kOWrD1EMn1UytDtDytI/evAvCUZYJ0XGQkHiCV382muCjGcBIT/hfpsXegjSLisOi2ZpyR/jgcxdwU/Jf40j1Q== X-MS-Exchange-Transport-CrossTenantHeadersStamped: AM6PR04MB5720 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: Bruce Richardson <bruce.richardson@intel.com>=20 Sent: Monday, July 13, 2020 6:01 PM To: dev@dpdk.org Cc: Bruce Richardson <bruce.richardson@intel.com>; Nipun Gupta <nipun.gupta= @nxp.com>; Hemant Agrawal <hemant.agrawal@nxp.com> Subject: [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs Importance: High 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%7C0f08b692d7e1471fa69908d8272= 8a944%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C637302402871919863&s= data=3DMfNlKHVOUk%2FRViCJBqSnyJRB%2BnnKpPeViN6OiCb9MJA%3D&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