3b8275feb889804c0d0d5a3eff011cdf4236f6a7
[safe/jmp/linux-2.6] / Documentation / perf_counter / 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 # CFLAGS and LDFLAGS are for the users to override from the command line.
161
162 CFLAGS = -ggdb3 -Wall -Werror -Wstrict-prototypes -Wmissing-declarations -Wmissing-prototypes -std=gnu99 -Wdeclaration-after-statement
163 LDFLAGS = -lpthread -lrt -lelf
164 ALL_CFLAGS = $(CFLAGS)
165 ALL_LDFLAGS = $(LDFLAGS)
166 STRIP ?= strip
167
168 # Among the variables below, these:
169 #   perfexecdir
170 #   template_dir
171 #   mandir
172 #   infodir
173 #   htmldir
174 #   ETC_PERFCONFIG (but not sysconfdir)
175 # can be specified as a relative path some/where/else;
176 # this is interpreted as relative to $(prefix) and "perf" at
177 # runtime figures out where they are based on the path to the executable.
178 # This can help installing the suite in a relocatable way.
179
180 prefix = $(HOME)
181 bindir_relative = bin
182 bindir = $(prefix)/$(bindir_relative)
183 mandir = share/man
184 infodir = share/info
185 perfexecdir = libexec/perf-core
186 sharedir = $(prefix)/share
187 template_dir = share/perf-core/templates
188 htmldir = share/doc/perf-doc
189 ifeq ($(prefix),/usr)
190 sysconfdir = /etc
191 ETC_PERFCONFIG = $(sysconfdir)/perfconfig
192 else
193 sysconfdir = $(prefix)/etc
194 ETC_PERFCONFIG = etc/perfconfig
195 endif
196 lib = lib
197 # DESTDIR=
198
199 export prefix bindir sharedir sysconfdir
200
201 CC = gcc
202 AR = ar
203 RM = rm -f
204 TAR = tar
205 FIND = find
206 INSTALL = install
207 RPMBUILD = rpmbuild
208 PTHREAD_LIBS = -lpthread
209
210 # sparse is architecture-neutral, which means that we need to tell it
211 # explicitly what architecture to check for. Fix this up for yours..
212 SPARSE_FLAGS = -D__BIG_ENDIAN__ -D__powerpc__
213
214
215
216 ### --- END CONFIGURATION SECTION ---
217
218 # Those must not be GNU-specific; they are shared with perl/ which may
219 # be built by a different compiler. (Note that this is an artifact now
220 # but it still might be nice to keep that distinction.)
221 BASIC_CFLAGS =
222 BASIC_LDFLAGS =
223
224 # Guard against environment variables
225 BUILTIN_OBJS =
226 BUILT_INS =
227 COMPAT_CFLAGS =
228 COMPAT_OBJS =
229 LIB_H =
230 LIB_OBJS =
231 SCRIPT_PERL =
232 SCRIPT_SH =
233 TEST_PROGRAMS =
234
235 #
236 # No scripts right now:
237 #
238
239 # SCRIPT_SH += perf-am.sh
240
241 #
242 # No Perl scripts right now:
243 #
244
245 # SCRIPT_PERL += perf-add--interactive.perl
246
247 SCRIPTS = $(patsubst %.sh,%,$(SCRIPT_SH)) \
248           $(patsubst %.perl,%,$(SCRIPT_PERL))
249
250 # Empty...
251 EXTRA_PROGRAMS =
252
253 # ... and all the rest that could be moved out of bindir to perfexecdir
254 PROGRAMS += $(EXTRA_PROGRAMS)
255
256 #
257 # Single 'perf' binary right now:
258 #
259 PROGRAMS += perf
260
261 # List built-in command $C whose implementation cmd_$C() is not in
262 # builtin-$C.o but is linked in as part of some other command.
263 BUILT_INS += $(patsubst builtin-%.o,perf-%$X,$(BUILTIN_OBJS))
264
265 #
266 # None right now:
267 #
268 # BUILT_INS += perf-init $X
269
270 # what 'all' will build and 'install' will install, in perfexecdir
271 ALL_PROGRAMS = $(PROGRAMS) $(SCRIPTS)
272
273 # what 'all' will build but not install in perfexecdir
274 OTHER_PROGRAMS = perf$X
275
276 # Set paths to tools early so that they can be used for version tests.
277 ifndef SHELL_PATH
278         SHELL_PATH = /bin/sh
279 endif
280 ifndef PERL_PATH
281         PERL_PATH = /usr/bin/perl
282 endif
283
284 export PERL_PATH
285
286 LIB_FILE=libperf.a
287
288 LIB_H += ../../include/linux/perf_counter.h
289 LIB_H += perf.h
290 LIB_H += util/list.h
291 LIB_H += util/rbtree.h
292 LIB_H += util/levenshtein.h
293 LIB_H += util/parse-options.h
294 LIB_H += util/parse-events.h
295 LIB_H += util/quote.h
296 LIB_H += util/util.h
297 LIB_H += util/help.h
298 LIB_H += util/strbuf.h
299 LIB_H += util/string.h
300 LIB_H += util/run-command.h
301 LIB_H += util/sigchain.h
302 LIB_H += util/symbol.h
303
304 LIB_OBJS += util/abspath.o
305 LIB_OBJS += util/alias.o
306 LIB_OBJS += util/config.o
307 LIB_OBJS += util/ctype.o
308 LIB_OBJS += util/environment.o
309 LIB_OBJS += util/exec_cmd.o
310 LIB_OBJS += util/help.o
311 LIB_OBJS += util/levenshtein.o
312 LIB_OBJS += util/parse-options.o
313 LIB_OBJS += util/parse-events.o
314 LIB_OBJS += util/path.o
315 LIB_OBJS += util/rbtree.o
316 LIB_OBJS += util/run-command.o
317 LIB_OBJS += util/quote.o
318 LIB_OBJS += util/strbuf.o
319 LIB_OBJS += util/string.o
320 LIB_OBJS += util/usage.o
321 LIB_OBJS += util/wrapper.o
322 LIB_OBJS += util/sigchain.o
323 LIB_OBJS += util/symbol.o
324 LIB_OBJS += util/pager.o
325
326 BUILTIN_OBJS += builtin-help.o
327 BUILTIN_OBJS += builtin-record.o
328 BUILTIN_OBJS += builtin-report.o
329 BUILTIN_OBJS += builtin-stat.o
330 BUILTIN_OBJS += builtin-top.o
331
332 PERFLIBS = $(LIB_FILE)
333 EXTLIBS =
334
335 #
336 # Platform specific tweaks
337 #
338
339 # We choose to avoid "if .. else if .. else .. endif endif"
340 # because maintaining the nesting to match is a pain.  If
341 # we had "elif" things would have been much nicer...
342
343 -include config.mak.autogen
344 -include config.mak
345
346 ifeq ($(uname_S),Darwin)
347         ifndef NO_FINK
348                 ifeq ($(shell test -d /sw/lib && echo y),y)
349                         BASIC_CFLAGS += -I/sw/include
350                         BASIC_LDFLAGS += -L/sw/lib
351                 endif
352         endif
353         ifndef NO_DARWIN_PORTS
354                 ifeq ($(shell test -d /opt/local/lib && echo y),y)
355                         BASIC_CFLAGS += -I/opt/local/include
356                         BASIC_LDFLAGS += -L/opt/local/lib
357                 endif
358         endif
359         PTHREAD_LIBS =
360 endif
361
362 ifndef CC_LD_DYNPATH
363         ifdef NO_R_TO_GCC_LINKER
364                 # Some gcc does not accept and pass -R to the linker to specify
365                 # the runtime dynamic library path.
366                 CC_LD_DYNPATH = -Wl,-rpath,
367         else
368                 CC_LD_DYNPATH = -R
369         endif
370 endif
371
372 ifdef ZLIB_PATH
373         BASIC_CFLAGS += -I$(ZLIB_PATH)/include
374         EXTLIBS += -L$(ZLIB_PATH)/$(lib) $(CC_LD_DYNPATH)$(ZLIB_PATH)/$(lib)
375 endif
376 EXTLIBS += -lz
377
378 ifdef NEEDS_SOCKET
379         EXTLIBS += -lsocket
380 endif
381 ifdef NEEDS_NSL
382         EXTLIBS += -lnsl
383 endif
384 ifdef NO_D_TYPE_IN_DIRENT
385         BASIC_CFLAGS += -DNO_D_TYPE_IN_DIRENT
386 endif
387 ifdef NO_D_INO_IN_DIRENT
388         BASIC_CFLAGS += -DNO_D_INO_IN_DIRENT
389 endif
390 ifdef NO_ST_BLOCKS_IN_STRUCT_STAT
391         BASIC_CFLAGS += -DNO_ST_BLOCKS_IN_STRUCT_STAT
392 endif
393 ifdef USE_NSEC
394         BASIC_CFLAGS += -DUSE_NSEC
395 endif
396 ifdef USE_ST_TIMESPEC
397         BASIC_CFLAGS += -DUSE_ST_TIMESPEC
398 endif
399 ifdef NO_NSEC
400         BASIC_CFLAGS += -DNO_NSEC
401 endif
402 ifdef NO_C99_FORMAT
403         BASIC_CFLAGS += -DNO_C99_FORMAT
404 endif
405 ifdef SNPRINTF_RETURNS_BOGUS
406         COMPAT_CFLAGS += -DSNPRINTF_RETURNS_BOGUS
407         COMPAT_OBJS += compat/snprintf.o
408 endif
409 ifdef FREAD_READS_DIRECTORIES
410         COMPAT_CFLAGS += -DFREAD_READS_DIRECTORIES
411         COMPAT_OBJS += compat/fopen.o
412 endif
413 ifdef NO_SYMLINK_HEAD
414         BASIC_CFLAGS += -DNO_SYMLINK_HEAD
415 endif
416 ifdef NO_STRCASESTR
417         COMPAT_CFLAGS += -DNO_STRCASESTR
418         COMPAT_OBJS += compat/strcasestr.o
419 endif
420 ifdef NO_STRTOUMAX
421         COMPAT_CFLAGS += -DNO_STRTOUMAX
422         COMPAT_OBJS += compat/strtoumax.o
423 endif
424 ifdef NO_STRTOULL
425         COMPAT_CFLAGS += -DNO_STRTOULL
426 endif
427 ifdef NO_SETENV
428         COMPAT_CFLAGS += -DNO_SETENV
429         COMPAT_OBJS += compat/setenv.o
430 endif
431 ifdef NO_MKDTEMP
432         COMPAT_CFLAGS += -DNO_MKDTEMP
433         COMPAT_OBJS += compat/mkdtemp.o
434 endif
435 ifdef NO_UNSETENV
436         COMPAT_CFLAGS += -DNO_UNSETENV
437         COMPAT_OBJS += compat/unsetenv.o
438 endif
439 ifdef NO_SYS_SELECT_H
440         BASIC_CFLAGS += -DNO_SYS_SELECT_H
441 endif
442 ifdef NO_MMAP
443         COMPAT_CFLAGS += -DNO_MMAP
444         COMPAT_OBJS += compat/mmap.o
445 else
446         ifdef USE_WIN32_MMAP
447                 COMPAT_CFLAGS += -DUSE_WIN32_MMAP
448                 COMPAT_OBJS += compat/win32mmap.o
449         endif
450 endif
451 ifdef NO_PREAD
452         COMPAT_CFLAGS += -DNO_PREAD
453         COMPAT_OBJS += compat/pread.o
454 endif
455 ifdef NO_FAST_WORKING_DIRECTORY
456         BASIC_CFLAGS += -DNO_FAST_WORKING_DIRECTORY
457 endif
458 ifdef NO_TRUSTABLE_FILEMODE
459         BASIC_CFLAGS += -DNO_TRUSTABLE_FILEMODE
460 endif
461 ifdef NO_IPV6
462         BASIC_CFLAGS += -DNO_IPV6
463 endif
464 ifdef NO_UINTMAX_T
465         BASIC_CFLAGS += -Duintmax_t=uint32_t
466 endif
467 ifdef NO_SOCKADDR_STORAGE
468 ifdef NO_IPV6
469         BASIC_CFLAGS += -Dsockaddr_storage=sockaddr_in
470 else
471         BASIC_CFLAGS += -Dsockaddr_storage=sockaddr_in6
472 endif
473 endif
474 ifdef NO_INET_NTOP
475         LIB_OBJS += compat/inet_ntop.o
476 endif
477 ifdef NO_INET_PTON
478         LIB_OBJS += compat/inet_pton.o
479 endif
480
481 ifdef NO_ICONV
482         BASIC_CFLAGS += -DNO_ICONV
483 endif
484
485 ifdef OLD_ICONV
486         BASIC_CFLAGS += -DOLD_ICONV
487 endif
488
489 ifdef NO_DEFLATE_BOUND
490         BASIC_CFLAGS += -DNO_DEFLATE_BOUND
491 endif
492
493 ifdef PPC_SHA1
494         SHA1_HEADER = "ppc/sha1.h"
495         LIB_OBJS += ppc/sha1.o ppc/sha1ppc.o
496 else
497 ifdef ARM_SHA1
498         SHA1_HEADER = "arm/sha1.h"
499         LIB_OBJS += arm/sha1.o arm/sha1_arm.o
500 else
501 ifdef MOZILLA_SHA1
502         SHA1_HEADER = "mozilla-sha1/sha1.h"
503         LIB_OBJS += mozilla-sha1/sha1.o
504 else
505         SHA1_HEADER = <openssl/sha.h>
506         EXTLIBS += $(LIB_4_CRYPTO)
507 endif
508 endif
509 endif
510 ifdef NO_PERL_MAKEMAKER
511         export NO_PERL_MAKEMAKER
512 endif
513 ifdef NO_HSTRERROR
514         COMPAT_CFLAGS += -DNO_HSTRERROR
515         COMPAT_OBJS += compat/hstrerror.o
516 endif
517 ifdef NO_MEMMEM
518         COMPAT_CFLAGS += -DNO_MEMMEM
519         COMPAT_OBJS += compat/memmem.o
520 endif
521 ifdef INTERNAL_QSORT
522         COMPAT_CFLAGS += -DINTERNAL_QSORT
523         COMPAT_OBJS += compat/qsort.o
524 endif
525 ifdef RUNTIME_PREFIX
526         COMPAT_CFLAGS += -DRUNTIME_PREFIX
527 endif
528
529 ifdef DIR_HAS_BSD_GROUP_SEMANTICS
530         COMPAT_CFLAGS += -DDIR_HAS_BSD_GROUP_SEMANTICS
531 endif
532 ifdef NO_EXTERNAL_GREP
533         BASIC_CFLAGS += -DNO_EXTERNAL_GREP
534 endif
535
536 ifeq ($(PERL_PATH),)
537 NO_PERL=NoThanks
538 endif
539
540 QUIET_SUBDIR0  = +$(MAKE) -C # space to separate -C and subdir
541 QUIET_SUBDIR1  =
542
543 ifneq ($(findstring $(MAKEFLAGS),w),w)
544 PRINT_DIR = --no-print-directory
545 else # "make -w"
546 NO_SUBDIR = :
547 endif
548
549 ifneq ($(findstring $(MAKEFLAGS),s),s)
550 ifndef V
551         QUIET_CC       = @echo '   ' CC $@;
552         QUIET_AR       = @echo '   ' AR $@;
553         QUIET_LINK     = @echo '   ' LINK $@;
554         QUIET_BUILT_IN = @echo '   ' BUILTIN $@;
555         QUIET_GEN      = @echo '   ' GEN $@;
556         QUIET_SUBDIR0  = +@subdir=
557         QUIET_SUBDIR1  = ;$(NO_SUBDIR) echo '   ' SUBDIR $$subdir; \
558                          $(MAKE) $(PRINT_DIR) -C $$subdir
559         export V
560         export QUIET_GEN
561         export QUIET_BUILT_IN
562 endif
563 endif
564
565 ifdef ASCIIDOC8
566         export ASCIIDOC8
567 endif
568
569 # Shell quote (do not use $(call) to accommodate ancient setups);
570
571 SHA1_HEADER_SQ = $(subst ','\'',$(SHA1_HEADER))
572 ETC_PERFCONFIG_SQ = $(subst ','\'',$(ETC_PERFCONFIG))
573
574 DESTDIR_SQ = $(subst ','\'',$(DESTDIR))
575 bindir_SQ = $(subst ','\'',$(bindir))
576 bindir_relative_SQ = $(subst ','\'',$(bindir_relative))
577 mandir_SQ = $(subst ','\'',$(mandir))
578 infodir_SQ = $(subst ','\'',$(infodir))
579 perfexecdir_SQ = $(subst ','\'',$(perfexecdir))
580 template_dir_SQ = $(subst ','\'',$(template_dir))
581 htmldir_SQ = $(subst ','\'',$(htmldir))
582 prefix_SQ = $(subst ','\'',$(prefix))
583
584 SHELL_PATH_SQ = $(subst ','\'',$(SHELL_PATH))
585 PERL_PATH_SQ = $(subst ','\'',$(PERL_PATH))
586
587 LIBS = $(PERFLIBS) $(EXTLIBS)
588
589 BASIC_CFLAGS += -DSHA1_HEADER='$(SHA1_HEADER_SQ)' \
590         $(COMPAT_CFLAGS)
591 LIB_OBJS += $(COMPAT_OBJS)
592
593 ALL_CFLAGS += $(BASIC_CFLAGS)
594 ALL_LDFLAGS += $(BASIC_LDFLAGS)
595
596 export TAR INSTALL DESTDIR SHELL_PATH
597
598
599 ### Build rules
600
601 SHELL = $(SHELL_PATH)
602
603 all:: shell_compatibility_test $(ALL_PROGRAMS) $(BUILT_INS) $(OTHER_PROGRAMS) PERF-BUILD-OPTIONS
604 ifneq (,$X)
605         $(foreach p,$(patsubst %$X,%,$(filter %$X,$(ALL_PROGRAMS) $(BUILT_INS) perf$X)), test '$p' -ef '$p$X' || $(RM) '$p';)
606 endif
607
608 all::
609
610 please_set_SHELL_PATH_to_a_more_modern_shell:
611         @$$(:)
612
613 shell_compatibility_test: please_set_SHELL_PATH_to_a_more_modern_shell
614
615 strip: $(PROGRAMS) perf$X
616         $(STRIP) $(STRIP_OPTS) $(PROGRAMS) perf$X
617
618 perf.o: perf.c common-cmds.h PERF-CFLAGS
619         $(QUIET_CC)$(CC) -DPERF_VERSION='"$(PERF_VERSION)"' \
620                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
621                 $(ALL_CFLAGS) -c $(filter %.c,$^)
622
623 perf$X: perf.o $(BUILTIN_OBJS) $(PERFLIBS)
624         $(QUIET_LINK)$(CC) $(ALL_CFLAGS) -o $@ perf.o \
625                 $(BUILTIN_OBJS) $(ALL_LDFLAGS) $(LIBS)
626
627 builtin-help.o: builtin-help.c common-cmds.h PERF-CFLAGS
628         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) \
629                 '-DPERF_HTML_PATH="$(htmldir_SQ)"' \
630                 '-DPERF_MAN_PATH="$(mandir_SQ)"' \
631                 '-DPERF_INFO_PATH="$(infodir_SQ)"' $<
632
633 $(BUILT_INS): perf$X
634         $(QUIET_BUILT_IN)$(RM) $@ && \
635         ln perf$X $@ 2>/dev/null || \
636         ln -s perf$X $@ 2>/dev/null || \
637         cp perf$X $@
638
639 common-cmds.h: util/generate-cmdlist.sh command-list.txt
640
641 common-cmds.h: $(wildcard Documentation/perf-*.txt)
642         $(QUIET_GEN)util/generate-cmdlist.sh > $@+ && mv $@+ $@
643
644 $(patsubst %.sh,%,$(SCRIPT_SH)) : % : %.sh
645         $(QUIET_GEN)$(RM) $@ $@+ && \
646         sed -e '1s|#!.*/sh|#!$(SHELL_PATH_SQ)|' \
647             -e 's|@SHELL_PATH@|$(SHELL_PATH_SQ)|' \
648             -e 's|@@PERL@@|$(PERL_PATH_SQ)|g' \
649             -e 's/@@PERF_VERSION@@/$(PERF_VERSION)/g' \
650             -e 's/@@NO_CURL@@/$(NO_CURL)/g' \
651             $@.sh >$@+ && \
652         chmod +x $@+ && \
653         mv $@+ $@
654
655 configure: configure.ac
656         $(QUIET_GEN)$(RM) $@ $<+ && \
657         sed -e 's/@@PERF_VERSION@@/$(PERF_VERSION)/g' \
658             $< > $<+ && \
659         autoconf -o $@ $<+ && \
660         $(RM) $<+
661
662 # These can record PERF_VERSION
663 perf.o perf.spec \
664         $(patsubst %.sh,%,$(SCRIPT_SH)) \
665         $(patsubst %.perl,%,$(SCRIPT_PERL)) \
666         : PERF-VERSION-FILE
667
668 %.o: %.c PERF-CFLAGS
669         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) $<
670 %.s: %.c PERF-CFLAGS
671         $(QUIET_CC)$(CC) -S $(ALL_CFLAGS) $<
672 %.o: %.S
673         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) $<
674
675 util/exec_cmd.o: util/exec_cmd.c PERF-CFLAGS
676         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) \
677                 '-DPERF_EXEC_PATH="$(perfexecdir_SQ)"' \
678                 '-DBINDIR="$(bindir_relative_SQ)"' \
679                 '-DPREFIX="$(prefix_SQ)"' \
680                 $<
681
682 builtin-init-db.o: builtin-init-db.c PERF-CFLAGS
683         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) -DDEFAULT_PERF_TEMPLATE_DIR='"$(template_dir_SQ)"' $<
684
685 util/config.o: util/config.c PERF-CFLAGS
686         $(QUIET_CC)$(CC) -o $*.o -c $(ALL_CFLAGS) -DETC_PERFCONFIG='"$(ETC_PERFCONFIG_SQ)"' $<
687
688 perf-%$X: %.o $(PERFLIBS)
689         $(QUIET_LINK)$(CC) $(ALL_CFLAGS) -o $@ $(ALL_LDFLAGS) $(filter %.o,$^) $(LIBS)
690
691 $(LIB_OBJS) $(BUILTIN_OBJS): $(LIB_H)
692 $(patsubst perf-%$X,%.o,$(PROGRAMS)): $(LIB_H) $(wildcard */*.h)
693 builtin-revert.o wt-status.o: wt-status.h
694
695 $(LIB_FILE): $(LIB_OBJS)
696         $(QUIET_AR)$(RM) $@ && $(AR) rcs $@ $(LIB_OBJS)
697
698 doc:
699         $(MAKE) -C Documentation all
700
701 man:
702         $(MAKE) -C Documentation man
703
704 html:
705         $(MAKE) -C Documentation html
706
707 info:
708         $(MAKE) -C Documentation info
709
710 pdf:
711         $(MAKE) -C Documentation pdf
712
713 TAGS:
714         $(RM) TAGS
715         $(FIND) . -name '*.[hcS]' -print | xargs etags -a
716
717 tags:
718         $(RM) tags
719         $(FIND) . -name '*.[hcS]' -print | xargs ctags -a
720
721 cscope:
722         $(RM) cscope*
723         $(FIND) . -name '*.[hcS]' -print | xargs cscope -b
724
725 ### Detect prefix changes
726 TRACK_CFLAGS = $(subst ','\'',$(ALL_CFLAGS)):\
727              $(bindir_SQ):$(perfexecdir_SQ):$(template_dir_SQ):$(prefix_SQ)
728
729 PERF-CFLAGS: .FORCE-PERF-CFLAGS
730         @FLAGS='$(TRACK_CFLAGS)'; \
731             if test x"$$FLAGS" != x"`cat PERF-CFLAGS 2>/dev/null`" ; then \
732                 echo 1>&2 "    * new build flags or prefix"; \
733                 echo "$$FLAGS" >PERF-CFLAGS; \
734             fi
735
736 # We need to apply sq twice, once to protect from the shell
737 # that runs PERF-BUILD-OPTIONS, and then again to protect it
738 # and the first level quoting from the shell that runs "echo".
739 PERF-BUILD-OPTIONS: .FORCE-PERF-BUILD-OPTIONS
740         @echo SHELL_PATH=\''$(subst ','\'',$(SHELL_PATH_SQ))'\' >$@
741         @echo TAR=\''$(subst ','\'',$(subst ','\'',$(TAR)))'\' >>$@
742         @echo NO_CURL=\''$(subst ','\'',$(subst ','\'',$(NO_CURL)))'\' >>$@
743         @echo NO_PERL=\''$(subst ','\'',$(subst ','\'',$(NO_PERL)))'\' >>$@
744
745 ### Testing rules
746
747 #
748 # None right now:
749 #
750 # TEST_PROGRAMS += test-something$X
751
752 all:: $(TEST_PROGRAMS)
753
754 # GNU make supports exporting all variables by "export" without parameters.
755 # However, the environment gets quite big, and some programs have problems
756 # with that.
757
758 export NO_SVN_TESTS
759
760 check: common-cmds.h
761         if sparse; \
762         then \
763                 for i in *.c */*.c; \
764                 do \
765                         sparse $(ALL_CFLAGS) $(SPARSE_FLAGS) $$i || exit; \
766                 done; \
767         else \
768                 echo 2>&1 "Did you mean 'make test'?"; \
769                 exit 1; \
770         fi
771
772 remove-dashes:
773         ./fixup-builtins $(BUILT_INS) $(PROGRAMS) $(SCRIPTS)
774
775 ### Installation rules
776
777 ifneq ($(filter /%,$(firstword $(template_dir))),)
778 template_instdir = $(template_dir)
779 else
780 template_instdir = $(prefix)/$(template_dir)
781 endif
782 export template_instdir
783
784 ifneq ($(filter /%,$(firstword $(perfexecdir))),)
785 perfexec_instdir = $(perfexecdir)
786 else
787 perfexec_instdir = $(prefix)/$(perfexecdir)
788 endif
789 perfexec_instdir_SQ = $(subst ','\'',$(perfexec_instdir))
790 export perfexec_instdir
791
792 install: all
793         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(bindir_SQ)'
794         $(INSTALL) -d -m 755 '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
795         $(INSTALL) $(ALL_PROGRAMS) '$(DESTDIR_SQ)$(perfexec_instdir_SQ)'
796         $(INSTALL) perf$X '$(DESTDIR_SQ)$(bindir_SQ)'
797 ifneq (,$X)
798         $(foreach p,$(patsubst %$X,%,$(filter %$X,$(ALL_PROGRAMS) $(BUILT_INS) perf$X)), $(RM) '$(DESTDIR_SQ)$(perfexec_instdir_SQ)/$p';)
799 endif
800
801 install-doc:
802         $(MAKE) -C Documentation install
803
804 install-man:
805         $(MAKE) -C Documentation install-man
806
807 install-html:
808         $(MAKE) -C Documentation install-html
809
810 install-info:
811         $(MAKE) -C Documentation install-info
812
813 install-pdf:
814         $(MAKE) -C Documentation install-pdf
815
816 quick-install-doc:
817         $(MAKE) -C Documentation quick-install
818
819 quick-install-man:
820         $(MAKE) -C Documentation quick-install-man
821
822 quick-install-html:
823         $(MAKE) -C Documentation quick-install-html
824
825
826 ### Maintainer's dist rules
827
828 perf.spec: perf.spec.in
829         sed -e 's/@@VERSION@@/$(PERF_VERSION)/g' < $< > $@+
830         mv $@+ $@
831
832 PERF_TARNAME=perf-$(PERF_VERSION)
833 dist: perf.spec perf-archive$(X) configure
834         ./perf-archive --format=tar \
835                 --prefix=$(PERF_TARNAME)/ HEAD^{tree} > $(PERF_TARNAME).tar
836         @mkdir -p $(PERF_TARNAME)
837         @cp perf.spec configure $(PERF_TARNAME)
838         @echo $(PERF_VERSION) > $(PERF_TARNAME)/version
839         $(TAR) rf $(PERF_TARNAME).tar \
840                 $(PERF_TARNAME)/perf.spec \
841                 $(PERF_TARNAME)/configure \
842                 $(PERF_TARNAME)/version
843         @$(RM) -r $(PERF_TARNAME)
844         gzip -f -9 $(PERF_TARNAME).tar
845
846 htmldocs = perf-htmldocs-$(PERF_VERSION)
847 manpages = perf-manpages-$(PERF_VERSION)
848 dist-doc:
849         $(RM) -r .doc-tmp-dir
850         mkdir .doc-tmp-dir
851         $(MAKE) -C Documentation WEBDOC_DEST=../.doc-tmp-dir install-webdoc
852         cd .doc-tmp-dir && $(TAR) cf ../$(htmldocs).tar .
853         gzip -n -9 -f $(htmldocs).tar
854         :
855         $(RM) -r .doc-tmp-dir
856         mkdir -p .doc-tmp-dir/man1 .doc-tmp-dir/man5 .doc-tmp-dir/man7
857         $(MAKE) -C Documentation DESTDIR=./ \
858                 man1dir=../.doc-tmp-dir/man1 \
859                 man5dir=../.doc-tmp-dir/man5 \
860                 man7dir=../.doc-tmp-dir/man7 \
861                 install
862         cd .doc-tmp-dir && $(TAR) cf ../$(manpages).tar .
863         gzip -n -9 -f $(manpages).tar
864         $(RM) -r .doc-tmp-dir
865
866 rpm: dist
867         $(RPMBUILD) -ta $(PERF_TARNAME).tar.gz
868
869 ### Cleaning rules
870
871 distclean: clean
872         $(RM) configure
873
874 clean:
875         $(RM) *.o */*.o $(LIB_FILE)
876         $(RM) $(ALL_PROGRAMS) $(BUILT_INS) perf$X
877         $(RM) $(TEST_PROGRAMS)
878         $(RM) *.spec *.pyc *.pyo */*.pyc */*.pyo common-cmds.h TAGS tags cscope*
879         $(RM) -r autom4te.cache
880         $(RM) config.log config.mak.autogen config.mak.append config.status config.cache
881         $(RM) -r $(PERF_TARNAME) .doc-tmp-dir
882         $(RM) $(PERF_TARNAME).tar.gz perf-core_$(PERF_VERSION)-*.tar.gz
883         $(RM) $(htmldocs).tar.gz $(manpages).tar.gz
884         $(MAKE) -C Documentation/ clean
885         $(RM) PERF-VERSION-FILE PERF-CFLAGS PERF-BUILD-OPTIONS
886
887 .PHONY: all install clean strip
888 .PHONY: shell_compatibility_test please_set_SHELL_PATH_to_a_more_modern_shell
889 .PHONY: .FORCE-PERF-VERSION-FILE TAGS tags cscope .FORCE-PERF-CFLAGS
890 .PHONY: .FORCE-PERF-BUILD-OPTIONS
891
892 ### Make sure built-ins do not have dups and listed in perf.c
893 #
894 check-builtins::
895         ./check-builtins.sh
896
897 ### Test suite coverage testing
898 #
899 .PHONY: coverage coverage-clean coverage-build coverage-report
900
901 coverage:
902         $(MAKE) coverage-build
903         $(MAKE) coverage-report
904
905 coverage-clean:
906         rm -f *.gcda *.gcno
907
908 COVERAGE_CFLAGS = $(CFLAGS) -O0 -ftest-coverage -fprofile-arcs
909 COVERAGE_LDFLAGS = $(CFLAGS)  -O0 -lgcov
910
911 coverage-build: coverage-clean
912         $(MAKE) CFLAGS="$(COVERAGE_CFLAGS)" LDFLAGS="$(COVERAGE_LDFLAGS)" all
913         $(MAKE) CFLAGS="$(COVERAGE_CFLAGS)" LDFLAGS="$(COVERAGE_LDFLAGS)" \
914                 -j1 test
915
916 coverage-report:
917         gcov -b *.c */*.c
918         grep '^function.*called 0 ' *.c.gcov */*.c.gcov \
919                 | sed -e 's/\([^:]*\)\.gcov: *function \([^ ]*\) called.*/\1: \2/' \
920                 | tee coverage-untested-functions