From patchwork Thu Nov 24 14:26:59 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Thomas Monjalon X-Patchwork-Id: 120131 X-Patchwork-Delegate: thomas@monjalon.net Return-Path: X-Original-To: patchwork@inbox.dpdk.org Delivered-To: patchwork@inbox.dpdk.org Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id EF95EA00C3; Thu, 24 Nov 2022 15:27:19 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 9918642DCE; Thu, 24 Nov 2022 15:27:13 +0100 (CET) Received: from out5-smtp.messagingengine.com (out5-smtp.messagingengine.com [66.111.4.29]) by mails.dpdk.org (Postfix) with ESMTP id BD44942DC9 for ; Thu, 24 Nov 2022 15:27:11 +0100 (CET) Received: from compute4.internal (compute4.nyi.internal [10.202.2.44]) by mailout.nyi.internal (Postfix) with ESMTP id 667E45C0121; Thu, 24 Nov 2022 09:27:11 -0500 (EST) Received: from mailfrontend2 ([10.202.2.163]) by compute4.internal (MEProxy); Thu, 24 Nov 2022 09:27:11 -0500 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=monjalon.net; h= cc:cc:content-transfer-encoding:date:date:from:from:in-reply-to :in-reply-to:message-id:mime-version:references:reply-to:sender :subject:subject:to:to; s=fm1; t=1669300031; x=1669386431; bh=JI b79+/8nYSK36fselgk2gecfNdBCsd5WWWk0DkcVac=; b=LkVxSa+8M0AxgYudnZ NZDK+L59BGE6vC+ypi2edoyNjxaf3RO1Zvhu7uwGbkAKuuttSbDJMauB9h8Aj7PH /9p15GbRTVe16MzQQsh8Ob04/rJiukzP+ECbw3PmLYwQV/6VAZ/DWvAS4r7MnQj3 +tkTD0d73ZvcUZPqO3FguU172ZYitnAhLq6ilPoBZ3u38KFTK+u5Xj5C7H0Zmzwf DzYlMiS3MnaVe2c82kk9xlKHwmTWYu02NoYf0w7/xDbGMmVQvM+SCWYuOFHeyO6k syPpKK8TD896VJm0abJZM/pG4k0v1xjH6ijTjzR+v4eyDQq3nYsJiGTfSzqe+8Yt 4mVg== DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d= messagingengine.com; h=cc:cc:content-transfer-encoding:date:date :feedback-id:feedback-id:from:from:in-reply-to:in-reply-to :message-id:mime-version:references:reply-to:sender:subject :subject:to:to:x-me-proxy:x-me-proxy:x-me-sender:x-me-sender :x-sasl-enc; s=fm1; t=1669300031; x=1669386431; bh=JIb79+/8nYSK3 6fselgk2gecfNdBCsd5WWWk0DkcVac=; b=hItTMvzrM3TCDjRWDvyWzcmA1QnF4 YCTBUYWLaJzqtFNgydX4wfsWvc0kBTmrgwpHOqlAyqRQDpMm2NzksS/TqKB5OX+6 2515OWmR8mJdP/KhTFkLlYyPC7AHJ5lgs4EVm+XBKxvbUThwef79oe9xC6YY09ll j1CATFpUQ5r2mrdyn3khNLhcT/p3Q4+W+xmKBYzuEFx48yrRFOHti/tkqIMmQ1nz mzPJBTpgnUbtBf4yIIhRKs2Og2o39q3f/+FvpEfUzUIHmHfza+qay6JIeDTbG4wj HevVtm1kkDb1zXfZ63lwKxpnuLxpYpG5MCKvlsvz3czdm+SQLLisDmNXw== X-ME-Sender: X-ME-Received: X-ME-Proxy-Cause: gggruggvucftvghtrhhoucdtuddrgedvgedrieefgdeigecutefuodetggdotefrodftvf curfhrohhfihhlvgemucfhrghsthforghilhdpqfgfvfdpuffrtefokffrpgfnqfghnecu uegrihhlohhuthemuceftddtnecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenuc fjughrpefhvfevufffkffojghfggfgsedtkeertdertddtnecuhfhrohhmpefvhhhomhgr shcuofhonhhjrghlohhnuceothhhohhmrghssehmohhnjhgrlhhonhdrnhgvtheqnecugg ftrfgrthhtvghrnhepvdejhfdugeehvddtieejieegteeuudfgjeeukeeiledthfetveek hefhieelhfdtnecuvehluhhsthgvrhfuihiivgeptdenucfrrghrrghmpehmrghilhhfrh homhepthhhohhmrghssehmohhnjhgrlhhonhdrnhgvth X-ME-Proxy: Feedback-ID: i47234305:Fastmail Received: by mail.messagingengine.com (Postfix) with ESMTPA; Thu, 24 Nov 2022 09:27:10 -0500 (EST) From: Thomas Monjalon To: dev@dpdk.org Cc: Ori Kam , Ferruh Yigit , Andrew Rybchenko Subject: [PATCH 2/2] doc: update deprecation notice of flow items Date: Thu, 24 Nov 2022 15:26:59 +0100 Message-Id: <20221124142659.3350953-3-thomas@monjalon.net> X-Mailer: git-send-email 2.36.1 In-Reply-To: <20221124142659.3350953-1-thomas@monjalon.net> References: <20221124142659.3350953-1-thomas@monjalon.net> MIME-Version: 1.0 X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org The flow items are not yet cleaned up in DPDK 22.11 as desired. The plan is updated for this release, with more details. A new plan must be precised during the next release. Signed-off-by: Thomas Monjalon --- doc/guides/rel_notes/deprecation.rst | 37 ++++++++++++++++++++++------ 1 file changed, 29 insertions(+), 8 deletions(-) diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst index 8e4b1c08ff..a780c5b126 100644 --- a/doc/guides/rel_notes/deprecation.rst +++ b/doc/guides/rel_notes/deprecation.rst @@ -55,14 +55,35 @@ Deprecation Notices One solution can be using a fixed size array instead of ``.*MAX.*`` value. * 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. - In v21.02 both individual protocol header fields and the protocol header struct - will be added as union, target is switch usage to the protocol header by time. - In v21.11 LTS, protocol header fields will be cleaned and only protocol header - struct will remain. + should start with relevant protocol header structure from lib/net/. + The individual protocol header fields and the protocol header struct + may be kept together in an union as a first migration step. + + These items are not compliant (not including struct from lib/net/): + + - ``rte_flow_item_ah`` + - ``rte_flow_item_arp_eth_ipv4`` + - ``rte_flow_item_e_tag`` + - ``rte_flow_item_geneve`` + - ``rte_flow_item_geneve_opt`` + - ``rte_flow_item_gre`` + - ``rte_flow_item_gtp`` + - ``rte_flow_item_icmp6`` + - ``rte_flow_item_icmp6_nd_na`` + - ``rte_flow_item_icmp6_nd_ns`` + - ``rte_flow_item_icmp6_nd_opt`` + - ``rte_flow_item_icmp6_nd_opt_sla_eth`` + - ``rte_flow_item_icmp6_nd_opt_tla_eth`` + - ``rte_flow_item_igmp`` + - ``rte_flow_item_ipv6_ext`` + - ``rte_flow_item_l2tpv3oip`` + - ``rte_flow_item_mpls`` + - ``rte_flow_item_nsh`` + - ``rte_flow_item_nvgre`` + - ``rte_flow_item_pfcp`` + - ``rte_flow_item_pppoe`` + - ``rte_flow_item_pppoe_proto_id`` + - ``rte_flow_item_vxlan_gpe`` * ethdev: Queue specific stats fields will be removed from ``struct rte_eth_stats``. Mentioned fields are: ``q_ipackets``, ``q_opackets``, ``q_ibytes``, ``q_obytes``,