test suite reviews and discussions
 help / color / mirror / Atom feed
From: Yinan <yinan.wang@intel.com>
To: dts@dpdk.org
Cc: Wang Yinan <yinan.wang@intel.com>
Subject: [dts] [PATCH v1] test_plans: add ntb test cases
Date: Fri, 20 Dec 2019 05:32:44 +0000	[thread overview]
Message-ID: <20191220053244.79055-1-yinan.wang@intel.com> (raw)

From: Wang Yinan <yinan.wang@intel.com>

Add ntb cases in ntb_test_plan.rst

Signed-off-by: Wang Yinan <yinan.wang@intel.com>
---
 test_plans/ntb_test_plan.rst | 257 +++++++++++++++++++++++++++++++++++
 1 file changed, 257 insertions(+)
 create mode 100644 test_plans/ntb_test_plan.rst

diff --git a/test_plans/ntb_test_plan.rst b/test_plans/ntb_test_plan.rst
new file mode 100644
index 0000000..5303174
--- /dev/null
+++ b/test_plans/ntb_test_plan.rst
@@ -0,0 +1,257 @@
+.. Copyright (c) <2019>, 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.
+
+==============
+NTB test plan
+==============
+
+The ntb sample application shows how to use ntb rawdev driver.
+This sample provides interactive mode to do packet based processing
+between two systems.
+
+This sample supports 4 types of packet forwarding mode.
+
+* ``file-trans``: transmit files between two systems. The sample will
+  be polling to receive files from the peer and save the file as
+  ``ntb_recv_file[N]``, [N] represents the number of received file.
+* ``rxonly``: NTB receives packets but doesn't transmit them.
+* ``txonly``: NTB generates and transmits packets without receiving any.
+* ``iofwd``: iofwd between NTB device and ethdev.
+ 
+Command-line Options
+--------------------
+
+The application supports the following command-line options.
+
+* ``--buf-size=N``
+
+  Set the data size of the mbufs used to N bytes, where N < 65536.
+  The default value is 2048.
+
+* ``--fwd-mode=mode``
+
+  Set the packet forwarding mode as ``file-trans``, ``txonly``,
+  ``rxonly`` or ``iofwd``.
+
+* ``--nb-desc=N``
+
+  Set number of descriptors of queue as N, namely queue size,
+  where 64 <= N <= 1024. The default value is 1024.
+
+* ``--txfreet=N``
+
+  Set the transmit free threshold of TX rings to N, where 0 <= N <=
+  the value of ``--nb-desc``. The default value is 256.
+
+* ``--burst=N``
+
+  Set the number of packets per burst to N, where 1 <= N <= 32.
+  The default value is 32.
+
+* ``--qp=N``
+
+  Set the number of queues as N, where qp > 0.
+
+Using the application
+----------------------
+
+The application is console-driven using the cmdline DPDK interface:
+ From this interface the available commands and descriptions of what
+ they do as as follows:
+ 
+* ``send [filepath]``: Send file to the peer host. Need to be in
+  file-trans forwarding mode first.
+* ``start``: Start transmission.
+* ``stop``: Stop transmission.
+* ``show/clear port stats``: Show/Clear port stats and throughput.
+* ``set fwd file-trans/rxonly/txonly/iofwd``: Set packet forwarding mode.
+* ``quit``: Exit program.
+
+Test Case1: NTB test with file-trans fwd mode using igb_uio 
+===========================================================
+
+1. Insmod kernel module and bind Non-Transparent Bridge to igb_uio driver on two host machines separately::
+
+    insmod x86_64-native-linuxapp-gcc/kmod/igb_uio.ko wc_activate=1
+    ./usertools/dpdk-devbind.py -b igb_uio ae:00.0
+
+2. Launch ntb_fwd sample on Machine1::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --buf-size=65407
+    >set fwd file-trans
+
+3. Launch ntb_fwd sample on Machine2::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --buf-size=65407
+    >set fwd file-trans
+
+4. Send file from Machine1::
+
+    >send xxx  # [xxx] is srouce absolute path + file
+
+5. Check file can be received on Machine2 fixed path.
+
+Test Case2: NTB test with file-trans fwd mode using vfio-pci
+============================================================
+
+1. Insmod kernel module and bind Non-Transparent Bridge to vfio-pci driver on two host machines separately::
+
+    insmod x86_64-native-linuxapp-gcc/kmod/igb_uio.ko
+    insmod vfio-pci
+    lspci -vv -s ae:00.0
+    echo "base=0x39bfa0000000 size=0x400000 type=write-combining" >> /proc/mtrr
+    echo "base=0x39bfa0000000 size=0x4000000 type=write-combining" >> /proc/mtrr
+    ./usertools/dpdk-devbind.py -b vfio-pci ae:00.0
+
+2. Launch ntb_fwd sample on Machine1::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --buf-size=65407
+    >set fwd file-trans
+
+3. Launch ntb_fwd sample on Machine2::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --buf-size=65407
+    >set fwd file-trans
+
+4. Send file from Machine1::
+
+    >send xxx  # [xxx] is srouce absolute path + file
+
+5. Check file can be received on Machine2 fixed path.
+
+Test Case3: NTB test with rxonly/txonly fwd mode using igb_uio
+==============================================================
+
+1. Insmod kernel module and bind Non-Transparent Bridge to igb_uio driver on two host machines separately::
+
+    insmod x86_64-native-linuxapp-gcc/kmod/igb_uio.ko wc_activate=1
+    ./usertools/dpdk-devbind.py -b igb_uio ae:00.0
+
+2. Launch ntb_fwd sample on Machine1::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --buf-size=65407
+    >set fwd rxonly
+    >start
+    >show port stats
+
+3. Launch ntb_fwd sample on Machine2::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --buf-size=65407
+    >set fwd txonly
+    >start
+    >show port stats
+
+4. Check throughput with log info on two machines.
+
+Test Case4: NTB test with rxonly/txonly fwd mode using vfio-pci
+==============================================================
+
+1. Insmod kernel module and bind Non-Transparent Bridge to vfio-pci driver on two host machines separately::
+
+    insmod x86_64-native-linuxapp-gcc/kmod/igb_uio.ko
+    insmod vfio-pci
+    lspci -vv -s ae:00.0
+    echo "base=0x39bfa0000000 size=0x400000 type=write-combining" >> /proc/mtrr
+    echo "base=0x39bfa0000000 size=0x4000000 type=write-combining" >> /proc/mtrr
+    ./usertools/dpdk-devbind.py -b vfio-pci ae:00.0
+
+2. Launch ntb_fwd sample on Machine1::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --buf-size=65407
+    >set fwd rxonly
+    >start
+    >show port stats
+
+3. Launch ntb_fwd sample on Machine2::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --buf-size=65407
+    >set fwd txonly
+    >start
+    >show port stats
+
+4. Check throughput with log info on two machines.
+
+Test Case5: NTB test with io fwd mode using igb_uio
+===================================================
+Test flow: TG <-> NIC1 <-> NTB1 <-> NTB2 <-> NIC2 <-> TG
+
+1. Insmod kernel module and bind Non-Transparent Bridge and NIC to igb_uio driver on two host machines separately::
+
+    insmod x86_64-native-linuxapp-gcc/kmod/igb_uio.ko wc_activate=1
+    ./usertools/dpdk-devbind.py -b igb_uio xx:xx.x    # xx:xx.x is NTB
+    ./usertools/dpdk-devbind.py -b igb_uio xx:xx.x    # xx:xx.x is NIC
+
+2. Launch ntb_fwd sample on Machine1::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --fwd-mode=iofwd --burst=32
+    >set fwd iofwd 
+    >start
+    >show port stats
+
+3. Launch ntb_fwd sample on Machine2::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --fwd-mode=iofwd --burst=32
+    >set fwd iofwd
+    >start
+    >show port stats
+
+4. Check throughput with log info on two machines.
+
+Test Case6: NTB test with io fwd mode using vfio-pci
+====================================================
+Test flow: TG <-> NIC1 <-> NTB1 <-> NTB2 <-> NIC2 <-> TG
+
+1. Insmod kernel module and bind Non-Transparent Bridge and NIC to vfio-pci driver on two host machines separately::
+
+    insmod x86_64-native-linuxapp-gcc/kmod/vfio-pci.ko
+    insmod vfio-pci
+    lspci -vv -s ae:00.0
+    echo "base=0x39bfa0000000 size=0x400000 type=write-combining" >> /proc/mtrr
+    echo "base=0x39bfa0000000 size=0x4000000 type=write-combining" >> /proc/mtrr
+    ./usertools/dpdk-devbind.py -b vfio-pci xx:xx.x    # xx:xx.x is NTB
+    ./usertools/dpdk-devbind.py -b vfio-pci xx:xx.x    # xx:xx.x is NIC
+
+2. Launch ntb_fwd sample on Machine1::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --fwd-mode=iofwd --burst=32
+    >set fwd iofwd 
+    >start
+    >show port stats
+
+3. Launch ntb_fwd sample on Machine2::
+
+    ./examples/ntb/build/ntb_fwd -l 28-32 -n 6 -- -i --fwd-mode=iofwd --burst=32
+    >set fwd iofwd
+    >start
+    >show port stats
+
+4. Check throughput with log info on two machines.
\ No newline at end of file
-- 
2.17.1


             reply	other threads:[~2019-12-20 12:37 UTC|newest]

Thread overview: 2+ messages / expand[flat|nested]  mbox.gz  Atom feed  top
2019-12-20  5:32 Yinan [this message]
2019-12-27  6:05 ` Tu, Lijuan

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=20191220053244.79055-1-yinan.wang@intel.com \
    --to=yinan.wang@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).