From patchwork Thu Dec 18 15:48:47 2014 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: "De Lara Guarch, Pablo" X-Patchwork-Id: 2100 Return-Path: X-Original-To: patchwork@dpdk.org Delivered-To: patchwork@dpdk.org Received: from [92.243.14.124] (localhost [IPv6:::1]) by dpdk.org (Postfix) with ESMTP id 8DDCE7E7C; Thu, 18 Dec 2014 16:59:12 +0100 (CET) Received: from mga02.intel.com (mga02.intel.com [134.134.136.20]) by dpdk.org (Postfix) with ESMTP id 9E3872A9 for ; Thu, 18 Dec 2014 16:59:08 +0100 (CET) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga101.jf.intel.com with ESMTP; 18 Dec 2014 07:55:11 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.07,601,1413270000"; d="scan'208";a="656460974" Received: from irvmail001.ir.intel.com ([163.33.26.43]) by orsmga002.jf.intel.com with ESMTP; 18 Dec 2014 07:55:10 -0800 Received: from sivswdev02.ir.intel.com (sivswdev02.ir.intel.com [10.237.217.46]) by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id sBIFmngd020768; Thu, 18 Dec 2014 15:48:49 GMT Received: from sivswdev02.ir.intel.com (localhost [127.0.0.1]) by sivswdev02.ir.intel.com with ESMTP id sBIFmnEB022975; Thu, 18 Dec 2014 15:48:49 GMT Received: (from pdelarax@localhost) by sivswdev02.ir.intel.com with id sBIFmnG5022971; Thu, 18 Dec 2014 15:48:49 GMT From: Pablo de Lara To: dev@dpdk.org Date: Thu, 18 Dec 2014 15:48:47 +0000 Message-Id: <1418917727-22921-3-git-send-email-pablo.de.lara.guarch@intel.com> X-Mailer: git-send-email 1.7.4.1 In-Reply-To: <1418917727-22921-1-git-send-email-pablo.de.lara.guarch@intel.com> References: <1418914328-22145-1-git-send-email-siobhan.a.butler@intel.com> <1418917727-22921-1-git-send-email-pablo.de.lara.guarch@intel.com> MIME-Version: 1.0 Subject: [dpdk-dev] =?utf-8?q?=5BPATCH_v2_2/2=5D_doc=3A_updating_from_1=2E?= =?utf-8?q?7_to_1=2E8_release_note?= X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: patches and discussions about DPDK List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" From: Siobhan Butler Added instructions for updating from DPDK 1.7.0 to 1.8.0 Signed-off-by: Siobhan Butler Signed-off-by: Bruce Richardson --- doc/guides/rel_notes/updating_apps.rst | 13 +++++++++++++ 1 file changed, 13 insertions(+) diff --git a/doc/guides/rel_notes/updating_apps.rst b/doc/guides/rel_notes/updating_apps.rst index 034554d..4dbf268 100644 --- a/doc/guides/rel_notes/updating_apps.rst +++ b/doc/guides/rel_notes/updating_apps.rst @@ -7,6 +7,19 @@ may require some code updates to benefit from performance and user experience en DPDK 1.7 to DPDK 1.8 -------------------- +Note that in DPDK 1.8, the structure of the rte_mbuf has changed considerably from all previous versions. +It is recommended that users familiarize themselves with the new structure defined in the file rte_mbuf.h in the release package. +The follow are some common changes that need to be made to code using mbufs, following an update to DPDK 1.8: + +* Any references to fields in the pkt or ctrl sub-structures of the mbuf, need to be replaced with references to the field + directly from the rte_mbuf, i.e. buf->pkt.data_len should be replace by buf->data_len. + +* Any direct references to the data field of the mbuf (original buf->pkt.data) should now be replace by the macro rte_pktmbuf_mtod + to get a computed data address inside the mbuf buffer area. + +* Any references to the in_port mbuf field should be replace by references to the port field. + +NOTE: The above list is not exhaustive, but only includes the most commonly required changes to code using mbufs. Intel® DPDK 1.6 to DPDK 1.7 ---------------------------