From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id AC9A3A0526; Thu, 23 Jul 2020 03:55:43 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 7D8031BFBA; Thu, 23 Jul 2020 03:55:42 +0200 (CEST) Received: from mga07.intel.com (mga07.intel.com [134.134.136.100]) by dpdk.org (Postfix) with ESMTP id CD8A11BE9A for ; Thu, 23 Jul 2020 03:55:40 +0200 (CEST) IronPort-SDR: 9oT25YLywCLy5+eaM1llxl2O6pFsn0ac0O59w6xFNFh/sD6sWnTJRdlkocG8AnEuh34Y3F6tYp GWLmgH96c8Sw== X-IronPort-AV: E=McAfee;i="6000,8403,9690"; a="215071819" X-IronPort-AV: E=Sophos;i="5.75,385,1589266800"; d="scan'208";a="215071819" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga008.jf.intel.com ([10.7.209.65]) by orsmga105.jf.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 22 Jul 2020 18:55:38 -0700 IronPort-SDR: 7gmUDOtPwQN8fhb0aLm5WvGq/lHoWPBPb+73OIcmcdyw1PT6HTtm/eKwH8IpT+O5uQTJC1WDCG 2CcNlUs6SgUQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.75,385,1589266800"; d="scan'208";a="318840769" Received: from fmsmsx603.amr.corp.intel.com ([10.18.126.83]) by orsmga008.jf.intel.com with ESMTP; 22 Jul 2020 18:55:37 -0700 Received: from fmsmsx604.amr.corp.intel.com (10.18.126.84) by fmsmsx603.amr.corp.intel.com (10.18.126.83) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256) id 15.1.1713.5; Wed, 22 Jul 2020 18:55:37 -0700 Received: from FMSEDG002.ED.cps.intel.com (10.1.192.134) by fmsmsx604.amr.corp.intel.com (10.18.126.84) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256) id 15.1.1713.5 via Frontend Transport; Wed, 22 Jul 2020 18:55:37 -0700 Received: from NAM02-BL2-obe.outbound.protection.outlook.com (104.47.38.56) by edgegateway.intel.com (192.55.55.69) with Microsoft SMTP Server (TLS) id 14.3.439.0; Wed, 22 Jul 2020 18:55:36 -0700 ARC-Seal: i=1; a=rsa-sha256; s=arcselector9901; d=microsoft.com; cv=none; b=oRaAXQ96WG/wBbnKD48vwFHp7GMFjvQxOtyoI95tBN/gF//GDo3JNDL1c88d97T71eNit1vZ6VERCTe2Nsyo7nTYuCJ5bzDrqW6LeMq1dWb2BRMf2u1I+5jWS2pKtdSz/E69+FHe9CIoDHVUXm1fGGhGpC54UVJ2wMO/9RNRO/g4Mk15GifW/L0PSNluwibWj8OOk3cyKs1+MHrpZdivTQxajjkZQgBq7rclhE/myFfwarIIITfVTskLyxITf/Z8NjJfE1Njrtu2HSzmheFrxr4+drTyDFNWfwCQGGPVGc7IePqaZCMSXECxJYWWHbyPYqglBbe5t2JfpDrYoulrCA== 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=NFldSMn7X3uMMB7I7Qx1prvxY8A98Cuoz1I9li9CIcs=; b=hHCMHphn3/HcxLQA3HZ9Gdl/c7sTSUyxYsOdimKjvvAFu7p5u3r7pXYjuN8x91X1FSeds3QSOvv0imF/4opn3AX3OcjKCeLB314SIYfLcTN+3Bg11Q96RyvmW8fr68vDbezcRSbOYxKDJtoFX5NqhtdIED0BblO1onX3/XfK+q86VO4taJWrVILu8WnznQM23k0aa+2qtt9lRGNSJxCcojkZOwWcRezO3FgWmiihhHHIHJmM5AzSNs54c/qqubP0iY0HDQjHtXlkL+XzIxOZlcPlo51kT3Y3O8OCwsZ0HEWmJeJOHCdqunmD1DEW9HYhFPx5raK9bYZht/oznA+OUA== ARC-Authentication-Results: i=1; mx.microsoft.com 1; spf=pass smtp.mailfrom=intel.com; dmarc=pass action=none header.from=intel.com; dkim=pass header.d=intel.com; arc=none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=intel.onmicrosoft.com; s=selector2-intel-onmicrosoft-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=NFldSMn7X3uMMB7I7Qx1prvxY8A98Cuoz1I9li9CIcs=; b=UEiz88xR9Hc2kreMOX9YN7v/NfAPDbxeNE+UGlAwZvt7eyp0v9g7+ZGhITkF6Y6dZVuABlU8YcyvEo+CIuVXnaeELVV3G8OQTpGRI8QgDZ3tyx5IXPZGcK+GXsLlPP3gf1HHtorlCh8hCo52/wkKA0hPRHJ7fwyk9nrTXzPukak= Received: from BYAPR11MB2901.namprd11.prod.outlook.com (2603:10b6:a03:91::23) by BYAPR11MB3253.namprd11.prod.outlook.com (2603:10b6:a03:77::31) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.3216.23; Thu, 23 Jul 2020 01:55:33 +0000 Received: from BYAPR11MB2901.namprd11.prod.outlook.com ([fe80::6552:92f9:74a5:412]) by BYAPR11MB2901.namprd11.prod.outlook.com ([fe80::6552:92f9:74a5:412%4]) with mapi id 15.20.3216.021; Thu, 23 Jul 2020 01:55:33 +0000 From: "Xu, Rosen" To: "Richardson, Bruce" , "dev@dpdk.org" CC: "Richardson, Bruce" , Nipun Gupta , Hemant Agrawal Thread-Topic: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs Thread-Index: AQHWWRGaUG3Qp59C2kivrzcF4mEs76kUdoLg Date: Thu, 23 Jul 2020 01:55:33 +0000 Message-ID: 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=intel.com; x-originating-ip: [192.102.204.38] x-ms-publictraffictype: Email x-ms-office365-filtering-correlation-id: eefce825-984a-450d-c042-08d82eab7c62 x-ms-traffictypediagnostic: BYAPR11MB3253: x-ld-processed: 46c98d88-e344-4ed4-8496-4ed7712e255d,ExtAddr x-ms-exchange-transport-forked: True x-microsoft-antispam-prvs: x-ms-oob-tlc-oobclassifiers: OLM:6790; x-ms-exchange-senderadcheck: 1 x-microsoft-antispam: BCL:0; x-microsoft-antispam-message-info: cwsW8ePl9Wuo96jsjbGQZMDbHJ1nV2iRVWKKV/dJ+Uffl59NkMuB5p2wRRSaZV4lmeXcTr4m3oYJtuTJhBg6gONwB6RNadlD9BA8zp4eRz49iX8IeYfa83YQLKGnIoGwEWgupWT38jTw1OR9iaKn7eSGmMzt5rJ4weeyfUwSJy7T6peWlRNYb97cjrldxdMK72Mz+sud2uFOIpLcE4ZHfEP7RoBjJggwFFPPdga+oE32puWhsZP4P5BWzpm0TuORbeP/4LHI1BmY7SvJ4EOTyUzXCWucrNgALT0YvwRsspDBa44irDA6id9imFAOWF70O9zaaVFNhLzD0bi8+HpOlauL0Q3nhZTRAmMOELvSlRhX9xUVxjv5lG6Cs63ALzJ3Aq+XguCUTE1h+t0gO0qWgA== x-forefront-antispam-report: CIP:255.255.255.255; CTRY:; LANG:en; SCL:1; SRV:; IPV:NLI; SFV:NSPM; H:BYAPR11MB2901.namprd11.prod.outlook.com; PTR:; CAT:NONE; SFTY:; SFS:(4636009)(346002)(376002)(366004)(39860400002)(136003)(396003)(52536014)(8936002)(76116006)(66946007)(64756008)(66556008)(66476007)(5660300002)(66446008)(33656002)(2906002)(110136005)(54906003)(7696005)(316002)(478600001)(186003)(4326008)(53546011)(6506007)(26005)(966005)(71200400001)(15650500001)(9686003)(83380400001)(86362001)(55016002); DIR:OUT; SFP:1102; x-ms-exchange-antispam-messagedata: FgHQWdNG879LV5aWGAEqq+y1MEOXSrXPB2hRw+Mm0KVc7sAKm1bi/LloYws5o7gDptP8tPaLRiyiDPnrH8DRqnB6BLE+oZ5PT6+BseTGOAoXkwcl1pLMZsb8u0DJG/+oWW0JMksIiayr64pSvoqa5gHOACjAubr9mLG6a0PhJjwZl2EfVvP96a+aTqYa+5FwubDh5x0/VDrYGL4Iv2B9TkKrmOQSBNhwa0nFlHWBSwv6OGnrGSdOzL+qspfEJs2v3CkKLW2e+chEB+m8WchwwcE8RY3iQIS8yuNFJqjaYH/knXRBcKUAqqCvWLymV4Tef0aaF746pnYLqWFe9Wu+lycgz1/BIDiah67DKzqkQIHiNGoXFXGMMOLskG+rmCBAh4DH0fxBAh2ySpaM4T2u7zup52pCCSL+AIew0+Uuu4AcaUn36vdYwfBxidNK+QxfBXc/f943216lnTfi3H6VqmQatU2rdD70W9lWtBCGVHiQl6grwjwDfnLLYyuGUvFx Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-MS-Exchange-CrossTenant-AuthAs: Internal X-MS-Exchange-CrossTenant-AuthSource: BYAPR11MB2901.namprd11.prod.outlook.com X-MS-Exchange-CrossTenant-Network-Message-Id: eefce825-984a-450d-c042-08d82eab7c62 X-MS-Exchange-CrossTenant-originalarrivaltime: 23 Jul 2020 01:55:33.2617 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: 46c98d88-e344-4ed4-8496-4ed7712e255d X-MS-Exchange-CrossTenant-mailboxtype: HOSTED X-MS-Exchange-CrossTenant-userprincipalname: x6tPOBlUmriAci0qs91tbmDIYMtpZAgzhnIV02lK/6oGBQQK3IgasvLMJtgVcwbdu0qhzVhS2Jgr4Yk34t/9ow== X-MS-Exchange-Transport-CrossTenantHeadersStamped: BYAPR11MB3253 X-OriginatorOrg: intel.com 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 List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Hi, -----Original Message----- From: dev On Behalf Of Bruce Richardson Sent: Monday, July 13, 2020 8:31 PM To: dev@dpdk.org Cc: Richardson, Bruce ; Nipun Gupta ; Hemant Agrawal 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] http://inbox.dpdk.org/dev/20200709152047.167730-1-bruce.richardson@inte= l.com/ Cc: Nipun Gupta Cc: Hemant Agrawal Signed-off-by: Bruce Richardson --- 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