1# Copyright (C) 1991-2022 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# <https://www.gnu.org/licenses/>.
17
18#
19#	Master Makefile for the GNU C library
20#
21ifneq (,)
22This makefile requires GNU Make.
23endif
24
25include Makeconfig
26
27
28# This is the default target; it makes everything except the tests.
29.PHONY: all help minihelp
30all: minihelp lib others
31
32help:
33	@sed '0,/^help-starts-here$$/d' Makefile.help
34
35minihelp:
36	@echo
37	@echo type \"make help\" for help with common glibc makefile targets
38	@echo
39
40
41ifneq ($(AUTOCONF),no)
42
43define autoconf-it
44@-rm -f $@.new
45$(AUTOCONF) $(ACFLAGS) $< > $@.new
46chmod a-w$(patsubst %,$(comma)a+x,$(filter .,$(@D))) $@.new
47mv -f $@.new $@
48endef
49
50configure: configure.ac aclocal.m4; $(autoconf-it)
51%/configure: %/configure.ac aclocal.m4; $(autoconf-it)
52%/preconfigure: %/preconfigure.ac aclocal.m4; $(autoconf-it)
53
54endif # $(AUTOCONF) = no
55
56
57# We don't want to run anything here in parallel.
58.NOTPARALLEL:
59
60# These are the targets that are made by making them in each subdirectory.
61+subdir_targets	:= subdir_lib objects objs others subdir_mostlyclean	\
62		   subdir_clean subdir_distclean subdir_realclean	\
63		   tests xtests						\
64		   subdir_update-abi subdir_check-abi			\
65		   subdir_update-all-abi				\
66		   subdir_echo-headers					\
67		   subdir_install					\
68		   subdir_objs subdir_stubs subdir_testclean		\
69		   $(addprefix install-, no-libc.a bin lib data headers others)
70
71headers := limits.h values.h features.h features-time64.h gnu-versions.h \
72	   bits/xopen_lim.h gnu/libc-version.h stdc-predef.h \
73	   bits/libc-header-start.h
74
75echo-headers: subdir_echo-headers
76
77# The headers are in the include directory.
78subdir-dirs = include
79vpath %.h $(subdir-dirs)
80
81# What to install.
82install-others = $(inst_includedir)/gnu/stubs.h
83install-bin-script =
84
85ifeq (yes,$(build-shared))
86headers += gnu/lib-names.h
87endif
88
89include Makerules
90
91ifeq ($(build-programs),yes)
92others: $(addprefix $(objpfx),$(install-bin-script))
93endif
94
95# Install from subdirectories too.
96install: subdir_install
97
98# Explicit dependency so that `make install-headers' works
99install-headers: install-headers-nosubdir
100
101# Make sure that the dynamic linker is installed before libc.
102$(inst_slibdir)/libc-$(version).so: elf/ldso_install
103
104.PHONY: elf/ldso_install
105elf/ldso_install:
106	$(MAKE) -C $(@D) $(@F)
107
108# Create links for shared libraries using the `ldconfig' program if possible.
109# Ignore the error if we cannot update /etc/ld.so.cache.
110ifeq (no,$(cross-compiling))
111ifeq (yes,$(build-shared))
112install:
113	-test ! -x $(elf-objpfx)ldconfig || LC_ALL=C \
114	  $(elf-objpfx)ldconfig $(addprefix -r ,$(install_root)) \
115				$(slibdir) $(libdir)
116ifneq (no,$(PERL))
117ifeq (/usr,$(prefix))
118ifeq (,$(install_root))
119	LD_SO=$(ld.so-version) CC="$(CC)" $(PERL) scripts/test-installation.pl $(common-objpfx)
120endif
121endif
122endif
123endif
124endif
125
126# Build subdirectory lib objects.
127lib-noranlib: subdir_lib
128
129ifeq (yes,$(build-shared))
130# Build the shared object from the PIC object library.
131lib: $(common-objpfx)libc.so $(common-objpfx)linkobj/libc.so
132endif # $(build-shared)
133
134# Used to build testrun.sh.
135define testrun-script
136#!/bin/bash
137builddir=`dirname "$$0"`
138GCONV_PATH="$${builddir}/iconvdata"
139
140usage () {
141cat << EOF
142Usage: $$0 [OPTIONS] <program> [ARGUMENTS...]
143
144  --tool=TOOL  Run with the specified TOOL. It can be strace, rpctrace,
145               valgrind or container. The container will run within
146               support/test-container.  For strace and valgrind,
147               additional arguments can be passed after the tool name.
148EOF
149
150  exit 1
151}
152
153toolname=default
154while test $$# -gt 0 ; do
155  case "$$1" in
156    --tool=*)
157      toolname="$${1:7}"
158      shift
159      ;;
160    --*)
161      usage
162      ;;
163    *)
164      break
165      ;;
166  esac
167done
168
169if test $$# -eq 0 ; then
170  usage
171fi
172
173case "$$toolname" in
174  default)
175    exec $(subst $(common-objdir),"$${builddir}", $(test-program-prefix)) \
176      $${1+"$$@"}
177    ;;
178  strace*)
179    exec $$toolname $(patsubst %, -E%, $(run-program-env)) \
180      $(test-via-rtld-prefix) $${1+"$$@"}
181    ;;
182  rpctrace)
183    exec rpctrace $(patsubst %, -E%, $(run-program-env)) \
184      $(test-via-rtld-prefix) $${1+"$$@"}
185    ;;
186  valgrind*)
187    exec env $(run-program-env) $$toolname $(test-via-rtld-prefix) $${1+"$$@"}
188    ;;
189  container)
190    exec env $(run-program-env) $(test-via-rtld-prefix) \
191      $(common-objdir)/support/test-container \
192      env $(run-program-env) $(test-via-rtld-prefix) $${1+"$$@"}
193    ;;
194  *)
195    usage
196    ;;
197esac
198endef
199
200# This is a handy script for running any dynamically linked program against
201# the current libc build for testing.
202$(common-objpfx)testrun.sh: $(common-objpfx)config.make \
203			    $(..)Makeconfig $(..)Makefile
204	$(file >$@T,$(testrun-script))
205	chmod a+x $@T
206	mv -f $@T $@
207postclean-generated += testrun.sh
208
209define debugglibc
210#!/bin/bash
211
212SOURCE_DIR="$(CURDIR)"
213BUILD_DIR="$(common-objpfx)"
214CMD_FILE="$(common-objpfx)debugglibc.gdb"
215CONTAINER=false
216DIRECT=true
217STATIC=false
218SYMBOLSFILE=true
219unset TESTCASE
220unset BREAKPOINTS
221unset ENVVARS
222
223usage()
224{
225cat << EOF
226Usage: $$0 [OPTIONS] <program>
227
228   Or: $$0 [OPTIONS] -- <program> [<args>]...
229
230  where <program> is the path to the program being tested,
231  and <args> are the arguments to be passed to it.
232
233Options:
234
235  -h, --help
236	Prints this message and leaves.
237
238  The following options require one argument:
239
240  -b, --breakpoint
241	Breakpoints to set at the beginning of the execution
242	(each breakpoint demands its own -b option, e.g. -b foo -b bar)
243  -e, --environment-variable
244	Environment variables to be set with 'exec-wrapper env' in GDB
245	(each environment variable demands its own -e option, e.g.
246	-e FOO=foo -e BAR=bar)
247
248  The following options do not take arguments:
249
250  -c, --in-container
251	Run the test case inside a container and automatically attach
252	GDB to it.
253  -i, --no-direct
254	Selects whether to pass the --direct flag to the program.
255	--direct is useful when debugging glibc test cases. It inhibits the
256	tests from forking and executing in a subprocess.
257	Default behaviour is to pass the --direct flag, except when the
258	program is run with user specified arguments using the "--" separator.
259  -s, --no-symbols-file
260	Do not tell GDB to load debug symbols from the program.
261EOF
262}
263
264# Parse input options
265while [[ $$# > 0 ]]
266do
267  key="$$1"
268  case $$key in
269    -h|--help)
270      usage
271      exit 0
272      ;;
273    -b|--breakpoint)
274      BREAKPOINTS="break $$2\n$$BREAKPOINTS"
275      shift
276      ;;
277    -e|--environment-variable)
278      ENVVARS="$$2 $$ENVVARS"
279      shift
280      ;;
281    -c|--in-container)
282      CONTAINER=true
283      ;;
284    -i|--no-direct)
285      DIRECT=false
286      ;;
287    -s|--no-symbols-file)
288      SYMBOLSFILE=false
289      ;;
290    --)
291      shift
292      TESTCASE=$$1
293      COMMANDLINE="$$@"
294      # Don't add --direct when user specifies program arguments
295      DIRECT=false
296      break
297      ;;
298    *)
299      TESTCASE=$$1
300      COMMANDLINE=$$TESTCASE
301      ;;
302  esac
303  shift
304done
305
306# Check for required argument and if the testcase exists
307if [ ! -v TESTCASE ] || [ ! -f $${TESTCASE} ]
308then
309  usage
310  exit 1
311fi
312
313# Container tests needing locale data should install them in-container.
314# Other tests/binaries need to use locale data from the build tree.
315if [ "$$CONTAINER" = false ]
316then
317  ENVVARS="GCONV_PATH=$${BUILD_DIR}/iconvdata $$ENVVARS"
318  ENVVARS="LOCPATH=$${BUILD_DIR}/localedata $$ENVVARS"
319  ENVVARS="LC_ALL=C $$ENVVARS"
320fi
321
322# Expand environment setup command
323if [ -v ENVVARS ]
324then
325  ENVVARSCMD="set exec-wrapper env $$ENVVARS"
326fi
327
328# Expand direct argument
329if [ "$$DIRECT" == true ]
330then
331  DIRECT="--direct"
332else
333  DIRECT=""
334fi
335
336# Check if the test case is static
337if file $${TESTCASE} | grep "statically linked" >/dev/null
338then
339  STATIC=true
340else
341  STATIC=false
342fi
343
344# Expand symbols loading command
345if [ "$$SYMBOLSFILE" == true ]
346then
347  SYMBOLSFILE="add-symbol-file $${TESTCASE}"
348else
349  SYMBOLSFILE=""
350fi
351
352# GDB commands template
353template ()
354{
355cat <<EOF
356set environment C -E -x c-header
357set auto-load safe-path $${BUILD_DIR}/nptl_db:\$$debugdir:\$$datadir/auto-load
358set libthread-db-search-path $${BUILD_DIR}/nptl_db
359__ENVVARS__
360__SYMBOLSFILE__
361break _dl_start_user
362run --library-path $(rpath-link):$${BUILD_DIR}/nptl_db \
363__COMMANDLINE__ __DIRECT__
364__BREAKPOINTS__
365EOF
366}
367
368# Generate the commands file for gdb initialization
369template | sed \
370  -e "s|__ENVVARS__|$$ENVVARSCMD|" \
371  -e "s|__SYMBOLSFILE__|$$SYMBOLSFILE|" \
372  -e "s|__COMMANDLINE__|$$COMMANDLINE|" \
373  -e "s|__DIRECT__|$$DIRECT|" \
374  -e "s|__BREAKPOINTS__|$$BREAKPOINTS|" \
375  > $$CMD_FILE
376
377echo
378echo "Debugging glibc..."
379echo "Build directory  : $$BUILD_DIR"
380echo "Source directory : $$SOURCE_DIR"
381echo "GLIBC Testcase   : $$TESTCASE"
382echo "GDB Commands     : $$CMD_FILE"
383echo "Env vars         : $$ENVVARS"
384echo
385
386if [ "$$CONTAINER" == true ]
387then
388# Use testrun.sh to start the test case with WAIT_FOR_DEBUGGER=1, then
389# automatically attach GDB to it.
390WAIT_FOR_DEBUGGER=1 $(common-objpfx)testrun.sh --tool=container $${TESTCASE} &
391gdb -x $${TESTCASE}.gdb
392elif [ "$$STATIC" == true ]
393then
394gdb $${TESTCASE}
395else
396# Start the test case debugging in two steps:
397#   1. the following command invokes gdb to run the loader;
398#   2. the commands file tells the loader to run the test case.
399gdb -q \
400  -x $${CMD_FILE} \
401  -d $${SOURCE_DIR} \
402  $${BUILD_DIR}/elf/ld.so
403fi
404endef
405
406# This is another handy script for debugging dynamically linked program
407# against the current libc build for testing.
408$(common-objpfx)debugglibc.sh: $(common-objpfx)config.make \
409			    $(..)Makeconfig $(..)Makefile
410	$(file >$@T,$(debugglibc))
411	chmod a+x $@T
412	mv -f $@T $@
413postclean-generated += debugglibc.sh debugglibc.gdb
414
415others: $(common-objpfx)testrun.sh $(common-objpfx)debugglibc.sh
416
417# Makerules creates a file `stubs' in each subdirectory, which
418# contains `#define __stub_FUNCTION' for each function defined in that
419# directory which is a stub.
420# Here we paste all of these together into <gnu/stubs.h>.
421
422subdir-stubs := $(foreach dir,$(subdirs),$(common-objpfx)$(dir)/stubs)
423
424ifndef abi-variants
425installed-stubs = $(inst_includedir)/gnu/stubs.h
426else
427installed-stubs = $(inst_includedir)/gnu/stubs-$(default-abi).h
428
429$(inst_includedir)/gnu/stubs.h: $(+force)
430	$(make-target-directory)
431	{ \
432	 echo '/* This file is automatically generated.';\
433	 echo "   This file selects the right generated file of \`__stub_FUNCTION' macros";\
434	 echo '   based on the architecture being compiled for.  */'; \
435	 echo ''; \
436	 $(foreach h,$(abi-includes), echo '#include <$(h)>';) \
437	 echo ''; \
438	 $(foreach v,$(abi-variants),\
439	 $(if $(abi-$(v)-condition),\
440	 echo '#if $(abi-$(v)-condition)'; \
441	 echo '# include <gnu/stubs-$(v).h>'); \
442	 $(if $(abi-$(v)-condition),echo '#endif';) \
443	 rm -f $(@:.d=.h).new$(v); \
444	 ) \
445	} > $(@:.d=.h).new
446	mv -f $(@:.d=.h).new $(@:.d=.h)
447
448install-others-nosubdir: $(installed-stubs)
449endif
450
451
452# Since stubs.h is never needed when building the library, we simplify the
453# hairy installation process by producing it in place only as the last part
454# of the top-level `make install'.  It depends on subdir_install, which
455# iterates over all the subdirs; subdir_install in each subdir depends on
456# the subdir's stubs file.  Having more direct dependencies would result in
457# extra iterations over the list for subdirs and many recursive makes.
458$(installed-stubs): include/stubs-prologue.h subdir_install
459	$(make-target-directory)
460	@rm -f $(objpfx)stubs.h
461	(sed '/^@/d' $<; LC_ALL=C sort $(subdir-stubs)) > $(objpfx)stubs.h
462	if test -r $@ && cmp -s $(objpfx)stubs.h $@; \
463	then echo 'stubs.h unchanged'; \
464	else $(INSTALL_DATA) $(objpfx)stubs.h $@; fi
465	rm -f $(objpfx)stubs.h
466
467# This makes the Info or DVI file of the documentation from the Texinfo source.
468.PHONY: info dvi pdf html
469info dvi pdf html:
470	$(MAKE) $(PARALLELMFLAGS) -C manual $@
471
472# This makes all the subdirectory targets.
473
474# For each target, make it depend on DIR/target for each subdirectory DIR.
475$(+subdir_targets): %: $(addsuffix /%,$(subdirs))
476
477# Compute a list of all those targets.
478all-subdirs-targets := $(foreach dir,$(subdirs),\
479				 $(addprefix $(dir)/,$(+subdir_targets)))
480
481# The action for each of those is to cd into the directory and make the
482# target there.
483$(all-subdirs-targets):
484	$(MAKE) $(PARALLELMFLAGS) $(subdir-target-args) $(@F)
485
486define subdir-target-args
487subdir=$(@D)$(if $($(@D)-srcdir),\
488-C $($(@D)-srcdir) ..=`pwd`/,\
489-C $(@D) ..=../)
490endef
491
492.PHONY: $(+subdir_targets) $(all-subdirs-targets)
493
494# Targets to clean things up to various degrees.
495
496.PHONY: clean realclean distclean distclean-1 parent-clean parent-mostlyclean \
497	tests-clean
498
499# Subroutines of all cleaning targets.
500parent-mostlyclean: common-mostlyclean # common-mostlyclean is in Makerules.
501	-rm -f $(foreach o,$(object-suffixes-for-libc),\
502		   $(common-objpfx)$(patsubst %,$(libtype$o),c)) \
503	       $(addprefix $(objpfx),$(install-lib))
504parent-clean: parent-mostlyclean common-clean
505
506postclean = $(addprefix $(common-objpfx),$(postclean-generated)) \
507	    $(addprefix $(objpfx),sysd-dirs sysd-rules) \
508	    $(addprefix $(objpfx),sysd-sorted soversions.mk soversions.i)
509
510clean: parent-clean
511# This is done this way rather than having `subdir_clean' be a
512# dependency of this target so that libc.a will be removed before the
513# subdirectories are dealt with and so they won't try to remove object
514# files from it when it's going to be removed anyway.
515	@$(MAKE) subdir_clean no_deps=t
516	-rm -f $(postclean)
517mostlyclean: parent-mostlyclean
518	@$(MAKE) subdir_mostlyclean no_deps=t
519	-rm -f $(postclean)
520
521tests-clean:
522	@$(MAKE) subdir_testclean no_deps=t
523
524ifneq (,$(CXX))
525vpath c++-types.data $(+sysdep_dirs)
526
527tests-special += $(objpfx)c++-types-check.out
528$(objpfx)c++-types-check.out: c++-types.data scripts/check-c++-types.sh
529	scripts/check-c++-types.sh $< $(CXX) $(filter-out -std=gnu11 $(+gccwarn-c),$(CFLAGS)) $(CPPFLAGS) > $@; \
530	$(evaluate-test)
531endif
532
533tests-special += $(objpfx)check-local-headers.out
534$(objpfx)check-local-headers.out: scripts/check-local-headers.sh
535	AWK='$(AWK)' scripts/check-local-headers.sh \
536	  "$(includedir)" "$(objpfx)" < /dev/null > $@; \
537	$(evaluate-test)
538
539ifneq "$(headers)" ""
540# Special test of all the installed headers in this directory.
541tests-special += $(objpfx)check-installed-headers-c.out
542libof-check-installed-headers-c := testsuite
543$(objpfx)check-installed-headers-c.out: \
544    scripts/check-installed-headers.sh $(headers)
545	$(SHELL) $(..)scripts/check-installed-headers.sh c \
546	  "$(CC) $(filter-out -std=%,$(CFLAGS)) -D_ISOMAC $(+includes)" \
547	  $(headers) > $@; \
548	$(evaluate-test)
549
550ifneq "$(CXX)" ""
551tests-special += $(objpfx)check-installed-headers-cxx.out
552libof-check-installed-headers-cxx := testsuite
553$(objpfx)check-installed-headers-cxx.out: \
554    scripts/check-installed-headers.sh $(headers)
555	$(SHELL) $(..)scripts/check-installed-headers.sh c++ \
556	  "$(CXX) $(filter-out -std=%,$(CXXFLAGS)) -D_ISOMAC $(+includes)" \
557	  $(headers) > $@; \
558	$(evaluate-test)
559endif # $(CXX)
560
561tests-special += $(objpfx)check-wrapper-headers.out
562$(objpfx)check-wrapper-headers.out: scripts/check-wrapper-headers.py $(headers)
563	$(PYTHON) $< --root=. --subdir=. $(headers) \
564	  --generated $(common-generated) > $@; $(evaluate-test)
565endif # $(headers)
566
567define summarize-tests
568@grep -E -v '^(PASS|XFAIL):' $(objpfx)$1 || true
569@echo "Summary of test results$2:"
570@sed 's/:.*//' < $(objpfx)$1 | sort | uniq -c
571@! grep -E -q -v '^(X?PASS|XFAIL|UNSUPPORTED):' $(objpfx)$1
572endef
573
574# The intention here is to do ONE install of our build into the
575# testroot.pristine/ directory, then rsync (internal to
576# support/test-container) that to testroot.root/ at the start of each
577# test.  That way we can promise each test a "clean" install, without
578# having to do the install for each test.
579#
580# In addition, we have to copy some files (which we build) into this
581# root in addition to what glibc installs.  For example, many tests
582# require additional programs including /bin/sh, /bin/true, and
583# /bin/echo, all of which we build below to limit library dependencies
584# to just those things in glibc and language support libraries which
585# we also copy into the into the rootfs.  To determine what language
586# support libraries we need we build a "test" program in either C or
587# (if available) C++ just so we can copy in any shared objects
588# (which we do not build) that GCC-compiled programs depend on.
589
590
591ifeq (,$(CXX))
592LINKS_DSO_PROGRAM = links-dso-program-c
593else
594LINKS_DSO_PROGRAM = links-dso-program
595endif
596
597$(tests-container) $(addsuffix /tests,$(subdirs)) : \
598		$(objpfx)testroot.pristine/install.stamp
599$(objpfx)testroot.pristine/install.stamp :
600	test -d $(objpfx)testroot.pristine || \
601	  mkdir $(objpfx)testroot.pristine
602	# We need a working /bin/sh for some of the tests.
603	test -d $(objpfx)testroot.pristine/bin || \
604	  mkdir $(objpfx)testroot.pristine/bin
605	# We need the compiled locale dir for localedef tests.
606	test -d $(objpfx)testroot.pristine/$(complocaledir) || \
607	  mkdir -p $(objpfx)testroot.pristine/$(complocaledir)
608	cp $(objpfx)support/shell-container $(objpfx)testroot.pristine/bin/sh
609	cp $(objpfx)support/echo-container $(objpfx)testroot.pristine/bin/echo
610	cp $(objpfx)support/true-container $(objpfx)testroot.pristine/bin/true
611ifeq ($(run-built-tests),yes)
612	# Copy these DSOs first so we can overwrite them with our own.
613	for dso in `$(test-wrapper-env) LD_TRACE_LOADED_OBJECTS=1  \
614		$(rtld-prefix) \
615		$(objpfx)testroot.pristine/bin/sh \
616	        | sed -n '/\//{s@.*=> /@/@;s/^[^/]*//;s/ .*//p;}'` ;\
617	  do \
618	    test -d `dirname $(objpfx)testroot.pristine$$dso` || \
619	      mkdir -p `dirname $(objpfx)testroot.pristine$$dso` ;\
620	    $(test-wrapper) cp $$dso $(objpfx)testroot.pristine$$dso ;\
621	  done
622	for dso in `$(test-wrapper-env) LD_TRACE_LOADED_OBJECTS=1  \
623		$(rtld-prefix) \
624		$(objpfx)support/$(LINKS_DSO_PROGRAM) \
625	        | sed -n '/\//{s@.*=> /@/@;s/^[^/]*//;s/ .*//p;}'` ;\
626	  do \
627	    test -d `dirname $(objpfx)testroot.pristine$$dso` || \
628	      mkdir -p `dirname $(objpfx)testroot.pristine$$dso` ;\
629	    $(test-wrapper) cp $$dso $(objpfx)testroot.pristine$$dso ;\
630	  done
631endif
632	# $(symbolic-link-list) is a file that encodes $(DESTDIR) so we
633	# have to purge it
634	rm -f $(symbolic-link-list)
635	# Setting INSTALL_UNCOMPRESSED causes localedata/Makefile to
636	# install the charmaps uncompressed, as the testroot does not
637	# provide a gunzip program.
638	$(MAKE) install DESTDIR=$(objpfx)testroot.pristine \
639	  INSTALL_UNCOMPRESSED=yes subdirs='$(sorted-subdirs)'
640	rm -f $(symbolic-link-list)
641	touch $(objpfx)testroot.pristine/install.stamp
642
643tests-special-notdir = $(patsubst $(objpfx)%, %, $(tests-special))
644tests: $(tests-special)
645	$(..)scripts/merge-test-results.sh -s $(objpfx) "" \
646	  $(sort $(tests-special-notdir:.out=)) \
647	  > $(objpfx)subdir-tests.sum
648	$(..)scripts/merge-test-results.sh -t $(objpfx) subdir-tests.sum \
649	  $(sort $(subdirs) .) \
650	  > $(objpfx)tests.sum
651	$(call summarize-tests,tests.sum)
652xtests:
653	$(..)scripts/merge-test-results.sh -t $(objpfx) subdir-xtests.sum \
654	  $(sort $(subdirs)) \
655	  > $(objpfx)xtests.sum
656	$(call summarize-tests,xtests.sum, for extra tests)
657
658# The realclean target is just like distclean for the parent, but we want
659# the subdirs to know the difference in case they care.
660realclean distclean: parent-clean
661# This is done this way rather than having `subdir_distclean' be a
662# dependency of this target so that libc.a will be removed before the
663# subdirectories are dealt with and so they won't try to remove object
664# files from it when it's going to be removed anyway.
665	@$(MAKE) distclean-1 no_deps=t distclean-1=$@ avoid-generated=yes \
666		 sysdep-subdirs="$(sysdep-subdirs)"
667	-rm -f $(postclean)
668
669# Subroutine of distclean and realclean.
670distclean-1: subdir_$(distclean-1)
671	-rm -f $(config-generated)
672	-rm -f $(addprefix $(objpfx),config.status config.cache config.log)
673	-rm -f $(addprefix $(objpfx),config.make config-name.h config.h)
674ifdef objdir
675	-rm -f $(objpfx)Makefile
676endif
677	-rm -f $(sysdep-$(distclean-1))
678
679# Make the TAGS file for Emacs users.
680
681.PHONY: TAGS
682TAGS:
683	scripts/list-sources.sh | sed -n -e '/Makefile/p' \
684	  $(foreach S,[chsSyl] cxx sh bash pl,\
685		    $(subst .,\.,-e '/.$S\(.in\)*$$/p')) \
686	| $(ETAGS) -o $@ -
687
688# Make the distribution tarfile.
689.PHONY: dist dist-prepare
690
691generated := $(generated) stubs.h
692
693files-for-dist := README INSTALL configure NEWS
694
695# Regenerate stuff, then error if these things are not committed yet.
696dist-prepare: $(files-for-dist)
697	conf=`find sysdeps -name configure`; \
698	$(MAKE) $$conf && \
699	git diff --stat HEAD -- $^ $$conf \
700	| $(AWK) '{ print; rc=1 } END { exit rc }'
701
702%.tar: FORCE
703	git archive --prefix=$*/ $* > $@.new
704	mv -f $@.new $@
705
706# Do `make dist dist-version=X.Y.Z' to make tar files of an older version.
707
708ifneq (,$(strip $(dist-version)))
709dist: $(foreach Z,.bz2 .gz .xz,$(dist-version).tar$Z)
710	md5sum $^
711else
712dist: dist-prepare
713	@if v=`git describe`; then \
714	  echo Distribution version $$v; \
715	  $(MAKE) dist dist-version=$$v; \
716	else \
717	  false; \
718	fi
719endif
720
721INSTALL: manual/install-plain.texi manual/macros.texi \
722	 $(common-objpfx)manual/pkgvers.texi manual/install.texi
723	makeinfo --no-validate --plaintext --no-number-sections \
724		 -I$(common-objpfx)manual $< -o $@-tmp
725	$(AWK) 'NF == 0 { ++n; next } \
726		NF != 0 { while (n-- > 0) print ""; n = 0; print }' \
727	  < $@-tmp > $@-tmp2
728	rm -f $@-tmp
729	-chmod a-w $@-tmp2
730	mv -f $@-tmp2 $@
731$(common-objpfx)manual/%: FORCE
732	$(MAKE) $(PARALLELMFLAGS) -C manual $@
733FORCE:
734
735iconvdata/% localedata/% po/%: FORCE
736	$(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)
737
738# Convenience target to rerun one test, from the top of the build tree
739# Example: make test t=wcsmbs/test-wcsnlen
740.PHONY: test
741test :
742	@-rm -f $(objpfx)$t.out
743	$(MAKE) subdir=$(patsubst %/,%,$(dir $t)) -C $(dir $t) ..=../ $(objpfx)$t.out
744	@cat $(objpfx)$t.test-result
745	@cat $(objpfx)$t.out
746