Skip to contentSkip to conversation

Deprecation notice updates

PATCH Applied Bruce Richardson 7 participants 11 messages Jul 13, 2020 – Aug 5, 2020

lore
Share & tools
lore
#0 lore raw

cover Deprecation notice updates

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(+)
Signature · 1 line
2.25.1
#1 lore raw

PATCH 1/2 doc: add deprecation notice for make build system removal

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 <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/rel_notes/deprecation.rst +7 -0
index a58a17946..ead7cbe43 100644
@@ -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
Signature · 1 line
2.25.1
Acked-by on v1 1/2
#2 lore raw

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

Quoted 20 lines · 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 <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/rel_notes/deprecation.rst +0 -0
index a58a17946..ead7cbe43 100644
@@ -11,6 +11,13 @@ here.
 Deprecation Notices
 -------------------
 

doc/guides/rel_notes/deprecation.rst here. · line 23

Quoted 10 lines
doc/guides/rel_notes/deprecation.rst +7 -0
+* 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
#3 lore raw

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

Quoted 20 lines · Ferruh Yigit
Quoted 19 lines · 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 <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/rel_notes/deprecation.rst +0 -0
index a58a17946..ead7cbe43 100644
@@ -11,6 +11,13 @@ here.
 Deprecation Notices
 -------------------
 
Quoted 14 lines

doc/guides/rel_notes/deprecation.rst here. · line 23

Quoted 11 lines
doc/guides/rel_notes/deprecation.rst +7 -0
+* 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
#4 lore raw

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

20/07/2020 15:38, Andrew Rybchenko:

Quoted 20 lines · Ferruh Yigit
Quoted 7 lines · Bruce Richardson
Quoted 6 lines

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 <[email protected]>
Quoted 11 lines

doc/guides/rel_notes/deprecation.rst here. · line 20

Quoted 9 lines

---

doc/guides/rel_notes/deprecation.rst +7 -0
+* 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.
+
Quoted 1 line
#5 lore raw

PATCH 2/2 doc: add deprecation notice for change of rawdev APIs

In reply to 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/[email protected]/

Cc Nipun Gupta <[email protected]>
Cc Hemant Agrawal <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/rel_notes/deprecation.rst +7 -0
index ead7cbe43..21b00103e 100644
@@ -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
Signature · 1 line
2.25.1
Acked-by on v1 2/2
#6 lore raw

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

-----Original Message-----
From: Bruce Richardson <[email protected]>
Sent: Monday, July 13, 2020 6:01 PM
To: [email protected]
Cc: Bruce Richardson <[email protected]>; Nipun Gupta <[email protected]>; Hemant Agrawal <[email protected]>
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 <[email protected]>
Cc Hemant Agrawal <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/rel_notes/deprecation.rst +9 -0
index ead7cbe43..21b00103e 100644
@@ -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 on v1 2/2
#7 lore raw

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

In reply to Bruce Richardson
Quoted 23 lines

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/[email protected]/

Cc Nipun Gupta <[email protected]>
Cc Hemant Agrawal <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/rel_notes/deprecation.rst +1 -0
index ead7cbe43..21b00103e 100644
@@ -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

doc/guides/rel_notes/deprecation.rst Deprecation Notices

Quoted 10 lines
doc/guides/rel_notes/deprecation.rst +6 -1
+  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
--
Quoted 1 line

2.25.1

Acked-by on v1 2/2
#8 lore raw

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

In reply to Bruce Richardson

Hi,

-----Original Message-----
From: dev <[email protected]> On Behalf Of Bruce Richardson
Sent: Monday, July 13, 2020 8:31 PM
To: [email protected]
Cc: Richardson, Bruce <[email protected]>; Nipun Gupta <[email protected]>; Hemant Agrawal <[email protected]>
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/[email protected]/

Cc Nipun Gupta <[email protected]>
Cc Hemant Agrawal <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/rel_notes/deprecation.rst +9 -0
index ead7cbe43..21b00103e 100644
@@ -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 Acked-by Rosen Xu
#9 lore raw

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

-----Original Message-----
From: Xu, Rosen <[email protected]>
Sent: Thursday, July 23, 2020 7:26 AM
To: Richardson, Bruce <[email protected]>; [email protected]
Cc: Richardson, Bruce <[email protected]>; Nipun Gupta <[email protected]>; Hemant Agrawal <[email protected]>
Subject: RE: [dpdk-dev] [PATCH 2/2] doc: add deprecation notice for change of rawdev APIs
Importance: High

Hi,

-----Original Message-----
From: dev <[email protected]> On Behalf Of Bruce Richardson
Sent: Monday, July 13, 2020 8:31 PM
To: [email protected]
Cc: Richardson, Bruce <[email protected]>; Nipun Gupta <[email protected]>; Hemant Agrawal <[email protected]>
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 <[email protected]>
Cc Hemant Agrawal <[email protected]>
---
 doc/guides/rel_notes/deprecation.rst | 7 +++++++
 1 file changed, 7 insertions(+)
doc/guides/rel_notes/deprecation.rst +9 -0
index ead7cbe43..21b00103e 100644
@@ -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

#10 lore raw
In reply to Bruce Richardson

13/07/2020 14:31, Bruce Richardson:

Quoted 5 lines

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