1 # Copyright (C) 1991-2019 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 # <http://www.gnu.org/licenses/>.
19 # Master Makefile for the GNU C library
22 This makefile requires GNU Make.
28 # This is the default target; it makes everything except the tests.
32 ifneq ($(AUTOCONF),no)
36 $(AUTOCONF) $(ACFLAGS) $< > $@.new
37 chmod a-w$(patsubst %,$(comma)a+x,$(filter .,$(@D))) $@.new
41 configure: configure.ac aclocal.m4; $(autoconf-it)
42 %/configure: %/configure.ac aclocal.m4; $(autoconf-it)
43 %/preconfigure: %/preconfigure.ac aclocal.m4; $(autoconf-it)
45 endif # $(AUTOCONF) = no
48 # We don't want to run anything here in parallel.
51 # These are the targets that are made by making them in each subdirectory.
52 +subdir_targets := subdir_lib objects objs others subdir_mostlyclean \
53 subdir_clean subdir_distclean subdir_realclean \
55 subdir_update-abi subdir_check-abi \
56 subdir_update-all-abi \
59 subdir_objs subdir_stubs subdir_testclean \
60 $(addprefix install-, no-libc.a bin lib data headers others)
62 headers := limits.h values.h features.h gnu-versions.h \
63 bits/xopen_lim.h gnu/libc-version.h stdc-predef.h \
64 bits/libc-header-start.h
66 echo-headers: subdir_echo-headers
68 # The headers are in the include directory.
70 vpath %.h $(subdir-dirs)
73 install-others = $(inst_includedir)/gnu/stubs.h
76 ifeq (yes,$(build-shared))
77 headers += gnu/lib-names.h
82 ifeq ($(build-programs),yes)
83 others: $(addprefix $(objpfx),$(install-bin-script))
86 # Install from subdirectories too.
87 install: subdir_install
89 # Explicit dependency so that `make install-headers' works
90 install-headers: install-headers-nosubdir
92 # Make sure that the dynamic linker is installed before libc.
93 $(inst_slibdir)/libc-$(version).so: elf/ldso_install
95 .PHONY: elf/ldso_install
97 $(MAKE) -C $(@D) $(@F)
99 # Create links for shared libraries using the `ldconfig' program if possible.
100 # Ignore the error if we cannot update /etc/ld.so.cache.
101 ifeq (no,$(cross-compiling))
102 ifeq (yes,$(build-shared))
103 install: install-symbolic-link
104 .PHONY: install-symbolic-link
105 install-symbolic-link: subdir_install
106 $(symbolic-link-prog) $(symbolic-link-list)
107 rm -f $(symbolic-link-list)
110 -test ! -x $(elf-objpfx)ldconfig || LC_ALL=C \
111 $(elf-objpfx)ldconfig $(addprefix -r ,$(install_root)) \
114 ifeq (/usr,$(prefix))
115 ifeq (,$(install_root))
116 LD_SO=$(ld.so-version) CC="$(CC)" $(PERL) scripts/test-installation.pl $(common-objpfx)
123 # Build subdirectory lib objects.
124 lib-noranlib: subdir_lib
126 ifeq (yes,$(build-shared))
127 # Build the shared object from the PIC object library.
128 lib: $(common-objpfx)libc.so $(common-objpfx)linkobj/libc.so
129 endif # $(build-shared)
131 # Used to build testrun.sh.
132 define testrun-script
134 builddir=`dirname "$$0"`
135 GCONV_PATH="$${builddir}/iconvdata"
138 echo "usage: $$0 [--tool=strace] PROGRAM [ARGUMENTS...]" 2>&1
139 echo " $$0 --tool=valgrind PROGRAM [ARGUMENTS...]" 2>&1
144 while test $$# -gt 0 ; do
159 if test $$# -eq 0 ; then
165 exec $(subst $(common-objdir),"$${builddir}", $(test-program-prefix)) \
169 exec strace $(patsubst %, -E%, $(run-program-env)) \
170 $(test-via-rtld-prefix) $${1+"$$@"}
173 exec env $(run-program-env) valgrind $(test-via-rtld-prefix) $${1+"$$@"}
181 # This is a handy script for running any dynamically linked program against
182 # the current libc build for testing.
183 $(common-objpfx)testrun.sh: $(common-objpfx)config.make \
184 $(..)Makeconfig $(..)Makefile
185 $(file >$@T,$(testrun-script))
188 postclean-generated += testrun.sh
190 others: $(common-objpfx)testrun.sh
192 # Makerules creates a file `stubs' in each subdirectory, which
193 # contains `#define __stub_FUNCTION' for each function defined in that
194 # directory which is a stub.
195 # Here we paste all of these together into <gnu/stubs.h>.
197 subdir-stubs := $(foreach dir,$(subdirs),$(common-objpfx)$(dir)/stubs)
200 installed-stubs = $(inst_includedir)/gnu/stubs.h
202 installed-stubs = $(inst_includedir)/gnu/stubs-$(default-abi).h
204 $(inst_includedir)/gnu/stubs.h: $(+force)
205 $(make-target-directory)
207 echo '/* This file is automatically generated.';\
208 echo " This file selects the right generated file of \`__stub_FUNCTION' macros";\
209 echo ' based on the architecture being compiled for. */'; \
211 $(foreach h,$(abi-includes), echo '#include <$(h)>';) \
213 $(foreach v,$(abi-variants),\
214 $(if $(abi-$(v)-condition),\
215 echo '#if $(abi-$(v)-condition)'; \
216 echo '# include <gnu/stubs-$(v).h>'); \
217 $(if $(abi-$(v)-condition),echo '#endif';) \
218 rm -f $(@:.d=.h).new$(v); \
221 mv -f $(@:.d=.h).new $(@:.d=.h)
223 install-others-nosubdir: $(installed-stubs)
227 # Since stubs.h is never needed when building the library, we simplify the
228 # hairy installation process by producing it in place only as the last part
229 # of the top-level `make install'. It depends on subdir_install, which
230 # iterates over all the subdirs; subdir_install in each subdir depends on
231 # the subdir's stubs file. Having more direct dependencies would result in
232 # extra iterations over the list for subdirs and many recursive makes.
233 $(installed-stubs): include/stubs-prologue.h subdir_install
234 $(make-target-directory)
235 @rm -f $(objpfx)stubs.h
236 (sed '/^@/d' $<; LC_ALL=C sort $(subdir-stubs)) > $(objpfx)stubs.h
237 if test -r $@ && cmp -s $(objpfx)stubs.h $@; \
238 then echo 'stubs.h unchanged'; \
239 else $(INSTALL_DATA) $(objpfx)stubs.h $@; fi
240 rm -f $(objpfx)stubs.h
242 # This makes the Info or DVI file of the documentation from the Texinfo source.
243 .PHONY: info dvi pdf html
245 $(MAKE) $(PARALLELMFLAGS) -C manual $@
247 # This makes all the subdirectory targets.
249 # For each target, make it depend on DIR/target for each subdirectory DIR.
250 $(+subdir_targets): %: $(addsuffix /%,$(subdirs))
252 # Compute a list of all those targets.
253 all-subdirs-targets := $(foreach dir,$(subdirs),\
254 $(addprefix $(dir)/,$(+subdir_targets)))
256 # The action for each of those is to cd into the directory and make the
258 $(all-subdirs-targets):
259 $(MAKE) $(PARALLELMFLAGS) $(subdir-target-args) $(@F)
261 define subdir-target-args
262 subdir=$(@D)$(if $($(@D)-srcdir),\
263 -C $($(@D)-srcdir) ..=`pwd`/,\
267 .PHONY: $(+subdir_targets) $(all-subdirs-targets)
269 # Targets to clean things up to various degrees.
271 .PHONY: clean realclean distclean distclean-1 parent-clean parent-mostlyclean \
274 # Subroutines of all cleaning targets.
275 parent-mostlyclean: common-mostlyclean # common-mostlyclean is in Makerules.
276 -rm -f $(foreach o,$(object-suffixes-for-libc),\
277 $(common-objpfx)$(patsubst %,$(libtype$o),c)) \
278 $(addprefix $(objpfx),$(install-lib))
279 parent-clean: parent-mostlyclean common-clean
281 postclean = $(addprefix $(common-objpfx),$(postclean-generated)) \
282 $(addprefix $(objpfx),sysd-dirs sysd-rules) \
283 $(addprefix $(objpfx),sysd-sorted soversions.mk soversions.i)
286 # This is done this way rather than having `subdir_clean' be a
287 # dependency of this target so that libc.a will be removed before the
288 # subdirectories are dealt with and so they won't try to remove object
289 # files from it when it's going to be removed anyway.
290 @$(MAKE) subdir_clean no_deps=t
292 mostlyclean: parent-mostlyclean
293 @$(MAKE) subdir_mostlyclean no_deps=t
297 @$(MAKE) subdir_testclean no_deps=t
300 vpath c++-types.data $(+sysdep_dirs)
302 tests-special += $(objpfx)c++-types-check.out
303 $(objpfx)c++-types-check.out: c++-types.data scripts/check-c++-types.sh
304 scripts/check-c++-types.sh $< $(CXX) $(filter-out -std=gnu11 $(+gccwarn-c),$(CFLAGS)) $(CPPFLAGS) > $@; \
308 tests-special += $(objpfx)check-local-headers.out
309 $(objpfx)check-local-headers.out: scripts/check-local-headers.sh
310 AWK='$(AWK)' scripts/check-local-headers.sh \
311 "$(includedir)" "$(objpfx)" < /dev/null > $@; \
314 ifneq "$(headers)" ""
315 # Special test of all the installed headers in this directory.
316 tests-special += $(objpfx)check-installed-headers-c.out
317 libof-check-installed-headers-c := testsuite
318 $(objpfx)check-installed-headers-c.out: \
319 scripts/check-installed-headers.sh $(headers)
320 $(SHELL) $(..)scripts/check-installed-headers.sh c \
321 "$(CC) $(filter-out -std=%,$(CFLAGS)) -D_ISOMAC $(+includes)" \
326 tests-special += $(objpfx)check-installed-headers-cxx.out
327 libof-check-installed-headers-cxx := testsuite
328 $(objpfx)check-installed-headers-cxx.out: \
329 scripts/check-installed-headers.sh $(headers)
330 $(SHELL) $(..)scripts/check-installed-headers.sh c++ \
331 "$(CXX) $(filter-out -std=%,$(CXXFLAGS)) -D_ISOMAC $(+includes)" \
336 tests-special += $(objpfx)check-wrapper-headers.out
337 $(objpfx)check-wrapper-headers.out: scripts/check-wrapper-headers.py $(headers)
338 $(PYTHON) $< --root=. --subdir=. $(headers) \
339 --generated $(common-generated) > $@; $(evaluate-test)
342 define summarize-tests
343 @egrep -v '^(PASS|XFAIL):' $(objpfx)$1 || true
344 @echo "Summary of test results$2:"
345 @sed 's/:.*//' < $(objpfx)$1 | sort | uniq -c
346 @! egrep -q -v '^(X?PASS|XFAIL|UNSUPPORTED):' $(objpfx)$1
349 # The intention here is to do ONE install of our build into the
350 # testroot.pristine/ directory, then rsync (internal to
351 # support/test-container) that to testroot.root/ at the start of each
352 # test. That way we can promise each test a "clean" install, without
353 # having to do the install for each test.
355 # In addition, we have to copy some files (which we build) into this
356 # root in addition to what glibc installs. For example, many tests
357 # require additional programs including /bin/sh, /bin/true, and
358 # /bin/echo, all of which we build below to limit library dependencies
359 # to just those things in glibc and language support libraries which
360 # we also copy into the into the rootfs. To determine what language
361 # support libraries we need we build a "test" program in either C or
362 # (if available) C++ just so we can copy in any shared objects
363 # (which we do not build) that GCC-compiled programs depend on.
367 LINKS_DSO_PROGRAM = links-dso-program-c
369 LINKS_DSO_PROGRAM = links-dso-program
372 $(tests-container) $(addsuffix /tests,$(subdirs)) : \
373 $(objpfx)testroot.pristine/install.stamp
374 $(objpfx)testroot.pristine/install.stamp :
375 test -d $(objpfx)testroot.pristine || \
376 mkdir $(objpfx)testroot.pristine
377 # We need a working /bin/sh for some of the tests.
378 test -d $(objpfx)testroot.pristine/bin || \
379 mkdir $(objpfx)testroot.pristine/bin
380 cp $(objpfx)support/shell-container $(objpfx)testroot.pristine/bin/sh
381 cp $(objpfx)support/echo-container $(objpfx)testroot.pristine/bin/echo
382 cp $(objpfx)support/true-container $(objpfx)testroot.pristine/bin/true
383 ifeq ($(run-built-tests),yes)
384 # Copy these DSOs first so we can overwrite them with our own.
385 for dso in `$(test-wrapper-env) LD_TRACE_LOADED_OBJECTS=1 \
387 $(objpfx)testroot.pristine/bin/sh \
388 | grep / | sed 's/^[^/]*//' | sed 's/ .*//'` ;\
390 test -d `dirname $(objpfx)testroot.pristine$$dso` || \
391 mkdir -p `dirname $(objpfx)testroot.pristine$$dso` ;\
392 $(test-wrapper) cp $$dso $(objpfx)testroot.pristine$$dso ;\
394 for dso in `$(test-wrapper-env) LD_TRACE_LOADED_OBJECTS=1 \
396 $(objpfx)support/$(LINKS_DSO_PROGRAM) \
397 | grep / | sed 's/^[^/]*//' | sed 's/ .*//'` ;\
399 test -d `dirname $(objpfx)testroot.pristine$$dso` || \
400 mkdir -p `dirname $(objpfx)testroot.pristine$$dso` ;\
401 $(test-wrapper) cp $$dso $(objpfx)testroot.pristine$$dso ;\
404 $(MAKE) install DESTDIR=$(objpfx)testroot.pristine \
405 subdirs='$(sorted-subdirs)'
406 touch $(objpfx)testroot.pristine/install.stamp
408 tests-special-notdir = $(patsubst $(objpfx)%, %, $(tests-special))
409 tests: $(tests-special)
410 $(..)scripts/merge-test-results.sh -s $(objpfx) "" \
411 $(sort $(tests-special-notdir:.out=)) \
412 > $(objpfx)subdir-tests.sum
413 $(..)scripts/merge-test-results.sh -t $(objpfx) subdir-tests.sum \
414 $(sort $(subdirs) .) \
416 $(call summarize-tests,tests.sum)
418 $(..)scripts/merge-test-results.sh -t $(objpfx) subdir-xtests.sum \
420 > $(objpfx)xtests.sum
421 $(call summarize-tests,xtests.sum, for extra tests)
423 # The realclean target is just like distclean for the parent, but we want
424 # the subdirs to know the difference in case they care.
425 realclean distclean: parent-clean
426 # This is done this way rather than having `subdir_distclean' be a
427 # dependency of this target so that libc.a will be removed before the
428 # subdirectories are dealt with and so they won't try to remove object
429 # files from it when it's going to be removed anyway.
430 @$(MAKE) distclean-1 no_deps=t distclean-1=$@ avoid-generated=yes \
431 sysdep-subdirs="$(sysdep-subdirs)"
434 # Subroutine of distclean and realclean.
435 distclean-1: subdir_$(distclean-1)
436 -rm -f $(config-generated)
437 -rm -f $(addprefix $(objpfx),config.status config.cache config.log)
438 -rm -f $(addprefix $(objpfx),config.make config-name.h config.h)
440 -rm -f $(objpfx)Makefile
442 -rm -f $(sysdep-$(distclean-1))
444 # Make the TAGS file for Emacs users.
448 scripts/list-sources.sh | sed -n -e '/Makefile/p' \
449 $(foreach S,[chsSyl] cxx sh bash pl,\
450 $(subst .,\.,-e '/.$S\(.in\)*$$/p')) \
453 # Make the distribution tarfile.
454 .PHONY: dist dist-prepare
456 generated := $(generated) stubs.h
458 files-for-dist := README INSTALL configure ChangeLog NEWS
460 # Regenerate stuff, then error if these things are not committed yet.
461 dist-prepare: $(files-for-dist)
462 conf=`find sysdeps -name configure`; \
464 git diff --stat HEAD -- $^ $$conf \
465 | $(AWK) '{ print; rc=1 } END { exit rc }'
468 git archive --prefix=$*/ $* > $@.new
471 # Do `make dist dist-version=X.Y.Z' to make tar files of an older version.
473 ifneq (,$(strip $(dist-version)))
474 dist: $(foreach Z,.bz2 .gz .xz,$(dist-version).tar$Z)
478 @if v=`git describe`; then \
479 echo Distribution version $$v; \
480 $(MAKE) dist dist-version=$$v; \
486 INSTALL: manual/install-plain.texi manual/macros.texi \
487 $(common-objpfx)manual/pkgvers.texi manual/install.texi
488 makeinfo --no-validate --plaintext --no-number-sections \
489 -I$(common-objpfx)manual $< -o $@-tmp
490 $(AWK) 'NF == 0 { ++n; next } \
491 NF != 0 { while (n-- > 0) print ""; n = 0; print }' \
496 $(common-objpfx)manual/%: FORCE
497 $(MAKE) $(PARALLELMFLAGS) -C manual $@
500 iconvdata/% localedata/% po/%: FORCE
501 $(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)