From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 44147A00C4 for ; Fri, 7 Oct 2022 13:55:09 +0200 (CEST) Received: from [217.70.189.124] (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 3F1F7400D5; Fri, 7 Oct 2022 13:55:09 +0200 (CEST) Received: from relay5-d.mail.gandi.net (relay5-d.mail.gandi.net [217.70.183.197]) by mails.dpdk.org (Postfix) with ESMTP id 359FD40042; Fri, 7 Oct 2022 13:55:08 +0200 (CEST) Received: (Authenticated sender: i.maximets@ovn.org) by mail.gandi.net (Postfix) with ESMTPSA id 16FC31C000A; Fri, 7 Oct 2022 11:55:00 +0000 (UTC) Message-ID: <96eb4c24-5a2c-98f0-9f27-4445a7f2732e@ovn.org> Date: Fri, 7 Oct 2022 13:55:00 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.2.1 Cc: i.maximets@ovn.org, dev@dpdk.org, stable@dpdk.org, Ajit Khaparde , Rahul Lakkireddy , Hemant Agrawal , Haiyue Wang , John Daley , Guoyang Zhou , "Min Hu (Connor)" , Beilei Xing , Jingjing Wu , Qi Zhang , Rosen Xu , Matan Azrad , Viacheslav Ovsiienko , Liron Himi , Jiawen Wu , Ori Kam Subject: Re: [PATCH] doc: fix support table for ETH and VLAN flow items Content-Language: en-US To: Thomas Monjalon References: <20220316120157.390311-1-i.maximets@ovn.org> <2843961.e9J7NaK4W3@thomas> From: Ilya Maximets In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 7bit X-BeenThere: stable@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: patches for DPDK stable branches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: stable-bounces@dpdk.org On 10/7/22 13:50, Ilya Maximets wrote: > On 9/12/22 12:09, Thomas Monjalon wrote: >> 16/03/2022 13:01, Ilya Maximets: >>> 'has_vlan' attribute is only supported by sfc, mlx5 and cnxk. >>> Other drivers doesn't support it. Most of them (like i40e) just >>> ignore it silently. Some drivers (like mlx4) never had a full >>> support of the eth item even before introduction of 'has_vlan' >>> (mlx4 allows to match on the destination MAC only). >>> >>> Same for the 'has_more_vlan' flag of the vlan item. >>> >>> Changing the support level to 'partial' for all such drivers. >>> This doesn't solve the issue, but at least marks the problematic >>> drivers. >> >> You changed "eth" and "vlan" from "Y" to "P". >> The field "has_vlan" is part of "rte_flow_item_eth", >> and "has_more_vlan" is part of "rte_flow_item_vlan", >> so I agree we need to change both items to "partial support". >> It looks to be a good change, just needs to more explicit, >> adding this kind of explanation about the fields. > > I can add this to the commit message. Should I also add > some note alongside the table in that documentation page? > >> >> We missed this patch in 22.07, let's have some progress quickly. > > It was a busy month + PTO, sorry I didn't get to that patch faster. > >> >>> Some details are available in: >>> https://bugs.dpdk.org/show_bug.cgi?id=958 >> >> About rte_flow_item_eth.{src,dst}, I don't find a deprecation notice >> about it in the history of the file doc/guides/rel_notes/deprecation.rst > > It took some time to find the deprecation notice, but I did find it > in the end. It's in the doc/guides/rel_notes/deprecation.rst, and > it says: > > * 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. > >> This is what we have in the code: >> union { >> struct { >> /* >> * These fields are retained for compatibility. >> * Please switch to the new header field below. >> */ >> struct rte_ether_addr dst; /**< Destination MAC. */ >> struct rte_ether_addr src; /**< Source MAC. */ >> rte_be16_t type; /**< EtherType or TPID. */ >> }; >> struct rte_ether_hdr hdr; >> }; >> >> Do you think we should remove the old fields now? > > From the OVS perspective, we do not care much. OVS is still using > old fields, but it's fairly simple change that we can do while moving > to a new version of DPDK. > > From the perspective of the API clarity, it's probably better to clean > up these structures. There seems to be some outstanding work still though: https://patches.dpdk.org/project/dpdk/patch/20210312110745.31721-1-ivan.malov@oktetlabs.ru/#129161 > > Best regards, Ilya Maximets. > >> >>> Fixes: 09315fc83861 ("ethdev: add VLAN attributes to ethernet and VLAN items") >>> Cc: stable@dpdk.org >>> >>> Signed-off-by: Ilya Maximets >> >> >> >