tools/perf/Makefile.perf

   1 include ../scripts/Makefile.include
   2
   3 # The default target of this Makefile is...
   4 all:
   5
   6 include ../scripts/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_LIBCRYPTO if you do not want libcrypto (openssl) support
  62 # used for generating build-ids for ELFs generated by jitdump.
  63 #
  64 # Define NO_LIBDW_DWARF_UNWIND if you do not want libdw support
  65 # for dwarf backtrace post unwind.
  66 #
  67 # Define NO_PERF_READ_VDSO32 if you do not want to build perf-read-vdso32
  68 # for reading the 32-bit compatibility VDSO in 64-bit mode
  69 #
  70 # Define NO_PERF_READ_VDSOX32 if you do not want to build perf-read-vdsox32
  71 # for reading the x32 mode 32-bit compatibility VDSO in 64-bit mode
  72 #
  73 # Define NO_ZLIB if you do not want to support compressed kernel modules
  74 #
  75 # Define LIBBABELTRACE if you DO want libbabeltrace support
  76 # for CTF data format.
  77 #
  78 # Define NO_LZMA if you do not want to support compressed (xz) kernel modules
  79 #
  80 # Define NO_AUXTRACE if you do not want AUX area tracing support
  81 #
  82 # Define NO_LIBBPF if you do not want BPF support
  83 #
  84 # Define NO_SDT if you do not want to define SDT event in perf tools,
  85 # note that it doesn't disable SDT scanning support.
  86 #
  87 # Define FEATURES_DUMP to provide features detection dump file
  88 # and bypass the feature detection
  89
  90 # As per kernel Makefile, avoid funny character set dependencies
  91 unexport LC_ALL
  92 LC_COLLATE=C
  93 LC_NUMERIC=C
  94 export LC_COLLATE LC_NUMERIC
  95
  96 ifeq ($(srctree),)
  97 srctree := $(patsubst %/,%,$(dir $(shell pwd)))
  98 srctree := $(patsubst %/,%,$(dir $(srctree)))
  99 #$(info Determined 'srctree' to be $(srctree))
 100 endif
 101
 102 ifneq ($(objtree),)
 103 #$(info Determined 'objtree' to be $(objtree))
 104 endif
 105
 106 ifneq ($(OUTPUT),)
 107 #$(info Determined 'OUTPUT' to be $(OUTPUT))
 108 # Adding $(OUTPUT) as a directory to look for source files,
 109 # because use generated output files as sources dependency
 110 # for flex/bison parsers.
 111 VPATH += $(OUTPUT)
 112 export VPATH
 113 endif
 114
 115 ifeq ($(V),1)
 116   Q =
 117 else
 118   Q = @
 119 endif
 120
 121 # Do not use make's built-in rules
 122 # (this improves performance and avoids hard-to-debug behaviour);
 123 MAKEFLAGS += -r
 124
 125 $(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
 126         $(Q)$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
 127         $(Q)touch $(OUTPUT)PERF-VERSION-FILE
 128
 129 # Makefiles suck: This macro sets a default value of $(2) for the
 130 # variable named by $(1), unless the variable has been set by
 131 # environment or command line. This is necessary for CC and AR
 132 # because make sets default values, so the simpler ?= approach
 133 # won't work as expected.
 134 define allow-override
 135   $(if $(or $(findstring environment,$(origin $(1))),\
 136             $(findstring command line,$(origin $(1)))),,\
 137     $(eval $(1) = $(2)))
 138 endef
 139
 140 # Allow setting CC and AR and LD, or setting CROSS_COMPILE as a prefix.
 141 $(call allow-override,CC,$(CROSS_COMPILE)gcc)
 142 $(call allow-override,AR,$(CROSS_COMPILE)ar)
 143 $(call allow-override,LD,$(CROSS_COMPILE)ld)
 144
 145 LD += $(EXTRA_LDFLAGS)
 146
 147 HOSTCC  ?= gcc
 148 HOSTLD  ?= ld
 149 HOSTAR  ?= ar
 150
 151 PKG_CONFIG = $(CROSS_COMPILE)pkg-config
 152
 153 RM      = rm -f
 154 LN      = ln -f
 155 MKDIR   = mkdir
 156 FIND    = find
 157 INSTALL = install
 158 FLEX    = flex
 159 BISON   = bison
 160 STRIP   = strip
 161 AWK     = awk
 162
 163 LIB_DIR         = $(srctree)/tools/lib/api/
 164 TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
 165 BPF_DIR         = $(srctree)/tools/lib/bpf/
 166 SUBCMD_DIR      = $(srctree)/tools/lib/subcmd/
 167
 168 # include Makefile.config by default and rule out
 169 # non-config cases
 170 config := 1
 171
 172 NON_CONFIG_TARGETS := clean TAGS tags cscope help install-doc
 173
 174 ifdef MAKECMDGOALS
 175 ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
 176   config := 0
 177 endif
 178 endif
 179
 180 # The fixdep build - we force fixdep tool to be built as
 181 # the first target in the separate make session not to be
 182 # disturbed by any parallel make jobs. Once fixdep is done
 183 # we issue the requested build with FIXDEP=1 variable.
 184 #
 185 # The fixdep build is disabled for $(NON_CONFIG_TARGETS)
 186 # targets, because it's not necessary.
 187
 188 ifdef FIXDEP
 189   force_fixdep := 0
 190 else
 191   force_fixdep := $(config)
 192 endif
 193
 194 export srctree OUTPUT RM CC CXX LD AR CFLAGS CXXFLAGS V BISON FLEX AWK
 195 export HOSTCC HOSTLD HOSTAR
 196
 197 include $(srctree)/tools/build/Makefile.include
 198
 199 ifeq ($(force_fixdep),1)
 200 goals := $(filter-out all sub-make, $(MAKECMDGOALS))
 201
 202 $(goals) all: sub-make
 203
 204 sub-make: fixdep
 205         @./check-headers.sh
 206         $(Q)$(MAKE) FIXDEP=1 -f Makefile.perf $(goals)
 207
 208 else # force_fixdep
 209
 210 # Set FEATURE_TESTS to 'all' so all possible feature checkers are executed.
 211 # Without this setting the output feature dump file misses some features, for
 212 # example, liberty. Select all checkers so we won't get an incomplete feature
 213 # dump file.
 214 ifeq ($(config),1)
 215 ifdef MAKECMDGOALS
 216 ifeq ($(filter feature-dump,$(MAKECMDGOALS)),feature-dump)
 217 FEATURE_TESTS := all
 218 endif
 219 endif
 220 include Makefile.config
 221 endif
 222
 223 ifeq ($(config),0)
 224 include $(srctree)/tools/scripts/Makefile.arch
 225 -include arch/$(SRCARCH)/Makefile
 226 endif
 227
 228 # The FEATURE_DUMP_EXPORT holds location of the actual
 229 # FEATURE_DUMP file to be used to bypass feature detection
 230 # (for bpf or any other subproject)
 231 ifeq ($(FEATURES_DUMP),)
 232 FEATURE_DUMP_EXPORT := $(realpath $(OUTPUT)FEATURE-DUMP)
 233 else
 234 FEATURE_DUMP_EXPORT := $(FEATURES_DUMP)
 235 endif
 236
 237 export prefix bindir sharedir sysconfdir DESTDIR
 238
 239 # sparse is architecture-neutral, which means that we need to tell it
 240 # explicitly what architecture to check for. Fix this up for yours..
 241 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
 242
 243 # Guard against environment variables
 244 PYRF_OBJS =
 245 SCRIPT_SH =
 246
 247 SCRIPT_SH += perf-archive.sh
 248 SCRIPT_SH += perf-with-kcore.sh
 249
 250 grep-libs = $(filter -l%,$(1))
 251 strip-libs = $(filter-out -l%,$(1))
 252
 253 ifneq ($(OUTPUT),)
 254   TE_PATH=$(OUTPUT)
 255   BPF_PATH=$(OUTPUT)
 256   SUBCMD_PATH=$(OUTPUT)
 257 ifneq ($(subdir),)
 258   API_PATH=$(OUTPUT)/../lib/api/
 259 else
 260   API_PATH=$(OUTPUT)
 261 endif
 262 else
 263   TE_PATH=$(TRACE_EVENT_DIR)
 264   API_PATH=$(LIB_DIR)
 265   BPF_PATH=$(BPF_DIR)
 266   SUBCMD_PATH=$(SUBCMD_DIR)
 267 endif
 268
 269 LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
 270 export LIBTRACEEVENT
 271
 272 LIBTRACEEVENT_DYNAMIC_LIST = $(TE_PATH)libtraceevent-dynamic-list
 273 LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS = -Xlinker --dynamic-list=$(LIBTRACEEVENT_DYNAMIC_LIST)
 274
 275 LIBAPI = $(API_PATH)libapi.a
 276 export LIBAPI
 277
 278 LIBBPF = $(BPF_PATH)libbpf.a
 279
 280 LIBSUBCMD = $(SUBCMD_PATH)libsubcmd.a
 281
 282 # python extension build directories
 283 PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
 284 PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
 285 PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
 286 export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
 287
 288 python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf.so
 289
 290 PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
 291 PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPI)
 292
 293 $(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS) $(LIBTRACEEVENT_DYNAMIC_LIST)
 294         $(QUIET_GEN)LDSHARED="$(CC) -pthread -shared" \
 295         CFLAGS='$(CFLAGS)' LDFLAGS='$(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS)' \
 296           $(PYTHON_WORD) util/setup.py \
 297           --quiet build_ext; \
 298         mkdir -p $(OUTPUT)python && \
 299         cp $(PYTHON_EXTBUILD_LIB)perf.so $(OUTPUT)python/
 300 #
 301 # No Perl scripts right now:
 302 #
 303
 304 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
 305
 306 PROGRAMS += $(OUTPUT)perf
 307
 308 ifndef NO_PERF_READ_VDSO32
 309 PROGRAMS += $(OUTPUT)perf-read-vdso32
 310 endif
 311
 312 ifndef NO_PERF_READ_VDSOX32
 313 PROGRAMS += $(OUTPUT)perf-read-vdsox32
 314 endif
 315
 316 # what 'all' will build and 'install' will install, in perfexecdir
 317 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
 318
 319 # what 'all' will build but not install in perfexecdir
 320 OTHER_PROGRAMS = $(OUTPUT)perf
 321
 322 # Set paths to tools early so that they can be used for version tests.
 323 ifndef SHELL_PATH
 324   SHELL_PATH = /bin/sh
 325 endif
 326 ifndef PERL_PATH
 327   PERL_PATH = /usr/bin/perl
 328 endif
 329
 330 export PERL_PATH
 331
 332 LIB_FILE=$(OUTPUT)libperf.a
 333
 334 PERFLIBS = $(LIB_FILE) $(LIBAPI) $(LIBTRACEEVENT) $(LIBSUBCMD)
 335 ifndef NO_LIBBPF
 336   PERFLIBS += $(LIBBPF)
 337 endif
 338
 339 # We choose to avoid "if .. else if .. else .. endif endif"
 340 # because maintaining the nesting to match is a pain.  If
 341 # we had "elif" things would have been much nicer...
 342
 343 ifneq ($(OUTPUT),)
 344   CFLAGS += -I$(OUTPUT)
 345 endif
 346
 347 ifndef NO_GTK2
 348   ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
 349   GTK_IN := $(OUTPUT)gtk-in.o
 350
 351 install-gtk: $(OUTPUT)libperf-gtk.so
 352         $(call QUIET_INSTALL, 'GTK UI') \
 353                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
 354                 $(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
 355 endif
 356
 357 ifdef ASCIIDOC8
 358   export ASCIIDOC8
 359 endif
 360
 361 LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
 362
 363 export INSTALL SHELL_PATH
 364
 365 ### Build rules
 366
 367 SHELL = $(SHELL_PATH)
 368
 369 all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
 370
 371 please_set_SHELL_PATH_to_a_more_modern_shell:
 372         $(Q)$$(:)
 373
 374 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
 375
 376 strip: $(PROGRAMS) $(OUTPUT)perf
 377         $(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
 378
 379 PERF_IN := $(OUTPUT)perf-in.o
 380
 381 JEVENTS       := $(OUTPUT)pmu-events/jevents
 382 JEVENTS_IN    := $(OUTPUT)pmu-events/jevents-in.o
 383
 384 PMU_EVENTS_IN := $(OUTPUT)pmu-events/pmu-events-in.o
 385
 386 export JEVENTS
 387
 388 build := -f $(srctree)/tools/build/Makefile.build dir=. obj
 389
 390 $(PERF_IN): prepare FORCE
 391         $(Q)$(MAKE) $(build)=perf
 392
 393 $(JEVENTS_IN): FORCE
 394         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=jevents
 395
 396 $(JEVENTS): $(JEVENTS_IN)
 397         $(QUIET_LINK)$(HOSTCC) $(JEVENTS_IN) -o $@
 398
 399 $(PMU_EVENTS_IN): $(JEVENTS) FORCE
 400         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=pmu-events obj=pmu-events
 401
 402 $(OUTPUT)perf: $(PERFLIBS) $(PERF_IN) $(PMU_EVENTS_IN) $(LIBTRACEEVENT_DYNAMIC_LIST)
 403         $(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(LIBTRACEEVENT_DYNAMIC_LIST_LDFLAGS) \
 404                 $(PERF_IN) $(PMU_EVENTS_IN) $(LIBS) -o $@
 405
 406 $(GTK_IN): FORCE
 407         $(Q)$(MAKE) $(build)=gtk
 408
 409 $(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
 410         $(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
 411
 412 $(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
 413
 414 $(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
 415         $(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
 416
 417 $(SCRIPTS) : % : %.sh
 418         $(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
 419
 420 # These can record PERF_VERSION
 421 perf.spec $(SCRIPTS) \
 422         : $(OUTPUT)PERF-VERSION-FILE
 423
 424 .SUFFIXES:
 425
 426 #
 427 # If a target does not match any of the later rules then prefix it by $(OUTPUT)
 428 # This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
 429 #
 430 ifneq ($(OUTPUT),)
 431 %.o: $(OUTPUT)%.o
 432         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 433 pmu-events/%.o: $(OUTPUT)pmu-events/%.o
 434         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 435 util/%.o: $(OUTPUT)util/%.o
 436         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 437 bench/%.o: $(OUTPUT)bench/%.o
 438         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 439 tests/%.o: $(OUTPUT)tests/%.o
 440         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 441 endif
 442
 443 # These two need to be here so that when O= is not used they take precedence
 444 # over the general rule for .o
 445
 446 # get relative building directory (to $(OUTPUT))
 447 # and '.' if it's $(OUTPUT) itself
 448 __build-dir = $(subst $(OUTPUT),,$(dir $@))
 449 build-dir   = $(if $(__build-dir),$(__build-dir),.)
 450
 451 prepare: $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h archheaders
 452
 453 $(OUTPUT)%.o: %.c prepare FORCE
 454         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 455
 456 $(OUTPUT)%.i: %.c prepare FORCE
 457         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 458
 459 $(OUTPUT)%.s: %.c prepare FORCE
 460         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 461
 462 $(OUTPUT)%-bison.o: %.c prepare FORCE
 463         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 464
 465 $(OUTPUT)%-flex.o: %.c prepare FORCE
 466         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 467
 468 $(OUTPUT)%.o: %.S prepare FORCE
 469         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 470
 471 $(OUTPUT)%.i: %.S prepare FORCE
 472         $(Q)$(MAKE) -f $(srctree)/tools/build/Makefile.build dir=$(build-dir) $@
 473
 474 $(OUTPUT)perf-%: %.o $(PERFLIBS)
 475         $(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
 476
 477 ifndef NO_PERF_READ_VDSO32
 478 $(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
 479         $(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
 480 endif
 481
 482 ifndef NO_PERF_READ_VDSOX32
 483 $(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
 484         $(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
 485 endif
 486
 487 $(patsubst perf-%,%.o,$(PROGRAMS)): $(wildcard */*.h)
 488
 489 LIBPERF_IN := $(OUTPUT)libperf-in.o
 490
 491 $(LIBPERF_IN): prepare FORCE
 492         $(Q)$(MAKE) $(build)=libperf
 493
 494 $(LIB_FILE): $(LIBPERF_IN)
 495         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
 496
 497 LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ)
 498
 499 $(LIBTRACEEVENT): FORCE
 500         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent.a
 501
 502 libtraceevent_plugins: FORCE
 503         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) plugins
 504
 505 $(LIBTRACEEVENT_DYNAMIC_LIST): libtraceevent_plugins
 506         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) $(OUTPUT)libtraceevent-dynamic-list
 507
 508 $(LIBTRACEEVENT)-clean:
 509         $(call QUIET_CLEAN, libtraceevent)
 510         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
 511
 512 install-traceevent-plugins: libtraceevent_plugins
 513         $(Q)$(MAKE) -C $(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) O=$(OUTPUT) install_plugins
 514
 515 $(LIBAPI): FORCE
 516         $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) $(OUTPUT)libapi.a
 517
 518 $(LIBAPI)-clean:
 519         $(call QUIET_CLEAN, libapi)
 520         $(Q)$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
 521
 522 $(LIBBPF): FORCE
 523         $(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) $(OUTPUT)libbpf.a FEATURES_DUMP=$(FEATURE_DUMP_EXPORT)
 524
 525 $(LIBBPF)-clean:
 526         $(call QUIET_CLEAN, libbpf)
 527         $(Q)$(MAKE) -C $(BPF_DIR) O=$(OUTPUT) clean >/dev/null
 528
 529 $(LIBSUBCMD): FORCE
 530         $(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) $(OUTPUT)libsubcmd.a
 531
 532 $(LIBSUBCMD)-clean:
 533         $(call QUIET_CLEAN, libsubcmd)
 534         $(Q)$(MAKE) -C $(SUBCMD_DIR) O=$(OUTPUT) clean
 535
 536 help:
 537         @echo 'Perf make targets:'
 538         @echo '  doc            - make *all* documentation (see below)'
 539         @echo '  man            - make manpage documentation (access with man <foo>)'
 540         @echo '  html           - make html documentation'
 541         @echo '  info           - make GNU info documentation (access with info <foo>)'
 542         @echo '  pdf            - make pdf documentation'
 543         @echo '  TAGS           - use etags to make tag information for source browsing'
 544         @echo '  tags           - use ctags to make tag information for source browsing'
 545         @echo '  cscope - use cscope to make interactive browsing database'
 546         @echo ''
 547         @echo 'Perf install targets:'
 548         @echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
 549         @echo '  HINT: use "prefix" or "DESTDIR" to install to a particular'
 550         @echo '        path like "make prefix=/usr/local install install-doc"'
 551         @echo '  install        - install compiled binaries'
 552         @echo '  install-doc    - install *all* documentation'
 553         @echo '  install-man    - install manpage documentation'
 554         @echo '  install-html   - install html documentation'
 555         @echo '  install-info   - install GNU info documentation'
 556         @echo '  install-pdf    - install pdf documentation'
 557         @echo ''
 558         @echo '  quick-install-doc      - alias for quick-install-man'
 559         @echo '  quick-install-man      - install the documentation quickly'
 560         @echo '  quick-install-html     - install the html documentation quickly'
 561         @echo ''
 562         @echo 'Perf maintainer targets:'
 563         @echo '  clean                  - clean all binary objects and build output'
 564
 565
 566 DOC_TARGETS := doc man html info pdf
 567
 568 INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
 569 INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
 570
 571 # 'make doc' should call 'make -C Documentation all'
 572 $(DOC_TARGETS):
 573         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
 574
 575 TAG_FOLDERS= . ../lib ../include
 576 TAG_FILES= ../../include/uapi/linux/perf_event.h
 577
 578 TAGS:
 579         $(QUIET_GEN)$(RM) TAGS; \
 580         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs etags -a $(TAG_FILES)
 581
 582 tags:
 583         $(QUIET_GEN)$(RM) tags; \
 584         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs ctags -a $(TAG_FILES)
 585
 586 cscope:
 587         $(QUIET_GEN)$(RM) cscope*; \
 588         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs cscope -b $(TAG_FILES)
 589
 590 ### Testing rules
 591
 592 # GNU make supports exporting all variables by "export" without parameters.
 593 # However, the environment gets quite big, and some programs have problems
 594 # with that.
 595
 596 check: $(OUTPUT)common-cmds.h
 597         if sparse; \
 598         then \
 599                 for i in *.c */*.c; \
 600                 do \
 601                         sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
 602                 done; \
 603         else \
 604                 exit 1; \
 605         fi
 606
 607 ### Installation rules
 608
 609 install-gtk:
 610
 611 install-tools: all install-gtk
 612         $(call QUIET_INSTALL, binaries) \
 613                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
 614                 $(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
 615                 $(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
 616 ifndef NO_PERF_READ_VDSO32
 617         $(call QUIET_INSTALL, perf-read-vdso32) \
 618                 $(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
 619 endif
 620 ifndef NO_PERF_READ_VDSOX32
 621         $(call QUIET_INSTALL, perf-read-vdsox32) \
 622                 $(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
 623 endif
 624         $(call QUIET_INSTALL, libexec) \
 625                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 626         $(call QUIET_INSTALL, perf-archive) \
 627                 $(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 628         $(call QUIET_INSTALL, perf-with-kcore) \
 629                 $(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 630 ifndef NO_LIBAUDIT
 631         $(call QUIET_INSTALL, strace/groups) \
 632                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'; \
 633                 $(INSTALL) trace/strace/groups/* -t '$(DESTDIR_SQ)$(STRACE_GROUPS_INSTDIR_SQ)'
 634 endif
 635 ifndef NO_LIBPERL
 636         $(call QUIET_INSTALL, perl-scripts) \
 637                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
 638                 $(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
 639                 $(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
 640                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
 641                 $(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
 642 endif
 643 ifndef NO_LIBPYTHON
 644         $(call QUIET_INSTALL, python-scripts) \
 645                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
 646                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
 647                 $(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
 648                 $(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
 649                 $(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
 650 endif
 651         $(call QUIET_INSTALL, perf_completion-script) \
 652                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
 653                 $(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
 654         $(call QUIET_INSTALL, perf-tip) \
 655                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(tip_instdir_SQ)'; \
 656                 $(INSTALL) Documentation/tips.txt -t '$(DESTDIR_SQ)$(tip_instdir_SQ)'
 657
 658 install-tests: all install-gtk
 659         $(call QUIET_INSTALL, tests) \
 660                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
 661                 $(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
 662                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
 663                 $(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'
 664
 665 install-bin: install-tools install-tests install-traceevent-plugins
 666
 667 install: install-bin try-install-man
 668
 669 install-python_ext:
 670         $(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
 671
 672 # 'make install-doc' should call 'make -C Documentation install'
 673 $(INSTALL_DOC_TARGETS):
 674         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
 675
 676 ### Cleaning rules
 677
 678 #
 679 # This is here, not in Makefile.config, because Makefile.config does
 680 # not get included for the clean target:
 681 #
 682 config-clean:
 683         $(call QUIET_CLEAN, config)
 684         $(Q)$(MAKE) -C $(srctree)/tools/build/feature/ $(if $(OUTPUT),OUTPUT=$(OUTPUT)feature/,) clean >/dev/null
 685
 686 clean:: $(LIBTRACEEVENT)-clean $(LIBAPI)-clean $(LIBBPF)-clean $(LIBSUBCMD)-clean config-clean
 687         $(call QUIET_CLEAN, core-objs)  $(RM) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(LANG_BINDINGS)
 688         $(Q)find $(if $(OUTPUT),$(OUTPUT),.) -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
 689         $(Q)$(RM) $(OUTPUT).config-detected
 690         $(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32 $(OUTPUT)pmu-events/jevents
 691         $(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* \
 692                 $(OUTPUT)util/intel-pt-decoder/inat-tables.c $(OUTPUT)fixdep \
 693                 $(OUTPUT)tests/llvm-src-{base,kbuild,prologue,relocation}.c \
 694                 $(OUTPUT)pmu-events/pmu-events.c
 695         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
 696         $(python-clean)
 697
 698 #
 699 # To provide FEATURE-DUMP into $(FEATURE_DUMP_COPY)
 700 # file if defined, with no further action.
 701 feature-dump:
 702 ifdef FEATURE_DUMP_COPY
 703         @cp $(OUTPUT)FEATURE-DUMP $(FEATURE_DUMP_COPY)
 704         @echo "FEATURE-DUMP file copied into $(FEATURE_DUMP_COPY)"
 705 else
 706         @echo "FEATURE-DUMP file available in $(OUTPUT)FEATURE-DUMP"
 707 endif
 708
 709 #
 710 # Trick: if ../../.git does not exist - we are building out of tree for example,
 711 # then force version regeneration:
 712 #
 713 ifeq ($(wildcard ../../.git/HEAD),)
 714     GIT-HEAD-PHONY = ../../.git/HEAD
 715 else
 716     GIT-HEAD-PHONY =
 717 endif
 718
 719 FORCE:
 720
 721 .PHONY: all install clean config-clean strip install-gtk
 722 .PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
 723 .PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope FORCE prepare
 724 .PHONY: libtraceevent_plugins archheaders
 725
 726 endif # force_fixdep