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 CF19CA04B1; Wed, 9 Sep 2020 13:12:28 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 25C631BF8D; Wed, 9 Sep 2020 13:12:28 +0200 (CEST) Received: from mga11.intel.com (mga11.intel.com [192.55.52.93]) by dpdk.org (Postfix) with ESMTP id 3BD5F1BE0C for ; Wed, 9 Sep 2020 13:12:25 +0200 (CEST) IronPort-SDR: Abah5FqNWrhqCr07JNzzzNGg9Q8k3Tr8HLOuYjzhTi6RLp5n7hQTpIGYmNDbtkYwZ7B955lCJ1 r3ZClMus5dOg== X-IronPort-AV: E=McAfee;i="6000,8403,9738"; a="155785299" X-IronPort-AV: E=Sophos;i="5.76,409,1592895600"; d="scan'208";a="155785299" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga001.jf.intel.com ([10.7.209.18]) by fmsmga102.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 09 Sep 2020 04:12:24 -0700 IronPort-SDR: YsypVFf0j5BZr2uX8+weWEpeVHpRCjAEYvmcNEG+bhoPfnrBxui7/w27h96yjCA3VkfoQpiQhx GcyIheP/BStw== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.76,409,1592895600"; d="scan'208";a="377829685" Received: from silpixa00399752.ir.intel.com (HELO silpixa00399752.ger.corp.intel.com) ([10.237.222.180]) by orsmga001.jf.intel.com with ESMTP; 09 Sep 2020 04:12:22 -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 12:12:14 +0100 Message-Id: <20200909111220.1195759-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 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] [PATCH v3 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 --- 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) { -- 2.26.2