xref: /openbmc/linux/tools/perf/Makefile.perf (revision 8730046c)
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# Define NO_JVMTI if you do not want jvmti agent built
91#
92# Define LIBCLANGLLVM if you DO want builtin clang and llvm support.
93# When selected, pass LLVM_CONFIG=/path/to/llvm-config to `make' if
94# llvm-config is not in $PATH.
95
96# As per kernel Makefile, avoid funny character set dependencies
97unexport LC_ALL
98LC_COLLATE=C
99LC_NUMERIC=C
100export LC_COLLATE LC_NUMERIC
101
102ifeq ($(srctree),)
103srctree := $(patsubst %/,%,$(dir $(CURDIR)))
104srctree := $(patsubst %/,%,$(dir $(srctree)))
105#$(info Determined 'srctree' to be $(srctree))
106endif
107
108ifneq ($(objtree),)
109#$(info Determined 'objtree' to be $(objtree))
110endif
111
112ifneq ($(OUTPUT),)
113#$(info Determined 'OUTPUT' to be $(OUTPUT))
114# Adding $(OUTPUT) as a directory to look for source files,
115# because use generated output files as sources dependency
116# for flex/bison parsers.
117VPATH += $(OUTPUT)
118export VPATH
119endif
120
121ifeq ($(V),1)
122  Q =
123else
124  Q = @
125endif
126
127# Do not use make's built-in rules
128# (this improves performance and avoids hard-to-debug behaviour);
129MAKEFLAGS += -r
130
131# Makefiles suck: This macro sets a default value of $(2) for the
132# variable named by $(1), unless the variable has been set by
133# environment or command line. This is necessary for CC and AR
134# because make sets default values, so the simpler ?= approach
135# won't work as expected.
136define allow-override
137  $(if $(or $(findstring environment,$(origin $(1))),\
138            $(findstring command line,$(origin $(1)))),,\
139    $(eval $(1) = $(2)))
140endef
141
142# Allow setting CC and AR and LD, or setting CROSS_COMPILE as a prefix.
143$(call allow-override,CC,$(CROSS_COMPILE)gcc)
144$(call allow-override,AR,$(CROSS_COMPILE)ar)
145$(call allow-override,LD,$(CROSS_COMPILE)ld)
146$(call allow-override,CXX,$(CROSS_COMPILE)g++)
147
148LD += $(EXTRA_LDFLAGS)
149
150HOSTCC  ?= gcc
151HOSTLD  ?= ld
152HOSTAR  ?= ar
153
154PKG_CONFIG = $(CROSS_COMPILE)pkg-config
155LLVM_CONFIG ?= llvm-config
156
157RM      = rm -f
158LN      = ln -f
159MKDIR   = mkdir
160FIND    = find
161INSTALL = install
162FLEX    = flex
163BISON   = bison
164STRIP   = strip
165AWK     = awk
166
167# include Makefile.config by default and rule out
168# non-config cases
169config := 1
170
171NON_CONFIG_TARGETS := clean TAGS tags cscope help install-doc install-man install-html install-info install-pdf doc man html info pdf
172
173ifdef MAKECMDGOALS
174ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
175  config := 0
176endif
177endif
178
179# The fixdep build - we force fixdep tool to be built as
180# the first target in the separate make session not to be
181# disturbed by any parallel make jobs. Once fixdep is done
182# we issue the requested build with FIXDEP=1 variable.
183#
184# The fixdep build is disabled for $(NON_CONFIG_TARGETS)
185# targets, because it's not necessary.
186
187ifdef FIXDEP
188  force_fixdep := 0
189else
190  force_fixdep := $(config)
191endif
192
193export srctree OUTPUT RM CC CXX LD AR CFLAGS CXXFLAGS V BISON FLEX AWK
194export HOSTCC HOSTLD HOSTAR
195
196include $(srctree)/tools/build/Makefile.include
197
198ifeq ($(force_fixdep),1)
199goals := $(filter-out all sub-make, $(MAKECMDGOALS))
200
201$(goals) all: sub-make
202
203sub-make: fixdep
204	@./check-headers.sh
205	$(Q)$(MAKE) FIXDEP=1 -f Makefile.perf $(goals)
206
207else # force_fixdep
208
209LIB_DIR         = $(srctree)/tools/lib/api/
210TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
211BPF_DIR         = $(srctree)/tools/lib/bpf/
212SUBCMD_DIR      = $(srctree)/tools/lib/subcmd/
213
214# Set FEATURE_TESTS to 'all' so all possible feature checkers are executed.
215# Without this setting the output feature dump file misses some features, for
216# example, liberty. Select all checkers so we won't get an incomplete feature
217# dump file.
218ifeq ($(config),1)
219ifdef MAKECMDGOALS
220ifeq ($(filter feature-dump,$(MAKECMDGOALS)),feature-dump)
221FEATURE_TESTS := all
222endif
223endif
224include Makefile.config
225endif
226
227ifeq ($(config),0)
228include $(srctree)/tools/scripts/Makefile.arch
229-include arch/$(ARCH)/Makefile
230endif
231
232# The FEATURE_DUMP_EXPORT holds location of the actual
233# FEATURE_DUMP file to be used to bypass feature detection
234# (for bpf or any other subproject)
235ifeq ($(FEATURES_DUMP),)
236FEATURE_DUMP_EXPORT := $(realpath $(OUTPUT)FEATURE-DUMP)
237else
238FEATURE_DUMP_EXPORT := $(FEATURES_DUMP)
239endif
240
241export prefix bindir sharedir sysconfdir DESTDIR
242
243# sparse is architecture-neutral, which means that we need to tell it
244# explicitly what architecture to check for. Fix this up for yours..
245SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
246
247# Guard against environment variables
248PYRF_OBJS =
249SCRIPT_SH =
250
251SCRIPT_SH += perf-archive.sh
252SCRIPT_SH += perf-with-kcore.sh
253
254grep-libs = $(filter -l%,$(1))
255strip-libs = $(filter-out -l%,$(1))
256
257ifneq ($(OUTPUT),)
258  TE_PATH=$(OUTPUT)
259  BPF_PATH=$(OUTPUT)
260  SUBCMD_PATH=$(OUTPUT)
261ifneq ($(subdir),)
262  API_PATH=$(OUTPUT)/../lib/api/
263else
264  API_PATH=$(OUTPUT)
265endif
266else
267  TE_PATH=$(TRACE_EVENT_DIR)
268  API_PATH=$(LIB_DIR)
269  BPF_PATH=$(BPF_DIR)
270  SUBCMD_PATH=$(SUBCMD_DIR)
271endif
272
273LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
274export LIBTRACEEVENT
275
276LIBTRACEEVENT_DYNAMIC_LIST = $(TE_PATH)libtraceevent-dynamic-list
277LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS = -Xlinker --dynamic-list=$(LIBTRACEEVENT_DYNAMIC_LIST)
278
279LIBAPI = $(API_PATH)libapi.a
280export LIBAPI
281
282LIBBPF = $(BPF_PATH)libbpf.a
283
284LIBSUBCMD = $(SUBCMD_PATH)libsubcmd.a
285
286# python extension build directories
287PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
288PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
289PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
290export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
291
292python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf.so
293
294PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
295PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
296
297SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
298
299PROGRAMS += $(OUTPUT)perf
300
301ifndef NO_PERF_READ_VDSO32
302PROGRAMS += $(OUTPUT)perf-read-vdso32
303endif
304
305ifndef NO_PERF_READ_VDSOX32
306PROGRAMS += $(OUTPUT)perf-read-vdsox32
307endif
308
309LIBJVMTI = libperf-jvmti.so
310
311ifndef NO_JVMTI
312PROGRAMS += $(OUTPUT)$(LIBJVMTI)
313endif
314
315# what 'all' will build and 'install' will install, in perfexecdir
316ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
317
318# what 'all' will build but not install in perfexecdir
319OTHER_PROGRAMS = $(OUTPUT)perf
320
321# Set paths to tools early so that they can be used for version tests.
322ifndef SHELL_PATH
323  SHELL_PATH = /bin/sh
324endif
325ifndef PERL_PATH
326  PERL_PATH = /usr/bin/perl
327endif
328
329export PERL_PATH
330
331LIB_FILE=$(OUTPUT)libperf.a
332
333PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT) $(LIBSUBCMD)
334ifndef NO_LIBBPF
335  PERFLIBS += $(LIBBPF)
336endif
337
338# We choose to avoid "if .. else if .. else .. endif endif"
339# because maintaining the nesting to match is a pain.  If
340# we had "elif" things would have been much nicer...
341
342ifneq ($(OUTPUT),)
343  CFLAGS += -I$(OUTPUT)
344endif
345
346ifndef NO_GTK2
347  ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
348  GTK_IN := $(OUTPUT)gtk-in.o
349endif
350
351ifdef ASCIIDOC8
352  export ASCIIDOC8
353endif
354
355LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
356
357ifeq ($(USE_CLANG), 1)
358  CLANGLIBS_LIST = AST Basic CodeGen Driver Frontend Lex Tooling Edit Sema Analysis Parse Serialization
359  LIBCLANG = $(foreach l,$(CLANGLIBS_LIST),$(wildcard $(shell $(LLVM_CONFIG) --libdir)/libclang$(l).a))
360  LIBS += -Wl,--start-group $(LIBCLANG) -Wl,--end-group
361endif
362
363ifeq ($(USE_LLVM), 1)
364  LIBLLVM = $(shell $(LLVM_CONFIG) --libs all) $(shell $(LLVM_CONFIG) --system-libs)
365  LIBS += -L$(shell $(LLVM_CONFIG) --libdir) $(LIBLLVM)
366endif
367
368ifeq ($(USE_CXX), 1)
369  LIBS += -lstdc++
370endif
371
372export INSTALL SHELL_PATH
373
374### Build rules
375
376SHELL = $(SHELL_PATH)
377
378all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
379
380$(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS) $(LIBTRACEEVENT_DYNAMIC_LIST)
381	$(QUIET_GEN)LDSHARED="$(CC) -pthread -shared" \
382        CFLAGS='$(CFLAGS)' LDFLAGS='$(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS)' \
383	  $(PYTHON_WORD) util/setup.py \
384	  --quiet build_ext; \
385	mkdir -p $(OUTPUT)python && \
386	cp $(PYTHON_EXTBUILD_LIB)perf.so $(OUTPUT)python/
387
388please_set_SHELL_PATH_to_a_more_modern_shell:
389	$(Q)$$(:)
390
391shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
392
393strip: $(PROGRAMS) $(OUTPUT)perf
394	$(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
395
396PERF_IN := $(OUTPUT)perf-in.o
397
398JEVENTS       := $(OUTPUT)pmu-events/jevents
399JEVENTS_IN    := $(OUTPUT)pmu-events/jevents-in.o
400
401PMU_EVENTS_IN := $(OUTPUT)pmu-events/pmu-events-in.o
402
403export JEVENTS
404
405build := -f $(srctree)/tools/build/Makefile.build dir=. obj
406
407$(PERF_IN): prepare FORCE
408	$(Q)$(MAKE) $(build)=perf
409
410$(JEVENTS_IN): FORCE
411	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=jevents
412
413$(JEVENTS): $(JEVENTS_IN)
414	$(QUIET_LINK)$(HOSTCC) $(JEVENTS_IN) -o $@
415
416$(PMU_EVENTS_IN): $(JEVENTS) FORCE
417	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=pmu-events
418
419$(OUTPUT)perf: $(PERFLIBS) $(PERF_IN) $(PMU_EVENTS_IN) $(LIBTRACEEVENT_DYNAMIC_LIST)
420	$(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS) \
421		$(PERF_IN) $(PMU_EVENTS_IN) $(LIBS) -o $@
422
423$(GTK_IN): FORCE
424	$(Q)$(MAKE) $(build)=gtk
425
426$(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
427	$(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
428
429$(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
430
431$(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
432	$(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
433
434$(SCRIPTS) : % : %.sh
435	$(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
436
437$(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
438	$(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
439	$(Q)touch $(OUTPUT)PERF-VERSION-FILE
440
441# These can record PERF_VERSION
442perf.spec $(SCRIPTS) \
443	: $(OUTPUT)PERF-VERSION-FILE
444
445.SUFFIXES:
446
447#
448# If a target does not match any of the later rules then prefix it by $(OUTPUT)
449# This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
450#
451ifneq ($(OUTPUT),)
452%.o: $(OUTPUT)%.o
453	@echo "    # Redirected target $@ => $(OUTPUT)$@"
454pmu-events/%.o: $(OUTPUT)pmu-events/%.o
455	@echo "    # Redirected target $@ => $(OUTPUT)$@"
456util/%.o: $(OUTPUT)util/%.o
457	@echo "    # Redirected target $@ => $(OUTPUT)$@"
458bench/%.o: $(OUTPUT)bench/%.o
459	@echo "    # Redirected target $@ => $(OUTPUT)$@"
460tests/%.o: $(OUTPUT)tests/%.o
461	@echo "    # Redirected target $@ => $(OUTPUT)$@"
462endif
463
464# These two need to be here so that when O= is not used they take precedence
465# over the general rule for .o
466
467# get relative building directory (to $(OUTPUT))
468# and '.' if it's $(OUTPUT) itself
469__build-dir = $(subst $(OUTPUT),,$(dir $@))
470build-dir   = $(if $(__build-dir),$(__build-dir),.)
471
472prepare: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h archheaders
473
474$(OUTPUT)%.o: %.c prepare FORCE
475	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
476
477$(OUTPUT)%.i: %.c prepare FORCE
478	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
479
480$(OUTPUT)%.s: %.c prepare FORCE
481	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
482
483$(OUTPUT)%-bison.o: %.c prepare FORCE
484	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
485
486$(OUTPUT)%-flex.o: %.c prepare FORCE
487	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
488
489$(OUTPUT)%.o: %.S prepare FORCE
490	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
491
492$(OUTPUT)%.i: %.S prepare FORCE
493	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
494
495$(OUTPUT)perf-%: %.o $(PERFLIBS)
496	$(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
497
498ifndef NO_PERF_READ_VDSO32
499$(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
500	$(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
501endif
502
503ifndef NO_PERF_READ_VDSOX32
504$(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
505	$(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
506endif
507
508ifndef NO_JVMTI
509LIBJVMTI_IN := $(OUTPUT)jvmti/jvmti-in.o
510
511$(LIBJVMTI_IN): FORCE
512	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=jvmti obj=jvmti
513
514$(OUTPUT)$(LIBJVMTI): $(LIBJVMTI_IN)
515	$(QUIET_LINK)$(CC) -shared -Wl,-soname -Wl,$(LIBJVMTI) -o $@ $< -lelf -lrt
516endif
517
518$(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
519
520LIBPERF_IN := $(OUTPUT)libperf-in.o
521
522$(LIBPERF_IN): prepare FORCE
523	$(Q)$(MAKE) $(build)=libperf
524
525$(LIB_FILE): $(LIBPERF_IN)
526	$(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
527
528LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ)
529
530$(LIBTRACEEVENT): FORCE
531	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a
532
533libtraceevent_plugins: FORCE
534	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) plugins
535
536$(LIBTRACEEVENT_DYNAMIC_LIST): libtraceevent_plugins
537	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent-dynamic-list
538
539$(LIBTRACEEVENT)-clean:
540	$(call QUIET_CLEAN, libtraceevent)
541	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
542
543install-traceevent-plugins: libtraceevent_plugins
544	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
545
546$(LIBAPI): FORCE
547	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
548
549$(LIBAPI)-clean:
550	$(call QUIET_CLEAN, libapi)
551	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
552
553$(LIBBPF): FORCE
554	$(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) $(OUTPUT)libbpf.a FEATURES_DUMP=$(FEATURE_DUMP_EXPORT)
555
556$(LIBBPF)-clean:
557	$(call QUIET_CLEAN, libbpf)
558	$(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) clean >/dev/null
559
560$(LIBSUBCMD): FORCE
561	$(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) $(OUTPUT)libsubcmd.a
562
563$(LIBSUBCMD)-clean:
564	$(call QUIET_CLEAN, libsubcmd)
565	$(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) clean
566
567help:
568	@echo 'Perf make targets:'
569	@echo '  doc		- make *all* documentation (see below)'
570	@echo '  man		- make manpage documentation (access with man <foo>)'
571	@echo '  html		- make html documentation'
572	@echo '  info		- make GNU info documentation (access with info <foo>)'
573	@echo '  pdf		- make pdf documentation'
574	@echo '  TAGS		- use etags to make tag information for source browsing'
575	@echo '  tags		- use ctags to make tag information for source browsing'
576	@echo '  cscope	- use cscope to make interactive browsing database'
577	@echo ''
578	@echo 'Perf install targets:'
579	@echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
580	@echo '  HINT: use "prefix" or "DESTDIR" to install to a particular'
581	@echo '        path like "make prefix=/usr/local install install-doc"'
582	@echo '  install	- install compiled binaries'
583	@echo '  install-doc	- install *all* documentation'
584	@echo '  install-man	- install manpage documentation'
585	@echo '  install-html	- install html documentation'
586	@echo '  install-info	- install GNU info documentation'
587	@echo '  install-pdf	- install pdf documentation'
588	@echo ''
589	@echo '  quick-install-doc	- alias for quick-install-man'
590	@echo '  quick-install-man	- install the documentation quickly'
591	@echo '  quick-install-html	- install the html documentation quickly'
592	@echo ''
593	@echo 'Perf maintainer targets:'
594	@echo '  clean			- clean all binary objects and build output'
595
596
597DOC_TARGETS := doc man html info pdf
598
599INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
600INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
601
602# 'make doc' should call 'make -C Documentation all'
603$(DOC_TARGETS):
604	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
605
606TAG_FOLDERS= . ../lib ../include
607TAG_FILES= ../../include/uapi/linux/perf_event.h
608
609TAGS:
610	$(QUIET_GEN)$(RM) TAGS; \
611	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs etags -a $(TAG_FILES)
612
613tags:
614	$(QUIET_GEN)$(RM) tags; \
615	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs ctags -a $(TAG_FILES)
616
617cscope:
618	$(QUIET_GEN)$(RM) cscope*; \
619	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs cscope -b $(TAG_FILES)
620
621### Testing rules
622
623# GNU make supports exporting all variables by "export" without parameters.
624# However, the environment gets quite big, and some programs have problems
625# with that.
626
627check: $(OUTPUT)common-cmds.h
628	if sparse; \
629	then \
630		for i in *.c */*.c; \
631		do \
632			sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
633		done; \
634	else \
635		exit 1; \
636	fi
637
638### Installation rules
639
640ifndef NO_GTK2
641install-gtk: $(OUTPUT)libperf-gtk.so
642	$(call QUIET_INSTALL, 'GTK UI') \
643		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
644		$(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
645else
646install-gtk:
647endif
648
649install-tools: all install-gtk
650	$(call QUIET_INSTALL, binaries) \
651		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
652		$(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
653		$(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
654ifndef NO_PERF_READ_VDSO32
655	$(call QUIET_INSTALL, perf-read-vdso32) \
656		$(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
657endif
658ifndef NO_PERF_READ_VDSOX32
659	$(call QUIET_INSTALL, perf-read-vdsox32) \
660		$(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
661endif
662ifndef NO_JVMTI
663	$(call QUIET_INSTALL, $(LIBJVMTI)) \
664		$(INSTALL) $(OUTPUT)$(LIBJVMTI) '$(DESTDIR_SQ)$(libdir_SQ)';
665endif
666	$(call QUIET_INSTALL, libexec) \
667		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
668	$(call QUIET_INSTALL, perf-archive) \
669		$(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
670	$(call QUIET_INSTALL, perf-with-kcore) \
671		$(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
672ifndef NO_LIBAUDIT
673	$(call QUIET_INSTALL, strace/groups) \
674		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'; \
675		$(INSTALL) trace/strace/groups/* -t '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'
676endif
677ifndef NO_LIBPERL
678	$(call QUIET_INSTALL, perl-scripts) \
679		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
680		$(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
681		$(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
682		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
683		$(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
684endif
685ifndef NO_LIBPYTHON
686	$(call QUIET_INSTALL, python-scripts) \
687		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
688		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
689		$(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
690		$(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
691		$(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
692endif
693	$(call QUIET_INSTALL, perf_completion-script) \
694		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
695		$(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
696	$(call QUIET_INSTALL, perf-tip) \
697		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(tip_instdir_SQ)'; \
698		$(INSTALL) Documentation/tips.txt -t '$(DESTDIR_SQ)$(tip_instdir_SQ)'
699
700install-tests: all install-gtk
701	$(call QUIET_INSTALL, tests) \
702		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
703		$(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
704		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
705		$(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'
706
707install-bin: install-tools install-tests install-traceevent-plugins
708
709install: install-bin try-install-man
710
711install-python_ext:
712	$(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
713
714# 'make install-doc' should call 'make -C Documentation install'
715$(INSTALL_DOC_TARGETS):
716	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
717
718### Cleaning rules
719
720#
721# This is here, not in Makefile.config, because Makefile.config does
722# not get included for the clean target:
723#
724config-clean:
725	$(call QUIET_CLEAN, config)
726	$(Q)$(MAKE) -C $(srctree)/tools/build/feature/ $(if $(OUTPUT),OUTPUT=$(OUTPUT)feature/,) clean >/dev/null
727
728clean:: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean $(LIBBPF)-clean $(LIBSUBCMD)-clean config-clean
729	$(call QUIET_CLEAN, core-objs)  $(RM) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(LANG_BINDINGS)
730	$(Q)find $(if $(OUTPUT),$(OUTPUT),.) -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
731	$(Q)$(RM) $(OUTPUT).config-detected
732	$(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32 $(OUTPUT)pmu-events/jevents $(OUTPUT)$(LIBJVMTI).so
733	$(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* \
734		$(OUTPUT)util/intel-pt-decoder/inat-tables.c $(OUTPUT)fixdep \
735		$(OUTPUT)tests/llvm-src-{base,kbuild,prologue,relocation}.c \
736		$(OUTPUT)pmu-events/pmu-events.c
737	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
738	$(python-clean)
739
740#
741# To provide FEATURE-DUMP into $(FEATURE_DUMP_COPY)
742# file if defined, with no further action.
743feature-dump:
744ifdef FEATURE_DUMP_COPY
745	@cp $(OUTPUT)FEATURE-DUMP $(FEATURE_DUMP_COPY)
746	@echo "FEATURE-DUMP file copied into $(FEATURE_DUMP_COPY)"
747else
748	@echo "FEATURE-DUMP file available in $(OUTPUT)FEATURE-DUMP"
749endif
750
751#
752# Trick: if ../../.git does not exist - we are building out of tree for example,
753# then force version regeneration:
754#
755ifeq ($(wildcard ../../.git/HEAD),)
756    GIT-HEAD-PHONY = ../../.git/HEAD
757else
758    GIT-HEAD-PHONY =
759endif
760
761FORCE:
762
763.PHONY: all install clean config-clean strip install-gtk
764.PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
765.PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE prepare
766.PHONY: libtraceevent_plugins archheaders
767
768endif # force_fixdep
769