[dpdk-dev] [PATCH v3] doc: update flow non-cached mode notes

Bing Zhao bingz at mellanox.com
Tue Apr 21 08:08:10 CEST 2020


This patch updates the MLX5 PMD and release notes documentations.
Adding the notes of the behavior change that rte flows organization
is switched into non-cached mode for applications.

Signed-off-by: Bing Zhao <bingz at mellanox.com>
---
v2: update the description in release notes.
v3: update the notes of rte_flow for application.
---
 doc/guides/nics/mlx5.rst               | 13 +++++++++++++
 doc/guides/rel_notes/release_20_05.rst |  2 ++
 2 files changed, 15 insertions(+)

diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst
index 759d0ac..ced5e03 100644
--- a/doc/guides/nics/mlx5.rst
+++ b/doc/guides/nics/mlx5.rst
@@ -1300,6 +1300,19 @@ set, and we should allow to specify zero values as rte_flow parameters for the
 META and MARK items and actions. In the same time zero mask has no meaning and
 should be rejected on validation stage.
 
+Notes for rte_flow
+------------------
+Implementation of flows organization is in non-cached mode. When stopping a
+device, all the flows inserted from application will be considered invalid and
+flushed automatically in the background. After restarting of the device, no
+application's flow exists in the system. All reference pointers to these flows
+held by the application are not valid anymore and should be discarded by the
+application.
+
+The application should recreate the flows as required after device restarting,
+and must not try to destroy or flush the invalid flows after stopping (except
+discarding them).
+
 Notes for testpmd
 -----------------
 
diff --git a/doc/guides/rel_notes/release_20_05.rst b/doc/guides/rel_notes/release_20_05.rst
index bacd4c6..367c5df 100644
--- a/doc/guides/rel_notes/release_20_05.rst
+++ b/doc/guides/rel_notes/release_20_05.rst
@@ -63,6 +63,8 @@ New Features
   * Added support for matching on IPv4 Time To Live and IPv6 Hop Limit.
   * Added support for creating Relaxed Ordering Memory Regions.
   * Added support for jumbo frame size (9K MTU) in Multi-Packet RQ mode.
+  * Flow rules caching removed from the driver for memory saving and
+    correctness according to RTE flow and RTE ethdev.
   * Optimized the memory consumption of flow.
 
 * **Updated the Intel ice driver.**
-- 
1.8.3.1



More information about the dev mailing list