From patchwork Mon Jul 13 12:31:05 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Bruce Richardson X-Patchwork-Id: 73939 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 3F541A0540; Mon, 13 Jul 2020 14:31:36 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 3E9B11D6F3; Mon, 13 Jul 2020 14:31:26 +0200 (CEST) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by dpdk.org (Postfix) with ESMTP id 6BDB71D6F3 for ; Mon, 13 Jul 2020 14:31:24 +0200 (CEST) IronPort-SDR: iERcr6+ZtC+F29VBzRNEsrMkVerXy4WxXWfXF8M94Ja2GCsYVg033J8mNJBsZxOnxsX4T4OR2z Gqvc2PT0rsAw== X-IronPort-AV: E=McAfee;i="6000,8403,9680"; a="166709963" X-IronPort-AV: E=Sophos;i="5.75,347,1589266800"; d="scan'208";a="166709963" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga004.fm.intel.com ([10.253.24.48]) by fmsmga101.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 13 Jul 2020 05:31:24 -0700 IronPort-SDR: xn2JtDalMCExJPfIwKHbpPauMuxBMTBi1GmIfuxUMvDFP+zczQgfz/bzwycdkLAc9YGjQSj4zp JpvjlBD1QtXg== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.75,347,1589266800"; d="scan'208";a="307445760" Received: from silpixa00399126.ir.intel.com ([10.237.222.36]) by fmsmga004.fm.intel.com with ESMTP; 13 Jul 2020 05:31:23 -0700 From: Bruce Richardson To: dev@dpdk.org Cc: Bruce Richardson , Nipun Gupta , Hemant Agrawal Date: Mon, 13 Jul 2020 13:31:05 +0100 Message-Id: <20200713123105.513960-3-bruce.richardson@intel.com> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20200713123105.513960-1-bruce.richardson@intel.com> References: <20200713123105.513960-1-bruce.richardson@intel.com> MIME-Version: 1.0 Subject: [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" Add to the documentation for 20.08 a notice about the changes of rawdev APIs proposed by patchset [1]. [1] http://inbox.dpdk.org/dev/20200709152047.167730-1-bruce.richardson@intel.com/ Cc: Nipun Gupta Cc: Hemant Agrawal Signed-off-by: Bruce Richardson Acked-by: Hemant Agrawal Signed-off-by: Bruce Richardson Acked-by: Konstantin Ananyev Acked-by: Rosen Xu Acked-by: Hemant Agrawal Signed-off-by: Bruce Richardson Acked-by: Rosen Xu --- 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/deprecation.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``. +* rawdev: The rawdev APIs which take a device-specific structure as + parameter directly, or indirectly via a "private" pointer inside another + structure, will be modified to take an additional parameter of the + structure size. The affected APIs will include ``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 mistakenly made ABI stable in the v19.11 release. The TM maintainer and other contributors have agreed to keep the TM APIs as experimental in expectation of additional spec