Add description of new '-secs' parameter in docs. Also, add to NEWS as
it is a user facing change.

Signed-off-by: Kevin Traynor <[email protected]>
---
 Documentation/topics/dpdk/pmd.rst | 23 ++++++++++++++++++-----
 NEWS                              |  3 +++
 2 files changed, 21 insertions(+), 5 deletions(-)

diff --git a/Documentation/topics/dpdk/pmd.rst 
b/Documentation/topics/dpdk/pmd.rst
index b259cc8b3..88457f366 100644
--- a/Documentation/topics/dpdk/pmd.rst
+++ b/Documentation/topics/dpdk/pmd.rst
@@ -102,10 +102,18 @@ core cycles for each Rx queue::
 .. note::
 
-   A history of one minute is recorded and shown for each Rx queue to allow for
-   traffic pattern spikes. Any changes in the Rx queue's PMD core cycles usage,
-   due to traffic pattern or reconfig changes, will take one minute to be fully
-   reflected in the stats.
+   By default a history of one minute is recorded and shown for each Rx queue
+   to allow for traffic pattern spikes. Any changes in the Rx queue's PMD core
+   cycles usage, due to traffic pattern or reconfig changes, will take one
+   minute to be fully reflected in the stats by default.
 
-   .. versionchanged:: 2.6.0
+PMD thread usage of an Rx queue can be displayed for a shorter period of time,
+from the last 5 seconds up to the default 60 seconds in 5 second steps.
+
+To see the port/Rx queue assignment and the last 5 secs of measured usage
+history of PMD core cycles for each Rx queue::
+
+    $ ovs-appctl dpif-netdev/pmd-rxq-show -secs 5
+
+.. versionchanged:: 2.6.0
 
       The ``pmd-rxq-show`` command was added in OVS 2.6.0.
@@ -116,4 +124,9 @@ core cycles for each Rx queue::
    cycles inherently consumed by the OVS PMD processing loop.
 
+.. versionchanged:: 3.1.0
+
+      The ``-secs`` parameter was added to the dpif-netdev/pmd-rxq-show
+      command.
+
 Rx queue to PMD assignment takes place whenever there are configuration changes
 or can be triggered by using::
diff --git a/NEWS b/NEWS
index ff77ee404..ab6834e24 100644
--- a/NEWS
+++ b/NEWS
@@ -24,4 +24,7 @@ Post-v3.0.0
        If a user wishes to benefit from these fixes it is recommended to use
        DPDK 21.11.2.
+   - Userspace datapath:
+     * Add '-secs' argument to appctl 'dpif-netdev/pmd-rxq-show' to show
+       the pmd usage of an Rx queue over a configurable time period.
 
 
-- 
2.37.3

_______________________________________________
dev mailing list
[email protected]
https://mail.openvswitch.org/mailman/listinfo/ovs-dev

Reply via email to