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
  73 ifeq ($(srctree),)
  74 srctree := $(patsubst %/,%,$(dir $(shell pwd)))
  75 srctree := $(patsubst %/,%,$(dir $(srctree)))
  76 #$(info Determined 'srctree' to be $(srctree))
  77 endif
  78
  79 ifneq ($(objtree),)
  80 #$(info Determined 'objtree' to be $(objtree))
  81 endif
  82
  83 ifneq ($(OUTPUT),)
  84 #$(info Determined 'OUTPUT' to be $(OUTPUT))
  85 # Adding $(OUTPUT) as a directory to look for source files,
  86 # because use generated output files as sources dependency
  87 # for flex/bison parsers.
  88 VPATH += $(OUTPUT)
  89 export VPATH
  90 endif
  91
  92 # Do not use make's built-in rules
  93 # (this improves performance and avoids hard-to-debug behaviour);
  94 MAKEFLAGS += -r
  95
  96 $(OUTPUT)PERF-VERSION-FILE: ../../.git/HEAD
  97         @$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
  98         @touch $(OUTPUT)PERF-VERSION-FILE
  99
 100 CC = $(CROSS_COMPILE)gcc
 101 LD = $(CROSS_COMPILE)ld
 102 AR = $(CROSS_COMPILE)ar
 103 PKG_CONFIG = $(CROSS_COMPILE)pkg-config
 104
 105 RM      = rm -f
 106 LN      = ln -f
 107 MKDIR   = mkdir
 108 FIND    = find
 109 INSTALL = install
 110 FLEX    = flex
 111 BISON   = bison
 112 STRIP   = strip
 113
 114 LIB_DIR          = $(srctree)/tools/lib/api/
 115 TRACE_EVENT_DIR = $(srctree)/tools/lib/traceevent/
 116
 117 # include config/Makefile by default and rule out
 118 # non-config cases
 119 config := 1
 120
 121 NON_CONFIG_TARGETS := clean TAGS tags cscope help
 122
 123 ifdef MAKECMDGOALS
 124 ifeq ($(filter-out $(NON_CONFIG_TARGETS),$(MAKECMDGOALS)),)
 125   config := 0
 126 endif
 127 endif
 128
 129 ifeq ($(config),1)
 130 include config/Makefile
 131 endif
 132
 133 export prefix bindir sharedir sysconfdir DESTDIR
 134
 135 # sparse is architecture-neutral, which means that we need to tell it
 136 # explicitly what architecture to check for. Fix this up for yours..
 137 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
 138
 139 # Guard against environment variables
 140 BUILTIN_OBJS =
 141 LIB_H =
 142 LIB_OBJS =
 143 GTK_OBJS =
 144 PYRF_OBJS =
 145 SCRIPT_SH =
 146
 147 SCRIPT_SH += perf-archive.sh
 148 SCRIPT_SH += perf-with-kcore.sh
 149
 150 grep-libs = $(filter -l%,$(1))
 151 strip-libs = $(filter-out -l%,$(1))
 152
 153 ifneq ($(OUTPUT),)
 154   TE_PATH=$(OUTPUT)
 155 ifneq ($(subdir),)
 156   LIB_PATH=$(OUTPUT)/../lib/api/
 157 else
 158   LIB_PATH=$(OUTPUT)
 159 endif
 160 else
 161   TE_PATH=$(TRACE_EVENT_DIR)
 162   LIB_PATH=$(LIB_DIR)
 163 endif
 164
 165 LIBTRACEEVENT = $(TE_PATH)libtraceevent.a
 166 export LIBTRACEEVENT
 167
 168 LIBAPIKFS = $(LIB_PATH)libapikfs.a
 169 export LIBAPIKFS
 170
 171 # python extension build directories
 172 PYTHON_EXTBUILD     := $(OUTPUT)python_ext_build/
 173 PYTHON_EXTBUILD_LIB := $(PYTHON_EXTBUILD)lib/
 174 PYTHON_EXTBUILD_TMP := $(PYTHON_EXTBUILD)tmp/
 175 export PYTHON_EXTBUILD_LIB PYTHON_EXTBUILD_TMP
 176
 177 python-clean := $(call QUIET_CLEAN, python) $(RM) -r $(PYTHON_EXTBUILD) $(OUTPUT)python/perf.so
 178
 179 PYTHON_EXT_SRCS := $(shell grep -v ^\# util/python-ext-sources)
 180 PYTHON_EXT_DEPS := util/python-ext-sources util/setup.py $(LIBTRACEEVENT) $(LIBAPIKFS)
 181
 182 $(OUTPUT)python/perf.so: $(PYTHON_EXT_SRCS) $(PYTHON_EXT_DEPS)
 183         $(QUIET_GEN)CFLAGS='$(CFLAGS)' $(PYTHON_WORD) util/setup.py \
 184           --quiet build_ext; \
 185         mkdir -p $(OUTPUT)python && \
 186         cp $(PYTHON_EXTBUILD_LIB)perf.so $(OUTPUT)python/
 187 #
 188 # No Perl scripts right now:
 189 #
 190
 191 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
 192
 193 PROGRAMS += $(OUTPUT)perf
 194
 195 ifndef NO_PERF_READ_VDSO32
 196 PROGRAMS += $(OUTPUT)perf-read-vdso32
 197 endif
 198
 199 ifndef NO_PERF_READ_VDSOX32
 200 PROGRAMS += $(OUTPUT)perf-read-vdsox32
 201 endif
 202
 203 # what 'all' will build and 'install' will install, in perfexecdir
 204 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
 205
 206 # what 'all' will build but not install in perfexecdir
 207 OTHER_PROGRAMS = $(OUTPUT)perf
 208
 209 # Set paths to tools early so that they can be used for version tests.
 210 ifndef SHELL_PATH
 211   SHELL_PATH = /bin/sh
 212 endif
 213 ifndef PERL_PATH
 214   PERL_PATH = /usr/bin/perl
 215 endif
 216
 217 export PERL_PATH
 218
 219 LIB_FILE=$(OUTPUT)libperf.a
 220
 221 LIB_H += ../lib/symbol/kallsyms.h
 222 LIB_H += ../../include/uapi/linux/perf_event.h
 223 LIB_H += ../../include/linux/rbtree.h
 224 LIB_H += ../../include/linux/list.h
 225 LIB_H += ../../include/uapi/linux/const.h
 226 LIB_H += ../include/linux/hash.h
 227 LIB_H += ../../include/linux/stringify.h
 228 LIB_H += util/include/linux/bitmap.h
 229 LIB_H += ../include/linux/bitops.h
 230 LIB_H += ../include/asm-generic/bitops/arch_hweight.h
 231 LIB_H += ../include/asm-generic/bitops/atomic.h
 232 LIB_H += ../include/asm-generic/bitops/const_hweight.h
 233 LIB_H += ../include/asm-generic/bitops/find.h
 234 LIB_H += ../include/asm-generic/bitops/fls64.h
 235 LIB_H += ../include/asm-generic/bitops/fls.h
 236 LIB_H += ../include/asm-generic/bitops/__ffs.h
 237 LIB_H += ../include/asm-generic/bitops/__fls.h
 238 LIB_H += ../include/asm-generic/bitops/hweight.h
 239 LIB_H += ../include/asm-generic/bitops.h
 240 LIB_H += ../include/linux/compiler.h
 241 LIB_H += ../include/linux/log2.h
 242 LIB_H += util/include/linux/const.h
 243 LIB_H += util/include/linux/ctype.h
 244 LIB_H += util/include/linux/kernel.h
 245 LIB_H += util/include/linux/list.h
 246 LIB_H += ../include/linux/export.h
 247 LIB_H += util/include/linux/poison.h
 248 LIB_H += util/include/linux/rbtree.h
 249 LIB_H += util/include/linux/rbtree_augmented.h
 250 LIB_H += util/include/linux/string.h
 251 LIB_H += ../include/linux/types.h
 252 LIB_H += util/include/linux/linkage.h
 253 LIB_H += util/include/asm/asm-offsets.h
 254 LIB_H += ../include/asm/bug.h
 255 LIB_H += util/include/asm/byteorder.h
 256 LIB_H += util/include/asm/swab.h
 257 LIB_H += util/include/asm/system.h
 258 LIB_H += util/include/asm/uaccess.h
 259 LIB_H += util/include/dwarf-regs.h
 260 LIB_H += util/include/asm/dwarf2.h
 261 LIB_H += util/include/asm/cpufeature.h
 262 LIB_H += util/include/asm/unistd_32.h
 263 LIB_H += util/include/asm/unistd_64.h
 264 LIB_H += perf.h
 265 LIB_H += util/annotate.h
 266 LIB_H += util/cache.h
 267 LIB_H += util/callchain.h
 268 LIB_H += util/build-id.h
 269 LIB_H += util/db-export.h
 270 LIB_H += util/debug.h
 271 LIB_H += util/pmu.h
 272 LIB_H += util/event.h
 273 LIB_H += util/evsel.h
 274 LIB_H += util/evlist.h
 275 LIB_H += util/exec_cmd.h
 276 LIB_H += util/find-vdso-map.c
 277 LIB_H += util/levenshtein.h
 278 LIB_H += util/machine.h
 279 LIB_H += util/map.h
 280 LIB_H += util/parse-options.h
 281 LIB_H += util/parse-events.h
 282 LIB_H += util/quote.h
 283 LIB_H += util/util.h
 284 LIB_H += util/xyarray.h
 285 LIB_H += util/header.h
 286 LIB_H += util/help.h
 287 LIB_H += util/session.h
 288 LIB_H += util/ordered-events.h
 289 LIB_H += util/strbuf.h
 290 LIB_H += util/strlist.h
 291 LIB_H += util/strfilter.h
 292 LIB_H += util/svghelper.h
 293 LIB_H += util/tool.h
 294 LIB_H += util/run-command.h
 295 LIB_H += util/sigchain.h
 296 LIB_H += util/dso.h
 297 LIB_H += util/symbol.h
 298 LIB_H += util/color.h
 299 LIB_H += util/values.h
 300 LIB_H += util/sort.h
 301 LIB_H += util/hist.h
 302 LIB_H += util/comm.h
 303 LIB_H += util/thread.h
 304 LIB_H += util/thread_map.h
 305 LIB_H += util/trace-event.h
 306 LIB_H += util/probe-finder.h
 307 LIB_H += util/dwarf-aux.h
 308 LIB_H += util/probe-event.h
 309 LIB_H += util/pstack.h
 310 LIB_H += util/cpumap.h
 311 LIB_H += util/top.h
 312 LIB_H += $(ARCH_INCLUDE)
 313 LIB_H += util/cgroup.h
 314 LIB_H += $(LIB_INCLUDE)traceevent/event-parse.h
 315 LIB_H += util/target.h
 316 LIB_H += util/rblist.h
 317 LIB_H += util/intlist.h
 318 LIB_H += util/perf_regs.h
 319 LIB_H += util/unwind.h
 320 LIB_H += util/vdso.h
 321 LIB_H += util/tsc.h
 322 LIB_H += ui/helpline.h
 323 LIB_H += ui/progress.h
 324 LIB_H += ui/util.h
 325 LIB_H += ui/ui.h
 326 LIB_H += util/data.h
 327 LIB_H += util/kvm-stat.h
 328 LIB_H += util/thread-stack.h
 329
 330 PERFLIBS = $(LIB_FILE) $(LIBAPIKFS) $(LIBTRACEEVENT)
 331
 332 # We choose to avoid "if .. else if .. else .. endif endif"
 333 # because maintaining the nesting to match is a pain.  If
 334 # we had "elif" things would have been much nicer...
 335
 336 -include arch/$(ARCH)/Makefile
 337
 338 ifneq ($(OUTPUT),)
 339   CFLAGS += -I$(OUTPUT)
 340 endif
 341
 342 ifndef NO_GTK2
 343   ALL_PROGRAMS += $(OUTPUT)libperf-gtk.so
 344   GTK_IN := $(OUTPUT)gtk-in.o
 345
 346 install-gtk: $(OUTPUT)libperf-gtk.so
 347         $(call QUIET_INSTALL, 'GTK UI') \
 348                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(libdir_SQ)'; \
 349                 $(INSTALL) $(OUTPUT)libperf-gtk.so '$(DESTDIR_SQ)$(libdir_SQ)'
 350 endif
 351
 352 ifdef ASCIIDOC8
 353   export ASCIIDOC8
 354 endif
 355
 356 LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive -Wl,--start-group $(EXTLIBS) -Wl,--end-group
 357
 358 export INSTALL SHELL_PATH
 359
 360 ### Build rules
 361
 362 SHELL = $(SHELL_PATH)
 363
 364 all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
 365
 366 please_set_SHELL_PATH_to_a_more_modern_shell:
 367         @$$(:)
 368
 369 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
 370
 371 strip: $(PROGRAMS) $(OUTPUT)perf
 372         $(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
 373
 374 PERF_IN := $(OUTPUT)perf-in.o
 375
 376 export srctree OUTPUT RM CC LD AR CFLAGS V BISON FLEX
 377 build := -f $(srctree)/tools/build/Makefile.build dir=. obj
 378
 379 $(PERF_IN): $(OUTPUT)common-cmds.h FORCE
 380         @$(MAKE) $(build)=perf
 381
 382 $(OUTPUT)perf.o: perf.c $(OUTPUT)common-cmds.h $(OUTPUT)PERF-CFLAGS
 383         $(QUIET_CC)$(CC) -include $(OUTPUT)PERF-VERSION-FILE \
 384                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
 385                 $(CFLAGS) -c $(filter %.c,$^) -o $@
 386
 387 $(OUTPUT)perf: $(OUTPUT)perf.o $(BUILTIN_OBJS) $(PERFLIBS) $(PERF_IN)
 388         $(QUIET_LINK)$(CC) $(CFLAGS) $(LDFLAGS) $(OUTPUT)perf.o \
 389                $(BUILTIN_OBJS) $(PERF_IN) $(LIBS) -o $@
 390
 391 $(GTK_IN): FORCE
 392         @$(MAKE) $(build)=gtk
 393
 394 $(OUTPUT)libperf-gtk.so: $(GTK_IN) $(PERFLIBS)
 395         $(QUIET_LINK)$(CC) -o $@ -shared $(LDFLAGS) $(filter %.o,$^) $(GTK_LIBS)
 396
 397 $(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
 398
 399 $(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
 400         $(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
 401
 402 $(SCRIPTS) : % : %.sh
 403         $(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
 404
 405 # These can record PERF_VERSION
 406 $(OUTPUT)perf.o perf.spec \
 407         $(SCRIPTS) \
 408         : $(OUTPUT)PERF-VERSION-FILE
 409
 410 .SUFFIXES:
 411
 412 #
 413 # If a target does not match any of the later rules then prefix it by $(OUTPUT)
 414 # This makes targets like 'make O=/tmp/perf perf.o' work in a natural way.
 415 #
 416 ifneq ($(OUTPUT),)
 417 %.o: $(OUTPUT)%.o
 418         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 419 util/%.o: $(OUTPUT)util/%.o
 420         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 421 bench/%.o: $(OUTPUT)bench/%.o
 422         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 423 tests/%.o: $(OUTPUT)tests/%.o
 424         @echo "    # Redirected target $@ => $(OUTPUT)$@"
 425 endif
 426
 427 # These two need to be here so that when O= is not used they take precedence
 428 # over the general rule for .o
 429
 430 $(OUTPUT)%.o: %.c $(OUTPUT)PERF-CFLAGS
 431         $(QUIET_CC)$(CC) -o $@ -c $(CFLAGS) $<
 432 $(OUTPUT)%.i: %.c $(OUTPUT)PERF-CFLAGS
 433         $(QUIET_CC)$(CC) -o $@ -E $(CFLAGS) $<
 434 $(OUTPUT)%.s: %.c $(OUTPUT)PERF-CFLAGS
 435         $(QUIET_CC)$(CC) -o $@ -S $(CFLAGS) $<
 436 $(OUTPUT)%.o: %.S
 437         $(QUIET_CC)$(CC) -o $@ -c $(CFLAGS) $<
 438 $(OUTPUT)%.s: %.S
 439         $(QUIET_CC)$(CC) -o $@ -E $(CFLAGS) $<
 440
 441 $(OUTPUT)perf-%: %.o $(PERFLIBS)
 442         $(QUIET_LINK)$(CC) $(CFLAGS) -o $@ $(LDFLAGS) $(filter %.o,$^) $(LIBS)
 443
 444 ifndef NO_PERF_READ_VDSO32
 445 $(OUTPUT)perf-read-vdso32: perf-read-vdso.c util/find-vdso-map.c
 446         $(QUIET_CC)$(CC) -m32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
 447 endif
 448
 449 ifndef NO_PERF_READ_VDSOX32
 450 $(OUTPUT)perf-read-vdsox32: perf-read-vdso.c util/find-vdso-map.c
 451         $(QUIET_CC)$(CC) -mx32 $(filter -static,$(LDFLAGS)) -Wall -Werror -o $@ perf-read-vdso.c
 452 endif
 453
 454 $(LIB_OBJS) $(BUILTIN_OBJS): $(LIB_H)
 455 $(patsubst perf-%,%.o,$(PROGRAMS)): $(LIB_H) $(wildcard */*.h)
 456
 457 # we compile into subdirectories. if the target directory is not the source directory, they might not exists. So
 458 # we depend the various files onto their directories.
 459 DIRECTORY_DEPS = $(LIB_OBJS) $(BUILTIN_OBJS) $(GTK_OBJS)
 460 DIRECTORY_DEPS += $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h
 461 # no need to add flex objects, because they depend on bison ones
 462 DIRECTORY_DEPS += $(OUTPUT)util/parse-events-bison.c
 463 DIRECTORY_DEPS += $(OUTPUT)util/pmu-bison.c
 464
 465 OUTPUT_DIRECTORIES := $(sort $(dir $(DIRECTORY_DEPS)))
 466
 467 $(DIRECTORY_DEPS): | $(OUTPUT_DIRECTORIES)
 468 # In the second step, we make a rule to actually create these directories
 469 $(OUTPUT_DIRECTORIES):
 470         $(QUIET_MKDIR)$(MKDIR) -p $@ 2>/dev/null
 471
 472 LIBPERF_IN := $(OUTPUT)libperf-in.o
 473
 474 $(LIBPERF_IN): FORCE
 475         @$(MAKE) $(build)=libperf
 476
 477 $(LIB_FILE): $(LIB_OBJS) $(LIBPERF_IN)
 478         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIBPERF_IN) $(LIB_OBJS)
 479
 480 # libtraceevent.a
 481 TE_SOURCES = $(wildcard $(TRACE_EVENT_DIR)*.[ch])
 482
 483 LIBTRACEEVENT_FLAGS  = $(QUIET_SUBDIR1) O=$(OUTPUT)
 484 LIBTRACEEVENT_FLAGS += CFLAGS="-g -Wall $(EXTRA_CFLAGS)"
 485 LIBTRACEEVENT_FLAGS += plugin_dir=$(plugindir_SQ)
 486
 487 $(LIBTRACEEVENT): $(TE_SOURCES) $(OUTPUT)PERF-CFLAGS
 488         $(QUIET_SUBDIR0)$(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) libtraceevent.a plugins
 489
 490 $(LIBTRACEEVENT)-clean:
 491         $(call QUIET_CLEAN, libtraceevent)
 492         @$(MAKE) -C $(TRACE_EVENT_DIR) O=$(OUTPUT) clean >/dev/null
 493
 494 install-traceevent-plugins: $(LIBTRACEEVENT)
 495         $(QUIET_SUBDIR0)$(TRACE_EVENT_DIR) $(LIBTRACEEVENT_FLAGS) install_plugins
 496
 497 LIBAPIKFS_SOURCES = $(wildcard $(LIB_PATH)fs/*.[ch] $(LIB_PATH)fd/*.[ch])
 498
 499 # if subdir is set, we've been called from above so target has been built
 500 # already
 501 $(LIBAPIKFS): $(LIBAPIKFS_SOURCES)
 502 ifeq ($(subdir),)
 503         $(QUIET_SUBDIR0)$(LIB_DIR) $(QUIET_SUBDIR1) O=$(OUTPUT) libapikfs.a
 504 endif
 505
 506 $(LIBAPIKFS)-clean:
 507 ifeq ($(subdir),)
 508         $(call QUIET_CLEAN, libapikfs)
 509         @$(MAKE) -C $(LIB_DIR) O=$(OUTPUT) clean >/dev/null
 510 endif
 511
 512 help:
 513         @echo 'Perf make targets:'
 514         @echo '  doc            - make *all* documentation (see below)'
 515         @echo '  man            - make manpage documentation (access with man <foo>)'
 516         @echo '  html           - make html documentation'
 517         @echo '  info           - make GNU info documentation (access with info <foo>)'
 518         @echo '  pdf            - make pdf documentation'
 519         @echo '  TAGS           - use etags to make tag information for source browsing'
 520         @echo '  tags           - use ctags to make tag information for source browsing'
 521         @echo '  cscope - use cscope to make interactive browsing database'
 522         @echo ''
 523         @echo 'Perf install targets:'
 524         @echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
 525         @echo '  HINT: use "prefix" or "DESTDIR" to install to a particular'
 526         @echo '        path like "make prefix=/usr/local install install-doc"'
 527         @echo '  install        - install compiled binaries'
 528         @echo '  install-doc    - install *all* documentation'
 529         @echo '  install-man    - install manpage documentation'
 530         @echo '  install-html   - install html documentation'
 531         @echo '  install-info   - install GNU info documentation'
 532         @echo '  install-pdf    - install pdf documentation'
 533         @echo ''
 534         @echo '  quick-install-doc      - alias for quick-install-man'
 535         @echo '  quick-install-man      - install the documentation quickly'
 536         @echo '  quick-install-html     - install the html documentation quickly'
 537         @echo ''
 538         @echo 'Perf maintainer targets:'
 539         @echo '  clean                  - clean all binary objects and build output'
 540
 541
 542 DOC_TARGETS := doc man html info pdf
 543
 544 INSTALL_DOC_TARGETS := $(patsubst %,install-%,$(DOC_TARGETS)) try-install-man
 545 INSTALL_DOC_TARGETS += quick-install-doc quick-install-man quick-install-html
 546
 547 # 'make doc' should call 'make -C Documentation all'
 548 $(DOC_TARGETS):
 549         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:doc=all)
 550
 551 TAG_FOLDERS= . ../lib/traceevent ../lib/api ../lib/symbol
 552 TAG_FILES= ../../include/uapi/linux/perf_event.h
 553
 554 TAGS:
 555         $(QUIET_GEN)$(RM) TAGS; \
 556         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs etags -a $(TAG_FILES)
 557
 558 tags:
 559         $(QUIET_GEN)$(RM) tags; \
 560         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs ctags -a $(TAG_FILES)
 561
 562 cscope:
 563         $(QUIET_GEN)$(RM) cscope*; \
 564         $(FIND) $(TAG_FOLDERS) -name '*.[hcS]' -print | xargs cscope -b $(TAG_FILES)
 565
 566 ### Detect prefix changes
 567 TRACK_CFLAGS = $(subst ','\'',$(CFLAGS)):\
 568              $(bindir_SQ):$(perfexecdir_SQ):$(template_dir_SQ):$(prefix_SQ):$(plugindir_SQ)
 569
 570 $(OUTPUT)PERF-CFLAGS: .FORCE-PERF-CFLAGS
 571         @FLAGS='$(TRACK_CFLAGS)'; \
 572             if test x"$$FLAGS" != x"`cat $(OUTPUT)PERF-CFLAGS 2>/dev/null`" ; then \
 573                 echo 1>&2 "  FLAGS:   * new build flags or prefix"; \
 574                 echo "$$FLAGS" >$(OUTPUT)PERF-CFLAGS; \
 575             fi
 576
 577 ### Testing rules
 578
 579 # GNU make supports exporting all variables by "export" without parameters.
 580 # However, the environment gets quite big, and some programs have problems
 581 # with that.
 582
 583 check: $(OUTPUT)common-cmds.h
 584         if sparse; \
 585         then \
 586                 for i in *.c */*.c; \
 587                 do \
 588                         sparse $(CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
 589                 done; \
 590         else \
 591                 exit 1; \
 592         fi
 593
 594 ### Installation rules
 595
 596 install-gtk:
 597
 598 install-bin: all install-gtk
 599         $(call QUIET_INSTALL, binaries) \
 600                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'; \
 601                 $(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'; \
 602                 $(LN) '$(DESTDIR_SQ)$(bindir_SQ)/perf' '$(DESTDIR_SQ)$(bindir_SQ)/trace'
 603 ifndef NO_PERF_READ_VDSO32
 604         $(call QUIET_INSTALL, perf-read-vdso32) \
 605                 $(INSTALL) $(OUTPUT)perf-read-vdso32 '$(DESTDIR_SQ)$(bindir_SQ)';
 606 endif
 607 ifndef NO_PERF_READ_VDSOX32
 608         $(call QUIET_INSTALL, perf-read-vdsox32) \
 609                 $(INSTALL) $(OUTPUT)perf-read-vdsox32 '$(DESTDIR_SQ)$(bindir_SQ)';
 610 endif
 611         $(call QUIET_INSTALL, libexec) \
 612                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 613         $(call QUIET_INSTALL, perf-archive) \
 614                 $(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 615         $(call QUIET_INSTALL, perf-with-kcore) \
 616                 $(INSTALL) $(OUTPUT)perf-with-kcore -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 617 ifndef NO_LIBPERL
 618         $(call QUIET_INSTALL, perl-scripts) \
 619                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
 620                 $(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'; \
 621                 $(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'; \
 622                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'; \
 623                 $(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
 624 endif
 625 ifndef NO_LIBPYTHON
 626         $(call QUIET_INSTALL, python-scripts) \
 627                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
 628                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'; \
 629                 $(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'; \
 630                 $(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'; \
 631                 $(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
 632 endif
 633         $(call QUIET_INSTALL, perf_completion-script) \
 634                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d'; \
 635                 $(INSTALL) perf-completion.sh '$(DESTDIR_SQ)$(sysconfdir_SQ)/bash_completion.d/perf'
 636         $(call QUIET_INSTALL, tests) \
 637                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
 638                 $(INSTALL) tests/attr.py '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests'; \
 639                 $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'; \
 640                 $(INSTALL) tests/attr/* '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/tests/attr'
 641
 642 install: install-bin try-install-man install-traceevent-plugins
 643
 644 install-python_ext:
 645         $(PYTHON_WORD) util/setup.py --quiet install --root='/$(DESTDIR_SQ)'
 646
 647 # 'make install-doc' should call 'make -C Documentation install'
 648 $(INSTALL_DOC_TARGETS):
 649         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) $(@:-doc=)
 650
 651 ### Cleaning rules
 652
 653 #
 654 # This is here, not in config/Makefile, because config/Makefile does
 655 # not get included for the clean target:
 656 #
 657 config-clean:
 658         $(call QUIET_CLEAN, config)
 659         @$(MAKE) -C config/feature-checks clean >/dev/null
 660
 661 clean: $(LIBTRACEEVENT)-clean $(LIBAPIKFS)-clean config-clean
 662         $(call QUIET_CLEAN, core-objs)  $(RM) $(LIB_OBJS) $(BUILTIN_OBJS) $(LIB_FILE) $(OUTPUT)perf-archive $(OUTPUT)perf-with-kcore $(OUTPUT)perf.o $(LANG_BINDINGS)
 663         @find . -name '*.o' -delete -o -name '\.*.cmd' -delete -o -name '\.*.d' -delete
 664         @$(RM) .config-detected
 665         $(call QUIET_CLEAN, core-progs) $(RM) $(ALL_PROGRAMS) perf perf-read-vdso32 perf-read-vdsox32
 666         $(call QUIET_CLEAN, core-gen)   $(RM)  *.spec *.pyc *.pyo */*.pyc */*.pyo $(OUTPUT)common-cmds.h TAGS tags cscope* $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)PERF-CFLAGS $(OUTPUT)PERF-FEATURES $(OUTPUT)util/*-bison* $(OUTPUT)util/*-flex*
 667         $(QUIET_SUBDIR0)Documentation $(QUIET_SUBDIR1) clean
 668         $(python-clean)
 669
 670 #
 671 # Trick: if ../../.git does not exist - we are building out of tree for example,
 672 # then force version regeneration:
 673 #
 674 ifeq ($(wildcard ../../.git/HEAD),)
 675     GIT-HEAD-PHONY = ../../.git/HEAD
 676 else
 677     GIT-HEAD-PHONY =
 678 endif
 679
 680 FORCE:
 681
 682 .PHONY: all install clean config-clean strip install-gtk
 683 .PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
 684 .PHONY: $(GIT-HEAD-PHONY) TAGS tags cscope .FORCE-PERF-CFLAGS FORCE
 685