xref: /linux/tools/perf/Makefile.perf (revision 61d007138a44dc69265cf948eadd1759edbd3875)
1include ../scripts/Makefile.include
2include ../scripts/Makefile.arch
3
4# The default target of this Makefile is...
5all:
6
7include ../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
113unexport LC_ALL
114LC_COLLATE=C
115LC_NUMERIC=C
116export LC_COLLATE LC_NUMERIC
117
118ifeq ($(srctree),)
119srctree := $(patsubst %/,%,$(dir $(CURDIR)))
120srctree := $(patsubst %/,%,$(dir $(srctree)))
121#$(info Determined 'srctree' to be $(srctree))
122endif
123
124ifneq ($(objtree),)
125#$(info Determined 'objtree' to be $(objtree))
126endif
127
128ifneq ($(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.
133VPATH += $(OUTPUT)
134export VPATH
135endif
136
137ifeq ($(V),1)
138  Q =
139else
140  Q = @
141endif
142
143# Do not use make's built-in rules
144# (this improves performance and avoids hard-to-debug behaviour);
145MAKEFLAGS += -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.
152define allow-override
153  $(if $(or $(findstring environment,$(origin $(1))),\
154            $(findstring command line,$(origin $(1)))),,\
155    $(eval $(1) = $(2)))
156endef
157
158LD += $(EXTRA_LDFLAGS)
159
160HOSTCC  ?= gcc
161HOSTLD  ?= ld
162HOSTAR  ?= ar
163
164PKG_CONFIG = $(CROSS_COMPILE)pkg-config
165LLVM_CONFIG ?= llvm-config
166
167RM      = rm -f
168LN      = ln -f
169MKDIR   = mkdir
170FIND    = find
171INSTALL = install
172FLEX    ?= flex
173BISON   ?= bison
174STRIP   = strip
175AWK     = awk
176
177# include Makefile.config by default and rule out
178# non-config cases
179config := 1
180
181NON_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
183ifdef MAKECMDGOALS
184ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
185  config := 0
186endif
187endif
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
197ifdef FIXDEP
198  force_fixdep := 0
199else
200  force_fixdep := $(config)
201endif
202
203export srctree OUTPUT RM CC CXX LD AR CFLAGS CXXFLAGS V BISON FLEX AWK
204export HOSTCC HOSTLD HOSTAR
205
206include $(srctree)/tools/build/Makefile.include
207
208ifeq ($(force_fixdep),1)
209goals := $(filter-out all sub-make, $(MAKECMDGOALS))
210
211$(goals) all: sub-make
212
213sub-make: fixdep
214	@./check-headers.sh
215	$(Q)$(MAKE) FIXDEP=1 -f Makefile.perf $(goals)
216
217else # force_fixdep
218
219LIB_DIR         = $(srctree)/tools/lib/api/
220TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
221BPF_DIR         = $(srctree)/tools/lib/bpf/
222SUBCMD_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.
228ifeq ($(config),1)
229ifdef MAKECMDGOALS
230ifeq ($(filter feature-dump,$(MAKECMDGOALS)),feature-dump)
231FEATURE_TESTS := all
232endif
233endif
234include Makefile.config
235endif
236
237ifeq ($(config),0)
238include $(srctree)/tools/scripts/Makefile.arch
239-include arch/$(SRCARCH)/Makefile
240endif
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)
245ifeq ($(FEATURES_DUMP),)
246FEATURE_DUMP_EXPORT := $(realpath $(OUTPUT)FEATURE-DUMP)
247else
248FEATURE_DUMP_EXPORT := $(realpath $(FEATURES_DUMP))
249endif
250
251export 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..
255SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
256
257# Guard against environment variables
258PYRF_OBJS =
259SCRIPT_SH =
260
261SCRIPT_SH += perf-archive.sh
262SCRIPT_SH += perf-with-kcore.sh
263
264grep-libs = $(filter -l%,$(1))
265strip-libs = $(filter-out -l%,$(1))
266
267ifneq ($(OUTPUT),)
268  TE_PATH=$(OUTPUT)
269  BPF_PATH=$(OUTPUT)
270  SUBCMD_PATH=$(OUTPUT)
271ifneq ($(subdir),)
272  API_PATH=$(OUTPUT)/../lib/api/
273else
274  API_PATH=$(OUTPUT)
275endif
276else
277  TE_PATH=$(TRACE_EVENT_DIR)
278  API_PATH=$(LIB_DIR)
279  BPF_PATH=$(BPF_DIR)
280  SUBCMD_PATH=$(SUBCMD_DIR)
281endif
282
283LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
284export LIBTRACEEVENT
285
286LIBTRACEEVENT_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.
292DYNAMIC_LIST_LDFLAGS               = -Xlinker --dynamic-list=$(LIBTRACEEVENT_DYNAMIC_LIST)
293LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS = $(if $(findstring -static,$(LDFLAGS)),,$(DYNAMIC_LIST_LDFLAGS))
294
295LIBAPI = $(API_PATH)libapi.a
296export LIBAPI
297
298LIBBPF = $(BPF_PATH)libbpf.a
299
300LIBSUBCMD = $(SUBCMD_PATH)libsubcmd.a
301
302# python extension build directories
303PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
304PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
305PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
306export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
307
308python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf*.so
309
310PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
311PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
312
313SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
314
315PROGRAMS += $(OUTPUT)perf
316
317ifndef NO_PERF_READ_VDSO32
318PROGRAMS += $(OUTPUT)perf-read-vdso32
319endif
320
321ifndef NO_PERF_READ_VDSOX32
322PROGRAMS += $(OUTPUT)perf-read-vdsox32
323endif
324
325LIBJVMTI = libperf-jvmti.so
326
327ifndef NO_JVMTI
328PROGRAMS += $(OUTPUT)$(LIBJVMTI)
329endif
330
331# what 'all' will build and 'install' will install, in perfexecdir
332ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
333
334# what 'all' will build but not install in perfexecdir
335OTHER_PROGRAMS = $(OUTPUT)perf
336
337# Set paths to tools early so that they can be used for version tests.
338ifndef SHELL_PATH
339  SHELL_PATH = /bin/sh
340endif
341ifndef PERL_PATH
342  PERL_PATH = /usr/bin/perl
343endif
344
345export PERL_PATH
346
347LIB_FILE=$(OUTPUT)libperf.a
348
349PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT) $(LIBSUBCMD)
350ifndef NO_LIBBPF
351  PERFLIBS += $(LIBBPF)
352endif
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
358ifneq ($(OUTPUT),)
359  CFLAGS += -I$(OUTPUT)
360endif
361
362ifndef NO_GTK2
363  ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
364  GTK_IN := $(OUTPUT)gtk-in.o
365endif
366
367ifdef ASCIIDOC8
368  export ASCIIDOC8
369endif
370
371EXTLIBS := $(call filter-out,$(EXCLUDE_EXTLIBS),$(EXTLIBS))
372LIBS = -Wl,--whole-archive $(PERFLIBS) $(EXTRA_PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
373
374ifeq ($(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
379endif
380
381ifeq ($(USE_LLVM), 1)
382  LIBLLVM = $(shell $(LLVM_CONFIG) --libs all) $(shell $(LLVM_CONFIG) --system-libs)
383  LIBS += -L$(shell $(LLVM_CONFIG) --libdir) $(LIBLLVM)
384endif
385
386ifeq ($(USE_CXX), 1)
387  LIBS += -lstdc++
388endif
389
390export INSTALL SHELL_PATH
391
392### Build rules
393
394SHELL = $(SHELL_PATH)
395
396linux_uapi_dir := $(srctree)/tools/include/uapi/linux
397asm_generic_uapi_dir := $(srctree)/tools/include/uapi/asm-generic
398arch_asm_uapi_dir := $(srctree)/tools/arch/$(SRCARCH)/include/uapi/asm/
399
400beauty_outdir := $(OUTPUT)trace/beauty/generated
401beauty_ioctl_outdir := $(beauty_outdir)/ioctl
402drm_ioctl_array := $(beauty_ioctl_outdir)/drm_ioctl_array.c
403drm_hdr_dir := $(srctree)/tools/include/uapi/drm
404drm_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/drm_ioctl.sh
405
406# Create output directory if not already present
407_dummy := $(shell [ -d '$(beauty_ioctl_outdir)' ] || mkdir -p '$(beauty_ioctl_outdir)')
408
409$(drm_ioctl_array): $(drm_hdr_dir)/drm.h $(drm_hdr_dir)/i915_drm.h $(drm_ioctl_tbl)
410	$(Q)$(SHELL) '$(drm_ioctl_tbl)' $(drm_hdr_dir) > $@
411
412pkey_alloc_access_rights_array := $(beauty_outdir)/pkey_alloc_access_rights_array.c
413asm_generic_hdr_dir := $(srctree)/tools/include/uapi/asm-generic/
414pkey_alloc_access_rights_tbl := $(srctree)/tools/perf/trace/beauty/pkey_alloc_access_rights.sh
415
416$(pkey_alloc_access_rights_array): $(asm_generic_hdr_dir)/mman-common.h $(pkey_alloc_access_rights_tbl)
417	$(Q)$(SHELL) '$(pkey_alloc_access_rights_tbl)' $(asm_generic_hdr_dir) > $@
418
419sndrv_ctl_ioctl_array := $(beauty_ioctl_outdir)/sndrv_ctl_ioctl_array.c
420sndrv_ctl_hdr_dir := $(srctree)/tools/include/uapi/sound
421sndrv_ctl_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/sndrv_ctl_ioctl.sh
422
423$(sndrv_ctl_ioctl_array): $(sndrv_ctl_hdr_dir)/asound.h $(sndrv_ctl_ioctl_tbl)
424	$(Q)$(SHELL) '$(sndrv_ctl_ioctl_tbl)' $(sndrv_ctl_hdr_dir) > $@
425
426sndrv_pcm_ioctl_array := $(beauty_ioctl_outdir)/sndrv_pcm_ioctl_array.c
427sndrv_pcm_hdr_dir := $(srctree)/tools/include/uapi/sound
428sndrv_pcm_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/sndrv_pcm_ioctl.sh
429
430$(sndrv_pcm_ioctl_array): $(sndrv_pcm_hdr_dir)/asound.h $(sndrv_pcm_ioctl_tbl)
431	$(Q)$(SHELL) '$(sndrv_pcm_ioctl_tbl)' $(sndrv_pcm_hdr_dir) > $@
432
433kcmp_type_array := $(beauty_outdir)/kcmp_type_array.c
434kcmp_hdr_dir := $(srctree)/tools/include/uapi/linux/
435kcmp_type_tbl := $(srctree)/tools/perf/trace/beauty/kcmp_type.sh
436
437$(kcmp_type_array): $(kcmp_hdr_dir)/kcmp.h $(kcmp_type_tbl)
438	$(Q)$(SHELL) '$(kcmp_type_tbl)' $(kcmp_hdr_dir) > $@
439
440kvm_ioctl_array := $(beauty_ioctl_outdir)/kvm_ioctl_array.c
441kvm_hdr_dir := $(srctree)/tools/include/uapi/linux
442kvm_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/kvm_ioctl.sh
443
444$(kvm_ioctl_array): $(kvm_hdr_dir)/kvm.h $(kvm_ioctl_tbl)
445	$(Q)$(SHELL) '$(kvm_ioctl_tbl)' $(kvm_hdr_dir) > $@
446
447socket_ipproto_array := $(beauty_outdir)/socket_ipproto_array.c
448socket_ipproto_tbl := $(srctree)/tools/perf/trace/beauty/socket_ipproto.sh
449
450$(socket_ipproto_array): $(linux_uapi_dir)/in.h $(socket_ipproto_tbl)
451	$(Q)$(SHELL) '$(socket_ipproto_tbl)' $(linux_uapi_dir) > $@
452
453vhost_virtio_ioctl_array := $(beauty_ioctl_outdir)/vhost_virtio_ioctl_array.c
454vhost_virtio_hdr_dir := $(srctree)/tools/include/uapi/linux
455vhost_virtio_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/vhost_virtio_ioctl.sh
456
457$(vhost_virtio_ioctl_array): $(vhost_virtio_hdr_dir)/vhost.h $(vhost_virtio_ioctl_tbl)
458	$(Q)$(SHELL) '$(vhost_virtio_ioctl_tbl)' $(vhost_virtio_hdr_dir) > $@
459
460perf_ioctl_array := $(beauty_ioctl_outdir)/perf_ioctl_array.c
461perf_hdr_dir := $(srctree)/tools/include/uapi/linux
462perf_ioctl_tbl := $(srctree)/tools/perf/trace/beauty/perf_ioctl.sh
463
464$(perf_ioctl_array): $(perf_hdr_dir)/perf_event.h $(perf_ioctl_tbl)
465	$(Q)$(SHELL) '$(perf_ioctl_tbl)' $(perf_hdr_dir) > $@
466
467madvise_behavior_array := $(beauty_outdir)/madvise_behavior_array.c
468madvise_hdr_dir := $(srctree)/tools/include/uapi/asm-generic/
469madvise_behavior_tbl := $(srctree)/tools/perf/trace/beauty/madvise_behavior.sh
470
471$(madvise_behavior_array): $(madvise_hdr_dir)/mman-common.h $(madvise_behavior_tbl)
472	$(Q)$(SHELL) '$(madvise_behavior_tbl)' $(madvise_hdr_dir) > $@
473
474mmap_flags_array := $(beauty_outdir)/mmap_flags_array.c
475mmap_flags_tbl := $(srctree)/tools/perf/trace/beauty/mmap_flags.sh
476
477$(mmap_flags_array): $(asm_generic_uapi_dir)/mman.h $(asm_generic_uapi_dir)/mman-common.h $(mmap_flags_tbl)
478	$(Q)$(SHELL) '$(mmap_flags_tbl)' $(asm_generic_uapi_dir) $(arch_asm_uapi_dir) > $@
479
480mount_flags_array := $(beauty_outdir)/mount_flags_array.c
481mount_flags_tbl := $(srctree)/tools/perf/trace/beauty/mount_flags.sh
482
483$(mount_flags_array): $(linux_uapi_dir)/fs.h $(mount_flags_tbl)
484	$(Q)$(SHELL) '$(mount_flags_tbl)' $(linux_uapi_dir) > $@
485
486prctl_option_array := $(beauty_outdir)/prctl_option_array.c
487prctl_hdr_dir := $(srctree)/tools/include/uapi/linux/
488prctl_option_tbl := $(srctree)/tools/perf/trace/beauty/prctl_option.sh
489
490$(prctl_option_array): $(prctl_hdr_dir)/prctl.h $(prctl_option_tbl)
491	$(Q)$(SHELL) '$(prctl_option_tbl)' $(prctl_hdr_dir) > $@
492
493rename_flags_array := $(beauty_outdir)/rename_flags_array.c
494rename_flags_tbl := $(srctree)/tools/perf/trace/beauty/rename_flags.sh
495
496$(rename_flags_array): $(linux_uapi_dir)/fs.h $(rename_flags_tbl)
497	$(Q)$(SHELL) '$(rename_flags_tbl)' $(linux_uapi_dir) > $@
498
499arch_errno_name_array := $(beauty_outdir)/arch_errno_name_array.c
500arch_errno_hdr_dir := $(srctree)/tools
501arch_errno_tbl := $(srctree)/tools/perf/trace/beauty/arch_errno_names.sh
502
503$(arch_errno_name_array): $(arch_errno_tbl)
504	$(Q)$(SHELL) '$(arch_errno_tbl)' $(CC) $(arch_errno_hdr_dir) > $@
505
506all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
507
508$(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS) $(LIBTRACEEVENT_DYNAMIC_LIST)
509	$(QUIET_GEN)LDSHARED="$(CC) -pthread -shared" \
510        CFLAGS='$(CFLAGS)' LDFLAGS='$(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS)' \
511	  $(PYTHON_WORD) util/setup.py \
512	  --quiet build_ext; \
513	mkdir -p $(OUTPUT)python && \
514	cp $(PYTHON_EXTBUILD_LIB)perf*.so $(OUTPUT)python/
515
516please_set_SHELL_PATH_to_a_more_modern_shell:
517	$(Q)$$(:)
518
519shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
520
521strip: $(PROGRAMS) $(OUTPUT)perf
522	$(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
523
524PERF_IN := $(OUTPUT)perf-in.o
525
526JEVENTS       := $(OUTPUT)pmu-events/jevents
527JEVENTS_IN    := $(OUTPUT)pmu-events/jevents-in.o
528
529PMU_EVENTS_IN := $(OUTPUT)pmu-events/pmu-events-in.o
530
531export JEVENTS
532
533build := -f $(srctree)/tools/build/Makefile.build dir=. obj
534
535$(PERF_IN): prepare FORCE
536	$(Q)$(MAKE) $(build)=perf
537
538$(JEVENTS_IN): FORCE
539	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=jevents
540
541$(JEVENTS): $(JEVENTS_IN)
542	$(QUIET_LINK)$(HOSTCC) $(JEVENTS_IN) -o $@
543
544$(PMU_EVENTS_IN): $(JEVENTS) FORCE
545	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=pmu-events
546
547$(OUTPUT)perf: $(PERFLIBS) $(PERF_IN) $(PMU_EVENTS_IN) $(LIBTRACEEVENT_DYNAMIC_LIST)
548	$(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS) \
549		$(PERF_IN) $(PMU_EVENTS_IN) $(LIBS) -o $@
550
551$(GTK_IN): FORCE
552	$(Q)$(MAKE) $(build)=gtk
553
554$(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
555	$(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
556
557$(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
558
559$(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
560	$(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
561
562$(SCRIPTS) : % : %.sh
563	$(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
564
565$(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
566	$(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
567	$(Q)touch $(OUTPUT)PERF-VERSION-FILE
568
569# These can record PERF_VERSION
570perf.spec $(SCRIPTS) \
571	: $(OUTPUT)PERF-VERSION-FILE
572
573.SUFFIXES:
574
575#
576# If a target does not match any of the later rules then prefix it by $(OUTPUT)
577# This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
578#
579ifneq ($(OUTPUT),)
580%.o: $(OUTPUT)%.o
581	@echo "    # Redirected target $@ => $(OUTPUT)$@"
582pmu-events/%.o: $(OUTPUT)pmu-events/%.o
583	@echo "    # Redirected target $@ => $(OUTPUT)$@"
584util/%.o: $(OUTPUT)util/%.o
585	@echo "    # Redirected target $@ => $(OUTPUT)$@"
586bench/%.o: $(OUTPUT)bench/%.o
587	@echo "    # Redirected target $@ => $(OUTPUT)$@"
588tests/%.o: $(OUTPUT)tests/%.o
589	@echo "    # Redirected target $@ => $(OUTPUT)$@"
590endif
591
592# These two need to be here so that when O= is not used they take precedence
593# over the general rule for .o
594
595# get relative building directory (to $(OUTPUT))
596# and '.' if it's $(OUTPUT) itself
597__build-dir = $(subst $(OUTPUT),,$(dir $@))
598build-dir   = $(if $(__build-dir),$(__build-dir),.)
599
600prepare: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h archheaders $(drm_ioctl_array) \
601	$(pkey_alloc_access_rights_array) \
602	$(sndrv_pcm_ioctl_array) \
603	$(sndrv_ctl_ioctl_array) \
604	$(kcmp_type_array) \
605	$(kvm_ioctl_array) \
606	$(socket_ipproto_array) \
607	$(vhost_virtio_ioctl_array) \
608	$(madvise_behavior_array) \
609	$(mmap_flags_array) \
610	$(mount_flags_array) \
611	$(perf_ioctl_array) \
612	$(prctl_option_array) \
613	$(rename_flags_array) \
614	$(arch_errno_name_array)
615
616$(OUTPUT)%.o: %.c prepare FORCE
617	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
618
619$(OUTPUT)%.i: %.c prepare FORCE
620	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
621
622$(OUTPUT)%.s: %.c prepare FORCE
623	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
624
625$(OUTPUT)%-bison.o: %.c prepare FORCE
626	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
627
628$(OUTPUT)%-flex.o: %.c prepare FORCE
629	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
630
631$(OUTPUT)%.o: %.S prepare FORCE
632	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
633
634$(OUTPUT)%.i: %.S prepare FORCE
635	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
636
637$(OUTPUT)perf-%: %.o $(PERFLIBS)
638	$(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
639
640ifndef NO_PERF_READ_VDSO32
641$(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
642	$(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
643endif
644
645ifndef NO_PERF_READ_VDSOX32
646$(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
647	$(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
648endif
649
650ifndef NO_JVMTI
651LIBJVMTI_IN := $(OUTPUT)jvmti/jvmti-in.o
652
653$(LIBJVMTI_IN): FORCE
654	$(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=jvmti obj=jvmti
655
656$(OUTPUT)$(LIBJVMTI): $(LIBJVMTI_IN)
657	$(QUIET_LINK)$(CC) $(LDFLAGS) -shared -Wl,-soname -Wl,$(LIBJVMTI) -o $@ $<
658endif
659
660$(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
661
662LIBPERF_IN := $(OUTPUT)libperf-in.o
663
664$(LIBPERF_IN): prepare FORCE
665	$(Q)$(MAKE) $(build)=libperf
666
667$(LIB_FILE): $(LIBPERF_IN)
668	$(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
669
670LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ) 'EXTRA_CFLAGS=$(EXTRA_CFLAGS)' 'LDFLAGS=$(LDFLAGS)'
671
672$(LIBTRACEEVENT): FORCE
673	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a
674
675libtraceevent_plugins: FORCE
676	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) plugins
677
678$(LIBTRACEEVENT_DYNAMIC_LIST): libtraceevent_plugins
679	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent-dynamic-list
680
681$(LIBTRACEEVENT)-clean:
682	$(call QUIET_CLEAN, libtraceevent)
683	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
684
685install-traceevent-plugins: libtraceevent_plugins
686	$(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
687
688$(LIBAPI): FORCE
689	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
690
691$(LIBAPI)-clean:
692	$(call QUIET_CLEAN, libapi)
693	$(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
694
695$(LIBBPF): FORCE
696	$(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) $(OUTPUT)libbpf.a FEATURES_DUMP=$(FEATURE_DUMP_EXPORT)
697
698$(LIBBPF)-clean:
699	$(call QUIET_CLEAN, libbpf)
700	$(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) clean >/dev/null
701
702$(LIBSUBCMD): FORCE
703	$(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) $(OUTPUT)libsubcmd.a
704
705$(LIBSUBCMD)-clean:
706	$(call QUIET_CLEAN, libsubcmd)
707	$(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) clean
708
709help:
710	@echo 'Perf make targets:'
711	@echo '  doc		- make *all* documentation (see below)'
712	@echo '  man		- make manpage documentation (access with man <foo>)'
713	@echo '  html		- make html documentation'
714	@echo '  info		- make GNU info documentation (access with info <foo>)'
715	@echo '  pdf		- make pdf documentation'
716	@echo '  TAGS		- use etags to make tag information for source browsing'
717	@echo '  tags		- use ctags to make tag information for source browsing'
718	@echo '  cscope	- use cscope to make interactive browsing database'
719	@echo ''
720	@echo 'Perf install targets:'
721	@echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
722	@echo '  HINT: use "prefix" or "DESTDIR" to install to a particular'
723	@echo '        path like "make prefix=/usr/local install install-doc"'
724	@echo '  install	- install compiled binaries'
725	@echo '  install-doc	- install *all* documentation'
726	@echo '  install-man	- install manpage documentation'
727	@echo '  install-html	- install html documentation'
728	@echo '  install-info	- install GNU info documentation'
729	@echo '  install-pdf	- install pdf documentation'
730	@echo ''
731	@echo '  quick-install-doc	- alias for quick-install-man'
732	@echo '  quick-install-man	- install the documentation quickly'
733	@echo '  quick-install-html	- install the html documentation quickly'
734	@echo ''
735	@echo 'Perf maintainer targets:'
736	@echo '  clean			- clean all binary objects and build output'
737
738
739DOC_TARGETS := doc man html info pdf
740
741INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
742INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
743
744# 'make doc' should call 'make -C Documentation all'
745$(DOC_TARGETS):
746	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
747
748TAG_FOLDERS= . ../lib ../include
749TAG_FILES= ../../include/uapi/linux/perf_event.h
750
751TAGS:
752	$(QUIET_GEN)$(RM) TAGS; \
753	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs etags -a $(TAG_FILES)
754
755tags:
756	$(QUIET_GEN)$(RM) tags; \
757	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs ctags -a $(TAG_FILES)
758
759cscope:
760	$(QUIET_GEN)$(RM) cscope*; \
761	$(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print -o -name '*.cpp' -print | xargs cscope -b $(TAG_FILES)
762
763### Testing rules
764
765# GNU make supports exporting all variables by "export" without parameters.
766# However, the environment gets quite big, and some programs have problems
767# with that.
768
769check: $(OUTPUT)common-cmds.h
770	if sparse; \
771	then \
772		for i in *.c */*.c; \
773		do \
774			sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
775		done; \
776	else \
777		exit 1; \
778	fi
779
780### Installation rules
781
782ifndef NO_GTK2
783install-gtk: $(OUTPUT)libperf-gtk.so
784	$(call QUIET_INSTALL, 'GTK UI') \
785		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
786		$(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
787else
788install-gtk:
789endif
790
791install-tools: all install-gtk
792	$(call QUIET_INSTALL, binaries) \
793		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
794		$(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
795		$(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
796ifndef NO_PERF_READ_VDSO32
797	$(call QUIET_INSTALL, perf-read-vdso32) \
798		$(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
799endif
800ifndef NO_PERF_READ_VDSOX32
801	$(call QUIET_INSTALL, perf-read-vdsox32) \
802		$(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
803endif
804ifndef NO_JVMTI
805	$(call QUIET_INSTALL, $(LIBJVMTI)) \
806		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
807		$(INSTALL) $(OUTPUT)$(LIBJVMTI) '$(DESTDIR_SQ)$(libdir_SQ)';
808endif
809	$(call QUIET_INSTALL, libexec) \
810		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
811ifndef NO_LIBBPF
812	$(call QUIET_INSTALL, bpf-headers) \
813		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf'; \
814		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf/linux'; \
815		$(INSTALL) include/bpf/*.h -t '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf'; \
816		$(INSTALL) include/bpf/linux/*.h -t '$(DESTDIR_SQ)$(perf_include_instdir_SQ)/bpf/linux'
817	$(call QUIET_INSTALL, bpf-examples) \
818		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perf_examples_instdir_SQ)/bpf'; \
819		$(INSTALL) examples/bpf/*.c -t '$(DESTDIR_SQ)$(perf_examples_instdir_SQ)/bpf'
820endif
821	$(call QUIET_INSTALL, perf-archive) \
822		$(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
823	$(call QUIET_INSTALL, perf-with-kcore) \
824		$(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
825ifndef NO_LIBAUDIT
826	$(call QUIET_INSTALL, strace/groups) \
827		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'; \
828		$(INSTALL) trace/strace/groups/* -t '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'
829endif
830ifndef NO_LIBPERL
831	$(call QUIET_INSTALL, perl-scripts) \
832		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
833		$(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
834		$(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
835		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
836		$(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
837endif
838ifndef NO_LIBPYTHON
839	$(call QUIET_INSTALL, python-scripts) \
840		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
841		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
842		$(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
843		$(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
844		$(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
845endif
846	$(call QUIET_INSTALL, perf_completion-script) \
847		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
848		$(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
849	$(call QUIET_INSTALL, perf-tip) \
850		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(tip_instdir_SQ)'; \
851		$(INSTALL) Documentation/tips.txt -t '$(DESTDIR_SQ)$(tip_instdir_SQ)'
852
853install-tests: all install-gtk
854	$(call QUIET_INSTALL, tests) \
855		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
856		$(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
857		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
858		$(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
859		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell'; \
860		$(INSTALL) tests/shell/*.sh '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell'; \
861		$(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell/lib'; \
862		$(INSTALL) tests/shell/lib/*.sh '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/shell/lib'
863
864install-bin: install-tools install-tests install-traceevent-plugins
865
866install: install-bin try-install-man
867
868install-python_ext:
869	$(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
870
871# 'make install-doc' should call 'make -C Documentation install'
872$(INSTALL_DOC_TARGETS):
873	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
874
875### Cleaning rules
876
877#
878# This is here, not in Makefile.config, because Makefile.config does
879# not get included for the clean target:
880#
881config-clean:
882	$(call QUIET_CLEAN, config)
883	$(Q)$(MAKE) -C $(srctree)/tools/build/feature/ $(if $(OUTPUT),OUTPUT=$(OUTPUT)feature/,) clean >/dev/null
884
885python-clean:
886	$(python-clean)
887
888clean:: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean $(LIBBPF)-clean $(LIBSUBCMD)-clean config-clean fixdep-clean python-clean
889	$(call QUIET_CLEAN, core-objs)  $(RM) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(LANG_BINDINGS)
890	$(Q)find $(if $(OUTPUT),$(OUTPUT),.) -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
891	$(Q)$(RM) $(OUTPUT).config-detected
892	$(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32 $(OUTPUT)pmu-events/jevents $(OUTPUT)$(LIBJVMTI).so
893	$(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* \
894		$(OUTPUT)util/intel-pt-decoder/inat-tables.c \
895		$(OUTPUT)tests/llvm-src-{base,kbuild,prologue,relocation}.c \
896		$(OUTPUT)pmu-events/pmu-events.c \
897		$(OUTPUT)$(madvise_behavior_array) \
898		$(OUTPUT)$(mmap_flags_array) \
899		$(OUTPUT)$(mount_flags_array) \
900		$(OUTPUT)$(drm_ioctl_array) \
901		$(OUTPUT)$(pkey_alloc_access_rights_array) \
902		$(OUTPUT)$(sndrv_ctl_ioctl_array) \
903		$(OUTPUT)$(sndrv_pcm_ioctl_array) \
904		$(OUTPUT)$(kvm_ioctl_array) \
905		$(OUTPUT)$(kcmp_type_array) \
906		$(OUTPUT)$(socket_ipproto_array) \
907		$(OUTPUT)$(vhost_virtio_ioctl_array) \
908		$(OUTPUT)$(perf_ioctl_array) \
909		$(OUTPUT)$(prctl_option_array) \
910		$(OUTPUT)$(rename_flags_array) \
911		$(OUTPUT)$(arch_errno_name_array)
912	$(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
913
914#
915# To provide FEATURE-DUMP into $(FEATURE_DUMP_COPY)
916# file if defined, with no further action.
917feature-dump:
918ifdef FEATURE_DUMP_COPY
919	@cp $(OUTPUT)FEATURE-DUMP $(FEATURE_DUMP_COPY)
920	@echo "FEATURE-DUMP file copied into $(FEATURE_DUMP_COPY)"
921else
922	@echo "FEATURE-DUMP file available in $(OUTPUT)FEATURE-DUMP"
923endif
924
925#
926# Trick: if ../../.git does not exist - we are building out of tree for example,
927# then force version regeneration:
928#
929ifeq ($(wildcard ../../.git/HEAD),)
930    GIT-HEAD-PHONY = ../../.git/HEAD
931else
932    GIT-HEAD-PHONY =
933endif
934
935FORCE:
936
937.PHONY: all install clean config-clean strip install-gtk
938.PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
939.PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE prepare
940.PHONY: libtraceevent_plugins archheaders
941
942endif # force_fixdep
943