tools/perf/Makefile.perf

1 # SPDX-License-Identifier: GPL-2.0-only
16 # Define ARCH as name of target architecture if you want cross-builds.
18 # Define CROSS_COMPILE as prefix name of compiler if you want cross-builds.
27 # Define PYTHON_CONFIG to point to the python-config binary if
28 # the default `$(PYTHON)-config' is not correct.
34 # Define LDFLAGS=-static to build a static binary.
36 # Define EXTRA_CFLAGS=-m64 or EXTRA_CFLAGS=-m32 as appropriate for cross-builds.
38 # Define EXCLUDE_EXTLIBS=-lmylib to exclude libmylib from the auto-generated
43 # Define NO_DWARF if you do not want debug-info analysis feature at all.
55 # Define NO_LIBELF if you do not want libelf dependency (e.g. cross-builds)
69 # used for generating build-ids for ELFs generated by jitdump.
74 # Define NO_PERF_READ_VDSO32 if you do not want to build perf-read-vdso32
75 # for reading the 32-bit compatibility VDSO in 64-bit mode
77 # Define NO_PERF_READ_VDSOX32 if you do not want to build perf-read-vdsox32
78 # for reading the x32 mode 32-bit compatibility VDSO in 64-bit mode
105 # When selected, pass LLVM_CONFIG=/path/to/llvm-config to `make' if
106 # llvm-config is not in $PATH.
161 # Do not use make's built-in rules
162 # (this improves performance and avoids hard-to-debug behaviour);
163 MAKEFLAGS += -r
170 define allow-override
182 PKG_CONFIG = $(CROSS_COMPILE)pkg-config
183 LLVM_CONFIG ?= llvm-config
185 RM      = rm -f
186 LN      = ln -f
196 # non-config cases
199 NON_CONFIG_TARGETS := clean python-clean TAGS tags cscope help
202 ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
207 # The fixdep build - we force fixdep tool to be built as
227 goals := $(filter-out all sub-make, $(MAKECMDGOALS))
229 $(goals) all: sub-make
231 sub-make: fixdep
232 	@./check-headers.sh
233 	$(Q)$(MAKE) FIXDEP=1 -f Makefile.perf $(goals)
250 ifeq ($(filter feature-dump,$(MAKECMDGOALS)),feature-dump)
259 -include arch/$(SRCARCH)/Makefile
266 FEATURE_DUMP_EXPORT := $(realpath $(OUTPUT)FEATURE-DUMP)
273 # sparse is architecture-neutral, which means that we need to tell it
275 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
281 SCRIPT_SH += perf-archive.sh
282 SCRIPT_SH += perf-with-kcore.sh
284 grep-libs = $(filter -l%,$(1))
285 strip-libs = $(filter-out -l%,$(1))
310 LIBTRACEEVENT_DYNAMIC_LIST = $(PLUGINS_PATH)libtraceevent-dynamic-list
316 DYNAMIC_LIST_LDFLAGS               = -Xlinker --dynamic-list=$(LIBTRACEEVENT_DYNAMIC_LIST)
317 LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS = $(if $(findstring -static,$(LDFLAGS)),,$(DYNAMIC_LIST_LDFLAGS))
335 python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf*.so
337 PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
338 PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
345 PROGRAMS += $(OUTPUT)perf-read-vdso32
349 PROGRAMS += $(OUTPUT)perf-read-vdsox32
352 LIBJVMTI = libperf-jvmti.so
386   CFLAGS += -I$(OUTPUT)
390   ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
391   GTK_IN := $(OUTPUT)gtk-in.o
398 EXTLIBS := $(call filter-out,$(EXCLUDE_EXTLIBS),$(EXTLIBS))
399 LIBS = -Wl,--whole-archive $(PERFLIBS) $(EXTRA_PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $…
403 …CLANGLIBS_NOEXT_LIST = $(foreach l,$(CLANGLIBS_LIST),$(shell $(LLVM_CONFIG) --libdir)/libclang$(l))
405   LIBS += -Wl,--start-group $(LIBCLANG) -Wl,--end-group
409   LIBLLVM = $(shell $(LLVM_CONFIG) --libs all) $(shell $(LLVM_CONFIG) --system-libs)
410   LIBS += -L$(shell $(LLVM_CONFIG) --libdir) $(LIBLLVM)
414   LIBS += -lstdc++
425 asm_generic_uapi_dir := $(srctree)/tools/include/uapi/asm-generic
437 _dummy := $(shell [ -d '$(beauty_ioctl_outdir)' ] || mkdir -p '$(beauty_ioctl_outdir)')
467 asm_generic_hdr_dir := $(srctree)/tools/include/uapi/asm-generic/
470 $(pkey_alloc_access_rights_array): $(asm_generic_hdr_dir)/mman-common.h $(pkey_alloc_access_rights_…
528 madvise_hdr_dir := $(srctree)/tools/include/uapi/asm-generic/
531 $(madvise_behavior_array): $(madvise_hdr_dir)/mman-common.h $(madvise_behavior_tbl)
537 …uapi_dir)/mman.h $(asm_generic_uapi_dir)/mman.h $(asm_generic_uapi_dir)/mman-common.h $(mmap_flags…
562 $(mmap_prot_array): $(asm_generic_uapi_dir)/mman.h $(asm_generic_uapi_dir)/mman-common.h $(mmap_pro…
593 $(x86_arch_MSRs_array): $(x86_arch_asm_dir)/msr-index.h $(x86_arch_MSRs_tbl)
618 _dummy := $(shell [ -d '$(OUTPUT)python' ] || mkdir -p '$(OUTPUT)python')
621 	$(QUIET_GEN)LDSHARED="$(CC) -pthread -shared" \
624 	  --quiet build_ext; \
635 PERF_IN := $(OUTPUT)perf-in.o
637 JEVENTS       := $(OUTPUT)pmu-events/jevents
638 JEVENTS_IN    := $(OUTPUT)pmu-events/jevents-in.o
640 PMU_EVENTS_IN := $(OUTPUT)pmu-events/pmu-events-in.o
644 build := -f $(srctree)/tools/build/Makefile.build dir=. obj
650 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=jevents
653 	$(QUIET_LINK)$(HOSTCC) $(JEVENTS_IN) -o $@
656 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=pmu-events
660 		$(PERF_IN) $(PMU_EVENTS_IN) $(LIBS) -o $@
665 $(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
666 	$(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
668 $(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
670 $(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
671 	$(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
676 $(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
677 	$(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
678 	$(Q)touch $(OUTPUT)PERF-VERSION-FILE
682 	: $(OUTPUT)PERF-VERSION-FILE
693 pmu-events/%.o: $(OUTPUT)pmu-events/%.o
708 __build-dir = $(subst $(OUTPUT),,$(dir $@))
709 build-dir   = $(if $(__build-dir),$(__build-dir),.)
711 prepare: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h archheaders $(drm_ioctl_array) \
741 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
744 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
747 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
749 $(OUTPUT)%-bison.o: %.c prepare FORCE
750 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
752 $(OUTPUT)%-flex.o: %.c prepare FORCE
753 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
756 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
759 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
761 $(OUTPUT)perf-%: %.o $(PERFLIBS)
762 	$(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
765 $(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-map.c
766 	$(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
770 $(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-map.c
771 	$(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
775 LIBJVMTI_IN := $(OUTPUT)jvmti/jvmti-in.o
778 	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=jvmti obj=jvmti
781 	$(QUIET_LINK)$(CC) $(LDFLAGS) -shared -Wl,-soname -Wl,$(LIBJVMTI) -o $@ $<
784 $(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
789 	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a
792 	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR)plugins $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) plugins
795 …$(Q)$(MAKE) -C $(TRACE_EVENT_DIR)plugins $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent…
797 $(LIBTRACEEVENT)-clean:
799 	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
801 install-traceevent-plugins: libtraceevent_plugins
802 	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
805 	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
807 $(LIBAPI)-clean:
809 	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
812 	$(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) $(OUTPUT)libbpf.a FEATURES_DUMP=$(FEATURE_DUMP_EXPORT)
814 $(LIBBPF)-clean:
816 	$(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) clean >/dev/null
819 	$(Q)$(MAKE) -C $(LIBPERF_DIR) EXTRA_CFLAGS="$(LIBPERF_CFLAGS)" O=$(OUTPUT) $(OUTPUT)libperf.a
821 $(LIBPERF)-clean:
823 	$(Q)$(MAKE) -C $(LIBPERF_DIR) O=$(OUTPUT) clean >/dev/null
826 	$(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) $(OUTPUT)libsubcmd.a
828 $(LIBSUBCMD)-clean:
829 	$(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) clean
833 	@echo '  doc		- make *all* documentation (see below)'
834 	@echo '  man		- make manpage documentation (access with man <foo>)'
835 	@echo '  html		- make html documentation'
836 	@echo '  info		- make GNU info documentation (access with info <foo>)'
837 	@echo '  pdf		- make pdf documentation'
838 	@echo '  TAGS		- use etags to make tag information for source browsing'
839 	@echo '  tags		- use ctags to make tag information for source browsing'
840 	@echo '  cscope	- use cscope to make interactive browsing database'
845 	@echo '        path like "make prefix=/usr/local install install-doc"'
846 	@echo '  install	- install compiled binaries'
847 	@echo '  install-doc	- install *all* documentation'
848 	@echo '  install-man	- install manpage documentation'
849 	@echo '  install-html	- install html documentation'
850 	@echo '  install-info	- install GNU info documentation'
851 	@echo '  install-pdf	- install pdf documentation'
853 	@echo '  quick-install-doc	- alias for quick-install-man'
854 	@echo '  quick-install-man	- install the documentation quickly'
855 	@echo '  quick-install-html	- install the html documentation quickly'
858 	@echo '  clean			- clean all binary objects and build output'
863 INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
864 INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
866 # 'make doc' should call 'make -C Documentation all'
868 	$(Q)$(MAKE) -C $(DOC_DIR) O=$(OUTPUT) $(@:doc=all) ASCIIDOC_EXTRA=$(ASCIIDOC_EXTRA)
875 	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs etags -a $(TAG_FILES)
879 	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs ctags -a $(TAG_FILES)
883 …$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs cscope -b $(TAG_FILE…
891 check: $(OUTPUT)common-cmds.h
905 install-gtk: $(OUTPUT)libperf-gtk.so
907 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
908 		$(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
910 install-gtk:
913 install-tools: all install-gtk
915 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
919 	$(call QUIET_INSTALL, perf-read-vdso32) \
920 		$(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
923 	$(call QUIET_INSTALL, perf-read-vdsox32) \
924 		$(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
928 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
932 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
934 	$(call QUIET_INSTALL, bpf-headers) \
935 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf'; \
936 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf/linux'; \
937 		$(INSTALL) include/bpf/*.h -t '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf'; \
938 		$(INSTALL) include/bpf/linux/*.h -t '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf/linux'
939 	$(call QUIET_INSTALL, bpf-examples) \
940 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_examples_instdir_SQ)/bpf'; \
941 		$(INSTALL) examples/bpf/*.c -t '$(DESTDIR_SQ)$(perf_examples_instdir_SQ)/bpf'
943 	$(call QUIET_INSTALL, perf-archive) \
944 		$(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
945 	$(call QUIET_INSTALL, perf-with-kcore) \
946 		$(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
949 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'; \
950 		$(INSTALL) trace/strace/groups/* -t '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'
953 	$(call QUIET_INSTALL, perl-scripts) \
954 …$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Tr…
955 …$(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/s…
956 		$(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
957 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
958 		$(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
961 	$(call QUIET_INSTALL, python-scripts) \
962 …$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/…
963 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
964 …TALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -m 644 -t '$(DESTDIR_SQ)$(perfexec_instdir_S…
965 		$(INSTALL) scripts/python/*.py -m 644 -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
966 		$(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
968 	$(call QUIET_INSTALL, perf_completion-script) \
969 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
970 		$(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
971 	$(call QUIET_INSTALL, perf-tip) \
972 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(tip_instdir_SQ)'; \
973 		$(INSTALL) Documentation/tips.txt -t '$(DESTDIR_SQ)$(tip_instdir_SQ)'
975 install-tests: all install-gtk
977 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
979 		$(INSTALL) tests/pe-file.exe* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
980 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
982 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell'; \
984 		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell/lib'; \
987 install-bin: install-tools install-tests install-traceevent-plugins
989 install: install-bin try-install-man
991 install-python_ext:
992 	$(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
994 # 'make install-doc' should call 'make -C Documentation install'
996 	$(Q)$(MAKE) -C $(DOC_DIR) O=$(OUTPUT) $(@:-doc=) ASCIIDOC_EXTRA=$(ASCIIDOC_EXTRA)
1004 config-clean:
1006 …$(Q)$(MAKE) -C $(srctree)/tools/build/feature/ $(if $(OUTPUT),OUTPUT=$(OUTPUT)feature/,) clean >/d…
1008 python-clean:
1009 	$(python-clean)
1011 …ean:: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean $(LIBBPF)-clean $(LIBSUBCMD)-clean $(LIBPERF)-clean c…
1012 …$(call QUIET_CLEAN, core-objs)  $(RM) $(LIBPERF_A) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore …
1013 …$(Q)find $(if $(OUTPUT),$(OUTPUT),.) -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.…
1014 	$(Q)$(RM) $(OUTPUT).config-detected
1015 …$(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32 $(OU…
1016 …-gen)   $(RM)  *.spec *.pyc *.pyo */*.pyc */*.pyo $(OUTPUT)common-cmds.h TAGS tags cscope* $(OUTPU…
1017 		$(OUTPUT)util/intel-pt-decoder/inat-tables.c \
1018 		$(OUTPUT)tests/llvm-src-{base,kbuild,prologue,relocation}.c \
1019 		$(OUTPUT)pmu-events/pmu-events.c \
1049 	$(MAKE) -C $(DOC_DIR) O=$(OUTPUT) clean >/dev/null
1052 # To provide FEATURE-DUMP into $(FEATURE_DUMP_COPY)
1054 feature-dump:
1056 	@cp $(OUTPUT)FEATURE-DUMP $(FEATURE_DUMP_COPY)
1057 	@echo "FEATURE-DUMP file copied into $(FEATURE_DUMP_COPY)"
1059 	@echo "FEATURE-DUMP file available in $(OUTPUT)FEATURE-DUMP"
1063 # Trick: if ../../.git does not exist - we are building out of tree for example,
1067     GIT-HEAD-PHONY = ../../.git/HEAD
1069     GIT-HEAD-PHONY =
1074 .PHONY: all install clean config-clean strip install-gtk
1076 .PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE prepare