From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by dpdk.org (Postfix) with ESMTP id 0AC887DF0 for ; Thu, 18 Dec 2014 16:07:42 +0100 (CET) Received: from fmsmga003.fm.intel.com ([10.253.24.29]) by fmsmga101.fm.intel.com with ESMTP; 18 Dec 2014 07:06:24 -0800 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.97,862,1389772800"; d="scan'208";a="430762736" Received: from irvmail001.ir.intel.com ([163.33.26.43]) by FMSMGA003.fm.intel.com with ESMTP; 18 Dec 2014 06:55:11 -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 sBIEqAkX032594; Thu, 18 Dec 2014 14:52:10 GMT Received: from sivswdev02.ir.intel.com (localhost [127.0.0.1]) by sivswdev02.ir.intel.com with ESMTP id sBIEqAU3022196; Thu, 18 Dec 2014 14:52:10 GMT Received: (from sabutler@localhost) by sivswdev02.ir.intel.com with id sBIEqA6Y022192; Thu, 18 Dec 2014 14:52:10 GMT From: Siobhan Butler To: dev@dpdk.org Date: Thu, 18 Dec 2014 14:52:08 +0000 Message-Id: <1418914328-22145-3-git-send-email-siobhan.a.butler@intel.com> X-Mailer: git-send-email 1.7.4.1 In-Reply-To: <1418914328-22145-1-git-send-email-siobhan.a.butler@intel.com> References: <1418914328-22145-1-git-send-email-siobhan.a.butler@intel.com> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Subject: [dpdk-dev] =?utf-8?q?=5BPATCH_2/2=5D_doc=3A_updating_from_1=2E7_t?= =?utf-8?q?o_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: , X-List-Received-Date: Thu, 18 Dec 2014 15:07:43 -0000 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 | 29 +++++++++++++++++++++++------ 1 file changed, 23 insertions(+), 6 deletions(-) diff --git a/doc/guides/rel_notes/updating_apps.rst b/doc/guides/rel_notes/updating_apps.rst index ba8012d..60d5d60 100644 --- a/doc/guides/rel_notes/updating_apps.rst +++ b/doc/guides/rel_notes/updating_apps.rst @@ -2,17 +2,34 @@ Updating Applications from Previous Versions ============================================ Although backward compatibility is being maintained across Intel® DPDK releases, code written for previous versions of the Intel® DPDK -may require some code updates to benefit from performance and user experience enhancements provided in later Intel® DPDK releases. +may require some code updates to benefit from performance and user experience enhancements provided in later DPDK releases. + +Intel® 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 Intel® DPDK 1.7 ----------------------------------- +------------------------------------ Note the following difference between 1.6 and 1.7: * The "default" target has been renamed to "native" Intel® DPDK 1.5 to Intel® DPDK 1.6 ----------------------------------- +------------------------------------ Note the following difference between 1.5 and 1.6: @@ -21,7 +38,7 @@ Note the following difference between 1.5 and 1.6: Intel® DPDK release and documented in the *Intel® DPDK Getting Started Guide*. Intel® DPDK 1.4 to Intel® DPDK 1.5 ----------------------------------- +------------------------------------ Note the following difference between 1.4 and 1.5: @@ -29,7 +46,7 @@ Note the following difference between 1.4 and 1.5: that is, DPDK-1.5.2/ rather than just DPDK/ . Intel® DPDK 1.3 to Intel® DPDK 1.4.x ------------------------------------- +-------------------------------------- Note the following difference between releases 1.3 and 1.4.x: @@ -50,7 +67,7 @@ Note the following difference between releases 1.3 and 1.4.x: For more details on this and how to re-enable the HPET if it is needed, please consult the *Intel® DPDK Getting Started Guide*. Intel® DPDK 1.2 to Intel® DPDK 1.3 ----------------------------------- +------------------------------------ Note the following difference between releases 1.2 and 1.3: -- 1.9.4.msysgit.2