[dpdk-dev] [PATCH] doc: reduce initial offload API scope to drivers

[Shahaf Shuler]

Hi Ferruh,

Friday, March 16, 2018 5:32 PM, Ferruh Yigit:
> Subject: [PATCH] doc: reduce initial offload API scope to drivers
> 
> 18.05 tagets ethdev-PMD offload API, which means switching all PMDs to
> new offloading API
> 
> Next step targets ethdev-application offload API which means forcing
> applications to switch to new API
> 
> Fixes: 3004d3454192 ("doc: update deprecation of ethdev offload API")
> Cc: shahafs at mellanox.com
> 
> Signed-off-by: Ferruh Yigit <ferruh.yigit at intel.com>
> ---
>  doc/guides/rel_notes/deprecation.rst | 7 ++++++-
>  1 file changed, 6 insertions(+), 1 deletion(-)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst
> b/doc/guides/rel_notes/deprecation.rst
> index 0c696f743..b40c57f28 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -97,8 +97,13 @@ Deprecation Notices
>  * ethdev: a new Tx and Rx offload API was introduced on 17.11.
>    In the new API, offloads are divided into per-port and per-queue offloads.
>    Offloads are disabled by default and enabled per application request.
> -  The old offloads API is target to be deprecated on 18.05. This includes:
> +  The old offloads API between ethdev and drivers is target to be
> deprecated on 18.05.
> +  This includes:
> 
> +  - removal of the conversion in ethdev from new offloading API to old API.

We cannot remove this part before all of the applications has moved to the new API.
The conversion function is to help PMDs to have single control path with no branch for both old and new application. 

> +
> +  In later releases the old offloading API between ethdev and
> + applications will be  deprecated too, which will include:
>    - removal of ``ETH_TXQ_FLAGS_NO*`` flags.
>    - removal of ``txq_flags`` field from ``rte_eth_txconf`` struct.
>    - removal of the offloads bit-field from ``rte_eth_rxmode`` struct.

I am OK with postponing the deprecation to a later release and have the PMDs conversion to the new API in the current/next one. 

> --
> 2.13.6