[V1,1/2] test_plans/vf_queue_start_stop: add new vf test_plan
Commit Message
add vf_queue_start_stop_test_plan
Signed-off-by: Lingli Chen <linglix.chen@intel.com>
---
test_plans/index.rst | 1 +
test_plans/vf_queue_start_stop_test_plan.rst | 94 ++++++++++++++++++++
2 files changed, 95 insertions(+)
create mode 100644 test_plans/vf_queue_start_stop_test_plan.rst
Comments
I thinks this is a generic test case, it's not necessary to create a new test suite, add it to iavf test plan is more make sense.
By the way, the title and description of test plan are not align with content.
> -----Original Message-----
> From: Lingli Chen <linglix.chen@intel.com>
> Sent: Thursday, April 13, 2023 2:17 PM
> To: dts@dpdk.org
> Cc: Peng, Yuan <yuan.peng@intel.com>; Chen, LingliX <linglix.chen@intel.com>
> Subject: [dts][PATCH V1 1/2] test_plans/vf_queue_start_stop: add new vf
> test_plan
>
> add vf_queue_start_stop_test_plan
>
> Signed-off-by: Lingli Chen <linglix.chen@intel.com>
> ---
> test_plans/index.rst | 1 +
> test_plans/vf_queue_start_stop_test_plan.rst | 94 ++++++++++++++++++++
> 2 files changed, 95 insertions(+)
> create mode 100644 test_plans/vf_queue_start_stop_test_plan.rst
>
> diff --git a/test_plans/index.rst b/test_plans/index.rst index 2008f50b..7c72d6eb
> 100644
> --- a/test_plans/index.rst
> +++ b/test_plans/index.rst
> @@ -192,6 +192,7 @@ The following are the test plans for the DPDK DTS
> automated test system.
> vf_packet_rxtx_test_plan
> vf_pf_reset_test_plan
> vf_port_start_stop_test_plan
> + vf_queue_start_stop_test_plan
> vf_rss_test_plan
> vf_single_core_perf_test_plan
> vf_smoke_test_plan
> diff --git a/test_plans/vf_queue_start_stop_test_plan.rst
> b/test_plans/vf_queue_start_stop_test_plan.rst
> new file mode 100644
> index 00000000..a1a83450
> --- /dev/null
> +++ b/test_plans/vf_queue_start_stop_test_plan.rst
> @@ -0,0 +1,94 @@
> +.. SPDX-License-Identifier: BSD-3-Clause
> + Copyright(c) 2023 Intel Corporation
> +
> +===========================
> +VF Shutdown API Queue Tests
> +===========================
> +
> +This tests for Shutdown API feature can be run on linux userspace. It
> +will check if NIC vf port can be stopped and restarted without exiting
> +the application process. Furthermore, it will check if it can
> +reconfigure new configurations for a port after the port is stopped,
> +and if it is able to restart with those new configurations. It is based
> +on testpmd application.
> +
> +The test is performed by running the testpmd application and using a
> +traffic generator. Port/queue configurations can be set interactively,
> +and still be set at the command line when launching the application in
> +order to be compatible with previous test framework.
> +
> +Prerequisites
> +-------------
> +
> +Assume port A and B are connected to the remote ports, e.g. packet generator.
> +Get the pci device id of DUT, for example::
> +
> + ./usertools/dpdk-devbind.py -s
> +
> + 0000:af:00.0 'Ethernet Controller XXV710 for 25GbE SFP28 158b'
> + if=enp175s0f0 drv=i40e unused=vfio-pci
> +
> +Generate 1 VF on PF::
> +
> + echo 1 > /sys/bus/pci/devices/0000:af:00.0/sriov_numvfs
> +
> +Bind VFs to dpdk driver::
> +
> + modprobe vfio-pci
> + ./usertools/dpdk-devbind.py -b vfio-pci 0000:af:01.0
> +
> +Test Case: vf queue start/stop
> +------------------------------
> +
> +This case support VF (Intel® Ethernet 700 Series/Intel® Ethernet 800
> +Series)
> +
> +#. Launch testpmd::
> + x86_64-native-linuxapp-gcc/app/dpdk-testpmd -l 1-2 -n 4 -a
> +0000:af:01.0 -- -i --portmask=0x1 --port-topology=loop
> +
> +#. Run "set verbose 1" to set verbose
> +#. Run "set fwd mac" to set fwd type
> +#. Run "start" to start fwd package
> +
> +#. Start a packet capture on the tester in the background::
> + tcpdump -i ens7 'ether[12:2] != 0x88cc' -Q in -w
> +/tmp/tester/sniff_ens7.pcap
> +
> +#. Start packet generator to transmit packets::
> + sendp([Ether(dst='3c:fd:fe:c1:0f:4c',
> +src='00:00:20:00:00:00')/IP()/UDP()/Raw(load=b'XXXXXXXXXXXXXXXXXX')],if
> +ace="ens7",count=4,inter=0,verbose=False)
> +
> +#. Stop testpmd::
> +
> + --------------------- Forward statistics for port 0 ----------------------
> + RX-packets: 4 RX-dropped: 0 RX-total: 4
> + TX-packets: 4 TX-dropped: 0 TX-total: 4
> +
> + ----------------------------------------------------------------------
> + ------
> +
> +#. Quit tcpdump and check tester port receive 4 packets
> +
> +#. Run "port 0 rxq 0 stop" to stop rxq 0 in port 0 #. Start packet
> +generator to transmit and check tester port not receive packets #. Stop
> +testpmd::
> +
> + ---------------------- Forward statistics for port 0 ----------------------
> + RX-packets: 0 RX-dropped: 4 RX-total: 4
> + TX-packets: 0 TX-dropped: 0 TX-total: 0
> +
> + ----------------------------------------------------------------------
> + ------
> +
> +#. Run "port 0 rxq 0 start" to start rxq 0 in port 0 #. Run "port 0 txq
> +0 stop" to stop txq 0 in port 0 #. Start packet generator to transmit
> +and check tester port not receive packets
> + and in testpmd it not has "port 0/queue 0: received 1 packets" print
> +#. Stop testpmd::
> +
> + ---------------------- Forward statistics for port 0 ----------------------
> + RX-packets: 4 RX-dropped: 0 RX-total: 4
> + TX-packets: 0 TX-dropped: 0 TX-total: 0
> +
> + ----------------------------------------------------------------------
> + ------
> +
> +#. Run "port 0 txq 0 start" to start txq 0 in port 0 #. Start packet
> +generator to transmit and check tester port receive 4 packets
> + and in testpmd it has "port 0/queue 0: received 1 packets" print #.
> +Stop testpmd::
> +
> + ---------------------- Forward statistics for port 0 ----------------------
> + RX-packets: 4 RX-dropped: 0 RX-total: 4
> + TX-packets: 4 TX-dropped: 0 TX-total: 4
> +
> + ----------------------------------------------------------------------
> + ------
> --
> 2.17.1
@@ -192,6 +192,7 @@ The following are the test plans for the DPDK DTS automated test system.
vf_packet_rxtx_test_plan
vf_pf_reset_test_plan
vf_port_start_stop_test_plan
+ vf_queue_start_stop_test_plan
vf_rss_test_plan
vf_single_core_perf_test_plan
vf_smoke_test_plan
new file mode 100644
@@ -0,0 +1,94 @@
+.. SPDX-License-Identifier: BSD-3-Clause
+ Copyright(c) 2023 Intel Corporation
+
+===========================
+VF Shutdown API Queue Tests
+===========================
+
+This tests for Shutdown API feature can be run on linux userspace. It
+will check if NIC vf port can be stopped and restarted without exiting the
+application process. Furthermore, it will check if it can reconfigure
+new configurations for a port after the port is stopped, and if it is
+able to restart with those new configurations. It is based on testpmd
+application.
+
+The test is performed by running the testpmd application and using a
+traffic generator. Port/queue configurations can be set interactively,
+and still be set at the command line when launching the application in
+order to be compatible with previous test framework.
+
+Prerequisites
+-------------
+
+Assume port A and B are connected to the remote ports, e.g. packet generator.
+Get the pci device id of DUT, for example::
+
+ ./usertools/dpdk-devbind.py -s
+
+ 0000:af:00.0 'Ethernet Controller XXV710 for 25GbE SFP28 158b' if=enp175s0f0 drv=i40e unused=vfio-pci
+
+Generate 1 VF on PF::
+
+ echo 1 > /sys/bus/pci/devices/0000:af:00.0/sriov_numvfs
+
+Bind VFs to dpdk driver::
+
+ modprobe vfio-pci
+ ./usertools/dpdk-devbind.py -b vfio-pci 0000:af:01.0
+
+Test Case: vf queue start/stop
+------------------------------
+
+This case support VF (Intel® Ethernet 700 Series/Intel® Ethernet 800 Series)
+
+#. Launch testpmd::
+ x86_64-native-linuxapp-gcc/app/dpdk-testpmd -l 1-2 -n 4 -a 0000:af:01.0 -- -i --portmask=0x1 --port-topology=loop
+
+#. Run "set verbose 1" to set verbose
+#. Run "set fwd mac" to set fwd type
+#. Run "start" to start fwd package
+
+#. Start a packet capture on the tester in the background::
+ tcpdump -i ens7 'ether[12:2] != 0x88cc' -Q in -w /tmp/tester/sniff_ens7.pcap
+
+#. Start packet generator to transmit packets::
+ sendp([Ether(dst='3c:fd:fe:c1:0f:4c', src='00:00:20:00:00:00')/IP()/UDP()/Raw(load=b'XXXXXXXXXXXXXXXXXX')],iface="ens7",count=4,inter=0,verbose=False)
+
+#. Stop testpmd::
+
+ --------------------- Forward statistics for port 0 ----------------------
+ RX-packets: 4 RX-dropped: 0 RX-total: 4
+ TX-packets: 4 TX-dropped: 0 TX-total: 4
+ ----------------------------------------------------------------------------
+
+#. Quit tcpdump and check tester port receive 4 packets
+
+#. Run "port 0 rxq 0 stop" to stop rxq 0 in port 0
+#. Start packet generator to transmit and check tester port not receive packets
+#. Stop testpmd::
+
+ ---------------------- Forward statistics for port 0 ----------------------
+ RX-packets: 0 RX-dropped: 4 RX-total: 4
+ TX-packets: 0 TX-dropped: 0 TX-total: 0
+ ----------------------------------------------------------------------------
+
+#. Run "port 0 rxq 0 start" to start rxq 0 in port 0
+#. Run "port 0 txq 0 stop" to stop txq 0 in port 0
+#. Start packet generator to transmit and check tester port not receive packets
+ and in testpmd it not has "port 0/queue 0: received 1 packets" print
+#. Stop testpmd::
+
+ ---------------------- Forward statistics for port 0 ----------------------
+ RX-packets: 4 RX-dropped: 0 RX-total: 4
+ TX-packets: 0 TX-dropped: 0 TX-total: 0
+ ----------------------------------------------------------------------------
+
+#. Run "port 0 txq 0 start" to start txq 0 in port 0
+#. Start packet generator to transmit and check tester port receive 4 packets
+ and in testpmd it has "port 0/queue 0: received 1 packets" print
+#. Stop testpmd::
+
+ ---------------------- Forward statistics for port 0 ----------------------
+ RX-packets: 4 RX-dropped: 0 RX-total: 4
+ TX-packets: 4 TX-dropped: 0 TX-total: 4
+ ----------------------------------------------------------------------------