From patchwork Thu Jul 30 12:55:54 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: yang_y_yi X-Patchwork-Id: 75039 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 48BFFA052B; Thu, 30 Jul 2020 14:56:12 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 4BD02E07; Thu, 30 Jul 2020 14:56:11 +0200 (CEST) Received: from m12-14.163.com (m12-14.163.com [220.181.12.14]) by dpdk.org (Postfix) with ESMTP id EE4032AB for ; Thu, 30 Jul 2020 14:56:08 +0200 (CEST) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=163.com; s=s110527; h=From:Subject:Date:Message-Id:MIME-Version; bh=e4WkR 4pka6lruKU9zKGGzN7CchjRv/I6co7YNANqDiQ=; b=gJjcr5Jtk+sXrzN2TuUYB fexJl//bU1zv84MWE071tULOdCp+/Z6wco5Tf1yyjr+yqObriJissSmujRfLFGsM CW2UXMLQAUqGp+uzIp+QnaL0oITSDrh0ujs5dCfRCVBeGaNL6z4eV2o8o1llbT3H ScwatbcSHFGCZaI6WvFd00= Received: from yangyi0100.home.langchao.com (unknown [61.48.210.155]) by smtp10 (Coremail) with SMTP id DsCowABndIhbwyJfKerMDg--.12744S2; Thu, 30 Jul 2020 20:55:56 +0800 (CST) From: yang_y_yi@163.com To: dev@dpdk.org Cc: jiayu.hu@intel.com, thomas@monjalon.net, yangyi01@inspur.com, yang_y_yi@163.com, Ray Kinsella , Neil Horman , John McNamara , Marko Kovacevic Date: Thu, 30 Jul 2020 20:55:54 +0800 Message-Id: <20200730125555.43908-1-yang_y_yi@163.com> X-Mailer: git-send-email 2.19.2.windows.1 MIME-Version: 1.0 X-CM-TRANSID: DsCowABndIhbwyJfKerMDg--.12744S2 X-Coremail-Antispam: 1Uf129KBjvJXoWrKFyxGr4xurWrCr4UtryfCrg_yoW8JrW5pa 1v9rWUC39xJrn3Cw1Iqr1fXFWfAFWkGa47WrZ2va4agwn3uryIq3yDCr4YkFW8X3s7Aa4f ZFW0q347A3W7uFDanT9S1TB71UUUUUUqnTZGkaVYY2UrUUUUjbIjqfuFe4nvWSU5nxnvy2 9KBjDUYxBIdaVFxhVjvjDU0xZFpf9x07UI2NtUUUUU= X-Originating-IP: [61.48.210.155] X-CM-SenderInfo: 51dqwsp1b1xqqrwthudrp/1tbiqAhxi1c7RBhdKwABsd Subject: [dpdk-dev] [PATCH] doc: announce deprecation of rte_mbuf_extbuf_free_callback_t 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" From: Yi Yang typedef rte_mbuf_extbuf_free_callback_t will be deprecated in 20.08 release. Signed-off-by: Yi Yang --- doc/guides/rel_notes/deprecation.rst | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 99c9806..df60e06 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -135,6 +135,14 @@ Deprecation Notices will be removed in 20.11. It will be replaced with ``refcnt`` of type ``uint16_t``. +* rte_mbuf_ext_shared_info: typedef of ``free_cb`` member in structure + ``rte_mbuf_ext_shared_info`` ``rte_mbuf_extbuf_free_callback_t`` will be + changed to adapt to GSO case, new typedef will be + ``void (*rte_mbuf_extbuf_free_callback_t)(struct rte_mbuf *, void *)``, + it is impossible to free original owner mbuf of shinfo by ``free_cb`` and + keep compatible with non-GSO case at the same time without this change. + It will be deprecated in 20.08. + * metrics: The function ``rte_metrics_init`` will have a non-void return in order to notify errors instead of calling ``rte_exit``.