d/numam-dpdk
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

doc: update deprecation notice of flow items

Browse Source 
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 <thomas@monjalon.net>
Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
Acked-by: Ori Kam <orika@nvidia.com>
This commit is contained in:
Thomas Monjalon 2022-11-24 15:20:27 +01:00
parent b66eb8551d
commit d7922db44d
1 changed files with 29 additions and 8 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

37
doc/guides/rel_notes/deprecation.rst
View File

@ -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 a 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``,