Linux 4.1.18
[linux/fpc-iii.git] / tools / perf / Makefile.perf
blobc43a2051759157dd6b65118b34b342b149f58861
1 include ../scripts/Makefile.include
3 # The default target of this Makefile is...
4 all:
6 include config/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_LIBDW_DWARF_UNWIND if you do not want libdw support
62 # for dwarf backtrace post unwind.
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
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
70 # Define NO_ZLIB if you do not want to support compressed kernel modules
72 # Define LIBBABELTRACE if you DO want libbabeltrace support
73 # for CTF data format.
75 # Define NO_LZMA if you do not want to support compressed (xz) kernel modules
77 ifeq ($(srctree),)
78 srctree := $(patsubst %/,%,$(dir $(shell pwd)))
79 srctree := $(patsubst %/,%,$(dir $(srctree)))
80 #$(info Determined 'srctree' to be $(srctree))
81 endif
83 ifneq ($(objtree),)
84 #$(info Determined 'objtree' to be $(objtree))
85 endif
87 ifneq ($(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.
92 VPATH += $(OUTPUT)
93 export VPATH
94 endif
96 ifeq ($(V),1)
97   Q =
98 else
99   Q = @
100 endif
102 # Do not use make's built-in rules
103 # (this improves performance and avoids hard-to-debug behaviour);
104 MAKEFLAGS += -r
106 $(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
107         $(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
108         $(Q)touch $(OUTPUT)PERF-VERSION-FILE
110 CC = $(CROSS_COMPILE)gcc
111 LD = $(CROSS_COMPILE)ld
112 AR = $(CROSS_COMPILE)ar
113 PKG_CONFIG = $(CROSS_COMPILE)pkg-config
115 RM      = rm -f
116 LN      = ln -f
117 MKDIR   = mkdir
118 FIND    = find
119 INSTALL = install
120 FLEX    = flex
121 BISON   = bison
122 STRIP   = strip
124 LIB_DIR          = $(srctree)/tools/lib/api/
125 TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
127 # include config/Makefile by default and rule out
128 # non-config cases
129 config := 1
131 NON_CONFIG_TARGETS := clean TAGS tags cscope help
133 ifdef MAKECMDGOALS
134 ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
135   config := 0
136 endif
137 endif
139 ifeq ($(config),1)
140 include config/Makefile
141 endif
143 export prefix bindir sharedir sysconfdir DESTDIR
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..
147 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
149 # Guard against environment variables
150 PYRF_OBJS =
151 SCRIPT_SH =
153 SCRIPT_SH += perf-archive.sh
154 SCRIPT_SH += perf-with-kcore.sh
156 grep-libs = $(filter -l%,$(1))
157 strip-libs = $(filter-out -l%,$(1))
159 ifneq ($(OUTPUT),)
160   TE_PATH=$(OUTPUT)
161 ifneq ($(subdir),)
162   LIB_PATH=$(OUTPUT)/../lib/api/
163 else
164   LIB_PATH=$(OUTPUT)
165 endif
166 else
167   TE_PATH=$(TRACE_EVENT_DIR)
168   LIB_PATH=$(LIB_DIR)
169 endif
171 LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
172 export LIBTRACEEVENT
174 LIBAPI = $(LIB_PATH)libapi.a
175 export LIBAPI
177 # python extension build directories
178 PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
179 PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
180 PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
181 export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
183 python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf.so
185 PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
186 PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
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/
194 # No Perl scripts right now:
197 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
199 PROGRAMS += $(OUTPUT)perf
201 ifndef NO_PERF_READ_VDSO32
202 PROGRAMS += $(OUTPUT)perf-read-vdso32
203 endif
205 ifndef NO_PERF_READ_VDSOX32
206 PROGRAMS += $(OUTPUT)perf-read-vdsox32
207 endif
209 # what 'all' will build and 'install' will install, in perfexecdir
210 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
212 # what 'all' will build but not install in perfexecdir
213 OTHER_PROGRAMS = $(OUTPUT)perf
215 # Set paths to tools early so that they can be used for version tests.
216 ifndef SHELL_PATH
217   SHELL_PATH = /bin/sh
218 endif
219 ifndef PERL_PATH
220   PERL_PATH = /usr/bin/perl
221 endif
223 export PERL_PATH
225 LIB_FILE=$(OUTPUT)libperf.a
227 PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT)
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...
233 -include arch/$(ARCH)/Makefile
235 ifneq ($(OUTPUT),)
236   CFLAGS += -I$(OUTPUT)
237 endif
239 ifndef NO_GTK2
240   ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
241   GTK_IN := $(OUTPUT)gtk-in.o
243 install-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)'
247 endif
249 ifdef ASCIIDOC8
250   export ASCIIDOC8
251 endif
253 LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
255 export INSTALL SHELL_PATH
257 ### Build rules
259 SHELL = $(SHELL_PATH)
261 all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
263 please_set_SHELL_PATH_to_a_more_modern_shell:
264         $(Q)$$(:)
266 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
268 strip: $(PROGRAMS) $(OUTPUT)perf
269         $(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
271 PERF_IN := $(OUTPUT)perf-in.o
273 export srctree OUTPUT RM CC LD AR CFLAGS V BISON FLEX
274 build := -f $(srctree)/tools/build/Makefile.build dir=. obj
276 $(PERF_IN): $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h FORCE
277         $(Q)$(MAKE) $(build)=perf
279 $(OUTPUT)perf: $(PERFLIBS) $(PERF_IN)
280         $(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(PERF_IN) $(LIBS) -o $@
282 $(GTK_IN): FORCE
283         $(Q)$(MAKE) $(build)=gtk
285 $(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
286         $(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
288 $(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
290 $(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
291         $(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
293 $(SCRIPTS) : % : %.sh
294         $(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
296 # These can record PERF_VERSION
297 perf.spec $(SCRIPTS) \
298         : $(OUTPUT)PERF-VERSION-FILE
300 .SUFFIXES:
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.
306 ifneq ($(OUTPUT),)
307 %.o: $(OUTPUT)%.o
308         @echo "    # Redirected target $@ => $(OUTPUT)$@"
309 util/%.o: $(OUTPUT)util/%.o
310         @echo "    # Redirected target $@ => $(OUTPUT)$@"
311 bench/%.o: $(OUTPUT)bench/%.o
312         @echo "    # Redirected target $@ => $(OUTPUT)$@"
313 tests/%.o: $(OUTPUT)tests/%.o
314         @echo "    # Redirected target $@ => $(OUTPUT)$@"
315 endif
317 # These two need to be here so that when O= is not used they take precedence
318 # over the general rule for .o
320 # get relative building directory (to $(OUTPUT))
321 # and '.' if it's $(OUTPUT) itself
322 __build-dir = $(subst $(OUTPUT),,$(dir $@))
323 build-dir   = $(if $(__build-dir),$(__build-dir),.)
325 single_dep: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h
327 $(OUTPUT)%.o: %.c single_dep FORCE
328         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
330 $(OUTPUT)%.i: %.c single_dep FORCE
331         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
333 $(OUTPUT)%.s: %.c single_dep FORCE
334         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
336 $(OUTPUT)%-bison.o: %.c single_dep FORCE
337         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
339 $(OUTPUT)%-flex.o: %.c single_dep FORCE
340         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
342 $(OUTPUT)%.o: %.S single_dep FORCE
343         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
345 $(OUTPUT)%.i: %.S single_dep FORCE
346         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
348 $(OUTPUT)perf-%: %.o $(PERFLIBS)
349         $(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
351 ifndef 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
354 endif
356 ifndef 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
359 endif
361 $(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
363 LIBPERF_IN := $(OUTPUT)libperf-in.o
365 $(LIBPERF_IN): FORCE
366         $(Q)$(MAKE) $(build)=libperf
368 $(LIB_FILE): $(LIBPERF_IN)
369         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
371 LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ)
373 $(LIBTRACEEVENT): FORCE
374         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a plugins
376 $(LIBTRACEEVENT)-clean:
377         $(call QUIET_CLEAN, libtraceevent)
378         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
380 install-traceevent-plugins: $(LIBTRACEEVENT)
381         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
383 $(LIBAPI): FORCE
384         $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
386 $(LIBAPI)-clean:
387         $(call QUIET_CLEAN, libapi)
388         $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
390 help:
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'
420 DOC_TARGETS := doc man html info pdf
422 INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
423 INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
425 # 'make doc' should call 'make -C Documentation all'
426 $(DOC_TARGETS):
427         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
429 TAG_FOLDERS= . ../lib/traceevent ../lib/api ../lib/symbol
430 TAG_FILES= ../../include/uapi/linux/perf_event.h
432 TAGS:
433         $(QUIET_GEN)$(RM) TAGS; \
434         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs etags -a $(TAG_FILES)
436 tags:
437         $(QUIET_GEN)$(RM) tags; \
438         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs ctags -a $(TAG_FILES)
440 cscope:
441         $(QUIET_GEN)$(RM) cscope*; \
442         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs cscope -b $(TAG_FILES)
444 ### Testing rules
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.
450 check: $(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
461 ### Installation rules
463 install-gtk:
465 install-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'
470 ifndef NO_PERF_READ_VDSO32
471         $(call QUIET_INSTALL, perf-read-vdso32) \
472                 $(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
473 endif
474 ifndef NO_PERF_READ_VDSOX32
475         $(call QUIET_INSTALL, perf-read-vdsox32) \
476                 $(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
477 endif
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)'
484 ifndef 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'
491 endif
492 ifndef 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'
499 endif
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'
509 install: install-bin try-install-man install-traceevent-plugins
511 install-python_ext:
512         $(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
514 # 'make install-doc' should call 'make -C Documentation install'
515 $(INSTALL_DOC_TARGETS):
516         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
518 ### Cleaning rules
521 # This is here, not in config/Makefile, because config/Makefile does
522 # not get included for the clean target:
524 config-clean:
525         $(call QUIET_CLEAN, config)
526         $(Q)$(MAKE) -C $(srctree)/tools/build/feature/ clean >/dev/null
528 clean: $(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)
538 # Trick: if ../../.git does not exist - we are building out of tree for example,
539 # then force version regeneration:
541 ifeq ($(wildcard ../../.git/HEAD),)
542     GIT-HEAD-PHONY = ../../.git/HEAD
543 else
544     GIT-HEAD-PHONY =
545 endif
547 FORCE:
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