From a02aa826fdb48ba48090c5eff6227a3e1130e9c3 Mon Sep 17 00:00:00 2001 From: Bing Zhao Date: Wed, 22 Apr 2020 23:27:15 +0800 Subject: [PATCH] doc: explicit flow config behaviour in mlx5 guide 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 Acked-by: Ori Kam --- doc/guides/nics/mlx5.rst | 13 +++++++++++++ doc/guides/rel_notes/release_20_05.rst | 1 + 2 files changed, 14 insertions(+) diff --git a/doc/guides/nics/mlx5.rst b/doc/guides/nics/mlx5.rst index 02a9bc2f20..0643592ebe 100644 --- a/doc/guides/nics/mlx5.rst +++ b/doc/guides/nics/mlx5.rst @@ -1317,6 +1317,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 +------------------ + +Flows are not cached in the driver. +When stopping a device port, all the flows created on this port from the +application will be flushed automatically in the background. +After stopping the device port, all flows on this port become invalid and +not represented in the system. +All references to these flows held by the application should be discarded +directly but neither destroyed nor flushed. + +The application should re-create the flows as required after the port restart. + Notes for testpmd ----------------- diff --git a/doc/guides/rel_notes/release_20_05.rst b/doc/guides/rel_notes/release_20_05.rst index 389bdc84f0..fe6c75e0eb 100644 --- a/doc/guides/rel_notes/release_20_05.rst +++ b/doc/guides/rel_notes/release_20_05.rst @@ -141,6 +141,7 @@ New Features * Added support for creating Relaxed Ordering Memory Regions. * Added support for configuring Hairpin queue data buffer size. * Added support for jumbo frame size (9K MTU) in Multi-Packet RQ mode. + * Removed flow rules caching for memory saving and compliance with ethdev API. * Optimized the memory consumption of flow. * Added support for flow aging based on hardware counter. -- 2.20.1