[dpdk-dev] [PATCH 1/2] doc: announce eth queue release callback parameter change

[dpdk-dev] [PATCH 1/2] doc: announce eth queue release callback parameter change

[Xueming Li]

This patch announces the parameter change of eth_queue_release_t
callback API to eth_dev_ops in DPDK v21.11.

[1] mail list discussion:
https://mails.dpdk.org/archives/dev/2021-July/215654.html

Signed-off-by: Xueming Li <xuemingl@nvidia.com>
---
 doc/guides/rel_notes/deprecation.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index d9c0e65921..c38aebe99d 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -131,6 +131,9 @@ Deprecation Notices
   consistent with existing outer header checksum status flag naming, which
   should help in reducing confusion about its usage.
 
+* ethdev: queue release callback parameter will be changed to device and queue
+  ID to align with other queue configureation callback.
+
 * i40e: As there are both i40evf and iavf pmd, the functions of them are
   duplicated. And now more and more advanced features are developed on iavf.
   To keep consistent with kernel driver's name
-- 
2.25.1

[dpdk-dev] [PATCH 2/2] doc: announce eth new offload flag and group field

[Xueming Li]

To support shared Rx queue, this patch announces new offload flag
RTE_ETH_RX_OFFLOAD_SHARED_RXQ and new shared_group field to struct
rte_eth_rxconf in DPDK v21.11.

[1] mail list discussion:
https://mails.dpdk.org/archives/dev/2021-July/215575.html

Signed-off-by: Xueming Li <xuemingl@nvidia.com>
---
 doc/guides/rel_notes/deprecation.rst | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index c38aebe99d..14f1f2dca7 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -131,6 +131,9 @@ Deprecation Notices
   consistent with existing outer header checksum status flag naming, which
   should help in reducing confusion about its usage.
 
+* ethdev: add new Rx queue offload flag ``RTE_ETH_RX_OFFLOAD_SHARED_RXQ`` and
+  ``shared_group`` field to struct rte_eth_rxconf.
+
 * ethdev: queue release callback parameter will be changed to device and queue
   ID to align with other queue configureation callback.
 
-- 
2.25.1

Re: [dpdk-dev] [PATCH 2/2] doc: announce eth new offload flag and group field

[Slava Ovsiienko]

> -----Original Message-----
> From: dev <dev-bounces@dpdk.org> On Behalf Of Xueming Li
> Sent: Monday, August 2, 2021 16:11
> Cc: dev@dpdk.org; Xueming(Steven) Li <xuemingl@nvidia.com>; Ray Kinsella
> <mdr@ashroe.eu>
> Subject: [dpdk-dev] [PATCH 2/2] doc: announce eth new offload flag and
> group field
> 
> To support shared Rx queue, this patch announces new offload flag
> RTE_ETH_RX_OFFLOAD_SHARED_RXQ and new shared_group field to struct
> rte_eth_rxconf in DPDK v21.11.
> 
> [1] mail list discussion:
> https://mails.dpdk.org/archives/dev/2021-July/215575.html
> 
> Signed-off-by: Xueming Li <xuemingl@nvidia.com>

We need this change to handle shared queues - the same queue
object can be shared by multiple ports, and releasing routine should
know exactly on which port_id/queue_id  object is being released.

Acked-by: Viacheslav Ovsiienko <viacheslavo@nvidia.com>

Re: [dpdk-dev] [PATCH 1/2] doc: announce eth queue release callback parameter change

[Andrew Rybchenko]

On 8/2/21 4:10 PM, Xueming Li wrote:
> This patch announces the parameter change of eth_queue_release_t
> callback API to eth_dev_ops in DPDK v21.11.
> 
> [1] mail list discussion:
> https://mails.dpdk.org/archives/dev/2021-July/215654.html
> 
> Signed-off-by: Xueming Li <xuemingl@nvidia.com>
> ---
>   doc/guides/rel_notes/deprecation.rst | 3 +++
>   1 file changed, 3 insertions(+)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index d9c0e65921..c38aebe99d 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -131,6 +131,9 @@ Deprecation Notices
>     consistent with existing outer header checksum status flag naming, which
>     should help in reducing confusion about its usage.
>   
> +* ethdev: queue release callback parameter will be changed to device and queue
> +  ID to align with other queue configureation callback.
> +
>   * i40e: As there are both i40evf and iavf pmd, the functions of them are
>     duplicated. And now more and more advanced features are developed on iavf.
>     To keep consistent with kernel driver's name
> 

Isn't it an internal callback and no deprecation notice required to
change it?

"to align with" is a bit weak justification that so huge change is
required (really many sources must be fixed). I guess it could be
required for shared RxQ. If so, it should be mentioned.

Re: [dpdk-dev] [PATCH 2/2] doc: announce eth new offload flag and group field

[Andrew Rybchenko]

