summaryrefslogtreecommitdiff
path: root/tools/testing/selftests/drivers/net/README.rst
diff options
context:
space:
mode:
authorJakub Kicinski <kuba@kernel.org>2024-04-05 05:45:25 +0300
committerDavid S. Miller <davem@davemloft.net>2024-04-08 13:40:41 +0300
commitb4db9f840283caca0d904436f187ef56a9126eaa (patch)
tree83a24b6b39f665387c5c017b965e45c8210f6d87 /tools/testing/selftests/drivers/net/README.rst
parentf216306bfb602b449cb2c49cf03870fb8761d146 (diff)
downloadlinux-b4db9f840283caca0d904436f187ef56a9126eaa.tar.xz
selftests: drivers: add scaffolding for Netlink tests in Python
Add drivers/net as a target for mixed-use tests. The setup is expected to work similarly to the forwarding tests. Since we only need one interface (unlike forwarding tests) read the target device name from NETIF. If not present we'll try to run the test against netdevsim. Reviewed-by: Petr Machata <petrm@nvidia.com> Signed-off-by: Jakub Kicinski <kuba@kernel.org> Signed-off-by: David S. Miller <davem@davemloft.net>
Diffstat (limited to 'tools/testing/selftests/drivers/net/README.rst')
-rw-r--r--tools/testing/selftests/drivers/net/README.rst30
1 files changed, 30 insertions, 0 deletions
diff --git a/tools/testing/selftests/drivers/net/README.rst b/tools/testing/selftests/drivers/net/README.rst
new file mode 100644
index 000000000000..5ef7c417d431
--- /dev/null
+++ b/tools/testing/selftests/drivers/net/README.rst
@@ -0,0 +1,30 @@
+Running tests
+=============
+
+Tests are executed within kselftest framework like any other tests.
+By default tests execute against software drivers such as netdevsim.
+All tests must support running against a real device (SW-only tests
+should instead be placed in net/ or drivers/net/netdevsim, HW-only
+tests in drivers/net/hw).
+
+Set appropriate variables to point the tests at a real device.
+
+Variables
+=========
+
+Variables can be set in the environment or by creating a net.config
+file in the same directory as this README file. Example::
+
+ $ NETIF=eth0 ./some_test.sh
+
+or::
+
+ $ cat tools/testing/selftests/drivers/net/net.config
+ # Variable set in a file
+ NETIF=eth0
+
+NETIF
+~~~~~
+
+Name of the netdevice against which the test should be executed.
+When empty or not set software devices will be used.