[dpdk-dev] [PATCH 0/2] Deprecation notice updates

[dpdk-dev] [PATCH 0/2] Deprecation notice updates

[Bruce Richardson]

Put in deprecation notices in the 20.08 release for changes coming in 20.11.

Bruce Richardson (2):
  doc: add deprecation notice for make build system removal
  doc: add deprecation notice for change of rawdev APIs

 doc/guides/rel_notes/deprecation.rst | 14 ++++++++++++++
 1 file changed, 14 insertions(+)

-- 
2.25.1

[dpdk-dev] [PATCH 1/2] doc: add deprecation notice for make build system removal

[Bruce Richardson]

Add in an official notice that the make build system is being removed in
20.11 and provide a link to instructions on how to build using meson and
ninja instead.

Cc: Thomas Monjalon <thomas@monjalon.net>

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index a58a17946..ead7cbe43 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -11,6 +11,13 @@ here.
 Deprecation Notices
 -------------------
 
+* make: Support for building DPDK with "make" has been deprecated and
+  support will be removed in the 20.11 release. From 20.11 onwards, DPDK
+  should be built using meson and ninja. For basic instructions see the
+  `Quick-start Guide <https://core.dpdk.org/doc/quick-start/>`_ on the
+  website or the `Getting Started Guide
+  <https://doc.dpdk.org/guides/linux_gsg/build_dpdk.html>`_ document.
+
 * meson: The minimum supported version of meson for configuring and building
   DPDK will be increased to v0.47.1 (from 0.41) from DPDK 19.05 onwards. For
   those users with a version earlier than 0.47.1, an updated copy of meson
-- 
2.25.1

[dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs

[Bruce Richardson]

Add to the documentation for 20.08 a notice about the changes of rawdev
APIs proposed by patchset [1].

[1] http://inbox.dpdk.org/dev/20200709152047.167730-1-bruce.richardson@intel.com/

Cc: Nipun Gupta <nipun.gupta@nxp.com>
Cc: Hemant Agrawal <hemant.agrawal@nxp.com>

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index ead7cbe43..21b00103e 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -117,6 +117,13 @@ Deprecation Notices
   break the ABI checks, that is why change is planned for 20.11.
   The list of internal APIs are mainly ones listed in ``rte_ethdev_driver.h``.
 
+* rawdev: The rawdev APIs which take a device-specific structure as
+  parameter directly, or indirectly via a "private" pointer inside another
+  structure, will be modified to take an additional parameter of the
+  structure size. The affected APIs will include ``rte_rawdev_info_get``,
+  ``rte_rawdev_configure``, ``rte_rawdev_queue_conf_get`` and
+  ``rte_rawdev_queue_setup``.
+
 * traffic manager: All traffic manager API's in ``rte_tm.h`` were mistakenly made
   ABI stable in the v19.11 release. The TM maintainer and other contributors have
   agreed to keep the TM APIs as experimental in expectation of additional spec
-- 
2.25.1

Re: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs

[Hemant Agrawal]

Acked-by: Hemant Agrawal <hemant.agrawal@nxp.com>

-----Original Message-----
From: Bruce Richardson <bruce.richardson@intel.com> 
Sent: Monday, July 13, 2020 6:01 PM
To: dev@dpdk.org
Cc: Bruce Richardson <bruce.richardson@intel.com>; Nipun Gupta <nipun.gupta@nxp.com>; Hemant Agrawal <hemant.agrawal@nxp.com>
Subject: [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs
Importance: High

Add to the documentation for 20.08 a notice about the changes of rawdev APIs proposed by patchset [1].

[1] https://eur01.safelinks.protection.outlook.com/?url=http%3A%2F%2Finbox.dpdk.org%2Fdev%2F20200709152047.167730-1-bruce.richardson%40intel.com%2F&amp;data=02%7C01%7Chemant.agrawal%40nxp.com%7C0f08b692d7e1471fa69908d82728a944%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C637302402871919863&amp;sdata=MfNlKHVOUk%2FRViCJBqSnyJRB%2BnnKpPeViN6OiCb9MJA%3D&amp;reserved=0

Cc: Nipun Gupta <nipun.gupta@nxp.com>
Cc: Hemant Agrawal <hemant.agrawal@nxp.com>

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index ead7cbe43..21b00103e 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -117,6 +117,13 @@ Deprecation Notices
   break the ABI checks, that is why change is planned for 20.11.
   The list of internal APIs are mainly ones listed in ``rte_ethdev_driver.h``.
 
+* rawdev: The rawdev APIs which take a device-specific structure as
+  parameter directly, or indirectly via a "private" pointer inside 
+another
+  structure, will be modified to take an additional parameter of the
+  structure size. The affected APIs will include 
+``rte_rawdev_info_get``,
+  ``rte_rawdev_configure``, ``rte_rawdev_queue_conf_get`` and
+  ``rte_rawdev_queue_setup``.
+
 * traffic manager: All traffic manager API's in ``rte_tm.h`` were mistakenly made
   ABI stable in the v19.11 release. The TM maintainer and other contributors have
   agreed to keep the TM APIs as experimental in expectation of additional spec
--
2.25.1

Re: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs

[Ananyev, Konstantin]

> Add to the documentation for 20.08 a notice about the changes of rawdev
> APIs proposed by patchset [1].
> 
> [1] http://inbox.dpdk.org/dev/20200709152047.167730-1-bruce.richardson@intel.com/
> 
> Cc: Nipun Gupta <nipun.gupta@nxp.com>
> Cc: Hemant Agrawal <hemant.agrawal@nxp.com>
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> ---
>  doc/guides/rel_notes/deprecation.rst | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index ead7cbe43..21b00103e 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -117,6 +117,13 @@ Deprecation Notices
>    break the ABI checks, that is why change is planned for 20.11.
>    The list of internal APIs are mainly ones listed in ``rte_ethdev_driver.h``.
> 
> +* rawdev: The rawdev APIs which take a device-specific structure as
> +  parameter directly, or indirectly via a "private" pointer inside another
> +  structure, will be modified to take an additional parameter of the
> +  structure size. The affected APIs will include ``rte_rawdev_info_get``,
> +  ``rte_rawdev_configure``, ``rte_rawdev_queue_conf_get`` and
> +  ``rte_rawdev_queue_setup``.
> +
>  * traffic manager: All traffic manager API's in ``rte_tm.h`` were mistakenly made
>    ABI stable in the v19.11 release. The TM maintainer and other contributors have
>    agreed to keep the TM APIs as experimental in expectation of additional spec
> --

Acked-by: Konstantin Ananyev <konstantin.ananyev@intel.com

> 2.25.1

Re: [dpdk-dev] [PATCH 1/2] doc: add deprecation notice for make build system removal

[Ferruh Yigit]

On 7/13/2020 1:31 PM, Bruce Richardson wrote:
> Add in an official notice that the make build system is being removed in
> 20.11 and provide a link to instructions on how to build using meson and
> ninja instead.
> 
> Cc: Thomas Monjalon <thomas@monjalon.net>
> 
> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> ---
>  doc/guides/rel_notes/deprecation.rst | 7 +++++++
>  1 file changed, 7 insertions(+)
> 
> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
> index a58a17946..ead7cbe43 100644
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> @@ -11,6 +11,13 @@ here.
>  Deprecation Notices
>  -------------------
>  
> +* make: Support for building DPDK with "make" has been deprecated and
> +  support will be removed in the 20.11 release. From 20.11 onwards, DPDK
> +  should be built using meson and ninja. For basic instructions see the
> +  `Quick-start Guide <https://core.dpdk.org/doc/quick-start/>`_ on the
> +  website or the `Getting Started Guide
> +  <https://doc.dpdk.org/guides/linux_gsg/build_dpdk.html>`_ document.
> +
>  * meson: The minimum supported version of meson for configuring and building
>    DPDK will be increased to v0.47.1 (from 0.41) from DPDK 19.05 onwards. For
>    those users with a version earlier than 0.47.1, an updated copy of meson
> 

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

Re: [dpdk-dev] [PATCH 1/2] doc: add deprecation notice for make build system removal

[Andrew Rybchenko]

On 7/20/20 4:28 PM, Ferruh Yigit wrote:
> On 7/13/2020 1:31 PM, Bruce Richardson wrote:
>> Add in an official notice that the make build system is being removed in
>> 20.11 and provide a link to instructions on how to build using meson and
>> ninja instead.
>>
>> Cc: Thomas Monjalon <thomas@monjalon.net>
>>
>> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
>> ---
>>  doc/guides/rel_notes/deprecation.rst | 7 +++++++
>>  1 file changed, 7 insertions(+)
>>
>> diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
>> index a58a17946..ead7cbe43 100644
>> --- a/doc/guides/rel_notes/deprecation.rst
>> +++ b/doc/guides/rel_notes/deprecation.rst
>> @@ -11,6 +11,13 @@ here.
>>  Deprecation Notices
>>  -------------------
>>  
>> +* make: Support for building DPDK with "make" has been deprecated and
>> +  support will be removed in the 20.11 release. From 20.11 onwards, DPDK
>> +  should be built using meson and ninja. For basic instructions see the
>> +  `Quick-start Guide <https://core.dpdk.org/doc/quick-start/>`_ on the
>> +  website or the `Getting Started Guide
>> +  <https://doc.dpdk.org/guides/linux_gsg/build_dpdk.html>`_ document.
>> +
>>  * meson: The minimum supported version of meson for configuring and building
>>    DPDK will be increased to v0.47.1 (from 0.41) from DPDK 19.05 onwards. For
>>    those users with a version earlier than 0.47.1, an updated copy of meson
>>
> 
> Acked-by: Ferruh Yigit <ferruh.yigit@intel.com>
> 

Acked-by: Andrew Rybchenko <arybchenko@solarflare.com>

Re: [dpdk-dev] [PATCH 1/2] doc: add deprecation notice for make build system removal

[Thomas Monjalon]

20/07/2020 15:38, Andrew Rybchenko:
> On 7/20/20 4:28 PM, Ferruh Yigit wrote:
> > On 7/13/2020 1:31 PM, Bruce Richardson wrote:
> >> Add in an official notice that the make build system is being removed in
> >> 20.11 and provide a link to instructions on how to build using meson and
> >> ninja instead.
> >>
> >> Cc: Thomas Monjalon <thomas@monjalon.net>
> >>
> >> Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
> >> ---
> >> +* make: Support for building DPDK with "make" has been deprecated and
> >> +  support will be removed in the 20.11 release. From 20.11 onwards, DPDK
> >> +  should be built using meson and ninja. For basic instructions see the
> >> +  `Quick-start Guide <https://core.dpdk.org/doc/quick-start/>`_ on the
> >> +  website or the `Getting Started Guide
> >> +  <https://doc.dpdk.org/guides/linux_gsg/build_dpdk.html>`_ document.
> >> +
> > 
> > Acked-by: Ferruh Yigit <ferruh.yigit@intel.com>
> 
> Acked-by: Andrew Rybchenko <arybchenko@solarflare.com>

Acked-by: Thomas Monjalon <thomas@monjalon.net>

Re: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs

[Xu, Rosen]

Hi,

-----Original Message-----
From: dev <dev-bounces@dpdk.org> On Behalf Of Bruce Richardson
Sent: Monday, July 13, 2020 8:31 PM
To: dev@dpdk.org
Cc: Richardson, Bruce <bruce.richardson@intel.com>; Nipun Gupta <nipun.gupta@nxp.com>; Hemant Agrawal <hemant.agrawal@nxp.com>
Subject: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs

Add to the documentation for 20.08 a notice about the changes of rawdev APIs proposed by patchset [1].

[1] http://inbox.dpdk.org/dev/20200709152047.167730-1-bruce.richardson@intel.com/

Cc: Nipun Gupta <nipun.gupta@nxp.com>
Cc: Hemant Agrawal <hemant.agrawal@nxp.com>

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index ead7cbe43..21b00103e 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -117,6 +117,13 @@ Deprecation Notices
   break the ABI checks, that is why change is planned for 20.11.
   The list of internal APIs are mainly ones listed in ``rte_ethdev_driver.h``.
 
+* rawdev: The rawdev APIs which take a device-specific structure as
+  parameter directly, or indirectly via a "private" pointer inside 
+another
+  structure, will be modified to take an additional parameter of the
+  structure size. The affected APIs will include 
+``rte_rawdev_info_get``,
+  ``rte_rawdev_configure``, ``rte_rawdev_queue_conf_get`` and
+  ``rte_rawdev_queue_setup``.
+
 * traffic manager: All traffic manager API's in ``rte_tm.h`` were mistakenly made
   ABI stable in the v19.11 release. The TM maintainer and other contributors have
   agreed to keep the TM APIs as experimental in expectation of additional spec
--
2.25.1

Acked-by: Rosen Xu <rosen.xu@intel.com>

Re: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs

[Hemant Agrawal]

Acked-by: Hemant Agrawal <hemant.agrawal@nxp.com>

-----Original Message-----
From: Xu, Rosen <rosen.xu@intel.com> 
Sent: Thursday, July 23, 2020 7:26 AM
To: Richardson, Bruce <bruce.richardson@intel.com>; dev@dpdk.org
Cc: Richardson, Bruce <bruce.richardson@intel.com>; Nipun Gupta <nipun.gupta@nxp.com>; Hemant Agrawal <hemant.agrawal@nxp.com>
Subject: RE: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs
Importance: High

Hi,

-----Original Message-----
From: dev <dev-bounces@dpdk.org> On Behalf Of Bruce Richardson
Sent: Monday, July 13, 2020 8:31 PM
To: dev@dpdk.org
Cc: Richardson, Bruce <bruce.richardson@intel.com>; Nipun Gupta <nipun.gupta@nxp.com>; Hemant Agrawal <hemant.agrawal@nxp.com>
Subject: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs

Add to the documentation for 20.08 a notice about the changes of rawdev APIs proposed by patchset [1].

[1] https://eur01.safelinks.protection.outlook.com/?url=http%3A%2F%2Finbox.dpdk.org%2Fdev%2F20200709152047.167730-1-bruce.richardson%40intel.com%2F&amp;data=02%7C01%7Chemant.agrawal%40nxp.com%7Cad3a0b27e46648a250d108d82eab80a3%7C686ea1d3bc2b4c6fa92cd99c5c301635%7C0%7C0%7C637310661421942508&amp;sdata=DdzY9DbZwYzLjQasNhDKxxSSpFgbCc%2Foh9NZR1ksuB8%3D&amp;reserved=0

Cc: Nipun Gupta <nipun.gupta@nxp.com>
Cc: Hemant Agrawal <hemant.agrawal@nxp.com>

Signed-off-by: Bruce Richardson <bruce.richardson@intel.com>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index ead7cbe43..21b00103e 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -117,6 +117,13 @@ Deprecation Notices
   break the ABI checks, that is why change is planned for 20.11.
   The list of internal APIs are mainly ones listed in ``rte_ethdev_driver.h``.
 
+* rawdev: The rawdev APIs which take a device-specific structure as
+  parameter directly, or indirectly via a "private" pointer inside 
+another
+  structure, will be modified to take an additional parameter of the
+  structure size. The affected APIs will include 
+``rte_rawdev_info_get``,
+  ``rte_rawdev_configure``, ``rte_rawdev_queue_conf_get`` and
+  ``rte_rawdev_queue_setup``.
+
 * traffic manager: All traffic manager API's in ``rte_tm.h`` were mistakenly made
   ABI stable in the v19.11 release. The TM maintainer and other contributors have
   agreed to keep the TM APIs as experimental in expectation of additional spec
--
2.25.1

Acked-by: Rosen Xu <rosen.xu@intel.com>

Re: [dpdk-dev] [PATCH 0/2] Deprecation notice updates

[Thomas Monjalon]

13/07/2020 14:31, Bruce Richardson:
> Put in deprecation notices in the 20.08 release for changes coming in 20.11.
> 
> Bruce Richardson (2):
>   doc: add deprecation notice for make build system removal
>   doc: add deprecation notice for change of rawdev APIs

Applied, thanks