[ovs-dev] [PATCH] Documentation: Add note about iproute2 requirements for check-kmod

Greg Rose gvrose8192 at gmail.com
Wed Mar 11 17:49:17 UTC 2020

On many systems the check-kmod and check-kernel test suites have
many failures due to the lack of feature support in the older
iproute2 utility packages shipped with those systems.  Add a
note indicating that it might be necessary to update the iproute2
utility package in order to fix those errors.

Signed-off-by: Greg Rose <gvrose8192 at gmail.com>
 Documentation/topics/testing.rst | 11 +++++++++++
 1 file changed, 11 insertions(+)

diff --git a/Documentation/topics/testing.rst b/Documentation/topics/testing.rst
index 161e9d4..b9fa94d 100644
--- a/Documentation/topics/testing.rst
+++ b/Documentation/topics/testing.rst
@@ -381,6 +381,17 @@ The results of the testsuite are in ``tests/system-kmod-testsuite.dir``.
 All the features documented under `Unit Tests`_ are available for the kernel
 datapath testsuite.
+.. note::
+  Many of the kernel tests are dependent on the utilities present in the
+  iproute2 package, especially the 'ip' command.  If there are many
+  otherwise unexplained errors it may be necessary to update the iproute2
+  package utilities on the system.  It is beyond the scope of this
+  documentation to explain all that is necessary to build and install
+  an updated iproute2 utilities package.  The package is available from
+  the Linux kernel organization open source git repositories.
+  https://git.kernel.org/pub/scm/linux/kernel/git/shemminger/iproute2.git
 .. _testing-static-analysis:
 Static Code Analysis

More information about the dev mailing list