Patch Detail
get:
Show a patch.
patch:
Update a patch.
put:
Update a patch.
GET /api/patches/75352/?format=api
{ "id": 75352, "url": "http://patches.dpdk.org/api/patches/75352/?format=api", "web_url": "http://patches.dpdk.org/project/dts/patch/20200811145834.47151-1-yinan.wang@intel.com/", "project": { "id": 3, "url": "http://patches.dpdk.org/api/projects/3/?format=api", "name": "DTS", "link_name": "dts", "list_id": "dts.dpdk.org", "list_email": "dts@dpdk.org", "web_url": "", "scm_url": "git://dpdk.org/tools/dts", "webscm_url": "http://git.dpdk.org/tools/dts/", "list_archive_url": "https://inbox.dpdk.org/dts", "list_archive_url_format": "https://inbox.dpdk.org/dts/{}", "commit_url_format": "" }, "msgid": "<20200811145834.47151-1-yinan.wang@intel.com>", "list_archive_url": "https://inbox.dpdk.org/dts/20200811145834.47151-1-yinan.wang@intel.com", "date": "2020-08-11T14:58:34", "name": "[v1] test_plans: add vhost_cbdma pvp test plan", "commit_ref": null, "pull_url": null, "state": "superseded", "archived": false, "hash": "932acf7fa725d3085bb7115c38630aa891e0bd49", "submitter": { "id": 1081, "url": "http://patches.dpdk.org/api/people/1081/?format=api", "name": "Wang, Yinan", "email": "yinan.wang@intel.com" }, "delegate": null, "mbox": "http://patches.dpdk.org/project/dts/patch/20200811145834.47151-1-yinan.wang@intel.com/mbox/", "series": [ { "id": 11577, "url": "http://patches.dpdk.org/api/series/11577/?format=api", "web_url": "http://patches.dpdk.org/project/dts/list/?series=11577", "date": "2020-08-11T14:58:34", "name": "[v1] test_plans: add vhost_cbdma pvp test plan", "version": 1, "mbox": "http://patches.dpdk.org/series/11577/mbox/" } ], "comments": "http://patches.dpdk.org/api/patches/75352/comments/", "check": "pending", "checks": "http://patches.dpdk.org/api/patches/75352/checks/", "tags": {}, "related": [], "headers": { "Return-Path": "<dts-bounces@dpdk.org>", "X-Original-To": "patchwork@inbox.dpdk.org", "Delivered-To": "patchwork@inbox.dpdk.org", "Received": [ "from dpdk.org (dpdk.org [92.243.14.124])\n\tby inbox.dpdk.org (Postfix) with ESMTP id 792C4A04D8;\n\tTue, 11 Aug 2020 08:08:11 +0200 (CEST)", "from [92.243.14.124] (localhost [127.0.0.1])\n\tby dpdk.org (Postfix) with ESMTP id 4A1551C01F;\n\tTue, 11 Aug 2020 08:08:11 +0200 (CEST)", "from mga12.intel.com (mga12.intel.com [192.55.52.136])\n by dpdk.org (Postfix) with ESMTP id 450E31C00D\n for <dts@dpdk.org>; Tue, 11 Aug 2020 08:08:09 +0200 (CEST)", "from fmsmga005.fm.intel.com ([10.253.24.32])\n by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384;\n 10 Aug 2020 23:08:08 -0700", "from dpdk-yinan-ntb1.sh.intel.com ([10.67.119.39])\n by fmsmga005.fm.intel.com with ESMTP; 10 Aug 2020 23:08:07 -0700" ], "IronPort-SDR": [ "\n 9dMZY4kI6ES1D8CNT+JMSBG0Ys8CWsfev5A++4rQOkEC2Ztur6Cg0Qo7EYUZimtcGFXi0ge7Rg\n fonkeTYUMojg==", "\n FF5c7qGgm3sCQ9d2zT6aYzcrzvzmCYzKKd6cyyspEgCFcCIhivAFUXnzh46QZ4BzYPZ8C7weyr\n jCzGy0C1UKCw==" ], "X-IronPort-AV": [ "E=McAfee;i=\"6000,8403,9709\"; a=\"133212895\"", "E=Sophos;i=\"5.75,459,1589266800\"; d=\"scan'208\";a=\"133212895\"", "E=Sophos;i=\"5.75,459,1589266800\"; d=\"scan'208\";a=\"495041715\"" ], "X-Amp-Result": "SKIPPED(no attachment in message)", "X-Amp-File-Uploaded": "False", "X-ExtLoop1": "1", "From": "Yinan Wang <yinan.wang@intel.com>", "To": "dts@dpdk.org", "Cc": "root <root@dpdk-yinan-ntb1.sh.intel.com>", "Date": "Tue, 11 Aug 2020 10:58:34 -0400", "Message-Id": "<20200811145834.47151-1-yinan.wang@intel.com>", "X-Mailer": "git-send-email 2.17.1", "Subject": "[dts] [PATCH v1] test_plans: add vhost_cbdma pvp test plan", "X-BeenThere": "dts@dpdk.org", "X-Mailman-Version": "2.1.15", "Precedence": "list", "List-Id": "test suite reviews and discussions <dts.dpdk.org>", "List-Unsubscribe": "<https://mails.dpdk.org/options/dts>,\n <mailto:dts-request@dpdk.org?subject=unsubscribe>", "List-Archive": "<http://mails.dpdk.org/archives/dts/>", "List-Post": "<mailto:dts@dpdk.org>", "List-Help": "<mailto:dts-request@dpdk.org?subject=help>", "List-Subscribe": "<https://mails.dpdk.org/listinfo/dts>,\n <mailto:dts-request@dpdk.org?subject=subscribe>", "Errors-To": "dts-bounces@dpdk.org", "Sender": "\"dts\" <dts-bounces@dpdk.org>" }, "content": "From: root <root@dpdk-yinan-ntb1.sh.intel.com>\n\nSigned-off-by: root <root@dpdk-yinan-ntb1.sh.intel.com>\n---\n test_plans/vhost_cbdma_test_plan.rst | 181 +++++++++++++++++++++++++++\n 1 file changed, 181 insertions(+)\n create mode 100644 test_plans/vhost_cbdma_test_plan.rst", "diff": "diff --git a/test_plans/vhost_cbdma_test_plan.rst b/test_plans/vhost_cbdma_test_plan.rst\nnew file mode 100644\nindex 0000000..f6464a7\n--- /dev/null\n+++ b/test_plans/vhost_cbdma_test_plan.rst\n@@ -0,0 +1,181 @@\n+.. Copyright (c) <2020>, Intel Corporation\n+ All rights reserved.\n+\n+ Redistribution and use in source and binary forms, with or without\n+ modification, are permitted provided that the following conditions\n+ are met:\n+\n+ - Redistributions of source code must retain the above copyright\n+ notice, this list of conditions and the following disclaimer.\n+\n+ - Redistributions in binary form must reproduce the above copyright\n+ notice, this list of conditions and the following disclaimer in\n+ the documentation and/or other materials provided with the\n+ distribution.\n+\n+ - Neither the name of Intel Corporation nor the names of its\n+ contributors may be used to endorse or promote products derived\n+ from this software without specific prior written permission.\n+\n+ THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS\n+ \"AS IS\" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT\n+ LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS\n+ FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE\n+ COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,\n+ INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES\n+ (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\n+ SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)\n+ HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT,\n+ STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)\n+ ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED\n+ OF THE POSSIBILITY OF SUCH DAMAGE.\n+\n+==========================================================\n+DMA-accelerated Tx operations for vhost-user PMD test plan\n+==========================================================\n+\n+Overview\n+--------\n+\n+This feature supports to offload large data movement in vhost enqueue operations\n+from the CPU to the I/OAT device for every queue. Note that I/OAT acceleration\n+is just enabled for split rings now. In addition, a queue can only use one I/OAT\n+device, and I/OAT devices cannot be shared among vhost ports and queues. That is,\n+an I/OAT device can only be used by one queue at a time. DMA devices used by\n+queues are assigned by users; for a queue without assigning a DMA device, the\n+PMD will leverages librte_vhost to perform vhost enqueue operations. Moreover,\n+users cannot enable I/OAT acceleration for live-migration. Large copies are\n+offloaded from the CPU to the DMA engine in an asynchronous manner. The CPU just\n+submits copy jobs to the DMA engine and without waiting for DMA copy completion;\n+there is no CPU intervention during DMA data transfer. By overlapping CPU\n+computation and DMA copy, we can save precious CPU cycles and improve the overall\n+throughput for vhost-user PMD based applications, like OVS. Due to startup overheads\n+associated with DMA engines, small copies are performed by the CPU.\n+\n+We introduce a new vdev parameter to enable DMA acceleration for Tx\n+operations of queues:\n+ - dmas: This parameter is used to specify the assigned DMA device of\n+ a queue.\n+ - dmathr: If packets length >= dmathr, leverage I/OAT device to perform memory copy;\n+ otherwise, leverage librte_vhost to perform memory copy.\n+\n+Here is an example:\n+ $ ./testpmd -c f -n 4 \\\n+ --vdev 'net_vhost0,iface=/tmp/s0,queues=1,dmas=[txq0@80:04.0],dmathr=1024'\n+\n+Test Case 1: PVP Split all path with DMA-accelerated vhost enqueue\n+==================================================================\n+\n+Packet pipeline: \n+================\n+TG --> NIC --> Vhost --> Virtio--> Vhost --> NIC --> TG\n+\n+1. Bind one cbdma port and one nic port to igb_uio, then launch vhost by below command::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 2-3 --file-prefix=vhost --vdev 'net_vhost0,iface=/tmp/s0,queues=1,dmas=[txq0@80:04.0],dmathr=1024' \\\n+ -- -i --nb-cores=1 --txd=1024 --rxd=1024\n+ set fwd mac\n+ start\n+\n+2. Launch virtio-user with inorder mergeable path::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 5-6 --no-pci --file-prefix=virtio \\\n+ --vdev=net_virtio_user0,mac=00:01:02:03:04:05,path=/tmp/s0,mrg_rxbuf=1,in_order=1,queues=1 \\\n+ -- -i --tx-offloads=0x0 --enable-hw-vlan-strip --nb-cores=1 --txd=1024 --rxd=1024\n+ >set fwd mac\n+ >start\n+\n+3. Send packets with packet size [64,1518] from packet generator, check the throughput can get expected data, restart vhost port, then check throughput again::\n+\n+ testpmd>show port stats all\n+ testpmd>stop\n+ testpmd>start\n+ testpmd>show port stats all\n+\n+4. Relaunch virtio-user with mergeable path, then repeat step 3::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 5-6 --no-pci --file-prefix=virtio \\\n+ --vdev=net_virtio_user0,mac=00:01:02:03:04:05,path=/tmp/s0,mrg_rxbuf=1,in_order=0,queues=1 \\\n+ -- -i --tx-offloads=0x0 --enable-hw-vlan-strip --nb-cores=1 --txd=1024 --rxd=1024\n+ >set fwd mac\n+ >start\n+\n+5. Relaunch virtio-user with inorder non-mergeable path, then repeat step 3::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 5-6 --no-pci --file-prefix=virtio \\\n+ --vdev=net_virtio_user0,mac=00:01:02:03:04:05,path=/tmp/s0,mrg_rxbuf=0in_order=1,queues=1 \\\n+ -- -i --tx-offloads=0x0 --enable-hw-vlan-strip --nb-cores=1 --txd=1024 --rxd=1024\n+ >set fwd mac\n+ >start\n+\n+6. Relaunch virtio-user with non-mergeable path, then repeat step 3::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 5-6 --no-pci --file-prefix=virtio \\\n+ --vdev=net_virtio_user0,mac=00:01:02:03:04:05,path=/tmp/s0,mrg_rxbuf=0,in_order=0,queues=1 \\\n+ -- -i --tx-offloads=0x0 --enable-hw-vlan-strip --nb-cores=1 --txd=1024 --rxd=1024\n+ >set fwd mac\n+ >start\n+\n+7. Relaunch virtio-user with vector_rx path, then repeat step 3::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 5-6 --socket-mem 1024,1024 \\\n+ --legacy-mem --no-pci --file-prefix=virtio \\\n+ --vdev=net_virtio_user0,mac=00:01:02:03:04:05,path=/tmp/s0,mrg_rxbuf=0,in_order=0,queues=1 \\\n+ -- -i --nb-cores=1 --txd=1024 --rxd=1024\n+ >set fwd mac\n+ >start\n+\n+Test Case2: Dynamic queue number test for DMA-accelerated vhost Tx operations\n+=============================================================================\n+\n+1. Bind two cbdma port and one nic port to igb_uio, then launch vhost by below command::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 28-29 --socket-mem 1024,1024 --legacy-mem \\\n+ --file-prefix=vhost --vdev 'net_vhost0,iface=/tmp/s0,queues=2,client=1,dmas=[txq0@80:04.5;txq1@80:04.6],dmathr=1024' \\\n+ -- -i --nb-cores=1 --txd=1024 --rxd=1024 --txq=2 --rxq=2\n+ set fwd mac\n+ start\n+\n+2. Launch virtio-user by below ccd ommand::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 30-31 --no-pci --file-prefix=virtio \\\n+ --vdev=net_virtio_user0,mac=00:01:02:03:04:05,path=/tmp/s0,mrg_rxbuf=1,in_order=1,queues=2,server=1 \\\n+ -- -i --tx-offloads=0x0 --enable-hw-vlan-strip --nb-cores=1 --txd=1024 --rxd=1024 --txq=2 --rxq=2\n+ >set fwd mac\n+ >start\n+\n+3. Send packets with packet size [64,1518] from packet generator with random ip, check perforamnce can get target and RX/TX can work normally in two queues.\n+\n+4. On virtio-user side, dynamic change rx queue numbers from 2 queue to 1 queues, then check one queue RX/TX can work normally::\n+\n+ start\n+ stop\n+ port stop all\n+ port config all rxq 1\n+ port start all\n+ start\n+\n+5. Relaunch virtio-user with queues=2, check RX/TX can work normally in two queues::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 30-31 --no-pci --file-prefix=virtio \\\n+ --vdev=net_virtio_user0,mac=00:01:02:03:04:05,path=/tmp/s0,mrg_rxbuf=1,in_order=1,queues=2,server=1 \\\n+ -- -i --tx-offloads=0x0 --enable-hw-vlan-strip --nb-cores=1 --txd=1024 --rxd=1024 --txq=2 --rxq=2\n+ >set fwd mac\n+ >start\n+\n+4. On vhost side, dynamic change rx queue numbers from 2 queue to 1 queues, then check one queue RX/TX can work normally::\n+\n+ start\n+ stop\n+ port stop all\n+ port config all rxq 1\n+ port start all\n+ start\n+\n+6. Relaunch vhost with another two cbdma channels, check perforamnce can get target and RX/TX can work normally in two queueus::\n+\n+ ./x86_64-native-linuxapp-gcc/app/testpmd -n 4 -l 28-29 --socket-mem 1024,1024 --legacy-mem \\\n+ --file-prefix=vhost --vdev 'net_vhost0,iface=/tmp/s0,queues=2,client=1,dmas=[txq0@80:04.0],dmathr=512' \\\n+ -- -i --nb-cores=1 --txd=1024 --rxd=1024 --txq=2 --rxq=2\n+ >set fwd mac\n+ >start\n", "prefixes": [ "v1" ] }