Linux kernel mirror (for testing)
git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel
os
linux
docs: netdev: refine netdevsim testing guidance
The library to create tests for both NIC HW and netdevsim has existed
for almost a year. netdevsim-only tests we get increasingly feel like
a waste, we should try to write tests that work both on netdevsim and
real HW. Refine the guidance accordingly.
Reviewed-by: Simon Horman <horms@kernel.org>
Link: https://patch.msgid.link/20260304151647.2770466-1-kuba@kernel.org
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
+8
-2
+8
-2
Documentation/process/maintainer-netdev.rst
+8
-2
Documentation/process/maintainer-netdev.rst
···
479
479
480
480
``netdevsim`` is a test driver which can be used to exercise driver
481
481
configuration APIs without requiring capable hardware.
482
-
Mock-ups and tests based on ``netdevsim`` are strongly encouraged when
483
-
adding new APIs, but ``netdevsim`` in itself is **not** considered
482
+
Mock-ups and tests based on ``netdevsim`` are encouraged when
483
+
adding new APIs with complex logic in the stack. The tests should
484
+
be written so that they can run both against ``netdevsim`` and a real
485
+
device (see ``tools/testing/selftests/drivers/net/README.rst``).
486
+
``netdevsim``-only tests should focus on testing corner cases
487
+
and failure paths in the core which are hard to exercise with a real driver.
488
+
489
+
``netdevsim`` in itself is **not** considered
484
490
a use case/user. You must also implement the new APIs in a real driver.
485
491
486
492
We give no guarantees that ``netdevsim`` won't change in the future