Re: [bpf-next PATCH 5/5] bpf, doc: howto use/run the BPF selftests
From: Silvan Jegen <hidden>
Date: 2018-05-14 15:16:29
Also in:
linux-doc, linux-man
Hi Some typo fixes below. On Mon, May 14, 2018 at 3:43 PM Jesper Dangaard Brouer [off-list ref] wrote:
I always forget howto run the BPF selftests. Thus, lets add that info to the QA document.
Documentation was based on Cilium's documentation: http://cilium.readthedocs.io/en/latest/bpf/#verifying-the-setup
Signed-off-by: Jesper Dangaard Brouer <redacted> --- Documentation/bpf/bpf_devel_QA.rst | 29 +++++++++++++++++++++++++++++ 1 file changed, 29 insertions(+)
quoted hunk ↗ jump to hunk
diff --git a/Documentation/bpf/bpf_devel_QA.rst
b/Documentation/bpf/bpf_devel_QA.rst
quoted hunk ↗ jump to hunk
index 2254bdeae990..0e7c1d946e83 100644--- a/Documentation/bpf/bpf_devel_QA.rst +++ b/Documentation/bpf/bpf_devel_QA.rst@@ -417,6 +417,33 @@ submitted by the BPF maintainers to the stable
maintainers.
Testing patches ===============
+Q: How to run BPF selftests +--------------------------- +A: After you have booted into the newly compiled kernel, navigate to +the BPF selftests_ suite in order to test BPF functionality (current +working directory points to the root of the cloned git tree):: + + $ cd tools/testing/selftests/bpf/ + $ make + +To run the verifier tests:: + + $ sudo ./test_verifier + +The verifier tests print out all the current checks being +performed. The summary at the end of running all tests will dump +information of test successes and failures::
Two colons at the end of the line. Don't think that was intended.
+ + Summary: 418 PASSED, 0 FAILED + +In order to run through all BPF selftests, the following command is +needed:: + + $ sudo make run_tests + +See the kernels selftest `Documentation/dev-tools/kselftest.rst`_
s/kernels/kernel's/ I also think the underscore at the end of this line is misplaced (or it should be a dash instead). Cheers, Silvan
quoted hunk ↗ jump to hunk
+document for further documentation. + Q: Which BPF kernel selftests version should I run my kernel against? --------------------------------------------------------------------- A: If you run a kernel ``xyz``, then always run the BPF kernel selftests@@ -607,5 +634,7 @@ when: .. _netdev FAQ: ../networking/netdev-FAQ.txt .. _samples/bpf/: ../../samples/bpf/ .. _selftests: ../../tools/testing/selftests/bpf/ +.. _Documentation/dev-tools/kselftest.rst: + https://www.kernel.org/doc/html/latest/dev-tools/kselftest.html
Happy BPF hacking!
-- To unsubscribe from this list: send the line "unsubscribe linux-man" in the body of a message to majordomo@vger.kernel.org More majordomo info at http://vger.kernel.org/majordomo-info.html