tools/lib/bpf/Makefile

   1 # SPDX-License-Identifier: (LGPL-2.1 OR BSD-2-Clause)
   2 # Most of this file is copied from tools/lib/traceevent/Makefile
   3
   4 LIBBPF_VERSION := $(shell \
   5         grep -oE '^LIBBPF_([0-9.]+)' libbpf.map | \
   6         sort -rV | head -n1 | cut -d'_' -f2)
   7 LIBBPF_MAJOR_VERSION := $(firstword $(subst ., ,$(LIBBPF_VERSION)))
   8
   9 MAKEFLAGS += --no-print-directory
  10
  11 # This will work when bpf is built in tools env. where srctree
  12 # isn't set and when invoked from selftests build, where srctree
  13 # is a ".". building_out_of_srctree is undefined for in srctree
  14 # builds
  15 ifndef building_out_of_srctree
  16 srctree := $(patsubst %/,%,$(dir $(CURDIR)))
  17 srctree := $(patsubst %/,%,$(dir $(srctree)))
  18 srctree := $(patsubst %/,%,$(dir $(srctree)))
  19 #$(info Determined 'srctree' to be $(srctree))
  20 endif
  21
  22 INSTALL = install
  23
  24 # Use DESTDIR for installing into a different root directory.
  25 # This is useful for building a package. The program will be
  26 # installed in this directory as if it was the root directory.
  27 # Then the build tool can move it later.
  28 DESTDIR ?=
  29 DESTDIR_SQ = '$(subst ','\'',$(DESTDIR))'
  30
  31 include $(srctree)/tools/scripts/Makefile.arch
  32
  33 ifeq ($(LP64), 1)
  34   libdir_relative = lib64
  35 else
  36   libdir_relative = lib
  37 endif
  38
  39 prefix ?= /usr/local
  40 libdir = $(prefix)/$(libdir_relative)
  41 man_dir = $(prefix)/share/man
  42 man_dir_SQ = '$(subst ','\'',$(man_dir))'
  43
  44 export man_dir man_dir_SQ INSTALL
  45 export DESTDIR DESTDIR_SQ
  46
  47 include $(srctree)/tools/scripts/Makefile.include
  48
  49 # copy a bit from Linux kbuild
  50
  51 ifeq ("$(origin V)", "command line")
  52   VERBOSE = $(V)
  53 endif
  54 ifndef VERBOSE
  55   VERBOSE = 0
  56 endif
  57
  58 FEATURE_USER = .libbpf
  59 FEATURE_TESTS = libelf libelf-mmap bpf reallocarray cxx
  60 FEATURE_DISPLAY = libelf bpf
  61
  62 INCLUDES = -I. -I$(srctree)/tools/include -I$(srctree)/tools/arch/$(ARCH)/include/uapi -I$(srctree)/tools/include/uapi
  63 FEATURE_CHECK_CFLAGS-bpf = $(INCLUDES)
  64
  65 check_feat := 1
  66 NON_CHECK_FEAT_TARGETS := clean TAGS tags cscope help
  67 ifdef MAKECMDGOALS
  68 ifeq ($(filter-out $(NON_CHECK_FEAT_TARGETS),$(MAKECMDGOALS)),)
  69   check_feat := 0
  70 endif
  71 endif
  72
  73 ifeq ($(check_feat),1)
  74 ifeq ($(FEATURES_DUMP),)
  75 include $(srctree)/tools/build/Makefile.feature
  76 else
  77 include $(FEATURES_DUMP)
  78 endif
  79 endif
  80
  81 export prefix libdir src obj
  82
  83 # Shell quotes
  84 libdir_SQ = $(subst ','\'',$(libdir))
  85 libdir_relative_SQ = $(subst ','\'',$(libdir_relative))
  86
  87 OBJ             = $@
  88 N               =
  89
  90 LIB_TARGET      = libbpf.a libbpf.so.$(LIBBPF_VERSION)
  91 LIB_FILE        = libbpf.a libbpf.so*
  92 PC_FILE         = libbpf.pc
  93
  94 # Set compile option CFLAGS
  95 ifdef EXTRA_CFLAGS
  96   CFLAGS := $(EXTRA_CFLAGS)
  97 else
  98   CFLAGS := -g -Wall
  99 endif
 100
 101 ifeq ($(feature-libelf-mmap), 1)
 102   override CFLAGS += -DHAVE_LIBELF_MMAP_SUPPORT
 103 endif
 104
 105 ifeq ($(feature-reallocarray), 0)
 106   override CFLAGS += -DCOMPAT_NEED_REALLOCARRAY
 107 endif
 108
 109 # Append required CFLAGS
 110 override CFLAGS += $(EXTRA_WARNINGS)
 111 override CFLAGS += -Werror -Wall
 112 override CFLAGS += -fPIC
 113 override CFLAGS += $(INCLUDES)
 114 override CFLAGS += -fvisibility=hidden
 115 override CFLAGS += -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64
 116
 117 # flags specific for shared library
 118 SHLIB_FLAGS := -DSHARED
 119
 120 ifeq ($(VERBOSE),1)
 121   Q =
 122 else
 123   Q = @
 124 endif
 125
 126 # Disable command line variables (CFLAGS) override from top
 127 # level Makefile (perf), otherwise build Makefile will get
 128 # the same command line setup.
 129 MAKEOVERRIDES=
 130
 131 all:
 132
 133 export srctree OUTPUT CC LD CFLAGS V
 134 include $(srctree)/tools/build/Makefile.include
 135
 136 SHARED_OBJDIR   := $(OUTPUT)sharedobjs/
 137 STATIC_OBJDIR   := $(OUTPUT)staticobjs/
 138 BPF_IN_SHARED   := $(SHARED_OBJDIR)libbpf-in.o
 139 BPF_IN_STATIC   := $(STATIC_OBJDIR)libbpf-in.o
 140 VERSION_SCRIPT  := libbpf.map
 141
 142 LIB_TARGET      := $(addprefix $(OUTPUT),$(LIB_TARGET))
 143 LIB_FILE        := $(addprefix $(OUTPUT),$(LIB_FILE))
 144 PC_FILE         := $(addprefix $(OUTPUT),$(PC_FILE))
 145
 146 GLOBAL_SYM_COUNT = $(shell readelf -s --wide $(BPF_IN_SHARED) | \
 147                            cut -d "@" -f1 | sed 's/_v[0-9]_[0-9]_[0-9].*//' | \
 148                            awk '/GLOBAL/ && /DEFAULT/ && !/UND/ {print $$8}' | \
 149                            sort -u | wc -l)
 150 VERSIONED_SYM_COUNT = $(shell readelf -s --wide $(OUTPUT)libbpf.so | \
 151                               grep -Eo '[^ ]+@LIBBPF_' | cut -d@ -f1 | sort -u | wc -l)
 152
 153 CMD_TARGETS = $(LIB_TARGET) $(PC_FILE)
 154
 155 CXX_TEST_TARGET = $(OUTPUT)test_libbpf
 156
 157 ifeq ($(feature-cxx), 1)
 158         CMD_TARGETS += $(CXX_TEST_TARGET)
 159 endif
 160
 161 TARGETS = $(CMD_TARGETS)
 162
 163 all: fixdep
 164         $(Q)$(MAKE) all_cmd
 165
 166 all_cmd: $(CMD_TARGETS) check
 167
 168 $(BPF_IN_SHARED): force elfdep bpfdep
 169         @(test -f ../../include/uapi/linux/bpf.h -a -f ../../../include/uapi/linux/bpf.h && ( \
 170         (diff -B ../../include/uapi/linux/bpf.h ../../../include/uapi/linux/bpf.h >/dev/null) || \
 171         echo "Warning: Kernel ABI header at 'tools/include/uapi/linux/bpf.h' differs from latest version at 'include/uapi/linux/bpf.h'" >&2 )) || true
 172         @(test -f ../../include/uapi/linux/bpf_common.h -a -f ../../../include/uapi/linux/bpf_common.h && ( \
 173         (diff -B ../../include/uapi/linux/bpf_common.h ../../../include/uapi/linux/bpf_common.h >/dev/null) || \
 174         echo "Warning: Kernel ABI header at 'tools/include/uapi/linux/bpf_common.h' differs from latest version at 'include/uapi/linux/bpf_common.h'" >&2 )) || true
 175         @(test -f ../../include/uapi/linux/netlink.h -a -f ../../../include/uapi/linux/netlink.h && ( \
 176         (diff -B ../../include/uapi/linux/netlink.h ../../../include/uapi/linux/netlink.h >/dev/null) || \
 177         echo "Warning: Kernel ABI header at 'tools/include/uapi/linux/netlink.h' differs from latest version at 'include/uapi/linux/netlink.h'" >&2 )) || true
 178         @(test -f ../../include/uapi/linux/if_link.h -a -f ../../../include/uapi/linux/if_link.h && ( \
 179         (diff -B ../../include/uapi/linux/if_link.h ../../../include/uapi/linux/if_link.h >/dev/null) || \
 180         echo "Warning: Kernel ABI header at 'tools/include/uapi/linux/if_link.h' differs from latest version at 'include/uapi/linux/if_link.h'" >&2 )) || true
 181         @(test -f ../../include/uapi/linux/if_xdp.h -a -f ../../../include/uapi/linux/if_xdp.h && ( \
 182         (diff -B ../../include/uapi/linux/if_xdp.h ../../../include/uapi/linux/if_xdp.h >/dev/null) || \
 183         echo "Warning: Kernel ABI header at 'tools/include/uapi/linux/if_xdp.h' differs from latest version at 'include/uapi/linux/if_xdp.h'" >&2 )) || true
 184         $(Q)$(MAKE) $(build)=libbpf OUTPUT=$(SHARED_OBJDIR) CFLAGS="$(CFLAGS) $(SHLIB_FLAGS)"
 185
 186 $(BPF_IN_STATIC): force elfdep bpfdep
 187         $(Q)$(MAKE) $(build)=libbpf OUTPUT=$(STATIC_OBJDIR)
 188
 189 $(OUTPUT)libbpf.so: $(OUTPUT)libbpf.so.$(LIBBPF_VERSION)
 190
 191 $(OUTPUT)libbpf.so.$(LIBBPF_VERSION): $(BPF_IN_SHARED)
 192         $(QUIET_LINK)$(CC) --shared -Wl,-soname,libbpf.so.$(LIBBPF_MAJOR_VERSION) \
 193                                     -Wl,--version-script=$(VERSION_SCRIPT) $^ -lelf -o $@
 194         @ln -sf $(@F) $(OUTPUT)libbpf.so
 195         @ln -sf $(@F) $(OUTPUT)libbpf.so.$(LIBBPF_MAJOR_VERSION)
 196
 197 $(OUTPUT)libbpf.a: $(BPF_IN_STATIC)
 198         $(QUIET_LINK)$(RM) $@; $(AR) rcs $@ $^
 199
 200 $(OUTPUT)test_libbpf: test_libbpf.cpp $(OUTPUT)libbpf.a
 201         $(QUIET_LINK)$(CXX) $(INCLUDES) $^ -lelf -o $@
 202
 203 $(OUTPUT)libbpf.pc:
 204         $(QUIET_GEN)sed -e "s|@PREFIX@|$(prefix)|" \
 205                 -e "s|@LIBDIR@|$(libdir_SQ)|" \
 206                 -e "s|@VERSION@|$(LIBBPF_VERSION)|" \
 207                 < libbpf.pc.template > $@
 208
 209 check: check_abi
 210
 211 check_abi: $(OUTPUT)libbpf.so
 212         @if [ "$(GLOBAL_SYM_COUNT)" != "$(VERSIONED_SYM_COUNT)" ]; then  \
 213                 echo "Warning: Num of global symbols in $(BPF_IN_SHARED)"        \
 214                      "($(GLOBAL_SYM_COUNT)) does NOT match with num of"  \
 215                      "versioned symbols in $^ ($(VERSIONED_SYM_COUNT))." \
 216                      "Please make sure all LIBBPF_API symbols are"       \
 217                      "versioned in $(VERSION_SCRIPT)." >&2;              \
 218                 readelf -s --wide $(OUTPUT)libbpf-in.o |                 \
 219                     cut -d "@" -f1 | sed 's/_v[0-9]_[0-9]_[0-9].*//' |   \
 220                     awk '/GLOBAL/ && /DEFAULT/ && !/UND/ {print $$8}'|   \
 221                     sort -u > $(OUTPUT)libbpf_global_syms.tmp;           \
 222                 readelf -s --wide $(OUTPUT)libbpf.so |                   \
 223                     grep -Eo '[^ ]+@LIBBPF_' | cut -d@ -f1 |             \
 224                     sort -u > $(OUTPUT)libbpf_versioned_syms.tmp;        \
 225                 diff -u $(OUTPUT)libbpf_global_syms.tmp                  \
 226                      $(OUTPUT)libbpf_versioned_syms.tmp;                 \
 227                 rm $(OUTPUT)libbpf_global_syms.tmp                       \
 228                    $(OUTPUT)libbpf_versioned_syms.tmp;                   \
 229                 exit 1;                                                  \
 230         fi
 231
 232 define do_install_mkdir
 233         if [ ! -d '$(DESTDIR_SQ)$1' ]; then             \
 234                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$1'; \
 235         fi
 236 endef
 237
 238 define do_install
 239         if [ ! -d '$(DESTDIR_SQ)$2' ]; then             \
 240                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$2'; \
 241         fi;                                             \
 242         $(INSTALL) $1 $(if $3,-m $3,) '$(DESTDIR_SQ)$2'
 243 endef
 244
 245 install_lib: all_cmd
 246         $(call QUIET_INSTALL, $(LIB_TARGET)) \
 247                 $(call do_install_mkdir,$(libdir_SQ)); \
 248                 cp -fpR $(LIB_FILE) $(DESTDIR)$(libdir_SQ)
 249
 250 install_headers:
 251         $(call QUIET_INSTALL, headers) \
 252                 $(call do_install,bpf.h,$(prefix)/include/bpf,644); \
 253                 $(call do_install,libbpf.h,$(prefix)/include/bpf,644); \
 254                 $(call do_install,btf.h,$(prefix)/include/bpf,644); \
 255                 $(call do_install,libbpf_util.h,$(prefix)/include/bpf,644); \
 256                 $(call do_install,xsk.h,$(prefix)/include/bpf,644);
 257
 258 install_pkgconfig: $(PC_FILE)
 259         $(call QUIET_INSTALL, $(PC_FILE)) \
 260                 $(call do_install,$(PC_FILE),$(libdir_SQ)/pkgconfig,644)
 261
 262 install: install_lib install_pkgconfig
 263
 264 ### Cleaning rules
 265
 266 config-clean:
 267         $(call QUIET_CLEAN, config)
 268         $(Q)$(MAKE) -C $(srctree)/tools/build/feature/ clean >/dev/null
 269
 270 clean:
 271         $(call QUIET_CLEAN, libbpf) $(RM) -rf $(TARGETS) $(CXX_TEST_TARGET) \
 272                 *.o *~ *.a *.so *.so.$(LIBBPF_MAJOR_VERSION) .*.d .*.cmd \
 273                 *.pc LIBBPF-CFLAGS $(SHARED_OBJDIR) $(STATIC_OBJDIR)
 274         $(call QUIET_CLEAN, core-gen) $(RM) $(OUTPUT)FEATURE-DUMP.libbpf
 275
 276
 277
 278 PHONY += force elfdep bpfdep
 279 force:
 280
 281 elfdep:
 282         @if [ "$(feature-libelf)" != "1" ]; then echo "No libelf found"; exit 1 ; fi
 283
 284 bpfdep:
 285         @if [ "$(feature-bpf)" != "1" ]; then echo "BPF API too old"; exit 1 ; fi
 286
 287 # Declare the contents of the .PHONY variable as phony.  We keep that
 288 # information in a variable so we can use it in if_changed and friends.
 289 .PHONY: $(PHONY)