diff --git a/MAINTAINERS b/MAINTAINERS index b690e1e83..e1c0f669b 100644 --- a/MAINTAINERS +++ b/MAINTAINERS @@ -1229,7 +1229,7 @@ F: doc/guides/howto/telemetry.rst BPF - EXPERIMENTAL M: Konstantin Ananyev F: lib/librte_bpf/ -F: test/bpf/ +F: examples/bpf/ F: test/test/test_bpf.c F: doc/guides/prog_guide/bpf_lib.rst diff --git a/doc/guides/testpmd_app_ug/testpmd_funcs.rst b/doc/guides/testpmd_app_ug/testpmd_funcs.rst index 5de9f1be1..1a12da4cf 100644 --- a/doc/guides/testpmd_app_ug/testpmd_funcs.rst +++ b/doc/guides/testpmd_app_ug/testpmd_funcs.rst @@ -4503,20 +4503,20 @@ For example: .. code-block:: console - cd test/bpf + cd examples/bpf clang -O2 -target bpf -c t1.c Then to load (and JIT compile) t1.o at RX queue 0, port 1:: .. code-block:: console - testpmd> bpf-load rx 1 0 J ./dpdk.org/test/bpf/t1.o + testpmd> bpf-load rx 1 0 J ./dpdk.org/examples/bpf/t1.o To load (not JITed) t1.o at TX queue 0, port 0:: .. code-block:: console - testpmd> bpf-load tx 0 0 - ./dpdk.org/test/bpf/t1.o + testpmd> bpf-load tx 0 0 - ./dpdk.org/examples/bpf/t1.o bpf-unload ~~~~~~~~~~ @@ -4529,4 +4529,4 @@ For example to unload BPF filter from TX queue 0, port 0: .. code-block:: console - testpmd> bpf-load tx 0 0 - ./dpdk.org/test/bpf/t1.o + testpmd> bpf-unload tx 0 0 diff --git a/examples/bpf/README b/examples/bpf/README new file mode 100644 index 000000000..d714180a5 --- /dev/null +++ b/examples/bpf/README @@ -0,0 +1,8 @@ +This folder contains example BPF programs for use with the DPDK bpf +library. To get details of each program and how to compile it, see +the header on the '.c' file itself. + +Once compiled, these example programs can be loaded into `testpmd` +for execution on a packet stream. See `bpf-load` and `bpf-unload` +commands documented in the `Testpmd Application User Guide` for +details on how to do so. diff --git a/test/bpf/dummy.c b/examples/bpf/dummy.c similarity index 100% rename from test/bpf/dummy.c rename to examples/bpf/dummy.c diff --git a/test/bpf/mbuf.h b/examples/bpf/mbuf.h similarity index 100% rename from test/bpf/mbuf.h rename to examples/bpf/mbuf.h diff --git a/examples/bpf/meson.build b/examples/bpf/meson.build new file mode 100644 index 000000000..0a817aaea --- /dev/null +++ b/examples/bpf/meson.build @@ -0,0 +1,6 @@ +# SPDX-License-Identifier: BSD-3-Clause +# Copyright(c) 2019 Intel Corporation + +# This contains BPF example code for use in testing BPF with testpmd, +# therefore it should not be built as part of a meson build. +build=false diff --git a/test/bpf/t1.c b/examples/bpf/t1.c similarity index 100% rename from test/bpf/t1.c rename to examples/bpf/t1.c diff --git a/test/bpf/t2.c b/examples/bpf/t2.c similarity index 100% rename from test/bpf/t2.c rename to examples/bpf/t2.c diff --git a/test/bpf/t3.c b/examples/bpf/t3.c similarity index 100% rename from test/bpf/t3.c rename to examples/bpf/t3.c