From: yufengx.mo@intel.com
To: dts@dpdk.org
Cc: yufengmx <yufengx.mo@intel.com>
Subject: [dts] [PATCH V1 1/2] ethtool_stats: upload test plan
Date: Wed, 6 Jun 2018 13:34:01 +0800 [thread overview]
Message-ID: <1528263242-22459-2-git-send-email-yufengx.mo@intel.com> (raw)
In-Reply-To: <1528263242-22459-1-git-send-email-yufengx.mo@intel.com>
From: yufengmx <yufengx.mo@intel.com>
Currently Ethtool supports a more complete list of stats for the same drivers
that DPDK supports. The idea behind this epic is two fold as following:
1. To achieve metric equivalence with what linux's ethtool provides.
2. To extend the functionality of the xstats API to enable the following options:
## the retrieval of aggregate stats upon request (Top level stats).
## the retrieval of the extended NIC stats.
## grouping of stats logically so they can be retrieved per logical grouping.
## the option to enable/disable the stats groups to retrieve similar to set
private flags in ethtool.
Signed-off-by: yufengmx <yufengx.mo@intel.com>
---
test_plans/ethtool_stats_test_plan.rst | 150 +++++++++++++++++++++++++++++++++
1 file changed, 150 insertions(+)
create mode 100644 test_plans/ethtool_stats_test_plan.rst
diff --git a/test_plans/ethtool_stats_test_plan.rst b/test_plans/ethtool_stats_test_plan.rst
new file mode 100644
index 0000000..9b18b3f
--- /dev/null
+++ b/test_plans/ethtool_stats_test_plan.rst
@@ -0,0 +1,150 @@
+.. Copyright (c) <2010-2018>, Intel Corporation
+ All rights reserved.
+
+ Redistribution and use in source and binary forms, with or without
+ modification, are permitted provided that the following conditions
+ are met:
+
+ - Redistributions of source code must retain the above copyright
+ notice, this list of conditions and the following disclaimer.
+
+ - Redistributions in binary form must reproduce the above copyright
+ notice, this list of conditions and the following disclaimer in
+ the documentation and/or other materials provided with the
+ distribution.
+
+ - Neither the name of Intel Corporation nor the names of its
+ contributors may be used to endorse or promote products derived
+ from this software without specific prior written permission.
+
+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+ FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+ COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+ INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
+ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,
+ STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED
+ OF THE POSSIBILITY OF SUCH DAMAGE.
+
+=============
+Ethtool stats
+=============
+
+This document provides test plan for ethtool stats . This is a simple example
+app featuring packet processing, ethtool is a utility for Linux kernel-based
+operating system for displaying and modifying some parameters of network
+interface controllers (NICs) and their device drivers.
+
+Currently Ethtool supports a more complete list of stats for the same drivers
+that DPDK supports. The idea behind this epic is two fold as following:
+1. To achieve metric equivalence with what linux's ethtool provides.
+2. To extend the functionality of the xstats API to enable the following options:
+ ## the retrieval of aggregate stats upon request (Top level stats).
+ ## the retrieval of the extended NIC stats.
+ ## grouping of stats logically so they can be retrieved per logical grouping.
+ ## the option to enable/disable the stats groups to retrieve similar to set
+ private flags in ethtool.
+
+Prerequisites
+-------------
+
+2xNICs (2 full duplex optical ports per NIC). One on dut, another one on tester,
+link them together. Update two nics' firmware to latest version.
+
+no nic type limitation.
+
+Test cases
+----------
+
+Check port extended statistics parameter after sending packet from peer link port.
+*. bind two ports
+
+ ./usertools/dpdk-devbind.py --bind=igb_uio <pci address 1> <pci address 2>
+
+Test Case 1: xstat command set intergrity (functional)
+======================================================
+check ``dpdk-procinfo`` tool support ``xstats`` command options. These options
+should be included.
+``xstats``
+``xstats-name``
+``xstats-id``
+``xstats-reset``
+
+steps:
+*. boot up ``testpmd``
+
+ ./<target name>/app/testpmd -c 0x600006 -n 4 -- -i --port-topology=loop \
+ --tx-offloads=<0x1fbf or 0x2203f>
+
+*. run ``dpdk-procinfo`` tool
+
+ ./<target name>/app/dpdk-procinfo
+
+*. check ``dpdk-procinfo`` tool output.
+
+Test Case 2: xstat command (functional)
+=======================================
+check if port extended statistics can get right data
+
+steps:
+*. boot up ``testpmd``
+
+ ./<target name>/app/testpmd -c 0x600006 -n 4 -- -i --port-topology=loop \
+ --tx-offloads=<0x1fbf or 0x2203f>
+
+*. send udp packet of 64/72/128/256/512/1024 size to port 0/1
+
+*. run ``dpdk-procinfo`` tool with ``xstats`` option and check if all port
+have a correct data of different size packet
+
+ ./<target name>/app/dpdk-procinfo -- -p 3 --xstats
+
+Test Case 3: xstat-reset command (functional)
+=============================================
+check if port extended statistics can be cleared
+
+steps:
+*. boot up ``testpmd``
+
+ ./<target name>/app/testpmd -c 0x600006 -n 4 -- -i --port-topology=loop \
+ --tx-offloads=<0x1fbf or 0x2203f>
+
+*. send udp packet of 64/72/128/256/512/1024 size to port 0/1
+
+*. run ``dpdk-procinfo`` tool with ``xstats-reset`` option and check if all port
+statistics have been cleared.
+
+ ./<target name>/app/dpdk-procinfo -- -p 3 --xstats-reset
+
+Test Case 4: xstat single statistic (functional)
+================================================
+check if port extended statistic name can be get by statistic id and check
+related data's correctness.
+
+steps:
+*. boot up ``testpmd``
+
+ ./<target name>/app/testpmd -c 0x600006 -n 4 -- -i --port-topology=loop \
+ --tx-offloads=<0x1fbf or 0x2203f>
+
+*. run ``dpdk-procinfo`` tool with ``xstats`` option to get all NIC extended
+statistics parameters of port and use the output display sequence as parameters'
+index in the following search index
+
+ ./<target name>/app/dpdk-procinfo -- -p 3 --xstats
+
+*. send udp packet of 64/72/128/256/512/1024 size to port 0/1
+
+*. run ``dpdk-procinfo`` tool with ``xstats-id`` option to get the statistic
+name corresponding with the index id
+
+ ./<target name>/app/dpdk-procinfo -- -p 3 --xstats-id 0,1,...N
+
+*. run ``dpdk-procinfo`` tool with ``xstats-name`` option to get the statistic
+data corresponding with the statistic name
+
+ ./<target name>/app/dpdk-procinfo -- -p 3 --xstats-name <statistic name>
--
1.9.3
next prev parent reply other threads:[~2018-06-06 5:34 UTC|newest]
Thread overview: 3+ messages / expand[flat|nested] mbox.gz Atom feed top
2018-06-06 5:34 [dts] [PATCH V1 0/2] ethtool_stats: upload suite test plan/automation script yufengx.mo
2018-06-06 5:34 ` yufengx.mo [this message]
2018-06-06 5:34 ` [dts] [PATCH V1 2/2] ethtool_stats: suite automation script yufengx.mo
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=1528263242-22459-2-git-send-email-yufengx.mo@intel.com \
--to=yufengx.mo@intel.com \
--cc=dts@dpdk.org \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
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).