xref: /openbmc/linux/tools/perf/Makefile.perf (revision d0bd7f2a)
1include ../scripts/Makefile.include
2
3# The default target of this Makefile is...
4all:
5
6include config/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_LIBDW_DWARF_UNWIND if you do not want libdw support
62# for dwarf backtrace post unwind.
63#
64# Define NO_PERF_READ_VDSO32 if you do not want to build perf-read-vdso32
65# for reading the 32-bit compatibility VDSO in 64-bit mode
66#
67# Define NO_PERF_READ_VDSOX32 if you do not want to build perf-read-vdsox32
68# for reading the x32 mode 32-bit compatibility VDSO in 64-bit mode
69#
70# Define NO_ZLIB if you do not want to support compressed kernel modules
71#
72# Define LIBBABELTRACE if you DO want libbabeltrace support
73# for CTF data format.
74#
75# Define NO_LZMA if you do not want to support compressed (xz) kernel modules
76
77ifeq ($(srctree),)
78srctree := $(patsubst %/,%,$(dir $(shell pwd)))
79srctree := $(patsubst %/,%,$(dir $(srctree)))
80#$(info Determined 'srctree' to be $(srctree))
81endif
82
83ifneq ($(objtree),)
84#$(info Determined 'objtree' to be $(objtree))
85endif
86
87ifneq ($(OUTPUT),)
88#$(info Determined 'OUTPUT' to be $(OUTPUT))
89# Adding $(OUTPUT) as a directory to look for source files,
90# because use generated output files as sources dependency
91# for flex/bison parsers.
92VPATH += $(OUTPUT)
93export VPATH
94endif
95
96ifeq ($(V),1)
97  Q =
98else
99  Q = @
100endif
101
102# Do not use make's built-in rules
103# (this improves performance and avoids hard-to-debug behaviour);
104MAKEFLAGS += -r
105
106$(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
107	$(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
108	$(Q)touch $(OUTPUT)PERF-VERSION-FILE
109
110CC = $(CROSS_COMPILE)gcc
111LD = $(CROSS_COMPILE)ld
112AR = $(CROSS_COMPILE)ar
113PKG_CONFIG = $(CROSS_COMPILE)pkg-config
114
115RM      = rm -f
116LN      = ln -f
117MKDIR   = mkdir
118FIND    = find
119INSTALL = install
120FLEX    = flex
121BISON   = bison
122STRIP   = strip
123
124LIB_DIR          = $(srctree)/tools/lib/api/
125TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
126
127# include config/Makefile by default and rule out
128# non-config cases
129config := 1
130
131NON_CONFIG_TARGETS := clean TAGS tags cscope help
132
133ifdef MAKECMDGOALS
134ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
135  config := 0
136endif
137endif
138
139ifeq ($(config),1)
140include config/Makefile
141endif
142
143export prefix bindir sharedir sysconfdir DESTDIR
144
145# sparse is architecture-neutral, which means that we need to tell it
146# explicitly what architecture to check for. Fix this up for yours..
147SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
148
149# Guard against environment variables
150PYRF_OBJS =
151SCRIPT_SH =
152
153SCRIPT_SH += perf-archive.sh
154SCRIPT_SH += perf-with-kcore.sh
155
156grep-libs = $(filter -l%,$(1))
157strip-libs = $(filter-out -l%,$(1))
158
159ifneq ($(OUTPUT),)
160  TE_PATH=$(OUTPUT)
161ifneq ($(subdir),)
162  LIB_PATH=$(OUTPUT)/../lib/api/
163else
164  LIB_PATH=$(OUTPUT)
165endif
166else
167  TE_PATH=$(TRACE_EVENT_DIR)
168  LIB_PATH=$(LIB_DIR)
169endif
170
171LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
172export LIBTRACEEVENT
173
174LIBAPI = $(LIB_PATH)libapi.a
175export LIBAPI
176
177# python extension build directories
178PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
179PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
180PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
181export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
182
183python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf.so
184
185PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
186PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
187
188$(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS)
189	$(QUIET_GEN)CFLAGS='$(CFLAGS)' $(PYTHON_WORD) util/setup.py \
190	  --quiet build_ext; \
191	mkdir -p $(OUTPUT)python && \
192	cp $(PYTHON_EXTBUILD_LIB)perf.so $(OUTPUT)python/
193#
194# No Perl scripts right now:
195#
196
197SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
198
199PROGRAMS += $(OUTPUT)perf
200
201ifndef NO_PERF_READ_VDSO32
202PROGRAMS += $(OUTPUT)perf-read-vdso32
203endif
204
205ifndef NO_PERF_READ_VDSOX32
206PROGRAMS += $(OUTPUT)perf-read-vdsox32
207endif
208
209# what 'all' will build and 'install' will install, in perfexecdir
210ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
211
212# what 'all' will build but not install in perfexecdir
213OTHER_PROGRAMS = $(OUTPUT)perf
214
215# Set paths to tools early so that they can be used for version tests.
216ifndef SHELL_PATH
217  SHELL_PATH = /bin/sh
218endif
219ifndef PERL_PATH
220  PERL_PATH = /usr/bin/perl
221endif
222
223export PERL_PATH
224
225LIB_FILE=$(OUTPUT)libperf.a
226
227PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT)
228
229# We choose to avoid "if .. else if .. else .. endif endif"
230# because maintaining the nesting to match is a pain.  If
231# we had "elif" things would have been much nicer...
232
233-include arch/$(ARCH)/Makefile
234
235ifneq ($(OUTPUT),)
236  CFLAGS += -I$(OUTPUT)
237endif
238
239ifndef NO_GTK2
240  ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
241  GTK_IN := $(OUTPUT)gtk-in.o
242
243install-gtk: $(OUTPUT)libperf-gtk.so
244	$(call QUIET_INSTALL, 'GTK UI') \
245		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
246		$(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
247endif
248
249ifdef ASCIIDOC8
250  export ASCIIDOC8
251endif
252
253LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
254
255export INSTALL SHELL_PATH
256
257### Build rules
258
259SHELL = $(SHELL_PATH)
260
261all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
262
263please_set_SHELL_PATH_to_a_more_modern_shell:
264	$(Q)$$(:)
265
266shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
267
268strip: $(PROGRAMS) $(OUTPUT)perf
269	$(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
270
271PERF_IN := $(OUTPUT)perf-in.o
272
273export srctree OUTPUT RM CC LD AR CFLAGS V BISON FLEX
274build := -f $(srctree)/tools/build/Makefile.build dir=. obj
275
276$(PERF_IN): $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h FORCE
277	$(Q)$(MAKE) $(build)=perf
278
279$(OUTPUT)perf: $(PERFLIBS) $(PERF_IN)
280	$(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(PERF_IN) $(LIBS) -o $@
281
282$(GTK_IN): FORCE
283	$(Q)$(MAKE) $(build)=gtk
284
285$(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
286	$(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
287
288$(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
289
290$(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
291	$(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
292
293$(SCRIPTS) : % : %.sh
294	$(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
295
296# These can record PERF_VERSION
297perf.spec $(SCRIPTS) \
298	: $(OUTPUT)PERF-VERSION-FILE
299
300.SUFFIXES:
301
302#
303# If a target does not match any of the later rules then prefix it by $(OUTPUT)
304# This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
305#
306ifneq ($(OUTPUT),)
307%.o: $(OUTPUT)%.o
308	@echo "    # Redirected target $@ => $(OUTPUT)$@"
309util/%.o: $(OUTPUT)util/%.o
310	@echo "    # Redirected target $@ => $(OUTPUT)$@"
311bench/%.o: $(OUTPUT)bench/%.o
312	@echo "    # Redirected target $@ => $(OUTPUT)$@"
313tests/%.o: $(OUTPUT)tests/%.o
314	@echo "    # Redirected target $@ => $(OUTPUT)$@"
315endif
316
317# These two need to be here so that when O= is not used they take precedence
318# over the general rule for .o
319
320# get relative building directory (to $(OUTPUT))
321# and '.' if it's $(OUTPUT) itself
322__build-dir = $(subst $(OUTPUT),,$(dir $@))
323build-dir   = $(if $(__build-dir),$(__build-dir),.)
324
325single_dep: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h
326
327$(OUTPUT)%.o: %.c single_dep FORCE
328	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
329
330$(OUTPUT)%.i: %.c single_dep FORCE
331	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
332
333$(OUTPUT)%.s: %.c single_dep FORCE
334	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
335
336$(OUTPUT)%-bison.o: %.c single_dep FORCE
337	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
338
339$(OUTPUT)%-flex.o: %.c single_dep FORCE
340	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
341
342$(OUTPUT)%.o: %.S single_dep FORCE
343	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
344
345$(OUTPUT)%.i: %.S single_dep FORCE
346	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
347
348$(OUTPUT)perf-%: %.o $(PERFLIBS)
349	$(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
350
351ifndef NO_PERF_READ_VDSO32
352$(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
353	$(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
354endif
355
356ifndef NO_PERF_READ_VDSOX32
357$(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
358	$(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
359endif
360
361$(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
362
363LIBPERF_IN := $(OUTPUT)libperf-in.o
364
365$(LIBPERF_IN): FORCE
366	$(Q)$(MAKE) $(build)=libperf
367
368$(LIB_FILE): $(LIBPERF_IN)
369	$(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
370
371LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ)
372
373$(LIBTRACEEVENT): FORCE
374	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a plugins
375
376$(LIBTRACEEVENT)-clean:
377	$(call QUIET_CLEAN, libtraceevent)
378	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
379
380install-traceevent-plugins: $(LIBTRACEEVENT)
381	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
382
383$(LIBAPI): FORCE
384	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
385
386$(LIBAPI)-clean:
387	$(call QUIET_CLEAN, libapi)
388	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
389
390help:
391	@echo 'Perf make targets:'
392	@echo '  doc		- make *all* documentation (see below)'
393	@echo '  man		- make manpage documentation (access with man <foo>)'
394	@echo '  html		- make html documentation'
395	@echo '  info		- make GNU info documentation (access with info <foo>)'
396	@echo '  pdf		- make pdf documentation'
397	@echo '  TAGS		- use etags to make tag information for source browsing'
398	@echo '  tags		- use ctags to make tag information for source browsing'
399	@echo '  cscope	- use cscope to make interactive browsing database'
400	@echo ''
401	@echo 'Perf install targets:'
402	@echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
403	@echo '  HINT: use "prefix" or "DESTDIR" to install to a particular'
404	@echo '        path like "make prefix=/usr/local install install-doc"'
405	@echo '  install	- install compiled binaries'
406	@echo '  install-doc	- install *all* documentation'
407	@echo '  install-man	- install manpage documentation'
408	@echo '  install-html	- install html documentation'
409	@echo '  install-info	- install GNU info documentation'
410	@echo '  install-pdf	- install pdf documentation'
411	@echo ''
412	@echo '  quick-install-doc	- alias for quick-install-man'
413	@echo '  quick-install-man	- install the documentation quickly'
414	@echo '  quick-install-html	- install the html documentation quickly'
415	@echo ''
416	@echo 'Perf maintainer targets:'
417	@echo '  clean			- clean all binary objects and build output'
418
419
420DOC_TARGETS := doc man html info pdf
421
422INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
423INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
424
425# 'make doc' should call 'make -C Documentation all'
426$(DOC_TARGETS):
427	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
428
429TAG_FOLDERS= . ../lib/traceevent ../lib/api ../lib/symbol
430TAG_FILES= ../../include/uapi/linux/perf_event.h
431
432TAGS:
433	$(QUIET_GEN)$(RM) TAGS; \
434	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs etags -a $(TAG_FILES)
435
436tags:
437	$(QUIET_GEN)$(RM) tags; \
438	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs ctags -a $(TAG_FILES)
439
440cscope:
441	$(QUIET_GEN)$(RM) cscope*; \
442	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs cscope -b $(TAG_FILES)
443
444### Testing rules
445
446# GNU make supports exporting all variables by "export" without parameters.
447# However, the environment gets quite big, and some programs have problems
448# with that.
449
450check: $(OUTPUT)common-cmds.h
451	if sparse; \
452	then \
453		for i in *.c */*.c; \
454		do \
455			sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
456		done; \
457	else \
458		exit 1; \
459	fi
460
461### Installation rules
462
463install-gtk:
464
465install-bin: all install-gtk
466	$(call QUIET_INSTALL, binaries) \
467		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
468		$(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
469		$(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
470ifndef NO_PERF_READ_VDSO32
471	$(call QUIET_INSTALL, perf-read-vdso32) \
472		$(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
473endif
474ifndef NO_PERF_READ_VDSOX32
475	$(call QUIET_INSTALL, perf-read-vdsox32) \
476		$(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
477endif
478	$(call QUIET_INSTALL, libexec) \
479		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
480	$(call QUIET_INSTALL, perf-archive) \
481		$(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
482	$(call QUIET_INSTALL, perf-with-kcore) \
483		$(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
484ifndef NO_LIBPERL
485	$(call QUIET_INSTALL, perl-scripts) \
486		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
487		$(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
488		$(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
489		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
490		$(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
491endif
492ifndef NO_LIBPYTHON
493	$(call QUIET_INSTALL, python-scripts) \
494		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
495		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
496		$(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
497		$(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
498		$(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
499endif
500	$(call QUIET_INSTALL, perf_completion-script) \
501		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
502		$(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
503	$(call QUIET_INSTALL, tests) \
504		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
505		$(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
506		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
507		$(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'
508
509install: install-bin try-install-man install-traceevent-plugins
510
511install-python_ext:
512	$(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
513
514# 'make install-doc' should call 'make -C Documentation install'
515$(INSTALL_DOC_TARGETS):
516	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
517
518### Cleaning rules
519
520#
521# This is here, not in config/Makefile, because config/Makefile does
522# not get included for the clean target:
523#
524config-clean:
525	$(call QUIET_CLEAN, config)
526	$(Q)$(MAKE) -C $(srctree)/tools/build/feature/ clean >/dev/null
527
528clean: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean config-clean
529	$(call QUIET_CLEAN, core-objs)  $(RM) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(LANG_BINDINGS)
530	$(Q)find . -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
531	$(Q)$(RM) .config-detected
532	$(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32
533	$(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*
534	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
535	$(python-clean)
536
537#
538# Trick: if ../../.git does not exist - we are building out of tree for example,
539# then force version regeneration:
540#
541ifeq ($(wildcard ../../.git/HEAD),)
542    GIT-HEAD-PHONY = ../../.git/HEAD
543else
544    GIT-HEAD-PHONY =
545endif
546
547FORCE:
548
549.PHONY: all install clean config-clean strip install-gtk
550.PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
551.PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE single_dep
552
553