[dpdk-dev] [PATCH] doc: announce deprecation of port mirroring API

[Jerin Jacob]

On Mon, Aug 3, 2020 at 9:03 PM Thomas Monjalon <thomas at monjalon.net> wrote:
>
> A new API is planned to be introduced for sampling and mirroring
> with rte_flow. It should be more generic and allow more use cases.
>
> This deprecation is to show the direction, avoiding overlapping APIs.
>
> Signed-off-by: Thomas Monjalon <thomas at monjalon.net>

Acked-by: Jerin Jacob <jerinj at marvell.com>


> ---
>  doc/guides/rel_notes/deprecation.rst | 6 ++++++
>  1 file changed, 6 insertions(+)
>
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index 6e12e57a13..ca0d8af96a 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -103,6 +103,12 @@ Deprecation Notices
>    Existing ``rte_eth_rx_descriptor_status`` and ``rte_eth_tx_descriptor_status``
>    APIs can be used as replacement.
>
> +* ethdev: The port mirroring API can be replaced with a more fine grain flow API.
> +  The structs ``rte_eth_mirror_conf``, ``rte_eth_vlan_mirror`` and the functions
> +  ``rte_eth_mirror_rule_set``, ``rte_eth_mirror_rule_reset`` will be marked
> +  as deprecated in DPDK 20.11, along with the associated macros ``ETH_MIRROR_*``.
> +  This API will be fully removed in DPDK 21.11.
> +
>  * ethdev: Some internal APIs for driver usage are exported in the .map file.
>    Now DPDK has ``__rte_internal`` marker so we can mark internal APIs and move
>    them to the INTERNAL block in .map. Although these APIs are internal it will
> --
> 2.27.0
>