[dts] [PATCH v1] test_plans: add test plan for dpdk hugetlbfs mount size test

[dts] [PATCH v1] test_plans: add test plan for dpdk hugetlbfs mount size test

[Yinan]

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

Signed-off-by: Wang Yinan <yinan.wang@intel.com>
---
 .../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

Re: [dts] [PATCH v1] test_plans: add test plan for dpdk hugetlbfs mount size test

[Tu, Lijuan]

Applied, thanks

> -----Original Message-----
> From: dts [mailto:dts-bounces@dpdk.org] On Behalf Of Yinan
> Sent: Friday, June 28, 2019 3:50 AM
> To: dts@dpdk.org
> Cc: Wang, Yinan <yinan.wang@intel.com>
> Subject: [dts] [PATCH v1] test_plans: add test plan for dpdk hugetlbfs mount
> size test
> 
> From: Wang Yinan <yinan.wang@intel.com>
> 
> Signed-off-by: Wang Yinan <yinan.wang@intel.com>
> ---
>  .../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