From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124]) by inbox.dpdk.org (Postfix) with ESMTP id 33EAB423FE; Tue, 17 Jan 2023 16:50:05 +0100 (CET) Received: from mails.dpdk.org (localhost [127.0.0.1]) by mails.dpdk.org (Postfix) with ESMTP id 5DAF942D66; Tue, 17 Jan 2023 16:49:22 +0100 (CET) Received: from lb.pantheon.sk (lb.pantheon.sk [46.229.239.20]) by mails.dpdk.org (Postfix) with ESMTP id D8A2742D36 for ; Tue, 17 Jan 2023 16:49:19 +0100 (CET) Received: from localhost (localhost [127.0.0.1]) by lb.pantheon.sk (Postfix) with ESMTP id 241CD1D8124; Tue, 17 Jan 2023 16:49:19 +0100 (CET) X-Virus-Scanned: amavisd-new at siecit.sk Received: from lb.pantheon.sk ([127.0.0.1]) by localhost (lb.pantheon.sk [127.0.0.1]) (amavisd-new, port 10024) with ESMTP id SjXqolEL6-rx; Tue, 17 Jan 2023 16:49:18 +0100 (CET) Received: from entguard.lab.pantheon.local (unknown [46.229.239.141]) by lb.pantheon.sk (Postfix) with ESMTP id 902711D812A; Tue, 17 Jan 2023 16:49:12 +0100 (CET) From: =?UTF-8?q?Juraj=20Linke=C5=A1?= To: thomas@monjalon.net, Honnappa.Nagarahalli@arm.com, ohilyard@iol.unh.edu, lijuan.tu@intel.com, bruce.richardson@intel.com Cc: dev@dpdk.org, =?UTF-8?q?Juraj=20Linke=C5=A1?= Subject: [PATCH v3 07/10] dts: add hello world testplan Date: Tue, 17 Jan 2023 15:49:03 +0000 Message-Id: <20230117154906.860916-8-juraj.linkes@pantheon.tech> X-Mailer: git-send-email 2.25.1 In-Reply-To: <20230117154906.860916-1-juraj.linkes@pantheon.tech> References: <20221114165438.1133783-1-juraj.linkes@pantheon.tech> <20230117154906.860916-1-juraj.linkes@pantheon.tech> MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: dev@dpdk.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: DPDK patches and discussions List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: dev-bounces@dpdk.org The testplan describes the capabilities of the tested application along with the description of testcases to test it. Signed-off-by: Juraj Linkeš --- dts/test_plans/hello_world_test_plan.rst | 68 ++++++++++++++++++++++++ 1 file changed, 68 insertions(+) create mode 100644 dts/test_plans/hello_world_test_plan.rst diff --git a/dts/test_plans/hello_world_test_plan.rst b/dts/test_plans/hello_world_test_plan.rst new file mode 100644 index 0000000000..566a9bb10c --- /dev/null +++ b/dts/test_plans/hello_world_test_plan.rst @@ -0,0 +1,68 @@ +.. SPDX-License-Identifier: BSD-3-Clause + Copyright(c) 2010-2017 Intel Corporation + +============================================= +Sample Application Tests: Hello World Example +============================================= + +This example is one of the most simple RTE application that can be +done. The program will just print a "helloworld" message on every +enabled lcore. + +Command Usage:: + + ./dpdk-helloworld -c COREMASK [-m NB] [-r NUM] [-n NUM] + + EAL option list: + -c COREMASK: hexadecimal bitmask of cores we are running on + -m MB : memory to allocate (default = size of hugemem) + -n NUM : force number of memory channels (don't detect) + -r NUM : force number of memory ranks (don't detect) + --huge-file: base filename for hugetlbfs entries + debug options: + --no-huge : use malloc instead of hugetlbfs + --no-pci : disable pci + --no-hpet : disable hpet + --no-shconf: no shared config (mmap'd files) + + +Prerequisites +============= + +Support igb_uio and vfio driver, if used vfio, kernel need 3.6+ and enable vt-d in bios. +When used vfio , used "modprobe vfio" and "modprobe vfio-pci" insmod vfio driver, then used +"./tools/dpdk_nic_bind.py --bind=vfio-pci device_bus_id" to bind vfio driver to test driver. + +To find out the mapping of lcores (processor) to core id and socket (physical +id), the command below can be used:: + + $ grep "processor\|physical id\|core id\|^$" /proc/cpuinfo + +The total logical core number will be used as ``helloworld`` input parameters. + + +Test Case: run hello world on single lcores +=========================================== + +To run example in single lcore :: + + $ ./dpdk-helloworld -c 1 + hello from core 0 + +Check the output is exact the lcore 0 + + +Test Case: run hello world on every lcores +========================================== + +To run the example in all the enabled lcore :: + + $ ./dpdk-helloworld -cffffff + hello from core 1 + hello from core 2 + hello from core 3 + ... + ... + hello from core 0 + +Verify the output of according to all the core masks. -- 2.30.2