selftests/bpf/README.rst

7 __ /Documentation/bpf/bpf_devel_QA.rst#q-how-to-run-bpf-selftests
31 trampoline support on IBM's s390x architecture. For cases like this, an in-tree
32 deny list file, located at ``tools/testing/selftests/bpf/DENYLIST.<arch>``, can
45 This last entry helps identify tests that can be re-enabled once such support is
54 would be run post-submit in the CI used by the Maintainers, with the exception
57 This script uses the in-tree kernel configuration and downloads a VM userspace
64 - clang (preferably built from sources, https://github.com/llvm/llvm-project);
65 - pahole (preferably built from sources, https://git.kernel.org/pub/scm/devel/pahole/pahole.git/);
66 - qemu;
67 - docutils (for ``rst2man``);
68 - libcap-devel.
72 .. code-block:: console
74   $ tools/testing/selftests/bpf/vmtest.sh -h
78 .. code-block:: console
80   $ LDLIBS=-static PKG_CONFIG='pkg-config --static' vmtest.sh
98 .. code-block:: console
100   $ sudo ./mkrootfs_debian.sh --arch riscv64 --distro noble
104 .. code-block:: console
106   $ PLATFORM=riscv64 CROSS_COMPILE=riscv64-linux-gnu- \
108     -l <path of local rootfs image> -- \
109     ./test_progs -d \
111             | cut -d'#' -f1 \
112             | sed -e 's/^[[:space:]]*//' \
113                   -e 's/[[:space:]]*$//' \
114             | tr -s '\n' ',' \
117 Link: https://github.com/pulehui/riscv-bpf-vmtest.git [0]
129 .. code-block:: c
148 __ https://github.com/llvm/llvm-project/commit/ddf1864ace484035e3cde5e83b3a31ac81e059c6
152 .. code-block:: c
171 .. code-block:: c
177   ; BPF_SEQ_PRINTF(seq, "%pi6 %02x ", &rt->fib6_dst.addr, rt->fib6_dst.plen);
183 .. code-block:: c
185   ; struct netlink_sock *nlk = ctx->sk;
190   ; BPF_SEQ_PRINTF(seq, "%pK %-3d ", s, s->sk_protocol);
198 __  https://github.com/llvm/llvm-project/commit/3cb7e7bf959dcd3b8080986c62e10a75c7af43f0
208 .. code-block:: c
215 .. code-block:: c
220       16:       04 01 00 00 ff ff ff ff w1 += -1
229       23:       7b 1a e0 ff 00 00 00 00 *(u64 *)(r10 - 32) = r1
230       24:       7b 5a c0 ff 00 00 00 00 *(u64 *)(r10 - 64) = r5
237 __  https://github.com/llvm/llvm-project/commit/1959ead525b8830cc8a345f45e1c3ef9902d3229
239 BPF CO-RE-based tests and Clang version
242 A set of selftests use BPF target-specific built-ins, which might require
243 bleeding-edge Clang versions (Clang 12 nightly at this time).
245 Few sub-tests of core_reloc test suit (part of test_progs test runner) require
246 the following built-ins, listed with corresponding Clang diffs introducing
247 them to Clang/LLVM. These sub-tests are going to be skipped if Clang is too
251 - __builtin_btf_type_id() [0_, 1_, 2_];
252 - __builtin_preserve_type_info(), __builtin_preserve_enum_value() [3_, 4_].
254 .. _0: https://github.com/llvm/llvm-project/commit/6b01b465388b204d543da3cf49efd6080db094a9
255 .. _1: https://github.com/llvm/llvm-project/commit/072cde03aaa13a2c57acf62d79876bf79aa1919f
256 .. _2: https://github.com/llvm/llvm-project/commit/00602ee7ef0bf6c68d690a2bd729c12b95c95c99
257 .. _3: https://github.com/llvm/llvm-project/commit/6d218b4adb093ff2e9764febbbc89f429412006c
258 .. _4: https://github.com/llvm/llvm-project/commit/6d6750696400e7ce988d66a1a00e1d0cb32815f8
260 Floating-point tests and Clang version
263 Certain selftests, e.g. core_reloc, require support for the floating-point
267 __  https://github.com/llvm/llvm-project/commit/a7137b238a07d9399d3ae96c0b461571bd5aa8b2
277 .. code-block:: console
279   libbpf: failed to find BTF for extern 'tcp_slow_start' [25] section: -2
281 __ https://github.com/llvm/llvm-project/commit/886f9ff53155075bd5f1e994f17b85d1e1b7470c
293 .. code-block:: console
297 .. _0: https://github.com/llvm/llvm-project/commit/a162b67c98066218d0d00aa13b99afb95d9bb5e6
298 .. _1: https://github.com/llvm/llvm-project/commit/3466e00716e12e32fdb100e3fcfca5c2b3e8d784
307 __ https://github.com/llvm/llvm-project/commit/968292cb93198442138128d850fd54dc7edc0035
325 .. _clang reloc patch: https://github.com/llvm/llvm-project/commit/6a2ea84600ba4bd3b2733bd8f08f5115…
335 .. code-block:: console
337 …LLVM have https://github.com/llvm/llvm-project/commit/ea72b0319d7b0f0c2fcf41d121afa5d031b319d5? un…
339 __ https://github.com/llvm/llvm-project/commit/ea72b0319d7b0f0c2fcf41d121afa5d031b319d5