[V1] doc: announce deprecation of flow item VXLAN-GPE
Checks
Commit Message
Adding the deprecation notice as reminder for removing
RTE_FLOW_ITEM_TYPE_VXLAN_GPE and its related structures,
eg. rte_vxlan_gpe_hdr, rte_flow_item_vxlan_gpe, etc.
The proposed time of the removal is DPDK release 25.11.
Signed-off-by: Gavin Li <gavinl@nvidia.com>
---
doc/guides/rel_notes/deprecation.rst | 7 +++++++
1 file changed, 7 insertions(+)
Comments
On 7/26/2024 9:51 AM, Gavin Li wrote:
> Adding the deprecation notice as reminder for removing
> RTE_FLOW_ITEM_TYPE_VXLAN_GPE and its related structures,
> eg. rte_vxlan_gpe_hdr, rte_flow_item_vxlan_gpe, etc.
>
> The proposed time of the removal is DPDK release 25.11.
>
> Signed-off-by: Gavin Li <gavinl@nvidia.com>
> ---
> 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 6948641ff6..5c04f88557 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -115,6 +115,13 @@ Deprecation Notices
> The legacy actions should be removed
> once ``MODIFY_FIELD`` alternative is implemented in drivers.
>
> + * ethdev,net: The flow item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE`` is replaced with ``RTE_FLOW_ITEM_TYPE_VXLAN``.
> + The struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask`` are replaced with
> + ``rte_flow_item_vxlan and its mask`` and its mask ``rte_flow_item_vxlan_mask``.
> + The item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE``, the struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask``,
> + and the header struct ``rte_vxlan_gpe_hdr`` with the macro ``RTE_ETHER_VXLAN_GPE_HLEN``
> + will be removed in DPDK 25.11.
> +
> * cryptodev: The function ``rte_cryptodev_cb_fn`` will be updated
> to have another parameter ``qp_id`` to return the queue pair ID
> which got error interrupt to the application,
>
Acked-by: Ferruh Yigit <ferruh.yigit@amd.com>
26/07/2024 13:31, Ferruh Yigit:
> On 7/26/2024 9:51 AM, Gavin Li wrote:
> > Adding the deprecation notice as reminder for removing
> > RTE_FLOW_ITEM_TYPE_VXLAN_GPE and its related structures,
> > eg. rte_vxlan_gpe_hdr, rte_flow_item_vxlan_gpe, etc.
> >
> > The proposed time of the removal is DPDK release 25.11.
> >
> > Signed-off-by: Gavin Li <gavinl@nvidia.com>
> > ---
> > --- a/doc/guides/rel_notes/deprecation.rst
> > +++ b/doc/guides/rel_notes/deprecation.rst
> > + * ethdev,net: The flow item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE`` is replaced with ``RTE_FLOW_ITEM_TYPE_VXLAN``.
> > + The struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask`` are replaced with
> > + ``rte_flow_item_vxlan and its mask`` and its mask ``rte_flow_item_vxlan_mask``.
> > + The item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE``, the struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask``,
> > + and the header struct ``rte_vxlan_gpe_hdr`` with the macro ``RTE_ETHER_VXLAN_GPE_HLEN``
> > + will be removed in DPDK 25.11.
>
> Acked-by: Ferruh Yigit <ferruh.yigit@amd.com>
Acked-by: Thomas Monjalon <thomas@monjalon.net>
On Mon, Jul 29, 2024 at 1:48 AM Thomas Monjalon <thomas@monjalon.net> wrote:
>
> 26/07/2024 13:31, Ferruh Yigit:
> > On 7/26/2024 9:51 AM, Gavin Li wrote:
> > > Adding the deprecation notice as reminder for removing
> > > RTE_FLOW_ITEM_TYPE_VXLAN_GPE and its related structures,
> > > eg. rte_vxlan_gpe_hdr, rte_flow_item_vxlan_gpe, etc.
> > >
> > > The proposed time of the removal is DPDK release 25.11.
> > >
> > > Signed-off-by: Gavin Li <gavinl@nvidia.com>
> > > ---
> > > --- a/doc/guides/rel_notes/deprecation.rst
> > > +++ b/doc/guides/rel_notes/deprecation.rst
> > > + * ethdev,net: The flow item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE`` is replaced with ``RTE_FLOW_ITEM_TYPE_VXLAN``.
> > > + The struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask`` are replaced with
> > > + ``rte_flow_item_vxlan and its mask`` and its mask ``rte_flow_item_vxlan_mask``.
> > > + The item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE``, the struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask``,
> > > + and the header struct ``rte_vxlan_gpe_hdr`` with the macro ``RTE_ETHER_VXLAN_GPE_HLEN``
> > > + will be removed in DPDK 25.11.
> >
> > Acked-by: Ferruh Yigit <ferruh.yigit@amd.com>
>
> Acked-by: Thomas Monjalon <thomas@monjalon.net>
Acked-by: Ajit Khaparde <ajit.khaparde@broadcom.com>
>
>
29/07/2024 15:47, Ajit Khaparde:
> On Mon, Jul 29, 2024 at 1:48 AM Thomas Monjalon <thomas@monjalon.net> wrote:
> >
> > 26/07/2024 13:31, Ferruh Yigit:
> > > On 7/26/2024 9:51 AM, Gavin Li wrote:
> > > > Adding the deprecation notice as reminder for removing
> > > > RTE_FLOW_ITEM_TYPE_VXLAN_GPE and its related structures,
> > > > eg. rte_vxlan_gpe_hdr, rte_flow_item_vxlan_gpe, etc.
> > > >
> > > > The proposed time of the removal is DPDK release 25.11.
> > > >
> > > > Signed-off-by: Gavin Li <gavinl@nvidia.com>
> > > > ---
> > > > --- a/doc/guides/rel_notes/deprecation.rst
> > > > +++ b/doc/guides/rel_notes/deprecation.rst
> > > > + * ethdev,net: The flow item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE`` is replaced with ``RTE_FLOW_ITEM_TYPE_VXLAN``.
> > > > + The struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask`` are replaced with
> > > > + ``rte_flow_item_vxlan and its mask`` and its mask ``rte_flow_item_vxlan_mask``.
> > > > + The item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE``, the struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask``,
> > > > + and the header struct ``rte_vxlan_gpe_hdr`` with the macro ``RTE_ETHER_VXLAN_GPE_HLEN``
> > > > + will be removed in DPDK 25.11.
> > >
> > > Acked-by: Ferruh Yigit <ferruh.yigit@amd.com>
> >
> > Acked-by: Thomas Monjalon <thomas@monjalon.net>
> Acked-by: Ajit Khaparde <ajit.khaparde@broadcom.com>
Applied with indent fixed, thanks.
@@ -115,6 +115,13 @@ Deprecation Notices
The legacy actions should be removed
once ``MODIFY_FIELD`` alternative is implemented in drivers.
+ * ethdev,net: The flow item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE`` is replaced with ``RTE_FLOW_ITEM_TYPE_VXLAN``.
+ The struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask`` are replaced with
+ ``rte_flow_item_vxlan and its mask`` and its mask ``rte_flow_item_vxlan_mask``.
+ The item ``RTE_FLOW_ITEM_TYPE_VXLAN_GPE``, the struct ``rte_flow_item_vxlan_gpe``, its mask ``rte_flow_item_vxlan_gpe_mask``,
+ and the header struct ``rte_vxlan_gpe_hdr`` with the macro ``RTE_ETHER_VXLAN_GPE_HLEN``
+ will be removed in DPDK 25.11.
+
* cryptodev: The function ``rte_cryptodev_cb_fn`` will be updated
to have another parameter ``qp_id`` to return the queue pair ID
which got error interrupt to the application,