1 # Copyright (C) 1991-2024 Free Software Foundation, Inc.
2 # This file is part of the GNU C Library.
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.
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.
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 # <https://www.gnu.org/licenses/>.
19 # Rules for making a subdirectory in the GNU C library.
20 # Each subdirectory Makefile defines some variables and includes this.
23 This makefile requires GNU Make.
26 all: # Don't let the default goal come from Makeconfig.
28 include $(firstword $(..) ../)Makeconfig
31 Each subdirectory makefile must define the `subdir' variable.
33 # This ` unconfuses emacs.
34 # This is benign and useless in GNU make before 3.63.
35 export subdir := $(subdir)
37 # This is the default target; it makes the library and auxiliary programs.
41 ifeq ($(build-programs),yes)
42 others: $(addprefix $(objpfx),$(extra-objs) \
44 $(install-bin) $(install-bin-script) \
45 $(install-rootsbin) $(install-sbin))
47 others: $(addprefix $(objpfx),$(extra-objs) \
51 ifneq "$(findstring env,$(origin headers))" ""
55 ifneq "$(findstring env,$(origin generated))" ""
59 ifneq "$(findstring env,$(origin common-generated))" ""
63 include $(..)Makerules
66 subdir_lib: lib-noranlib
68 # Some subdirs need to install a dummy library.
69 # They can use "$(objpfx)libfnord.a: $(dep-dummy-lib); $(make-dummy-lib)".
70 dep-dummy-lib = $(common-objpfx)dummy.o
72 $(AR) cr$(verbose) $@ $<
75 $(common-objpfx)dummy.c:
77 (echo 'extern void __dummy__ (void);'; \
78 echo 'void __dummy__ (void) { }') > $@
79 common-generated += dummy.o dummy.c
82 # Test that all of the headers installed by this directory can be compiled
84 tests-special += $(objpfx)check-installed-headers-c.out
85 libof-check-installed-headers-c := testsuite
86 $(objpfx)check-installed-headers-c.out: \
87 $(..)scripts/check-installed-headers.sh $(headers)
88 $(SHELL) $(..)scripts/check-installed-headers.sh c $(supported-fortify) \
89 "$(CC) $(filter-out -std=%,$(CFLAGS)) -D_ISOMAC $(+includes)" \
94 # If a C++ compiler is available, also test that they can be compiled
95 # in isolation as C++.
96 tests-special += $(objpfx)check-installed-headers-cxx.out
97 libof-check-installed-headers-cxx := testsuite
98 $(objpfx)check-installed-headers-cxx.out: \
99 $(..)scripts/check-installed-headers.sh $(headers)
100 $(SHELL) $(..)scripts/check-installed-headers.sh c++ $(supported-fortify) \
101 "$(CXX) $(filter-out -std=%,$(CXXFLAGS)) -D_ISOMAC $(+includes)" \
106 # Test that a wrapper header exists in include/ for each non-sysdeps header.
107 # This script does not need $(py-env).
108 tests-special += $(objpfx)check-wrapper-headers.out
109 $(objpfx)check-wrapper-headers.out: \
110 $(..)scripts/check-wrapper-headers.py $(headers)
111 $(PYTHON) $< --root=$(..) --subdir=$(subdir) $(headers) > $@; \
114 # Test that none of the headers installed by this directory use certain
115 # obsolete constructs (e.g. legacy BSD typedefs superseded by stdint.h).
116 # This script does not need $(py-env).
117 tests-special += $(objpfx)check-obsolete-constructs.out
118 libof-check-obsolete-constructs := testsuite
119 $(objpfx)check-obsolete-constructs.out: \
120 $(..)scripts/check-obsolete-constructs.py $(headers)
121 $(PYTHON) $^ > $@ 2>&1; \
126 # This makes all the auxiliary and test programs.
128 .PHONY: others tests bench bench-build
130 # Test programs for the pretty printers.
131 tests-printers-programs := $(addprefix $(objpfx),$(tests-printers))
133 # .out files with the output of running the pretty printer tests.
134 tests-printers-out := $(patsubst %,$(objpfx)%.out,$(tests-printers))
136 ifeq ($(build-programs),yes)
137 others: $(addprefix $(objpfx),$(others) $(sysdep-others) $(extra-objs))
139 others: $(addprefix $(objpfx),$(extra-objs))
142 # Generate constant files for Python pretty printers if required.
145 ifeq ($(run-built-tests),no)
146 tests: $(addprefix $(objpfx),$(filter-out $(tests-unsupported), \
147 $(tests) $(tests-internal) \
149 $(tests-mcheck:%=%-mcheck) \
150 $(tests-malloc-check:%=%-malloc-check) \
151 $(tests-malloc-hugetlb1:%=%-malloc-hugetlb1) \
152 $(tests-malloc-hugetlb2:%=%-malloc-hugetlb2)) \
153 $(test-srcs)) $(tests-special) \
154 $(tests-printers-programs)
155 xtests: tests $(xtests-special)
157 tests: $(tests:%=$(objpfx)%.out) $(tests-internal:%=$(objpfx)%.out) \
158 $(tests-container:%=$(objpfx)%.out) \
159 $(tests-mcheck:%=$(objpfx)%-mcheck.out) \
160 $(tests-malloc-check:%=$(objpfx)%-malloc-check.out) \
161 $(tests-malloc-hugetlb1:%=$(objpfx)%-malloc-hugetlb1.out) \
162 $(tests-malloc-hugetlb2:%=$(objpfx)%-malloc-hugetlb2.out) \
163 $(tests-special) $(tests-printers-out)
164 xtests: tests $(xtests:%=$(objpfx)%.out) $(xtests-special)
167 tests-special-notdir = $(patsubst $(objpfx)%, %, $(tests-special))
168 xtests-special-notdir = $(patsubst $(objpfx)%, %, $(xtests-special))
169 ifeq ($(run-built-tests),no)
172 tests-expected = $(tests) $(tests-internal) $(tests-printers) \
173 $(tests-container) $(tests-malloc-check:%=%-malloc-check) \
174 $(tests-malloc-hugetlb1:%=%-malloc-hugetlb1) \
175 $(tests-malloc-hugetlb2:%=%-malloc-hugetlb2) \
176 $(tests-mcheck:%=%-mcheck)
179 $(..)scripts/merge-test-results.sh -s $(objpfx) $(subdir) \
180 $(sort $(tests-expected) $(tests-special-notdir:.out=)) \
181 > $(objpfx)subdir-tests.sum
183 $(..)scripts/merge-test-results.sh -s $(objpfx) $(subdir) \
184 $(sort $(xtests) $(xtests-special-notdir:.out=)) \
185 > $(objpfx)subdir-xtests.sum
187 ifeq ($(build-programs),yes)
188 binaries-all-notests = $(others) $(sysdep-others)
189 binaries-all-tests = $(tests) $(tests-internal) $(xtests) $(test-srcs) \
191 binaries-all = $(binaries-all-notests) $(binaries-all-tests)
192 binaries-static-notests = $(others-static)
193 binaries-static-tests = $(tests-static) $(xtests-static)
194 binaries-static = $(binaries-static-notests) $(binaries-static-tests)
195 binaries-shared-2.0-tests = $(tests-2.0)
196 ifeq (yesyes,$(have-fpie)$(build-shared))
197 binaries-pie-tests = $(tests-pie) $(xtests-pie)
198 binaries-pie-notests = $(others-pie)
201 binaries-pie-notests =
203 binaries-mcheck-tests = $(tests-mcheck:%=%-mcheck)
204 binaries-malloc-check-tests = $(tests-malloc-check:%=%-malloc-check)
205 binaries-malloc-hugetlb1-tests = $(tests-malloc-hugetlb1:%=%-malloc-hugetlb1)
206 binaries-malloc-hugetlb2-tests = $(tests-malloc-hugetlb2:%=%-malloc-hugetlb2)
208 binaries-all-notests =
209 binaries-all-tests = $(tests) $(tests-internal) $(xtests) $(test-srcs)
210 binaries-all = $(binaries-all-tests)
211 binaries-static-notests =
212 binaries-static-tests =
215 binaries-pie-notests =
216 binaries-mcheck-tests =
217 binaries-malloc-check-tests =
218 binaries-malloc-hugetlb1-tests =
219 binaries-malloc-hugetlb2-tests =
222 binaries-pie = $(binaries-pie-tests) $(binaries-pie-notests)
223 binaries-shared-tests = $(filter-out $(binaries-pie) $(binaries-static) \
224 $(binaries-shared-2.0-tests), \
225 $(binaries-all-tests))
226 binaries-shared-notests = $(filter-out $(binaries-pie) $(binaries-static), \
227 $(binaries-all-notests))
229 ifneq "$(strip $(binaries-shared-notests))" ""
230 $(addprefix $(objpfx),$(binaries-shared-notests)): %: %.o \
231 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
232 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
236 ifneq "$(strip $(binaries-shared-tests))" ""
237 $(addprefix $(objpfx),$(binaries-shared-tests)): %: %.o \
238 $(link-extra-libs-tests) \
239 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
240 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
244 # Linking test programs with crt1.o from glibc 2.0.
245 ifneq "$(strip $(binaries-shared-2.0-tests))" ""
246 $(addprefix $(objpfx),$(binaries-shared-2.0-tests)): %: %.o \
247 $(link-extra-libs-tests) \
248 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
249 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
253 ifneq "$(strip $(binaries-mcheck-tests))" ""
254 $(addprefix $(objpfx),$(binaries-mcheck-tests)): %-mcheck: %.o \
255 $(link-extra-libs-tests) \
256 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
257 $(common-objpfx)malloc/libmcheck.a \
258 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
262 ifneq "$(strip $(binaries-malloc-check-tests))" ""
263 $(addprefix $(objpfx),$(binaries-malloc-check-tests)): %-malloc-check: %.o \
264 $(link-extra-libs-tests) \
265 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
266 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
270 ifneq "$(strip $(binaries-malloc-hugetlb1-tests))" ""
271 $(addprefix $(objpfx),$(binaries-malloc-hugetlb1-tests)): %-malloc-hugetlb1: %.o \
272 $(link-extra-libs-tests) \
273 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
274 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
278 ifneq "$(strip $(binaries-malloc-hugetlb2-tests))" ""
279 $(addprefix $(objpfx),$(binaries-malloc-hugetlb2-tests)): %-malloc-hugetlb2: %.o \
280 $(link-extra-libs-tests) \
281 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
282 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
286 ifneq "$(strip $(binaries-pie-tests))" ""
287 $(addprefix $(objpfx),$(binaries-pie-tests)): %: %.o \
288 $(link-extra-libs-tests) \
289 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
290 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
294 ifneq "$(strip $(binaries-pie-notests))" ""
295 $(addprefix $(objpfx),$(binaries-pie-notests)): %: %.o \
296 $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
297 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
301 ifneq "$(strip $(binaries-static-notests))" ""
302 $(addprefix $(objpfx),$(binaries-static-notests)): %: %.o \
303 $(sort $(filter $(common-objpfx)lib%,$(link-libc-static))) \
304 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
308 ifneq "$(strip $(binaries-static-tests))" ""
309 $(addprefix $(objpfx),$(binaries-static-tests)): %: %.o \
310 $(link-extra-libs-tests) \
311 $(sort $(filter $(common-objpfx)lib%,$(link-libc-static-tests))) \
312 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
313 $(+link-static-tests)
316 # All malloc-check tests will be run with MALLOC_CHECK_=3
317 define malloc-check-ENVS
318 $(1)-malloc-check-ENV = MALLOC_CHECK_=3 \
319 LD_PRELOAD=$(common-objpfx)/malloc/libc_malloc_debug.so
321 $(foreach t,$(tests-malloc-check),$(eval $(call malloc-check-ENVS,$(t))))
323 # All malloc-hugetlb1 tests will be run with GLIBC_TUNABLES=glibc.malloc.hugetlb=1
324 define malloc-hugetlb1-ENVS
325 $(1)-malloc-hugetlb1-ENV += GLIBC_TUNABLES=glibc.malloc.hugetlb=1
327 $(foreach t,$(tests-malloc-hugetlb1),$(eval $(call malloc-hugetlb1-ENVS,$(t))))
329 # All malloc-hugetlb2 tests will be run with GLIBC_TUNABLE=glibc.malloc.hugetlb=2
330 define malloc-hugetlb2-ENVS
331 $(1)-malloc-hugetlb2-ENV += GLIBC_TUNABLES=glibc.malloc.hugetlb=2
333 $(foreach t,$(tests-malloc-hugetlb2),$(eval $(call malloc-hugetlb2-ENVS,$(t))))
335 # mcheck tests need the debug DSO to support -lmcheck.
337 $(1)-mcheck-ENV = LD_PRELOAD=$(common-objpfx)/malloc/libc_malloc_debug.so
339 $(foreach t,$(tests-mcheck),$(eval $(call mcheck-ENVS,$(t))))
341 ifneq "$(strip $(tests) $(tests-internal) $(xtests) $(test-srcs))" ""
342 # These are the implicit rules for making test outputs
343 # from the test programs and whatever input files are present.
346 $(if $($*-ENV-only),$(test-wrapper-env-only) $($*-ENV-only),\
347 $(test-wrapper-env) $(run-program-env) $($*-ENV)) \
348 $(host-test-program-cmd) $($*-ARGS)
350 $(objpfx)%.out: %.input $(objpfx)%
351 $(make-test-out) > $@ < $(word 1,$^); \
353 $(objpfx)%.out: /dev/null $(objpfx)% # Make it 2nd arg for canned sequence.
354 $(make-test-out) > $@; \
358 # Any tests that require an isolated container (filesystem, network
359 # and pid namespaces) in which to run, should be added to
361 $(tests-container:%=$(objpfx)%.out): $(objpfx)%.out : $(if $(wildcard $(objpfx)%.files),$(objpfx)%.files,/dev/null) $(objpfx)%
362 $(test-wrapper-env) $(run-program-env) $(run-via-rtld-prefix) \
363 $(common-objpfx)support/test-container env $(run-program-env) $($*-ENV) \
364 $(host-test-program-cmd) $($*-ARGS) > $@; \
368 # tests-unsupported lists tests that we will not try to build at all in
369 # this configuration. Note this runs every time because it does not
370 # actually create its target. The dependency on Makefile is meant to
371 # ensure that it runs after a Makefile change to add a test to the list
372 # when it previously ran and produced a .out file (probably for a failure).
373 ifneq "$(strip $(tests-unsupported))" ""
374 $(tests-unsupported:%=$(objpfx)%.out): $(objpfx)%.out: Makefile
376 $(..)scripts/evaluate-test.sh $(patsubst $(common-objpfx)%.out,%,$@) \
377 77 false false > $(@:.out=.test-result)
382 ifneq "$(strip $(tests-printers))" ""
384 # Static pattern rule for building the test programs for the pretty printers.
385 $(tests-printers-programs): %: %.o $(tests-printers-libs) \
386 $(sort $(filter $(common-objpfx)lib%,$(link-libc-static-tests))) \
387 $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
388 $(+link-printers-tests)
390 # Add the paths to the generated constants file and test_common_printers.py
391 # to PYTHONPATH so the test scripts can find them.
392 py-env := PYTHONPATH=$(py-const-dir):$(..)scripts:$${PYTHONPATH}
394 # Static pattern rule that matches the test-* targets to their .c and .py
395 # prerequisites. It'll run the corresponding test script for each test program
396 # we compiled and place its output in the corresponding .out file.
397 # The pretty printer files and test_common_printers.py must be present for all.
398 $(tests-printers-out): $(objpfx)%.out: $(objpfx)% %.py %.c $(pretty-printers) \
399 $(..)scripts/test_printers_common.py
400 $(test-wrapper-env) $(py-env) \
401 $(PYTHON) $*.py $*.c $(objpfx)$* $(pretty-printers) > $@; \
406 .PHONY: distclean realclean subdir_distclean subdir_realclean \
407 subdir_clean subdir_mostlyclean subdir_testclean
408 subdir_mostlyclean: mostlyclean
410 subdir_distclean: distclean
411 subdir_realclean: realclean
412 subdir_testclean: do-tests-clean
416 # We want to install everything except the library itself, but update all
417 # our portions of the library because the parent make will install it later
418 # (likewise the stubs file).
419 .PHONY: subdir_install
420 subdir_install: install-no-libc.a lib-noranlib stubs
422 .PHONY: subdir_objs subdir_stubs
426 # Target required by the Hurd to ensure that all the MiG-generated
427 # headers are in place before building a subdirectory.
428 .PHONY: before-compile
429 before-compile: $(before-compile)
431 $(common-objpfx)dummy.o: $(common-objpfx)dummy.c $(before-compile);