tools/perf/Makefile

   1 # The default target of this Makefile is...
   2 all::
   3
   4 # Define V=1 to have a more verbose compile.
   5 #
   6 # Define SNPRINTF_RETURNS_BOGUS if your are on a system which snprintf()
   7 # or vsnprintf() return -1 instead of number of characters which would
   8 # have been written to the final string if enough space had been available.
   9 #
  10 # Define FREAD_READS_DIRECTORIES if your are on a system which succeeds
  11 # when attempting to read from an fopen'ed directory.
  12 #
  13 # Define NO_OPENSSL environment variable if you do not have OpenSSL.
  14 # This also implies MOZILLA_SHA1.
  15 #
  16 # Define CURLDIR=/foo/bar if your curl header and library files are in
  17 # /foo/bar/include and /foo/bar/lib directories.
  18 #
  19 # Define EXPATDIR=/foo/bar if your expat header and library files are in
  20 # /foo/bar/include and /foo/bar/lib directories.
  21 #
  22 # Define NO_D_INO_IN_DIRENT if you don't have d_ino in your struct dirent.
  23 #
  24 # Define NO_D_TYPE_IN_DIRENT if your platform defines DT_UNKNOWN but lacks
  25 # d_type in struct dirent (latest Cygwin -- will be fixed soonish).
  26 #
  27 # Define NO_C99_FORMAT if your formatted IO functions (printf/scanf et.al.)
  28 # do not support the 'size specifiers' introduced by C99, namely ll, hh,
  29 # j, z, t. (representing long long int, char, intmax_t, size_t, ptrdiff_t).
  30 # some C compilers supported these specifiers prior to C99 as an extension.
  31 #
  32 # Define NO_STRCASESTR if you don't have strcasestr.
  33 #
  34 # Define NO_MEMMEM if you don't have memmem.
  35 #
  36 # Define NO_STRTOUMAX if you don't have strtoumax in the C library.
  37 # If your compiler also does not support long long or does not have
  38 # strtoull, define NO_STRTOULL.
  39 #
  40 # Define NO_SETENV if you don't have setenv in the C library.
  41 #
  42 # Define NO_UNSETENV if you don't have unsetenv in the C library.
  43 #
  44 # Define NO_MKDTEMP if you don't have mkdtemp in the C library.
  45 #
  46 # Define NO_SYS_SELECT_H if you don't have sys/select.h.
  47 #
  48 # Define NO_SYMLINK_HEAD if you never want .perf/HEAD to be a symbolic link.
  49 # Enable it on Windows.  By default, symrefs are still used.
  50 #
  51 # Define NO_SVN_TESTS if you want to skip time-consuming SVN interoperability
  52 # tests.  These tests take up a significant amount of the total test time
  53 # but are not needed unless you plan to talk to SVN repos.
  54 #
  55 # Define NO_FINK if you are building on Darwin/Mac OS X, have Fink
  56 # installed in /sw, but don't want PERF to link against any libraries
  57 # installed there.  If defined you may specify your own (or Fink's)
  58 # include directories and library directories by defining CFLAGS
  59 # and LDFLAGS appropriately.
  60 #
  61 # Define NO_DARWIN_PORTS if you are building on Darwin/Mac OS X,
  62 # have DarwinPorts installed in /opt/local, but don't want PERF to
  63 # link against any libraries installed there.  If defined you may
  64 # specify your own (or DarwinPort's) include directories and
  65 # library directories by defining CFLAGS and LDFLAGS appropriately.
  66 #
  67 # Define PPC_SHA1 environment variable when running make to make use of
  68 # a bundled SHA1 routine optimized for PowerPC.
  69 #
  70 # Define ARM_SHA1 environment variable when running make to make use of
  71 # a bundled SHA1 routine optimized for ARM.
  72 #
  73 # Define MOZILLA_SHA1 environment variable when running make to make use of
  74 # a bundled SHA1 routine coming from Mozilla. It is GPL'd and should be fast
  75 # on non-x86 architectures (e.g. PowerPC), while the OpenSSL version (default
  76 # choice) has very fast version optimized for i586.
  77 #
  78 # Define NEEDS_SSL_WITH_CRYPTO if you need -lcrypto with -lssl (Darwin).
  79 #
  80 # Define NEEDS_LIBICONV if linking with libc is not enough (Darwin).
  81 #
  82 # Define NEEDS_SOCKET if linking with libc is not enough (SunOS,
  83 # Patrick Mauritz).
  84 #
  85 # Define NO_MMAP if you want to avoid mmap.
  86 #
  87 # Define NO_PTHREADS if you do not have or do not want to use Pthreads.
  88 #
  89 # Define NO_PREAD if you have a problem with pread() system call (e.g.
  90 # cygwin.dll before v1.5.22).
  91 #
  92 # Define NO_FAST_WORKING_DIRECTORY if accessing objects in pack files is
  93 # generally faster on your platform than accessing the working directory.
  94 #
  95 # Define NO_TRUSTABLE_FILEMODE if your filesystem may claim to support
  96 # the executable mode bit, but doesn't really do so.
  97 #
  98 # Define NO_IPV6 if you lack IPv6 support and getaddrinfo().
  99 #
 100 # Define NO_SOCKADDR_STORAGE if your platform does not have struct
 101 # sockaddr_storage.
 102 #
 103 # Define NO_ICONV if your libc does not properly support iconv.
 104 #
 105 # Define OLD_ICONV if your library has an old iconv(), where the second
 106 # (input buffer pointer) parameter is declared with type (const char **).
 107 #
 108 # Define NO_DEFLATE_BOUND if your zlib does not have deflateBound.
 109 #
 110 # Define NO_R_TO_GCC_LINKER if your gcc does not like "-R/path/lib"
 111 # that tells runtime paths to dynamic libraries;
 112 # "-Wl,-rpath=/path/lib" is used instead.
 113 #
 114 # Define USE_NSEC below if you want perf to care about sub-second file mtimes
 115 # and ctimes. Note that you need recent glibc (at least 2.2.4) for this, and
 116 # it will BREAK YOUR LOCAL DIFFS! show-diff and anything using it will likely
 117 # randomly break unless your underlying filesystem supports those sub-second
 118 # times (my ext3 doesn't).
 119 #
 120 # Define USE_ST_TIMESPEC if your "struct stat" uses "st_ctimespec" instead of
 121 # "st_ctim"
 122 #
 123 # Define NO_NSEC if your "struct stat" does not have "st_ctim.tv_nsec"
 124 # available.  This automatically turns USE_NSEC off.
 125 #
 126 # Define USE_STDEV below if you want perf to care about the underlying device
 127 # change being considered an inode change from the update-index perspective.
 128 #
 129 # Define NO_ST_BLOCKS_IN_STRUCT_STAT if your platform does not have st_blocks
 130 # field that counts the on-disk footprint in 512-byte blocks.
 131 #
 132 # Define ASCIIDOC8 if you want to format documentation with AsciiDoc 8
 133 #
 134 # Define DOCBOOK_XSL_172 if you want to format man pages with DocBook XSL v1.72.
 135 #
 136 # Define NO_PERL_MAKEMAKER if you cannot use Makefiles generated by perl's
 137 # MakeMaker (e.g. using ActiveState under Cygwin).
 138 #
 139 # Define NO_PERL if you do not want Perl scripts or libraries at all.
 140 #
 141 # Define INTERNAL_QSORT to use Git's implementation of qsort(), which
 142 # is a simplified version of the merge sort used in glibc. This is
 143 # recommended if Git triggers O(n^2) behavior in your platform's qsort().
 144 #
 145 # Define NO_EXTERNAL_GREP if you don't want "perf grep" to ever call
 146 # your external grep (e.g., if your system lacks grep, if its grep is
 147 # broken, or spawning external process is slower than built-in grep perf has).
 148
 149 PERF-VERSION-FILE: .FORCE-PERF-VERSION-FILE
 150         @$(SHELL_PATH) util/PERF-VERSION-GEN
 151 -include PERF-VERSION-FILE
 152
 153 uname_S := $(shell sh -c 'uname -s 2>/dev/null || echo not')
 154 uname_M := $(shell sh -c 'uname -m 2>/dev/null || echo not')
 155 uname_O := $(shell sh -c 'uname -o 2>/dev/null || echo not')
 156 uname_R := $(shell sh -c 'uname -r 2>/dev/null || echo not')
 157 uname_P := $(shell sh -c 'uname -p 2>/dev/null || echo not')
 158 uname_V := $(shell sh -c 'uname -v 2>/dev/null || echo not')
 159
 160 #
 161 # Add -m32 for cross-builds:
 162 #
 163 ifdef NO_64BIT
 164   MBITS := -m32
 165 else
 166   #
 167   # If we're on a 64-bit kernel, use -m64:
 168   #
 169   ifneq ($(patsubst %64,%,$(uname_M)),$(uname_M))
 170     MBITS := -m64
 171   endif
 172 endif
 173
 174 # CFLAGS and LDFLAGS are for the users to override from the command line.
 175
 176 #
 177 # Include saner warnings here, which can catch bugs:
 178 #
 179
 180 EXTRA_WARNINGS := -Wformat
 181 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wformat-security
 182 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wformat-y2k
 183 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wshadow
 184 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Winit-self
 185 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wpacked
 186 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wredundant-decls
 187 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wstack-protector
 188 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wstrict-aliasing=3
 189 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wswitch-default
 190 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wswitch-enum
 191 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wno-system-headers
 192 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wundef
 193 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wvolatile-register-var
 194 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wwrite-strings
 195 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wbad-function-cast
 196 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wmissing-declarations
 197 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wmissing-prototypes
 198 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wnested-externs
 199 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wold-style-definition
 200 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wstrict-prototypes
 201 EXTRA_WARNINGS := $(EXTRA_WARNINGS) -Wdeclaration-after-statement
 202
 203 CFLAGS = $(MBITS) -ggdb3 -Wall -Wextra -std=gnu99 -Werror -O6 -fstack-protector-all -D_FORTIFY_SOURCE=2 $(EXTRA_WARNINGS)
 204 LDFLAGS = -lpthread -lrt -lelf -lm
 205 ALL_CFLAGS = $(CFLAGS)
 206 ALL_LDFLAGS = $(LDFLAGS)
 207 STRIP ?= strip
 208
 209 # Among the variables below, these:
 210 #   perfexecdir
 211 #   template_dir
 212 #   mandir
 213 #   infodir
 214 #   htmldir
 215 #   ETC_PERFCONFIG (but not sysconfdir)
 216 # can be specified as a relative path some/where/else;
 217 # this is interpreted as relative to $(prefix) and "perf" at
 218 # runtime figures out where they are based on the path to the executable.
 219 # This can help installing the suite in a relocatable way.
 220
 221 prefix = $(HOME)
 222 bindir_relative = bin
 223 bindir = $(prefix)/$(bindir_relative)
 224 mandir = share/man
 225 infodir = share/info
 226 perfexecdir = libexec/perf-core
 227 sharedir = $(prefix)/share
 228 template_dir = share/perf-core/templates
 229 htmldir = share/doc/perf-doc
 230 ifeq ($(prefix),/usr)
 231 sysconfdir = /etc
 232 ETC_PERFCONFIG = $(sysconfdir)/perfconfig
 233 else
 234 sysconfdir = $(prefix)/etc
 235 ETC_PERFCONFIG = etc/perfconfig
 236 endif
 237 lib = lib
 238 # DESTDIR=
 239
 240 export prefix bindir sharedir sysconfdir
 241
 242 CC = gcc
 243 AR = ar
 244 RM = rm -f
 245 TAR = tar
 246 FIND = find
 247 INSTALL = install
 248 RPMBUILD = rpmbuild
 249 PTHREAD_LIBS = -lpthread
 250
 251 # sparse is architecture-neutral, which means that we need to tell it
 252 # explicitly what architecture to check for. Fix this up for yours..
 253 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
 254
 255
 256
 257 ### --- END CONFIGURATION SECTION ---
 258
 259 # Those must not be GNU-specific; they are shared with perl/ which may
 260 # be built by a different compiler. (Note that this is an artifact now
 261 # but it still might be nice to keep that distinction.)
 262 BASIC_CFLAGS = -Iutil/include
 263 BASIC_LDFLAGS =
 264
 265 # Guard against environment variables
 266 BUILTIN_OBJS =
 267 BUILT_INS =
 268 COMPAT_CFLAGS =
 269 COMPAT_OBJS =
 270 LIB_H =
 271 LIB_OBJS =
 272 SCRIPT_PERL =
 273 SCRIPT_SH =
 274 TEST_PROGRAMS =
 275
 276 #
 277 # No scripts right now:
 278 #
 279
 280 # SCRIPT_SH += perf-am.sh
 281
 282 #
 283 # No Perl scripts right now:
 284 #
 285
 286 # SCRIPT_PERL += perf-add--interactive.perl
 287
 288 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH)) \
 289           $(patsubst %.perl,%,$(SCRIPT_PERL))
 290
 291 # Empty...
 292 EXTRA_PROGRAMS =
 293
 294 # ... and all the rest that could be moved out of bindir to perfexecdir
 295 PROGRAMS += $(EXTRA_PROGRAMS)
 296
 297 #
 298 # Single 'perf' binary right now:
 299 #
 300 PROGRAMS += perf
 301
 302 # List built-in command $C whose implementation cmd_$C() is not in
 303 # builtin-$C.o but is linked in as part of some other command.
 304 #
 305 # None right now:
 306 #
 307 # BUILT_INS += perf-init $X
 308
 309 # what 'all' will build and 'install' will install, in perfexecdir
 310 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
 311
 312 # what 'all' will build but not install in perfexecdir
 313 OTHER_PROGRAMS = perf$X
 314
 315 # Set paths to tools early so that they can be used for version tests.
 316 ifndef SHELL_PATH
 317         SHELL_PATH = /bin/sh
 318 endif
 319 ifndef PERL_PATH
 320         PERL_PATH = /usr/bin/perl
 321 endif
 322
 323 export PERL_PATH
 324
 325 LIB_FILE=libperf.a
 326
 327 LIB_H += ../../include/linux/perf_event.h
 328 LIB_H += ../../include/linux/rbtree.h
 329 LIB_H += ../../include/linux/list.h
 330 LIB_H += util/include/linux/list.h
 331 LIB_H += perf.h
 332 LIB_H += util/types.h
 333 LIB_H += util/levenshtein.h
 334 LIB_H += util/parse-options.h
 335 LIB_H += util/parse-events.h
 336 LIB_H += util/quote.h
 337 LIB_H += util/util.h
 338 LIB_H += util/help.h
 339 LIB_H += util/strbuf.h
 340 LIB_H += util/string.h
 341 LIB_H += util/strlist.h
 342 LIB_H += util/run-command.h
 343 LIB_H += util/sigchain.h
 344 LIB_H += util/symbol.h
 345 LIB_H += util/module.h
 346 LIB_H += util/color.h
 347 LIB_H += util/values.h
 348
 349 LIB_OBJS += util/abspath.o
 350 LIB_OBJS += util/alias.o
 351 LIB_OBJS += util/config.o
 352 LIB_OBJS += util/ctype.o
 353 LIB_OBJS += util/environment.o
 354 LIB_OBJS += util/exec_cmd.o
 355 LIB_OBJS += util/help.o
 356 LIB_OBJS += util/levenshtein.o
 357 LIB_OBJS += util/parse-options.o
 358 LIB_OBJS += util/parse-events.o
 359 LIB_OBJS += util/path.o
 360 LIB_OBJS += util/rbtree.o
 361 LIB_OBJS += util/run-command.o
 362 LIB_OBJS += util/quote.o
 363 LIB_OBJS += util/strbuf.o
 364 LIB_OBJS += util/string.o
 365 LIB_OBJS += util/strlist.o
 366 LIB_OBJS += util/usage.o
 367 LIB_OBJS += util/wrapper.o
 368 LIB_OBJS += util/sigchain.o
 369 LIB_OBJS += util/symbol.o
 370 LIB_OBJS += util/module.o
 371 LIB_OBJS += util/color.o
 372 LIB_OBJS += util/pager.o
 373 LIB_OBJS += util/header.o
 374 LIB_OBJS += util/callchain.o
 375 LIB_OBJS += util/values.o
 376 LIB_OBJS += util/debug.o
 377 LIB_OBJS += util/map.o
 378 LIB_OBJS += util/thread.o
 379 LIB_OBJS += util/trace-event-parse.o
 380 LIB_OBJS += util/trace-event-read.o
 381 LIB_OBJS += util/trace-event-info.o
 382 LIB_OBJS += util/svghelper.o
 383
 384 BUILTIN_OBJS += builtin-annotate.o
 385 BUILTIN_OBJS += builtin-help.o
 386 BUILTIN_OBJS += builtin-sched.o
 387 BUILTIN_OBJS += builtin-list.o
 388 BUILTIN_OBJS += builtin-record.o
 389 BUILTIN_OBJS += builtin-report.o
 390 BUILTIN_OBJS += builtin-stat.o
 391 BUILTIN_OBJS += builtin-timechart.o
 392 BUILTIN_OBJS += builtin-top.o
 393 BUILTIN_OBJS += builtin-trace.o
 394
 395 PERFLIBS = $(LIB_FILE)
 396
 397 #
 398 # Platform specific tweaks
 399 #
 400
 401 # We choose to avoid "if .. else if .. else .. endif endif"
 402 # because maintaining the nesting to match is a pain.  If
 403 # we had "elif" things would have been much nicer...
 404
 405 -include config.mak.autogen
 406 -include config.mak
 407
 408 ifeq ($(uname_S),Darwin)
 409         ifndef NO_FINK
 410                 ifeq ($(shell test -d /sw/lib && echo y),y)
 411                         BASIC_CFLAGS += -I/sw/include
 412                         BASIC_LDFLAGS += -L/sw/lib
 413                 endif
 414         endif
 415         ifndef NO_DARWIN_PORTS
 416                 ifeq ($(shell test -d /opt/local/lib && echo y),y)
 417                         BASIC_CFLAGS += -I/opt/local/include
 418                         BASIC_LDFLAGS += -L/opt/local/lib
 419                 endif
 420         endif
 421         PTHREAD_LIBS =
 422 endif
 423
 424 ifeq ($(shell sh -c "(echo '\#include <libelf.h>'; echo 'int main(void) { Elf * elf = elf_begin(0, ELF_C_READ, 0); return (long)elf; }') | $(CC) -x c - $(ALL_CFLAGS) -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64 -o /dev/null $(ALL_LDFLAGS) > /dev/null 2>&1 && echo y"), y)
 425         ifneq ($(shell sh -c "(echo '\#include <libelf.h>'; echo 'int main(void) { Elf * elf = elf_begin(0, ELF_C_READ_MMAP, 0); return (long)elf; }') | $(CC) -x c - $(ALL_CFLAGS) -D_LARGEFILE64_SOURCE -D_FILE_OFFSET_BITS=64 -o /dev/null $(ALL_LDFLAGS) > /dev/null 2>&1 && echo y"), y)
 426                 BASIC_CFLAGS += -DLIBELF_NO_MMAP
 427         endif
 428 else
 429         msg := $(error No libelf.h/libelf found, please install libelf-dev/elfutils-libelf-devel and glibc-dev[el]);
 430 endif
 431
 432 ifdef NO_DEMANGLE
 433         BASIC_CFLAGS += -DNO_DEMANGLE
 434 else
 435         has_bfd := $(shell sh -c "(echo '\#include <bfd.h>'; echo 'int main(void) { bfd_demangle(0, 0, 0); return 0; }') | $(CC) -x c - $(ALL_CFLAGS) -o /dev/null $(ALL_LDFLAGS) -lbfd > /dev/null 2>&1 && echo y")
 436
 437         ifeq ($(has_bfd),y)
 438                 EXTLIBS += -lbfd
 439         else
 440                 has_bfd_iberty := $(shell sh -c "(echo '\#include <bfd.h>'; echo 'int main(void) { bfd_demangle(0, 0, 0); return 0; }') | $(CC) -x c - $(ALL_CFLAGS) -o /dev/null $(ALL_LDFLAGS) -lbfd -liberty > /dev/null 2>&1 && echo y")
 441                 ifeq ($(has_bfd_iberty),y)
 442                         EXTLIBS += -lbfd -liberty
 443                 else
 444                         has_bfd_iberty_z := $(shell sh -c "(echo '\#include <bfd.h>'; echo 'int main(void) { bfd_demangle(0, 0, 0); return 0; }') | $(CC) -x c - $(ALL_CFLAGS) -o /dev/null $(ALL_LDFLAGS) -lbfd -liberty -lz > /dev/null 2>&1 && echo y")
 445                         ifeq ($(has_bfd_iberty_z),y)
 446                                 EXTLIBS += -lbfd -liberty -lz
 447                         else
 448                                 has_cplus_demangle := $(shell sh -c "(echo 'extern char *cplus_demangle(const char *, int);'; echo 'int main(void) { cplus_demangle(0, 0); return 0; }') | $(CC) -x c - $(ALL_CFLAGS) -o /dev/null $(ALL_LDFLAGS) -liberty > /dev/null 2>&1 && echo y")
 449                                 ifeq ($(has_cplus_demangle),y)
 450                                         EXTLIBS += -liberty
 451                                         BASIC_CFLAGS += -DHAVE_CPLUS_DEMANGLE
 452                                 else
 453                                         msg := $(warning No bfd.h/libbfd found, install binutils-dev[el] to gain symbol demangling)
 454                                         BASIC_CFLAGS += -DNO_DEMANGLE
 455                                 endif
 456                         endif
 457                 endif
 458         endif
 459 endif
 460
 461 ifndef CC_LD_DYNPATH
 462         ifdef NO_R_TO_GCC_LINKER
 463                 # Some gcc does not accept and pass -R to the linker to specify
 464                 # the runtime dynamic library path.
 465                 CC_LD_DYNPATH = -Wl,-rpath,
 466         else
 467                 CC_LD_DYNPATH = -R
 468         endif
 469 endif
 470
 471 ifdef NEEDS_SOCKET
 472         EXTLIBS += -lsocket
 473 endif
 474 ifdef NEEDS_NSL
 475         EXTLIBS += -lnsl
 476 endif
 477 ifdef NO_D_TYPE_IN_DIRENT
 478         BASIC_CFLAGS += -DNO_D_TYPE_IN_DIRENT
 479 endif
 480 ifdef NO_D_INO_IN_DIRENT
 481         BASIC_CFLAGS += -DNO_D_INO_IN_DIRENT
 482 endif
 483 ifdef NO_ST_BLOCKS_IN_STRUCT_STAT
 484         BASIC_CFLAGS += -DNO_ST_BLOCKS_IN_STRUCT_STAT
 485 endif
 486 ifdef USE_NSEC
 487         BASIC_CFLAGS += -DUSE_NSEC
 488 endif
 489 ifdef USE_ST_TIMESPEC
 490         BASIC_CFLAGS += -DUSE_ST_TIMESPEC
 491 endif
 492 ifdef NO_NSEC
 493         BASIC_CFLAGS += -DNO_NSEC
 494 endif
 495 ifdef NO_C99_FORMAT
 496         BASIC_CFLAGS += -DNO_C99_FORMAT
 497 endif
 498 ifdef SNPRINTF_RETURNS_BOGUS
 499         COMPAT_CFLAGS += -DSNPRINTF_RETURNS_BOGUS
 500         COMPAT_OBJS += compat/snprintf.o
 501 endif
 502 ifdef FREAD_READS_DIRECTORIES
 503         COMPAT_CFLAGS += -DFREAD_READS_DIRECTORIES
 504         COMPAT_OBJS += compat/fopen.o
 505 endif
 506 ifdef NO_SYMLINK_HEAD
 507         BASIC_CFLAGS += -DNO_SYMLINK_HEAD
 508 endif
 509 ifdef NO_STRCASESTR
 510         COMPAT_CFLAGS += -DNO_STRCASESTR
 511         COMPAT_OBJS += compat/strcasestr.o
 512 endif
 513 ifdef NO_STRTOUMAX
 514         COMPAT_CFLAGS += -DNO_STRTOUMAX
 515         COMPAT_OBJS += compat/strtoumax.o
 516 endif
 517 ifdef NO_STRTOULL
 518         COMPAT_CFLAGS += -DNO_STRTOULL
 519 endif
 520 ifdef NO_SETENV
 521         COMPAT_CFLAGS += -DNO_SETENV
 522         COMPAT_OBJS += compat/setenv.o
 523 endif
 524 ifdef NO_MKDTEMP
 525         COMPAT_CFLAGS += -DNO_MKDTEMP
 526         COMPAT_OBJS += compat/mkdtemp.o
 527 endif
 528 ifdef NO_UNSETENV
 529         COMPAT_CFLAGS += -DNO_UNSETENV
 530         COMPAT_OBJS += compat/unsetenv.o
 531 endif
 532 ifdef NO_SYS_SELECT_H
 533         BASIC_CFLAGS += -DNO_SYS_SELECT_H
 534 endif
 535 ifdef NO_MMAP
 536         COMPAT_CFLAGS += -DNO_MMAP
 537         COMPAT_OBJS += compat/mmap.o
 538 else
 539         ifdef USE_WIN32_MMAP
 540                 COMPAT_CFLAGS += -DUSE_WIN32_MMAP
 541                 COMPAT_OBJS += compat/win32mmap.o
 542         endif
 543 endif
 544 ifdef NO_PREAD
 545         COMPAT_CFLAGS += -DNO_PREAD
 546         COMPAT_OBJS += compat/pread.o
 547 endif
 548 ifdef NO_FAST_WORKING_DIRECTORY
 549         BASIC_CFLAGS += -DNO_FAST_WORKING_DIRECTORY
 550 endif
 551 ifdef NO_TRUSTABLE_FILEMODE
 552         BASIC_CFLAGS += -DNO_TRUSTABLE_FILEMODE
 553 endif
 554 ifdef NO_IPV6
 555         BASIC_CFLAGS += -DNO_IPV6
 556 endif
 557 ifdef NO_UINTMAX_T
 558         BASIC_CFLAGS += -Duintmax_t=uint32_t
 559 endif
 560 ifdef NO_SOCKADDR_STORAGE
 561 ifdef NO_IPV6
 562         BASIC_CFLAGS += -Dsockaddr_storage=sockaddr_in
 563 else
 564         BASIC_CFLAGS += -Dsockaddr_storage=sockaddr_in6
 565 endif
 566 endif
 567 ifdef NO_INET_NTOP
 568         LIB_OBJS += compat/inet_ntop.o
 569 endif
 570 ifdef NO_INET_PTON
 571         LIB_OBJS += compat/inet_pton.o
 572 endif
 573
 574 ifdef NO_ICONV
 575         BASIC_CFLAGS += -DNO_ICONV
 576 endif
 577
 578 ifdef OLD_ICONV
 579         BASIC_CFLAGS += -DOLD_ICONV
 580 endif
 581
 582 ifdef NO_DEFLATE_BOUND
 583         BASIC_CFLAGS += -DNO_DEFLATE_BOUND
 584 endif
 585
 586 ifdef PPC_SHA1
 587         SHA1_HEADER = "ppc/sha1.h"
 588         LIB_OBJS += ppc/sha1.o ppc/sha1ppc.o
 589 else
 590 ifdef ARM_SHA1
 591         SHA1_HEADER = "arm/sha1.h"
 592         LIB_OBJS += arm/sha1.o arm/sha1_arm.o
 593 else
 594 ifdef MOZILLA_SHA1
 595         SHA1_HEADER = "mozilla-sha1/sha1.h"
 596         LIB_OBJS += mozilla-sha1/sha1.o
 597 else
 598         SHA1_HEADER = <openssl/sha.h>
 599         EXTLIBS += $(LIB_4_CRYPTO)
 600 endif
 601 endif
 602 endif
 603 ifdef NO_PERL_MAKEMAKER
 604         export NO_PERL_MAKEMAKER
 605 endif
 606 ifdef NO_HSTRERROR
 607         COMPAT_CFLAGS += -DNO_HSTRERROR
 608         COMPAT_OBJS += compat/hstrerror.o
 609 endif
 610 ifdef NO_MEMMEM
 611         COMPAT_CFLAGS += -DNO_MEMMEM
 612         COMPAT_OBJS += compat/memmem.o
 613 endif
 614 ifdef INTERNAL_QSORT
 615         COMPAT_CFLAGS += -DINTERNAL_QSORT
 616         COMPAT_OBJS += compat/qsort.o
 617 endif
 618 ifdef RUNTIME_PREFIX
 619         COMPAT_CFLAGS += -DRUNTIME_PREFIX
 620 endif
 621
 622 ifdef DIR_HAS_BSD_GROUP_SEMANTICS
 623         COMPAT_CFLAGS += -DDIR_HAS_BSD_GROUP_SEMANTICS
 624 endif
 625 ifdef NO_EXTERNAL_GREP
 626         BASIC_CFLAGS += -DNO_EXTERNAL_GREP
 627 endif
 628
 629 ifeq ($(PERL_PATH),)
 630 NO_PERL=NoThanks
 631 endif
 632
 633 QUIET_SUBDIR0  = +$(MAKE) -C # space to separate -C and subdir
 634 QUIET_SUBDIR1  =
 635
 636 ifneq ($(findstring $(MAKEFLAGS),w),w)
 637 PRINT_DIR = --no-print-directory
 638 else # "make -w"
 639 NO_SUBDIR = :
 640 endif
 641
 642 ifneq ($(findstring $(MAKEFLAGS),s),s)
 643 ifndef V
 644         QUIET_CC       = @echo '   ' CC $@;
 645         QUIET_AR       = @echo '   ' AR $@;
 646         QUIET_LINK     = @echo '   ' LINK $@;
 647         QUIET_BUILT_IN = @echo '   ' BUILTIN $@;
 648         QUIET_GEN      = @echo '   ' GEN $@;
 649         QUIET_SUBDIR0  = +@subdir=
 650         QUIET_SUBDIR1  = ;$(NO_SUBDIR) echo '   ' SUBDIR $$subdir; \
 651                          $(MAKE) $(PRINT_DIR) -C $$subdir
 652         export V
 653         export QUIET_GEN
 654         export QUIET_BUILT_IN
 655 endif
 656 endif
 657
 658 ifdef ASCIIDOC8
 659         export ASCIIDOC8
 660 endif
 661
 662 # Shell quote (do not use $(call) to accommodate ancient setups);
 663
 664 SHA1_HEADER_SQ = $(subst ','\'',$(SHA1_HEADER))
 665 ETC_PERFCONFIG_SQ = $(subst ','\'',$(ETC_PERFCONFIG))
 666
 667 DESTDIR_SQ = $(subst ','\'',$(DESTDIR))
 668 bindir_SQ = $(subst ','\'',$(bindir))
 669 bindir_relative_SQ = $(subst ','\'',$(bindir_relative))
 670 mandir_SQ = $(subst ','\'',$(mandir))
 671 infodir_SQ = $(subst ','\'',$(infodir))
 672 perfexecdir_SQ = $(subst ','\'',$(perfexecdir))
 673 template_dir_SQ = $(subst ','\'',$(template_dir))
 674 htmldir_SQ = $(subst ','\'',$(htmldir))
 675 prefix_SQ = $(subst ','\'',$(prefix))
 676
 677 SHELL_PATH_SQ = $(subst ','\'',$(SHELL_PATH))
 678 PERL_PATH_SQ = $(subst ','\'',$(PERL_PATH))
 679
 680 LIBS = $(PERFLIBS) $(EXTLIBS)
 681
 682 BASIC_CFLAGS += -DSHA1_HEADER='$(SHA1_HEADER_SQ)' \
 683         $(COMPAT_CFLAGS)
 684 LIB_OBJS += $(COMPAT_OBJS)
 685
 686 ALL_CFLAGS += $(BASIC_CFLAGS)
 687 ALL_LDFLAGS += $(BASIC_LDFLAGS)
 688
 689 export TAR INSTALL DESTDIR SHELL_PATH
 690
 691
 692 ### Build rules
 693
 694 SHELL = $(SHELL_PATH)
 695
 696 all:: shell_compatibility_test $(ALL_PROGRAMS) $(BUILT_INS) $(OTHER_PROGRAMS) PERF-BUILD-OPTIONS
 697 ifneq (,$X)
 698         $(foreach p,$(patsubst %$X,%,$(filter %$X,$(ALL_PROGRAMS) $(BUILT_INS) perf$X)), test '$p' -ef '$p$X' || $(RM) '$p';)
 699 endif
 700
 701 all::
 702
 703 please_set_SHELL_PATH_to_a_more_modern_shell:
 704         @$$(:)
 705
 706 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
 707
 708 strip: $(PROGRAMS) perf$X
 709         $(STRIP) $(STRIP_OPTS) $(PROGRAMS) perf$X
 710
 711 perf.o: perf.c common-cmds.h PERF-CFLAGS
 712         $(QUIET_CC)$(CC) -DPERF_VERSION='"$(PERF_VERSION)"' \
 713                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
 714                 $(ALL_CFLAGS) -c $(filter %.c,$^)
 715
 716 perf$X: perf.o $(BUILTIN_OBJS) $(PERFLIBS)
 717         $(QUIET_LINK)$(CC) $(ALL_CFLAGS) -o $@ perf.o \
 718                 $(BUILTIN_OBJS) $(ALL_LDFLAGS) $(LIBS)
 719
 720 builtin-help.o: builtin-help.c common-cmds.h PERF-CFLAGS
 721         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) \
 722                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
 723                 '-DPERF_MAN_PATH="$(mandir_SQ)"' \
 724                 '-DPERF_INFO_PATH="$(infodir_SQ)"' $<
 725
 726 builtin-timechart.o: builtin-timechart.c common-cmds.h PERF-CFLAGS
 727         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) \
 728                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
 729                 '-DPERF_MAN_PATH="$(mandir_SQ)"' \
 730                 '-DPERF_INFO_PATH="$(infodir_SQ)"' $<
 731
 732 $(BUILT_INS): perf$X
 733         $(QUIET_BUILT_IN)$(RM) $@ && \
 734         ln perf$X $@ 2>/dev/null || \
 735         ln -s perf$X $@ 2>/dev/null || \
 736         cp perf$X $@
 737
 738 common-cmds.h: util/generate-cmdlist.sh command-list.txt
 739
 740 common-cmds.h: $(wildcard Documentation/perf-*.txt)
 741         $(QUIET_GEN). util/generate-cmdlist.sh > $@+ && mv $@+ $@
 742
 743 $(patsubst %.sh,%,$(SCRIPT_SH)) : % : %.sh
 744         $(QUIET_GEN)$(RM) $@ $@+ && \
 745         sed -e '1s|#!.*/sh|#!$(SHELL_PATH_SQ)|' \
 746             -e 's|@SHELL_PATH@|$(SHELL_PATH_SQ)|' \
 747             -e 's|@@PERL@@|$(PERL_PATH_SQ)|g' \
 748             -e 's/@@PERF_VERSION@@/$(PERF_VERSION)/g' \
 749             -e 's/@@NO_CURL@@/$(NO_CURL)/g' \
 750             $@.sh >$@+ && \
 751         chmod +x $@+ && \
 752         mv $@+ $@
 753
 754 configure: configure.ac
 755         $(QUIET_GEN)$(RM) $@ $<+ && \
 756         sed -e 's/@@PERF_VERSION@@/$(PERF_VERSION)/g' \
 757             $< > $<+ && \
 758         autoconf -o $@ $<+ && \
 759         $(RM) $<+
 760
 761 # These can record PERF_VERSION
 762 perf.o perf.spec \
 763         $(patsubst %.sh,%,$(SCRIPT_SH)) \
 764         $(patsubst %.perl,%,$(SCRIPT_PERL)) \
 765         : PERF-VERSION-FILE
 766
 767 %.o: %.c PERF-CFLAGS
 768         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) $<
 769 %.s: %.c PERF-CFLAGS
 770         $(QUIET_CC)$(CC) -S $(ALL_CFLAGS) $<
 771 %.o: %.S
 772         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) $<
 773
 774 util/exec_cmd.o: util/exec_cmd.c PERF-CFLAGS
 775         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) \
 776                 '-DPERF_EXEC_PATH="$(perfexecdir_SQ)"' \
 777                 '-DBINDIR="$(bindir_relative_SQ)"' \
 778                 '-DPREFIX="$(prefix_SQ)"' \
 779                 $<
 780
 781 builtin-init-db.o: builtin-init-db.c PERF-CFLAGS
 782         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) -DDEFAULT_PERF_TEMPLATE_DIR='"$(template_dir_SQ)"' $<
 783
 784 util/config.o: util/config.c PERF-CFLAGS
 785         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) -DETC_PERFCONFIG='"$(ETC_PERFCONFIG_SQ)"' $<
 786
 787 util/rbtree.o: ../../lib/rbtree.c PERF-CFLAGS
 788         $(QUIET_CC)$(CC) -o util/rbtree.o -c $(ALL_CFLAGS) -DETC_PERFCONFIG='"$(ETC_PERFCONFIG_SQ)"' $<
 789
 790 perf-%$X: %.o $(PERFLIBS)
 791         $(QUIET_LINK)$(CC) $(ALL_CFLAGS) -o $@ $(ALL_LDFLAGS) $(filter %.o,$^) $(LIBS)
 792
 793 $(LIB_OBJS) $(BUILTIN_OBJS): $(LIB_H)
 794 $(patsubst perf-%$X,%.o,$(PROGRAMS)): $(LIB_H) $(wildcard */*.h)
 795 builtin-revert.o wt-status.o: wt-status.h
 796
 797 $(LIB_FILE): $(LIB_OBJS)
 798         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIB_OBJS)
 799
 800 doc:
 801         $(MAKE) -C Documentation all
 802
 803 man:
 804         $(MAKE) -C Documentation man
 805
 806 html:
 807         $(MAKE) -C Documentation html
 808
 809 info:
 810         $(MAKE) -C Documentation info
 811
 812 pdf:
 813         $(MAKE) -C Documentation pdf
 814
 815 TAGS:
 816         $(RM) TAGS
 817         $(FIND) . -name '*.[hcS]' -print | xargs etags -a
 818
 819 tags:
 820         $(RM) tags
 821         $(FIND) . -name '*.[hcS]' -print | xargs ctags -a
 822
 823 cscope:
 824         $(RM) cscope*
 825         $(FIND) . -name '*.[hcS]' -print | xargs cscope -b
 826
 827 ### Detect prefix changes
 828 TRACK_CFLAGS = $(subst ','\'',$(ALL_CFLAGS)):\
 829              $(bindir_SQ):$(perfexecdir_SQ):$(template_dir_SQ):$(prefix_SQ)
 830
 831 PERF-CFLAGS: .FORCE-PERF-CFLAGS
 832         @FLAGS='$(TRACK_CFLAGS)'; \
 833             if test x"$$FLAGS" != x"`cat PERF-CFLAGS 2>/dev/null`" ; then \
 834                 echo 1>&2 "    * new build flags or prefix"; \
 835                 echo "$$FLAGS" >PERF-CFLAGS; \
 836             fi
 837
 838 # We need to apply sq twice, once to protect from the shell
 839 # that runs PERF-BUILD-OPTIONS, and then again to protect it
 840 # and the first level quoting from the shell that runs "echo".
 841 PERF-BUILD-OPTIONS: .FORCE-PERF-BUILD-OPTIONS
 842         @echo SHELL_PATH=\''$(subst ','\'',$(SHELL_PATH_SQ))'\' >$@
 843         @echo TAR=\''$(subst ','\'',$(subst ','\'',$(TAR)))'\' >>$@
 844         @echo NO_CURL=\''$(subst ','\'',$(subst ','\'',$(NO_CURL)))'\' >>$@
 845         @echo NO_PERL=\''$(subst ','\'',$(subst ','\'',$(NO_PERL)))'\' >>$@
 846
 847 ### Testing rules
 848
 849 #
 850 # None right now:
 851 #
 852 # TEST_PROGRAMS += test-something$X
 853
 854 all:: $(TEST_PROGRAMS)
 855
 856 # GNU make supports exporting all variables by "export" without parameters.
 857 # However, the environment gets quite big, and some programs have problems
 858 # with that.
 859
 860 export NO_SVN_TESTS
 861
 862 check: common-cmds.h
 863         if sparse; \
 864         then \
 865                 for i in *.c */*.c; \
 866                 do \
 867                         sparse $(ALL_CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
 868                 done; \
 869         else \
 870                 echo 2>&1 "Did you mean 'make test'?"; \
 871                 exit 1; \
 872         fi
 873
 874 remove-dashes:
 875         ./fixup-builtins $(BUILT_INS) $(PROGRAMS) $(SCRIPTS)
 876
 877 ### Installation rules
 878
 879 ifneq ($(filter /%,$(firstword $(template_dir))),)
 880 template_instdir = $(template_dir)
 881 else
 882 template_instdir = $(prefix)/$(template_dir)
 883 endif
 884 export template_instdir
 885
 886 ifneq ($(filter /%,$(firstword $(perfexecdir))),)
 887 perfexec_instdir = $(perfexecdir)
 888 else
 889 perfexec_instdir = $(prefix)/$(perfexecdir)
 890 endif
 891 perfexec_instdir_SQ = $(subst ','\'',$(perfexec_instdir))
 892 export perfexec_instdir
 893
 894 install: all
 895         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'
 896         $(INSTALL) perf$X '$(DESTDIR_SQ)$(bindir_SQ)'
 897 ifdef BUILT_INS
 898         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 899         $(INSTALL) $(BUILT_INS) '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
 900 ifneq (,$X)
 901         $(foreach p,$(patsubst %$X,%,$(filter %$X,$(ALL_PROGRAMS) $(BUILT_INS) perf$X)), $(RM) '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/$p';)
 902 endif
 903 endif
 904
 905 install-doc:
 906         $(MAKE) -C Documentation install
 907
 908 install-man:
 909         $(MAKE) -C Documentation install-man
 910
 911 install-html:
 912         $(MAKE) -C Documentation install-html
 913
 914 install-info:
 915         $(MAKE) -C Documentation install-info
 916
 917 install-pdf:
 918         $(MAKE) -C Documentation install-pdf
 919
 920 quick-install-doc:
 921         $(MAKE) -C Documentation quick-install
 922
 923 quick-install-man:
 924         $(MAKE) -C Documentation quick-install-man
 925
 926 quick-install-html:
 927         $(MAKE) -C Documentation quick-install-html
 928
 929
 930 ### Maintainer's dist rules
 931 #
 932 # None right now
 933 #
 934 #
 935 # perf.spec: perf.spec.in
 936 #       sed -e 's/@@VERSION@@/$(PERF_VERSION)/g' < $< > $@+
 937 #       mv $@+ $@
 938 #
 939 # PERF_TARNAME=perf-$(PERF_VERSION)
 940 # dist: perf.spec perf-archive$(X) configure
 941 #       ./perf-archive --format=tar \
 942 #               --prefix=$(PERF_TARNAME)/ HEAD^{tree} > $(PERF_TARNAME).tar
 943 #       @mkdir -p $(PERF_TARNAME)
 944 #       @cp perf.spec configure $(PERF_TARNAME)
 945 #       @echo $(PERF_VERSION) > $(PERF_TARNAME)/version
 946 #       $(TAR) rf $(PERF_TARNAME).tar \
 947 #               $(PERF_TARNAME)/perf.spec \
 948 #               $(PERF_TARNAME)/configure \
 949 #               $(PERF_TARNAME)/version
 950 #       @$(RM) -r $(PERF_TARNAME)
 951 #       gzip -f -9 $(PERF_TARNAME).tar
 952 #
 953 # htmldocs = perf-htmldocs-$(PERF_VERSION)
 954 # manpages = perf-manpages-$(PERF_VERSION)
 955 # dist-doc:
 956 #       $(RM) -r .doc-tmp-dir
 957 #       mkdir .doc-tmp-dir
 958 #       $(MAKE) -C Documentation WEBDOC_DEST=../.doc-tmp-dir install-webdoc
 959 #       cd .doc-tmp-dir && $(TAR) cf ../$(htmldocs).tar .
 960 #       gzip -n -9 -f $(htmldocs).tar
 961 #       :
 962 #       $(RM) -r .doc-tmp-dir
 963 #       mkdir -p .doc-tmp-dir/man1 .doc-tmp-dir/man5 .doc-tmp-dir/man7
 964 #       $(MAKE) -C Documentation DESTDIR=./ \
 965 #               man1dir=../.doc-tmp-dir/man1 \
 966 #               man5dir=../.doc-tmp-dir/man5 \
 967 #               man7dir=../.doc-tmp-dir/man7 \
 968 #               install
 969 #       cd .doc-tmp-dir && $(TAR) cf ../$(manpages).tar .
 970 #       gzip -n -9 -f $(manpages).tar
 971 #       $(RM) -r .doc-tmp-dir
 972 #
 973 # rpm: dist
 974 #       $(RPMBUILD) -ta $(PERF_TARNAME).tar.gz
 975
 976 ### Cleaning rules
 977
 978 distclean: clean
 979 #       $(RM) configure
 980
 981 clean:
 982         $(RM) *.o */*.o $(LIB_FILE)
 983         $(RM) $(ALL_PROGRAMS) $(BUILT_INS) perf$X
 984         $(RM) $(TEST_PROGRAMS)
 985         $(RM) *.spec *.pyc *.pyo */*.pyc */*.pyo common-cmds.h TAGS tags cscope*
 986         $(RM) -r autom4te.cache
 987         $(RM) config.log config.mak.autogen config.mak.append config.status config.cache
 988         $(RM) -r $(PERF_TARNAME) .doc-tmp-dir
 989         $(RM) $(PERF_TARNAME).tar.gz perf-core_$(PERF_VERSION)-*.tar.gz
 990         $(RM) $(htmldocs).tar.gz $(manpages).tar.gz
 991         $(MAKE) -C Documentation/ clean
 992         $(RM) PERF-VERSION-FILE PERF-CFLAGS PERF-BUILD-OPTIONS
 993
 994 .PHONY: all install clean strip
 995 .PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
 996 .PHONY: .FORCE-PERF-VERSION-FILE TAGS tags cscope .FORCE-PERF-CFLAGS
 997 .PHONY: .FORCE-PERF-BUILD-OPTIONS
 998
 999 ### Make sure built-ins do not have dups and listed in perf.c
1000 #
1001 check-builtins::
1002         ./check-builtins.sh
1003
1004 ### Test suite coverage testing
1005 #
1006 # None right now
1007 #
1008 # .PHONY: coverage coverage-clean coverage-build coverage-report
1009 #
1010 # coverage:
1011 #       $(MAKE) coverage-build
1012 #       $(MAKE) coverage-report
1013 #
1014 # coverage-clean:
1015 #       rm -f *.gcda *.gcno
1016 #
1017 # COVERAGE_CFLAGS = $(CFLAGS) -O0 -ftest-coverage -fprofile-arcs
1018 # COVERAGE_LDFLAGS = $(CFLAGS)  -O0 -lgcov
1019 #
1020 # coverage-build: coverage-clean
1021 #       $(MAKE) CFLAGS="$(COVERAGE_CFLAGS)" LDFLAGS="$(COVERAGE_LDFLAGS)" all
1022 #       $(MAKE) CFLAGS="$(COVERAGE_CFLAGS)" LDFLAGS="$(COVERAGE_LDFLAGS)" \
1023 #               -j1 test
1024 #
1025 # coverage-report:
1026 #       gcov -b *.c */*.c
1027 #       grep '^function.*called 0 ' *.c.gcov */*.c.gcov \
1028 #               | sed -e 's/\([^:]*\)\.gcov: *function \([^ ]*\) called.*/\1: \2/' \
1029 #               | tee coverage-untested-functions