Rules

   1 # Copyright (C) 1991-2019 Free Software Foundation, Inc.
   2 # This file is part of the GNU C Library.
   3
   4 # The GNU C Library is free software; you can redistribute it and/or
   5 # modify it under the terms of the GNU Lesser General Public
   6 # License as published by the Free Software Foundation; either
   7 # version 2.1 of the License, or (at your option) any later version.
   8
   9 # The GNU C Library is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12 # Lesser General Public License for more details.
  13
  14 # You should have received a copy of the GNU Lesser General Public
  15 # License along with the GNU C Library; if not, see
  16 # <http://www.gnu.org/licenses/>.
  17
  18 #
  19 #       Rules for making a subdirectory in the GNU C library.
  20 #       Each subdirectory Makefile defines some variables and includes this.
  21 #
  22 ifneq (,)
  23 This makefile requires GNU Make.
  24 endif
  25
  26 all: # Don't let the default goal come from Makeconfig.
  27
  28 include $(firstword $(..) ../)Makeconfig
  29
  30 ifndef  subdir
  31 Each subdirectory makefile must define the `subdir' variable.
  32 endif
  33 # This ` unconfuses emacs.
  34 # This is benign and useless in GNU make before 3.63.
  35 export subdir := $(subdir)
  36 \f
  37 # This is the default target; it makes the library and auxiliary programs.
  38 .PHONY: all
  39 all: objs lib others
  40
  41 ifeq ($(build-programs),yes)
  42 others: $(addprefix $(objpfx),$(extra-objs) \
  43                               $(install-lib) \
  44                               $(install-bin) $(install-bin-script) \
  45                               $(install-rootsbin) $(install-sbin))
  46 else
  47 others: $(addprefix $(objpfx),$(extra-objs) \
  48                               $(install-lib))
  49 endif
  50
  51 ifneq   "$(findstring env,$(origin headers))" ""
  52 headers :=
  53 endif
  54
  55 ifneq   "$(findstring env,$(origin generated))" ""
  56 generated :=
  57 endif
  58
  59 ifneq   "$(findstring env,$(origin common-generated))" ""
  60 common-generated :=
  61 endif
  62
  63 # See below.  This must be set before Makerules processes it.
  64 before-compile += $(common-objpfx)bits/stdio_lim.h
  65
  66 include $(..)Makerules
  67
  68 .PHONY: subdir_lib
  69 subdir_lib: lib-noranlib
  70
  71 # Some subdirs need to install a dummy library.
  72 # They can use "$(objpfx)libfnord.a: $(dep-dummy-lib); $(make-dummy-lib)".
  73 dep-dummy-lib = $(common-objpfx)dummy.o
  74 define make-dummy-lib
  75 $(AR) cr$(verbose) $@ $<
  76 endef
  77
  78 $(common-objpfx)dummy.c:
  79         rm -f $@
  80         (echo 'extern void __dummy__ (void);'; \
  81          echo 'void __dummy__ (void) { }') > $@
  82 common-generated += dummy.o dummy.c
  83
  84 ifneq "$(headers)" ""
  85 # Test that all of the headers installed by this directory can be compiled
  86 # in isolation.
  87 tests-special += $(objpfx)check-installed-headers-c.out
  88 libof-check-installed-headers-c := testsuite
  89 $(objpfx)check-installed-headers-c.out: \
  90     $(..)scripts/check-installed-headers.sh $(headers)
  91         $(SHELL) $(..)scripts/check-installed-headers.sh c \
  92           "$(CC) $(filter-out -std=%,$(CFLAGS)) -D_ISOMAC $(+includes)" \
  93           $(headers) > $@; \
  94         $(evaluate-test)
  95
  96 ifneq "$(CXX)" ""
  97 # If a C++ compiler is available, also test that they can be compiled
  98 # in isolation as C++.
  99 tests-special += $(objpfx)check-installed-headers-cxx.out
 100 libof-check-installed-headers-cxx := testsuite
 101 $(objpfx)check-installed-headers-cxx.out: \
 102     $(..)scripts/check-installed-headers.sh $(headers)
 103         $(SHELL) $(..)scripts/check-installed-headers.sh c++ \
 104           "$(CXX) $(filter-out -std=%,$(CXXFLAGS)) -D_ISOMAC $(+includes)" \
 105           $(headers) > $@; \
 106         $(evaluate-test)
 107 endif
 108 endif
 109 \f
 110 # This makes all the auxiliary and test programs.
 111
 112 .PHONY: others tests bench bench-build
 113
 114 # Test programs for the pretty printers.
 115 tests-printers-programs := $(addprefix $(objpfx),$(tests-printers))
 116
 117 # .out files with the output of running the pretty printer tests.
 118 tests-printers-out := $(patsubst %,$(objpfx)%.out,$(tests-printers))
 119
 120 ifeq ($(build-programs),yes)
 121 others: $(addprefix $(objpfx),$(others) $(sysdep-others) $(extra-objs))
 122 else
 123 others: $(addprefix $(objpfx),$(extra-objs))
 124 endif
 125
 126 # Generate constant files for Python pretty printers if required.
 127 others: $(py-const)
 128
 129 ifeq ($(run-built-tests),no)
 130 tests: $(addprefix $(objpfx),$(filter-out $(tests-unsupported), \
 131                                           $(tests) $(tests-internal) \
 132                                           $(tests-container)) \
 133                              $(test-srcs)) $(tests-special) \
 134                              $(tests-printers-programs)
 135 xtests: tests $(xtests-special)
 136 else
 137 tests: $(tests:%=$(objpfx)%.out) $(tests-internal:%=$(objpfx)%.out) \
 138        $(tests-container:%=$(objpfx)%.out) \
 139        $(tests-special) $(tests-printers-out)
 140 xtests: tests $(xtests:%=$(objpfx)%.out) $(xtests-special)
 141 endif
 142
 143 tests-special-notdir = $(patsubst $(objpfx)%, %, $(tests-special))
 144 xtests-special-notdir = $(patsubst $(objpfx)%, %, $(xtests-special))
 145 ifeq ($(run-built-tests),no)
 146 tests-expected =
 147 else
 148 tests-expected = $(tests) $(tests-internal) $(tests-printers) \
 149         $(tests-container)
 150 endif
 151 tests:
 152         $(..)scripts/merge-test-results.sh -s $(objpfx) $(subdir) \
 153           $(sort $(tests-expected) $(tests-special-notdir:.out=)) \
 154           > $(objpfx)subdir-tests.sum
 155 xtests:
 156         $(..)scripts/merge-test-results.sh -s $(objpfx) $(subdir) \
 157           $(sort $(xtests) $(xtests-special-notdir:.out=)) \
 158           > $(objpfx)subdir-xtests.sum
 159
 160 ifeq ($(build-programs),yes)
 161 binaries-all-notests = $(others) $(sysdep-others)
 162 binaries-all-tests = $(tests) $(tests-internal) $(xtests) $(test-srcs) \
 163                      $(tests-container)
 164 binaries-all = $(binaries-all-notests) $(binaries-all-tests)
 165 binaries-static-notests = $(others-static)
 166 binaries-static-tests = $(tests-static) $(xtests-static)
 167 binaries-static = $(binaries-static-notests) $(binaries-static-tests)
 168 ifeq (yesyes,$(have-fpie)$(build-shared))
 169 binaries-pie-tests = $(tests-pie) $(xtests-pie)
 170 binaries-pie-notests = $(others-pie)
 171 else
 172 binaries-pie-tests =
 173 binaries-pie-notests =
 174 endif
 175 else
 176 binaries-all-notests =
 177 binaries-all-tests = $(tests) $(tests-internal) $(xtests) $(test-srcs)
 178 binaries-all = $(binaries-all-tests)
 179 binaries-static-notests =
 180 binaries-static-tests =
 181 binaries-static =
 182 binaries-pie-tests =
 183 binaries-pie-notests =
 184 endif
 185
 186 binaries-pie = $(binaries-pie-tests) $(binaries-pie-notests)
 187 binaries-shared-tests = $(filter-out $(binaries-pie) $(binaries-static), \
 188                                      $(binaries-all-tests))
 189 binaries-shared-notests = $(filter-out $(binaries-pie) $(binaries-static), \
 190                                        $(binaries-all-notests))
 191
 192 ifneq "$(strip $(binaries-shared-notests))" ""
 193 $(addprefix $(objpfx),$(binaries-shared-notests)): %: %.o \
 194   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
 195   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
 196         $(+link)
 197 endif
 198
 199 ifneq "$(strip $(binaries-shared-tests))" ""
 200 $(addprefix $(objpfx),$(binaries-shared-tests)): %: %.o \
 201   $(link-extra-libs-tests) \
 202   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
 203   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
 204         $(+link-tests)
 205 endif
 206
 207 ifneq "$(strip $(binaries-pie-tests))" ""
 208 $(addprefix $(objpfx),$(binaries-pie-tests)): %: %.o \
 209   $(link-extra-libs-tests) \
 210   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
 211   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
 212         $(+link-pie-tests)
 213 endif
 214
 215 ifneq "$(strip $(binaries-pie-notests))" ""
 216 $(addprefix $(objpfx),$(binaries-pie-notests)): %: %.o \
 217   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
 218   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
 219         $(+link-pie)
 220 endif
 221
 222 ifneq "$(strip $(binaries-static-notests))" ""
 223 $(addprefix $(objpfx),$(binaries-static-notests)): %: %.o \
 224   $(sort $(filter $(common-objpfx)lib%,$(link-libc-static))) \
 225   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
 226         $(+link-static)
 227 endif
 228
 229 ifneq "$(strip $(binaries-static-tests))" ""
 230 $(addprefix $(objpfx),$(binaries-static-tests)): %: %.o \
 231   $(link-extra-libs-tests) \
 232   $(sort $(filter $(common-objpfx)lib%,$(link-libc-static-tests))) \
 233   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
 234         $(+link-static-tests)
 235 endif
 236
 237 ifneq "$(strip $(tests) $(tests-internal) $(xtests) $(test-srcs))" ""
 238 # These are the implicit rules for making test outputs
 239 # from the test programs and whatever input files are present.
 240
 241 define make-test-out
 242 $(if $($*-ENV-only),$(test-wrapper-env-only) $($*-ENV-only),\
 243      $(test-wrapper-env) $(run-program-env) $($*-ENV)) \
 244 $(host-test-program-cmd) $($*-ARGS)
 245 endef
 246 $(objpfx)%.out: %.input $(objpfx)%
 247         $(make-test-out) > $@ < $(word 1,$^); \
 248         $(evaluate-test)
 249 $(objpfx)%.out: /dev/null $(objpfx)%    # Make it 2nd arg for canned sequence.
 250         $(make-test-out) > $@; \
 251         $(evaluate-test)
 252
 253
 254 # Any tests that require an isolated container (filesystem, network
 255 # and pid namespaces) in which to run, should be added to
 256 # tests-container.
 257 $(tests-container:%=$(objpfx)%.out): $(objpfx)%.out : $(if $(wildcard $(objpfx)%.files),$(objpfx)%.files,/dev/null) $(objpfx)%
 258         $(test-wrapper-env) $(run-program-env) $(run-via-rtld-prefix) \
 259           $(common-objpfx)support/test-container env $(run-program-env) $($*-ENV) \
 260           $(host-test-program-cmd) $($*-ARGS) > $@; \
 261         $(evaluate-test)
 262
 263
 264 # tests-unsupported lists tests that we will not try to build at all in
 265 # this configuration.  Note this runs every time because it does not
 266 # actually create its target.  The dependency on Makefile is meant to
 267 # ensure that it runs after a Makefile change to add a test to the list
 268 # when it previously ran and produced a .out file (probably for a failure).
 269 ifneq "$(strip $(tests-unsupported))" ""
 270 $(tests-unsupported:%=$(objpfx)%.out): $(objpfx)%.out: Makefile
 271         @rm -f $@
 272         $(..)scripts/evaluate-test.sh $(patsubst $(common-objpfx)%.out,%,$@) \
 273                                       77 false false > $(@:.out=.test-result)
 274 endif
 275
 276 endif   # tests
 277
 278 ifneq "$(strip $(tests-printers))" ""
 279
 280 # Static pattern rule for building the test programs for the pretty printers.
 281 $(tests-printers-programs): %: %.o $(tests-printers-libs) \
 282   $(sort $(filter $(common-objpfx)lib%,$(link-libc-static-tests))) \
 283   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
 284         $(+link-printers-tests)
 285
 286 # Add the paths to the generated constants file and test_common_printers.py
 287 # to PYTHONPATH so the test scripts can find them.
 288 py-env := PYTHONPATH=$(py-const-dir):$(..)scripts:$${PYTHONPATH}
 289
 290 # Static pattern rule that matches the test-* targets to their .c and .py
 291 # prerequisites.  It'll run the corresponding test script for each test program
 292 # we compiled and place its output in the corresponding .out file.
 293 # The pretty printer files and test_common_printers.py must be present for all.
 294 $(tests-printers-out): $(objpfx)%.out: $(objpfx)% %.py %.c $(pretty-printers) \
 295                        $(..)scripts/test_printers_common.py
 296         $(test-wrapper-env) $(py-env) \
 297             $(PYTHON) $*.py $*.c $(objpfx)$* $(pretty-printers) > $@; \
 298         $(evaluate-test)
 299 endif
 300
 301 \f
 302 .PHONY: distclean realclean subdir_distclean subdir_realclean \
 303         subdir_clean subdir_mostlyclean subdir_testclean
 304 subdir_mostlyclean: mostlyclean
 305 subdir_clean: clean
 306 subdir_distclean: distclean
 307 subdir_realclean: realclean
 308 subdir_testclean: do-tests-clean
 309 realclean: distclean
 310 distclean: clean
 311
 312 # We want to install everything except the library itself, but update all
 313 # our portions of the library because the parent make will install it later
 314 # (likewise the stubs file).
 315 .PHONY: subdir_install
 316 subdir_install: install-no-libc.a lib-noranlib stubs
 317
 318 .PHONY: subdir_objs subdir_stubs
 319 subdir_objs: objs
 320 subdir_stubs: stubs
 321
 322 # Target required by the Hurd to ensure that all the MiG-generated
 323 # headers are in place before building a subdirectory.
 324 .PHONY: before-compile
 325 before-compile: $(before-compile)
 326
 327 $(common-objpfx)dummy.o: $(common-objpfx)dummy.c $(before-compile);
 328         $(compile-command.c)
 329
 330 # Local Variables:
 331 # mode: makefile
 332 # End: