Makefile

   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 #
  21 ifneq (,)
  22 This makefile requires GNU Make.
  23 endif
  24
  25 include Makeconfig
  26
  27
  28 # This is the default target; it makes everything except the tests.
  29 .PHONY: all help minihelp
  30 all: minihelp lib others
  31
  32 help:
  33         @sed '0,/^help-starts-here$$/d' Makefile.help
  34
  35 minihelp:
  36         @echo
  37         @echo type \"make help\" for help with common glibc makefile targets
  38         @echo
  39
  40 \f
  41 ifneq ($(AUTOCONF),no)
  42
  43 define autoconf-it
  44 @-rm -f $@.new
  45 $(AUTOCONF) $(ACFLAGS) $< > $@.new
  46 chmod a-w$(patsubst %,$(comma)a+x,$(filter .,$(@D))) $@.new
  47 mv -f $@.new $@
  48 endef
  49
  50 configure: configure.ac aclocal.m4; $(autoconf-it)
  51 %/configure: %/configure.ac aclocal.m4; $(autoconf-it)
  52 %/preconfigure: %/preconfigure.ac aclocal.m4; $(autoconf-it)
  53
  54 endif # $(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 \f
  71 headers := 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
  75 echo-headers: subdir_echo-headers
  76
  77 # The headers are in the include directory.
  78 subdir-dirs = include
  79 vpath %.h $(subdir-dirs)
  80
  81 # What to install.
  82 install-others = $(inst_includedir)/gnu/stubs.h
  83 install-bin-script =
  84
  85 ifeq (yes,$(build-shared))
  86 headers += gnu/lib-names.h
  87 endif
  88
  89 include Makerules
  90
  91 ifeq ($(build-programs),yes)
  92 others: $(addprefix $(objpfx),$(install-bin-script))
  93 endif
  94
  95 # Install from subdirectories too.
  96 install: subdir_install
  97
  98 # Explicit dependency so that `make install-headers' works
  99 install-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
 105 elf/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.
 110 ifeq (no,$(cross-compiling))
 111 ifeq (yes,$(build-shared))
 112 install:
 113         -test ! -x $(elf-objpfx)ldconfig || LC_ALL=C \
 114           $(elf-objpfx)ldconfig $(addprefix -r ,$(install_root)) \
 115                                 $(slibdir) $(libdir)
 116 ifneq (no,$(PERL))
 117 ifeq (/usr,$(prefix))
 118 ifeq (,$(install_root))
 119         LD_SO=$(ld.so-version) CC="$(CC)" $(PERL) scripts/test-installation.pl $(common-objpfx)
 120 endif
 121 endif
 122 endif
 123 endif
 124 endif
 125
 126 # Build subdirectory lib objects.
 127 lib-noranlib: subdir_lib
 128
 129 ifeq (yes,$(build-shared))
 130 # Build the shared object from the PIC object library.
 131 lib: $(common-objpfx)libc.so $(common-objpfx)linkobj/libc.so
 132 endif # $(build-shared)
 133
 134 # Used to build testrun.sh.
 135 define testrun-script
 136 #!/bin/bash
 137 builddir=`dirname "$$0"`
 138 GCONV_PATH="$${builddir}/iconvdata"
 139
 140 usage () {
 141 cat << EOF
 142 Usage: $$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.
 148 EOF
 149
 150   exit 1
 151 }
 152
 153 toolname=default
 154 while 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
 167 done
 168
 169 if test $$# -eq 0 ; then
 170   usage
 171 fi
 172
 173 case "$$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     ;;
 197 esac
 198 endef
 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 $@
 207 postclean-generated += testrun.sh
 208
 209 define debugglibc
 210 #!/bin/bash
 211
 212 SOURCE_DIR="$(CURDIR)"
 213 BUILD_DIR="$(common-objpfx)"
 214 CMD_FILE="$(common-objpfx)debugglibc.gdb"
 215 CONTAINER=false
 216 DIRECT=true
 217 STATIC=false
 218 SYMBOLSFILE=true
 219 unset TESTCASE
 220 unset BREAKPOINTS
 221 unset ENVVARS
 222
 223 usage()
 224 {
 225 cat << EOF
 226 Usage: $$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
 233 Options:
 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.
 261 EOF
 262 }
 263
 264 # Parse input options
 265 while [[ $$# > 0 ]]
 266 do
 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
 304 done
 305
 306 # Check for required argument and if the testcase exists
 307 if [ ! -v TESTCASE ] || [ ! -f $${TESTCASE} ]
 308 then
 309   usage
 310   exit 1
 311 fi
 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.
 315 if [ "$$CONTAINER" = false ]
 316 then
 317   ENVVARS="GCONV_PATH=$${BUILD_DIR}/iconvdata $$ENVVARS"
 318   ENVVARS="LOCPATH=$${BUILD_DIR}/localedata $$ENVVARS"
 319   ENVVARS="LC_ALL=C $$ENVVARS"
 320 fi
 321
 322 # Expand environment setup command
 323 if [ -v ENVVARS ]
 324 then
 325   ENVVARSCMD="set exec-wrapper env $$ENVVARS"
 326 fi
 327
 328 # Expand direct argument
 329 if [ "$$DIRECT" == true ]
 330 then
 331   DIRECT="--direct"
 332 else
 333   DIRECT=""
 334 fi
 335
 336 # Check if the test case is static
 337 if file $${TESTCASE} | grep "statically linked" >/dev/null
 338 then
 339   STATIC=true
 340 else
 341   STATIC=false
 342 fi
 343
 344 # Expand symbols loading command
 345 if [ "$$SYMBOLSFILE" == true ]
 346 then
 347   SYMBOLSFILE="add-symbol-file $${TESTCASE}"
 348 else
 349   SYMBOLSFILE=""
 350 fi
 351
 352 # GDB commands template
 353 template ()
 354 {
 355 cat <<EOF
 356 set environment C -E -x c-header
 357 set auto-load safe-path $${BUILD_DIR}/nptl_db:\$$debugdir:\$$datadir/auto-load
 358 set libthread-db-search-path $${BUILD_DIR}/nptl_db
 359 __ENVVARS__
 360 __SYMBOLSFILE__
 361 break _dl_start_user
 362 run --library-path $(rpath-link):$${BUILD_DIR}/nptl_db \
 363 __COMMANDLINE__ __DIRECT__
 364 __BREAKPOINTS__
 365 EOF
 366 }
 367
 368 # Generate the commands file for gdb initialization
 369 template | 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
 377 echo
 378 echo "Debugging glibc..."
 379 echo "Build directory  : $$BUILD_DIR"
 380 echo "Source directory : $$SOURCE_DIR"
 381 echo "GLIBC Testcase   : $$TESTCASE"
 382 echo "GDB Commands     : $$CMD_FILE"
 383 echo "Env vars         : $$ENVVARS"
 384 echo
 385
 386 if [ "$$CONTAINER" == true ]
 387 then
 388 # Use testrun.sh to start the test case with WAIT_FOR_DEBUGGER=1, then
 389 # automatically attach GDB to it.
 390 WAIT_FOR_DEBUGGER=1 $(common-objpfx)testrun.sh --tool=container $${TESTCASE} &
 391 gdb -x $${TESTCASE}.gdb
 392 elif [ "$$STATIC" == true ]
 393 then
 394 gdb $${TESTCASE}
 395 else
 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.
 399 gdb -q \
 400   -x $${CMD_FILE} \
 401   -d $${SOURCE_DIR} \
 402   $${BUILD_DIR}/elf/ld.so
 403 fi
 404 endef
 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 $@
 413 postclean-generated += debugglibc.sh debugglibc.gdb
 414
 415 others: $(common-objpfx)testrun.sh $(common-objpfx)debugglibc.sh
 416 \f
 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
 422 subdir-stubs := $(foreach dir,$(subdirs),$(common-objpfx)$(dir)/stubs)
 423
 424 ifndef abi-variants
 425 installed-stubs = $(inst_includedir)/gnu/stubs.h
 426 else
 427 installed-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
 448 install-others-nosubdir: $(installed-stubs)
 449 endif
 450
 451 # If we're bootstrapping, install a dummy gnu/stubs.h along with the
 452 # other headers, so 'make install-headers' produces a useable include
 453 # tree.  Otherwise, install gnu/stubs.h later, after the rest of the
 454 # build is done.
 455 ifeq ($(install-bootstrap-headers),yes)
 456 install-headers: $(inst_includedir)/gnu/stubs.h $(installed-stubs) \
 457                  $(inst_includedir)/$(lib-names-h-abi)
 458 endif
 459
 460 # Since stubs.h is never needed when building the library, we simplify the
 461 # hairy installation process by producing it in place only as the last part
 462 # of the top-level `make install'.  It depends on subdir_install, which
 463 # iterates over all the subdirs; subdir_install in each subdir depends on
 464 # the subdir's stubs file.  Having more direct dependencies would result in
 465 # extra iterations over the list for subdirs and many recursive makes.
 466 ifeq ($(install-bootstrap-headers),yes)
 467 # gnu/stubs.h depends (via the subdir 'stubs' targets) on all the .o
 468 # files in GLIBC.  For bootstrapping a GCC/GLIBC pair, an empty
 469 # gnu/stubs.h is good enough.
 470 $(installed-stubs): include/stubs-bootstrap.h $(+force)
 471         $(make-target-directory)
 472         $(INSTALL_DATA) $< $@
 473 else
 474 $(installed-stubs): include/stubs-prologue.h subdir_install
 475         $(make-target-directory)
 476         @rm -f $(objpfx)stubs.h
 477         (sed '/^@/d' $<; LC_ALL=C sort $(subdir-stubs)) > $(objpfx)stubs.h
 478         if test -r $@ && cmp -s $(objpfx)stubs.h $@; \
 479         then echo 'stubs.h unchanged'; \
 480         else $(INSTALL_DATA) $(objpfx)stubs.h $@; fi
 481         rm -f $(objpfx)stubs.h
 482 endif
 483 \f
 484 # This makes the Info or DVI file of the documentation from the Texinfo source.
 485 .PHONY: info dvi pdf html
 486 info dvi pdf html:
 487         $(MAKE) $(PARALLELMFLAGS) -C manual $@
 488 \f
 489 # This makes all the subdirectory targets.
 490
 491 # For each target, make it depend on DIR/target for each subdirectory DIR.
 492 $(+subdir_targets): %: $(addsuffix /%,$(subdirs))
 493
 494 # Compute a list of all those targets.
 495 all-subdirs-targets := $(foreach dir,$(subdirs),\
 496                                  $(addprefix $(dir)/,$(+subdir_targets)))
 497
 498 # The action for each of those is to cd into the directory and make the
 499 # target there.
 500 $(all-subdirs-targets):
 501         $(MAKE) $(PARALLELMFLAGS) $(subdir-target-args) $(@F)
 502
 503 define subdir-target-args
 504 subdir=$(@D)$(if $($(@D)-srcdir),\
 505 -C $($(@D)-srcdir) ..=`pwd`/,\
 506 -C $(@D) ..=../)
 507 endef
 508
 509 .PHONY: $(+subdir_targets) $(all-subdirs-targets)
 510 \f
 511 # Targets to clean things up to various degrees.
 512
 513 .PHONY: clean realclean distclean distclean-1 parent-clean parent-mostlyclean \
 514         tests-clean
 515
 516 # Subroutines of all cleaning targets.
 517 parent-mostlyclean: common-mostlyclean # common-mostlyclean is in Makerules.
 518         -rm -f $(foreach o,$(object-suffixes-for-libc),\
 519                    $(common-objpfx)$(patsubst %,$(libtype$o),c)) \
 520                $(addprefix $(objpfx),$(install-lib))
 521 parent-clean: parent-mostlyclean common-clean
 522
 523 postclean = $(addprefix $(common-objpfx),$(postclean-generated)) \
 524             $(addprefix $(objpfx),sysd-dirs sysd-rules) \
 525             $(addprefix $(objpfx),sysd-sorted soversions.mk soversions.i)
 526
 527 clean: parent-clean
 528 # This is done this way rather than having `subdir_clean' be a
 529 # dependency of this target so that libc.a will be removed before the
 530 # subdirectories are dealt with and so they won't try to remove object
 531 # files from it when it's going to be removed anyway.
 532         @$(MAKE) subdir_clean no_deps=t
 533         -rm -f $(postclean)
 534 mostlyclean: parent-mostlyclean
 535         @$(MAKE) subdir_mostlyclean no_deps=t
 536         -rm -f $(postclean)
 537
 538 tests-clean:
 539         @$(MAKE) subdir_testclean no_deps=t
 540
 541 ifneq (,$(CXX))
 542 vpath c++-types.data $(+sysdep_dirs)
 543
 544 tests-special += $(objpfx)c++-types-check.out
 545 $(objpfx)c++-types-check.out: c++-types.data scripts/check-c++-types.sh
 546         scripts/check-c++-types.sh $< $(CXX) $(filter-out -std=gnu11 $(+gccwarn-c),$(CFLAGS)) $(CPPFLAGS) > $@; \
 547         $(evaluate-test)
 548 endif
 549
 550 tests-special += $(objpfx)check-local-headers.out
 551 $(objpfx)check-local-headers.out: scripts/check-local-headers.sh
 552         AWK='$(AWK)' scripts/check-local-headers.sh \
 553           "$(includedir)" "$(objpfx)" < /dev/null > $@; \
 554         $(evaluate-test)
 555
 556 ifneq "$(headers)" ""
 557 # Special test of all the installed headers in this directory.
 558 tests-special += $(objpfx)check-installed-headers-c.out
 559 libof-check-installed-headers-c := testsuite
 560 $(objpfx)check-installed-headers-c.out: \
 561     scripts/check-installed-headers.sh $(headers)
 562         $(SHELL) $(..)scripts/check-installed-headers.sh c \
 563           "$(CC) $(filter-out -std=%,$(CFLAGS)) -D_ISOMAC $(+includes)" \
 564           $(headers) > $@; \
 565         $(evaluate-test)
 566
 567 ifneq "$(CXX)" ""
 568 tests-special += $(objpfx)check-installed-headers-cxx.out
 569 libof-check-installed-headers-cxx := testsuite
 570 $(objpfx)check-installed-headers-cxx.out: \
 571     scripts/check-installed-headers.sh $(headers)
 572         $(SHELL) $(..)scripts/check-installed-headers.sh c++ \
 573           "$(CXX) $(filter-out -std=%,$(CXXFLAGS)) -D_ISOMAC $(+includes)" \
 574           $(headers) > $@; \
 575         $(evaluate-test)
 576 endif # $(CXX)
 577
 578 tests-special += $(objpfx)check-wrapper-headers.out
 579 $(objpfx)check-wrapper-headers.out: scripts/check-wrapper-headers.py $(headers)
 580         $(PYTHON) $< --root=. --subdir=. $(headers) \
 581           --generated $(common-generated) > $@; $(evaluate-test)
 582 endif # $(headers)
 583
 584 define summarize-tests
 585 @grep -E -v '^(PASS|XFAIL):' $(objpfx)$1 || true
 586 @echo "Summary of test results$2:"
 587 @sed 's/:.*//' < $(objpfx)$1 | sort | uniq -c
 588 @! grep -E -q -v '^(X?PASS|XFAIL|UNSUPPORTED):' $(objpfx)$1
 589 endef
 590
 591 # The intention here is to do ONE install of our build into the
 592 # testroot.pristine/ directory, then rsync (internal to
 593 # support/test-container) that to testroot.root/ at the start of each
 594 # test.  That way we can promise each test a "clean" install, without
 595 # having to do the install for each test.
 596 #
 597 # In addition, we have to copy some files (which we build) into this
 598 # root in addition to what glibc installs.  For example, many tests
 599 # require additional programs including /bin/sh, /bin/true, and
 600 # /bin/echo, all of which we build below to limit library dependencies
 601 # to just those things in glibc and language support libraries which
 602 # we also copy into the into the rootfs.  To determine what language
 603 # support libraries we need we build a "test" program in either C or
 604 # (if available) C++ just so we can copy in any shared objects
 605 # (which we do not build) that GCC-compiled programs depend on.
 606
 607
 608 ifeq (,$(CXX))
 609 LINKS_DSO_PROGRAM = links-dso-program-c
 610 else
 611 LINKS_DSO_PROGRAM = links-dso-program
 612 endif
 613
 614 $(tests-container) $(addsuffix /tests,$(subdirs)) : \
 615                 $(objpfx)testroot.pristine/install.stamp
 616 $(objpfx)testroot.pristine/install.stamp :
 617         test -d $(objpfx)testroot.pristine || \
 618           mkdir $(objpfx)testroot.pristine
 619         # We need a working /bin/sh for some of the tests.
 620         test -d $(objpfx)testroot.pristine/bin || \
 621           mkdir $(objpfx)testroot.pristine/bin
 622         # We need the compiled locale dir for localedef tests.
 623         test -d $(objpfx)testroot.pristine/$(complocaledir) || \
 624           mkdir -p $(objpfx)testroot.pristine/$(complocaledir)
 625         cp $(objpfx)support/shell-container $(objpfx)testroot.pristine/bin/sh
 626         cp $(objpfx)support/echo-container $(objpfx)testroot.pristine/bin/echo
 627         cp $(objpfx)support/true-container $(objpfx)testroot.pristine/bin/true
 628 ifeq ($(run-built-tests),yes)
 629         # Copy these DSOs first so we can overwrite them with our own.
 630         for dso in `$(test-wrapper-env) LD_TRACE_LOADED_OBJECTS=1  \
 631                 $(rtld-prefix) \
 632                 $(objpfx)testroot.pristine/bin/sh \
 633                 | sed -n '/\//{s@.*=> /@/@;s/^[^/]*//;s/ .*//p;}'` ;\
 634           do \
 635             test -d `dirname $(objpfx)testroot.pristine$$dso` || \
 636               mkdir -p `dirname $(objpfx)testroot.pristine$$dso` ;\
 637             $(test-wrapper) cp $$dso $(objpfx)testroot.pristine$$dso ;\
 638           done
 639         for dso in `$(test-wrapper-env) LD_TRACE_LOADED_OBJECTS=1  \
 640                 $(rtld-prefix) \
 641                 $(objpfx)support/$(LINKS_DSO_PROGRAM) \
 642                 | sed -n '/\//{s@.*=> /@/@;s/^[^/]*//;s/ .*//p;}'` ;\
 643           do \
 644             test -d `dirname $(objpfx)testroot.pristine$$dso` || \
 645               mkdir -p `dirname $(objpfx)testroot.pristine$$dso` ;\
 646             $(test-wrapper) cp $$dso $(objpfx)testroot.pristine$$dso ;\
 647           done
 648 endif
 649         # $(symbolic-link-list) is a file that encodes $(DESTDIR) so we
 650         # have to purge it
 651         rm -f $(symbolic-link-list)
 652         # Setting INSTALL_UNCOMPRESSED causes localedata/Makefile to
 653         # install the charmaps uncompressed, as the testroot does not
 654         # provide a gunzip program.
 655         $(MAKE) install install_root=$(objpfx)testroot.pristine \
 656           INSTALL_UNCOMPRESSED=yes subdirs='$(sorted-subdirs)'
 657         rm -f $(symbolic-link-list)
 658         touch $(objpfx)testroot.pristine/install.stamp
 659
 660 tests-special-notdir = $(patsubst $(objpfx)%, %, $(tests-special))
 661 tests: $(tests-special)
 662         $(..)scripts/merge-test-results.sh -s $(objpfx) "" \
 663           $(sort $(tests-special-notdir:.out=)) \
 664           > $(objpfx)subdir-tests.sum
 665         $(..)scripts/merge-test-results.sh -t $(objpfx) subdir-tests.sum \
 666           $(sort $(subdirs) .) \
 667           > $(objpfx)tests.sum
 668         $(call summarize-tests,tests.sum)
 669 xtests:
 670         $(..)scripts/merge-test-results.sh -t $(objpfx) subdir-xtests.sum \
 671           $(sort $(subdirs)) \
 672           > $(objpfx)xtests.sum
 673         $(call summarize-tests,xtests.sum, for extra tests)
 674
 675 # The realclean target is just like distclean for the parent, but we want
 676 # the subdirs to know the difference in case they care.
 677 realclean distclean: parent-clean
 678 # This is done this way rather than having `subdir_distclean' be a
 679 # dependency of this target so that libc.a will be removed before the
 680 # subdirectories are dealt with and so they won't try to remove object
 681 # files from it when it's going to be removed anyway.
 682         @$(MAKE) distclean-1 no_deps=t distclean-1=$@ avoid-generated=yes \
 683                  sysdep-subdirs="$(sysdep-subdirs)"
 684         -rm -f $(postclean)
 685
 686 # Subroutine of distclean and realclean.
 687 distclean-1: subdir_$(distclean-1)
 688         -rm -f $(config-generated)
 689         -rm -f $(addprefix $(objpfx),config.status config.cache config.log)
 690         -rm -f $(addprefix $(objpfx),config.make config-name.h config.h)
 691 ifdef objdir
 692         -rm -f $(objpfx)Makefile
 693 endif
 694         -rm -f $(sysdep-$(distclean-1))
 695 \f
 696 # Make the TAGS file for Emacs users.
 697
 698 .PHONY: TAGS
 699 TAGS:
 700         scripts/list-sources.sh | sed -n -e '/Makefile/p' \
 701           $(foreach S,[chsSyl] cxx sh bash pl,\
 702                     $(subst .,\.,-e '/.$S\(.in\)*$$/p')) \
 703         | $(ETAGS) -o $@ -
 704 \f
 705 # Make the distribution tarfile.
 706 .PHONY: dist dist-prepare
 707
 708 generated := $(generated) stubs.h
 709
 710 files-for-dist := README INSTALL configure NEWS
 711
 712 # Regenerate stuff, then error if these things are not committed yet.
 713 dist-prepare: $(files-for-dist)
 714         conf=`find sysdeps -name configure`; \
 715         $(MAKE) $$conf && \
 716         git diff --stat HEAD -- $^ $$conf \
 717         | $(AWK) '{ print; rc=1 } END { exit rc }'
 718
 719 %.tar: FORCE
 720         git archive --prefix=$*/ $* > $@.new
 721         mv -f $@.new $@
 722
 723 # Do `make dist dist-version=X.Y.Z' to make tar files of an older version.
 724
 725 ifneq (,$(strip $(dist-version)))
 726 dist: $(foreach Z,.bz2 .gz .xz,$(dist-version).tar$Z)
 727         md5sum $^
 728 else
 729 dist: dist-prepare
 730         @if v=`git describe`; then \
 731           echo Distribution version $$v; \
 732           $(MAKE) dist dist-version=$$v; \
 733         else \
 734           false; \
 735         fi
 736 endif
 737
 738 INSTALL: manual/install-plain.texi manual/macros.texi \
 739          $(common-objpfx)manual/pkgvers.texi manual/install.texi
 740         makeinfo --no-validate --plaintext --no-number-sections \
 741                  -I$(common-objpfx)manual $< -o $@-tmp
 742         $(AWK) 'NF == 0 { ++n; next } \
 743                 NF != 0 { while (n-- > 0) print ""; n = 0; print }' \
 744           < $@-tmp > $@-tmp2
 745         rm -f $@-tmp
 746         -chmod a-w $@-tmp2
 747         mv -f $@-tmp2 $@
 748 $(common-objpfx)manual/%: FORCE
 749         $(MAKE) $(PARALLELMFLAGS) -C manual $@
 750 FORCE:
 751
 752 iconvdata/% localedata/% po/%: FORCE
 753         $(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)
 754
 755 # Convenience target to rerun one test, from the top of the build tree
 756 # Example: make test t=wcsmbs/test-wcsnlen
 757 .PHONY: test
 758 test :
 759         @-rm -f $(objpfx)$t.out
 760         $(MAKE) subdir=$(patsubst %/,%,$(dir $t)) -C $(dir $t) ..=../ $(objpfx)$t.out
 761         @cat $(objpfx)$t.test-result
 762         @cat $(objpfx)$t.out