DPDK patches and discussions
 help / color / mirror / Atom feed
* [dpdk-dev] [PATCH] docs: add statistics read frequency to fm10k guide
@ 2016-02-08 15:42 Harry van Haaren
  2016-02-08 16:00 ` Thomas Monjalon
  2016-02-09 15:19 ` [dpdk-dev] [PATCH v2] " Harry van Haaren
  0 siblings, 2 replies; 11+ messages in thread
From: Harry van Haaren @ 2016-02-08 15:42 UTC (permalink / raw)
  To: jing.d.chen; +Cc: dev

This patch documents that the statistics of fm10k based NICs must be
read regularly in order to avoid an undetected 32 bit integer-overflow.

Signed-off-by: Harry van Haaren <harry.van.haaren@intel.com>
---
 doc/guides/nics/fm10k.rst            | 16 ++++++++++++++++
 doc/guides/rel_notes/release_2_3.rst |  4 ++++
 2 files changed, 20 insertions(+)

diff --git a/doc/guides/nics/fm10k.rst b/doc/guides/nics/fm10k.rst
index 4206b7f..4250c9e 100644
--- a/doc/guides/nics/fm10k.rst
+++ b/doc/guides/nics/fm10k.rst
@@ -65,3 +65,19 @@ The FM10000 family of NICS support a maximum of a 15K jumbo frame. The value
 is fixed and cannot be changed. So, even when the ``rxmode.max_rx_pkt_len``
 member of ``struct rte_eth_conf`` is set to a value lower than 15364, frames
 up to 15364 bytes can still reach the host interface.
+
+Statistic Polling Frequency
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The FM10000 NICs expose a set of statistics via the PCI BARs. These statistics
+are read from the hardware registers when ``rte_eth_stats_get()`` or
+``rte_eth_xstats_get()`` is called. The packet counting registers are 32 bits
+while the byte counting registers are 48 bits. As a result, the statistics must
+be polled regularly in order to ensure the consistency of the returned reads.
+
+Given the PCIe Gen3 x8, about 50Gbps of traffic can occur. With 64 byte packets
+this gives almost 100 million packets/second, causing 32 bit integer overflow
+after approx 40 seconds. To ensure these overflows are detected and accounted
+for in the statistics, it is necessary to read statistic regularly. It is
+suggested to read stats every 20 seconds, which will gaurantee the statistics
+are accurate.
diff --git a/doc/guides/rel_notes/release_2_3.rst b/doc/guides/rel_notes/release_2_3.rst
index 99de186..f966940 100644
--- a/doc/guides/rel_notes/release_2_3.rst
+++ b/doc/guides/rel_notes/release_2_3.rst
@@ -15,6 +15,10 @@ EAL
 Drivers
 ~~~~~~~
 
+* **FM10K: Statistics Polling Frequency**
+
+  A section has been added to the NIC guide for fm10k about the time
+  between reading statistics and 32 bit packet counter overflows.
 
 Libraries
 ~~~~~~~~~
-- 
2.5.0

^ permalink raw reply	[flat|nested] 11+ messages in thread

end of thread, other threads:[~2016-03-09 17:41 UTC | newest]

Thread overview: 11+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2016-02-08 15:42 [dpdk-dev] [PATCH] docs: add statistics read frequency to fm10k guide Harry van Haaren
2016-02-08 16:00 ` Thomas Monjalon
2016-02-08 16:06   ` Van Haaren, Harry
2016-02-09 15:00   ` Mcnamara, John
2016-02-09 15:19 ` [dpdk-dev] [PATCH v2] " Harry van Haaren
2016-02-22 17:13   ` Mcnamara, John
2016-02-22 17:18   ` Mcnamara, John
2016-02-22 17:40     ` Thomas Monjalon
2016-03-06 22:35   ` Thomas Monjalon
2016-03-08 17:16   ` [dpdk-dev] [PATCH v3] " Harry van Haaren
2016-03-09 17:39     ` Thomas Monjalon

This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for NNTP newsgroup(s).