[PATCH] doc: announce inclusive naming function name changes

[PATCH] doc: announce inclusive naming function name changes

[Chaoyong He]

In order to support inclusive naming, some of the functions in
DPDK will need to be renamed. Do this through deprecation process
now for 23.07.

Signed-off-by: Chaoyong He <chaoyong.he@corigine.com>
---
 doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index dcc1ca1696..267a49aa13 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -163,3 +163,15 @@ Deprecation Notices
   The new port library API (functions rte_swx_port_*)
   will gradually transition from experimental to stable status
   starting with DPDK 23.07 release.
+
+* bonding: References to slave will be removed in DPDK 23.11. The following
+  functions will be deprecated in DPDK 23.07, and removed in DPDK 23.11.
+  The old functions:
+  ``rte_eth_bond_8023ad_slave_info``,
+  ``rte_eth_bond_active_slaves_get``,
+  ``rte_eth_bond_slave_add``, ``rte_eth_bond_slave_remove``, and
+  ``rte_eth_bond_slaves_get`` will be replaced by:
+  ``rte_eth_bond_8023ad_member_info``,
+  ``rte_eth_bond_active_members_get``,
+  ``rte_eth_bond_member_add``, ``rte_eth_bond_member_remove``,
+  and ``rte_eth_bond_members_get``.
-- 
2.39.1

Re: [PATCH] doc: announce inclusive naming function name changes

[Ferruh Yigit]

On 5/19/2023 7:33 AM, Chaoyong He wrote:
> In order to support inclusive naming, some of the functions in
> DPDK will need to be renamed. Do this through deprecation process
> now for 23.07.
> 
> Signed-off-by: Chaoyong He <chaoyong.he@corigine.com>
> ---
>  doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index dcc1ca1696..267a49aa13 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -163,3 +163,15 @@ Deprecation Notices
>    The new port library API (functions rte_swx_port_*)
>    will gradually transition from experimental to stable status
>    starting with DPDK 23.07 release.
> +
> +* bonding: References to slave will be removed in DPDK 23.11. The following
> +  functions will be deprecated in DPDK 23.07, and removed in DPDK 23.11.
> +  The old functions:
> +  ``rte_eth_bond_8023ad_slave_info``,
> +  ``rte_eth_bond_active_slaves_get``,
> +  ``rte_eth_bond_slave_add``, ``rte_eth_bond_slave_remove``, and
> +  ``rte_eth_bond_slaves_get`` will be replaced by:
> +  ``rte_eth_bond_8023ad_member_info``,
> +  ``rte_eth_bond_active_members_get``,
> +  ``rte_eth_bond_member_add``, ``rte_eth_bond_member_remove``,
> +  and ``rte_eth_bond_members_get``.

Acked-by: Ferruh Yigit <ferruh.yigit@amd.com>

Re: [PATCH] doc: announce inclusive naming function name changes

[Stephen Hemminger]

On Fri, 19 May 2023 14:33:34 +0800
Chaoyong He <chaoyong.he@corigine.com> wrote:

> In order to support inclusive naming, some of the functions in
> DPDK will need to be renamed. Do this through deprecation process
> now for 23.07.
> 
> Signed-off-by: Chaoyong He <chaoyong.he@corigine.com>

Acked-by: Stephen Hemminger <stephen@networkplumber.org>

Re: [PATCH] doc: announce inclusive naming function name changes

[Tyler Retzlaff]

On Fri, May 19, 2023 at 02:33:34PM +0800, Chaoyong He wrote:
> In order to support inclusive naming, some of the functions in
> DPDK will need to be renamed. Do this through deprecation process
> now for 23.07.
> 
> Signed-off-by: Chaoyong He <chaoyong.he@corigine.com>
> ---

Acked-by: Tyler Retzlaff <roretzla@linux.microsoft.com>

RE: [PATCH] doc: announce inclusive naming function name changes

[Xia, Chenbo]

