1 include ../scripts/Makefile.include
3 # The default target of this Makefile is...
6 include ../scripts/utilities.mak
8 # Define V to have a more verbose compile.
10 # Define VF to have a more verbose feature check output.
12 # Define O to save output files in a separate directory.
14 # Define ARCH as name of target architecture if you want cross-builds.
16 # Define CROSS_COMPILE as prefix name of compiler if you want cross-builds.
18 # Define NO_LIBPERL to disable perl script extension.
20 # Define NO_LIBPYTHON to disable python script extension.
22 # Define PYTHON to point to the python binary if the default
23 # `python' is not correct; for example: PYTHON=python2
25 # Define PYTHON_CONFIG to point to the python-config binary if
26 # the default `$(PYTHON)-config' is not correct.
28 # Define ASCIIDOC8 if you want to format documentation with AsciiDoc 8
30 # Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72.
32 # Define LDFLAGS=-static to build a static binary.
34 # Define EXTRA_CFLAGS=-m64 or EXTRA_CFLAGS=-m32 as appropriate for cross-builds.
36 # Define NO_DWARF if you do not want debug-info analysis feature at all.
38 # Define WERROR=0 to disable treating any warnings as errors.
40 # Define NO_NEWT if you do not want TUI support. (deprecated)
42 # Define NO_SLANG if you do not want TUI support.
44 # Define NO_GTK2 if you do not want GTK+ GUI support.
46 # Define NO_DEMANGLE if you do not want C++ symbol demangling.
48 # Define NO_LIBELF if you do not want libelf dependency (e.g. cross-builds)
50 # Define NO_LIBUNWIND if you do not want libunwind dependency for dwarf
51 # backtrace post unwind.
53 # Define NO_BACKTRACE if you do not want stack backtrace debug feature
55 # Define NO_LIBNUMA if you do not want numa perf benchmark
57 # Define NO_LIBAUDIT if you do not want libaudit support
59 # Define NO_LIBBIONIC if you do not want bionic support
61 # Define NO_LIBCRYPTO if you do not want libcrypto (openssl) support
62 # used for generating build-ids for ELFs generated by jitdump.
64 # Define NO_LIBDW_DWARF_UNWIND if you do not want libdw support
65 # for dwarf backtrace post unwind.
67 # Define NO_PERF_READ_VDSO32 if you do not want to build perf-read-vdso32
68 # for reading the 32-bit compatibility VDSO in 64-bit mode
70 # Define NO_PERF_READ_VDSOX32 if you do not want to build perf-read-vdsox32
71 # for reading the x32 mode 32-bit compatibility VDSO in 64-bit mode
73 # Define NO_ZLIB if you do not want to support compressed kernel modules
75 # Define LIBBABELTRACE if you DO want libbabeltrace support
76 # for CTF data format.
78 # Define NO_LZMA if you do not want to support compressed (xz) kernel modules
80 # Define NO_AUXTRACE if you do not want AUX area tracing support
82 # Define NO_LIBBPF if you do not want BPF support
84 # Define NO_SDT if you do not want to define SDT event in perf tools,
85 # note that it doesn't disable SDT scanning support.
87 # Define FEATURES_DUMP to provide features detection dump file
88 # and bypass the feature detection
90 # As per kernel Makefile, avoid funny character set dependencies
94 export LC_COLLATE LC_NUMERIC
97 srctree := $(patsubst %/,%,$(dir $(shell pwd)))
98 srctree := $(patsubst %/,%,$(dir $(srctree)))
99 #$(info Determined 'srctree' to be $(srctree))
103 #$(info Determined 'objtree' to be $(objtree))
107 #$(info Determined 'OUTPUT' to be $(OUTPUT))
108 # Adding $(OUTPUT) as a directory to look for source files,
109 # because use generated output files as sources dependency
110 # for flex/bison parsers.
121 # Do not use make's built-in rules
122 # (this improves performance and avoids hard-to-debug behaviour);
125 $(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
126 $(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
127 $(Q)touch $(OUTPUT)PERF-VERSION-FILE
129 # Makefiles suck: This macro sets a default value of $(2) for the
130 # variable named by $(1), unless the variable has been set by
131 # environment or command line. This is necessary for CC and AR
132 # because make sets default values, so the simpler ?= approach
133 # won't work as expected.
134 define allow-override
135 $(if $(or $(findstring environment,$(origin $(1))),\
136 $(findstring command line,$(origin $(1)))),,\
140 # Allow setting CC and AR and LD, or setting CROSS_COMPILE as a prefix.
141 $(call allow-override,CC,$(CROSS_COMPILE)gcc)
142 $(call allow-override,AR,$(CROSS_COMPILE)ar)
143 $(call allow-override,LD,$(CROSS_COMPILE)ld)
145 LD += $(EXTRA_LDFLAGS)
151 PKG_CONFIG = $(CROSS_COMPILE)pkg-config
163 LIB_DIR = $(srctree)/tools/lib/api/
164 TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
165 BPF_DIR = $(srctree)/tools/lib/bpf/
166 SUBCMD_DIR = $(srctree)/tools/lib/subcmd/
168 # include Makefile.config by default and rule out
172 NON_CONFIG_TARGETS := clean TAGS tags cscope help install-doc
175 ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
180 # Set FEATURE_TESTS to 'all' so all possible feature checkers are executed.
181 # Without this setting the output feature dump file misses some features, for
182 # example, liberty. Select all checkers so we won't get an incomplete feature
186 ifeq ($(filter feature-dump,$(MAKECMDGOALS)),feature-dump)
190 include Makefile.config
194 include $(srctree)/tools/scripts/Makefile.arch
195 -include arch/$(SRCARCH)/Makefile
198 # The FEATURE_DUMP_EXPORT holds location of the actual
199 # FEATURE_DUMP file to be used to bypass feature detection
200 # (for bpf or any other subproject)
201 ifeq ($(FEATURES_DUMP),)
202 FEATURE_DUMP_EXPORT := $(realpath $(OUTPUT)FEATURE-DUMP)
204 FEATURE_DUMP_EXPORT := $(FEATURES_DUMP)
207 export prefix bindir sharedir sysconfdir DESTDIR
209 # sparse is architecture-neutral, which means that we need to tell it
210 # explicitly what architecture to check for. Fix this up for yours..
211 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
213 # Guard against environment variables
217 SCRIPT_SH += perf-archive.sh
218 SCRIPT_SH += perf-with-kcore.sh
220 grep-libs = $(filter -l%,$(1))
221 strip-libs = $(filter-out -l%,$(1))
226 SUBCMD_PATH=$(OUTPUT)
228 API_PATH=$(OUTPUT)/../lib/api/
233 TE_PATH=$(TRACE_EVENT_DIR)
236 SUBCMD_PATH=$(SUBCMD_DIR)
239 LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
242 LIBTRACEEVENT_DYNAMIC_LIST = $(TE_PATH)libtraceevent-dynamic-list
243 LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS = -Xlinker --dynamic-list=$(LIBTRACEEVENT_DYNAMIC_LIST)
245 LIBAPI = $(API_PATH)libapi.a
248 LIBBPF = $(BPF_PATH)libbpf.a
250 LIBSUBCMD = $(SUBCMD_PATH)libsubcmd.a
252 # python extension build directories
253 PYTHON_EXTBUILD := $(OUTPUT)python_ext_build/
254 PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
255 PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
256 export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
258 python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf.so
260 PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
261 PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
263 $(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS) $(LIBTRACEEVENT_DYNAMIC_LIST)
264 $(QUIET_GEN)LDSHARED="$(CC) -pthread -shared" \
265 CFLAGS='$(CFLAGS)' LDFLAGS='$(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS)' \
266 $(PYTHON_WORD) util/setup.py \
268 mkdir -p $(OUTPUT)python && \
269 cp $(PYTHON_EXTBUILD_LIB)perf.so $(OUTPUT)python/
271 # No Perl scripts right now:
274 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
276 PROGRAMS += $(OUTPUT)perf
278 ifndef NO_PERF_READ_VDSO32
279 PROGRAMS += $(OUTPUT)perf-read-vdso32
282 ifndef NO_PERF_READ_VDSOX32
283 PROGRAMS += $(OUTPUT)perf-read-vdsox32
286 # what 'all' will build and 'install' will install, in perfexecdir
287 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
289 # what 'all' will build but not install in perfexecdir
290 OTHER_PROGRAMS = $(OUTPUT)perf
292 # Set paths to tools early so that they can be used for version tests.
297 PERL_PATH = /usr/bin/perl
302 LIB_FILE=$(OUTPUT)libperf.a
304 PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT) $(LIBSUBCMD)
306 PERFLIBS += $(LIBBPF)
309 # We choose to avoid "if .. else if .. else .. endif endif"
310 # because maintaining the nesting to match is a pain. If
311 # we had "elif" things would have been much nicer...
314 CFLAGS += -I$(OUTPUT)
318 ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
319 GTK_IN := $(OUTPUT)gtk-in.o
321 install-gtk: $(OUTPUT)libperf-gtk.so
322 $(call QUIET_INSTALL, 'GTK UI') \
323 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
324 $(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
331 LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
333 export INSTALL SHELL_PATH
337 SHELL = $(SHELL_PATH)
339 all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
341 please_set_SHELL_PATH_to_a_more_modern_shell:
344 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
346 strip: $(PROGRAMS) $(OUTPUT)perf
347 $(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
349 PERF_IN := $(OUTPUT)perf-in.o
351 export srctree OUTPUT RM CC LD AR CFLAGS V BISON FLEX AWK
352 export HOSTCC HOSTLD HOSTAR
353 include $(srctree)/tools/build/Makefile.include
355 JEVENTS := $(OUTPUT)pmu-events/jevents
356 JEVENTS_IN := $(OUTPUT)pmu-events/jevents-in.o
358 PMU_EVENTS_IN := $(OUTPUT)pmu-events/pmu-events-in.o
362 build := -f $(srctree)/tools/build/Makefile.build dir=. obj
364 $(PERF_IN): prepare FORCE
365 @(test -f ../../include/uapi/linux/perf_event.h && ( \
366 (diff -B ../include/uapi/linux/perf_event.h ../../include/uapi/linux/perf_event.h >/dev/null) \
367 || echo "Warning: tools/include/uapi/linux/perf_event.h differs from kernel" >&2 )) || true
368 @(test -f ../../include/linux/hash.h && ( \
369 (diff -B ../include/linux/hash.h ../../include/linux/hash.h >/dev/null) \
370 || echo "Warning: tools/include/linux/hash.h differs from kernel" >&2 )) || true
371 @(test -f ../../include/uapi/linux/hw_breakpoint.h && ( \
372 (diff -B ../include/uapi/linux/hw_breakpoint.h ../../include/uapi/linux/hw_breakpoint.h >/dev/null) \
373 || echo "Warning: tools/include/uapi/linux/hw_breakpoint.h differs from kernel" >&2 )) || true
374 @(test -f ../../arch/x86/include/asm/disabled-features.h && ( \
375 (diff -B ../arch/x86/include/asm/disabled-features.h ../../arch/x86/include/asm/disabled-features.h >/dev/null) \
376 || echo "Warning: tools/arch/x86/include/asm/disabled-features.h differs from kernel" >&2 )) || true
377 @(test -f ../../arch/x86/include/asm/required-features.h && ( \
378 (diff -B ../arch/x86/include/asm/required-features.h ../../arch/x86/include/asm/required-features.h >/dev/null) \
379 || echo "Warning: tools/arch/x86/include/asm/required-features.h differs from kernel" >&2 )) || true
380 @(test -f ../../arch/x86/include/asm/cpufeatures.h && ( \
381 (diff -B ../arch/x86/include/asm/cpufeatures.h ../../arch/x86/include/asm/cpufeatures.h >/dev/null) \
382 || echo "Warning: tools/arch/x86/include/asm/cpufeatures.h differs from kernel" >&2 )) || true
383 @(test -f ../../arch/x86/lib/memcpy_64.S && ( \
384 (diff -B ../arch/x86/lib/memcpy_64.S ../../arch/x86/lib/memcpy_64.S >/dev/null) \
385 || echo "Warning: tools/arch/x86/lib/memcpy_64.S differs from kernel" >&2 )) || true
386 @(test -f ../../arch/x86/lib/memset_64.S && ( \
387 (diff -B ../arch/x86/lib/memset_64.S ../../arch/x86/lib/memset_64.S >/dev/null) \
388 || echo "Warning: tools/arch/x86/lib/memset_64.S differs from kernel" >&2 )) || true
389 @(test -f ../../arch/arm/include/uapi/asm/perf_regs.h && ( \
390 (diff -B ../arch/arm/include/uapi/asm/perf_regs.h ../../arch/arm/include/uapi/asm/perf_regs.h >/dev/null) \
391 || echo "Warning: tools/arch/arm/include/uapi/asm/perf_regs.h differs from kernel" >&2 )) || true
392 @(test -f ../../arch/arm64/include/uapi/asm/perf_regs.h && ( \
393 (diff -B ../arch/arm64/include/uapi/asm/perf_regs.h ../../arch/arm64/include/uapi/asm/perf_regs.h >/dev/null) \
394 || echo "Warning: tools/arch/arm64/include/uapi/asm/perf_regs.h differs from kernel" >&2 )) || true
395 @(test -f ../../arch/powerpc/include/uapi/asm/perf_regs.h && ( \
396 (diff -B ../arch/powerpc/include/uapi/asm/perf_regs.h ../../arch/powerpc/include/uapi/asm/perf_regs.h >/dev/null) \
397 || echo "Warning: tools/arch/powerpc/include/uapi/asm/perf_regs.h differs from kernel" >&2 )) || true
398 @(test -f ../../arch/x86/include/uapi/asm/perf_regs.h && ( \
399 (diff -B ../arch/x86/include/uapi/asm/perf_regs.h ../../arch/x86/include/uapi/asm/perf_regs.h >/dev/null) \
400 || echo "Warning: tools/arch/x86/include/uapi/asm/perf_regs.h differs from kernel" >&2 )) || true
401 @(test -f ../../arch/x86/include/uapi/asm/kvm.h && ( \
402 (diff -B ../arch/x86/include/uapi/asm/kvm.h ../../arch/x86/include/uapi/asm/kvm.h >/dev/null) \
403 || echo "Warning: tools/arch/x86/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
404 @(test -f ../../arch/x86/include/uapi/asm/kvm_perf.h && ( \
405 (diff -B ../arch/x86/include/uapi/asm/kvm_perf.h ../../arch/x86/include/uapi/asm/kvm_perf.h >/dev/null) \
406 || echo "Warning: tools/arch/x86/include/uapi/asm/kvm_perf.h differs from kernel" >&2 )) || true
407 @(test -f ../../arch/x86/include/uapi/asm/svm.h && ( \
408 (diff -B ../arch/x86/include/uapi/asm/svm.h ../../arch/x86/include/uapi/asm/svm.h >/dev/null) \
409 || echo "Warning: tools/arch/x86/include/uapi/asm/svm.h differs from kernel" >&2 )) || true
410 @(test -f ../../arch/x86/include/uapi/asm/vmx.h && ( \
411 (diff -B ../arch/x86/include/uapi/asm/vmx.h ../../arch/x86/include/uapi/asm/vmx.h >/dev/null) \
412 || echo "Warning: tools/arch/x86/include/uapi/asm/vmx.h differs from kernel" >&2 )) || true
413 @(test -f ../../arch/powerpc/include/uapi/asm/kvm.h && ( \
414 (diff -B ../arch/powerpc/include/uapi/asm/kvm.h ../../arch/powerpc/include/uapi/asm/kvm.h >/dev/null) \
415 || echo "Warning: tools/arch/powerpc/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
416 @(test -f ../../arch/s390/include/uapi/asm/kvm.h && ( \
417 (diff -B ../arch/s390/include/uapi/asm/kvm.h ../../arch/s390/include/uapi/asm/kvm.h >/dev/null) \
418 || echo "Warning: tools/arch/s390/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
419 @(test -f ../../arch/s390/include/uapi/asm/kvm_perf.h && ( \
420 (diff -B ../arch/s390/include/uapi/asm/kvm_perf.h ../../arch/s390/include/uapi/asm/kvm_perf.h >/dev/null) \
421 || echo "Warning: tools/arch/s390/include/uapi/asm/kvm_perf.h differs from kernel" >&2 )) || true
422 @(test -f ../../arch/s390/include/uapi/asm/sie.h && ( \
423 (diff -B ../arch/s390/include/uapi/asm/sie.h ../../arch/s390/include/uapi/asm/sie.h >/dev/null) \
424 || echo "Warning: tools/arch/s390/include/uapi/asm/sie.h differs from kernel" >&2 )) || true
425 @(test -f ../../arch/arm/include/uapi/asm/kvm.h && ( \
426 (diff -B ../arch/arm/include/uapi/asm/kvm.h ../../arch/arm/include/uapi/asm/kvm.h >/dev/null) \
427 || echo "Warning: tools/arch/arm/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
428 @(test -f ../../arch/arm64/include/uapi/asm/kvm.h && ( \
429 (diff -B ../arch/arm64/include/uapi/asm/kvm.h ../../arch/arm64/include/uapi/asm/kvm.h >/dev/null) \
430 || echo "Warning: tools/arch/arm64/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
431 @(test -f ../../include/asm-generic/bitops/arch_hweight.h && ( \
432 (diff -B ../include/asm-generic/bitops/arch_hweight.h ../../include/asm-generic/bitops/arch_hweight.h >/dev/null) \
433 || echo "Warning: tools/include/asm-generic/bitops/arch_hweight.h differs from kernel" >&2 )) || true
434 @(test -f ../../include/asm-generic/bitops/const_hweight.h && ( \
435 (diff -B ../include/asm-generic/bitops/const_hweight.h ../../include/asm-generic/bitops/const_hweight.h >/dev/null) \
436 || echo "Warning: tools/include/asm-generic/bitops/const_hweight.h differs from kernel" >&2 )) || true
437 @(test -f ../../include/asm-generic/bitops/__fls.h && ( \
438 (diff -B ../include/asm-generic/bitops/__fls.h ../../include/asm-generic/bitops/__fls.h >/dev/null) \
439 || echo "Warning: tools/include/asm-generic/bitops/__fls.h differs from kernel" >&2 )) || true
440 @(test -f ../../include/asm-generic/bitops/fls.h && ( \
441 (diff -B ../include/asm-generic/bitops/fls.h ../../include/asm-generic/bitops/fls.h >/dev/null) \
442 || echo "Warning: tools/include/asm-generic/bitops/fls.h differs from kernel" >&2 )) || true
443 @(test -f ../../include/asm-generic/bitops/fls64.h && ( \
444 (diff -B ../include/asm-generic/bitops/fls64.h ../../include/asm-generic/bitops/fls64.h >/dev/null) \
445 || echo "Warning: tools/include/asm-generic/bitops/fls64.h differs from kernel" >&2 )) || true
446 @(test -f ../../include/linux/coresight-pmu.h && ( \
447 (diff -B ../include/linux/coresight-pmu.h ../../include/linux/coresight-pmu.h >/dev/null) \
448 || echo "Warning: tools/include/linux/coresight-pmu.h differs from kernel" >&2 )) || true
449 @(test -f ../../include/uapi/asm-generic/mman-common.h && ( \
450 (diff -B ../include/uapi/asm-generic/mman-common.h ../../include/uapi/asm-generic/mman-common.h >/dev/null) \
451 || echo "Warning: tools/include/uapi/asm-generic/mman-common.h differs from kernel" >&2 )) || true
452 @(test -f ../../include/uapi/asm-generic/mman.h && ( \
453 (diff -B -I "^#include <\(uapi/\)*asm-generic/mman-common.h>$$" ../include/uapi/asm-generic/mman.h ../../include/uapi/asm-generic/mman.h >/dev/null) \
454 || echo "Warning: tools/include/uapi/asm-generic/mman.h differs from kernel" >&2 )) || true
455 @(test -f ../../include/uapi/linux/mman.h && ( \
456 (diff -B -I "^#include <\(uapi/\)*asm/mman.h>$$" ../include/uapi/linux/mman.h ../../include/uapi/linux/mman.h >/dev/null) \
457 || echo "Warning: tools/include/uapi/linux/mman.h differs from kernel" >&2 )) || true
458 $(Q)$(MAKE) $(build)=perf
461 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=jevents
463 $(JEVENTS): $(JEVENTS_IN)
464 $(QUIET_LINK)$(HOSTCC) $(JEVENTS_IN) -o $@
466 $(PMU_EVENTS_IN): $(JEVENTS) FORCE
467 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=pmu-events
469 $(OUTPUT)perf: $(PERFLIBS) $(PERF_IN) $(PMU_EVENTS_IN) $(LIBTRACEEVENT_DYNAMIC_LIST)
470 $(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS) \
471 $(PERF_IN) $(PMU_EVENTS_IN) $(LIBS) -o $@
473 $(GTK_IN): fixdep FORCE
474 $(Q)$(MAKE) $(build)=gtk
476 $(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
477 $(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
479 $(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
481 $(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
482 $(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
484 $(SCRIPTS) : % : %.sh
485 $(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
487 # These can record PERF_VERSION
488 perf.spec $(SCRIPTS) \
489 : $(OUTPUT)PERF-VERSION-FILE
494 # If a target does not match any of the later rules then prefix it by $(OUTPUT)
495 # This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
499 @echo " # Redirected target $@ => $(OUTPUT)$@"
500 pmu-events/%.o: $(OUTPUT)pmu-events/%.o
501 @echo " # Redirected target $@ => $(OUTPUT)$@"
502 util/%.o: $(OUTPUT)util/%.o
503 @echo " # Redirected target $@ => $(OUTPUT)$@"
504 bench/%.o: $(OUTPUT)bench/%.o
505 @echo " # Redirected target $@ => $(OUTPUT)$@"
506 tests/%.o: $(OUTPUT)tests/%.o
507 @echo " # Redirected target $@ => $(OUTPUT)$@"
510 # These two need to be here so that when O= is not used they take precedence
511 # over the general rule for .o
513 # get relative building directory (to $(OUTPUT))
514 # and '.' if it's $(OUTPUT) itself
515 __build-dir = $(subst $(OUTPUT),,$(dir $@))
516 build-dir = $(if $(__build-dir),$(__build-dir),.)
518 prepare: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h fixdep archheaders
520 $(OUTPUT)%.o: %.c prepare FORCE
521 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
523 $(OUTPUT)%.i: %.c prepare FORCE
524 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
526 $(OUTPUT)%.s: %.c prepare FORCE
527 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
529 $(OUTPUT)%-bison.o: %.c prepare FORCE
530 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
532 $(OUTPUT)%-flex.o: %.c prepare FORCE
533 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
535 $(OUTPUT)%.o: %.S prepare FORCE
536 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
538 $(OUTPUT)%.i: %.S prepare FORCE
539 $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
541 $(OUTPUT)perf-%: %.o $(PERFLIBS)
542 $(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
544 ifndef NO_PERF_READ_VDSO32
545 $(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
546 $(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
549 ifndef NO_PERF_READ_VDSOX32
550 $(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
551 $(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
554 $(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
556 LIBPERF_IN := $(OUTPUT)libperf-in.o
558 $(LIBPERF_IN): prepare fixdep FORCE
559 $(Q)$(MAKE) $(build)=libperf
561 $(LIB_FILE): $(LIBPERF_IN)
562 $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
564 LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ)
566 $(LIBTRACEEVENT): fixdep FORCE
567 $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a
569 libtraceevent_plugins: fixdep FORCE
570 $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) plugins
572 $(LIBTRACEEVENT_DYNAMIC_LIST): libtraceevent_plugins
573 $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent-dynamic-list
575 $(LIBTRACEEVENT)-clean:
576 $(call QUIET_CLEAN, libtraceevent)
577 $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
579 install-traceevent-plugins: libtraceevent_plugins
580 $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
582 $(LIBAPI): fixdep FORCE
583 $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
586 $(call QUIET_CLEAN, libapi)
587 $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
589 $(LIBBPF): fixdep FORCE
590 $(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) $(OUTPUT)libbpf.a FEATURES_DUMP=$(FEATURE_DUMP_EXPORT)
593 $(call QUIET_CLEAN, libbpf)
594 $(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) clean >/dev/null
596 $(LIBSUBCMD): fixdep FORCE
597 $(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) $(OUTPUT)libsubcmd.a
600 $(call QUIET_CLEAN, libsubcmd)
601 $(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) clean
604 @echo 'Perf make targets:'
605 @echo ' doc - make *all* documentation (see below)'
606 @echo ' man - make manpage documentation (access with man <foo>)'
607 @echo ' html - make html documentation'
608 @echo ' info - make GNU info documentation (access with info <foo>)'
609 @echo ' pdf - make pdf documentation'
610 @echo ' TAGS - use etags to make tag information for source browsing'
611 @echo ' tags - use ctags to make tag information for source browsing'
612 @echo ' cscope - use cscope to make interactive browsing database'
614 @echo 'Perf install targets:'
615 @echo ' NOTE: documentation build requires asciidoc, xmlto packages to be installed'
616 @echo ' HINT: use "prefix" or "DESTDIR" to install to a particular'
617 @echo ' path like "make prefix=/usr/local install install-doc"'
618 @echo ' install - install compiled binaries'
619 @echo ' install-doc - install *all* documentation'
620 @echo ' install-man - install manpage documentation'
621 @echo ' install-html - install html documentation'
622 @echo ' install-info - install GNU info documentation'
623 @echo ' install-pdf - install pdf documentation'
625 @echo ' quick-install-doc - alias for quick-install-man'
626 @echo ' quick-install-man - install the documentation quickly'
627 @echo ' quick-install-html - install the html documentation quickly'
629 @echo 'Perf maintainer targets:'
630 @echo ' clean - clean all binary objects and build output'
633 DOC_TARGETS := doc man html info pdf
635 INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
636 INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
638 # 'make doc' should call 'make -C Documentation all'
640 $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
642 TAG_FOLDERS= . ../lib ../include
643 TAG_FILES= ../../include/uapi/linux/perf_event.h
646 $(QUIET_GEN)$(RM) TAGS; \
647 $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs etags -a $(TAG_FILES)
650 $(QUIET_GEN)$(RM) tags; \
651 $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs ctags -a $(TAG_FILES)
654 $(QUIET_GEN)$(RM) cscope*; \
655 $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs cscope -b $(TAG_FILES)
659 # GNU make supports exporting all variables by "export" without parameters.
660 # However, the environment gets quite big, and some programs have problems
663 check: $(OUTPUT)common-cmds.h
666 for i in *.c */*.c; \
668 sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
674 ### Installation rules
678 install-tools: all install-gtk
679 $(call QUIET_INSTALL, binaries) \
680 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
681 $(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
682 $(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
683 ifndef NO_PERF_READ_VDSO32
684 $(call QUIET_INSTALL, perf-read-vdso32) \
685 $(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
687 ifndef NO_PERF_READ_VDSOX32
688 $(call QUIET_INSTALL, perf-read-vdsox32) \
689 $(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
691 $(call QUIET_INSTALL, libexec) \
692 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
693 $(call QUIET_INSTALL, perf-archive) \
694 $(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
695 $(call QUIET_INSTALL, perf-with-kcore) \
696 $(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
698 $(call QUIET_INSTALL, strace/groups) \
699 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'; \
700 $(INSTALL) trace/strace/groups/* -t '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'
703 $(call QUIET_INSTALL, perl-scripts) \
704 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
705 $(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
706 $(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
707 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
708 $(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
711 $(call QUIET_INSTALL, python-scripts) \
712 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
713 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
714 $(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
715 $(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
716 $(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
718 $(call QUIET_INSTALL, perf_completion-script) \
719 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
720 $(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
721 $(call QUIET_INSTALL, perf-tip) \
722 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(tip_instdir_SQ)'; \
723 $(INSTALL) Documentation/tips.txt -t '$(DESTDIR_SQ)$(tip_instdir_SQ)'
725 install-tests: all install-gtk
726 $(call QUIET_INSTALL, tests) \
727 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
728 $(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
729 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
730 $(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'
732 install-bin: install-tools install-tests install-traceevent-plugins
734 install: install-bin try-install-man
737 $(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
739 # 'make install-doc' should call 'make -C Documentation install'
740 $(INSTALL_DOC_TARGETS):
741 $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
746 # This is here, not in Makefile.config, because Makefile.config does
747 # not get included for the clean target:
750 $(call QUIET_CLEAN, config)
751 $(Q)$(MAKE) -C $(srctree)/tools/build/feature/ $(if $(OUTPUT),OUTPUT=$(OUTPUT)feature/,) clean >/dev/null
753 clean:: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean $(LIBBPF)-clean $(LIBSUBCMD)-clean config-clean
754 $(call QUIET_CLEAN, core-objs) $(RM) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(LANG_BINDINGS)
755 $(Q)find $(if $(OUTPUT),$(OUTPUT),.) -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
756 $(Q)$(RM) $(OUTPUT).config-detected
757 $(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32 $(OUTPUT)pmu-events/jevents
758 $(call QUIET_CLEAN, core-gen) $(RM) *.spec *.pyc *.pyo */*.pyc */*.pyo $(OUTPUT)common-cmds.h TAGS tags cscope* $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)FEATURE-DUMP $(OUTPUT)util/*-bison* $(OUTPUT)util/*-flex* \
759 $(OUTPUT)util/intel-pt-decoder/inat-tables.c $(OUTPUT)fixdep \
760 $(OUTPUT)tests/llvm-src-{base,kbuild,prologue,relocation}.c \
761 $(OUTPUT)pmu-events/pmu-events.c
762 $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
766 # To provide FEATURE-DUMP into $(FEATURE_DUMP_COPY)
767 # file if defined, with no further action.
769 ifdef FEATURE_DUMP_COPY
770 @cp $(OUTPUT)FEATURE-DUMP $(FEATURE_DUMP_COPY)
771 @echo "FEATURE-DUMP file copied into $(FEATURE_DUMP_COPY)"
773 @echo "FEATURE-DUMP file available in $(OUTPUT)FEATURE-DUMP"
777 # Trick: if ../../.git does not exist - we are building out of tree for example,
778 # then force version regeneration:
780 ifeq ($(wildcard ../../.git/HEAD),)
781 GIT-HEAD-PHONY = ../../.git/HEAD
788 .PHONY: all install clean config-clean strip install-gtk
789 .PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
790 .PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE prepare
791 .PHONY: libtraceevent_plugins archheaders