tools/perf/Makefile.perf

   1 include ../scripts/Makefile.include
   2
   3 # The default target of this Makefile is...
   4 all:
   5
   6 include config/utilities.mak
   7
   8 # Define V to have a more verbose compile.
   9 #
  10 # Define VF to have a more verbose feature check output.
  11 #
  12 # Define O to save output files in a separate directory.
  13 #
  14 # Define ARCH as name of target architecture if you want cross-builds.
  15 #
  16 # Define CROSS_COMPILE as prefix name of compiler if you want cross-builds.
  17 #
  18 # Define NO_LIBPERL to disable perl script extension.
  19 #
  20 # Define NO_LIBPYTHON to disable python script extension.
  21 #
  22 # Define PYTHON to point to the python binary if the default
  23 # `python' is not correct; for example: PYTHON=python2
  24 #
  25 # Define PYTHON_CONFIG to point to the python-config binary if
  26 # the default `$(PYTHON)-config' is not correct.
  27 #
  28 # Define ASCIIDOC8 if you want to format documentation with AsciiDoc 8
  29 #
  30 # Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72.
  31 #
  32 # Define LDFLAGS=-static to build a static binary.
  33 #
  34 # Define EXTRA_CFLAGS=-m64 or EXTRA_CFLAGS=-m32 as appropriate for cross-builds.
  35 #
  36 # Define NO_DWARF if you do not want debug-info analysis feature at all.
  37 #
  38 # Define WERROR=0 to disable treating any warnings as errors.
  39 #
  40 # Define NO_NEWT if you do not want TUI support. (deprecated)
  41 #
  42 # Define NO_SLANG if you do not want TUI support.
  43 #
  44 # Define NO_GTK2 if you do not want GTK+ GUI support.
  45 #
  46 # Define NO_DEMANGLE if you do not want C++ symbol demangling.
  47 #
  48 # Define NO_LIBELF if you do not want libelf dependency (e.g. cross-builds)
  49 #
  50 # Define NO_LIBUNWIND if you do not want libunwind dependency for dwarf
  51 # backtrace post unwind.
  52 #
  53 # Define NO_BACKTRACE if you do not want stack backtrace debug feature
  54 #
  55 # Define NO_LIBNUMA if you do not want numa perf benchmark
  56 #
  57 # Define NO_LIBAUDIT if you do not want libaudit support
  58 #
  59 # Define NO_LIBBIONIC if you do not want bionic support
  60 #
  61 # Define NO_LIBDW_DWARF_UNWIND if you do not want libdw support
  62 # for dwarf backtrace post unwind.
  63 #
  64 # Define NO_PERF_READ_VDSO32 if you do not want to build perf-read-vdso32
  65 # for reading the 32-bit compatibility VDSO in 64-bit mode
  66 #
  67 # Define NO_PERF_READ_VDSOX32 if you do not want to build perf-read-vdsox32
  68 # for reading the x32 mode 32-bit compatibility VDSO in 64-bit mode
  69 #
  70 # Define NO_ZLIB if you do not want to support compressed kernel modules
  71 #
  72 # Define LIBBABELTRACE if you DO want libbabeltrace support
  73 # for CTF data format.
  74 #
  75 # Define NO_LZMA if you do not want to support compressed (xz) kernel modules
  76 #
  77 # Define NO_AUXTRACE if you do not want AUX area tracing support
  78 #
  79 # Define NO_LIBBPF if you do not want BPF support
  80
  81 # As per kernel Makefile, avoid funny character set dependencies
  82 unexport LC_ALL
  83 LC_COLLATE=C
  84 LC_NUMERIC=C
  85 export LC_COLLATE LC_NUMERIC
  86
  87 ifeq ($(srctree),)
  88 srctree := $(patsubst %/,%,$(dir $(shell pwd)))
  89 srctree := $(patsubst %/,%,$(dir $(srctree)))
  90 #$(info Determined 'srctree' to be $(srctree))
  91 endif
  92
  93 ifneq ($(objtree),)
  94 #$(info Determined 'objtree' to be $(objtree))
  95 endif
  96
  97 ifneq ($(OUTPUT),)
  98 #$(info Determined 'OUTPUT' to be $(OUTPUT))
  99 # Adding $(OUTPUT) as a directory to look for source files,
 100 # because use generated output files as sources dependency
 101 # for flex/bison parsers.
 102 VPATH += $(OUTPUT)
 103 export VPATH
 104 endif
 105
 106 ifeq ($(V),1)
 107   Q =
 108 else
 109   Q = @
 110 endif
 111
 112 # Do not use make's built-in rules
 113 # (this improves performance and avoids hard-to-debug behaviour);
 114 MAKEFLAGS += -r
 115
 116 $(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
 117         $(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
 118         $(Q)touch $(OUTPUT)PERF-VERSION-FILE
 119
 120 # Makefiles suck: This macro sets a default value of $(2) for the
 121 # variable named by $(1), unless the variable has been set by
 122 # environment or command line. This is necessary for CC and AR
 123 # because make sets default values, so the simpler ?= approach
 124 # won't work as expected.
 125 define allow-override
 126   $(if $(or $(findstring environment,$(origin $(1))),\
 127             $(findstring command line,$(origin $(1)))),,\
 128     $(eval $(1) = $(2)))
 129 endef
 130
 131 # Allow setting CC and AR and LD, or setting CROSS_COMPILE as a prefix.
 132 $(call allow-override,CC,$(CROSS_COMPILE)gcc)
 133 $(call allow-override,AR,$(CROSS_COMPILE)ar)
 134 $(call allow-override,LD,$(CROSS_COMPILE)ld)
 135
 136 PKG_CONFIG = $(CROSS_COMPILE)pkg-config
 137
 138 RM      = rm -f
 139 LN      = ln -f
 140 MKDIR   = mkdir
 141 FIND    = find
 142 INSTALL = install
 143 FLEX    = flex
 144 BISON   = bison
 145 STRIP   = strip
 146 AWK     = awk
 147
 148 LIB_DIR          = $(srctree)/tools/lib/api/
 149 TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
 150 BPF_DIR = $(srctree)/tools/lib/bpf/
 151
 152 # include config/Makefile by default and rule out
 153 # non-config cases
 154 config := 1
 155
 156 NON_CONFIG_TARGETS := clean TAGS tags cscope help
 157
 158 ifdef MAKECMDGOALS
 159 ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
 160   config := 0
 161 endif
 162 endif
 163
 164 ifeq ($(config),1)
 165 include config/Makefile
 166 endif
 167
 168 export prefix bindir sharedir sysconfdir DESTDIR
 169
 170 # sparse is architecture-neutral, which means that we need to tell it
 171 # explicitly what architecture to check for. Fix this up for yours..
 172 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
 173
 174 # Guard against environment variables
 175 PYRF_OBJS =
 176 SCRIPT_SH =
 177
 178 SCRIPT_SH += perf-archive.sh
 179 SCRIPT_SH += perf-with-kcore.sh
 180
 181 grep-libs = $(filter -l%,$(1))
 182 strip-libs = $(filter-out -l%,$(1))
 183
 184 ifneq ($(OUTPUT),)
 185   TE_PATH=$(OUTPUT)
 186   BPF_PATH=$(OUTPUT)
 187 ifneq ($(subdir),)
 188   LIB_PATH=$(OUTPUT)/../lib/api/
 189 else
 190   LIB_PATH=$(OUTPUT)
 191 endif
 192 else
 193   TE_PATH=$(TRACE_EVENT_DIR)
 194   LIB_PATH=$(LIB_DIR)
 195   BPF_PATH=$(BPF_DIR)
 196 endif
 197
 198 LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
 199 export LIBTRACEEVENT
 200
 201 LIBTRACEEVENT_DYNAMIC_LIST = $(TE_PATH)libtraceevent-dynamic-list
 202 LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS = -Xlinker --dynamic-list=$(LIBTRACEEVENT_DYNAMIC_LIST)
 203
 204 LIBAPI = $(LIB_PATH)libapi.a
 205 export LIBAPI
 206
 207 LIBBPF = $(BPF_PATH)libbpf.a
 208
 209 # python extension build directories
 210 PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
 211 PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
 212 PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
 213 export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
 214
 215 python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf.so
 216
 217 PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
 218 PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
 219
 220 $(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS) $(LIBTRACEEVENT_DYNAMIC_LIST)
 221         $(QUIET_GEN)CFLAGS='$(CFLAGS)' LDFLAGS='$(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS)' \
 222           $(PYTHON_WORD) util/setup.py \
 223           --quiet build_ext; \
 224         mkdir -p $(OUTPUT)python && \
 225         cp $(PYTHON_EXTBUILD_LIB)perf.so $(OUTPUT)python/
 226 #
 227 # No Perl scripts right now:
 228 #
 229
 230 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
 231
 232 PROGRAMS += $(OUTPUT)perf
 233
 234 ifndef NO_PERF_READ_VDSO32
 235 PROGRAMS += $(OUTPUT)perf-read-vdso32
 236 endif
 237
 238 ifndef NO_PERF_READ_VDSOX32
 239 PROGRAMS += $(OUTPUT)perf-read-vdsox32
 240 endif
 241
 242 # what 'all' will build and 'install' will install, in perfexecdir
 243 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
 244
 245 # what 'all' will build but not install in perfexecdir
 246 OTHER_PROGRAMS = $(OUTPUT)perf
 247
 248 # Set paths to tools early so that they can be used for version tests.
 249 ifndef SHELL_PATH
 250   SHELL_PATH = /bin/sh
 251 endif
 252 ifndef PERL_PATH
 253   PERL_PATH = /usr/bin/perl
 254 endif
 255
 256 export PERL_PATH
 257
 258 LIB_FILE=$(OUTPUT)libperf.a
 259
 260 PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT)
 261 ifndef NO_LIBBPF
 262   PERFLIBS += $(LIBBPF)
 263 endif
 264
 265 # We choose to avoid "if .. else if .. else .. endif endif"
 266 # because maintaining the nesting to match is a pain.  If
 267 # we had "elif" things would have been much nicer...
 268
 269 -include arch/$(ARCH)/Makefile
 270
 271 ifneq ($(OUTPUT),)
 272   CFLAGS += -I$(OUTPUT)
 273 endif
 274
 275 ifndef NO_GTK2
 276   ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
 277   GTK_IN := $(OUTPUT)gtk-in.o
 278
 279 install-gtk: $(OUTPUT)libperf-gtk.so
 280         $(call QUIET_INSTALL, 'GTK UI') \
 281                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
 282                 $(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
 283 endif
 284
 285 ifdef ASCIIDOC8
 286   export ASCIIDOC8
 287 endif
 288
 289 LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
 290
 291 export INSTALL SHELL_PATH
 292
 293 ### Build rules
 294
 295 SHELL = $(SHELL_PATH)
 296
 297 all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
 298
 299 please_set_SHELL_PATH_to_a_more_modern_shell:
 300         $(Q)$$(:)
 301
 302 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
 303
 304 strip: $(PROGRAMS) $(OUTPUT)perf
 305         $(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
 306
 307 PERF_IN := $(OUTPUT)perf-in.o
 308
 309 export srctree OUTPUT RM CC LD AR CFLAGS V BISON FLEX AWK
 310 include $(srctree)/tools/build/Makefile.include
 311
 312 $(PERF_IN): prepare FORCE
 313         @(test -f ../../arch/x86/include/asm/disabled-features.h && ( \
 314         (diff -B ../arch/x86/include/asm/disabled-features.h ../../arch/x86/include/asm/disabled-features.h >/dev/null) \
 315         || echo "Warning: tools/arch/x86/include/asm/disabled-features.h differs from kernel" >&2 )) || true
 316         @(test -f ../../arch/x86/include/asm/required-features.h && ( \
 317         (diff -B ../arch/x86/include/asm/required-features.h ../../arch/x86/include/asm/required-features.h >/dev/null) \
 318         || echo "Warning: tools/arch/x86/include/asm/required-features.h differs from kernel" >&2 )) || true
 319         @(test -f ../../arch/x86/include/asm/cpufeatures.h && ( \
 320         (diff -B ../arch/x86/include/asm/cpufeatures.h ../../arch/x86/include/asm/cpufeatures.h >/dev/null) \
 321         || echo "Warning: tools/arch/x86/include/asm/cpufeatures.h differs from kernel" >&2 )) || true
 322         @(test -f ../../arch/x86/lib/memcpy_64.S && ( \
 323         (diff -B ../arch/x86/lib/memcpy_64.S ../../arch/x86/lib/memcpy_64.S >/dev/null) \
 324         || echo "Warning: tools/arch/x86/lib/memcpy_64.S differs from kernel" >&2 )) || true
 325         @(test -f ../../arch/x86/lib/memset_64.S && ( \
 326         (diff -B ../arch/x86/lib/memset_64.S ../../arch/x86/lib/memset_64.S >/dev/null) \
 327         || echo "Warning: tools/arch/x86/lib/memset_64.S differs from kernel" >&2 )) || true
 328         $(Q)$(MAKE) $(build)=perf
 329
 330 $(OUTPUT)perf: $(PERFLIBS) $(PERF_IN) $(LIBTRACEEVENT_DYNAMIC_LIST)
 331         $(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS) \
 332                 $(PERF_IN) $(LIBS) -o $@
 333
 334 $(GTK_IN): fixdep FORCE
 335         $(Q)$(MAKE) $(build)=gtk
 336
 337 $(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
 338         $(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
 339
 340 $(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
 341
 342 $(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
 343         $(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
 344
 345 $(SCRIPTS) : % : %.sh
 346         $(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
 347
 348 # These can record PERF_VERSION
 349 perf.spec $(SCRIPTS) \
 350         : $(OUTPUT)PERF-VERSION-FILE
 351
 352 .SUFFIXES:
 353
 354 #
 355 # If a target does not match any of the later rules then prefix it by $(OUTPUT)
 356 # This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
 357 #
 358 ifneq ($(OUTPUT),)
 359 %.o: $(OUTPUT)%.o
 360         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 361 util/%.o: $(OUTPUT)util/%.o
 362         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 363 bench/%.o: $(OUTPUT)bench/%.o
 364         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 365 tests/%.o: $(OUTPUT)tests/%.o
 366         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 367 endif
 368
 369 # These two need to be here so that when O= is not used they take precedence
 370 # over the general rule for .o
 371
 372 # get relative building directory (to $(OUTPUT))
 373 # and '.' if it's $(OUTPUT) itself
 374 __build-dir = $(subst $(OUTPUT),,$(dir $@))
 375 build-dir   = $(if $(__build-dir),$(__build-dir),.)
 376
 377 prepare: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h fixdep
 378
 379 $(OUTPUT)%.o: %.c prepare FORCE
 380         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 381
 382 $(OUTPUT)%.i: %.c prepare FORCE
 383         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 384
 385 $(OUTPUT)%.s: %.c prepare FORCE
 386         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 387
 388 $(OUTPUT)%-bison.o: %.c prepare FORCE
 389         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 390
 391 $(OUTPUT)%-flex.o: %.c prepare FORCE
 392         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 393
 394 $(OUTPUT)%.o: %.S prepare FORCE
 395         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 396
 397 $(OUTPUT)%.i: %.S prepare FORCE
 398         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 399
 400 $(OUTPUT)perf-%: %.o $(PERFLIBS)
 401         $(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
 402
 403 ifndef NO_PERF_READ_VDSO32
 404 $(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
 405         $(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
 406 endif
 407
 408 ifndef NO_PERF_READ_VDSOX32
 409 $(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
 410         $(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
 411 endif
 412
 413 $(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
 414
 415 LIBPERF_IN := $(OUTPUT)libperf-in.o
 416
 417 $(LIBPERF_IN): fixdep FORCE
 418         $(Q)$(MAKE) $(build)=libperf
 419
 420 $(LIB_FILE): $(LIBPERF_IN)
 421         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
 422
 423 LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ)
 424
 425 $(LIBTRACEEVENT): fixdep FORCE
 426         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a
 427
 428 libtraceevent_plugins: fixdep FORCE
 429         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) plugins
 430
 431 $(LIBTRACEEVENT_DYNAMIC_LIST): libtraceevent_plugins
 432         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent-dynamic-list
 433
 434 $(LIBTRACEEVENT)-clean:
 435         $(call QUIET_CLEAN, libtraceevent)
 436         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
 437
 438 install-traceevent-plugins: libtraceevent_plugins
 439         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
 440
 441 $(LIBAPI): fixdep FORCE
 442         $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
 443
 444 $(LIBAPI)-clean:
 445         $(call QUIET_CLEAN, libapi)
 446         $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
 447
 448 $(LIBBPF): fixdep FORCE
 449         $(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) $(OUTPUT)libbpf.a
 450
 451 $(LIBBPF)-clean:
 452         $(call QUIET_CLEAN, libbpf)
 453         $(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) clean >/dev/null
 454
 455 help:
 456         @echo 'Perf make targets:'
 457         @echo '  doc            - make *all* documentation (see below)'
 458         @echo '  man            - make manpage documentation (access with man <foo>)'
 459         @echo '  html           - make html documentation'
 460         @echo '  info           - make GNU info documentation (access with info <foo>)'
 461         @echo '  pdf            - make pdf documentation'
 462         @echo '  TAGS           - use etags to make tag information for source browsing'
 463         @echo '  tags           - use ctags to make tag information for source browsing'
 464         @echo '  cscope - use cscope to make interactive browsing database'
 465         @echo ''
 466         @echo 'Perf install targets:'
 467         @echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
 468         @echo '  HINT: use "prefix" or "DESTDIR" to install to a particular'
 469         @echo '        path like "make prefix=/usr/local install install-doc"'
 470         @echo '  install        - install compiled binaries'
 471         @echo '  install-doc    - install *all* documentation'
 472         @echo '  install-man    - install manpage documentation'
 473         @echo '  install-html   - install html documentation'
 474         @echo '  install-info   - install GNU info documentation'
 475         @echo '  install-pdf    - install pdf documentation'
 476         @echo ''
 477         @echo '  quick-install-doc      - alias for quick-install-man'
 478         @echo '  quick-install-man      - install the documentation quickly'
 479         @echo '  quick-install-html     - install the html documentation quickly'
 480         @echo ''
 481         @echo 'Perf maintainer targets:'
 482         @echo '  clean                  - clean all binary objects and build output'
 483
 484
 485 DOC_TARGETS := doc man html info pdf
 486
 487 INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
 488 INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
 489
 490 # 'make doc' should call 'make -C Documentation all'
 491 $(DOC_TARGETS):
 492         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
 493
 494 TAG_FOLDERS= . ../lib/traceevent ../lib/api ../lib/symbol ../include ../lib/bpf
 495 TAG_FILES= ../../include/uapi/linux/perf_event.h
 496
 497 TAGS:
 498         $(QUIET_GEN)$(RM) TAGS; \
 499         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs etags -a $(TAG_FILES)
 500
 501 tags:
 502         $(QUIET_GEN)$(RM) tags; \
 503         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs ctags -a $(TAG_FILES)
 504
 505 cscope:
 506         $(QUIET_GEN)$(RM) cscope*; \
 507         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs cscope -b $(TAG_FILES)
 508
 509 ### Testing rules
 510
 511 # GNU make supports exporting all variables by "export" without parameters.
 512 # However, the environment gets quite big, and some programs have problems
 513 # with that.
 514
 515 check: $(OUTPUT)common-cmds.h
 516         if sparse; \
 517         then \
 518                 for i in *.c */*.c; \
 519                 do \
 520                         sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
 521                 done; \
 522         else \
 523                 exit 1; \
 524         fi
 525
 526 ### Installation rules
 527
 528 install-gtk:
 529
 530 install-tools: all install-gtk
 531         $(call QUIET_INSTALL, binaries) \
 532                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
 533                 $(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
 534                 $(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
 535 ifndef NO_PERF_READ_VDSO32
 536         $(call QUIET_INSTALL, perf-read-vdso32) \
 537                 $(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
 538 endif
 539 ifndef NO_PERF_READ_VDSOX32
 540         $(call QUIET_INSTALL, perf-read-vdsox32) \
 541                 $(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
 542 endif
 543         $(call QUIET_INSTALL, libexec) \
 544                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 545         $(call QUIET_INSTALL, perf-archive) \
 546                 $(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 547         $(call QUIET_INSTALL, perf-with-kcore) \
 548                 $(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 549 ifndef NO_LIBAUDIT
 550         $(call QUIET_INSTALL, strace/groups) \
 551                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'; \
 552                 $(INSTALL) trace/strace/groups/* -t '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'
 553 endif
 554 ifndef NO_LIBPERL
 555         $(call QUIET_INSTALL, perl-scripts) \
 556                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
 557                 $(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
 558                 $(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
 559                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
 560                 $(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
 561 endif
 562 ifndef NO_LIBPYTHON
 563         $(call QUIET_INSTALL, python-scripts) \
 564                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
 565                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
 566                 $(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
 567                 $(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
 568                 $(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
 569 endif
 570         $(call QUIET_INSTALL, perf_completion-script) \
 571                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
 572                 $(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
 573
 574 install-tests: all install-gtk
 575         $(call QUIET_INSTALL, tests) \
 576                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
 577                 $(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
 578                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
 579                 $(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'
 580
 581 install-bin: install-tools install-tests install-traceevent-plugins
 582
 583 install: install-bin try-install-man
 584
 585 install-python_ext:
 586         $(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
 587
 588 # 'make install-doc' should call 'make -C Documentation install'
 589 $(INSTALL_DOC_TARGETS):
 590         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
 591
 592 ### Cleaning rules
 593
 594 #
 595 # This is here, not in config/Makefile, because config/Makefile does
 596 # not get included for the clean target:
 597 #
 598 config-clean:
 599         $(call QUIET_CLEAN, config)
 600         $(Q)$(MAKE) -C $(srctree)/tools/build/feature/ clean >/dev/null
 601
 602 clean: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean $(LIBBPF)-clean config-clean
 603         $(call QUIET_CLEAN, core-objs)  $(RM) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(LANG_BINDINGS)
 604         $(Q)find . -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
 605         $(Q)$(RM) $(OUTPUT).config-detected
 606         $(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32
 607         $(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* \
 608                 $(OUTPUT)util/intel-pt-decoder/inat-tables.c
 609         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
 610         $(python-clean)
 611
 612 #
 613 # Trick: if ../../.git does not exist - we are building out of tree for example,
 614 # then force version regeneration:
 615 #
 616 ifeq ($(wildcard ../../.git/HEAD),)
 617     GIT-HEAD-PHONY = ../../.git/HEAD
 618 else
 619     GIT-HEAD-PHONY =
 620 endif
 621
 622 FORCE:
 623
 624 .PHONY: all install clean config-clean strip install-gtk
 625 .PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
 626 .PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE prepare
 627 .PHONY: libtraceevent_plugins
 628