xref: /openbmc/linux/tools/perf/Makefile.perf (revision bc5aa3a0)
1include ../scripts/Makefile.include
2
3# The default target of this Makefile is...
4all:
5
6include ../scripts/utilities.mak
7
8# Define V to have a more verbose compile.
9#
10# Define VF to have a more verbose feature check output.
11#
12# Define O to save output files in a separate directory.
13#
14# Define ARCH as name of target architecture if you want cross-builds.
15#
16# Define CROSS_COMPILE as prefix name of compiler if you want cross-builds.
17#
18# Define NO_LIBPERL to disable perl script extension.
19#
20# Define NO_LIBPYTHON to disable python script extension.
21#
22# Define PYTHON to point to the python binary if the default
23# `python' is not correct; for example: PYTHON=python2
24#
25# Define PYTHON_CONFIG to point to the python-config binary if
26# the default `$(PYTHON)-config' is not correct.
27#
28# Define ASCIIDOC8 if you want to format documentation with AsciiDoc 8
29#
30# Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72.
31#
32# Define LDFLAGS=-static to build a static binary.
33#
34# Define EXTRA_CFLAGS=-m64 or EXTRA_CFLAGS=-m32 as appropriate for cross-builds.
35#
36# Define NO_DWARF if you do not want debug-info analysis feature at all.
37#
38# Define WERROR=0 to disable treating any warnings as errors.
39#
40# Define NO_NEWT if you do not want TUI support. (deprecated)
41#
42# Define NO_SLANG if you do not want TUI support.
43#
44# Define NO_GTK2 if you do not want GTK+ GUI support.
45#
46# Define NO_DEMANGLE if you do not want C++ symbol demangling.
47#
48# Define NO_LIBELF if you do not want libelf dependency (e.g. cross-builds)
49#
50# Define NO_LIBUNWIND if you do not want libunwind dependency for dwarf
51# backtrace post unwind.
52#
53# Define NO_BACKTRACE if you do not want stack backtrace debug feature
54#
55# Define NO_LIBNUMA if you do not want numa perf benchmark
56#
57# Define NO_LIBAUDIT if you do not want libaudit support
58#
59# Define NO_LIBBIONIC if you do not want bionic support
60#
61# Define NO_LIBCRYPTO if you do not want libcrypto (openssl) support
62# used for generating build-ids for ELFs generated by jitdump.
63#
64# Define NO_LIBDW_DWARF_UNWIND if you do not want libdw support
65# for dwarf backtrace post unwind.
66#
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
69#
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
72#
73# Define NO_ZLIB if you do not want to support compressed kernel modules
74#
75# Define LIBBABELTRACE if you DO want libbabeltrace support
76# for CTF data format.
77#
78# Define NO_LZMA if you do not want to support compressed (xz) kernel modules
79#
80# Define NO_AUXTRACE if you do not want AUX area tracing support
81#
82# Define NO_LIBBPF if you do not want BPF support
83#
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.
86#
87# Define FEATURES_DUMP to provide features detection dump file
88# and bypass the feature detection
89
90# As per kernel Makefile, avoid funny character set dependencies
91unexport LC_ALL
92LC_COLLATE=C
93LC_NUMERIC=C
94export LC_COLLATE LC_NUMERIC
95
96ifeq ($(srctree),)
97srctree := $(patsubst %/,%,$(dir $(shell pwd)))
98srctree := $(patsubst %/,%,$(dir $(srctree)))
99#$(info Determined 'srctree' to be $(srctree))
100endif
101
102ifneq ($(objtree),)
103#$(info Determined 'objtree' to be $(objtree))
104endif
105
106ifneq ($(OUTPUT),)
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.
111VPATH += $(OUTPUT)
112export VPATH
113endif
114
115ifeq ($(V),1)
116  Q =
117else
118  Q = @
119endif
120
121# Do not use make's built-in rules
122# (this improves performance and avoids hard-to-debug behaviour);
123MAKEFLAGS += -r
124
125$(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
126	$(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
127	$(Q)touch $(OUTPUT)PERF-VERSION-FILE
128
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.
134define allow-override
135  $(if $(or $(findstring environment,$(origin $(1))),\
136            $(findstring command line,$(origin $(1)))),,\
137    $(eval $(1) = $(2)))
138endef
139
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)
144
145LD += $(EXTRA_LDFLAGS)
146
147PKG_CONFIG = $(CROSS_COMPILE)pkg-config
148
149RM      = rm -f
150LN      = ln -f
151MKDIR   = mkdir
152FIND    = find
153INSTALL = install
154FLEX    = flex
155BISON   = bison
156STRIP   = strip
157AWK     = awk
158
159LIB_DIR		= $(srctree)/tools/lib/api/
160TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
161BPF_DIR		= $(srctree)/tools/lib/bpf/
162SUBCMD_DIR	= $(srctree)/tools/lib/subcmd/
163
164# include Makefile.config by default and rule out
165# non-config cases
166config := 1
167
168NON_CONFIG_TARGETS := clean TAGS tags cscope help
169
170ifdef MAKECMDGOALS
171ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
172  config := 0
173endif
174endif
175
176# Set FEATURE_TESTS to 'all' so all possible feature checkers are executed.
177# Without this setting the output feature dump file misses some features, for
178# example, liberty. Select all checkers so we won't get an incomplete feature
179# dump file.
180ifeq ($(config),1)
181ifdef MAKECMDGOALS
182ifeq ($(filter feature-dump,$(MAKECMDGOALS)),feature-dump)
183FEATURE_TESTS := all
184endif
185endif
186include Makefile.config
187endif
188
189ifeq ($(config),0)
190include $(srctree)/tools/scripts/Makefile.arch
191-include arch/$(ARCH)/Makefile
192endif
193
194# The FEATURE_DUMP_EXPORT holds location of the actual
195# FEATURE_DUMP file to be used to bypass feature detection
196# (for bpf or any other subproject)
197ifeq ($(FEATURES_DUMP),)
198FEATURE_DUMP_EXPORT := $(realpath $(OUTPUT)FEATURE-DUMP)
199else
200FEATURE_DUMP_EXPORT := $(FEATURES_DUMP)
201endif
202
203export prefix bindir sharedir sysconfdir DESTDIR
204
205# sparse is architecture-neutral, which means that we need to tell it
206# explicitly what architecture to check for. Fix this up for yours..
207SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
208
209# Guard against environment variables
210PYRF_OBJS =
211SCRIPT_SH =
212
213SCRIPT_SH += perf-archive.sh
214SCRIPT_SH += perf-with-kcore.sh
215
216grep-libs = $(filter -l%,$(1))
217strip-libs = $(filter-out -l%,$(1))
218
219ifneq ($(OUTPUT),)
220  TE_PATH=$(OUTPUT)
221  BPF_PATH=$(OUTPUT)
222  SUBCMD_PATH=$(OUTPUT)
223ifneq ($(subdir),)
224  API_PATH=$(OUTPUT)/../lib/api/
225else
226  API_PATH=$(OUTPUT)
227endif
228else
229  TE_PATH=$(TRACE_EVENT_DIR)
230  API_PATH=$(LIB_DIR)
231  BPF_PATH=$(BPF_DIR)
232  SUBCMD_PATH=$(SUBCMD_DIR)
233endif
234
235LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
236export LIBTRACEEVENT
237
238LIBTRACEEVENT_DYNAMIC_LIST = $(TE_PATH)libtraceevent-dynamic-list
239LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS = -Xlinker --dynamic-list=$(LIBTRACEEVENT_DYNAMIC_LIST)
240
241LIBAPI = $(API_PATH)libapi.a
242export LIBAPI
243
244LIBBPF = $(BPF_PATH)libbpf.a
245
246LIBSUBCMD = $(SUBCMD_PATH)libsubcmd.a
247
248# python extension build directories
249PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
250PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
251PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
252export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
253
254python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf.so
255
256PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
257PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
258
259$(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS) $(LIBTRACEEVENT_DYNAMIC_LIST)
260	$(QUIET_GEN)LDSHARED="$(CC) -pthread -shared" \
261        CFLAGS='$(CFLAGS)' LDFLAGS='$(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS)' \
262	  $(PYTHON_WORD) util/setup.py \
263	  --quiet build_ext; \
264	mkdir -p $(OUTPUT)python && \
265	cp $(PYTHON_EXTBUILD_LIB)perf.so $(OUTPUT)python/
266#
267# No Perl scripts right now:
268#
269
270SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
271
272PROGRAMS += $(OUTPUT)perf
273
274ifndef NO_PERF_READ_VDSO32
275PROGRAMS += $(OUTPUT)perf-read-vdso32
276endif
277
278ifndef NO_PERF_READ_VDSOX32
279PROGRAMS += $(OUTPUT)perf-read-vdsox32
280endif
281
282# what 'all' will build and 'install' will install, in perfexecdir
283ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
284
285# what 'all' will build but not install in perfexecdir
286OTHER_PROGRAMS = $(OUTPUT)perf
287
288# Set paths to tools early so that they can be used for version tests.
289ifndef SHELL_PATH
290  SHELL_PATH = /bin/sh
291endif
292ifndef PERL_PATH
293  PERL_PATH = /usr/bin/perl
294endif
295
296export PERL_PATH
297
298LIB_FILE=$(OUTPUT)libperf.a
299
300PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT) $(LIBSUBCMD)
301ifndef NO_LIBBPF
302  PERFLIBS += $(LIBBPF)
303endif
304
305# We choose to avoid "if .. else if .. else .. endif endif"
306# because maintaining the nesting to match is a pain.  If
307# we had "elif" things would have been much nicer...
308
309ifneq ($(OUTPUT),)
310  CFLAGS += -I$(OUTPUT)
311endif
312
313ifndef NO_GTK2
314  ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
315  GTK_IN := $(OUTPUT)gtk-in.o
316
317install-gtk: $(OUTPUT)libperf-gtk.so
318	$(call QUIET_INSTALL, 'GTK UI') \
319		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
320		$(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
321endif
322
323ifdef ASCIIDOC8
324  export ASCIIDOC8
325endif
326
327LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
328
329export INSTALL SHELL_PATH
330
331### Build rules
332
333SHELL = $(SHELL_PATH)
334
335all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
336
337please_set_SHELL_PATH_to_a_more_modern_shell:
338	$(Q)$$(:)
339
340shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
341
342strip: $(PROGRAMS) $(OUTPUT)perf
343	$(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
344
345PERF_IN := $(OUTPUT)perf-in.o
346
347export srctree OUTPUT RM CC LD AR CFLAGS V BISON FLEX AWK
348include $(srctree)/tools/build/Makefile.include
349
350$(PERF_IN): prepare FORCE
351	@(test -f ../../include/uapi/linux/perf_event.h && ( \
352        (diff -B ../include/uapi/linux/perf_event.h ../../include/uapi/linux/perf_event.h >/dev/null) \
353        || echo "Warning: tools/include/uapi/linux/perf_event.h differs from kernel" >&2 )) || true
354	@(test -f ../../include/linux/hash.h && ( \
355        (diff -B ../include/linux/hash.h ../../include/linux/hash.h >/dev/null) \
356        || echo "Warning: tools/include/linux/hash.h differs from kernel" >&2 )) || true
357	@(test -f ../../include/uapi/linux/hw_breakpoint.h && ( \
358        (diff -B ../include/uapi/linux/hw_breakpoint.h ../../include/uapi/linux/hw_breakpoint.h >/dev/null) \
359        || echo "Warning: tools/include/uapi/linux/hw_breakpoint.h differs from kernel" >&2 )) || true
360	@(test -f ../../arch/x86/include/asm/disabled-features.h && ( \
361        (diff -B ../arch/x86/include/asm/disabled-features.h ../../arch/x86/include/asm/disabled-features.h >/dev/null) \
362        || echo "Warning: tools/arch/x86/include/asm/disabled-features.h differs from kernel" >&2 )) || true
363	@(test -f ../../arch/x86/include/asm/required-features.h && ( \
364        (diff -B ../arch/x86/include/asm/required-features.h ../../arch/x86/include/asm/required-features.h >/dev/null) \
365        || echo "Warning: tools/arch/x86/include/asm/required-features.h differs from kernel" >&2 )) || true
366	@(test -f ../../arch/x86/include/asm/cpufeatures.h && ( \
367        (diff -B ../arch/x86/include/asm/cpufeatures.h ../../arch/x86/include/asm/cpufeatures.h >/dev/null) \
368        || echo "Warning: tools/arch/x86/include/asm/cpufeatures.h differs from kernel" >&2 )) || true
369	@(test -f ../../arch/x86/lib/memcpy_64.S && ( \
370        (diff -B ../arch/x86/lib/memcpy_64.S ../../arch/x86/lib/memcpy_64.S >/dev/null) \
371        || echo "Warning: tools/arch/x86/lib/memcpy_64.S differs from kernel" >&2 )) || true
372	@(test -f ../../arch/x86/lib/memset_64.S && ( \
373        (diff -B ../arch/x86/lib/memset_64.S ../../arch/x86/lib/memset_64.S >/dev/null) \
374        || echo "Warning: tools/arch/x86/lib/memset_64.S differs from kernel" >&2 )) || true
375	@(test -f ../../arch/arm/include/uapi/asm/perf_regs.h && ( \
376        (diff -B ../arch/arm/include/uapi/asm/perf_regs.h ../../arch/arm/include/uapi/asm/perf_regs.h >/dev/null) \
377        || echo "Warning: tools/arch/arm/include/uapi/asm/perf_regs.h differs from kernel" >&2 )) || true
378	@(test -f ../../arch/arm64/include/uapi/asm/perf_regs.h && ( \
379        (diff -B ../arch/arm64/include/uapi/asm/perf_regs.h ../../arch/arm64/include/uapi/asm/perf_regs.h >/dev/null) \
380        || echo "Warning: tools/arch/arm64/include/uapi/asm/perf_regs.h differs from kernel" >&2 )) || true
381	@(test -f ../../arch/powerpc/include/uapi/asm/perf_regs.h && ( \
382        (diff -B ../arch/powerpc/include/uapi/asm/perf_regs.h ../../arch/powerpc/include/uapi/asm/perf_regs.h >/dev/null) \
383        || echo "Warning: tools/arch/powerpc/include/uapi/asm/perf_regs.h differs from kernel" >&2 )) || true
384	@(test -f ../../arch/x86/include/uapi/asm/perf_regs.h && ( \
385        (diff -B ../arch/x86/include/uapi/asm/perf_regs.h ../../arch/x86/include/uapi/asm/perf_regs.h >/dev/null) \
386        || echo "Warning: tools/arch/x86/include/uapi/asm/perf_regs.h differs from kernel" >&2 )) || true
387	@(test -f ../../arch/x86/include/uapi/asm/kvm.h && ( \
388        (diff -B ../arch/x86/include/uapi/asm/kvm.h ../../arch/x86/include/uapi/asm/kvm.h >/dev/null) \
389        || echo "Warning: tools/arch/x86/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
390	@(test -f ../../arch/x86/include/uapi/asm/kvm_perf.h && ( \
391        (diff -B ../arch/x86/include/uapi/asm/kvm_perf.h ../../arch/x86/include/uapi/asm/kvm_perf.h >/dev/null) \
392        || echo "Warning: tools/arch/x86/include/uapi/asm/kvm_perf.h differs from kernel" >&2 )) || true
393	@(test -f ../../arch/x86/include/uapi/asm/svm.h && ( \
394        (diff -B ../arch/x86/include/uapi/asm/svm.h ../../arch/x86/include/uapi/asm/svm.h >/dev/null) \
395        || echo "Warning: tools/arch/x86/include/uapi/asm/svm.h differs from kernel" >&2 )) || true
396	@(test -f ../../arch/x86/include/uapi/asm/vmx.h && ( \
397        (diff -B ../arch/x86/include/uapi/asm/vmx.h ../../arch/x86/include/uapi/asm/vmx.h >/dev/null) \
398        || echo "Warning: tools/arch/x86/include/uapi/asm/vmx.h differs from kernel" >&2 )) || true
399	@(test -f ../../arch/powerpc/include/uapi/asm/kvm.h && ( \
400        (diff -B ../arch/powerpc/include/uapi/asm/kvm.h ../../arch/powerpc/include/uapi/asm/kvm.h >/dev/null) \
401        || echo "Warning: tools/arch/powerpc/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
402	@(test -f ../../arch/s390/include/uapi/asm/kvm.h && ( \
403        (diff -B ../arch/s390/include/uapi/asm/kvm.h ../../arch/s390/include/uapi/asm/kvm.h >/dev/null) \
404        || echo "Warning: tools/arch/s390/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
405	@(test -f ../../arch/s390/include/uapi/asm/kvm_perf.h && ( \
406        (diff -B ../arch/s390/include/uapi/asm/kvm_perf.h ../../arch/s390/include/uapi/asm/kvm_perf.h >/dev/null) \
407        || echo "Warning: tools/arch/s390/include/uapi/asm/kvm_perf.h differs from kernel" >&2 )) || true
408	@(test -f ../../arch/s390/include/uapi/asm/sie.h && ( \
409        (diff -B ../arch/s390/include/uapi/asm/sie.h ../../arch/s390/include/uapi/asm/sie.h >/dev/null) \
410        || echo "Warning: tools/arch/s390/include/uapi/asm/sie.h differs from kernel" >&2 )) || true
411	@(test -f ../../arch/arm/include/uapi/asm/kvm.h && ( \
412        (diff -B ../arch/arm/include/uapi/asm/kvm.h ../../arch/arm/include/uapi/asm/kvm.h >/dev/null) \
413        || echo "Warning: tools/arch/arm/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
414	@(test -f ../../arch/arm64/include/uapi/asm/kvm.h && ( \
415        (diff -B ../arch/arm64/include/uapi/asm/kvm.h ../../arch/arm64/include/uapi/asm/kvm.h >/dev/null) \
416        || echo "Warning: tools/arch/arm64/include/uapi/asm/kvm.h differs from kernel" >&2 )) || true
417	@(test -f ../../include/asm-generic/bitops/arch_hweight.h && ( \
418        (diff -B ../include/asm-generic/bitops/arch_hweight.h ../../include/asm-generic/bitops/arch_hweight.h >/dev/null) \
419        || echo "Warning: tools/include/asm-generic/bitops/arch_hweight.h differs from kernel" >&2 )) || true
420	@(test -f ../../include/asm-generic/bitops/const_hweight.h && ( \
421        (diff -B ../include/asm-generic/bitops/const_hweight.h ../../include/asm-generic/bitops/const_hweight.h >/dev/null) \
422        || echo "Warning: tools/include/asm-generic/bitops/const_hweight.h differs from kernel" >&2 )) || true
423	@(test -f ../../include/asm-generic/bitops/__fls.h && ( \
424        (diff -B ../include/asm-generic/bitops/__fls.h ../../include/asm-generic/bitops/__fls.h >/dev/null) \
425        || echo "Warning: tools/include/asm-generic/bitops/__fls.h differs from kernel" >&2 )) || true
426	@(test -f ../../include/asm-generic/bitops/fls.h && ( \
427        (diff -B ../include/asm-generic/bitops/fls.h ../../include/asm-generic/bitops/fls.h >/dev/null) \
428        || echo "Warning: tools/include/asm-generic/bitops/fls.h differs from kernel" >&2 )) || true
429	@(test -f ../../include/asm-generic/bitops/fls64.h && ( \
430        (diff -B ../include/asm-generic/bitops/fls64.h ../../include/asm-generic/bitops/fls64.h >/dev/null) \
431        || echo "Warning: tools/include/asm-generic/bitops/fls64.h differs from kernel" >&2 )) || true
432	$(Q)$(MAKE) $(build)=perf
433
434$(OUTPUT)perf: $(PERFLIBS) $(PERF_IN) $(LIBTRACEEVENT_DYNAMIC_LIST)
435	$(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS) \
436		$(PERF_IN) $(LIBS) -o $@
437
438$(GTK_IN): fixdep FORCE
439	$(Q)$(MAKE) $(build)=gtk
440
441$(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
442	$(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
443
444$(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
445
446$(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
447	$(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
448
449$(SCRIPTS) : % : %.sh
450	$(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
451
452# These can record PERF_VERSION
453perf.spec $(SCRIPTS) \
454	: $(OUTPUT)PERF-VERSION-FILE
455
456.SUFFIXES:
457
458#
459# If a target does not match any of the later rules then prefix it by $(OUTPUT)
460# This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
461#
462ifneq ($(OUTPUT),)
463%.o: $(OUTPUT)%.o
464	@echo "    # Redirected target $@ => $(OUTPUT)$@"
465util/%.o: $(OUTPUT)util/%.o
466	@echo "    # Redirected target $@ => $(OUTPUT)$@"
467bench/%.o: $(OUTPUT)bench/%.o
468	@echo "    # Redirected target $@ => $(OUTPUT)$@"
469tests/%.o: $(OUTPUT)tests/%.o
470	@echo "    # Redirected target $@ => $(OUTPUT)$@"
471endif
472
473# These two need to be here so that when O= is not used they take precedence
474# over the general rule for .o
475
476# get relative building directory (to $(OUTPUT))
477# and '.' if it's $(OUTPUT) itself
478__build-dir = $(subst $(OUTPUT),,$(dir $@))
479build-dir   = $(if $(__build-dir),$(__build-dir),.)
480
481prepare: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h fixdep archheaders
482
483$(OUTPUT)%.o: %.c prepare FORCE
484	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
485
486$(OUTPUT)%.i: %.c prepare FORCE
487	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
488
489$(OUTPUT)%.s: %.c prepare FORCE
490	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
491
492$(OUTPUT)%-bison.o: %.c prepare FORCE
493	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
494
495$(OUTPUT)%-flex.o: %.c prepare FORCE
496	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
497
498$(OUTPUT)%.o: %.S prepare FORCE
499	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
500
501$(OUTPUT)%.i: %.S prepare FORCE
502	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
503
504$(OUTPUT)perf-%: %.o $(PERFLIBS)
505	$(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
506
507ifndef NO_PERF_READ_VDSO32
508$(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
509	$(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
510endif
511
512ifndef NO_PERF_READ_VDSOX32
513$(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
514	$(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
515endif
516
517$(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
518
519LIBPERF_IN := $(OUTPUT)libperf-in.o
520
521$(LIBPERF_IN): prepare fixdep FORCE
522	$(Q)$(MAKE) $(build)=libperf
523
524$(LIB_FILE): $(LIBPERF_IN)
525	$(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
526
527LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ)
528
529$(LIBTRACEEVENT): fixdep FORCE
530	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a
531
532libtraceevent_plugins: fixdep FORCE
533	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) plugins
534
535$(LIBTRACEEVENT_DYNAMIC_LIST): libtraceevent_plugins
536	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent-dynamic-list
537
538$(LIBTRACEEVENT)-clean:
539	$(call QUIET_CLEAN, libtraceevent)
540	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
541
542install-traceevent-plugins: libtraceevent_plugins
543	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
544
545$(LIBAPI): fixdep FORCE
546	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
547
548$(LIBAPI)-clean:
549	$(call QUIET_CLEAN, libapi)
550	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
551
552$(LIBBPF): fixdep FORCE
553	$(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) $(OUTPUT)libbpf.a FEATURES_DUMP=$(FEATURE_DUMP_EXPORT)
554
555$(LIBBPF)-clean:
556	$(call QUIET_CLEAN, libbpf)
557	$(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) clean >/dev/null
558
559$(LIBSUBCMD): fixdep FORCE
560	$(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) $(OUTPUT)libsubcmd.a
561
562$(LIBSUBCMD)-clean:
563	$(call QUIET_CLEAN, libsubcmd)
564	$(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) clean
565
566help:
567	@echo 'Perf make targets:'
568	@echo '  doc		- make *all* documentation (see below)'
569	@echo '  man		- make manpage documentation (access with man <foo>)'
570	@echo '  html		- make html documentation'
571	@echo '  info		- make GNU info documentation (access with info <foo>)'
572	@echo '  pdf		- make pdf documentation'
573	@echo '  TAGS		- use etags to make tag information for source browsing'
574	@echo '  tags		- use ctags to make tag information for source browsing'
575	@echo '  cscope	- use cscope to make interactive browsing database'
576	@echo ''
577	@echo 'Perf install targets:'
578	@echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
579	@echo '  HINT: use "prefix" or "DESTDIR" to install to a particular'
580	@echo '        path like "make prefix=/usr/local install install-doc"'
581	@echo '  install	- install compiled binaries'
582	@echo '  install-doc	- install *all* documentation'
583	@echo '  install-man	- install manpage documentation'
584	@echo '  install-html	- install html documentation'
585	@echo '  install-info	- install GNU info documentation'
586	@echo '  install-pdf	- install pdf documentation'
587	@echo ''
588	@echo '  quick-install-doc	- alias for quick-install-man'
589	@echo '  quick-install-man	- install the documentation quickly'
590	@echo '  quick-install-html	- install the html documentation quickly'
591	@echo ''
592	@echo 'Perf maintainer targets:'
593	@echo '  clean			- clean all binary objects and build output'
594
595
596DOC_TARGETS := doc man html info pdf
597
598INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
599INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
600
601# 'make doc' should call 'make -C Documentation all'
602$(DOC_TARGETS):
603	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
604
605TAG_FOLDERS= . ../lib ../include
606TAG_FILES= ../../include/uapi/linux/perf_event.h
607
608TAGS:
609	$(QUIET_GEN)$(RM) TAGS; \
610	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs etags -a $(TAG_FILES)
611
612tags:
613	$(QUIET_GEN)$(RM) tags; \
614	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs ctags -a $(TAG_FILES)
615
616cscope:
617	$(QUIET_GEN)$(RM) cscope*; \
618	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs cscope -b $(TAG_FILES)
619
620### Testing rules
621
622# GNU make supports exporting all variables by "export" without parameters.
623# However, the environment gets quite big, and some programs have problems
624# with that.
625
626check: $(OUTPUT)common-cmds.h
627	if sparse; \
628	then \
629		for i in *.c */*.c; \
630		do \
631			sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
632		done; \
633	else \
634		exit 1; \
635	fi
636
637### Installation rules
638
639install-gtk:
640
641install-tools: all install-gtk
642	$(call QUIET_INSTALL, binaries) \
643		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
644		$(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
645		$(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
646ifndef NO_PERF_READ_VDSO32
647	$(call QUIET_INSTALL, perf-read-vdso32) \
648		$(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
649endif
650ifndef NO_PERF_READ_VDSOX32
651	$(call QUIET_INSTALL, perf-read-vdsox32) \
652		$(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
653endif
654	$(call QUIET_INSTALL, libexec) \
655		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
656	$(call QUIET_INSTALL, perf-archive) \
657		$(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
658	$(call QUIET_INSTALL, perf-with-kcore) \
659		$(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
660ifndef NO_LIBAUDIT
661	$(call QUIET_INSTALL, strace/groups) \
662		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'; \
663		$(INSTALL) trace/strace/groups/* -t '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'
664endif
665ifndef NO_LIBPERL
666	$(call QUIET_INSTALL, perl-scripts) \
667		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
668		$(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
669		$(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
670		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
671		$(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
672endif
673ifndef NO_LIBPYTHON
674	$(call QUIET_INSTALL, python-scripts) \
675		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
676		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
677		$(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
678		$(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
679		$(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
680endif
681	$(call QUIET_INSTALL, perf_completion-script) \
682		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
683		$(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
684	$(call QUIET_INSTALL, perf-tip) \
685		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(tip_instdir_SQ)'; \
686		$(INSTALL) Documentation/tips.txt -t '$(DESTDIR_SQ)$(tip_instdir_SQ)'
687
688install-tests: all install-gtk
689	$(call QUIET_INSTALL, tests) \
690		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
691		$(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
692		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
693		$(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'
694
695install-bin: install-tools install-tests
696
697install: install-bin try-install-man install-traceevent-plugins
698
699install-python_ext:
700	$(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
701
702# 'make install-doc' should call 'make -C Documentation install'
703$(INSTALL_DOC_TARGETS):
704	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
705
706### Cleaning rules
707
708#
709# This is here, not in Makefile.config, because Makefile.config does
710# not get included for the clean target:
711#
712config-clean:
713	$(call QUIET_CLEAN, config)
714	$(Q)$(MAKE) -C $(srctree)/tools/build/feature/ $(if $(OUTPUT),OUTPUT=$(OUTPUT)feature/,) clean >/dev/null
715
716clean:: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean $(LIBBPF)-clean $(LIBSUBCMD)-clean config-clean
717	$(call QUIET_CLEAN, core-objs)  $(RM) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(LANG_BINDINGS)
718	$(Q)find $(if $(OUTPUT),$(OUTPUT),.) -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
719	$(Q)$(RM) $(OUTPUT).config-detected
720	$(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32
721	$(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* \
722		$(OUTPUT)util/intel-pt-decoder/inat-tables.c $(OUTPUT)fixdep \
723		$(OUTPUT)tests/llvm-src-{base,kbuild,prologue,relocation}.c
724	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
725	$(python-clean)
726
727#
728# To provide FEATURE-DUMP into $(FEATURE_DUMP_COPY)
729# file if defined, with no further action.
730feature-dump:
731ifdef FEATURE_DUMP_COPY
732	@cp $(OUTPUT)FEATURE-DUMP $(FEATURE_DUMP_COPY)
733	@echo "FEATURE-DUMP file copied into $(FEATURE_DUMP_COPY)"
734else
735	@echo "FEATURE-DUMP file available in $(OUTPUT)FEATURE-DUMP"
736endif
737
738#
739# Trick: if ../../.git does not exist - we are building out of tree for example,
740# then force version regeneration:
741#
742ifeq ($(wildcard ../../.git/HEAD),)
743    GIT-HEAD-PHONY = ../../.git/HEAD
744else
745    GIT-HEAD-PHONY =
746endif
747
748FORCE:
749
750.PHONY: all install clean config-clean strip install-gtk
751.PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
752.PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE prepare
753.PHONY: libtraceevent_plugins archheaders
754
755