[dpdk-dev] doc: announce rte_devargs changes in 17.11

Message ID 1501853399-17487-1-git-send-email-gaetan.rivet@6wind.com (mailing list archive)
State Accepted, archived
Headers

Checks

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

Commit Message

Gaëtan Rivet Aug. 4, 2017, 1:29 p.m. UTC
  Signed-off-by: Gaetan Rivet <gaetan.rivet@6wind.com>
---
 doc/guides/rel_notes/deprecation.rst | 12 ++++++++++++
 1 file changed, 12 insertions(+)
  

Comments

Thomas Monjalon Aug. 7, 2017, 11:18 p.m. UTC | #1
04/08/2017 15:29, Gaetan Rivet:
> Signed-off-by: Gaetan Rivet <gaetan.rivet@6wind.com>
> ---
> --- a/doc/guides/rel_notes/deprecation.rst
> +++ b/doc/guides/rel_notes/deprecation.rst
> +* eal: several API and ABI changes are planned for ``rte_devargs`` in v17.11.
> +  The format of device command line parameters will change. The bus will need
> +  to be explicitly stated in the device declaration. The enum ``rte_devtype``
> +  was used to identify a bus and will disappear.
> +  The structure ``rte_devargs`` will change.
> +  The ``rte_devargs_list`` will be made private.
> +  The following functions are deprecated starting from 17.08 and will either be
> +  modified or removed in 17.11:
> +
> +  - ``rte_eal_devargs_add``
> +  - ``rte_eal_devargs_type_count``

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

This kind of change has already been suggested by Jan Blunck:
	http://dpdk.org/ml/archives/dev/2017-July/070729.html
	http://dpdk.org/ml/archives/dev/2017-July/071054.html

It is very important to continue progressing on device syntax and
bus rework during 17.11.

Applied
  

Patch

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 7024c81..9e063f1 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -57,3 +57,15 @@  Deprecation Notices
   be removed in 17.11:
 
   - ``rte_cryptodev_create_vdev``
+
+* eal: several API and ABI changes are planned for ``rte_devargs`` in v17.11.
+  The format of device command line parameters will change. The bus will need
+  to be explicitly stated in the device declaration. The enum ``rte_devtype``
+  was used to identify a bus and will disappear.
+  The structure ``rte_devargs`` will change.
+  The ``rte_devargs_list`` will be made private.
+  The following functions are deprecated starting from 17.08 and will either be
+  modified or removed in 17.11:
+
+  - ``rte_eal_devargs_add``
+  - ``rte_eal_devargs_type_count``