From patchwork Wed Sep 9 13:01:42 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ferruh Yigit X-Patchwork-Id: 77043 X-Patchwork-Delegate: ferruh.yigit@amd.com 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 87654A04B1; Wed, 9 Sep 2020 15:02:26 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 931931C0CD; Wed, 9 Sep 2020 15:02:17 +0200 (CEST) Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) by dpdk.org (Postfix) with ESMTP id C663E1C0CD for ; Wed, 9 Sep 2020 15:02:15 +0200 (CEST) IronPort-SDR: cBZQbn9mUJPocSK8caD+pQySSoqOfI34Sfbs0zgumrRBNT/HdqcmcMtexJdtPtpUdau+d0mspB AkWnCy202cyQ== X-IronPort-AV: E=McAfee;i="6000,8403,9738"; a="137837523" X-IronPort-AV: E=Sophos;i="5.76,409,1592895600"; d="scan'208";a="137837523" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Sep 2020 06:01:52 -0700 IronPort-SDR: ckjs9YGuNRupOJMU5MWm2Xh5d9cCojlx6BDM1tJ/O70axRDG7CUbUcGJfqUrlmTpDbMrg/Jfdu UOTT5Ba4ExwQ== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.76,409,1592895600"; d="scan'208";a="341566967" Received: from silpixa00399752.ir.intel.com (HELO silpixa00399752.ger.corp.intel.com) ([10.237.222.180]) by FMSMGA003.fm.intel.com with ESMTP; 09 Sep 2020 06:01:50 -0700 From: Ferruh Yigit To: dev@dpdk.org, Ray Kinsella , Neil Horman , John McNamara , Marko Kovacevic , Thomas Monjalon , Andrew Rybchenko Cc: Ferruh Yigit , David Marchand Date: Wed, 9 Sep 2020 14:01:42 +0100 Message-Id: <20200909130148.1756518-1-ferruh.yigit@intel.com> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200824094021.2323605-1-ferruh.yigit@intel.com> References: <20200824094021.2323605-1-ferruh.yigit@intel.com> MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH v4 1/7] ethdev: deprecate descriptor status check API 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" Marking 'rte_eth_rx_descriptor_done()' API as deprecated. ``rte_eth_rx_descriptor_status`` and ``rte_eth_tx_descriptor_status`` APIs can be used as replacement. Plan is to remove the API on 21.11 release. Signed-off-by: Ferruh Yigit Acked-by: David Marchand --- Cc: David Marchand v3: * Just deprecating the 'rte_eth_rx_descriptor_done()' API without removing it to stick to the original plan. --- doc/guides/rel_notes/deprecation.rst | 2 +- doc/guides/rel_notes/release_20_11.rst | 2 ++ lib/librte_ethdev/rte_ethdev.h | 1 + 3 files changed, 4 insertions(+), 1 deletion(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 279eccb04a..35c676e262 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -214,7 +214,7 @@ Deprecation Notices https://mails.dpdk.org/archives/dev/2020-July/176135.html. * ethdev: ``rx_descriptor_done`` dev_ops and ``rte_eth_rx_descriptor_done`` - will be deprecated in 20.11 and will be removed in 21.11. + will be removed in 21.11. Existing ``rte_eth_rx_descriptor_status`` and ``rte_eth_tx_descriptor_status`` APIs can be used as replacement. diff --git a/doc/guides/rel_notes/release_20_11.rst b/doc/guides/rel_notes/release_20_11.rst index df227a1773..a7d57b001d 100644 --- a/doc/guides/rel_notes/release_20_11.rst +++ b/doc/guides/rel_notes/release_20_11.rst @@ -84,6 +84,8 @@ API Changes Also, make sure to start the actual text at the margin. ======================================================= +* ``rte_eth_rx_descriptor_done()`` API has deprecated. + ABI Changes ----------- diff --git a/lib/librte_ethdev/rte_ethdev.h b/lib/librte_ethdev/rte_ethdev.h index f30245b102..eb6cd01f8d 100644 --- a/lib/librte_ethdev/rte_ethdev.h +++ b/lib/librte_ethdev/rte_ethdev.h @@ -4567,6 +4567,7 @@ rte_eth_rx_queue_count(uint16_t port_id, uint16_t queue_id) * - (-ENODEV) if *port_id* invalid. * - (-ENOTSUP) if the device does not support this function */ +__rte_deprecated static inline int rte_eth_rx_descriptor_done(uint16_t port_id, uint16_t queue_id, uint16_t offset) {