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