tools/testing/selftests/bpf/Makefile

   1 # SPDX-License-Identifier: GPL-2.0
   2 include ../../../build/Build.include
   3 include ../../../scripts/Makefile.arch
   4 include ../../../scripts/Makefile.include
   5
   6 CXX ?= $(CROSS_COMPILE)g++
   7
   8 CURDIR := $(abspath .)
   9 TOOLSDIR := $(abspath ../../..)
  10 LIBDIR := $(TOOLSDIR)/lib
  11 BPFDIR := $(LIBDIR)/bpf
  12 TOOLSINCDIR := $(TOOLSDIR)/include
  13 BPFTOOLDIR := $(TOOLSDIR)/bpf/bpftool
  14 APIDIR := $(TOOLSINCDIR)/uapi
  15 GENDIR := $(abspath ../../../../include/generated)
  16 GENHDR := $(GENDIR)/autoconf.h
  17 HOSTPKG_CONFIG := pkg-config
  18
  19 ifneq ($(wildcard $(GENHDR)),)
  20   GENFLAGS := -DHAVE_GENHDR
  21 endif
  22
  23 BPF_GCC         ?= $(shell command -v bpf-gcc;)
  24 SAN_CFLAGS      ?=
  25 SAN_LDFLAGS     ?= $(SAN_CFLAGS)
  26 CFLAGS += -g -O0 -rdynamic -Wall -Werror $(GENFLAGS) $(SAN_CFLAGS)      \
  27           -I$(CURDIR) -I$(INCLUDE_DIR) -I$(GENDIR) -I$(LIBDIR)          \
  28           -I$(TOOLSINCDIR) -I$(APIDIR) -I$(OUTPUT)
  29 LDFLAGS += $(SAN_LDFLAGS)
  30 LDLIBS += -lelf -lz -lrt -lpthread
  31
  32 # Silence some warnings when compiled with clang
  33 ifneq ($(LLVM),)
  34 CFLAGS += -Wno-unused-command-line-argument
  35 endif
  36
  37 # Order correspond to 'make run_tests' order
  38 TEST_GEN_PROGS = test_verifier test_tag test_maps test_lru_map test_lpm_map test_progs \
  39         test_verifier_log test_dev_cgroup \
  40         test_sock test_sockmap get_cgroup_id_user \
  41         test_cgroup_storage \
  42         test_tcpnotify_user test_sysctl \
  43         test_progs-no_alu32
  44
  45 # Also test bpf-gcc, if present
  46 ifneq ($(BPF_GCC),)
  47 TEST_GEN_PROGS += test_progs-bpf_gcc
  48 endif
  49
  50 TEST_GEN_FILES = test_lwt_ip_encap.bpf.o test_tc_edt.bpf.o
  51 TEST_FILES = xsk_prereqs.sh $(wildcard progs/btf_dump_test_case_*.c)
  52
  53 # Order correspond to 'make run_tests' order
  54 TEST_PROGS := test_kmod.sh \
  55         test_xdp_redirect.sh \
  56         test_xdp_redirect_multi.sh \
  57         test_xdp_meta.sh \
  58         test_xdp_veth.sh \
  59         test_offload.py \
  60         test_sock_addr.sh \
  61         test_tunnel.sh \
  62         test_lwt_seg6local.sh \
  63         test_lirc_mode2.sh \
  64         test_skb_cgroup_id.sh \
  65         test_flow_dissector.sh \
  66         test_xdp_vlan_mode_generic.sh \
  67         test_xdp_vlan_mode_native.sh \
  68         test_lwt_ip_encap.sh \
  69         test_tcp_check_syncookie.sh \
  70         test_tc_tunnel.sh \
  71         test_tc_edt.sh \
  72         test_xdping.sh \
  73         test_bpftool_build.sh \
  74         test_bpftool.sh \
  75         test_bpftool_metadata.sh \
  76         test_doc_build.sh \
  77         test_xsk.sh \
  78         test_xdp_features.sh
  79
  80 TEST_PROGS_EXTENDED := with_addr.sh \
  81         with_tunnels.sh ima_setup.sh verify_sig_setup.sh \
  82         test_xdp_vlan.sh test_bpftool.py
  83
  84 # Compile but not part of 'make run_tests'
  85 TEST_GEN_PROGS_EXTENDED = test_sock_addr test_skb_cgroup_id_user \
  86         flow_dissector_load test_flow_dissector test_tcp_check_syncookie_user \
  87         test_lirc_mode2_user xdping test_cpp runqslower bench bpf_testmod.ko \
  88         xskxceiver xdp_redirect_multi xdp_synproxy veristat xdp_hw_metadata \
  89         xdp_features
  90
  91 TEST_CUSTOM_PROGS = $(OUTPUT)/urandom_read $(OUTPUT)/sign-file
  92 TEST_GEN_FILES += liburandom_read.so
  93
  94 # Emit succinct information message describing current building step
  95 # $1 - generic step name (e.g., CC, LINK, etc);
  96 # $2 - optional "flavor" specifier; if provided, will be emitted as [flavor];
  97 # $3 - target (assumed to be file); only file name will be emitted;
  98 # $4 - optional extra arg, emitted as-is, if provided.
  99 ifeq ($(V),1)
 100 Q =
 101 msg =
 102 else
 103 Q = @
 104 msg = @printf '  %-8s%s %s%s\n' "$(1)" "$(if $(2), [$(2)])" "$(notdir $(3))" "$(if $(4), $(4))";
 105 MAKEFLAGS += --no-print-directory
 106 submake_extras := feature_display=0
 107 endif
 108
 109 # override lib.mk's default rules
 110 OVERRIDE_TARGETS := 1
 111 override define CLEAN
 112         $(call msg,CLEAN)
 113         $(Q)$(RM) -r $(TEST_GEN_PROGS)
 114         $(Q)$(RM) -r $(TEST_GEN_PROGS_EXTENDED)
 115         $(Q)$(RM) -r $(TEST_GEN_FILES)
 116         $(Q)$(RM) -r $(EXTRA_CLEAN)
 117         $(Q)$(MAKE) -C bpf_testmod clean
 118         $(Q)$(MAKE) docs-clean
 119 endef
 120
 121 include ../lib.mk
 122
 123 SCRATCH_DIR := $(OUTPUT)/tools
 124 BUILD_DIR := $(SCRATCH_DIR)/build
 125 INCLUDE_DIR := $(SCRATCH_DIR)/include
 126 BPFOBJ := $(BUILD_DIR)/libbpf/libbpf.a
 127 ifneq ($(CROSS_COMPILE),)
 128 HOST_BUILD_DIR          := $(BUILD_DIR)/host
 129 HOST_SCRATCH_DIR        := $(OUTPUT)/host-tools
 130 HOST_INCLUDE_DIR        := $(HOST_SCRATCH_DIR)/include
 131 else
 132 HOST_BUILD_DIR          := $(BUILD_DIR)
 133 HOST_SCRATCH_DIR        := $(SCRATCH_DIR)
 134 HOST_INCLUDE_DIR        := $(INCLUDE_DIR)
 135 endif
 136 HOST_BPFOBJ := $(HOST_BUILD_DIR)/libbpf/libbpf.a
 137 RESOLVE_BTFIDS := $(HOST_BUILD_DIR)/resolve_btfids/resolve_btfids
 138 RUNQSLOWER_OUTPUT := $(BUILD_DIR)/runqslower/
 139
 140 VMLINUX_BTF_PATHS ?= $(if $(O),$(O)/vmlinux)                            \
 141                      $(if $(KBUILD_OUTPUT),$(KBUILD_OUTPUT)/vmlinux)    \
 142                      ../../../../vmlinux                                \
 143                      /sys/kernel/btf/vmlinux                            \
 144                      /boot/vmlinux-$(shell uname -r)
 145 VMLINUX_BTF ?= $(abspath $(firstword $(wildcard $(VMLINUX_BTF_PATHS))))
 146 ifeq ($(VMLINUX_BTF),)
 147 $(error Cannot find a vmlinux for VMLINUX_BTF at any of "$(VMLINUX_BTF_PATHS)")
 148 endif
 149
 150 # Define simple and short `make test_progs`, `make test_sysctl`, etc targets
 151 # to build individual tests.
 152 # NOTE: Semicolon at the end is critical to override lib.mk's default static
 153 # rule for binaries.
 154 $(notdir $(TEST_GEN_PROGS)                                              \
 155          $(TEST_GEN_PROGS_EXTENDED)                                     \
 156          $(TEST_CUSTOM_PROGS)): %: $(OUTPUT)/% ;
 157
 158 # sort removes libbpf duplicates when not cross-building
 159 MAKE_DIRS := $(sort $(BUILD_DIR)/libbpf $(HOST_BUILD_DIR)/libbpf        \
 160                $(BUILD_DIR)/bpftool $(HOST_BUILD_DIR)/bpftool           \
 161                $(HOST_BUILD_DIR)/resolve_btfids                         \
 162                $(RUNQSLOWER_OUTPUT) $(INCLUDE_DIR))
 163 $(MAKE_DIRS):
 164         $(call msg,MKDIR,,$@)
 165         $(Q)mkdir -p $@
 166
 167 $(OUTPUT)/%.o: %.c
 168         $(call msg,CC,,$@)
 169         $(Q)$(CC) $(CFLAGS) -c $(filter %.c,$^) $(LDLIBS) -o $@
 170
 171 $(OUTPUT)/%:%.c
 172         $(call msg,BINARY,,$@)
 173         $(Q)$(LINK.c) $^ $(LDLIBS) -o $@
 174
 175 # LLVM's ld.lld doesn't support all the architectures, so use it only on x86
 176 ifeq ($(SRCARCH),x86)
 177 LLD := lld
 178 else
 179 LLD := ld
 180 endif
 181
 182 # Filter out -static for liburandom_read.so and its dependent targets so that static builds
 183 # do not fail. Static builds leave urandom_read relying on system-wide shared libraries.
 184 $(OUTPUT)/liburandom_read.so: urandom_read_lib1.c urandom_read_lib2.c
 185         $(call msg,LIB,,$@)
 186         $(Q)$(CLANG) $(filter-out -static,$(CFLAGS) $(LDFLAGS))   \
 187                      $^ $(filter-out -static,$(LDLIBS))      \
 188                      -fuse-ld=$(LLD) -Wl,-znoseparate-code -Wl,--build-id=sha1 \
 189                      -fPIC -shared -o $@
 190
 191 $(OUTPUT)/urandom_read: urandom_read.c urandom_read_aux.c $(OUTPUT)/liburandom_read.so
 192         $(call msg,BINARY,,$@)
 193         $(Q)$(CLANG) $(filter-out -static,$(CFLAGS) $(LDFLAGS)) $(filter %.c,$^) \
 194                      -lurandom_read $(filter-out -static,$(LDLIBS)) -L$(OUTPUT)  \
 195                      -fuse-ld=$(LLD) -Wl,-znoseparate-code -Wl,--build-id=sha1 \
 196                      -Wl,-rpath=. -o $@
 197
 198 $(OUTPUT)/sign-file: ../../../../scripts/sign-file.c
 199         $(call msg,SIGN-FILE,,$@)
 200         $(Q)$(CC) $(shell $(HOSTPKG_CONFIG)--cflags libcrypto 2> /dev/null) \
 201                   $< -o $@ \
 202                   $(shell $(HOSTPKG_CONFIG) --libs libcrypto 2> /dev/null || echo -lcrypto)
 203
 204 $(OUTPUT)/bpf_testmod.ko: $(VMLINUX_BTF) $(RESOLVE_BTFIDS) $(wildcard bpf_testmod/Makefile bpf_testmod/*.[ch])
 205         $(call msg,MOD,,$@)
 206         $(Q)$(RM) bpf_testmod/bpf_testmod.ko # force re-compilation
 207         $(Q)$(MAKE) $(submake_extras) RESOLVE_BTFIDS=$(RESOLVE_BTFIDS) -C bpf_testmod
 208         $(Q)cp bpf_testmod/bpf_testmod.ko $@
 209
 210 DEFAULT_BPFTOOL := $(HOST_SCRATCH_DIR)/sbin/bpftool
 211 ifneq ($(CROSS_COMPILE),)
 212 CROSS_BPFTOOL := $(SCRATCH_DIR)/sbin/bpftool
 213 TRUNNER_BPFTOOL := $(CROSS_BPFTOOL)
 214 USE_BOOTSTRAP := ""
 215 else
 216 TRUNNER_BPFTOOL := $(DEFAULT_BPFTOOL)
 217 USE_BOOTSTRAP := "bootstrap/"
 218 endif
 219
 220 $(OUTPUT)/runqslower: $(BPFOBJ) | $(DEFAULT_BPFTOOL) $(RUNQSLOWER_OUTPUT)
 221         $(Q)$(MAKE) $(submake_extras) -C $(TOOLSDIR)/bpf/runqslower            \
 222                     OUTPUT=$(RUNQSLOWER_OUTPUT) VMLINUX_BTF=$(VMLINUX_BTF)     \
 223                     BPFTOOL_OUTPUT=$(HOST_BUILD_DIR)/bpftool/                  \
 224                     BPFOBJ_OUTPUT=$(BUILD_DIR)/libbpf                          \
 225                     BPFOBJ=$(BPFOBJ) BPF_INCLUDE=$(INCLUDE_DIR)                \
 226                     EXTRA_CFLAGS='-g -O0 $(SAN_CFLAGS)'                        \
 227                     EXTRA_LDFLAGS='$(SAN_LDFLAGS)' &&                          \
 228                     cp $(RUNQSLOWER_OUTPUT)runqslower $@
 229
 230 TEST_GEN_PROGS_EXTENDED += $(TRUNNER_BPFTOOL)
 231
 232 $(TEST_GEN_PROGS) $(TEST_GEN_PROGS_EXTENDED): $(BPFOBJ)
 233
 234 TESTING_HELPERS := $(OUTPUT)/testing_helpers.o
 235 CGROUP_HELPERS  := $(OUTPUT)/cgroup_helpers.o
 236 UNPRIV_HELPERS  := $(OUTPUT)/unpriv_helpers.o
 237 TRACE_HELPERS   := $(OUTPUT)/trace_helpers.o
 238 JSON_WRITER             := $(OUTPUT)/json_writer.o
 239 CAP_HELPERS     := $(OUTPUT)/cap_helpers.o
 240
 241 $(OUTPUT)/test_dev_cgroup: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 242 $(OUTPUT)/test_skb_cgroup_id_user: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 243 $(OUTPUT)/test_sock: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 244 $(OUTPUT)/test_sock_addr: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 245 $(OUTPUT)/test_sockmap: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 246 $(OUTPUT)/test_tcpnotify_user: $(CGROUP_HELPERS) $(TESTING_HELPERS) $(TRACE_HELPERS)
 247 $(OUTPUT)/get_cgroup_id_user: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 248 $(OUTPUT)/test_cgroup_storage: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 249 $(OUTPUT)/test_sock_fields: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 250 $(OUTPUT)/test_sysctl: $(CGROUP_HELPERS) $(TESTING_HELPERS)
 251 $(OUTPUT)/test_tag: $(TESTING_HELPERS)
 252 $(OUTPUT)/test_lirc_mode2_user: $(TESTING_HELPERS)
 253 $(OUTPUT)/xdping: $(TESTING_HELPERS)
 254 $(OUTPUT)/flow_dissector_load: $(TESTING_HELPERS)
 255 $(OUTPUT)/test_maps: $(TESTING_HELPERS)
 256 $(OUTPUT)/test_verifier: $(TESTING_HELPERS) $(CAP_HELPERS) $(UNPRIV_HELPERS)
 257 $(OUTPUT)/xsk.o: $(BPFOBJ)
 258
 259 BPFTOOL ?= $(DEFAULT_BPFTOOL)
 260 $(DEFAULT_BPFTOOL): $(wildcard $(BPFTOOLDIR)/*.[ch] $(BPFTOOLDIR)/Makefile)    \
 261                     $(HOST_BPFOBJ) | $(HOST_BUILD_DIR)/bpftool
 262         $(Q)$(MAKE) $(submake_extras)  -C $(BPFTOOLDIR)                        \
 263                     ARCH= CROSS_COMPILE= CC="$(HOSTCC)" LD="$(HOSTLD)"         \
 264                     EXTRA_CFLAGS='-g -O0'                                      \
 265                     OUTPUT=$(HOST_BUILD_DIR)/bpftool/                          \
 266                     LIBBPF_OUTPUT=$(HOST_BUILD_DIR)/libbpf/                    \
 267                     LIBBPF_DESTDIR=$(HOST_SCRATCH_DIR)/                        \
 268                     prefix= DESTDIR=$(HOST_SCRATCH_DIR)/ install-bin
 269
 270 ifneq ($(CROSS_COMPILE),)
 271 $(CROSS_BPFTOOL): $(wildcard $(BPFTOOLDIR)/*.[ch] $(BPFTOOLDIR)/Makefile)       \
 272                     $(BPFOBJ) | $(BUILD_DIR)/bpftool
 273         $(Q)$(MAKE) $(submake_extras)  -C $(BPFTOOLDIR)                         \
 274                     ARCH=$(ARCH) CROSS_COMPILE=$(CROSS_COMPILE)                 \
 275                     EXTRA_CFLAGS='-g -O0'                                       \
 276                     OUTPUT=$(BUILD_DIR)/bpftool/                                \
 277                     LIBBPF_OUTPUT=$(BUILD_DIR)/libbpf/                          \
 278                     LIBBPF_DESTDIR=$(SCRATCH_DIR)/                              \
 279                     prefix= DESTDIR=$(SCRATCH_DIR)/ install-bin
 280 endif
 281
 282 all: docs
 283
 284 docs:
 285         $(Q)RST2MAN_OPTS="--exit-status=1" $(MAKE) $(submake_extras)    \
 286                     -f Makefile.docs                                    \
 287                     prefix= OUTPUT=$(OUTPUT)/ DESTDIR=$(OUTPUT)/ $@
 288
 289 docs-clean:
 290         $(Q)$(MAKE) $(submake_extras)                                   \
 291                     -f Makefile.docs                                    \
 292                     prefix= OUTPUT=$(OUTPUT)/ DESTDIR=$(OUTPUT)/ $@
 293
 294 $(BPFOBJ): $(wildcard $(BPFDIR)/*.[ch] $(BPFDIR)/Makefile)                     \
 295            $(APIDIR)/linux/bpf.h                                               \
 296            | $(BUILD_DIR)/libbpf
 297         $(Q)$(MAKE) $(submake_extras) -C $(BPFDIR) OUTPUT=$(BUILD_DIR)/libbpf/ \
 298                     EXTRA_CFLAGS='-g -O0 $(SAN_CFLAGS)'                        \
 299                     EXTRA_LDFLAGS='$(SAN_LDFLAGS)'                             \
 300                     DESTDIR=$(SCRATCH_DIR) prefix= all install_headers
 301
 302 ifneq ($(BPFOBJ),$(HOST_BPFOBJ))
 303 $(HOST_BPFOBJ): $(wildcard $(BPFDIR)/*.[ch] $(BPFDIR)/Makefile)                \
 304                 $(APIDIR)/linux/bpf.h                                          \
 305                 | $(HOST_BUILD_DIR)/libbpf
 306         $(Q)$(MAKE) $(submake_extras) -C $(BPFDIR)                             \
 307                     EXTRA_CFLAGS='-g -O0' ARCH= CROSS_COMPILE=                 \
 308                     OUTPUT=$(HOST_BUILD_DIR)/libbpf/                           \
 309                     CC="$(HOSTCC)" LD="$(HOSTLD)"                              \
 310                     DESTDIR=$(HOST_SCRATCH_DIR)/ prefix= all install_headers
 311 endif
 312
 313 $(INCLUDE_DIR)/vmlinux.h: $(VMLINUX_BTF) $(BPFTOOL) | $(INCLUDE_DIR)
 314 ifeq ($(VMLINUX_H),)
 315         $(call msg,GEN,,$@)
 316         $(Q)$(BPFTOOL) btf dump file $(VMLINUX_BTF) format c > $@
 317 else
 318         $(call msg,CP,,$@)
 319         $(Q)cp "$(VMLINUX_H)" $@
 320 endif
 321
 322 $(RESOLVE_BTFIDS): $(HOST_BPFOBJ) | $(HOST_BUILD_DIR)/resolve_btfids    \
 323                        $(TOOLSDIR)/bpf/resolve_btfids/main.c    \
 324                        $(TOOLSDIR)/lib/rbtree.c                 \
 325                        $(TOOLSDIR)/lib/zalloc.c                 \
 326                        $(TOOLSDIR)/lib/string.c                 \
 327                        $(TOOLSDIR)/lib/ctype.c                  \
 328                        $(TOOLSDIR)/lib/str_error_r.c
 329         $(Q)$(MAKE) $(submake_extras) -C $(TOOLSDIR)/bpf/resolve_btfids \
 330                 CC="$(HOSTCC)" LD="$(HOSTLD)" AR="$(HOSTAR)" \
 331                 LIBBPF_INCLUDE=$(HOST_INCLUDE_DIR) \
 332                 OUTPUT=$(HOST_BUILD_DIR)/resolve_btfids/ BPFOBJ=$(HOST_BPFOBJ)
 333
 334 # Get Clang's default includes on this system, as opposed to those seen by
 335 # '-target bpf'. This fixes "missing" files on some architectures/distros,
 336 # such as asm/byteorder.h, asm/socket.h, asm/sockios.h, sys/cdefs.h etc.
 337 #
 338 # Use '-idirafter': Don't interfere with include mechanics except where the
 339 # build would have failed anyways.
 340 define get_sys_includes
 341 $(shell $(1) $(2) -v -E - </dev/null 2>&1 \
 342         | sed -n '/<...> search starts here:/,/End of search list./{ s| \(/.*\)|-idirafter \1|p }') \
 343 $(shell $(1) $(2) -dM -E - </dev/null | grep '__riscv_xlen ' | awk '{printf("-D__riscv_xlen=%d -D__BITS_PER_LONG=%d", $$3, $$3)}') \
 344 $(shell $(1) $(2) -dM -E - </dev/null | grep '__loongarch_grlen ' | awk '{printf("-D__BITS_PER_LONG=%d", $$3)}')
 345 endef
 346
 347 # Determine target endianness.
 348 IS_LITTLE_ENDIAN = $(shell $(CC) -dM -E - </dev/null | \
 349                         grep 'define __BYTE_ORDER__ __ORDER_LITTLE_ENDIAN__')
 350 MENDIAN=$(if $(IS_LITTLE_ENDIAN),-mlittle-endian,-mbig-endian)
 351
 352 ifneq ($(CROSS_COMPILE),)
 353 CLANG_TARGET_ARCH = --target=$(notdir $(CROSS_COMPILE:%-=%))
 354 endif
 355
 356 CLANG_SYS_INCLUDES = $(call get_sys_includes,$(CLANG),$(CLANG_TARGET_ARCH))
 357 BPF_CFLAGS = -g -Wall -Werror -D__TARGET_ARCH_$(SRCARCH) $(MENDIAN)     \
 358              -I$(INCLUDE_DIR) -I$(CURDIR) -I$(APIDIR)                   \
 359              -I$(abspath $(OUTPUT)/../usr/include)
 360
 361 CLANG_CFLAGS = $(CLANG_SYS_INCLUDES) \
 362                -Wno-compare-distinct-pointer-types
 363
 364 $(OUTPUT)/test_l4lb_noinline.o: BPF_CFLAGS += -fno-inline
 365 $(OUTPUT)/test_xdp_noinline.o: BPF_CFLAGS += -fno-inline
 366
 367 $(OUTPUT)/flow_dissector_load.o: flow_dissector_load.h
 368 $(OUTPUT)/cgroup_getset_retval_hooks.o: cgroup_getset_retval_hooks.h
 369
 370 # Build BPF object using Clang
 371 # $1 - input .c file
 372 # $2 - output .o file
 373 # $3 - CFLAGS
 374 define CLANG_BPF_BUILD_RULE
 375         $(call msg,CLNG-BPF,$(TRUNNER_BINARY),$2)
 376         $(Q)$(CLANG) $3 -O2 -target bpf -c $1 -mcpu=v3 -o $2
 377 endef
 378 # Similar to CLANG_BPF_BUILD_RULE, but with disabled alu32
 379 define CLANG_NOALU32_BPF_BUILD_RULE
 380         $(call msg,CLNG-BPF,$(TRUNNER_BINARY),$2)
 381         $(Q)$(CLANG) $3 -O2 -target bpf -c $1 -mcpu=v2 -o $2
 382 endef
 383 # Build BPF object using GCC
 384 define GCC_BPF_BUILD_RULE
 385         $(call msg,GCC-BPF,$(TRUNNER_BINARY),$2)
 386         $(Q)$(BPF_GCC) $3 -O2 -c $1 -o $2
 387 endef
 388
 389 SKEL_BLACKLIST := btf__% test_pinning_invalid.c test_sk_assign.c
 390
 391 LINKED_SKELS := test_static_linked.skel.h linked_funcs.skel.h           \
 392                 linked_vars.skel.h linked_maps.skel.h                   \
 393                 test_subskeleton.skel.h test_subskeleton_lib.skel.h     \
 394                 test_usdt.skel.h
 395
 396 LSKELS := fentry_test.c fexit_test.c fexit_sleep.c atomics.c            \
 397         trace_printk.c trace_vprintk.c map_ptr_kern.c                   \
 398         core_kern.c core_kern_overflow.c test_ringbuf.c                 \
 399         test_ringbuf_map_key.c
 400
 401 # Generate both light skeleton and libbpf skeleton for these
 402 LSKELS_EXTRA := test_ksyms_module.c test_ksyms_weak.c kfunc_call_test.c \
 403         kfunc_call_test_subprog.c
 404 SKEL_BLACKLIST += $$(LSKELS)
 405
 406 test_static_linked.skel.h-deps := test_static_linked1.bpf.o test_static_linked2.bpf.o
 407 linked_funcs.skel.h-deps := linked_funcs1.bpf.o linked_funcs2.bpf.o
 408 linked_vars.skel.h-deps := linked_vars1.bpf.o linked_vars2.bpf.o
 409 linked_maps.skel.h-deps := linked_maps1.bpf.o linked_maps2.bpf.o
 410 # In the subskeleton case, we want the test_subskeleton_lib.subskel.h file
 411 # but that's created as a side-effect of the skel.h generation.
 412 test_subskeleton.skel.h-deps := test_subskeleton_lib2.bpf.o test_subskeleton_lib.bpf.o test_subskeleton.bpf.o
 413 test_subskeleton_lib.skel.h-deps := test_subskeleton_lib2.bpf.o test_subskeleton_lib.bpf.o
 414 test_usdt.skel.h-deps := test_usdt.bpf.o test_usdt_multispec.bpf.o
 415 xsk_xdp_progs.skel.h-deps := xsk_xdp_progs.bpf.o
 416 xdp_hw_metadata.skel.h-deps := xdp_hw_metadata.bpf.o
 417 xdp_features.skel.h-deps := xdp_features.bpf.o
 418
 419 LINKED_BPF_SRCS := $(patsubst %.bpf.o,%.c,$(foreach skel,$(LINKED_SKELS),$($(skel)-deps)))
 420
 421 # Set up extra TRUNNER_XXX "temporary" variables in the environment (relies on
 422 # $eval()) and pass control to DEFINE_TEST_RUNNER_RULES.
 423 # Parameters:
 424 # $1 - test runner base binary name (e.g., test_progs)
 425 # $2 - test runner extra "flavor" (e.g., no_alu32, gcc-bpf, etc)
 426 define DEFINE_TEST_RUNNER
 427
 428 TRUNNER_OUTPUT := $(OUTPUT)$(if $2,/)$2
 429 TRUNNER_BINARY := $1$(if $2,-)$2
 430 TRUNNER_TEST_OBJS := $$(patsubst %.c,$$(TRUNNER_OUTPUT)/%.test.o,       \
 431                                  $$(notdir $$(wildcard $(TRUNNER_TESTS_DIR)/*.c)))
 432 TRUNNER_EXTRA_OBJS := $$(patsubst %.c,$$(TRUNNER_OUTPUT)/%.o,           \
 433                                  $$(filter %.c,$(TRUNNER_EXTRA_SOURCES)))
 434 TRUNNER_EXTRA_HDRS := $$(filter %.h,$(TRUNNER_EXTRA_SOURCES))
 435 TRUNNER_TESTS_HDR := $(TRUNNER_TESTS_DIR)/tests.h
 436 TRUNNER_BPF_SRCS := $$(notdir $$(wildcard $(TRUNNER_BPF_PROGS_DIR)/*.c))
 437 TRUNNER_BPF_OBJS := $$(patsubst %.c,$$(TRUNNER_OUTPUT)/%.bpf.o, $$(TRUNNER_BPF_SRCS))
 438 TRUNNER_BPF_SKELS := $$(patsubst %.c,$$(TRUNNER_OUTPUT)/%.skel.h,       \
 439                                  $$(filter-out $(SKEL_BLACKLIST) $(LINKED_BPF_SRCS),\
 440                                                $$(TRUNNER_BPF_SRCS)))
 441 TRUNNER_BPF_LSKELS := $$(patsubst %.c,$$(TRUNNER_OUTPUT)/%.lskel.h, $$(LSKELS) $$(LSKELS_EXTRA))
 442 TRUNNER_BPF_SKELS_LINKED := $$(addprefix $$(TRUNNER_OUTPUT)/,$(LINKED_SKELS))
 443 TEST_GEN_FILES += $$(TRUNNER_BPF_OBJS)
 444
 445 # Evaluate rules now with extra TRUNNER_XXX variables above already defined
 446 $$(eval $$(call DEFINE_TEST_RUNNER_RULES,$1,$2))
 447
 448 endef
 449
 450 # Using TRUNNER_XXX variables, provided by callers of DEFINE_TEST_RUNNER and
 451 # set up by DEFINE_TEST_RUNNER itself, create test runner build rules with:
 452 # $1 - test runner base binary name (e.g., test_progs)
 453 # $2 - test runner extra "flavor" (e.g., no_alu32, gcc-bpf, etc)
 454 define DEFINE_TEST_RUNNER_RULES
 455
 456 ifeq ($($(TRUNNER_OUTPUT)-dir),)
 457 $(TRUNNER_OUTPUT)-dir := y
 458 $(TRUNNER_OUTPUT):
 459         $$(call msg,MKDIR,,$$@)
 460         $(Q)mkdir -p $$@
 461 endif
 462
 463 # ensure we set up BPF objects generation rule just once for a given
 464 # input/output directory combination
 465 ifeq ($($(TRUNNER_BPF_PROGS_DIR)$(if $2,-)$2-bpfobjs),)
 466 $(TRUNNER_BPF_PROGS_DIR)$(if $2,-)$2-bpfobjs := y
 467 $(TRUNNER_BPF_OBJS): $(TRUNNER_OUTPUT)/%.bpf.o:                         \
 468                      $(TRUNNER_BPF_PROGS_DIR)/%.c                       \
 469                      $(TRUNNER_BPF_PROGS_DIR)/*.h                       \
 470                      $$(INCLUDE_DIR)/vmlinux.h                          \
 471                      $(wildcard $(BPFDIR)/bpf_*.h)                      \
 472                      $(wildcard $(BPFDIR)/*.bpf.h)                      \
 473                      | $(TRUNNER_OUTPUT) $$(BPFOBJ)
 474         $$(call $(TRUNNER_BPF_BUILD_RULE),$$<,$$@,                      \
 475                                           $(TRUNNER_BPF_CFLAGS))
 476
 477 $(TRUNNER_BPF_SKELS): %.skel.h: %.bpf.o $(BPFTOOL) | $(TRUNNER_OUTPUT)
 478         $$(call msg,GEN-SKEL,$(TRUNNER_BINARY),$$@)
 479         $(Q)$$(BPFTOOL) gen object $$(<:.o=.linked1.o) $$<
 480         $(Q)$$(BPFTOOL) gen object $$(<:.o=.linked2.o) $$(<:.o=.linked1.o)
 481         $(Q)$$(BPFTOOL) gen object $$(<:.o=.linked3.o) $$(<:.o=.linked2.o)
 482         $(Q)diff $$(<:.o=.linked2.o) $$(<:.o=.linked3.o)
 483         $(Q)$$(BPFTOOL) gen skeleton $$(<:.o=.linked3.o) name $$(notdir $$(<:.bpf.o=)) > $$@
 484         $(Q)$$(BPFTOOL) gen subskeleton $$(<:.o=.linked3.o) name $$(notdir $$(<:.bpf.o=)) > $$(@:.skel.h=.subskel.h)
 485
 486 $(TRUNNER_BPF_LSKELS): %.lskel.h: %.bpf.o $(BPFTOOL) | $(TRUNNER_OUTPUT)
 487         $$(call msg,GEN-SKEL,$(TRUNNER_BINARY),$$@)
 488         $(Q)$$(BPFTOOL) gen object $$(<:.o=.llinked1.o) $$<
 489         $(Q)$$(BPFTOOL) gen object $$(<:.o=.llinked2.o) $$(<:.o=.llinked1.o)
 490         $(Q)$$(BPFTOOL) gen object $$(<:.o=.llinked3.o) $$(<:.o=.llinked2.o)
 491         $(Q)diff $$(<:.o=.llinked2.o) $$(<:.o=.llinked3.o)
 492         $(Q)$$(BPFTOOL) gen skeleton -L $$(<:.o=.llinked3.o) name $$(notdir $$(<:.bpf.o=_lskel)) > $$@
 493
 494 $(TRUNNER_BPF_SKELS_LINKED): $(TRUNNER_BPF_OBJS) $(BPFTOOL) | $(TRUNNER_OUTPUT)
 495         $$(call msg,LINK-BPF,$(TRUNNER_BINARY),$$(@:.skel.h=.bpf.o))
 496         $(Q)$$(BPFTOOL) gen object $$(@:.skel.h=.linked1.o) $$(addprefix $(TRUNNER_OUTPUT)/,$$($$(@F)-deps))
 497         $(Q)$$(BPFTOOL) gen object $$(@:.skel.h=.linked2.o) $$(@:.skel.h=.linked1.o)
 498         $(Q)$$(BPFTOOL) gen object $$(@:.skel.h=.linked3.o) $$(@:.skel.h=.linked2.o)
 499         $(Q)diff $$(@:.skel.h=.linked2.o) $$(@:.skel.h=.linked3.o)
 500         $$(call msg,GEN-SKEL,$(TRUNNER_BINARY),$$@)
 501         $(Q)$$(BPFTOOL) gen skeleton $$(@:.skel.h=.linked3.o) name $$(notdir $$(@:.skel.h=)) > $$@
 502         $(Q)$$(BPFTOOL) gen subskeleton $$(@:.skel.h=.linked3.o) name $$(notdir $$(@:.skel.h=)) > $$(@:.skel.h=.subskel.h)
 503 endif
 504
 505 # ensure we set up tests.h header generation rule just once
 506 ifeq ($($(TRUNNER_TESTS_DIR)-tests-hdr),)
 507 $(TRUNNER_TESTS_DIR)-tests-hdr := y
 508 $(TRUNNER_TESTS_HDR): $(TRUNNER_TESTS_DIR)/*.c
 509         $$(call msg,TEST-HDR,$(TRUNNER_BINARY),$$@)
 510         $$(shell (echo '/* Generated header, do not edit */';                                   \
 511                   sed -n -E 's/^void (serial_)?test_([a-zA-Z0-9_]+)\((void)?\).*/DEFINE_TEST(\2)/p'     \
 512                         $(TRUNNER_TESTS_DIR)/*.c | sort ;       \
 513                  ) > $$@)
 514 endif
 515
 516 # compile individual test files
 517 # Note: we cd into output directory to ensure embedded BPF object is found
 518 $(TRUNNER_TEST_OBJS): $(TRUNNER_OUTPUT)/%.test.o:                       \
 519                       $(TRUNNER_TESTS_DIR)/%.c                          \
 520                       $(TRUNNER_EXTRA_HDRS)                             \
 521                       $(TRUNNER_BPF_OBJS)                               \
 522                       $(TRUNNER_BPF_SKELS)                              \
 523                       $(TRUNNER_BPF_LSKELS)                             \
 524                       $(TRUNNER_BPF_SKELS_LINKED)                       \
 525                       $$(BPFOBJ) | $(TRUNNER_OUTPUT)
 526         $$(call msg,TEST-OBJ,$(TRUNNER_BINARY),$$@)
 527         $(Q)cd $$(@D) && $$(CC) -I. $$(CFLAGS) -c $(CURDIR)/$$< $$(LDLIBS) -o $$(@F)
 528
 529 $(TRUNNER_EXTRA_OBJS): $(TRUNNER_OUTPUT)/%.o:                           \
 530                        %.c                                              \
 531                        $(TRUNNER_EXTRA_HDRS)                            \
 532                        $(TRUNNER_TESTS_HDR)                             \
 533                        $$(BPFOBJ) | $(TRUNNER_OUTPUT)
 534         $$(call msg,EXT-OBJ,$(TRUNNER_BINARY),$$@)
 535         $(Q)$$(CC) $$(CFLAGS) -c $$< $$(LDLIBS) -o $$@
 536
 537 # non-flavored in-srctree builds receive special treatment, in particular, we
 538 # do not need to copy extra resources (see e.g. test_btf_dump_case())
 539 $(TRUNNER_BINARY)-extras: $(TRUNNER_EXTRA_FILES) | $(TRUNNER_OUTPUT)
 540 ifneq ($2:$(OUTPUT),:$(shell pwd))
 541         $$(call msg,EXT-COPY,$(TRUNNER_BINARY),$(TRUNNER_EXTRA_FILES))
 542         $(Q)rsync -aq $$^ $(TRUNNER_OUTPUT)/
 543 endif
 544
 545 $(OUTPUT)/$(TRUNNER_BINARY): $(TRUNNER_TEST_OBJS)                       \
 546                              $(TRUNNER_EXTRA_OBJS) $$(BPFOBJ)           \
 547                              $(RESOLVE_BTFIDS)                          \
 548                              $(TRUNNER_BPFTOOL)                         \
 549                              | $(TRUNNER_BINARY)-extras
 550         $$(call msg,BINARY,,$$@)
 551         $(Q)$$(CC) $$(CFLAGS) $$(filter %.a %.o,$$^) $$(LDLIBS) -o $$@
 552         $(Q)$(RESOLVE_BTFIDS) --btf $(TRUNNER_OUTPUT)/btf_data.bpf.o $$@
 553         $(Q)ln -sf $(if $2,..,.)/tools/build/bpftool/$(USE_BOOTSTRAP)bpftool \
 554                    $(OUTPUT)/$(if $2,$2/)bpftool
 555
 556 endef
 557
 558 # Define test_progs test runner.
 559 TRUNNER_TESTS_DIR := prog_tests
 560 TRUNNER_BPF_PROGS_DIR := progs
 561 TRUNNER_EXTRA_SOURCES := test_progs.c cgroup_helpers.c trace_helpers.c  \
 562                          network_helpers.c testing_helpers.c            \
 563                          btf_helpers.c flow_dissector_load.h            \
 564                          cap_helpers.c test_loader.c xsk.c disasm.c     \
 565                          json_writer.c unpriv_helpers.c
 566
 567 TRUNNER_EXTRA_FILES := $(OUTPUT)/urandom_read $(OUTPUT)/bpf_testmod.ko  \
 568                        $(OUTPUT)/liburandom_read.so                     \
 569                        $(OUTPUT)/xdp_synproxy                           \
 570                        $(OUTPUT)/sign-file                              \
 571                        ima_setup.sh                                     \
 572                        verify_sig_setup.sh                              \
 573                        $(wildcard progs/btf_dump_test_case_*.c)         \
 574                        $(wildcard progs/*.bpf.o)
 575 TRUNNER_BPF_BUILD_RULE := CLANG_BPF_BUILD_RULE
 576 TRUNNER_BPF_CFLAGS := $(BPF_CFLAGS) $(CLANG_CFLAGS) -DENABLE_ATOMICS_TESTS
 577 $(eval $(call DEFINE_TEST_RUNNER,test_progs))
 578
 579 # Define test_progs-no_alu32 test runner.
 580 TRUNNER_BPF_BUILD_RULE := CLANG_NOALU32_BPF_BUILD_RULE
 581 TRUNNER_BPF_CFLAGS := $(BPF_CFLAGS) $(CLANG_CFLAGS)
 582 $(eval $(call DEFINE_TEST_RUNNER,test_progs,no_alu32))
 583
 584 # Define test_progs BPF-GCC-flavored test runner.
 585 ifneq ($(BPF_GCC),)
 586 TRUNNER_BPF_BUILD_RULE := GCC_BPF_BUILD_RULE
 587 TRUNNER_BPF_CFLAGS := $(BPF_CFLAGS) $(call get_sys_includes,gcc,)
 588 $(eval $(call DEFINE_TEST_RUNNER,test_progs,bpf_gcc))
 589 endif
 590
 591 # Define test_maps test runner.
 592 TRUNNER_TESTS_DIR := map_tests
 593 TRUNNER_BPF_PROGS_DIR := progs
 594 TRUNNER_EXTRA_SOURCES := test_maps.c
 595 TRUNNER_EXTRA_FILES :=
 596 TRUNNER_BPF_BUILD_RULE := $$(error no BPF objects should be built)
 597 TRUNNER_BPF_CFLAGS :=
 598 $(eval $(call DEFINE_TEST_RUNNER,test_maps))
 599
 600 # Define test_verifier test runner.
 601 # It is much simpler than test_maps/test_progs and sufficiently different from
 602 # them (e.g., test.h is using completely pattern), that it's worth just
 603 # explicitly defining all the rules explicitly.
 604 verifier/tests.h: verifier/*.c
 605         $(shell ( cd verifier/; \
 606                   echo '/* Generated header, do not edit */'; \
 607                   echo '#ifdef FILL_ARRAY'; \
 608                   ls *.c 2> /dev/null | sed -e 's@\(.*\)@#include \"\1\"@'; \
 609                   echo '#endif' \
 610                 ) > verifier/tests.h)
 611 $(OUTPUT)/test_verifier: test_verifier.c verifier/tests.h $(BPFOBJ) | $(OUTPUT)
 612         $(call msg,BINARY,,$@)
 613         $(Q)$(CC) $(CFLAGS) $(filter %.a %.o %.c,$^) $(LDLIBS) -o $@
 614
 615 $(OUTPUT)/xskxceiver: xskxceiver.c xskxceiver.h $(OUTPUT)/xsk.o $(OUTPUT)/xsk_xdp_progs.skel.h $(BPFOBJ) | $(OUTPUT)
 616         $(call msg,BINARY,,$@)
 617         $(Q)$(CC) $(CFLAGS) $(filter %.a %.o %.c,$^) $(LDLIBS) -o $@
 618
 619 $(OUTPUT)/xdp_hw_metadata: xdp_hw_metadata.c $(OUTPUT)/network_helpers.o $(OUTPUT)/xsk.o $(OUTPUT)/xdp_hw_metadata.skel.h | $(OUTPUT)
 620         $(call msg,BINARY,,$@)
 621         $(Q)$(CC) $(CFLAGS) $(filter %.a %.o %.c,$^) $(LDLIBS) -o $@
 622
 623 $(OUTPUT)/xdp_features: xdp_features.c $(OUTPUT)/network_helpers.o $(OUTPUT)/xdp_features.skel.h | $(OUTPUT)
 624         $(call msg,BINARY,,$@)
 625         $(Q)$(CC) $(CFLAGS) $(filter %.a %.o %.c,$^) $(LDLIBS) -o $@
 626
 627 # Make sure we are able to include and link libbpf against c++.
 628 $(OUTPUT)/test_cpp: test_cpp.cpp $(OUTPUT)/test_core_extern.skel.h $(BPFOBJ)
 629         $(call msg,CXX,,$@)
 630         $(Q)$(CXX) $(CFLAGS) $(filter %.a %.o %.cpp,$^) $(LDLIBS) -o $@
 631
 632 # Benchmark runner
 633 $(OUTPUT)/bench_%.o: benchs/bench_%.c bench.h $(BPFOBJ)
 634         $(call msg,CC,,$@)
 635         $(Q)$(CC) $(CFLAGS) -O2 -c $(filter %.c,$^) $(LDLIBS) -o $@
 636 $(OUTPUT)/bench_rename.o: $(OUTPUT)/test_overhead.skel.h
 637 $(OUTPUT)/bench_trigger.o: $(OUTPUT)/trigger_bench.skel.h
 638 $(OUTPUT)/bench_ringbufs.o: $(OUTPUT)/ringbuf_bench.skel.h \
 639                             $(OUTPUT)/perfbuf_bench.skel.h
 640 $(OUTPUT)/bench_bloom_filter_map.o: $(OUTPUT)/bloom_filter_bench.skel.h
 641 $(OUTPUT)/bench_bpf_loop.o: $(OUTPUT)/bpf_loop_bench.skel.h
 642 $(OUTPUT)/bench_strncmp.o: $(OUTPUT)/strncmp_bench.skel.h
 643 $(OUTPUT)/bench_bpf_hashmap_full_update.o: $(OUTPUT)/bpf_hashmap_full_update_bench.skel.h
 644 $(OUTPUT)/bench_local_storage.o: $(OUTPUT)/local_storage_bench.skel.h
 645 $(OUTPUT)/bench_local_storage_rcu_tasks_trace.o: $(OUTPUT)/local_storage_rcu_tasks_trace_bench.skel.h
 646 $(OUTPUT)/bench_local_storage_create.o: $(OUTPUT)/bench_local_storage_create.skel.h
 647 $(OUTPUT)/bench_bpf_hashmap_lookup.o: $(OUTPUT)/bpf_hashmap_lookup.skel.h
 648 $(OUTPUT)/bench.o: bench.h testing_helpers.h $(BPFOBJ)
 649 $(OUTPUT)/bench: LDLIBS += -lm
 650 $(OUTPUT)/bench: $(OUTPUT)/bench.o \
 651                  $(TESTING_HELPERS) \
 652                  $(TRACE_HELPERS) \
 653                  $(OUTPUT)/bench_count.o \
 654                  $(OUTPUT)/bench_rename.o \
 655                  $(OUTPUT)/bench_trigger.o \
 656                  $(OUTPUT)/bench_ringbufs.o \
 657                  $(OUTPUT)/bench_bloom_filter_map.o \
 658                  $(OUTPUT)/bench_bpf_loop.o \
 659                  $(OUTPUT)/bench_strncmp.o \
 660                  $(OUTPUT)/bench_bpf_hashmap_full_update.o \
 661                  $(OUTPUT)/bench_local_storage.o \
 662                  $(OUTPUT)/bench_local_storage_rcu_tasks_trace.o \
 663                  $(OUTPUT)/bench_bpf_hashmap_lookup.o \
 664                  $(OUTPUT)/bench_local_storage_create.o \
 665                  #
 666         $(call msg,BINARY,,$@)
 667         $(Q)$(CC) $(CFLAGS) $(LDFLAGS) $(filter %.a %.o,$^) $(LDLIBS) -o $@
 668
 669 $(OUTPUT)/veristat.o: $(BPFOBJ)
 670 $(OUTPUT)/veristat: $(OUTPUT)/veristat.o
 671         $(call msg,BINARY,,$@)
 672         $(Q)$(CC) $(CFLAGS) $(LDFLAGS) $(filter %.a %.o,$^) $(LDLIBS) -o $@
 673
 674 EXTRA_CLEAN := $(TEST_CUSTOM_PROGS) $(SCRATCH_DIR) $(HOST_SCRATCH_DIR)  \
 675         prog_tests/tests.h map_tests/tests.h verifier/tests.h           \
 676         feature bpftool                                                 \
 677         $(addprefix $(OUTPUT)/,*.o *.skel.h *.lskel.h *.subskel.h       \
 678                                no_alu32 bpf_gcc bpf_testmod.ko          \
 679                                liburandom_read.so)
 680
 681 .PHONY: docs docs-clean
 682
 683 # Delete partially updated (corrupted) files on error
 684 .DELETE_ON_ERROR: