From: Jie Liu <[email protected]> The drv-sw-stats devarg and the software receive statistics xstats that depend on it are no longer supported. Remove the parameter description from the Runtime Configuration section and the corresponding "Receive Software Statistics" subsection under Extended Statistics to keep the documentation consistent.
Cc: [email protected] Cc: [email protected] Signed-off-by: Jie Liu <[email protected]> --- doc/guides/nics/sxe2.rst | 49 ---------------------------------------- 1 file changed, 49 deletions(-) diff --git a/doc/guides/nics/sxe2.rst b/doc/guides/nics/sxe2.rst index c5b400a8ba..d9be5ab693 100644 --- a/doc/guides/nics/sxe2.rst +++ b/doc/guides/nics/sxe2.rst @@ -109,30 +109,6 @@ Runtime Configuration Default value is 3 (count both packets and bytes). -- ``drv-sw-stats`` parameter [int] - - This parameter controls whether per-packet software statistics (SW stats) - are collected in the Rx data path. - - Hardware packet statistic counters may be inaccurate for certain packet types - due to hardware design limitations. - When accuracy of Rx packet classification statistics is critical, - enabling this parameter allows the driver to accumulate statistics in software - as packets are received, providing an alternative statistical path - that bypasses hardware counter inaccuracies. - - - 0: Disable software statistics collection (default). - The basic port statistics (``ipackets``, ``ibytes``) are reported - from the hardware counters. - - 1: Enable software statistics collection. - Per-packet software statistics are accumulated for unicast, - multicast, broadcast, and dropped packets in the Rx data path. - - When enabled, the following extended statistics (xstats) are available: - ``rx_sw_unicast_packets``, ``rx_sw_multicast_packets``, - ``rx_sw_broadcast_packets``, ``rx_sw_drop_packets``, - and ``rx_sw_drop_bytes``. - - ``no-sched-mode`` parameter [int] This parameter enables non-scheduling mode (no-sched mode). @@ -197,31 +173,6 @@ Runtime Configuration Extended Statistics (xstats) ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ -The PMD provides the following extended statistics (xstats) -for detailed monitoring of receive-side packet classification -and software-level accounting. -The software statistics path is provided as a workaround -for hardware counter inaccuracies on certain packet types --- -it accumulates per-packet statistics directly in the Rx data path, -ensuring that unicast, multicast, broadcast, and drop counts -reflect the actual packets processed by the driver. - -Receive Software Statistics - These counters are collected in the Rx data path - when ``drv-sw-stats=1`` is configured (see the ``drv-sw-stats`` devarg above). - When ``drv-sw-stats`` is disabled (default), these xstats report zero. - - - ``rx_sw_unicast_packets``: Number of unicast packets received. - - ``rx_sw_multicast_packets``: Number of multicast packets received. - - ``rx_sw_broadcast_packets``: Number of broadcast packets received. - - ``rx_sw_drop_packets``: Number of packets dropped in the Rx data path. - - ``rx_sw_drop_bytes``: Number of bytes dropped in the Rx data path. - - When ``drv-sw-stats`` is enabled, the basic counters - ``ipackets`` and ``ibytes`` (from ``rte_eth_stats``) - also reflect the software-accumulated packet and byte counts. - Otherwise, they are reported from hardware counters. - Fnav Flow Engine Statistics The Fnav flow engine statistics type is controlled by the ``fnav-stat-type`` devarg (see above). -- 2.52.0
