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 # <https://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
193 SOURCE_DIR
="$(CURDIR)"
194 BUILD_DIR
="$(common-objpfx)"
195 CMD_FILE
="$(common-objpfx)debugglibc.gdb"
205 Usage
: $$0 [OPTIONS
] <program
>
207 Or
: $$0 [OPTIONS
] -- <program
> [<args
>]...
209 where
<program
> is the path to the program being tested
,
210 and
<args
> are the arguments to be passed to it.
215 Prints this message and leaves.
217 The following options require one argument
:
220 Breakpoints to set at the beginning of the execution
221 (each breakpoint demands its own
-b option
, e.g.
-b foo
-b bar
)
222 -e
, --environment-variable
223 Environment variables to be set with
'exec-wrapper env' in GDB
224 (each environment variable demands its own
-e option
, e.g.
225 -e FOO
=foo
-e BAR
=bar
)
227 The following options do not take arguments
:
230 Selects whether to pass the
--direct flag to the program.
231 --direct is useful when debugging glibc
test cases. It inhibits the
232 tests from forking and executing in a subprocess.
233 Default behaviour is to pass the
--direct flag
, except when the
234 program is run with user specified arguments using the
"--" separator.
235 -s
, --no-symbols-file
236 Do not tell GDB to load debug symbols from the program.
240 # Parse input options
250 BREAKPOINTS
="break $$2\n$$BREAKPOINTS"
253 -e|
--environment-variable
)
254 ENVVARS
="$$2 $$ENVVARS"
260 -s|
--no-symbols-file
)
267 # Don't add --direct when user specifies program arguments
273 COMMANDLINE
=$$TESTCASE
279 # Check for required argument
286 # Expand environment setup command
289 ENVVARSCMD
="set exec-wrapper env $$ENVVARS"
292 # Expand direct argument
293 if
[ "$$DIRECT" == true
]
300 # Expand symbols loading command
301 if
[ "$$SYMBOLSFILE" == true
]
303 SYMBOLSFILE
="add-symbol-file $${TESTCASE}"
308 # GDB commands template
312 set environment C
-E
-x c-header
313 set auto-load safe-path
$${BUILD_DIR}/nptl_db
:\
$$debugdir:\
$$datadir/auto-load
314 set libthread-db-search-path
$${BUILD_DIR}/nptl_db
318 run
--library-path
$(rpath-link
):$${BUILD_DIR}/nptl_db \
319 __COMMANDLINE__ __DIRECT__
324 # Generate the commands file for gdb initialization
326 -e
"s|__ENVVARS__|$$ENVVARSCMD|" \
327 -e
"s|__SYMBOLSFILE__|$$SYMBOLSFILE|" \
328 -e
"s|__COMMANDLINE__|$$COMMANDLINE|" \
329 -e
"s|__DIRECT__|$$DIRECT|" \
330 -e
"s|__BREAKPOINTS__|$$BREAKPOINTS|" \
334 echo
"Debugging glibc..."
335 echo
"Build directory : $$BUILD_DIR"
336 echo
"Source directory : $$SOURCE_DIR"
337 echo
"GLIBC Testcase : $$TESTCASE"
338 echo
"GDB Commands : $$CMD_FILE"
339 echo
"Env vars : $$ENVVARS"
342 # Start the test case debugging in two steps:
343 # 1. the following command invokes gdb to run the loader;
344 # 2. the commands file tells the loader to run the test case.
348 $${BUILD_DIR}/elf
/ld.so
351 # This is another handy script for debugging dynamically linked program
352 # against the current libc build for testing.
353 $(common-objpfx
)debugglibc.sh
: $(common-objpfx
)config.make \
354 $(..
)Makeconfig
$(..
)Makefile
355 $(file
>$@T
,$(debugglibc
))
358 postclean-generated
+= debugglibc.sh debugglibc.gdb
360 others
: $(common-objpfx
)testrun.sh
$(common-objpfx
)debugglibc.sh
362 # Makerules creates a file `stubs' in each subdirectory, which
363 # contains `#define __stub_FUNCTION' for each function defined in that
364 # directory which is a stub.
365 # Here we paste all of these together into <gnu/stubs.h>.
367 subdir-stubs
:= $(foreach dir,$(subdirs
),$(common-objpfx
)$(dir)/stubs
)
370 installed-stubs
= $(inst_includedir
)/gnu
/stubs.h
372 installed-stubs
= $(inst_includedir
)/gnu
/stubs-
$(default-abi
).h
374 $(inst_includedir
)/gnu
/stubs.h
: $(+force)
375 $(make-target-directory
)
377 echo
'/* This file is automatically generated.';\
378 echo
" This file selects the right generated file of \`__stub_FUNCTION' macros";\
379 echo
' based on the architecture being compiled for. */'; \
381 $(foreach h
,$(abi-includes
), echo
'#include <$(h)>';) \
383 $(foreach v
,$(abi-variants
),\
384 $(if
$(abi-
$(v
)-condition
),\
385 echo
'#if $(abi-$(v)-condition)'; \
386 echo
'# include <gnu/stubs-$(v).h>'); \
387 $(if
$(abi-
$(v
)-condition
),echo
'#endif';) \
388 rm -f
$(@
:.d
=.h
).new
$(v
); \
391 mv
-f
$(@
:.d
=.h
).new
$(@
:.d
=.h
)
393 install-others-nosubdir
: $(installed-stubs
)
397 # Since stubs.h is never needed when building the library, we simplify the
398 # hairy installation process by producing it in place only as the last part
399 # of the top-level `make install'. It depends on subdir_install, which
400 # iterates over all the subdirs; subdir_install in each subdir depends on
401 # the subdir's stubs file. Having more direct dependencies would result in
402 # extra iterations over the list for subdirs and many recursive makes.
403 $(installed-stubs
): include/stubs-prologue.h subdir_install
404 $(make-target-directory
)
405 @
rm -f
$(objpfx
)stubs.h
406 (sed
'/^@/d' $<; LC_ALL
=C
sort $(subdir-stubs
)) > $(objpfx
)stubs.h
407 if
test -r
$@
&& cmp
-s
$(objpfx
)stubs.h
$@
; \
408 then echo
'stubs.h unchanged'; \
409 else $(INSTALL_DATA
) $(objpfx
)stubs.h
$@
; fi
410 rm -f
$(objpfx
)stubs.h
412 # This makes the Info or DVI file of the documentation from the Texinfo source.
413 .PHONY
: info dvi pdf html
415 $(MAKE
) $(PARALLELMFLAGS
) -C manual
$@
417 # This makes all the subdirectory targets.
419 # For each target, make it depend on DIR/target for each subdirectory DIR.
420 $(+subdir_targets
): %: $(addsuffix /%,$(subdirs
))
422 # Compute a list of all those targets.
423 all-subdirs-targets
:= $(foreach dir,$(subdirs
),\
424 $(addprefix $(dir)/,$(+subdir_targets
)))
426 # The action for each of those is to cd into the directory and make the
428 $(all-subdirs-targets
):
429 $(MAKE
) $(PARALLELMFLAGS
) $(subdir-target-args
) $(@F
)
431 define subdir-target-args
432 subdir
=$(@D
)$(if
$($(@D
)-srcdir),\
433 -C
$($(@D
)-srcdir) ..
=`pwd`/,\
437 .PHONY
: $(+subdir_targets
) $(all-subdirs-targets
)
439 # Targets to clean things up to various degrees.
441 .PHONY
: clean realclean distclean distclean-1 parent-clean parent-mostlyclean \
444 # Subroutines of all cleaning targets.
445 parent-mostlyclean
: common-mostlyclean
# common-mostlyclean is in Makerules.
446 -rm -f
$(foreach o
,$(object-suffixes-for-libc
),\
447 $(common-objpfx
)$(patsubst %,$(libtype
$o),c
)) \
448 $(addprefix $(objpfx
),$(install-lib
))
449 parent-clean
: parent-mostlyclean common-clean
451 postclean
= $(addprefix $(common-objpfx
),$(postclean-generated
)) \
452 $(addprefix $(objpfx
),sysd-dirs sysd-rules
) \
453 $(addprefix $(objpfx
),sysd-sorted soversions.mk soversions.i
)
456 # This is done this way rather than having `subdir_clean' be a
457 # dependency of this target so that libc.a will be removed before the
458 # subdirectories are dealt with and so they won't try to remove object
459 # files from it when it's going to be removed anyway.
460 @
$(MAKE
) subdir_clean no_deps
=t
462 mostlyclean: parent-mostlyclean
463 @
$(MAKE
) subdir_mostlyclean no_deps
=t
467 @
$(MAKE
) subdir_testclean no_deps
=t
470 vpath c
++-types.data
$(+sysdep_dirs
)
472 tests-special
+= $(objpfx
)c
++-types-check.out
473 $(objpfx
)c
++-types-check.out
: c
++-types.data scripts
/check-c
++-types.sh
474 scripts
/check-c
++-types.sh
$< $(CXX
) $(filter-out -std
=gnu11
$(+gccwarn-c
),$(CFLAGS
)) $(CPPFLAGS
) > $@
; \
478 tests-special
+= $(objpfx
)check-local-headers.out
479 $(objpfx
)check-local-headers.out
: scripts
/check-local-headers.sh
480 AWK
='$(AWK)' scripts
/check-local-headers.sh \
481 "$(includedir)" "$(objpfx)" < /dev
/null
> $@
; \
484 ifneq "$(headers)" ""
485 # Special test of all the installed headers in this directory.
486 tests-special
+= $(objpfx
)check-installed-headers-c.out
487 libof-check-installed-headers-c
:= testsuite
488 $(objpfx
)check-installed-headers-c.out
: \
489 scripts
/check-installed-headers.sh
$(headers
)
490 $(SHELL
) $(..
)scripts
/check-installed-headers.sh c \
491 "$(CC) $(filter-out -std=%,$(CFLAGS)) -D_ISOMAC $(+includes)" \
496 tests-special
+= $(objpfx
)check-installed-headers-cxx.out
497 libof-check-installed-headers-cxx
:= testsuite
498 $(objpfx
)check-installed-headers-cxx.out
: \
499 scripts
/check-installed-headers.sh
$(headers
)
500 $(SHELL
) $(..
)scripts
/check-installed-headers.sh c
++ \
501 "$(CXX) $(filter-out -std=%,$(CXXFLAGS)) -D_ISOMAC $(+includes)" \
506 tests-special
+= $(objpfx
)check-wrapper-headers.out
507 $(objpfx
)check-wrapper-headers.out
: scripts
/check-wrapper-headers.py
$(headers
)
508 $(PYTHON
) $< --root
=.
--subdir
=.
$(headers
) \
509 --generated
$(common-generated
) > $@
; $(evaluate-test
)
512 define summarize-tests
513 @egrep
-v
'^(PASS|XFAIL):' $(objpfx
)$1 || true
514 @echo
"Summary of test results$2:"
515 @sed
's/:.*//' < $(objpfx
)$1 |
sort | uniq
-c
516 @
! egrep
-q
-v
'^(X?PASS|XFAIL|UNSUPPORTED):' $(objpfx
)$1
519 # The intention here is to do ONE install of our build into the
520 # testroot.pristine/ directory, then rsync (internal to
521 # support/test-container) that to testroot.root/ at the start of each
522 # test. That way we can promise each test a "clean" install, without
523 # having to do the install for each test.
525 # In addition, we have to copy some files (which we build) into this
526 # root in addition to what glibc installs. For example, many tests
527 # require additional programs including /bin/sh, /bin/true, and
528 # /bin/echo, all of which we build below to limit library dependencies
529 # to just those things in glibc and language support libraries which
530 # we also copy into the into the rootfs. To determine what language
531 # support libraries we need we build a "test" program in either C or
532 # (if available) C++ just so we can copy in any shared objects
533 # (which we do not build) that GCC-compiled programs depend on.
537 LINKS_DSO_PROGRAM
= links-dso-program-c
539 LINKS_DSO_PROGRAM
= links-dso-program
542 $(tests-container
) $(addsuffix /tests
,$(subdirs
)) : \
543 $(objpfx
)testroot.pristine
/install.stamp
544 $(objpfx
)testroot.pristine
/install.stamp
:
545 test -d
$(objpfx
)testroot.pristine || \
546 mkdir
$(objpfx
)testroot.pristine
547 # We need a working /bin/sh for some of the tests.
548 test -d
$(objpfx
)testroot.pristine
/bin || \
549 mkdir
$(objpfx
)testroot.pristine
/bin
550 cp
$(objpfx
)support
/shell-container
$(objpfx
)testroot.pristine
/bin
/sh
551 cp
$(objpfx
)support
/echo-container
$(objpfx
)testroot.pristine
/bin
/echo
552 cp
$(objpfx
)support
/true-container
$(objpfx
)testroot.pristine
/bin
/true
553 ifeq ($(run-built-tests
),yes
)
554 # Copy these DSOs first so we can overwrite them with our own.
555 for dso in
`$(test-wrapper-env) LD_TRACE_LOADED_OBJECTS=1 \
557 $(objpfx)testroot.pristine/bin/sh \
558 | grep / | sed 's/^[^/]*//' | sed 's/ .*//'` ;\
560 test -d
`dirname $(objpfx)testroot.pristine$$dso` || \
561 mkdir
-p
`dirname $(objpfx)testroot.pristine$$dso` ;\
562 $(test-wrapper
) cp
$$dso $(objpfx
)testroot.pristine
$$dso ;\
564 for dso in
`$(test-wrapper-env) LD_TRACE_LOADED_OBJECTS=1 \
566 $(objpfx)support/$(LINKS_DSO_PROGRAM) \
567 | grep / | sed 's/^[^/]*//' | sed 's/ .*//'` ;\
569 test -d
`dirname $(objpfx)testroot.pristine$$dso` || \
570 mkdir
-p
`dirname $(objpfx)testroot.pristine$$dso` ;\
571 $(test-wrapper
) cp
$$dso $(objpfx
)testroot.pristine
$$dso ;\
574 $(MAKE
) install DESTDIR
=$(objpfx
)testroot.pristine \
575 subdirs
='$(sorted-subdirs)'
576 touch
$(objpfx
)testroot.pristine
/install.stamp
578 tests-special-notdir
= $(patsubst $(objpfx
)%, %, $(tests-special
))
579 tests
: $(tests-special
)
580 $(..
)scripts
/merge-test-results.sh
-s
$(objpfx
) "" \
581 $(sort $(tests-special-notdir
:.out
=)) \
582 > $(objpfx
)subdir-tests.sum
583 $(..
)scripts
/merge-test-results.sh
-t
$(objpfx
) subdir-tests.sum \
584 $(sort $(subdirs
) .
) \
586 $(call summarize-tests
,tests.sum
)
588 $(..
)scripts
/merge-test-results.sh
-t
$(objpfx
) subdir-xtests.sum \
590 > $(objpfx
)xtests.sum
591 $(call summarize-tests
,xtests.sum
, for extra tests
)
593 # The realclean target is just like distclean for the parent, but we want
594 # the subdirs to know the difference in case they care.
595 realclean distclean: parent-clean
596 # This is done this way rather than having `subdir_distclean' be a
597 # dependency of this target so that libc.a will be removed before the
598 # subdirectories are dealt with and so they won't try to remove object
599 # files from it when it's going to be removed anyway.
600 @
$(MAKE
) distclean-1 no_deps
=t distclean-1
=$@ avoid-generated
=yes \
601 sysdep-subdirs
="$(sysdep-subdirs)"
604 # Subroutine of distclean and realclean.
605 distclean-1
: subdir_
$(distclean-1
)
606 -rm -f
$(config-generated
)
607 -rm -f
$(addprefix $(objpfx
),config.status config.cache config.log
)
608 -rm -f
$(addprefix $(objpfx
),config.make config-name.h config.h
)
610 -rm -f
$(objpfx
)Makefile
612 -rm -f
$(sysdep-
$(distclean-1
))
614 # Make the TAGS file for Emacs users.
618 scripts
/list-sources.sh | sed
-n
-e
'/Makefile/p' \
619 $(foreach S
,[chsSyl
] cxx sh bash pl
,\
620 $(subst .
,\.
,-e
'/.$S\(.in\)*$$/p')) \
623 # Make the distribution tarfile.
624 .PHONY
: dist dist-prepare
626 generated
:= $(generated
) stubs.h
628 files-for-dist
:= README INSTALL configure ChangeLog NEWS
630 # Regenerate stuff, then error if these things are not committed yet.
631 dist-prepare
: $(files-for-dist
)
632 conf
=`find sysdeps -name configure`; \
634 git diff
--stat HEAD
-- $^
$$conf \
635 |
$(AWK
) '{ print; rc=1 } END { exit rc }'
638 git archive
--prefix=$*/ $* > $@.new
641 # Do `make dist dist-version=X.Y.Z' to make tar files of an older version.
643 ifneq (,$(strip $(dist-version
)))
644 dist: $(foreach Z
,.bz2 .gz .xz
,$(dist-version
).
tar$Z)
648 @if v
=`git describe`; then \
649 echo Distribution version
$$v; \
650 $(MAKE
) dist dist-version
=$$v; \
656 INSTALL
: manual
/install-plain.texi manual
/macros.texi \
657 $(common-objpfx
)manual
/pkgvers.texi manual
/install.texi
658 makeinfo --no-validate
--plaintext
--no-number-sections \
659 -I
$(common-objpfx
)manual
$< -o
$@
-tmp
660 $(AWK
) 'NF == 0 { ++n; next } \
661 NF != 0 { while (n-- > 0) print ""; n = 0; print }' \
666 $(common-objpfx
)manual
/%: FORCE
667 $(MAKE
) $(PARALLELMFLAGS
) -C manual
$@
670 iconvdata
/% localedata
/% po
/%: FORCE
671 $(MAKE
) $(PARALLELMFLAGS
) -C
$(@D
) $(@F
)