summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSiobhan Butler <siobhan.a.butler@intel.com>2014-12-18 15:48:47 +0000
committerThomas Monjalon <thomas.monjalon@6wind.com>2014-12-20 00:38:39 +0100
commit5ef25d82fd0b165b4d7fb368965d40be9e8416a4 (patch)
tree7a031dc0205a060ec755ea6e8c11977160808b98
parent7547be1efc1e19558b489be5dc79822b23bd2a36 (diff)
downloaddpdk-5ef25d82fd0b165b4d7fb368965d40be9e8416a4.zip
dpdk-5ef25d82fd0b165b4d7fb368965d40be9e8416a4.tar.gz
dpdk-5ef25d82fd0b165b4d7fb368965d40be9e8416a4.tar.xz
doc: updating to 1.8 release note
Added instructions for updating from DPDK 1.7.0 to 1.8.0 Signed-off-by: Siobhan Butler <siobhan.a.butler@intel.com> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com> Acked-by: Bernard Iremonger <bernard.iremonger@intel.com>
-rw-r--r--doc/guides/rel_notes/updating_apps.rst13
1 files changed, 13 insertions, 0 deletions
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
---------------------------