[dpdk-dev,v1,3/4] doc: announce API change for flow RSS/RAW actions

Message ID 20180214152847.19774-4-adrien.mazarguil@6wind.com (mailing list archive)
State Rejected, archived
Delegated to: Thomas Monjalon
Headers

Checks

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

Commit Message

Adrien Mazarguil Feb. 14, 2018, 3:37 p.m. UTC
  C99-style flexible arrays were a bad idea for this API. This announces a
minor API/ABI change to remove them.

Signed-off-by: Adrien Mazarguil <adrien.mazarguil@6wind.com>
---
 doc/guides/rel_notes/deprecation.rst | 5 +++++
 1 file changed, 5 insertions(+)
  

Patch

diff --git a/doc/guides/rel_notes/deprecation.rst b/doc/guides/rel_notes/deprecation.rst
index 40b76b391..77390ce9f 100644
--- a/doc/guides/rel_notes/deprecation.rst
+++ b/doc/guides/rel_notes/deprecation.rst
@@ -72,3 +72,8 @@  Deprecation Notices
   rte_eth_rss_conf`` due to its limitations. All parameters, including the
   currently missing hash function to use will be made part of ``struct
   rte_flow_action_rss`` directly.
+
+* rte_flow: C99-style flexible arrays in ``struct rte_flow_action_rss`` and
+  ``struct rte_flow_item_raw`` will be replaced by standard pointers to the
+  same data. They proved difficult to use in the field (e.g. no possibility
+  of static initialization) and are unsuitable for C++ applications.