2 # src/Makefile.global.in
5 #------------------------------------------------------------------------------
6 # All PostgreSQL makefiles include this file and use the variables it sets,
7 # which in turn are put here by the configure script. There is no need for
8 # users to edit this file -- if it turns out to be necessary then that's a
11 # A makefile that includes this file needs to set the variable `subdir' to
12 # the relative path from the top to itself and `top_builddir' to the relative
13 # path from itself to the top before including this file. (The "top" is the
14 # parent directory of the directory this file is in.)
15 #------------------------------------------------------------------------------
18 ##########################################################################
22 standard_targets = all install installdirs uninstall distprep clean distclean maintainer-clean coverage check installcheck init-po update-po
23 # these targets should recurse even into subdirectories not being built:
24 standard_always_targets = distprep clean distclean maintainer-clean
26 .PHONY: $(standard_targets) install-strip html man installcheck-parallel maintainer-check
28 # make `all' the default target
31 # Delete target files if the command fails after it has
32 # started to update the file.
35 # Never delete any intermediate files automatically.
38 # PostgreSQL version number
39 VERSION = @PACKAGE_VERSION@
40 MAJORVERSION = @PG_MAJORVERSION@
41 VERSION_NUM = @PG_VERSION_NUM@
43 # Set top_srcdir, srcdir, and VPATH.
45 top_srcdir = $(top_builddir)
47 # If VPATH is set or Makefile is not in current directory we are building
48 # the extension with VPATH so we set the variable here.
52 ifeq ($(CURDIR),$(dir $(firstword $(MAKEFILE_LIST))))
56 srcdir = $(dir $(firstword $(MAKEFILE_LIST)))
61 vpath_build = @vpath_build@
62 abs_top_builddir = @abs_top_builddir@
63 abs_top_srcdir = @abs_top_srcdir@
65 ifneq ($(vpath_build),yes)
66 top_srcdir = $(top_builddir)
68 else # vpath_build = yes
69 top_srcdir = $(abs_top_srcdir)
70 srcdir = $(top_srcdir)/$(subdir)
75 vpathsearch = `for f in $(addsuffix /$(1),$(subst :, ,. $(VPATH))); do test -r $$f && echo $$f && break; done`
77 # Saved arguments from configure
78 configure_args = @configure_args@
81 ##########################################################################
83 # Installation directories
85 # These are set by the equivalent --xxxdir configure options. We
86 # append "postgresql" to some of them, if the string does not already
87 # contain "pgsql" or "postgres", in order to avoid directory clutter.
89 # In a PGXS build, we cannot use the values inserted into Makefile.global
90 # by configure, since the installation tree may have been relocated.
91 # Instead get the path values from pg_config.
95 # Note that prefix, exec_prefix, and datarootdir aren't defined in a PGXS build;
96 # makefiles may only use the derived variables such as bindir.
99 exec_prefix := @exec_prefix@
100 datarootdir := @datarootdir@
105 ifeq "$(findstring pgsql, $(datadir))" ""
106 ifeq "$(findstring postgres, $(datadir))" ""
107 override datadir := $(datadir)/postgresql
111 sysconfdir := @sysconfdir@
112 ifeq "$(findstring pgsql, $(sysconfdir))" ""
113 ifeq "$(findstring postgres, $(sysconfdir))" ""
114 override sysconfdir := $(sysconfdir)/postgresql
120 pkglibdir = $(libdir)
121 ifeq "$(findstring pgsql, $(pkglibdir))" ""
122 ifeq "$(findstring postgres, $(pkglibdir))" ""
123 override pkglibdir := $(pkglibdir)/postgresql
127 includedir := @includedir@
129 pkgincludedir = $(includedir)
130 ifeq "$(findstring pgsql, $(pkgincludedir))" ""
131 ifeq "$(findstring postgres, $(pkgincludedir))" ""
132 override pkgincludedir := $(pkgincludedir)/postgresql
139 ifeq "$(findstring pgsql, $(docdir))" ""
140 ifeq "$(findstring postgres, $(docdir))" ""
141 override docdir := $(docdir)/postgresql
147 localedir := @localedir@
151 # Extension makefiles should set PG_CONFIG, but older ones might not
153 PG_CONFIG = pg_config
156 bindir := $(shell $(PG_CONFIG) --bindir)
157 datadir := $(shell $(PG_CONFIG) --sharedir)
158 sysconfdir := $(shell $(PG_CONFIG) --sysconfdir)
159 libdir := $(shell $(PG_CONFIG) --libdir)
160 pkglibdir := $(shell $(PG_CONFIG) --pkglibdir)
161 includedir := $(shell $(PG_CONFIG) --includedir)
162 pkgincludedir := $(shell $(PG_CONFIG) --pkgincludedir)
163 mandir := $(shell $(PG_CONFIG) --mandir)
164 docdir := $(shell $(PG_CONFIG) --docdir)
165 localedir := $(shell $(PG_CONFIG) --localedir)
169 # These derived path variables aren't separately configurable.
171 includedir_server = $(pkgincludedir)/server
172 includedir_internal = $(pkgincludedir)/internal
173 pgxsdir = $(pkglibdir)/pgxs
176 ##########################################################################
180 # Records the choice of the various --enable-xxx and --with-xxx options.
182 with_perl = @with_perl@
183 with_python = @with_python@
184 with_tcl = @with_tcl@
185 with_openssl = @with_openssl@
186 with_selinux = @with_selinux@
187 with_systemd = @with_systemd@
188 with_libxml = @with_libxml@
189 with_libxslt = @with_libxslt@
190 with_system_tzdata = @with_system_tzdata@
191 with_uuid = @with_uuid@
192 with_zlib = @with_zlib@
193 enable_rpath = @enable_rpath@
194 enable_nls = @enable_nls@
195 enable_debug = @enable_debug@
196 enable_dtrace = @enable_dtrace@
197 enable_coverage = @enable_coverage@
198 enable_tap_tests = @enable_tap_tests@
199 enable_thread_safety = @enable_thread_safety@
201 python_includespec = @python_includespec@
202 python_libdir = @python_libdir@
203 python_libspec = @python_libspec@
204 python_additional_libs = @python_additional_libs@
205 python_majorversion = @python_majorversion@
206 python_version = @python_version@
208 krb_srvtab = @krb_srvtab@
211 TCL_LIBS = @TCL_LIBS@
212 TCL_LIB_SPEC = @TCL_LIB_SPEC@
213 TCL_INCLUDE_SPEC = @TCL_INCLUDE_SPEC@
214 TCL_SHARED_BUILD = @TCL_SHARED_BUILD@
215 TCL_SHLIB_LD_LIBS = @TCL_SHLIB_LD_LIBS@
217 PTHREAD_CFLAGS = @PTHREAD_CFLAGS@
218 PTHREAD_LIBS = @PTHREAD_LIBS@
221 ##########################################################################
228 CPPFLAGS = @CPPFLAGS@
231 override CPPFLAGS := -I$(includedir_server) -I$(includedir_internal) $(CPPFLAGS)
233 override CPPFLAGS := -I$(top_srcdir)/src/include $(CPPFLAGS)
235 override CPPFLAGS := -I$(top_builddir)/src/include $(CPPFLAGS)
241 SUN_STUDIO_CC = @SUN_STUDIO_CC@
243 CFLAGS_VECTOR = @CFLAGS_VECTOR@
244 CFLAGS_SSE42 = @CFLAGS_SSE42@
249 BISONFLAGS = @BISONFLAGS@ $(YFLAGS)
251 FLEXFLAGS = @FLEXFLAGS@ $(LFLAGS)
253 DTRACEFLAGS = @DTRACEFLAGS@
262 LDAP_LIBS_FE = @LDAP_LIBS_FE@
263 LDAP_LIBS_BE = @LDAP_LIBS_BE@
264 UUID_LIBS = @UUID_LIBS@
265 UUID_EXTRA_OBJS = @UUID_EXTRA_OBJS@
267 with_gnu_ld = @with_gnu_ld@
268 ld_R_works = @ld_R_works@
270 # We want -L for libpgport.a and libpgcommon.a to be first in LDFLAGS. We
271 # also need LDFLAGS to be a "recursively expanded" variable, else adjustments
272 # to rpathdir don't work right. So we must NOT do LDFLAGS := something,
273 # meaning this has to be done first and elsewhere we must only do LDFLAGS +=
276 LDFLAGS = -L$(libdir)
278 LDFLAGS = -L$(top_builddir)/src/port -L$(top_builddir)/src/common
282 LDFLAGS_EX = @LDFLAGS_EX@
283 # LDFLAGS_SL might have already been assigned by calling makefile
284 LDFLAGS_SL += @LDFLAGS_SL@
294 # quoted to protect pathname with spaces
297 PERL = $(missing) perl
299 perl_archlibexp = @perl_archlibexp@
300 perl_privlibexp = @perl_privlibexp@
301 perl_embed_ldflags = @perl_embed_ldflags@
308 MSGFMT_FLAGS = @MSGFMT_FLAGS@
309 MSGMERGE = @MSGMERGE@
312 XGETTEXT = @XGETTEXT@
323 ifndef NO_TEMP_INSTALL
324 ifneq ($(abs_top_builddir),)
325 ifeq ($(MAKELEVEL),0)
326 rm -rf '$(abs_top_builddir)'/tmp_install
327 $(MKDIR_P) '$(abs_top_builddir)'/tmp_install/log
328 $(MAKE) -C '$(top_builddir)' DESTDIR='$(abs_top_builddir)'/tmp_install install >'$(abs_top_builddir)'/tmp_install/log/install.log 2>&1
330 $(if $(EXTRA_INSTALL),for extra in $(EXTRA_INSTALL); do $(MAKE) -C '$(top_builddir)'/$$extra DESTDIR='$(abs_top_builddir)'/tmp_install install >>'$(abs_top_builddir)'/tmp_install/log/install.log || exit; done)
335 PG_PROVE_FLAGS = -I $(top_srcdir)/src/test/perl/
336 PROVE_FLAGS = --verbose
338 # prepend to path if already set, else just set it
340 $(1)="$(if $($(1)),$(2):$$$(1),$(2))"
343 # platform-specific environment variable to set shared library path
344 define ld_library_path_var
345 $(if $(filter $(PORTNAME),darwin),DYLD_LIBRARY_PATH,$(if $(filter $(PORTNAME),aix),LIBPATH,LD_LIBRARY_PATH))
348 define with_temp_install
349 PATH="$(abs_top_builddir)/tmp_install$(bindir):$$PATH" $(call add_to_path,$(ld_library_path_var),$(abs_top_builddir)/tmp_install$(libdir))
352 ifeq ($(enable_tap_tests),yes)
354 define prove_installcheck
355 rm -rf $(CURDIR)/tmp_check/log
356 cd $(srcdir) && TESTDIR='$(CURDIR)' PATH="$(bindir):$$PATH" PGPORT='6$(DEF_PGPORT)' top_builddir='$(CURDIR)/$(top_builddir)' PG_REGRESS='$(CURDIR)/$(top_builddir)/src/test/regress/pg_regress' $(PROVE) $(PG_PROVE_FLAGS) $(PROVE_FLAGS) t/*.pl
360 rm -rf $(CURDIR)/tmp_check/log
361 cd $(srcdir) && TESTDIR='$(CURDIR)' $(with_temp_install) PGPORT='6$(DEF_PGPORT)' PG_REGRESS='$(CURDIR)/$(top_builddir)/src/test/regress/pg_regress' $(PROVE) $(PG_PROVE_FLAGS) $(PROVE_FLAGS) t/*.pl
365 prove_installcheck = @echo "TAP tests not enabled"
366 prove_check = $(prove_installcheck)
371 install_bin = @install_bin@
372 install_sh = $(SHELL) $(top_srcdir)/config/install-sh -c
373 INSTALL = $(if $(use_install_sh),$(install_sh),$(if $(install_bin),$(install_bin),$(install_sh)))
375 INSTALL_SCRIPT_MODE = 755
376 INSTALL_DATA_MODE = 644
377 INSTALL_PROGRAM = $(INSTALL_PROGRAM_ENV) $(INSTALL) $(INSTALL_STRIP_FLAG)
378 INSTALL_SCRIPT = $(INSTALL) -m $(INSTALL_SCRIPT_MODE)
379 INSTALL_DATA = $(INSTALL) -m $(INSTALL_DATA_MODE)
380 INSTALL_STLIB = $(INSTALL_STLIB_ENV) $(INSTALL_DATA) $(INSTALL_STRIP_FLAG)
381 INSTALL_SHLIB = $(INSTALL_SHLIB_ENV) $(INSTALL) $(INSTALL_SHLIB_OPTS) $(INSTALL_STRIP_FLAG)
382 # Override in Makefile.port if necessary
383 INSTALL_SHLIB_OPTS = -m 755
387 missing = $(SHELL) $(top_srcdir)/config/missing
390 STRIP_STATIC_LIB = @STRIP_STATIC_LIB@
391 STRIP_SHARED_LIB = @STRIP_SHARED_LIB@
395 have_docbook = @have_docbook@
396 COLLATEINDEX = @COLLATEINDEX@
397 DBTOEPUB = @DBTOEPUB@
398 DOCBOOKSTYLE = @DOCBOOKSTYLE@
403 XSLTPROC = @XSLTPROC@
411 ifeq ($(enable_coverage),yes)
412 # ccache loses .gcno files
413 export CCACHE_DISABLE = 1
418 DEF_PGPORT = @default_port@
419 WANTED_LANGUAGES = @WANTED_LANGUAGES@
422 ##########################################################################
424 # Additional platform-specific settings
427 # Name of the "template"
430 build_os = @build_os@
434 host_cpu = @host_cpu@
436 # Make HAVE_IPV6 available for initdb script creation
437 HAVE_IPV6= @HAVE_IPV6@
439 # This is mainly for use on FreeBSD, where we have both a.out and elf
440 # systems now. May be applicable to other systems to?
441 ELF_SYSTEM= @ELF_SYS@
443 # Backend stack size limit has to be hard-wired on Windows (it's in bytes)
444 WIN32_STACK_RLIMIT=4194304
446 # Set if we have a working win32 crashdump header
447 have_win32_dbghelp = @have_win32_dbghelp@
449 # Pull in platform-specific magic
450 include $(top_builddir)/src/Makefile.port
452 # Set up rpath if enabled. By default it will point to our libdir,
453 # but individual Makefiles can force other rpath paths if needed.
456 ifeq ($(enable_rpath), yes)
461 ##########################################################################
463 # Some variables needed to find some client interfaces
466 # some contribs assumes headers and libs are in the source tree...
467 libpq_srcdir = $(includedir)
468 libpq_builddir = $(libdir)
470 libpq_srcdir = $(top_srcdir)/src/interfaces/libpq
471 libpq_builddir = $(top_builddir)/src/interfaces/libpq
474 # This macro is for use by libraries linking to libpq. (Because libpgport
475 # isn't created with the same link flags as libpq, it can't be used.)
476 libpq = -L$(libpq_builddir) -lpq
478 # This macro is for use by client executables (not libraries) that use libpq.
479 # We force clients to pull symbols from the non-shared libraries libpgport
480 # and libpgcommon rather than pulling some libpgport symbols from libpq just
481 # because libpq uses those functions too. This makes applications less
482 # dependent on changes in libpq's usage of pgport. To do this we link to
483 # pgport before libpq. This does cause duplicate -lpgport's to appear
484 # on client link lines.
486 libpq_pgport = -L$(libdir) -lpgcommon -lpgport $(libpq)
488 libpq_pgport = -L$(top_builddir)/src/common -lpgcommon -L$(top_builddir)/src/port -lpgport $(libpq)
491 # Cygwin seems to need ldap libraries to be mentioned here, too
492 ifeq ($(PORTNAME),cygwin)
493 libpq_pgport += $(LDAP_LIBS_FE)
498 $(MAKE) -C $(libpq_builddir) all
501 $(MAKE) -C $(top_builddir)/src/port all
502 $(MAKE) -C $(top_builddir)/src/common all
504 submake-libpgfeutils:
505 $(MAKE) -C $(top_builddir)/src/port all
506 $(MAKE) -C $(top_builddir)/src/common all
507 $(MAKE) -C $(top_builddir)/src/fe_utils all
509 .PHONY: submake-libpq submake-libpgport submake-libpgfeutils
512 ##########################################################################
516 PL_TESTDB = pl_regression
517 CONTRIB_TESTDB = contrib_regression
518 ifneq ($(MODULE_big),)
519 CONTRIB_TESTDB_MODULE = contrib_regression_$(MODULE_big)
522 CONTRIB_TESTDB_MODULE = contrib_regression_$(MODULES)
524 CONTRIB_TESTDB_MODULE = contrib_regression
529 NOLOCALE += --no-locale
532 # file with extra config for temp build
535 TEMP_CONF += --temp-config=$(TEMP_CONFIG)
538 pg_regress_locale_flags = $(if $(ENCODING),--encoding=$(ENCODING)) $(NOLOCALE)
540 pg_regress_check = $(with_temp_install) $(top_builddir)/src/test/regress/pg_regress --inputdir=$(srcdir) --temp-instance=./tmp_check $(TEMP_CONF) --bindir= $(pg_regress_locale_flags) $(EXTRA_REGRESS_OPTS)
541 pg_regress_installcheck = $(top_builddir)/src/test/regress/pg_regress --inputdir=$(srcdir) --bindir='$(bindir)' $(pg_regress_locale_flags) $(EXTRA_REGRESS_OPTS)
543 pg_regress_clean_files = results/ regression.diffs regression.out tmp_check/ log/
545 pg_isolation_regress_check = $(with_temp_install) $(top_builddir)/src/test/isolation/pg_isolation_regress --inputdir=$(srcdir) --temp-instance=./tmp_check $(TEMP_CONF) --bindir= $(pg_regress_locale_flags) $(EXTRA_REGRESS_OPTS)
546 pg_isolation_regress_installcheck = $(top_builddir)/src/test/isolation/pg_isolation_regress --inputdir=$(srcdir) $(pg_regress_locale_flags) $(EXTRA_REGRESS_OPTS)
548 ##########################################################################
552 # This includes your local customizations if Makefile.custom exists
553 # in the source directory. This file doesn't exist in the original
554 # distribution so that it doesn't get overwritten when you upgrade.
556 # NOTE: Makefile.custom is from the pre-Autoconf days of PostgreSQL.
557 # You are liable to shoot yourself in the foot if you use it without
558 # knowing exactly what you're doing. The preferred (and more
559 # reliable) method is to communicate what you want to do to the
560 # configure script, and leave the makefiles alone.
562 -include $(top_srcdir)/src/Makefile.custom
564 ifneq ($(CUSTOM_INSTALL),)
565 INSTALL= $(CUSTOM_INSTALL)
568 ifneq ($(CUSTOM_CC),)
572 ifneq ($(CUSTOM_COPT),)
583 LDFLAGS += $(PROFILE)
587 ##########################################################################
589 # substitute implementations of C library routines (see src/port/)
590 # note we already included -L.../src/port in LDFLAGS above
594 # files needed for the chosen CRC-32C implementation
595 PG_CRC32C_OBJS = @PG_CRC32C_OBJS@
597 LIBS := -lpgcommon -lpgport $(LIBS)
599 # to make ws2_32.lib the last library
600 ifeq ($(PORTNAME),win32)
604 # Not really standard libc functions, used by the backend.
608 ##########################################################################
610 # Global targets and rules
614 $(FLEX) $(if $(FLEX_NO_BACKUP),-b) $(FLEXFLAGS) -o'$@' $<
615 @$(if $(FLEX_NO_BACKUP),if [ `wc -l <lex.backup` -eq 1 ]; then rm lex.backup; else echo "Scanner requires backup; see lex.backup." 1>&2; exit 1; fi)
617 @$(missing) flex $< '$@'
621 $(if $(BISON_CHECK_CMD),$(BISON_CHECK_CMD))
623 $(BISON) $(BISONFLAGS) -o $@ $<
625 @$(missing) bison $< $@
629 $(CPP) $(CPPFLAGS) -o $@ $<
632 $(GZIP) --best -c $< >$@
637 # Direct builds of foo.c -> foo are disabled to avoid generating
638 # *.dSYM junk on Macs. All builds should normally go through the
639 # foo.c -> foo.o -> foo steps. This also ensures that dependency
640 # tracking (see below) is used.
645 # Remake Makefile.global from Makefile.global.in if the latter
646 # changed. In order to trigger this rule, the including file must
647 # write `include $(top_builddir)/src/Makefile.global', not some
649 $(top_builddir)/src/Makefile.global: $(top_srcdir)/src/Makefile.global.in $(top_builddir)/config.status
650 cd $(top_builddir) && ./config.status src/Makefile.global
652 # Remake pg_config.h from pg_config.h.in if the latter changed.
653 # config.status will not change the timestamp on pg_config.h if it
654 # doesn't change, so as to avoid recompiling the entire tree
655 # unnecessarily. Therefore we make config.status update a timestamp file
656 # stamp-h every time it runs, so that we don't trigger this rule every time.
657 # (We do trigger the null rule for stamp-h to pg_config.h every time; so it's
658 # important for that rule to be empty!)
660 # Of course you need to turn on dependency tracking to get any
661 # dependencies on pg_config.h.
662 $(top_builddir)/src/include/pg_config.h: $(top_builddir)/src/include/stamp-h ;
664 $(top_builddir)/src/include/stamp-h: $(top_srcdir)/src/include/pg_config.h.in $(top_builddir)/config.status
665 cd $(top_builddir) && ./config.status src/include/pg_config.h
667 # Also remake pg_config_ext.h from pg_config_ext.h.in, same logic as above.
668 $(top_builddir)/src/include/pg_config_ext.h: $(top_builddir)/src/include/stamp-ext-h ;
670 $(top_builddir)/src/include/stamp-ext-h: $(top_srcdir)/src/include/pg_config_ext.h.in $(top_builddir)/config.status
671 cd $(top_builddir) && ./config.status src/include/pg_config_ext.h
673 # Also remake ecpg_config.h from ecpg_config.h.in if the latter changed, same
675 $(top_builddir)/src/interfaces/ecpg/include/ecpg_config.h: $(top_builddir)/src/interfaces/ecpg/include/stamp-h ;
677 $(top_builddir)/src/interfaces/ecpg/include/stamp-h: $(top_builddir)/src/interfaces/ecpg/include/ecpg_config.h.in $(top_builddir)/config.status
678 cd $(top_builddir) && ./config.status src/interfaces/ecpg/include/ecpg_config.h
680 # When configure changes, rerun configure with the same options as
681 # last time. To change configure, you need to run autoconf manually.
682 $(top_builddir)/config.status: $(top_srcdir)/configure
683 cd $(top_builddir) && ./config.status --recheck
689 # install-strip always uses install-sh, so that strip options can be
691 $(MAKE) use_install_sh=yes \
692 INSTALL_PROGRAM_ENV="STRIPPROG='$(STRIP)'" \
693 INSTALL_STLIB_ENV="STRIPPROG='$(STRIP_STATIC_LIB)'" \
694 INSTALL_SHLIB_ENV="STRIPPROG='$(STRIP_SHARED_LIB)'" \
695 INSTALL_STRIP_FLAG=-s \
699 ##########################################################################
701 # Recursive make support
702 # ----------------------
703 # Instead of recursing through subdirectories with a for loop or
704 # repeated $(MAKE) -C whatever calls, this is a little smarter: it
705 # allows parallel make across directories and lets make -k and -q work
708 # We need the $(eval) function and order-only prerequisites, which are
709 # available in GNU make 3.80. That also happens to be the version
710 # where the .VARIABLES variable was introduced, so this is a simple check.
712 $(error GNU make 3.80 or newer is required. You are using version $(MAKE_VERSION))
715 # This function is only for internal use below. It should be called
716 # using $(eval). It will set up a target so that it recurses into
717 # a given subdirectory. Note that to avoid a nasty bug in make 3.80,
718 # this function has to avoid using any complicated constructs (like
719 # multiple targets on a line) and also not contain any lines that expand
720 # to more than about 200 bytes. This is why we make it apply to just one
721 # subdirectory at a time, rather than to a list of subdirectories.
722 # $1: target name, e.g., all
724 # $3: target to run in subdir, usually same as $1
725 define _create_recursive_target
726 .PHONY: $(1)-$(2)-recurse
727 $(1): $(1)-$(2)-recurse
728 $(1)-$(2)-recurse: $(if $(filter check, $(3)), temp-install)
729 $$(MAKE) -C $(2) $(3)
731 # Note that the use of $$ on the last line above is important; we want
732 # $(MAKE) to be evaluated when the rule is run, not when the $(eval) is run
733 # to create the rule. This is necessary to get make -q working.
735 # Call this function in a makefile that needs to recurse into subdirectories.
736 # In the normal case all arguments can be defaulted.
737 # $1: targets to make recursive (defaults to list of standard targets)
738 # $2: list of subdirs (defaults to SUBDIRS variable)
739 # $3: target to run in subdir (defaults to current element of $1)
740 recurse = $(foreach target,$(if $1,$1,$(standard_targets)),$(foreach subdir,$(if $2,$2,$(SUBDIRS)),$(eval $(call _create_recursive_target,$(target),$(subdir),$(if $3,$3,$(target))))))
742 # If a makefile's list of SUBDIRS varies depending on configuration, then
743 # any subdirectories excluded from SUBDIRS should instead be added to
744 # ALWAYS_SUBDIRS, and then it must call recurse_always as well as recurse.
745 # This ensures that distprep, distclean, etc will apply to all subdirectories.
746 # In the normal case all arguments will be defaulted.
747 # $1: targets to make recursive (defaults to standard_always_targets)
748 # $2: list of subdirs (defaults to ALWAYS_SUBDIRS variable)
749 # $3: target to run in subdir (defaults to current element of $1)
750 recurse_always = $(foreach target,$(if $1,$1,$(standard_always_targets)),$(foreach subdir,$(if $2,$2,$(ALWAYS_SUBDIRS)),$(eval $(call _create_recursive_target,$(target),$(subdir),$(if $3,$3,$(target))))))
753 ##########################################################################
755 # Automatic dependency generation
756 # -------------------------------
757 # When we configure with --enable-depend then we override the default
758 # compilation rule with the magic below. While or after creating the
759 # actual output file we also create a dependency list for the .c file.
760 # Next time we invoke make we will have top-notch information about
761 # whether this file needs to be updated. The dependency files are kept
762 # in the .deps subdirectory of each directory.
764 autodepend = @autodepend@
766 ifeq ($(autodepend), yes)
769 COMPILE.c = $(CC) $(CFLAGS) $(CPPFLAGS) -c
776 # GCC allows us to create object and dependency file in one invocation.
778 @if test ! -d $(DEPDIR); then mkdir -p $(DEPDIR); fi
779 $(COMPILE.c) -o $@ $< -MMD -MP -MF $(DEPDIR)/$(*F).Po
783 # Include all the dependency files generated for the current
784 # directory. Note that make would complain if include was called with
786 Po_files := $(wildcard $(DEPDIR)/*.Po)
792 clean distclean maintainer-clean: clean-deps
801 ##########################################################################
803 # Native language support
805 ifeq ($(enable_nls), yes)
806 ifneq (,$(wildcard $(srcdir)/nls.mk))
808 include $(top_srcdir)/src/nls-global.mk
814 ##########################################################################
818 # Explanation of involved files:
821 # foo.gcno gcov graph (a.k.a. "notes") file, created at compile time
822 # (by gcc -ftest-coverage)
823 # foo.gcda gcov data file, created when the program is run (for
824 # programs compiled with gcc -fprofile-arcs)
825 # foo.c.gcov gcov output file with coverage information, created by
826 # gcov from foo.gcda (by "make coverage")
827 # foo.c.gcov.out stdout captured when foo.c.gcov is created, mildly
829 # lcov.info lcov tracefile, built from gcda files in one directory,
830 # later collected by "make coverage-html"
832 ifeq ($(enable_coverage), yes)
834 # There is a strange interaction between lcov and existing .gcov
835 # output files. Hence the rm command and the ordering dependency.
837 gcda_files := $(wildcard *.gcda)
839 lcov.info: $(gcda_files)
841 $(if $^,$(LCOV) -d . -c -o $@ $(LCOVFLAGS) --gcov-tool $(GCOV))
843 %.c.gcov: %.gcda | lcov.info
844 $(GCOV) -b -f -p -o . $(GCOVFLAGS) $*.c >$*.c.gcov.out
846 coverage: $(gcda_files:.gcda=.c.gcov) lcov.info
848 .PHONY: coverage-html
849 coverage-html: coverage
852 $(GENHTML) --show-details --legend --output-directory=coverage --title=PostgreSQL --num-spaces=4 --prefix=$(abs_top_srcdir) `find . -name lcov.info -print`
856 clean distclean maintainer-clean: clean-coverage
858 .PHONY: clean-coverage
861 rm -f *.gcda *.gcno lcov.info *.gcov *.gcov.out
864 # User-callable target to reset counts between test runs
866 rm -f `find . -name '*.gcda' -print`
868 endif # enable_coverage