From patchwork Thu Aug 1 12:41:23 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Monjalon X-Patchwork-Id: 57352 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id B34151C1DB; Thu, 1 Aug 2019 14:41:35 +0200 (CEST) Received: from out2-smtp.messagingengine.com (out2-smtp.messagingengine.com [66.111.4.26]) by dpdk.org (Postfix) with ESMTP id 49C4D1C1DA for ; Thu, 1 Aug 2019 14:41:34 +0200 (CEST) Received: from compute1.internal (compute1.nyi.internal [10.202.2.41]) by mailout.nyi.internal (Postfix) with ESMTP id D85AC220CA; Thu, 1 Aug 2019 08:41:30 -0400 (EDT) Received: from mailfrontend2 ([10.202.2.163]) by compute1.internal (MEProxy); Thu, 01 Aug 2019 08:41:30 -0400 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= from:to:cc:subject:date:message-id:mime-version :content-transfer-encoding; s=mesmtp; bh=njaV3U0DI8K5ghEMfeKw7uc BwIPAfRL/jhwxWlH3HHM=; b=jgHS31Mm++UtaAZ7nBY4D++E3sBHlwyC34QLoC2 PG3rJBtJLzI6N+SJ67ylZeqTXoU1rfn63SJyCRDL2I/ym2TIO304eiOKxmzECDIr sb9ysT5VNMxMxZSyMdznZzFSmyeBBnWaH3/KrMSOM5Ax4C/HXQxfvRQ1jhAtiO47 WLxY= DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:content-transfer-encoding:date:from :message-id:mime-version:subject:to:x-me-proxy:x-me-proxy :x-me-sender:x-me-sender:x-sasl-enc; s=fm3; bh=njaV3U0DI8K5ghEMf eKw7ucBwIPAfRL/jhwxWlH3HHM=; b=BAobbV65FhNgSDLoU33Iqn60lNWrLyjjq vZdE/HDb2JOsDcbkD4EmBrAcdJZw/S5bYS2wEYY+lSDxWlwoXBvEJ3k2YyHttgJY ZFO7tjr696nrjOQwbHRaohSK1CWEjbzjkDYdwm+gp5jqU/TsmKNRlk9j5QtbisT9 Tarx77tKLCoj5umGBPFbTzDT8vPQoZhD9KpbFKqdp9CVlUkQdomLS/09829jpd9G 3SUz7uYX7hIXjwdzPR3prjVCk2oy6Mw726lo7BtCBd2QrTi2TK+Es+gbm9vvoSdC ssNXXuOYYBCoHrg/EjeBIyQqCBK2X8AcRnvDj0wPywEFPtnrHvh5w== X-ME-Sender: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgeduvddrleejgdehgecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecunecujfgurhephffvufffkffoggfgsedtkeertdertd dtnecuhfhrohhmpefvhhhomhgrshcuofhonhhjrghlohhnuceothhhohhmrghssehmohhn jhgrlhhonhdrnhgvtheqnecukfhppeejjedrudefgedrvddtfedrudekgeenucfrrghrrg hmpehmrghilhhfrhhomhepthhhohhmrghssehmohhnjhgrlhhonhdrnhgvthenucevlhhu shhtvghrufhiiigvpedt X-ME-Proxy: Received: from xps.monjalon.net (184.203.134.77.rev.sfr.net [77.134.203.184]) by mail.messagingengine.com (Postfix) with ESMTPA id 7D047380085; Thu, 1 Aug 2019 08:41:29 -0400 (EDT) From: Thomas Monjalon To: olivier.matz@6wind.com Cc: dev@dpdk.org Date: Thu, 1 Aug 2019 14:41:23 +0200 Message-Id: <20190801124123.21591-1-thomas@monjalon.net> X-Mailer: git-send-email 2.21.0 MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH] doc: announce API change in mbuf 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" In order to prepare for a long term stable API, the mbuf library has to change: allowing more features as dynamic fields, and fixing the lack of rte_ prefix in the namespace. The namespace fix should not break the compatibility by keeping some aliases during few releases to give time for migration. Signed-off-by: Thomas Monjalon Acked-by: Olivier Matz --- doc/guides/rel_notes/deprecation.rst | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 37b8592b6..e4939f1fe 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -51,6 +51,11 @@ Deprecation Notices structure would be made internal (or removed if all dependencies are cleared) in future releases. +* mbuf: Some fields will be moved or converted to dynamic API in DPDK 19.11 + in order to offer more space for the dynamic fields in future. + The namespace will be fixed at the same time while keeping a backward + compatibility for some time. + * ethdev: the legacy filter API, including ``rte_eth_dev_filter_supported()``, ``rte_eth_dev_filter_ctrl()`` as well as filter types MACVLAN, ETHERTYPE, FLEXIBLE, SYN, NTUPLE, TUNNEL, FDIR,