OSDN Git Service

clk: at91: fix masterck name
[uclinux-h8/linux.git] / tools / perf / Makefile.perf
1 include ../scripts/Makefile.include
2 include ../scripts/Makefile.arch
3
4 # The default target of this Makefile is...
5 all:
6
7 include ../scripts/utilities.mak
8
9 # Define V to have a more verbose compile.
10 #
11 # Define VF to have a more verbose feature check output.
12 #
13 # Define O to save output files in a separate directory.
14 #
15 # Define ARCH as name of target architecture if you want cross-builds.
16 #
17 # Define CROSS_COMPILE as prefix name of compiler if you want cross-builds.
18 #
19 # Define NO_LIBPERL to disable perl script extension.
20 #
21 # Define NO_LIBPYTHON to disable python script extension.
22 #
23 # Define PYTHON to point to the python binary if the default
24 # `python' is not correct; for example: PYTHON=python2
25 #
26 # Define PYTHON_CONFIG to point to the python-config binary if
27 # the default `$(PYTHON)-config' is not correct.
28 #
29 # Define ASCIIDOC8 if you want to format documentation with AsciiDoc 8
30 #
31 # Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72.
32 #
33 # Define LDFLAGS=-static to build a static binary.
34 #
35 # Define EXTRA_CFLAGS=-m64 or EXTRA_CFLAGS=-m32 as appropriate for cross-builds.
36 #
37 # Define EXCLUDE_EXTLIBS=-lmylib to exclude libmylib from the auto-generated
38 # EXTLIBS.
39 #
40 # Define EXTRA_PERFLIBS to pass extra libraries to PERFLIBS.
41 #
42 # Define NO_DWARF if you do not want debug-info analysis feature at all.
43 #
44 # Define WERROR=0 to disable treating any warnings as errors.
45 #
46 # Define NO_NEWT if you do not want TUI support. (deprecated)
47 #
48 # Define NO_SLANG if you do not want TUI support.
49 #
50 # Define NO_GTK2 if you do not want GTK+ GUI support.
51 #
52 # Define NO_DEMANGLE if you do not want C++ symbol demangling.
53 #
54 # Define NO_LIBELF if you do not want libelf dependency (e.g. cross-builds)
55 #
56 # Define NO_LIBUNWIND if you do not want libunwind dependency for dwarf
57 # backtrace post unwind.
58 #
59 # Define NO_BACKTRACE if you do not want stack backtrace debug feature
60 #
61 # Define NO_LIBNUMA if you do not want numa perf benchmark
62 #
63 # Define NO_LIBAUDIT if you do not want libaudit support
64 #
65 # Define NO_LIBBIONIC if you do not want bionic support
66 #
67 # Define NO_LIBCRYPTO if you do not want libcrypto (openssl) support
68 # used for generating build-ids for ELFs generated by jitdump.
69 #
70 # Define NO_LIBDW_DWARF_UNWIND if you do not want libdw support
71 # for dwarf backtrace post unwind.
72 #
73 # Define NO_PERF_READ_VDSO32 if you do not want to build perf-read-vdso32
74 # for reading the 32-bit compatibility VDSO in 64-bit mode
75 #
76 # Define NO_PERF_READ_VDSOX32 if you do not want to build perf-read-vdsox32
77 # for reading the x32 mode 32-bit compatibility VDSO in 64-bit mode
78 #
79 # Define NO_ZLIB if you do not want to support compressed kernel modules
80 #
81 # Define NO_LIBBABELTRACE if you do not want libbabeltrace support
82 # for CTF data format.
83 #
84 # Define NO_LZMA if you do not want to support compressed (xz) kernel modules
85 #
86 # Define NO_AUXTRACE if you do not want AUX area tracing support
87 #
88 # Define NO_LIBBPF if you do not want BPF support
89 #
90 # Define NO_SDT if you do not want to define SDT event in perf tools,
91 # note that it doesn't disable SDT scanning support.
92 #
93 # Define FEATURES_DUMP to provide features detection dump file
94 # and bypass the feature detection
95 #
96 # Define NO_JVMTI if you do not want jvmti agent built
97 #
98 # Define NO_JVMTI_CMLR (debug only) if you do not want to process CMLR
99 # data for java source lines.
100 #
101 # Define LIBCLANGLLVM if you DO want builtin clang and llvm support.
102 # When selected, pass LLVM_CONFIG=/path/to/llvm-config to `make' if
103 # llvm-config is not in $PATH.
104 #
105 # Define NO_CORESIGHT if you do not want support for CoreSight trace decoding.
106 #
107 # Define NO_AIO if you do not want support of Posix AIO based trace
108 # streaming for record mode. Currently Posix AIO trace streaming is
109 # supported only when linking with glibc.
110 #
111
112 # As per kernel Makefile, avoid funny character set dependencies
113 unexport LC_ALL
114 LC_COLLATE=C
115 LC_NUMERIC=C
116 export LC_COLLATE LC_NUMERIC
117
118 ifeq ($(srctree),)
119 srctree := $(patsubst %/,%,$(dir $(CURDIR)))
120 srctree := $(patsubst %/,%,$(dir $(srctree)))
121 #$(info Determined 'srctree' to be $(srctree))
122 endif
123
124 ifneq ($(objtree),)
125 #$(info Determined 'objtree' to be $(objtree))
126 endif
127
128 ifneq ($(OUTPUT),)
129 #$(info Determined 'OUTPUT' to be $(OUTPUT))
130 # Adding $(OUTPUT) as a directory to look for source files,
131 # because use generated output files as sources dependency
132 # for flex/bison parsers.
133 VPATH += $(OUTPUT)
134 export VPATH
135 endif
136
137 ifeq ($(V),1)
138   Q =
139 else
140   Q = @
141 endif
142
143 # Do not use make's built-in rules
144 # (this improves performance and avoids hard-to-debug behaviour);
145 MAKEFLAGS += -r
146
147 # Makefiles suck: This macro sets a default value of $(2) for the
148 # variable named by $(1), unless the variable has been set by
149 # environment or command line. This is necessary for CC and AR
150 # because make sets default values, so the simpler ?= approach
151 # won't work as expected.
152 define allow-override
153   $(if $(or $(findstring environment,$(origin $(1))),\
154             $(findstring command line,$(origin $(1)))),,\
155     $(eval $(1) = $(2)))
156 endef
157
158 LD += $(EXTRA_LDFLAGS)
159
160 HOSTCC  ?= gcc
161 HOSTLD  ?= ld
162 HOSTAR  ?= ar
163
164 PKG_CONFIG = $(CROSS_COMPILE)pkg-config
165 LLVM_CONFIG ?= llvm-config
166
167 RM      = rm -f
168 LN      = ln -f
169 MKDIR   = mkdir
170 FIND    = find
171 INSTALL = install
172 FLEX    ?= flex
173 BISON   ?= bison
174 STRIP   = strip
175 AWK     = awk
176
177 # include Makefile.config by default and rule out
178 # non-config cases
179 config := 1
180
181 NON_CONFIG_TARGETS := clean python-clean TAGS tags cscope help install-doc install-man install-html install-info install-pdf doc man html info pdf
182
183 ifdef MAKECMDGOALS
184 ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
185   config := 0
186 endif
187 endif
188
189 # The fixdep build - we force fixdep tool to be built as
190 # the first target in the separate make session not to be
191 # disturbed by any parallel make jobs. Once fixdep is done
192 # we issue the requested build with FIXDEP=1 variable.
193 #
194 # The fixdep build is disabled for $(NON_CONFIG_TARGETS)
195 # targets, because it's not necessary.
196
197 ifdef FIXDEP
198   force_fixdep := 0
199 else
200   force_fixdep := $(config)
201 endif
202
203 export srctree OUTPUT RM CC CXX LD AR CFLAGS CXXFLAGS V BISON FLEX AWK
204 export HOSTCC HOSTLD HOSTAR
205
206 include $(srctree)/tools/build/Makefile.include
207
208 ifeq ($(force_fixdep),1)
209 goals := $(filter-out all sub-make, $(MAKECMDGOALS))
210
211 $(goals) all: sub-make
212
213 sub-make: fixdep
214         @./check-headers.sh
215         $(Q)$(MAKE) FIXDEP=1 -f Makefile.perf $(goals)
216
217 else # force_fixdep
218
219 LIB_DIR         = $(srctree)/tools/lib/api/
220 TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
221 BPF_DIR         = $(srctree)/tools/lib/bpf/
222 SUBCMD_DIR      = $(srctree)/tools/lib/subcmd/
223
224 # Set FEATURE_TESTS to 'all' so all possible feature checkers are executed.
225 # Without this setting the output feature dump file misses some features, for
226 # example, liberty. Select all checkers so we won't get an incomplete feature
227 # dump file.
228 ifeq ($(config),1)
229 ifdef MAKECMDGOALS
230 ifeq ($(filter feature-dump,$(MAKECMDGOALS)),feature-dump)
231 FEATURE_TESTS := all
232 endif
233 endif
234 include Makefile.config
235 endif
236
237 ifeq ($(config),0)
238 include $(srctree)/tools/scripts/Makefile.arch
239 -include arch/$(SRCARCH)/Makefile
240 endif
241
242 # The FEATURE_DUMP_EXPORT holds location of the actual
243 # FEATURE_DUMP file to be used to bypass feature detection
244 # (for bpf or any other subproject)
245 ifeq ($(FEATURES_DUMP),)
246 FEATURE_DUMP_EXPORT := $(realpath $(OUTPUT)FEATURE-DUMP)
247 else
248 FEATURE_DUMP_EXPORT := $(realpath $(FEATURES_DUMP))
249 endif
250
251 export prefix bindir sharedir sysconfdir DESTDIR
252
253 # sparse is architecture-neutral, which means that we need to tell it
254 # explicitly what architecture to check for. Fix this up for yours..
255 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
256
257 # Guard against environment variables
258 PYRF_OBJS =
259 SCRIPT_SH =
260
261 SCRIPT_SH += perf-archive.sh
262 SCRIPT_SH += perf-with-kcore.sh
263
264 grep-libs = $(filter -l%,$(1))
265 strip-libs = $(filter-out -l%,$(1))
266
267 ifneq ($(OUTPUT),)
268   TE_PATH=$(OUTPUT)
269   BPF_PATH=$(OUTPUT)
270   SUBCMD_PATH=$(OUTPUT)
271 ifneq ($(subdir),)
272   API_PATH=$(OUTPUT)/../lib/api/
273 else
274   API_PATH=$(OUTPUT)
275 endif
276 else
277   TE_PATH=$(TRACE_EVENT_DIR)
278   API_PATH=$(LIB_DIR)
279   BPF_PATH=$(BPF_DIR)
280   SUBCMD_PATH=$(SUBCMD_DIR)
281 endif
282
283 LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
284 export LIBTRACEEVENT
285
286 LIBTRACEEVENT_DYNAMIC_LIST = $(TE_PATH)libtraceevent-dynamic-list
287
288 #
289 # The static build has no dynsym table, so this does not work for
290 # static build. Looks like linker starts to scream about that now
291 # (in Fedora 26) so we need to switch it off for static build.
292 DYNAMIC_LIST_LDFLAGS               = -Xlinker --dynamic-list=$(LIBTRACEEVENT_DYNAMIC_LIST)
293 LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS = $(if $(findstring -static,$(LDFLAGS)),,$(DYNAMIC_LIST_LDFLAGS))
294
295 LIBAPI = $(API_PATH)libapi.a
296 export LIBAPI
297
298 LIBBPF = $(BPF_PATH)libbpf.a
299
300 LIBSUBCMD = $(SUBCMD_PATH)libsubcmd.a
301
302 # python extension build directories
303 PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
304 PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
305 PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
306 export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
307
308 python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf*.so
309
310 PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
311 PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
312
313 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
314
315 PROGRAMS += $(OUTPUT)perf
316
317 ifndef NO_PERF_READ_VDSO32
318 PROGRAMS += $(OUTPUT)perf-read-vdso32
319 endif
320
321 ifndef NO_PERF_READ_VDSOX32
322 PROGRAMS += $(OUTPUT)perf-read-vdsox32
323 endif
324
325 LIBJVMTI = libperf-jvmti.so
326
327 ifndef NO_JVMTI
328 PROGRAMS += $(OUTPUT)$(LIBJVMTI)
329 endif
330
331 # what 'all' will build and 'install' will install, in perfexecdir
332 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
333
334 # what 'all' will build but not install in perfexecdir
335 OTHER_PROGRAMS = $(OUTPUT)perf
336
337 # Set paths to tools early so that they can be used for version tests.
338 ifndef SHELL_PATH
339   SHELL_PATH = /bin/sh
340 endif
341 ifndef PERL_PATH
342   PERL_PATH = /usr/bin/perl
343 endif
344
345 export PERL_PATH
346
347 LIB_FILE=$(OUTPUT)libperf.a
348
349 PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT) $(LIBSUBCMD)
350 ifndef NO_LIBBPF
351   PERFLIBS += $(LIBBPF)
352 endif
353
354 # We choose to avoid "if .. else if .. else .. endif endif"
355 # because maintaining the nesting to match is a pain.  If
356 # we had "elif" things would have been much nicer...
357
358 ifneq ($(OUTPUT),)
359   CFLAGS += -I$(OUTPUT)
360 endif
361
362 ifndef NO_GTK2
363   ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
364   GTK_IN := $(OUTPUT)gtk-in.o
365 endif
366
367 ifdef ASCIIDOC8
368   export ASCIIDOC8
369 endif
370
371 EXTLIBS := $(call filter-out,$(EXCLUDE_EXTLIBS),$(EXTLIBS))
372 LIBS = -Wl,--whole-archive $(PERFLIBS) $(EXTRA_PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
373
374 ifeq ($(USE_CLANG), 1)
375   CLANGLIBS_LIST = AST Basic CodeGen Driver Frontend Lex Tooling Edit Sema Analysis Parse Serialization
376   CLANGLIBS_NOEXT_LIST = $(foreach l,$(CLANGLIBS_LIST),$(shell $(LLVM_CONFIG) --libdir)/libclang$(l))
377   LIBCLANG = $(foreach l,$(CLANGLIBS_NOEXT_LIST),$(wildcard $(l).a $(l).so))
378   LIBS += -Wl,--start-group $(LIBCLANG) -Wl,--end-group
379 endif
380
381 ifeq ($(USE_LLVM), 1)
382   LIBLLVM = $(shell $(LLVM_CONFIG) --libs all) $(shell $(LLVM_CONFIG) --system-libs)
383   LIBS += -L$(shell $(LLVM_CONFIG) --libdir) $(LIBLLVM)
384 endif
385
386 ifeq ($(USE_CXX), 1)
387   LIBS += -lstdc++
388 endif
389
390 export INSTALL SHELL_PATH
391
392 ### Build rules
393
394 SHELL = $(SHELL_PATH)
395
396 linux_uapi_dir := $(srctree)/tools/include/uapi/linux
397 asm_generic_uapi_dir := $(srctree)/tools/include/uapi/asm-generic
398 arch_asm_uapi_dir := $(srctree)/tools/arch/$(SRCARCH)/include/uapi/asm/
399 x86_arch_asm_uapi_dir := $(srctree)/tools/arch/x86/include/uapi/asm/
400
401 beauty_outdir := $(OUTPUT)trace/beauty/generated
402 beauty_ioctl_outdir := $(beauty_outdir)/ioctl
403 drm_ioctl_array := $(beauty_ioctl_outdir)/drm_ioctl_array.c
404 drm_hdr_dir := $(srctree)/tools/include/uapi/drm
405 drm_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/drm_ioctl.sh
406
407 # Create output directory if not already present
408 _dummy := $(shell [ -d '$(beauty_ioctl_outdir)' ] || mkdir -p '$(beauty_ioctl_outdir)')
409
410 $(drm_ioctl_array): $(drm_hdr_dir)/drm.h $(drm_hdr_dir)/i915_drm.h $(drm_ioctl_tbl)
411         $(Q)$(SHELL) '$(drm_ioctl_tbl)' $(drm_hdr_dir) > $@
412
413 fadvise_advice_array := $(beauty_outdir)/fadvise_advice_array.c
414 fadvise_advice_tbl := $(srctree)/tools/perf/trace/beauty/fadvise.sh
415
416 $(fadvise_advice_array): $(linux_uapi_dir)/in.h $(fadvise_advice_tbl)
417         $(Q)$(SHELL) '$(fadvise_advice_tbl)' $(linux_uapi_dir) > $@
418
419 pkey_alloc_access_rights_array := $(beauty_outdir)/pkey_alloc_access_rights_array.c
420 asm_generic_hdr_dir := $(srctree)/tools/include/uapi/asm-generic/
421 pkey_alloc_access_rights_tbl := $(srctree)/tools/perf/trace/beauty/pkey_alloc_access_rights.sh
422
423 $(pkey_alloc_access_rights_array): $(asm_generic_hdr_dir)/mman-common.h $(pkey_alloc_access_rights_tbl)
424         $(Q)$(SHELL) '$(pkey_alloc_access_rights_tbl)' $(asm_generic_hdr_dir) > $@
425
426 sndrv_ctl_ioctl_array := $(beauty_ioctl_outdir)/sndrv_ctl_ioctl_array.c
427 sndrv_ctl_hdr_dir := $(srctree)/tools/include/uapi/sound
428 sndrv_ctl_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/sndrv_ctl_ioctl.sh
429
430 $(sndrv_ctl_ioctl_array): $(sndrv_ctl_hdr_dir)/asound.h $(sndrv_ctl_ioctl_tbl)
431         $(Q)$(SHELL) '$(sndrv_ctl_ioctl_tbl)' $(sndrv_ctl_hdr_dir) > $@
432
433 sndrv_pcm_ioctl_array := $(beauty_ioctl_outdir)/sndrv_pcm_ioctl_array.c
434 sndrv_pcm_hdr_dir := $(srctree)/tools/include/uapi/sound
435 sndrv_pcm_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/sndrv_pcm_ioctl.sh
436
437 $(sndrv_pcm_ioctl_array): $(sndrv_pcm_hdr_dir)/asound.h $(sndrv_pcm_ioctl_tbl)
438         $(Q)$(SHELL) '$(sndrv_pcm_ioctl_tbl)' $(sndrv_pcm_hdr_dir) > $@
439
440 kcmp_type_array := $(beauty_outdir)/kcmp_type_array.c
441 kcmp_hdr_dir := $(srctree)/tools/include/uapi/linux/
442 kcmp_type_tbl := $(srctree)/tools/perf/trace/beauty/kcmp_type.sh
443
444 $(kcmp_type_array): $(kcmp_hdr_dir)/kcmp.h $(kcmp_type_tbl)
445         $(Q)$(SHELL) '$(kcmp_type_tbl)' $(kcmp_hdr_dir) > $@
446
447 kvm_ioctl_array := $(beauty_ioctl_outdir)/kvm_ioctl_array.c
448 kvm_hdr_dir := $(srctree)/tools/include/uapi/linux
449 kvm_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/kvm_ioctl.sh
450
451 $(kvm_ioctl_array): $(kvm_hdr_dir)/kvm.h $(kvm_ioctl_tbl)
452         $(Q)$(SHELL) '$(kvm_ioctl_tbl)' $(kvm_hdr_dir) > $@
453
454 socket_ipproto_array := $(beauty_outdir)/socket_ipproto_array.c
455 socket_ipproto_tbl := $(srctree)/tools/perf/trace/beauty/socket_ipproto.sh
456
457 $(socket_ipproto_array): $(linux_uapi_dir)/in.h $(socket_ipproto_tbl)
458         $(Q)$(SHELL) '$(socket_ipproto_tbl)' $(linux_uapi_dir) > $@
459
460 vhost_virtio_ioctl_array := $(beauty_ioctl_outdir)/vhost_virtio_ioctl_array.c
461 vhost_virtio_hdr_dir := $(srctree)/tools/include/uapi/linux
462 vhost_virtio_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/vhost_virtio_ioctl.sh
463
464 $(vhost_virtio_ioctl_array): $(vhost_virtio_hdr_dir)/vhost.h $(vhost_virtio_ioctl_tbl)
465         $(Q)$(SHELL) '$(vhost_virtio_ioctl_tbl)' $(vhost_virtio_hdr_dir) > $@
466
467 perf_ioctl_array := $(beauty_ioctl_outdir)/perf_ioctl_array.c
468 perf_hdr_dir := $(srctree)/tools/include/uapi/linux
469 perf_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/perf_ioctl.sh
470
471 $(perf_ioctl_array): $(perf_hdr_dir)/perf_event.h $(perf_ioctl_tbl)
472         $(Q)$(SHELL) '$(perf_ioctl_tbl)' $(perf_hdr_dir) > $@
473
474 madvise_behavior_array := $(beauty_outdir)/madvise_behavior_array.c
475 madvise_hdr_dir := $(srctree)/tools/include/uapi/asm-generic/
476 madvise_behavior_tbl := $(srctree)/tools/perf/trace/beauty/madvise_behavior.sh
477
478 $(madvise_behavior_array): $(madvise_hdr_dir)/mman-common.h $(madvise_behavior_tbl)
479         $(Q)$(SHELL) '$(madvise_behavior_tbl)' $(madvise_hdr_dir) > $@
480
481 mmap_flags_array := $(beauty_outdir)/mmap_flags_array.c
482 mmap_flags_tbl := $(srctree)/tools/perf/trace/beauty/mmap_flags.sh
483
484 $(mmap_flags_array): $(asm_generic_uapi_dir)/mman.h $(asm_generic_uapi_dir)/mman-common.h $(mmap_flags_tbl)
485         $(Q)$(SHELL) '$(mmap_flags_tbl)' $(asm_generic_uapi_dir) $(arch_asm_uapi_dir) > $@
486
487 mount_flags_array := $(beauty_outdir)/mount_flags_array.c
488 mount_flags_tbl := $(srctree)/tools/perf/trace/beauty/mount_flags.sh
489
490 $(mount_flags_array): $(linux_uapi_dir)/fs.h $(mount_flags_tbl)
491         $(Q)$(SHELL) '$(mount_flags_tbl)' $(linux_uapi_dir) > $@
492
493 prctl_option_array := $(beauty_outdir)/prctl_option_array.c
494 prctl_hdr_dir := $(srctree)/tools/include/uapi/linux/
495 prctl_option_tbl := $(srctree)/tools/perf/trace/beauty/prctl_option.sh
496
497 $(prctl_option_array): $(prctl_hdr_dir)/prctl.h $(prctl_option_tbl)
498         $(Q)$(SHELL) '$(prctl_option_tbl)' $(prctl_hdr_dir) > $@
499
500 usbdevfs_ioctl_array := $(beauty_ioctl_outdir)/usbdevfs_ioctl_array.c
501 usbdevfs_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/usbdevfs_ioctl.sh
502
503 $(usbdevfs_ioctl_array): $(linux_uapi_dir)/usbdevice_fs.h $(usbdevfs_ioctl_tbl)
504         $(Q)$(SHELL) '$(usbdevfs_ioctl_tbl)' $(linux_uapi_dir) > $@
505
506 x86_arch_prctl_code_array := $(beauty_outdir)/x86_arch_prctl_code_array.c
507 x86_arch_prctl_code_tbl := $(srctree)/tools/perf/trace/beauty/x86_arch_prctl.sh
508
509 $(x86_arch_prctl_code_array): $(x86_arch_asm_uapi_dir)/prctl.h $(x86_arch_prctl_code_tbl)
510         $(Q)$(SHELL) '$(x86_arch_prctl_code_tbl)' $(x86_arch_asm_uapi_dir) > $@
511
512 rename_flags_array := $(beauty_outdir)/rename_flags_array.c
513 rename_flags_tbl := $(srctree)/tools/perf/trace/beauty/rename_flags.sh
514
515 $(rename_flags_array): $(linux_uapi_dir)/fs.h $(rename_flags_tbl)
516         $(Q)$(SHELL) '$(rename_flags_tbl)' $(linux_uapi_dir) > $@
517
518 arch_errno_name_array := $(beauty_outdir)/arch_errno_name_array.c
519 arch_errno_hdr_dir := $(srctree)/tools
520 arch_errno_tbl := $(srctree)/tools/perf/trace/beauty/arch_errno_names.sh
521
522 $(arch_errno_name_array): $(arch_errno_tbl)
523         $(Q)$(SHELL) '$(arch_errno_tbl)' $(CC) $(arch_errno_hdr_dir) > $@
524
525 all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
526
527 $(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS) $(LIBTRACEEVENT_DYNAMIC_LIST)
528         $(QUIET_GEN)LDSHARED="$(CC) -pthread -shared" \
529         CFLAGS='$(CFLAGS)' LDFLAGS='$(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS)' \
530           $(PYTHON_WORD) util/setup.py \
531           --quiet build_ext; \
532         mkdir -p $(OUTPUT)python && \
533         cp $(PYTHON_EXTBUILD_LIB)perf*.so $(OUTPUT)python/
534
535 please_set_SHELL_PATH_to_a_more_modern_shell:
536         $(Q)$$(:)
537
538 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
539
540 strip: $(PROGRAMS) $(OUTPUT)perf
541         $(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
542
543 PERF_IN := $(OUTPUT)perf-in.o
544
545 JEVENTS       := $(OUTPUT)pmu-events/jevents
546 JEVENTS_IN    := $(OUTPUT)pmu-events/jevents-in.o
547
548 PMU_EVENTS_IN := $(OUTPUT)pmu-events/pmu-events-in.o
549
550 export JEVENTS
551
552 build := -f $(srctree)/tools/build/Makefile.build dir=. obj
553
554 $(PERF_IN): prepare FORCE
555         $(Q)$(MAKE) $(build)=perf
556
557 $(JEVENTS_IN): FORCE
558         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=jevents
559
560 $(JEVENTS): $(JEVENTS_IN)
561         $(QUIET_LINK)$(HOSTCC) $(JEVENTS_IN) -o $@
562
563 $(PMU_EVENTS_IN): $(JEVENTS) FORCE
564         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=pmu-events
565
566 $(OUTPUT)perf: $(PERFLIBS) $(PERF_IN) $(PMU_EVENTS_IN) $(LIBTRACEEVENT_DYNAMIC_LIST)
567         $(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS) \
568                 $(PERF_IN) $(PMU_EVENTS_IN) $(LIBS) -o $@
569
570 $(GTK_IN): FORCE
571         $(Q)$(MAKE) $(build)=gtk
572
573 $(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
574         $(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
575
576 $(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
577
578 $(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
579         $(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
580
581 $(SCRIPTS) : % : %.sh
582         $(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
583
584 $(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
585         $(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
586         $(Q)touch $(OUTPUT)PERF-VERSION-FILE
587
588 # These can record PERF_VERSION
589 perf.spec $(SCRIPTS) \
590         : $(OUTPUT)PERF-VERSION-FILE
591
592 .SUFFIXES:
593
594 #
595 # If a target does not match any of the later rules then prefix it by $(OUTPUT)
596 # This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
597 #
598 ifneq ($(OUTPUT),)
599 %.o: $(OUTPUT)%.o
600         @echo "    # Redirected target $@ => $(OUTPUT)$@"
601 pmu-events/%.o: $(OUTPUT)pmu-events/%.o
602         @echo "    # Redirected target $@ => $(OUTPUT)$@"
603 util/%.o: $(OUTPUT)util/%.o
604         @echo "    # Redirected target $@ => $(OUTPUT)$@"
605 bench/%.o: $(OUTPUT)bench/%.o
606         @echo "    # Redirected target $@ => $(OUTPUT)$@"
607 tests/%.o: $(OUTPUT)tests/%.o
608         @echo "    # Redirected target $@ => $(OUTPUT)$@"
609 endif
610
611 # These two need to be here so that when O= is not used they take precedence
612 # over the general rule for .o
613
614 # get relative building directory (to $(OUTPUT))
615 # and '.' if it's $(OUTPUT) itself
616 __build-dir = $(subst $(OUTPUT),,$(dir $@))
617 build-dir   = $(if $(__build-dir),$(__build-dir),.)
618
619 prepare: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h archheaders $(drm_ioctl_array) \
620         $(fadvise_advice_array) \
621         $(pkey_alloc_access_rights_array) \
622         $(sndrv_pcm_ioctl_array) \
623         $(sndrv_ctl_ioctl_array) \
624         $(kcmp_type_array) \
625         $(kvm_ioctl_array) \
626         $(socket_ipproto_array) \
627         $(vhost_virtio_ioctl_array) \
628         $(madvise_behavior_array) \
629         $(mmap_flags_array) \
630         $(mount_flags_array) \
631         $(perf_ioctl_array) \
632         $(prctl_option_array) \
633         $(usbdevfs_ioctl_array) \
634         $(x86_arch_prctl_code_array) \
635         $(rename_flags_array) \
636         $(arch_errno_name_array)
637
638 $(OUTPUT)%.o: %.c prepare FORCE
639         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
640
641 $(OUTPUT)%.i: %.c prepare FORCE
642         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
643
644 $(OUTPUT)%.s: %.c prepare FORCE
645         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
646
647 $(OUTPUT)%-bison.o: %.c prepare FORCE
648         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
649
650 $(OUTPUT)%-flex.o: %.c prepare FORCE
651         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
652
653 $(OUTPUT)%.o: %.S prepare FORCE
654         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
655
656 $(OUTPUT)%.i: %.S prepare FORCE
657         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
658
659 $(OUTPUT)perf-%: %.o $(PERFLIBS)
660         $(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
661
662 ifndef NO_PERF_READ_VDSO32
663 $(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
664         $(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
665 endif
666
667 ifndef NO_PERF_READ_VDSOX32
668 $(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
669         $(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
670 endif
671
672 ifndef NO_JVMTI
673 LIBJVMTI_IN := $(OUTPUT)jvmti/jvmti-in.o
674
675 $(LIBJVMTI_IN): FORCE
676         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=jvmti obj=jvmti
677
678 $(OUTPUT)$(LIBJVMTI): $(LIBJVMTI_IN)
679         $(QUIET_LINK)$(CC) $(LDFLAGS) -shared -Wl,-soname -Wl,$(LIBJVMTI) -o $@ $<
680 endif
681
682 $(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
683
684 LIBPERF_IN := $(OUTPUT)libperf-in.o
685
686 $(LIBPERF_IN): prepare FORCE
687         $(Q)$(MAKE) $(build)=libperf
688
689 $(LIB_FILE): $(LIBPERF_IN)
690         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
691
692 LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ) 'EXTRA_CFLAGS=$(EXTRA_CFLAGS)' 'LDFLAGS=$(LDFLAGS)'
693
694 $(LIBTRACEEVENT): FORCE
695         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a
696
697 libtraceevent_plugins: FORCE
698         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) plugins
699
700 $(LIBTRACEEVENT_DYNAMIC_LIST): libtraceevent_plugins
701         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent-dynamic-list
702
703 $(LIBTRACEEVENT)-clean:
704         $(call QUIET_CLEAN, libtraceevent)
705         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
706
707 install-traceevent-plugins: libtraceevent_plugins
708         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
709
710 $(LIBAPI): FORCE
711         $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
712
713 $(LIBAPI)-clean:
714         $(call QUIET_CLEAN, libapi)
715         $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
716
717 $(LIBBPF): FORCE
718         $(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) $(OUTPUT)libbpf.a FEATURES_DUMP=$(FEATURE_DUMP_EXPORT)
719
720 $(LIBBPF)-clean:
721         $(call QUIET_CLEAN, libbpf)
722         $(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) clean >/dev/null
723
724 $(LIBSUBCMD): FORCE
725         $(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) $(OUTPUT)libsubcmd.a
726
727 $(LIBSUBCMD)-clean:
728         $(call QUIET_CLEAN, libsubcmd)
729         $(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) clean
730
731 help:
732         @echo 'Perf make targets:'
733         @echo '  doc            - make *all* documentation (see below)'
734         @echo '  man            - make manpage documentation (access with man <foo>)'
735         @echo '  html           - make html documentation'
736         @echo '  info           - make GNU info documentation (access with info <foo>)'
737         @echo '  pdf            - make pdf documentation'
738         @echo '  TAGS           - use etags to make tag information for source browsing'
739         @echo '  tags           - use ctags to make tag information for source browsing'
740         @echo '  cscope - use cscope to make interactive browsing database'
741         @echo ''
742         @echo 'Perf install targets:'
743         @echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
744         @echo '  HINT: use "prefix" or "DESTDIR" to install to a particular'
745         @echo '        path like "make prefix=/usr/local install install-doc"'
746         @echo '  install        - install compiled binaries'
747         @echo '  install-doc    - install *all* documentation'
748         @echo '  install-man    - install manpage documentation'
749         @echo '  install-html   - install html documentation'
750         @echo '  install-info   - install GNU info documentation'
751         @echo '  install-pdf    - install pdf documentation'
752         @echo ''
753         @echo '  quick-install-doc      - alias for quick-install-man'
754         @echo '  quick-install-man      - install the documentation quickly'
755         @echo '  quick-install-html     - install the html documentation quickly'
756         @echo ''
757         @echo 'Perf maintainer targets:'
758         @echo '  clean                  - clean all binary objects and build output'
759
760
761 DOC_TARGETS := doc man html info pdf
762
763 INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
764 INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
765
766 # 'make doc' should call 'make -C Documentation all'
767 $(DOC_TARGETS):
768         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
769
770 TAG_FOLDERS= . ../lib ../include
771 TAG_FILES= ../../include/uapi/linux/perf_event.h
772
773 TAGS:
774         $(QUIET_GEN)$(RM) TAGS; \
775         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs etags -a $(TAG_FILES)
776
777 tags:
778         $(QUIET_GEN)$(RM) tags; \
779         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs ctags -a $(TAG_FILES)
780
781 cscope:
782         $(QUIET_GEN)$(RM) cscope*; \
783         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs cscope -b $(TAG_FILES)
784
785 ### Testing rules
786
787 # GNU make supports exporting all variables by "export" without parameters.
788 # However, the environment gets quite big, and some programs have problems
789 # with that.
790
791 check: $(OUTPUT)common-cmds.h
792         if sparse; \
793         then \
794                 for i in *.c */*.c; \
795                 do \
796                         sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
797                 done; \
798         else \
799                 exit 1; \
800         fi
801
802 ### Installation rules
803
804 ifndef NO_GTK2
805 install-gtk: $(OUTPUT)libperf-gtk.so
806         $(call QUIET_INSTALL, 'GTK UI') \
807                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
808                 $(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
809 else
810 install-gtk:
811 endif
812
813 install-tools: all install-gtk
814         $(call QUIET_INSTALL, binaries) \
815                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
816                 $(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
817                 $(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
818 ifndef NO_PERF_READ_VDSO32
819         $(call QUIET_INSTALL, perf-read-vdso32) \
820                 $(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
821 endif
822 ifndef NO_PERF_READ_VDSOX32
823         $(call QUIET_INSTALL, perf-read-vdsox32) \
824                 $(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
825 endif
826 ifndef NO_JVMTI
827         $(call QUIET_INSTALL, $(LIBJVMTI)) \
828                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
829                 $(INSTALL) $(OUTPUT)$(LIBJVMTI) '$(DESTDIR_SQ)$(libdir_SQ)';
830 endif
831         $(call QUIET_INSTALL, libexec) \
832                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
833 ifndef NO_LIBBPF
834         $(call QUIET_INSTALL, bpf-headers) \
835                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf'; \
836                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf/linux'; \
837                 $(INSTALL) include/bpf/*.h -t '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf'; \
838                 $(INSTALL) include/bpf/linux/*.h -t '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf/linux'
839         $(call QUIET_INSTALL, bpf-examples) \
840                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_examples_instdir_SQ)/bpf'; \
841                 $(INSTALL) examples/bpf/*.c -t '$(DESTDIR_SQ)$(perf_examples_instdir_SQ)/bpf'
842 endif
843         $(call QUIET_INSTALL, perf-archive) \
844                 $(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
845         $(call QUIET_INSTALL, perf-with-kcore) \
846                 $(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
847 ifndef NO_LIBAUDIT
848         $(call QUIET_INSTALL, strace/groups) \
849                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'; \
850                 $(INSTALL) trace/strace/groups/* -t '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'
851 endif
852 ifndef NO_LIBPERL
853         $(call QUIET_INSTALL, perl-scripts) \
854                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
855                 $(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
856                 $(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
857                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
858                 $(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
859 endif
860 ifndef NO_LIBPYTHON
861         $(call QUIET_INSTALL, python-scripts) \
862                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
863                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
864                 $(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
865                 $(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
866                 $(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
867 endif
868         $(call QUIET_INSTALL, perf_completion-script) \
869                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
870                 $(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
871         $(call QUIET_INSTALL, perf-tip) \
872                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(tip_instdir_SQ)'; \
873                 $(INSTALL) Documentation/tips.txt -t '$(DESTDIR_SQ)$(tip_instdir_SQ)'
874
875 install-tests: all install-gtk
876         $(call QUIET_INSTALL, tests) \
877                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
878                 $(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
879                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
880                 $(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
881                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell'; \
882                 $(INSTALL) tests/shell/*.sh '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell'; \
883                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell/lib'; \
884                 $(INSTALL) tests/shell/lib/*.sh '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell/lib'
885
886 install-bin: install-tools install-tests install-traceevent-plugins
887
888 install: install-bin try-install-man
889
890 install-python_ext:
891         $(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
892
893 # 'make install-doc' should call 'make -C Documentation install'
894 $(INSTALL_DOC_TARGETS):
895         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
896
897 ### Cleaning rules
898
899 #
900 # This is here, not in Makefile.config, because Makefile.config does
901 # not get included for the clean target:
902 #
903 config-clean:
904         $(call QUIET_CLEAN, config)
905         $(Q)$(MAKE) -C $(srctree)/tools/build/feature/ $(if $(OUTPUT),OUTPUT=$(OUTPUT)feature/,) clean >/dev/null
906
907 python-clean:
908         $(python-clean)
909
910 clean:: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean $(LIBBPF)-clean $(LIBSUBCMD)-clean config-clean fixdep-clean python-clean
911         $(call QUIET_CLEAN, core-objs)  $(RM) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(LANG_BINDINGS)
912         $(Q)find $(if $(OUTPUT),$(OUTPUT),.) -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
913         $(Q)$(RM) $(OUTPUT).config-detected
914         $(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32 $(OUTPUT)pmu-events/jevents $(OUTPUT)$(LIBJVMTI).so
915         $(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* \
916                 $(OUTPUT)util/intel-pt-decoder/inat-tables.c \
917                 $(OUTPUT)tests/llvm-src-{base,kbuild,prologue,relocation}.c \
918                 $(OUTPUT)pmu-events/pmu-events.c \
919                 $(OUTPUT)$(fadvise_advice_array) \
920                 $(OUTPUT)$(madvise_behavior_array) \
921                 $(OUTPUT)$(mmap_flags_array) \
922                 $(OUTPUT)$(mount_flags_array) \
923                 $(OUTPUT)$(drm_ioctl_array) \
924                 $(OUTPUT)$(pkey_alloc_access_rights_array) \
925                 $(OUTPUT)$(sndrv_ctl_ioctl_array) \
926                 $(OUTPUT)$(sndrv_pcm_ioctl_array) \
927                 $(OUTPUT)$(kvm_ioctl_array) \
928                 $(OUTPUT)$(kcmp_type_array) \
929                 $(OUTPUT)$(socket_ipproto_array) \
930                 $(OUTPUT)$(vhost_virtio_ioctl_array) \
931                 $(OUTPUT)$(perf_ioctl_array) \
932                 $(OUTPUT)$(prctl_option_array) \
933                 $(OUTPUT)$(usbdevfs_ioctl_array) \
934                 $(OUTPUT)$(x86_arch_prctl_code_array) \
935                 $(OUTPUT)$(rename_flags_array) \
936                 $(OUTPUT)$(arch_errno_name_array)
937         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
938
939 #
940 # To provide FEATURE-DUMP into $(FEATURE_DUMP_COPY)
941 # file if defined, with no further action.
942 feature-dump:
943 ifdef FEATURE_DUMP_COPY
944         @cp $(OUTPUT)FEATURE-DUMP $(FEATURE_DUMP_COPY)
945         @echo "FEATURE-DUMP file copied into $(FEATURE_DUMP_COPY)"
946 else
947         @echo "FEATURE-DUMP file available in $(OUTPUT)FEATURE-DUMP"
948 endif
949
950 #
951 # Trick: if ../../.git does not exist - we are building out of tree for example,
952 # then force version regeneration:
953 #
954 ifeq ($(wildcard ../../.git/HEAD),)
955     GIT-HEAD-PHONY = ../../.git/HEAD
956 else
957     GIT-HEAD-PHONY =
958 endif
959
960 FORCE:
961
962 .PHONY: all install clean config-clean strip install-gtk
963 .PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
964 .PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE prepare
965 .PHONY: libtraceevent_plugins archheaders
966
967 endif # force_fixdep