From patchwork Thu Jul 16 12:19:36 2015 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Cristian Dumitrescu X-Patchwork-Id: 6452 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 6131DC33A; Thu, 16 Jul 2015 14:19:51 +0200 (CEST) Received: from mga03.intel.com (mga03.intel.com [134.134.136.65]) by dpdk.org (Postfix) with ESMTP id 93E4DC336 for ; Thu, 16 Jul 2015 14:19:48 +0200 (CEST) Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga103.jf.intel.com with ESMTP; 16 Jul 2015 05:19:40 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.15,488,1432623600"; d="scan'208";a="765609986" Received: from irvmail001.ir.intel.com ([163.33.26.43]) by orsmga002.jf.intel.com with ESMTP; 16 Jul 2015 05:19:38 -0700 Received: from sivswdev01.ir.intel.com (sivswdev01.ir.intel.com [10.237.217.45]) by irvmail001.ir.intel.com (8.14.3/8.13.6/MailSET/Hub) with ESMTP id t6GCJbkV022201; Thu, 16 Jul 2015 13:19:38 +0100 Received: from sivswdev01.ir.intel.com (localhost [127.0.0.1]) by sivswdev01.ir.intel.com with ESMTP id t6GCJbOA006912; Thu, 16 Jul 2015 13:19:37 +0100 Received: (from cfdumitr@localhost) by sivswdev01.ir.intel.com with id t6GCJbAf006908; Thu, 16 Jul 2015 13:19:37 +0100 From: Cristian Dumitrescu To: dev@dpdk.org Date: Thu, 16 Jul 2015 13:19:36 +0100 Message-Id: <1437049176-6866-1-git-send-email-cristian.dumitrescu@intel.com> X-Mailer: git-send-email 1.7.4.1 Subject: [dpdk-dev] [PATCH] doc: announce ABI change for librte_port 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" Signed-off-by: Cristian Dumitrescu Acked-by: Maciej Gajdzica Acked-by: Daniel Mrzyglod Acked-by: Jasvinder Singh --- doc/guides/rel_notes/abi.rst | 12 ++++++++++++ 1 files changed, 12 insertions(+), 0 deletions(-) diff --git a/doc/guides/rel_notes/abi.rst b/doc/guides/rel_notes/abi.rst index 9e98d62..271e08e 100644 --- a/doc/guides/rel_notes/abi.rst +++ b/doc/guides/rel_notes/abi.rst @@ -34,3 +34,15 @@ Deprecation Notices creates a dummy/empty malloc library to fulfill binaries with dynamic linking dependencies on librte_malloc.so. Such dummy library will not be created from release 2.2 so binaries will need to be rebuilt. + +* librte_port (rte_port.h): Macros to access the packet meta-data stored within + the packet buffer will be adjusted to cover the packet mbuf structure as well, + as currently they are able to access any packet buffer location except the + packet mbuf structure. The consequence is that applications currently using + these macros will have to adjust the value of the offset parameter of these + macros by increasing it with sizeof(struc rte_mbuf). The affected macros are: + RTE_MBUF_METADATA_UINT<8, 16, 32, 64>_PTR and + RTE_MBUF_METADATA_UINT<8, 16, 32, 64>. In terms of code changes, most likely + only the definition of RTE_MBUF_METADATA_UINT8_PTR macro will be changed from + ``(&((uint8_t *) &(mbuf)[1])[offset])`` to + ``(&((uint8_t *) (mbuf))[offset])``.