tools/perf/Makefile

   1 ifeq ("$(origin O)", "command line")
   2         OUTPUT := $(O)/
   3 endif
   4
   5 # The default target of this Makefile is...
   6 all:
   7
   8 include config/utilities.mak
   9
  10 ifneq ($(OUTPUT),)
  11 # check that the output directory actually exists
  12 OUTDIR := $(shell cd $(OUTPUT) && /bin/pwd)
  13 $(if $(OUTDIR),, $(error output directory "$(OUTPUT)" does not exist))
  14 endif
  15
  16 # Define V to have a more verbose compile.
  17 #
  18 # Define PYTHON to point to the python binary if the default
  19 # `python' is not correct; for example: PYTHON=python2
  20 #
  21 # Define PYTHON_CONFIG to point to the python-config binary if
  22 # the default `$(PYTHON)-config' is not correct.
  23 #
  24 # Define ASCIIDOC8 if you want to format documentation with AsciiDoc 8
  25 #
  26 # Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72.
  27 #
  28 # Define LDFLAGS=-static to build a static binary.
  29 #
  30 # Define EXTRA_CFLAGS=-m64 or EXTRA_CFLAGS=-m32 as appropriate for cross-builds.
  31 #
  32 # Define NO_DWARF if you do not want debug-info analysis feature at all.
  33
  34 $(OUTPUT)PERF-VERSION-FILE: .FORCE-PERF-VERSION-FILE
  35         @$(SHELL_PATH) util/PERF-VERSION-GEN $(OUTPUT)
  36 -include $(OUTPUT)PERF-VERSION-FILE
  37
  38 uname_M := $(shell uname -m 2>/dev/null || echo not)
  39
  40 ARCH ?= $(shell echo $(uname_M) | sed -e s/i.86/i386/ -e s/sun4u/sparc64/ \
  41                                   -e s/arm.*/arm/ -e s/sa110/arm/ \
  42                                   -e s/s390x/s390/ -e s/parisc64/parisc/ \
  43                                   -e s/ppc.*/powerpc/ -e s/mips.*/mips/ \
  44                                   -e s/sh[234].*/sh/ )
  45
  46 CC = $(CROSS_COMPILE)gcc
  47 AR = $(CROSS_COMPILE)ar
  48
  49 # Additional ARCH settings for x86
  50 ifeq ($(ARCH),i386)
  51         ARCH := x86
  52 endif
  53 ifeq ($(ARCH),x86_64)
  54         ARCH := x86
  55         IS_X86_64 := $(shell echo __x86_64__ | ${CC} -E -xc - | tail -n 1)
  56         ifeq (${IS_X86_64}, 1)
  57                 RAW_ARCH := x86_64
  58                 ARCH_CFLAGS := -DARCH_X86_64
  59                 ARCH_INCLUDE = ../../arch/x86/lib/memcpy_64.S
  60         endif
  61 endif
  62
  63 #
  64 # Include saner warnings here, which can catch bugs:
  65 #
  66
  67 EXTRA_WARNINGS := -Wformat
  68 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wformat-security
  69 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wformat-y2k
  70 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wshadow
  71 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Winit-self
  72 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wpacked
  73 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wredundant-decls
  74 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wstrict-aliasing=3
  75 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wswitch-default
  76 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wswitch-enum
  77 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wno-system-headers
  78 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wundef
  79 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wwrite-strings
  80 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wbad-function-cast
  81 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wmissing-declarations
  82 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wmissing-prototypes
  83 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wnested-externs
  84 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wold-style-definition
  85 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wstrict-prototypes
  86 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wdeclaration-after-statement
  87
  88 ifeq ("$(origin DEBUG)", "command line")
  89   PERF_DEBUG = $(DEBUG)
  90 endif
  91 ifndef PERF_DEBUG
  92   CFLAGS_OPTIMIZE = -O6
  93 endif
  94
  95 CFLAGS = -fno-omit-frame-pointer -ggdb3 -Wall -Wextra -std=gnu99 -Werror $(CFLAGS_OPTIMIZE) -D_FORTIFY_SOURCE=2 $(EXTRA_WARNINGS) $(EXTRA_CFLAGS)
  96 EXTLIBS = -lpthread -lrt -lelf -lm
  97 ALL_CFLAGS = $(CFLAGS) -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64
  98 ALL_LDFLAGS = $(LDFLAGS)
  99 STRIP ?= strip
 100
 101 # Among the variables below, these:
 102 #   perfexecdir
 103 #   template_dir
 104 #   mandir
 105 #   infodir
 106 #   htmldir
 107 #   ETC_PERFCONFIG (but not sysconfdir)
 108 # can be specified as a relative path some/where/else;
 109 # this is interpreted as relative to $(prefix) and "perf" at
 110 # runtime figures out where they are based on the path to the executable.
 111 # This can help installing the suite in a relocatable way.
 112
 113 # Make the path relative to DESTDIR, not to prefix
 114 ifndef DESTDIR
 115 prefix = $(HOME)
 116 endif
 117 bindir_relative = bin
 118 bindir = $(prefix)/$(bindir_relative)
 119 mandir = share/man
 120 infodir = share/info
 121 perfexecdir = libexec/perf-core
 122 sharedir = $(prefix)/share
 123 template_dir = share/perf-core/templates
 124 htmldir = share/doc/perf-doc
 125 ifeq ($(prefix),/usr)
 126 sysconfdir = /etc
 127 ETC_PERFCONFIG = $(sysconfdir)/perfconfig
 128 else
 129 sysconfdir = $(prefix)/etc
 130 ETC_PERFCONFIG = etc/perfconfig
 131 endif
 132 lib = lib
 133
 134 export prefix bindir sharedir sysconfdir
 135
 136 RM = rm -f
 137 MKDIR = mkdir
 138 FIND = find
 139 INSTALL = install
 140
 141 # sparse is architecture-neutral, which means that we need to tell it
 142 # explicitly what architecture to check for. Fix this up for yours..
 143 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
 144
 145 -include config/feature-tests.mak
 146
 147 ifeq ($(call try-cc,$(SOURCE_HELLO),-Werror -fstack-protector-all),y)
 148         CFLAGS := $(CFLAGS) -fstack-protector-all
 149 endif
 150
 151 ifeq ($(call try-cc,$(SOURCE_HELLO),-Werror -Wstack-protector),y)
 152        CFLAGS := $(CFLAGS) -Wstack-protector
 153 endif
 154
 155 ifeq ($(call try-cc,$(SOURCE_HELLO),-Werror -Wvolatile-register-var),y)
 156        CFLAGS := $(CFLAGS) -Wvolatile-register-var
 157 endif
 158
 159 ### --- END CONFIGURATION SECTION ---
 160
 161 # Those must not be GNU-specific; they are shared with perl/ which may
 162 # be built by a different compiler. (Note that this is an artifact now
 163 # but it still might be nice to keep that distinction.)
 164 BASIC_CFLAGS = -Iutil/include -Iarch/$(ARCH)/include
 165 BASIC_LDFLAGS =
 166
 167 # Guard against environment variables
 168 BUILTIN_OBJS =
 169 LIB_H =
 170 LIB_OBJS =
 171 PYRF_OBJS =
 172 SCRIPT_SH =
 173
 174 SCRIPT_SH += perf-archive.sh
 175
 176 grep-libs = $(filter -l%,$(1))
 177 strip-libs = $(filter-out -l%,$(1))
 178
 179 $(OUTPUT)python/perf.so: $(PYRF_OBJS)
 180         $(QUIET_GEN)CFLAGS='$(BASIC_CFLAGS)' $(PYTHON_WORD) util/setup.py \
 181           --quiet build_ext \
 182           --build-lib='$(OUTPUT)python' \
 183           --build-temp='$(OUTPUT)python/temp'
 184 #
 185 # No Perl scripts right now:
 186 #
 187
 188 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH))
 189
 190 #
 191 # Single 'perf' binary right now:
 192 #
 193 PROGRAMS += $(OUTPUT)perf
 194
 195 LANG_BINDINGS =
 196
 197 # what 'all' will build and 'install' will install, in perfexecdir
 198 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
 199
 200 # what 'all' will build but not install in perfexecdir
 201 OTHER_PROGRAMS = $(OUTPUT)perf
 202
 203 # Set paths to tools early so that they can be used for version tests.
 204 ifndef SHELL_PATH
 205         SHELL_PATH = /bin/sh
 206 endif
 207 ifndef PERL_PATH
 208         PERL_PATH = /usr/bin/perl
 209 endif
 210
 211 export PERL_PATH
 212
 213 LIB_FILE=$(OUTPUT)libperf.a
 214
 215 LIB_H += ../../include/linux/perf_event.h
 216 LIB_H += ../../include/linux/rbtree.h
 217 LIB_H += ../../include/linux/list.h
 218 LIB_H += ../../include/linux/const.h
 219 LIB_H += ../../include/linux/hash.h
 220 LIB_H += ../../include/linux/stringify.h
 221 LIB_H += util/include/linux/bitmap.h
 222 LIB_H += util/include/linux/bitops.h
 223 LIB_H += util/include/linux/compiler.h
 224 LIB_H += util/include/linux/const.h
 225 LIB_H += util/include/linux/ctype.h
 226 LIB_H += util/include/linux/kernel.h
 227 LIB_H += util/include/linux/list.h
 228 LIB_H += util/include/linux/module.h
 229 LIB_H += util/include/linux/poison.h
 230 LIB_H += util/include/linux/prefetch.h
 231 LIB_H += util/include/linux/rbtree.h
 232 LIB_H += util/include/linux/string.h
 233 LIB_H += util/include/linux/types.h
 234 LIB_H += util/include/linux/linkage.h
 235 LIB_H += util/include/asm/asm-offsets.h
 236 LIB_H += util/include/asm/bug.h
 237 LIB_H += util/include/asm/byteorder.h
 238 LIB_H += util/include/asm/hweight.h
 239 LIB_H += util/include/asm/swab.h
 240 LIB_H += util/include/asm/system.h
 241 LIB_H += util/include/asm/uaccess.h
 242 LIB_H += util/include/dwarf-regs.h
 243 LIB_H += util/include/asm/dwarf2.h
 244 LIB_H += util/include/asm/cpufeature.h
 245 LIB_H += perf.h
 246 LIB_H += util/annotate.h
 247 LIB_H += util/cache.h
 248 LIB_H += util/callchain.h
 249 LIB_H += util/build-id.h
 250 LIB_H += util/debug.h
 251 LIB_H += util/debugfs.h
 252 LIB_H += util/event.h
 253 LIB_H += util/evsel.h
 254 LIB_H += util/evlist.h
 255 LIB_H += util/exec_cmd.h
 256 LIB_H += util/types.h
 257 LIB_H += util/levenshtein.h
 258 LIB_H += util/map.h
 259 LIB_H += util/parse-options.h
 260 LIB_H += util/parse-events.h
 261 LIB_H += util/quote.h
 262 LIB_H += util/util.h
 263 LIB_H += util/xyarray.h
 264 LIB_H += util/header.h
 265 LIB_H += util/help.h
 266 LIB_H += util/session.h
 267 LIB_H += util/strbuf.h
 268 LIB_H += util/strlist.h
 269 LIB_H += util/strfilter.h
 270 LIB_H += util/svghelper.h
 271 LIB_H += util/run-command.h
 272 LIB_H += util/sigchain.h
 273 LIB_H += util/symbol.h
 274 LIB_H += util/color.h
 275 LIB_H += util/values.h
 276 LIB_H += util/sort.h
 277 LIB_H += util/hist.h
 278 LIB_H += util/thread.h
 279 LIB_H += util/thread_map.h
 280 LIB_H += util/trace-event.h
 281 LIB_H += util/probe-finder.h
 282 LIB_H += util/probe-event.h
 283 LIB_H += util/pstack.h
 284 LIB_H += util/cpumap.h
 285 LIB_H += util/top.h
 286 LIB_H += $(ARCH_INCLUDE)
 287 LIB_H += util/cgroup.h
 288
 289 LIB_OBJS += $(OUTPUT)util/abspath.o
 290 LIB_OBJS += $(OUTPUT)util/alias.o
 291 LIB_OBJS += $(OUTPUT)util/annotate.o
 292 LIB_OBJS += $(OUTPUT)util/build-id.o
 293 LIB_OBJS += $(OUTPUT)util/config.o
 294 LIB_OBJS += $(OUTPUT)util/ctype.o
 295 LIB_OBJS += $(OUTPUT)util/debugfs.o
 296 LIB_OBJS += $(OUTPUT)util/environment.o
 297 LIB_OBJS += $(OUTPUT)util/event.o
 298 LIB_OBJS += $(OUTPUT)util/evlist.o
 299 LIB_OBJS += $(OUTPUT)util/evsel.o
 300 LIB_OBJS += $(OUTPUT)util/exec_cmd.o
 301 LIB_OBJS += $(OUTPUT)util/help.o
 302 LIB_OBJS += $(OUTPUT)util/levenshtein.o
 303 LIB_OBJS += $(OUTPUT)util/parse-options.o
 304 LIB_OBJS += $(OUTPUT)util/parse-events.o
 305 LIB_OBJS += $(OUTPUT)util/path.o
 306 LIB_OBJS += $(OUTPUT)util/rbtree.o
 307 LIB_OBJS += $(OUTPUT)util/bitmap.o
 308 LIB_OBJS += $(OUTPUT)util/hweight.o
 309 LIB_OBJS += $(OUTPUT)util/run-command.o
 310 LIB_OBJS += $(OUTPUT)util/quote.o
 311 LIB_OBJS += $(OUTPUT)util/strbuf.o
 312 LIB_OBJS += $(OUTPUT)util/string.o
 313 LIB_OBJS += $(OUTPUT)util/strlist.o
 314 LIB_OBJS += $(OUTPUT)util/strfilter.o
 315 LIB_OBJS += $(OUTPUT)util/top.o
 316 LIB_OBJS += $(OUTPUT)util/usage.o
 317 LIB_OBJS += $(OUTPUT)util/wrapper.o
 318 LIB_OBJS += $(OUTPUT)util/sigchain.o
 319 LIB_OBJS += $(OUTPUT)util/symbol.o
 320 LIB_OBJS += $(OUTPUT)util/color.o
 321 LIB_OBJS += $(OUTPUT)util/pager.o
 322 LIB_OBJS += $(OUTPUT)util/header.o
 323 LIB_OBJS += $(OUTPUT)util/callchain.o
 324 LIB_OBJS += $(OUTPUT)util/values.o
 325 LIB_OBJS += $(OUTPUT)util/debug.o
 326 LIB_OBJS += $(OUTPUT)util/map.o
 327 LIB_OBJS += $(OUTPUT)util/pstack.o
 328 LIB_OBJS += $(OUTPUT)util/session.o
 329 LIB_OBJS += $(OUTPUT)util/thread.o
 330 LIB_OBJS += $(OUTPUT)util/thread_map.o
 331 LIB_OBJS += $(OUTPUT)util/trace-event-parse.o
 332 LIB_OBJS += $(OUTPUT)util/trace-event-read.o
 333 LIB_OBJS += $(OUTPUT)util/trace-event-info.o
 334 LIB_OBJS += $(OUTPUT)util/trace-event-scripting.o
 335 LIB_OBJS += $(OUTPUT)util/svghelper.o
 336 LIB_OBJS += $(OUTPUT)util/sort.o
 337 LIB_OBJS += $(OUTPUT)util/hist.o
 338 LIB_OBJS += $(OUTPUT)util/probe-event.o
 339 LIB_OBJS += $(OUTPUT)util/util.o
 340 LIB_OBJS += $(OUTPUT)util/xyarray.o
 341 LIB_OBJS += $(OUTPUT)util/cpumap.o
 342 LIB_OBJS += $(OUTPUT)util/cgroup.o
 343
 344 BUILTIN_OBJS += $(OUTPUT)builtin-annotate.o
 345
 346 BUILTIN_OBJS += $(OUTPUT)builtin-bench.o
 347
 348 # Benchmark modules
 349 BUILTIN_OBJS += $(OUTPUT)bench/sched-messaging.o
 350 BUILTIN_OBJS += $(OUTPUT)bench/sched-pipe.o
 351 ifeq ($(RAW_ARCH),x86_64)
 352 BUILTIN_OBJS += $(OUTPUT)bench/mem-memcpy-x86-64-asm.o
 353 endif
 354 BUILTIN_OBJS += $(OUTPUT)bench/mem-memcpy.o
 355
 356 BUILTIN_OBJS += $(OUTPUT)builtin-diff.o
 357 BUILTIN_OBJS += $(OUTPUT)builtin-evlist.o
 358 BUILTIN_OBJS += $(OUTPUT)builtin-help.o
 359 BUILTIN_OBJS += $(OUTPUT)builtin-sched.o
 360 BUILTIN_OBJS += $(OUTPUT)builtin-buildid-list.o
 361 BUILTIN_OBJS += $(OUTPUT)builtin-buildid-cache.o
 362 BUILTIN_OBJS += $(OUTPUT)builtin-list.o
 363 BUILTIN_OBJS += $(OUTPUT)builtin-record.o
 364 BUILTIN_OBJS += $(OUTPUT)builtin-report.o
 365 BUILTIN_OBJS += $(OUTPUT)builtin-stat.o
 366 BUILTIN_OBJS += $(OUTPUT)builtin-timechart.o
 367 BUILTIN_OBJS += $(OUTPUT)builtin-top.o
 368 BUILTIN_OBJS += $(OUTPUT)builtin-script.o
 369 BUILTIN_OBJS += $(OUTPUT)builtin-probe.o
 370 BUILTIN_OBJS += $(OUTPUT)builtin-kmem.o
 371 BUILTIN_OBJS += $(OUTPUT)builtin-lock.o
 372 BUILTIN_OBJS += $(OUTPUT)builtin-kvm.o
 373 BUILTIN_OBJS += $(OUTPUT)builtin-test.o
 374 BUILTIN_OBJS += $(OUTPUT)builtin-inject.o
 375
 376 PERFLIBS = $(LIB_FILE)
 377
 378 # Files needed for the python binding, perf.so
 379 # pyrf is just an internal name needed for all those wrappers.
 380 # This has to be in sync with what is in the 'sources' variable in
 381 # tools/perf/util/setup.py
 382
 383 PYRF_OBJS += $(OUTPUT)util/cpumap.o
 384 PYRF_OBJS += $(OUTPUT)util/ctype.o
 385 PYRF_OBJS += $(OUTPUT)util/evlist.o
 386 PYRF_OBJS += $(OUTPUT)util/evsel.o
 387 PYRF_OBJS += $(OUTPUT)util/python.o
 388 PYRF_OBJS += $(OUTPUT)util/thread_map.o
 389 PYRF_OBJS += $(OUTPUT)util/util.o
 390 PYRF_OBJS += $(OUTPUT)util/xyarray.o
 391
 392 #
 393 # Platform specific tweaks
 394 #
 395
 396 # We choose to avoid "if .. else if .. else .. endif endif"
 397 # because maintaining the nesting to match is a pain.  If
 398 # we had "elif" things would have been much nicer...
 399
 400 -include config.mak.autogen
 401 -include config.mak
 402
 403 ifndef NO_DWARF
 404 FLAGS_DWARF=$(ALL_CFLAGS) -ldw -lelf $(ALL_LDFLAGS) $(EXTLIBS)
 405 ifneq ($(call try-cc,$(SOURCE_DWARF),$(FLAGS_DWARF)),y)
 406         msg := $(warning No libdw.h found or old libdw.h found or elfutils is older than 0.138, disables dwarf support. Please install new elfutils-devel/libdw-dev);
 407         NO_DWARF := 1
 408 endif # Dwarf support
 409 endif # NO_DWARF
 410
 411 -include arch/$(ARCH)/Makefile
 412
 413 ifneq ($(OUTPUT),)
 414         BASIC_CFLAGS += -I$(OUTPUT)
 415 endif
 416
 417 FLAGS_LIBELF=$(ALL_CFLAGS) $(ALL_LDFLAGS) $(EXTLIBS)
 418 ifneq ($(call try-cc,$(SOURCE_LIBELF),$(FLAGS_LIBELF)),y)
 419         FLAGS_GLIBC=$(ALL_CFLAGS) $(ALL_LDFLAGS)
 420         ifneq ($(call try-cc,$(SOURCE_GLIBC),$(FLAGS_GLIBC)),y)
 421                 msg := $(error No gnu/libc-version.h found, please install glibc-dev[el]/glibc-static);
 422         else
 423                 msg := $(error No libelf.h/libelf found, please install libelf-dev/elfutils-libelf-devel);
 424         endif
 425 endif
 426
 427 ifneq ($(call try-cc,$(SOURCE_ELF_MMAP),$(FLAGS_COMMON)),y)
 428         BASIC_CFLAGS += -DLIBELF_NO_MMAP
 429 endif
 430
 431 ifndef NO_DWARF
 432 ifeq ($(origin PERF_HAVE_DWARF_REGS), undefined)
 433         msg := $(warning DWARF register mappings have not been defined for architecture $(ARCH), DWARF support disabled);
 434 else
 435         BASIC_CFLAGS += -DDWARF_SUPPORT
 436         EXTLIBS += -lelf -ldw
 437         LIB_OBJS += $(OUTPUT)util/probe-finder.o
 438 endif # PERF_HAVE_DWARF_REGS
 439 endif # NO_DWARF
 440
 441 ifdef NO_NEWT
 442         BASIC_CFLAGS += -DNO_NEWT_SUPPORT
 443 else
 444         FLAGS_NEWT=$(ALL_CFLAGS) $(ALL_LDFLAGS) $(EXTLIBS) -lnewt
 445         ifneq ($(call try-cc,$(SOURCE_NEWT),$(FLAGS_NEWT)),y)
 446                 msg := $(warning newt not found, disables TUI support. Please install newt-devel or libnewt-dev);
 447                 BASIC_CFLAGS += -DNO_NEWT_SUPPORT
 448         else
 449                 # Fedora has /usr/include/slang/slang.h, but ubuntu /usr/include/slang.h
 450                 BASIC_CFLAGS += -I/usr/include/slang
 451                 EXTLIBS += -lnewt -lslang
 452                 LIB_OBJS += $(OUTPUT)util/ui/setup.o
 453                 LIB_OBJS += $(OUTPUT)util/ui/browser.o
 454                 LIB_OBJS += $(OUTPUT)util/ui/browsers/annotate.o
 455                 LIB_OBJS += $(OUTPUT)util/ui/browsers/hists.o
 456                 LIB_OBJS += $(OUTPUT)util/ui/browsers/map.o
 457                 LIB_OBJS += $(OUTPUT)util/ui/browsers/top.o
 458                 LIB_OBJS += $(OUTPUT)util/ui/helpline.o
 459                 LIB_OBJS += $(OUTPUT)util/ui/progress.o
 460                 LIB_OBJS += $(OUTPUT)util/ui/util.o
 461                 LIB_H += util/ui/browser.h
 462                 LIB_H += util/ui/browsers/map.h
 463                 LIB_H += util/ui/helpline.h
 464                 LIB_H += util/ui/libslang.h
 465                 LIB_H += util/ui/progress.h
 466                 LIB_H += util/ui/util.h
 467                 LIB_H += util/ui/ui.h
 468         endif
 469 endif
 470
 471 ifdef NO_LIBPERL
 472         BASIC_CFLAGS += -DNO_LIBPERL
 473 else
 474        PERL_EMBED_LDOPTS = $(shell perl -MExtUtils::Embed -e ldopts 2>/dev/null)
 475        PERL_EMBED_LDFLAGS = $(call strip-libs,$(PERL_EMBED_LDOPTS))
 476        PERL_EMBED_LIBADD = $(call grep-libs,$(PERL_EMBED_LDOPTS))
 477         PERL_EMBED_CCOPTS = `perl -MExtUtils::Embed -e ccopts 2>/dev/null`
 478         FLAGS_PERL_EMBED=$(PERL_EMBED_CCOPTS) $(PERL_EMBED_LDOPTS)
 479
 480         ifneq ($(call try-cc,$(SOURCE_PERL_EMBED),$(FLAGS_PERL_EMBED)),y)
 481                 BASIC_CFLAGS += -DNO_LIBPERL
 482         else
 483                ALL_LDFLAGS += $(PERL_EMBED_LDFLAGS)
 484                EXTLIBS += $(PERL_EMBED_LIBADD)
 485                 LIB_OBJS += $(OUTPUT)util/scripting-engines/trace-event-perl.o
 486                 LIB_OBJS += $(OUTPUT)scripts/perl/Perf-Trace-Util/Context.o
 487         endif
 488 endif
 489
 490 disable-python = $(eval $(disable-python_code))
 491 define disable-python_code
 492   BASIC_CFLAGS += -DNO_LIBPYTHON
 493   $(if $(1),$(warning No $(1) was found))
 494   $(warning Python support won't be built)
 495 endef
 496
 497 override PYTHON := \
 498   $(call get-executable-or-default,PYTHON,python)
 499
 500 ifndef PYTHON
 501   $(call disable-python,python interpreter)
 502   python-clean :=
 503 else
 504
 505   PYTHON_WORD := $(call shell-wordify,$(PYTHON))
 506
 507   python-clean := $(PYTHON_WORD) util/setup.py clean \
 508     --build-lib='$(OUTPUT)python' \
 509     --build-temp='$(OUTPUT)python/temp'
 510
 511   ifdef NO_LIBPYTHON
 512     $(call disable-python)
 513   else
 514
 515     override PYTHON_CONFIG := \
 516       $(call get-executable-or-default,PYTHON_CONFIG,$(PYTHON)-config)
 517
 518     ifndef PYTHON_CONFIG
 519       $(call disable-python,python-config tool)
 520     else
 521
 522       PYTHON_CONFIG_SQ := $(call shell-sq,$(PYTHON_CONFIG))
 523
 524       PYTHON_EMBED_LDOPTS := $(shell $(PYTHON_CONFIG_SQ) --ldflags 2>/dev/null)
 525       PYTHON_EMBED_LDFLAGS := $(call strip-libs,$(PYTHON_EMBED_LDOPTS))
 526       PYTHON_EMBED_LIBADD := $(call grep-libs,$(PYTHON_EMBED_LDOPTS))
 527       PYTHON_EMBED_CCOPTS := $(shell $(PYTHON_CONFIG_SQ) --cflags 2>/dev/null)
 528       FLAGS_PYTHON_EMBED := $(PYTHON_EMBED_CCOPTS) $(PYTHON_EMBED_LDOPTS)
 529
 530       ifneq ($(call try-cc,$(SOURCE_PYTHON_EMBED),$(FLAGS_PYTHON_EMBED)),y)
 531         $(call disable-python,Python.h (for Python 2.x))
 532       else
 533
 534         ifneq ($(call try-cc,$(SOURCE_PYTHON_VERSION),$(FLAGS_PYTHON_EMBED)),y)
 535           $(warning Python 3 is not yet supported; please set)
 536           $(warning PYTHON and/or PYTHON_CONFIG appropriately.)
 537           $(warning If you also have Python 2 installed, then)
 538           $(warning try something like:)
 539           $(warning $(and ,))
 540           $(warning $(and ,)  make PYTHON=python2)
 541           $(warning $(and ,))
 542           $(warning Otherwise, disable Python support entirely:)
 543           $(warning $(and ,))
 544           $(warning $(and ,)  make NO_LIBPYTHON=1)
 545           $(warning $(and ,))
 546           $(error   $(and ,))
 547         else
 548           ALL_LDFLAGS += $(PYTHON_EMBED_LDFLAGS)
 549           EXTLIBS += $(PYTHON_EMBED_LIBADD)
 550           LIB_OBJS += $(OUTPUT)util/scripting-engines/trace-event-python.o
 551           LIB_OBJS += $(OUTPUT)scripts/python/Perf-Trace-Util/Context.o
 552           LANG_BINDINGS += $(OUTPUT)python/perf.so
 553         endif
 554
 555       endif
 556     endif
 557   endif
 558 endif
 559
 560 ifdef NO_DEMANGLE
 561         BASIC_CFLAGS += -DNO_DEMANGLE
 562 else
 563         ifdef HAVE_CPLUS_DEMANGLE
 564                 EXTLIBS += -liberty
 565                 BASIC_CFLAGS += -DHAVE_CPLUS_DEMANGLE
 566         else
 567                 FLAGS_BFD=$(ALL_CFLAGS) $(ALL_LDFLAGS) $(EXTLIBS) -lbfd
 568                 has_bfd := $(call try-cc,$(SOURCE_BFD),$(FLAGS_BFD))
 569                 ifeq ($(has_bfd),y)
 570                         EXTLIBS += -lbfd
 571                 else
 572                         FLAGS_BFD_IBERTY=$(FLAGS_BFD) -liberty
 573                         has_bfd_iberty := $(call try-cc,$(SOURCE_BFD),$(FLAGS_BFD_IBERTY))
 574                         ifeq ($(has_bfd_iberty),y)
 575                                 EXTLIBS += -lbfd -liberty
 576                         else
 577                                 FLAGS_BFD_IBERTY_Z=$(FLAGS_BFD_IBERTY) -lz
 578                                 has_bfd_iberty_z := $(call try-cc,$(SOURCE_BFD),$(FLAGS_BFD_IBERTY_Z))
 579                                 ifeq ($(has_bfd_iberty_z),y)
 580                                         EXTLIBS += -lbfd -liberty -lz
 581                                 else
 582                                         FLAGS_CPLUS_DEMANGLE=$(ALL_CFLAGS) $(ALL_LDFLAGS) $(EXTLIBS) -liberty
 583                                         has_cplus_demangle := $(call try-cc,$(SOURCE_CPLUS_DEMANGLE),$(FLAGS_CPLUS_DEMANGLE))
 584                                         ifeq ($(has_cplus_demangle),y)
 585                                                 EXTLIBS += -liberty
 586                                                 BASIC_CFLAGS += -DHAVE_CPLUS_DEMANGLE
 587                                         else
 588                                                 msg := $(warning No bfd.h/libbfd found, install binutils-dev[el]/zlib-static to gain symbol demangling)
 589                                                 BASIC_CFLAGS += -DNO_DEMANGLE
 590                                         endif
 591                                 endif
 592                         endif
 593                 endif
 594         endif
 595 endif
 596
 597
 598 ifdef NO_STRLCPY
 599         BASIC_CFLAGS += -DNO_STRLCPY
 600 else
 601         ifneq ($(call try-cc,$(SOURCE_STRLCPY),),y)
 602                 BASIC_CFLAGS += -DNO_STRLCPY
 603         endif
 604 endif
 605
 606 ifneq ($(findstring $(MAKEFLAGS),s),s)
 607 ifndef V
 608         QUIET_CC       = @echo '   ' CC $@;
 609         QUIET_AR       = @echo '   ' AR $@;
 610         QUIET_LINK     = @echo '   ' LINK $@;
 611         QUIET_MKDIR    = @echo '   ' MKDIR $@;
 612         QUIET_GEN      = @echo '   ' GEN $@;
 613 endif
 614 endif
 615
 616 ifdef ASCIIDOC8
 617         export ASCIIDOC8
 618 endif
 619
 620 # Shell quote (do not use $(call) to accommodate ancient setups);
 621
 622 ETC_PERFCONFIG_SQ = $(subst ','\'',$(ETC_PERFCONFIG))
 623
 624 DESTDIR_SQ = $(subst ','\'',$(DESTDIR))
 625 bindir_SQ = $(subst ','\'',$(bindir))
 626 bindir_relative_SQ = $(subst ','\'',$(bindir_relative))
 627 mandir_SQ = $(subst ','\'',$(mandir))
 628 infodir_SQ = $(subst ','\'',$(infodir))
 629 perfexecdir_SQ = $(subst ','\'',$(perfexecdir))
 630 template_dir_SQ = $(subst ','\'',$(template_dir))
 631 htmldir_SQ = $(subst ','\'',$(htmldir))
 632 prefix_SQ = $(subst ','\'',$(prefix))
 633
 634 SHELL_PATH_SQ = $(subst ','\'',$(SHELL_PATH))
 635
 636 LIBS = -Wl,--whole-archive $(PERFLIBS) -Wl,--no-whole-archive $(EXTLIBS)
 637
 638 ALL_CFLAGS += $(BASIC_CFLAGS)
 639 ALL_CFLAGS += $(ARCH_CFLAGS)
 640 ALL_LDFLAGS += $(BASIC_LDFLAGS)
 641
 642 export INSTALL SHELL_PATH
 643
 644
 645 ### Build rules
 646
 647 SHELL = $(SHELL_PATH)
 648
 649 all: shell_compatibility_test $(ALL_PROGRAMS) $(LANG_BINDINGS) $(OTHER_PROGRAMS)
 650
 651 please_set_SHELL_PATH_to_a_more_modern_shell:
 652         @$$(:)
 653
 654 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
 655
 656 strip: $(PROGRAMS) $(OUTPUT)perf
 657         $(STRIP) $(STRIP_OPTS) $(PROGRAMS) $(OUTPUT)perf
 658
 659 $(OUTPUT)perf.o: perf.c $(OUTPUT)common-cmds.h $(OUTPUT)PERF-CFLAGS
 660         $(QUIET_CC)$(CC) -DPERF_VERSION='"$(PERF_VERSION)"' \
 661                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
 662                 $(ALL_CFLAGS) -c $(filter %.c,$^) -o $@
 663
 664 $(OUTPUT)perf: $(OUTPUT)perf.o $(BUILTIN_OBJS) $(PERFLIBS)
 665         $(QUIET_LINK)$(CC) $(ALL_CFLAGS) $(ALL_LDFLAGS) $(OUTPUT)perf.o \
 666                $(BUILTIN_OBJS) $(LIBS) -o $@
 667
 668 $(OUTPUT)builtin-help.o: builtin-help.c $(OUTPUT)common-cmds.h $(OUTPUT)PERF-CFLAGS
 669         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) \
 670                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
 671                 '-DPERF_MAN_PATH="$(mandir_SQ)"' \
 672                 '-DPERF_INFO_PATH="$(infodir_SQ)"' $<
 673
 674 $(OUTPUT)builtin-timechart.o: builtin-timechart.c $(OUTPUT)common-cmds.h $(OUTPUT)PERF-CFLAGS
 675         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) \
 676                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
 677                 '-DPERF_MAN_PATH="$(mandir_SQ)"' \
 678                 '-DPERF_INFO_PATH="$(infodir_SQ)"' $<
 679
 680 $(OUTPUT)common-cmds.h: util/generate-cmdlist.sh command-list.txt
 681
 682 $(OUTPUT)common-cmds.h: $(wildcard Documentation/perf-*.txt)
 683         $(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
 684
 685 $(SCRIPTS) : % : %.sh
 686         $(QUIET_GEN)$(INSTALL) '$@.sh' '$(OUTPUT)$@'
 687
 688 # These can record PERF_VERSION
 689 $(OUTPUT)perf.o perf.spec \
 690         $(SCRIPTS) \
 691         : $(OUTPUT)PERF-VERSION-FILE
 692
 693 $(OUTPUT)%.o: %.c $(OUTPUT)PERF-CFLAGS
 694         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) $<
 695 $(OUTPUT)%.s: %.c $(OUTPUT)PERF-CFLAGS
 696         $(QUIET_CC)$(CC) -S $(ALL_CFLAGS) $<
 697 $(OUTPUT)%.o: %.S
 698         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) $<
 699
 700 $(OUTPUT)util/exec_cmd.o: util/exec_cmd.c $(OUTPUT)PERF-CFLAGS
 701         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) \
 702                 '-DPERF_EXEC_PATH="$(perfexecdir_SQ)"' \
 703                 '-DBINDIR="$(bindir_relative_SQ)"' \
 704                 '-DPREFIX="$(prefix_SQ)"' \
 705                 $<
 706
 707 $(OUTPUT)util/config.o: util/config.c $(OUTPUT)PERF-CFLAGS
 708         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) -DETC_PERFCONFIG='"$(ETC_PERFCONFIG_SQ)"' $<
 709
 710 $(OUTPUT)util/ui/browser.o: util/ui/browser.c $(OUTPUT)PERF-CFLAGS
 711         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) -DENABLE_SLFUTURE_CONST $<
 712
 713 $(OUTPUT)util/ui/browsers/annotate.o: util/ui/browsers/annotate.c $(OUTPUT)PERF-CFLAGS
 714         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) -DENABLE_SLFUTURE_CONST $<
 715
 716 $(OUTPUT)util/ui/browsers/top.o: util/ui/browsers/top.c $(OUTPUT)PERF-CFLAGS
 717         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) -DENABLE_SLFUTURE_CONST $<
 718
 719 $(OUTPUT)util/ui/browsers/hists.o: util/ui/browsers/hists.c $(OUTPUT)PERF-CFLAGS
 720         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) -DENABLE_SLFUTURE_CONST $<
 721
 722 $(OUTPUT)util/ui/browsers/map.o: util/ui/browsers/map.c $(OUTPUT)PERF-CFLAGS
 723         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) -DENABLE_SLFUTURE_CONST $<
 724
 725 $(OUTPUT)util/rbtree.o: ../../lib/rbtree.c $(OUTPUT)PERF-CFLAGS
 726         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) -DETC_PERFCONFIG='"$(ETC_PERFCONFIG_SQ)"' $<
 727
 728 $(OUTPUT)util/scripting-engines/trace-event-perl.o: util/scripting-engines/trace-event-perl.c $(OUTPUT)PERF-CFLAGS
 729         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) $(PERL_EMBED_CCOPTS) -Wno-redundant-decls -Wno-strict-prototypes -Wno-unused-parameter -Wno-shadow $<
 730
 731 $(OUTPUT)scripts/perl/Perf-Trace-Util/Context.o: scripts/perl/Perf-Trace-Util/Context.c $(OUTPUT)PERF-CFLAGS
 732         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) $(PERL_EMBED_CCOPTS) -Wno-redundant-decls -Wno-strict-prototypes -Wno-unused-parameter -Wno-nested-externs $<
 733
 734 $(OUTPUT)util/scripting-engines/trace-event-python.o: util/scripting-engines/trace-event-python.c $(OUTPUT)PERF-CFLAGS
 735         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) $(PYTHON_EMBED_CCOPTS) -Wno-redundant-decls -Wno-strict-prototypes -Wno-unused-parameter -Wno-shadow $<
 736
 737 $(OUTPUT)scripts/python/Perf-Trace-Util/Context.o: scripts/python/Perf-Trace-Util/Context.c $(OUTPUT)PERF-CFLAGS
 738         $(QUIET_CC)$(CC) -o $@ -c $(ALL_CFLAGS) $(PYTHON_EMBED_CCOPTS) -Wno-redundant-decls -Wno-strict-prototypes -Wno-unused-parameter -Wno-nested-externs $<
 739
 740 $(OUTPUT)perf-%: %.o $(PERFLIBS)
 741         $(QUIET_LINK)$(CC) $(ALL_CFLAGS) -o $@ $(ALL_LDFLAGS) $(filter %.o,$^) $(LIBS)
 742
 743 $(LIB_OBJS) $(BUILTIN_OBJS): $(LIB_H)
 744 $(patsubst perf-%,%.o,$(PROGRAMS)): $(LIB_H) $(wildcard */*.h)
 745
 746 # we compile into subdirectories. if the target directory is not the source directory, they might not exists. So
 747 # we depend the various files onto their directories.
 748 DIRECTORY_DEPS = $(LIB_OBJS) $(BUILTIN_OBJS) $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)common-cmds.h
 749 $(DIRECTORY_DEPS): | $(sort $(dir $(DIRECTORY_DEPS)))
 750 # In the second step, we make a rule to actually create these directories
 751 $(sort $(dir $(DIRECTORY_DEPS))):
 752         $(QUIET_MKDIR)$(MKDIR) -p $@ 2>/dev/null
 753
 754 $(LIB_FILE): $(LIB_OBJS)
 755         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIB_OBJS)
 756
 757 help:
 758         @echo 'Perf make targets:'
 759         @echo '  doc            - make *all* documentation (see below)'
 760         @echo '  man            - make manpage documentation (access with man <foo>)'
 761         @echo '  html           - make html documentation'
 762         @echo '  info           - make GNU info documentation (access with info <foo>)'
 763         @echo '  pdf            - make pdf documentation'
 764         @echo '  TAGS           - use etags to make tag information for source browsing'
 765         @echo '  tags           - use ctags to make tag information for source browsing'
 766         @echo '  cscope - use cscope to make interactive browsing database'
 767         @echo ''
 768         @echo 'Perf install targets:'
 769         @echo '  NOTE: documentation build requires asciidoc, xmlto packages to be installed'
 770         @echo '  HINT: use "make prefix=<path> <install target>" to install to a particular'
 771         @echo '        path like make prefix=/usr/local install install-doc'
 772         @echo '  install        - install compiled binaries'
 773         @echo '  install-doc    - install *all* documentation'
 774         @echo '  install-man    - install manpage documentation'
 775         @echo '  install-html   - install html documentation'
 776         @echo '  install-info   - install GNU info documentation'
 777         @echo '  install-pdf    - install pdf documentation'
 778         @echo ''
 779         @echo '  quick-install-doc      - alias for quick-install-man'
 780         @echo '  quick-install-man      - install the documentation quickly'
 781         @echo '  quick-install-html     - install the html documentation quickly'
 782         @echo ''
 783         @echo 'Perf maintainer targets:'
 784         @echo '  distclean              - alias to clean'
 785         @echo '  clean                  - clean all binary objects and build output'
 786
 787 doc:
 788         $(MAKE) -C Documentation all
 789
 790 man:
 791         $(MAKE) -C Documentation man
 792
 793 html:
 794         $(MAKE) -C Documentation html
 795
 796 info:
 797         $(MAKE) -C Documentation info
 798
 799 pdf:
 800         $(MAKE) -C Documentation pdf
 801
 802 TAGS:
 803         $(RM) TAGS
 804         $(FIND) . -name '*.[hcS]' -print | xargs etags -a
 805
 806 tags:
 807         $(RM) tags
 808         $(FIND) . -name '*.[hcS]' -print | xargs ctags -a
 809
 810 cscope:
 811         $(RM) cscope*
 812         $(FIND) . -name '*.[hcS]' -print | xargs cscope -b
 813
 814 ### Detect prefix changes
 815 TRACK_CFLAGS = $(subst ','\'',$(ALL_CFLAGS)):\
 816              $(bindir_SQ):$(perfexecdir_SQ):$(template_dir_SQ):$(prefix_SQ)
 817
 818 $(OUTPUT)PERF-CFLAGS: .FORCE-PERF-CFLAGS
 819         @FLAGS='$(TRACK_CFLAGS)'; \
 820             if test x"$$FLAGS" != x"`cat $(OUTPUT)PERF-CFLAGS 2>/dev/null`" ; then \
 821                 echo 1>&2 "    * new build flags or prefix"; \
 822                 echo "$$FLAGS" >$(OUTPUT)PERF-CFLAGS; \
 823             fi
 824
 825 ### Testing rules
 826
 827 # GNU make supports exporting all variables by "export" without parameters.
 828 # However, the environment gets quite big, and some programs have problems
 829 # with that.
 830
 831 check: $(OUTPUT)common-cmds.h
 832         if sparse; \
 833         then \
 834                 for i in *.c */*.c; \
 835                 do \
 836                         sparse $(ALL_CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
 837                 done; \
 838         else \
 839                 exit 1; \
 840         fi
 841
 842 ### Installation rules
 843
 844 ifneq ($(filter /%,$(firstword $(perfexecdir))),)
 845 perfexec_instdir = $(perfexecdir)
 846 else
 847 perfexec_instdir = $(prefix)/$(perfexecdir)
 848 endif
 849 perfexec_instdir_SQ = $(subst ','\'',$(perfexec_instdir))
 850
 851 install: all
 852         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'
 853         $(INSTALL) $(OUTPUT)perf '$(DESTDIR_SQ)$(bindir_SQ)'
 854         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'
 855         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
 856         $(INSTALL) $(OUTPUT)perf-archive -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 857         $(INSTALL) scripts/perl/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/Perf-Trace-Util/lib/Perf/Trace'
 858         $(INSTALL) scripts/perl/*.pl -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl'
 859         $(INSTALL) scripts/perl/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/perl/bin'
 860         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'
 861         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
 862         $(INSTALL) scripts/python/Perf-Trace-Util/lib/Perf/Trace/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/Perf-Trace-Util/lib/Perf/Trace'
 863         $(INSTALL) scripts/python/*.py -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python'
 864         $(INSTALL) scripts/python/bin/* -t '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/scripts/python/bin'
 865
 866 install-doc:
 867         $(MAKE) -C Documentation install
 868
 869 install-man:
 870         $(MAKE) -C Documentation install-man
 871
 872 install-html:
 873         $(MAKE) -C Documentation install-html
 874
 875 install-info:
 876         $(MAKE) -C Documentation install-info
 877
 878 install-pdf:
 879         $(MAKE) -C Documentation install-pdf
 880
 881 quick-install-doc:
 882         $(MAKE) -C Documentation quick-install
 883
 884 quick-install-man:
 885         $(MAKE) -C Documentation quick-install-man
 886
 887 quick-install-html:
 888         $(MAKE) -C Documentation quick-install-html
 889
 890 ### Cleaning rules
 891
 892 clean:
 893         $(RM) $(OUTPUT){*.o,*/*.o,*/*/*.o,*/*/*/*.o,$(LIB_FILE),perf-archive}
 894         $(RM) $(ALL_PROGRAMS) perf
 895         $(RM) *.spec *.pyc *.pyo */*.pyc */*.pyo $(OUTPUT)common-cmds.h TAGS tags cscope*
 896         $(MAKE) -C Documentation/ clean
 897         $(RM) $(OUTPUT)PERF-VERSION-FILE $(OUTPUT)PERF-CFLAGS
 898         $(python-clean)
 899
 900 .PHONY: all install clean strip
 901 .PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
 902 .PHONY: .FORCE-PERF-VERSION-FILE TAGS tags cscope .FORCE-PERF-CFLAGS