On 8/4/21 11:08 AM, Slava Ovsiienko wrote:
>> -----Original Message-----
>> From: dev <dev-bounces@dpdk.org> On Behalf Of Xueming Li
>> Sent: Monday, August 2, 2021 16:11
>> Cc: dev@dpdk.org; Xueming(Steven) Li <xuemingl@nvidia.com>; Ray Kinsella
>> <mdr@ashroe.eu>
>> Subject: [dpdk-dev] [PATCH 2/2] doc: announce eth new offload flag and
>> group field
>>
>> To support shared Rx queue, this patch announces new offload flag
>> RTE_ETH_RX_OFFLOAD_SHARED_RXQ and new shared_group field to struct
>> rte_eth_rxconf in DPDK v21.11.
>>
>> [1] mail list discussion:
>> https://mails.dpdk.org/archives/dev/2021-July/215575.html
>>
>> Signed-off-by: Xueming Li <xuemingl@nvidia.com>
> 
> We need this change to handle shared queues - the same queue
> object can be shared by multiple ports, and releasing routine should
> know exactly on which port_id/queue_id  object is being released.
> 
> Acked-by: Viacheslav Ovsiienko <viacheslavo@nvidia.com>
> 

Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>

Re: [dpdk-dev] [PATCH 1/2] doc: announce eth queue release callback parameter change

[Xueming(Steven) Li]

> -----Original Message-----
> From: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
> Sent: Wednesday, August 4, 2021 8:28 PM
> To: Xueming(Steven) Li <xuemingl@nvidia.com>
> Cc: dev@dpdk.org; Ray Kinsella <mdr@ashroe.eu>
> Subject: Re: [dpdk-dev] [PATCH 1/2] doc: announce eth queue release callback parameter change
> 
> On 8/2/21 4:10 PM, Xueming Li wrote:
> > This patch announces the parameter change of eth_queue_release_t
> > callback API to eth_dev_ops in DPDK v21.11.
> >
> > [1] mail list discussion:
> > https://mails.dpdk.org/archives/dev/2021-July/215654.html
> >
> > Signed-off-by: Xueming Li <xuemingl@nvidia.com>
> > ---
> >   doc/guides/rel_notes/deprecation.rst | 3 +++
> >   1 file changed, 3 insertions(+)
> >
> > diff --git a/doc/guides/rel_notes/deprecation.rst
> > b/doc/guides/rel_notes/deprecation.rst
> > index d9c0e65921..c38aebe99d 100644
> > --- a/doc/guides/rel_notes/deprecation.rst
> > +++ b/doc/guides/rel_notes/deprecation.rst
> > @@ -131,6 +131,9 @@ Deprecation Notices
> >     consistent with existing outer header checksum status flag naming, which
> >     should help in reducing confusion about its usage.
> >
> > +* ethdev: queue release callback parameter will be changed to device
> > +and queue
> > +  ID to align with other queue configureation callback.
> > +
> >   * i40e: As there are both i40evf and iavf pmd, the functions of them are
> >     duplicated. And now more and more advanced features are developed on iavf.
> >     To keep consistent with kernel driver's name
> >
> 
> Isn't it an internal callback and no deprecation notice required to change it?

Agree, let's drop this deprecation notice. Thanks for pointing this out.

> 
> "to align with" is a bit weak justification that so huge change is required (really many sources must be fixed). I guess it could be
> required for shared RxQ. If so, it should be mentioned.

Re: [dpdk-dev] [PATCH 2/2] doc: announce eth new offload flag and group field

[Jerin Jacob]

On Wed, Aug 4, 2021 at 5:59 PM Andrew Rybchenko
<andrew.rybchenko@oktetlabs.ru> wrote:
>
> On 8/4/21 11:08 AM, Slava Ovsiienko wrote:
> >> -----Original Message-----
> >> From: dev <dev-bounces@dpdk.org> On Behalf Of Xueming Li
> >> Sent: Monday, August 2, 2021 16:11
> >> Cc: dev@dpdk.org; Xueming(Steven) Li <xuemingl@nvidia.com>; Ray Kinsella
> >> <mdr@ashroe.eu>
> >> Subject: [dpdk-dev] [PATCH 2/2] doc: announce eth new offload flag and
> >> group field
> >>
> >> To support shared Rx queue, this patch announces new offload flag
> >> RTE_ETH_RX_OFFLOAD_SHARED_RXQ and new shared_group field to struct
> >> rte_eth_rxconf in DPDK v21.11.
> >>
> >> [1] mail list discussion:
> >> https://mails.dpdk.org/archives/dev/2021-July/215575.html
> >>
> >> Signed-off-by: Xueming Li <xuemingl@nvidia.com>
> >
> > We need this change to handle shared queues - the same queue
> > object can be shared by multiple ports, and releasing routine should
> > know exactly on which port_id/queue_id  object is being released.
> >
> > Acked-by: Viacheslav Ovsiienko <viacheslavo@nvidia.com>
> >
>
> Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>

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

Re: [dpdk-dev] [PATCH 2/2] doc: announce eth new offload flag and group field

[Thomas Monjalon]

> > >> To support shared Rx queue, this patch announces new offload flag
> > >> RTE_ETH_RX_OFFLOAD_SHARED_RXQ and new shared_group field to struct
> > >> rte_eth_rxconf in DPDK v21.11.
> > >>
> > >> [1] mail list discussion:
> > >> https://mails.dpdk.org/archives/dev/2021-July/215575.html
> > >>
> > >> Signed-off-by: Xueming Li <xuemingl@nvidia.com>
> > >
> > > We need this change to handle shared queues - the same queue
> > > object can be shared by multiple ports, and releasing routine should
> > > know exactly on which port_id/queue_id  object is being released.
> > >
> > > Acked-by: Viacheslav Ovsiienko <viacheslavo@nvidia.com>
> > Acked-by: Andrew Rybchenko <andrew.rybchenko@oktetlabs.ru>
> Acked-by: Jerin Jacob <jerinj@marvell.com>

Applied, thanks.