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

Message ID 20180413212059.137738-1-ferruh.yigit@intel.com (mailing list archive)
State Accepted, archived
Delegated to: Thomas Monjalon
Headers

Checks

Context Check Description
ci/checkpatch success coding style OK
ci/Intel-compilation fail Compilation issues

Commit Message

Ferruh Yigit April 13, 2018, 9:20 p.m. UTC
  Do ethdev new offloading API switch in two steps.

In v18.05 target is implementing the new ethdev-PMD offload interface,
which means converting all PMDs to new offloading API.

Next target is removing the old ethdev offload API.
It will effect applications and will force them to implement new
offloading API.

Fixes: 3004d3454192 ("doc: update deprecation of ethdev offload API")
Cc: shahafs@mellanox.com

Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
---
v2:
* Update commit log and deprecation notice for clarification
---
 doc/guides/rel_notes/deprecation.rst | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)
  

Comments

Shahaf Shuler April 15, 2018, 5:28 a.m. UTC | #1
Saturday, April 14, 2018 12:21 AM, Ferruh Yigit:
> Subject: [PATCH v2] doc: reduce initial offload API scope to drivers
> 
> Do ethdev new offloading API switch in two steps.
> 
> In v18.05 target is implementing the new ethdev-PMD offload interface,
> which means converting all PMDs to new offloading API.
> 
> Next target is removing the old ethdev offload API.
> It will effect applications and will force them to implement new offloading
> API.
> 
> Fixes: 3004d3454192 ("doc: update deprecation of ethdev offload API")
> Cc: shahafs@mellanox.com
> 
> Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
> ---
> v2:
> * Update commit log and deprecation notice for clarification
> ---
>  doc/guides/rel_notes/deprecation.rst | 6 +++++-
>  1 file changed, 5 insertions(+), 1 deletion(-)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst
> b/doc/guides/rel_notes/deprecation.rst
> index c929dcc31..fd9def20c 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -72,8 +72,12 @@ 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 ethdev - drivers offload interface will be deprecated on 18.05.
> +  This includes:
> +  - removal of the conversion in ethdev from new offloading API to old API
> for drivers.
> +
> +  In later releases the old offloading API will be deprecated, 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.
> --
> 2.14.3

Acked-by: Shahaf Shuler <shahafs@mellanox.com>
  
Thomas Monjalon April 15, 2018, 1:14 p.m. UTC | #2
15/04/2018 07:28, Shahaf Shuler:
> Saturday, April 14, 2018 12:21 AM, Ferruh Yigit:
> > Subject: [PATCH v2] doc: reduce initial offload API scope to drivers
> > 
> > Do ethdev new offloading API switch in two steps.
> > 
> > In v18.05 target is implementing the new ethdev-PMD offload interface,
> > which means converting all PMDs to new offloading API.
> > 
> > Next target is removing the old ethdev offload API.
> > It will effect applications and will force them to implement new offloading
> > API.
> > 
> > Fixes: 3004d3454192 ("doc: update deprecation of ethdev offload API")
> > Cc: shahafs@mellanox.com
> > 
> > Signed-off-by: Ferruh Yigit <ferruh.yigit@intel.com>
> > ---
> > v2:
> > * Update commit log and deprecation notice for clarification
> > ---
> 
> Acked-by: Shahaf Shuler <shahafs@mellanox.com>

Applied, thanks
  

Patch

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index c929dcc31..fd9def20c 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -72,8 +72,12 @@  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 ethdev - drivers offload interface will be deprecated on 18.05.
+  This includes:
+  - removal of the conversion in ethdev from new offloading API to old API for drivers.
+
+  In later releases the old offloading API will be deprecated, 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.