From patchwork Mon Nov 23 13:40:07 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Ferruh Yigit X-Patchwork-Id: 84470 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id B1D5FA04B1; Mon, 23 Nov 2020 14:40:19 +0100 (CET) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 8F420C8C4; Mon, 23 Nov 2020 14:40:17 +0100 (CET) Received: from mga05.intel.com (mga05.intel.com [192.55.52.43]) by dpdk.org (Postfix) with ESMTP id 6CB2A375B for ; Mon, 23 Nov 2020 14:40:14 +0100 (CET) IronPort-SDR: YVnjRpPZD6BY138BqAZgfMZupzMI+83V6+hoxfBHAEBviiKidvXJv3Kud6bjVupsHS4RkkL9QB L67ilpRV3RvQ== X-IronPort-AV: E=McAfee;i="6000,8403,9813"; a="256470706" X-IronPort-AV: E=Sophos;i="5.78,363,1599548400"; d="scan'208";a="256470706" X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from orsmga006.jf.intel.com ([10.7.209.51]) by fmsmga105.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 23 Nov 2020 05:40:11 -0800 IronPort-SDR: TY84D4FcXdet6jBgYIt0xS68SjzBQnblwrGpqpWqL7+D8ep63XngfQiX92Idn8aPsHEOv7i3Ke ht4yVl/HDC5Q== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.78,363,1599548400"; d="scan'208";a="332186930" Received: from silpixa00399752.ir.intel.com (HELO silpixa00399752.ger.corp.intel.com) ([10.237.222.180]) by orsmga006.jf.intel.com with ESMTP; 23 Nov 2020 05:40:09 -0800 From: Ferruh Yigit To: Ray Kinsella , Neil Horman Cc: Ferruh Yigit , dev@dpdk.org, Thomas Monjalon , Andrew Rybchenko , Ori Kam Date: Mon, 23 Nov 2020 13:40:07 +0000 Message-Id: <20201123134007.2870297-1-ferruh.yigit@intel.com> X-Mailer: git-send-email 2.26.2 MIME-Version: 1.0 Subject: [dpdk-dev] [PATCH] doc: announce flow API matching pattern struct changes X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org Sender: "dev" Proposing to replace protocol header fields in the ``rte_flow_item_*`` structures with the protocol structs, like: Current ``struct rte_flow_item_eth``, struct rte_flow_item_eth { struct rte_ether_addr dst; struct rte_ether_addr src; rte_be16_t type; uint32_t has_vlan:1; uint32_t reserved:31; } will become struct rte_flow_item_eth { struct rte_ether_hdr hdr; uint32_t has_vlan:1; uint32_t reserved:31; } This is both for documenting the intention and to be sure ``rte_flow_item_*`` always starts with complete protocol header. Already many ``rte_flow_item_*`` structs implemented to have protocol struct, target is convert all to this usage. Signed-off-by: Ferruh Yigit Acked-by: Andrew Rybchenko --- Cc: Thomas Monjalon Cc: Andrew Rybchenko Cc: Ori Kam --- doc/guides/rel_notes/deprecation.rst | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 96986fabd598..a2fa0c196472 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -88,6 +88,13 @@ Deprecation Notices will be limited to maximum 256 queues. Also compile time flag ``RTE_ETHDEV_QUEUE_STAT_CNTRS`` will be removed. +* ethdev: The flow API matching pattern structures, ``struct rte_flow_item_*``, + should start with relevant protocol header. + Some matching pattern structures implements this by duplicating protocol header + fields in the struct. To clarify the intention and to be sure protocol header + is intact, will replace those fields with relevant protocol header struct. + Target is v21.02 release and this should not change the ABI. + * sched: To allow more traffic classes, flexible mapping of pipe queues to traffic classes, and subport level configuration of pipes and queues changes will be made to macros, data structures and API functions defined