From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from dpdk.org (dpdk.org [92.243.14.124]) by inbox.dpdk.org (Postfix) with ESMTP id 53C39A046B for ; Fri, 28 Jun 2019 04:53:12 +0200 (CEST) Received: from [92.243.14.124] (localhost [127.0.0.1]) by dpdk.org (Postfix) with ESMTP id 1F6AD2956; Fri, 28 Jun 2019 04:53:12 +0200 (CEST) Received: from mga04.intel.com (mga04.intel.com [192.55.52.120]) by dpdk.org (Postfix) with ESMTP id 50CC51E2F for ; Fri, 28 Jun 2019 04:53:10 +0200 (CEST) X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga007.fm.intel.com ([10.253.24.52]) by fmsmga104.fm.intel.com with ESMTP/TLS/DHE-RSA-AES256-GCM-SHA384; 27 Jun 2019 19:53:09 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.63,426,1557212400"; d="scan'208";a="164534498" Received: from npg-dpdk-project-yinanwang-1.sh.intel.com ([10.67.110.166]) by fmsmga007.fm.intel.com with ESMTP; 27 Jun 2019 19:53:08 -0700 From: Yinan To: dts@dpdk.org Cc: Wang Yinan Date: Thu, 27 Jun 2019 19:50:13 +0000 Message-Id: <20190627195013.94256-1-yinan.wang@intel.com> X-Mailer: git-send-email 2.17.1 Subject: [dts] [PATCH v1] test_plans: add test plan for dpdk hugetlbfs mount size test X-BeenThere: dts@dpdk.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: test suite reviews and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dts-bounces@dpdk.org Sender: "dts" From: Wang Yinan Signed-off-by: Wang Yinan --- .../dpdk_hugetlbfs_mount_size_test_plan.rst | 129 ++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 test_plans/dpdk_hugetlbfs_mount_size_test_plan.rst diff --git a/test_plans/dpdk_hugetlbfs_mount_size_test_plan.rst b/test_plans/dpdk_hugetlbfs_mount_size_test_plan.rst new file mode 100644 index 0000000..6d0eb88 --- /dev/null +++ b/test_plans/dpdk_hugetlbfs_mount_size_test_plan.rst @@ -0,0 +1,129 @@ +.. Copyright (c) <2016>, 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. + +=========================================== +DPDK Hugetlbfs Mount Size Feature Test Plan +=========================================== + +This feature is to limit DPDK to use the exact size which is the mounted hugepage size. + +Prerequisites +============= + +To test this feature, following options need to pass the the kernel: +hugepagesz=1G hugepages=8 default_hugepagesz=1G + +Test Case 1: default hugepage size w/ and w/o numa +================================================== + +1. Create and mount hugepages:: + + mount -t hugetlbfs hugetlbfs /mnt/huge + +2. Bind one nic port to igb_uio driver, launch testpmd:: + + ./testpmd -c 0x3 -n 4 --huge-dir /mnt/huge --file-prefix=abc -- -i + testpmd>start + +3. Send packet with packet generator, check testpmd could forward packets correctly. + +4. Goto step 2 resart testpmd with numa support:: + + ./testpmd -c 0x3 -n 4 --huge-dir /mnt/huge --file-prefix=abc -- -i --numa + testpmd>start + +5. Send packets with packet generator, make sure testpmd could receive and fwd packets correctly. + +Test Case 2: mount size exactly match total hugepage size with two mount points +=============================================================================== + +1. Create and mount hugepages:: + + mount -t hugetlbfs -o size=4G hugetlbfs /mnt/huge1 + mount -t hugetlbfs -o size=4G hugetlbfs /mnt/huge2 + +2. Bind two nic ports to igb_uio driver, launch testpmd with numactl:: + + numactl --membind=1 ./testpmd -l 31-32 -n 4 --legacy-mem --socket-mem 0,2048 --huge-dir /mnt/huge1 --file-prefix=abc -w 82:00.0 -- -i --socket-num=1 --no-numa + testpmd>start + + numactl --membind=1 ./testpmd -l 33-34 -n 4 --legacy-mem --socket-mem 0,2048 --huge-dir /mnt/huge2 --file-prefix=bcd -w 82:00.1 -- -i --socket-num=1 --no-numa + testpmd>start + +3. Send packets with packet generator, make sure two testpmd could receive and fwd packets correctly. + +Test Case 3: mount size greater than total hugepage size with single mount point +================================================================================ + +1. Create and mount hugepage:: + + mount -t hugetlbfs -o size=9G hugetlbfs /mnt/huge + +2. Bind one nic port to igb_uio driver, launch testpmd:: + + ./testpmd -c 0x3 -n 4 --legacy-mem --huge-dir /mnt/huge --file-prefix=abc -- -i + testpmd>start + +3. Send packets with packet generator, make sure testpmd could receive and fwd packets correctly. + +Test Case 4: mount size greater than total hugepage size with multiple mount points +=================================================================================== + +1. Create and mount hugepage:: + + mount -t hugetlbfs -o size=4G hugetlbfs /mnt/huge1 + mount -t hugetlbfs -o size=4G hugetlbfs /mnt/huge2 + mount -t hugetlbfs -o size=1G hugetlbfs /mnt/huge3 + +2. Bind one nic port to igb_uio driver, launch testpmd:: + + numactl --membind=0 ./testpmd -c 0x3 -n 4 --legacy-mem --socket-mem 2048,0 --huge-dir /mnt/huge1 --file-prefix=abc -- -i --socket-num=0 --no-numa + testpmd>start + + numactl --membind=0 ./testpmd -c 0xc -n 4 --legacy-mem --socket-mem 2048,0 --huge-dir /mnt/huge2 --file-prefix=bcd -- -i --socket-num=0 --no-numa + testpmd>start + + numactl --membind=0 ./testpmd -c 0x30 -n 4 --legacy-mem --socket-mem 1024,0 --huge-dir /mnt/huge3 --file-prefix=fgh -- -i --socket-num=0 --no-numa + testpmd>start + +3. Send packets with packet generator, check first and second testpmd will start correctly while third one will report error with not enough mem in socket 0. + +Test Case 5: run dpdk app in limited hugepages controlled by cgroup +=================================================================== + +1. Bind one nic port to igb_uio driver, launch testpmd in limited hugepages:: + + cgcreate -g hugetlb:/test-subgroup + cgset -r hugetlb.1GB.limit_in_bytes=2147483648 test-subgroup + cgexec -g hugetlb:test-subgroup numactl -m 1 ./testpmd -c 0x3000 -n 4 -- -i --socket-num=1 --no-numa + +2. Start testpmd and send packets with packet generator, make sure testpmd could receive and fwd packets correctly. -- 2.17.1