From patchwork Tue Apr 5 17:58:09 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: "Van Haaren, Harry" X-Patchwork-Id: 11946 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 3B6FF2C5D; Tue, 5 Apr 2016 19:58:22 +0200 (CEST) Received: from mga01.intel.com (mga01.intel.com [192.55.52.88]) by dpdk.org (Postfix) with ESMTP id EBC5F2C5A for ; Tue, 5 Apr 2016 19:58:19 +0200 (CEST) Received: from fmsmga001.fm.intel.com ([10.253.24.23]) by fmsmga101.fm.intel.com with ESMTP; 05 Apr 2016 10:58:17 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.24,444,1455004800"; d="scan'208";a="938872038" Received: from sie-lab-212-120.ir.intel.com (HELO silpixa00394367.ir.intel.com) ([10.237.212.120]) by fmsmga001.fm.intel.com with ESMTP; 05 Apr 2016 10:58:16 -0700 From: Harry van Haaren To: dev@dpdk.org Cc: maryam.tahhan@intel.com, Harry van Haaren Date: Tue, 5 Apr 2016 18:58:09 +0100 Message-Id: <1459879089-3430-1-git-send-email-harry.van.haaren@intel.com> X-Mailer: git-send-email 2.5.0 Subject: [dpdk-dev] [PATCH] doc: announce xstats api change for 16.07 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" This patch adds a notice that the API for the xstats functionality will be modified in the 16.07 release, with no backwards compatibility planned as it would require code duplication in each PMD that supports xstats. Signed-off-by: Harry van Haaren Acked-by: Thomas Monjalon Acked-by: Remy Horton Acked-by: David Harton Acked-by: Maryam Tahhan --- 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 98d5529..13c3a95 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -54,3 +54,8 @@ Deprecation Notices induce a modification of the rte_mempool structure, plus a modification of the API of rte_mempool_obj_iter(), implying a breakage of the ABI. + +* ABI change is planned for the xstats API and rte_eth_xstats struct, to + facilitate updating to an API that allows retrieval of values without any + string copies or parsing. No backwards compatibility is planned, as it would + require code duplication in every PMD that supports xstats.