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