> -----Original Message-----
> From: Chaoyong He <chaoyong.he@corigine.com>
> Sent: Friday, May 19, 2023 2:34 PM
> To: dev@dpdk.org
> Cc: oss-drivers@corigine.com; niklas.soderlund@corigine.com; Chaoyong He
> <chaoyong.he@corigine.com>
> Subject: [PATCH] doc: announce inclusive naming function name changes
> 
> In order to support inclusive naming, some of the functions in
> DPDK will need to be renamed. Do this through deprecation process
> now for 23.07.
> 
> Signed-off-by: Chaoyong He <chaoyong.he@corigine.com>
> ---
>  doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++
>  1 file changed, 12 insertions(+)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst
> b/doc/guides/rel_notes/deprecation.rst
> index dcc1ca1696..267a49aa13 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -163,3 +163,15 @@ Deprecation Notices
>    The new port library API (functions rte_swx_port_*)
>    will gradually transition from experimental to stable status
>    starting with DPDK 23.07 release.
> +
> +* bonding: References to slave will be removed in DPDK 23.11. The
> following
> +  functions will be deprecated in DPDK 23.07, and removed in DPDK 23.11.
> +  The old functions:
> +  ``rte_eth_bond_8023ad_slave_info``,
> +  ``rte_eth_bond_active_slaves_get``,
> +  ``rte_eth_bond_slave_add``, ``rte_eth_bond_slave_remove``, and
> +  ``rte_eth_bond_slaves_get`` will be replaced by:
> +  ``rte_eth_bond_8023ad_member_info``,
> +  ``rte_eth_bond_active_members_get``,
> +  ``rte_eth_bond_member_add``, ``rte_eth_bond_member_remove``,
> +  and ``rte_eth_bond_members_get``.
> --
> 2.39.1

Acked-by: Chenbo Xia <chenbo.xia@intel.com> 

Re: [PATCH] doc: announce inclusive naming function name changes

[Stephen Hemminger]

On Fri, 19 May 2023 14:33:34 +0800
Chaoyong He <chaoyong.he@corigine.com> wrote:

> In order to support inclusive naming, some of the functions in
> DPDK will need to be renamed. Do this through deprecation process
> now for 23.07.
> 
> Signed-off-by: Chaoyong He <chaoyong.he@corigine.com>

Can this please get merged for 23.07, sufficient ACK's

[PATCH] doc: announce inclusive naming function name changes

[Stephen Hemminger]

In order to suppor inclusive naming, some of the functions in
DPDK will need to be renamed. Do this through deprecation
process now for 23.07.

Signed-off-by: Stephen Hemminger <stephen@networkplumber.org>
---
 doc/guides/rel_notes/deprecation.rst | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index dcc1ca169668..bae39ad5ffd4 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -163,3 +163,19 @@ Deprecation Notices
   The new port library API (functions rte_swx_port_*)
   will gradually transition from experimental to stable status
   starting with DPDK 23.07 release.
+
+* mbuf: The function ``rte_mbuf_sanity_check`` will be deprecated in DPDK 23.07
+  and removed in DPDK 23.11. The new function will be ``rte_mbuf_validate``.
+
+* jobstats: The function ``rte_jobstats_abort`` will be deprecated in DPDK 23.07
+  and removed in DPDK 23.11. The new function will be ``rte_jobstats_cancel``.
+
+* bonding: References to slave will be removed in DPDK 23.11. The following
+  functions will be deprecated in DPDK 23.07, and removed in DPDK 23.11.
+  The old functions:
+  ``rte_eth_bond_8023ad_slave_info``, ``rte_eth_bond_active_slaves_get``,
+  ``rte_eth_bond_slave_add``, ``rte_eth_bond_slave_remove``, and
+  ``rte_eth_bond_slaves_get`` will be replaced by:
+  ``rte_eth_bond_8023ad_child_info``, ``rte_eth_bond_active_children_get``,
+  ``rte_eth_bond_child_add``, ``rte_eth_bond_child_remove``,
+  and ``rte_eth_bond_children_get``.
-- 
2.39.2