From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <dev-bounces@dpdk.org>
Received: from mails.dpdk.org (mails.dpdk.org [217.70.189.124])
	by inbox.dpdk.org (Postfix) with ESMTP id 8D457A00C4;
	Mon, 14 Nov 2022 17:55:57 +0100 (CET)
Received: from mails.dpdk.org (localhost [127.0.0.1])
	by mails.dpdk.org (Postfix) with ESMTP id 62D8A42D55;
	Mon, 14 Nov 2022 17:54:56 +0100 (CET)
Received: from lb.pantheon.sk (lb.pantheon.sk [46.229.239.20])
 by mails.dpdk.org (Postfix) with ESMTP id EEA9742D2A
 for <dev@dpdk.org>; Mon, 14 Nov 2022 17:54:52 +0100 (CET)
Received: from localhost (localhost [127.0.0.1])
 by lb.pantheon.sk (Postfix) with ESMTP id 50B6E21C5E8;
 Mon, 14 Nov 2022 17:54:52 +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 mSRZIzFlgfec; Mon, 14 Nov 2022 17:54:51 +0100 (CET)
Received: from entguard.lab.pantheon.local (unknown [46.229.239.141])
 by lb.pantheon.sk (Postfix) with ESMTP id 3E62124794E;
 Mon, 14 Nov 2022 17:54:44 +0100 (CET)
From: =?UTF-8?q?Juraj=20Linke=C5=A1?= <juraj.linkes@pantheon.tech>
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?= <juraj.linkes@pantheon.tech>
Subject: [RFC PATCH v2 09/10] dts: add hello world testplan
Date: Mon, 14 Nov 2022 16:54:37 +0000
Message-Id: <20221114165438.1133783-10-juraj.linkes@pantheon.tech>
X-Mailer: git-send-email 2.25.1
In-Reply-To: <20221114165438.1133783-1-juraj.linkes@pantheon.tech>
References: <20220824162454.394285-1-juraj.linkes@pantheon.tech>
 <20221114165438.1133783-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 <dev.dpdk.org>
List-Unsubscribe: <https://mails.dpdk.org/options/dev>,
 <mailto:dev-request@dpdk.org?subject=unsubscribe>
List-Archive: <http://mails.dpdk.org/archives/dev/>
List-Post: <mailto:dev@dpdk.org>
List-Help: <mailto:dev-request@dpdk.org?subject=help>
List-Subscribe: <https://mails.dpdk.org/listinfo/dev>,
 <mailto:dev-request@dpdk.org?subject=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š <juraj.linkes@pantheon.tech>
---
 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