1 # Copyright (C) 1991-2017 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 # Makefile configuration options for the GNU C library.
22 This makefile requires GNU Make.
25 all: # Make this the default goal
27 ifneq "$(origin +included-Makeconfig)" "file"
29 +included-Makeconfig := yes
35 # $(common-objdir) is the place to put objects and
36 # such that are not specific to a single subdir.
38 objpfx := $(patsubst %//,%/,$(objdir)/$(subdir)/)
39 common-objpfx = $(objdir)/
40 common-objdir = $(objdir)
42 objdir must be defined by the build-directory Makefile.
45 # Root of the sysdeps tree.
46 sysdep_dir := $(..)sysdeps
47 export sysdep_dir := $(sysdep_dir)
49 # Get the values defined by options to `configure'.
50 include $(common-objpfx)config.make
52 # What flags to give to sources which call user provided callbacks
53 uses-callbacks = -fexceptions
55 # What flags to give to tests which test stack alignment
56 stack-align-test-flags =
58 # Complete path to sysdep dirs.
59 # `configure' writes a definition of `config-sysdirs' in `config.make'.
60 sysdirs := $(foreach D,$(config-sysdirs),$(firstword $(filter /%,$D) $(..)$D))
62 # Add-ons that contribute sysdeps trees get added to the include list
63 # after sysdeps/generic. This makes #include <sysdeps/...> work right
64 # to find specific add-on files without assuming the add-on directory name.
65 # It also means that headers can go into an add-on's base directory
66 # instead of the add-on needing a sysdeps/generic of its own.
67 sysdeps-srcdirs := $(foreach add-on,$(sysdeps-add-ons),\
68 $(firstword $(filter /%,$(add-on)) \
70 +sysdep_dirs = $(sysdirs) $(sysdeps-srcdirs)
72 +sysdep_dirs := $(objdir) $(+sysdep_dirs)
75 # Run config.status to update config.make and config.h. We don't show the
76 # dependence of config.h to Make, because it is only touched when it
77 # changes and so config.status would be run every time; the dependence of
78 # config.make should suffice to force regeneration and re-exec, and the new
79 # image will notice if config.h changed.
80 $(common-objpfx)config.make: $(common-objpfx)config.status \
81 $(..)config.make.in $(..)config.h.in
82 cd $(<D); $(SHELL) $(<F)
84 # Find all the add-on and sysdeps configure fragments, to make sure we
85 # re-run configure when any of them changes.
86 $(common-objpfx)config.status: $(..)version.h $(..)configure \
87 $(foreach dir,$(sysdirs),\
88 $(wildcard $(dir)/Implies) \
90 $(firstword $(wildcard \
91 $(addprefix $(dir)/,configure configure.ac))))) \
93 $(wildcard $(..)sysdeps/*/preconfigure $(..)sysdeps/*/preconfigure.ac)) \
95 $(foreach add-on,$(add-ons),\
96 $(firstword $(wildcard \
97 $(addprefix $(firstword $(filter /%,$(add-on)) $(..)$(add-on))/,\
98 configure configure.ac))) \
99 $(wildcard $(addprefix $(firstword $(filter /%,$(add-on)) $(..)$(add-on))/,\
100 sysdeps/*/preconfigure sysdeps/*/preconfigure.ac))))
101 @cd $(@D); if test -f $(@F); then exec $(SHELL) $(@F) --recheck; else \
102 echo The GNU C library has not been configured. >&2; \
103 echo Run \`configure\' to configure it before building. >&2; \
104 echo Try \`configure --help\' for more details. >&2; \
107 # We don't want CPPFLAGS to be exported to the command running configure.
110 # Get the user's configuration parameters.
111 ifneq ($(wildcard $(..)configparms),)
112 include $(..)configparms
115 ifneq ($(wildcard $(common-objpfx)configparms),)
116 include $(common-objpfx)configparms
121 #### These are the configuration variables. You can define values for
122 #### the variables below in the file `configparms'.
123 #### Do NOT edit this file.
127 # Common prefix for machine-independent installation directories.
128 ifeq ($(origin prefix),undefined) # ifndef would override explicit empty value.
132 # Decide whether we shall build the programs or not. We always do this
133 # unless the user tells us (in configparms) or we are building for a
135 ifndef build-programs
136 ifneq ($(config-os),none)
143 # Common prefix for machine-dependent installation directories.
144 ifeq ($(origin exec_prefix),undefined)
145 exec_prefix = $(prefix)
148 # Where to install the library and object files.
150 libdir = $(exec_prefix)/lib
152 inst_libdir = $(install_root)$(libdir)
154 # Where to install the shared library.
156 slibdir = $(exec_prefix)/lib
158 inst_slibdir = $(install_root)$(slibdir)
160 # Where to install the dynamic linker.
164 inst_rtlddir = $(install_root)$(rtlddir)
166 # Prefix to put on files installed in $(libdir). For libraries `libNAME.a',
167 # the prefix is spliced between `lib' and the name, so the linker switch
168 # `-l$(libprefix)NAME' finds the library; for other files the prefix is
169 # just prepended to the whole file name.
170 ifeq ($(origin libprefix),undefined)
174 # Where to install the header files.
176 includedir = $(prefix)/include
178 inst_includedir = $(install_root)$(includedir)
180 # Where to install machine-independent data files.
181 # These are the timezone database, and the locale database.
183 datadir = $(prefix)/share
185 inst_datadir = $(install_root)$(datadir)
187 # Where to install the timezone data files (which are machine-independent).
189 zonedir = $(datadir)/zoneinfo
191 inst_zonedir = $(install_root)$(zonedir)
193 # Where to install the compiled binary locale archive and compiled
194 # binary locale files.
196 complocaledir = $(libdir)/locale
198 inst_complocaledir = $(install_root)$(complocaledir)
200 # Where to install the message catalog data files (which are
201 # machine-independent).
203 localedir = $(datadir)/locale
205 inst_localedir = $(install_root)$(localedir)
207 # Where to install the locale charmap source files.
209 i18ndir = $(datadir)/i18n
211 inst_i18ndir = $(install_root)$(i18ndir)
213 # Where to install the shared object for charset transformation.
215 gconvdir = $(libdir)/gconv
217 inst_gconvdir = $(install_root)$(gconvdir)
219 # Where to install programs.
221 bindir = $(exec_prefix)/bin
223 inst_bindir = $(install_root)$(bindir)
225 # Where to install internal programs.
227 libexecdir = $(exec_prefix)/libexec
229 inst_libexecdir = $(install_root)$(libexecdir)
231 # Where to install administrative programs.
233 rootsbindir = $(exec_prefix)/sbin
235 inst_rootsbindir = $(install_root)$(rootsbindir)
238 sbindir = $(exec_prefix)/sbin
240 inst_sbindir = $(install_root)$(sbindir)
242 # Where to install the Info files.
244 infodir = $(prefix)/info
246 inst_infodir = $(install_root)$(infodir)
248 # Where to install audit libraries.
250 auditdir = $(libdir)/audit
252 inst_auditdir = $(install_root)$(auditdir)
254 # Where to install default configuration files. These include the local
255 # timezone specification and network data base files.
257 sysconfdir = $(prefix)/etc
259 inst_sysconfdir = $(install_root)$(sysconfdir)
261 # Directory for the database files and Makefile for nss_db.
263 vardbdir = $(localstatedir)/db
265 inst_vardbdir = $(install_root)$(vardbdir)
267 # Where to install the "localtime" timezone file; this is the file whose
268 # contents $(localtime) specifies. If this is a relative pathname, it is
269 # relative to $(zonedir). It is a good idea to put this somewhere
270 # other than there, so the zoneinfo directory contains only universal data,
271 # localizing the configuration data elsewhere.
272 ifndef localtime-file
273 localtime-file = $(sysconfdir)/localtime
276 # What to use for leap second specifications in compiling the default
277 # timezone files. Set this to `/dev/null' for no leap second handling as
278 # 1003.1 requires, or to `leapseconds' for proper leap second handling.
279 # Both zone flavors are always available as `posix/ZONE' and `right/ZONE'.
280 # This variable determines the default: if it's `/dev/null',
281 # ZONE==posix/ZONE; if it's `leapseconds', ZONE==right/ZONE.
283 leapseconds = /dev/null
286 # What timezone's DST rules should be used when a POSIX-style TZ
287 # environment variable doesn't specify any rules. For 1003.1 compliance
288 # this timezone must use rules that are as U.S. federal law defines DST.
289 # Run `make -C time echo-zonenames' to see a list of available zone names.
290 # This setting can be changed with `zic -p TIMEZONE' at any time.
291 # If you want POSIX.1 compatibility, use `America/New_York'.
293 posixrules = America/New_York
296 # Where to install the "posixrules" timezone file; this is file
297 # whose contents $(posixrules) specifies. If this is a relative
298 # pathname, it is relative to $(zonedir).
299 ifndef posixrules-file
300 posixrules-file = posixrules
304 # Directory where your system's native header files live.
305 # This is used on Unix systems to generate some GNU libc header files.
307 sysincludedir = /usr/include
311 # Commands to install files.
313 INSTALL_DATA = $(INSTALL) -m 644
315 ifndef INSTALL_SCRIPT
316 INSTALL_SCRIPT = $(INSTALL)
318 ifndef INSTALL_PROGRAM
319 INSTALL_PROGRAM = $(INSTALL)
326 # The name of the C compiler.
327 # If you've got GCC, and it works, use it.
328 ifeq ($(origin CC),default)
332 # The name of the C compiler to use for compilations of programs to run on
333 # the host that is building the library. If you set CC to a
334 # cross-compiler, you must set this to the normal compiler.
339 # Default flags to pass the C compiler.
340 ifndef default_cflags
341 ifeq ($(release),stable)
342 default_cflags := -g -O2
344 default_cflags := -g -O
348 # Flags to pass the C compiler when assembling preprocessed assembly code
354 as-needed := -Wl,--as-needed
355 no-as-needed := -Wl,--no-as-needed
357 # Must be supported by the linker.
358 no-whole-archive = -Wl,--no-whole-archive
359 whole-archive = -Wl,--whole-archive
361 # Installed name of the startup code.
362 # The ELF convention is that the startfile is called crt1.o
363 start-installed-name = crt1.o
364 # On systems that do not need a special startfile for statically linked
365 # binaries, simply set it to the normal name.
366 ifndef static-start-installed-name
367 static-start-installed-name = $(start-installed-name)
370 ifeq (yesyes,$(build-shared)$(have-z-combreloc))
371 combreloc-LDFLAGS = -Wl,-z,combreloc
372 LDFLAGS.so += $(combreloc-LDFLAGS)
373 LDFLAGS-rtld += $(combreloc-LDFLAGS)
376 relro-LDFLAGS = -Wl,-z,relro
377 LDFLAGS.so += $(relro-LDFLAGS)
378 LDFLAGS-rtld += $(relro-LDFLAGS)
380 ifeq (yes,$(have-hash-style))
381 # For the time being we unconditionally use 'both'. At some time we
382 # should declare statically linked code as 'out of luck' and compile
383 # with --hash-style=gnu only.
384 hashstyle-LDFLAGS = -Wl,--hash-style=both
385 LDFLAGS.so += $(hashstyle-LDFLAGS)
386 LDFLAGS-rtld += $(hashstyle-LDFLAGS)
389 # If lazy relocations are disabled, add the -z now flag. Use
390 # LDFLAGS-lib.so instead of LDFLAGS.so, to avoid adding the flag to
392 ifeq ($(bind-now),yes)
393 LDFLAGS-lib.so += -Wl,-z,now
396 # Command to run after every final link (executable or shared object).
397 # This is invoked with $(call after-link,...), so it should operate on
398 # the file $1. This can be set to do some sort of post-processing on
399 # binaries, or to perform some sort of static sanity check.
404 # Additional libraries to link into every test.
405 link-extra-libs-tests = $(libsupport)
407 # Command for linking PIE programs with the C library.
409 +link-pie-before-libc = $(CC) -pie -Wl,-O1 -nostdlib -nostartfiles -o $@ \
410 $(sysdep-LDFLAGS) $(LDFLAGS) $(LDFLAGS-$(@F)) \
411 $(combreloc-LDFLAGS) $(relro-LDFLAGS) $(hashstyle-LDFLAGS) \
412 $(addprefix $(csu-objpfx),S$(start-installed-name)) \
413 $(+preinit) $(+prectorS) \
414 $(filter-out $(addprefix $(csu-objpfx),start.o \
415 S$(start-installed-name))\
416 $(+preinit) $(link-extra-libs) \
417 $(common-objpfx)libc% $(+postinit),$^) \
419 +link-pie-after-libc = $(+postctorS) $(+postinit)
421 $(+link-pie-before-libc) $(rtld-LDFLAGS) $(link-libc) $(+link-pie-after-libc)
422 $(call after-link,$@)
424 define +link-pie-tests
425 $(+link-pie-before-libc) $(rtld-tests-LDFLAGS) $(link-libc-tests) \
426 $(+link-pie-after-libc)
427 $(call after-link,$@)
429 define +link-pie-printers-tests
430 $(+link-pie-before-libc) $(built-rtld-LDFLAGS) $(link-libc-printers-tests) \
431 $(+link-pie-after-libc)
432 $(call after-link,$@)
435 # Command for statically linking programs with the C library.
437 +link-static-before-libc = $(CC) -nostdlib -nostartfiles -static -o $@ \
438 $(sysdep-LDFLAGS) $(LDFLAGS) $(LDFLAGS-$(@F)) \
439 $(addprefix $(csu-objpfx),$(static-start-installed-name)) \
440 $(+preinit) $(+prectorT) \
441 $(filter-out $(addprefix $(csu-objpfx),start.o \
442 $(start-installed-name))\
443 $(+preinit) $(link-extra-libs-static) \
444 $(common-objpfx)libc% $(+postinit),$^) \
445 $(link-extra-libs-static)
446 +link-static-after-libc = $(+postctorT) $(+postinit)
448 $(+link-static-before-libc) $(link-libc-static) $(+link-static-after-libc)
449 $(call after-link,$@)
451 define +link-static-tests
452 $(+link-static-before-libc) $(link-libc-static-tests) $(+link-static-after-libc)
453 $(call after-link,$@)
456 # Commands for linking programs with the C library.
458 ifeq (yes,$(build-shared))
459 ifeq (yes,$(build-pie-default))
460 no-pie-ldflag = -no-pie
462 +link-tests = $(+link-pie-tests)
463 +link-printers-tests = $(+link-pie-printers-tests)
464 else # not build-pie-default
465 +link-before-libc = $(CC) -nostdlib -nostartfiles -o $@ \
466 $(sysdep-LDFLAGS) $(LDFLAGS) $(LDFLAGS-$(@F)) \
467 $(combreloc-LDFLAGS) $(relro-LDFLAGS) $(hashstyle-LDFLAGS) \
468 $(addprefix $(csu-objpfx),$(start-installed-name)) \
469 $(+preinit) $(+prector) \
470 $(filter-out $(addprefix $(csu-objpfx),start.o \
471 $(start-installed-name))\
472 $(+preinit) $(link-extra-libs) \
473 $(common-objpfx)libc% $(+postinit),$^) \
475 +link-after-libc = $(+postctor) $(+postinit)
477 $(+link-before-libc) $(rtld-LDFLAGS) $(link-libc) $(+link-after-libc)
478 $(call after-link,$@)
481 $(+link-before-libc) $(rtld-tests-LDFLAGS) $(link-libc-tests) \
483 $(call after-link,$@)
485 define +link-printers-tests
486 $(+link-before-libc) $(built-rtld-LDFLAGS) $(link-libc-printers-tests) \
488 $(call after-link,$@)
490 endif # build-pie-default
492 +link = $(+link-static)
493 +link-tests = $(+link-static-tests)
494 +link-printers-tests = $(+link-static-tests)
498 # The pretty printer test programs need to be compiled without optimizations
499 # so they won't confuse gdb. We could use either the 'GCC optimize' pragma
500 # or the 'optimize' function attribute to achieve this; however, at least on
501 # ARM, gcc always produces different debugging symbols when invoked with
502 # a -O greater than 0 than when invoked with -O0, regardless of anything else
503 # we're using to suppress optimizations. Therefore, we need to explicitly pass
504 # -O0 to it through CFLAGS.
505 # Additionally, the build system will try to -include $(common-objpfx)/config.h
506 # when compiling the tests, which will throw an error if some special macros
507 # (such as __OPTIMIZE__ and IS_IN_build) aren't defined. To avoid this, we
508 # tell gcc to define IS_IN_build.
509 CFLAGS-printers-tests := -O0 -ggdb3 -DIS_IN_build
511 ifeq (yes,$(build-shared))
512 # These indicate whether to link using the built ld.so or the installed one.
513 installed-rtld-LDFLAGS = -Wl,-dynamic-linker=$(rtlddir)/$(rtld-installed-name)
514 built-rtld-LDFLAGS = -Wl,-dynamic-linker=$(elf-objpfx)ld.so
517 rtld-LDFLAGS = $(installed-rtld-LDFLAGS)
520 ifndef rtld-tests-LDFLAGS
521 ifeq (yes,$(build-hardcoded-path-in-tests))
522 rtld-tests-LDFLAGS = $(built-rtld-LDFLAGS)
524 rtld-tests-LDFLAGS = $(installed-rtld-LDFLAGS)
525 endif # build-hardcoded-path-in-tests
526 endif # rtld-tests-LDFLAGS
531 ifeq (yes,$(build-shared))
532 # We need the versioned name of libc.so in the deps of $(others) et al
533 # so that the symlink to libc.so is created before anything tries to
534 # run the linked programs.
535 link-libc-rpath = -Wl,-rpath=$(rpath-link)
536 link-libc-rpath-link = -Wl,-rpath-link=$(rpath-link)
538 ifeq (yes,$(build-hardcoded-path-in-tests))
539 link-libc-tests-rpath-link = $(link-libc-rpath)
541 link-libc-tests-rpath-link = $(link-libc-rpath-link)
542 endif # build-hardcoded-path-in-tests
544 link-libc-before-gnulib = $(common-objpfx)libc.so$(libc.so-version) \
545 $(common-objpfx)$(patsubst %,$(libtype.oS),c) \
546 $(as-needed) $(elf-objpfx)ld.so \
548 link-libc = $(link-libc-rpath-link) $(link-libc-before-gnulib) $(gnulib)
550 link-libc-tests-after-rpath-link = $(link-libc-before-gnulib) $(gnulib-tests)
551 link-libc-tests = $(link-libc-tests-rpath-link) \
552 $(link-libc-tests-after-rpath-link)
553 # Pretty printer test programs always require rpath instead of rpath-link.
554 link-libc-printers-tests = $(link-libc-rpath) \
555 $(link-libc-tests-after-rpath-link)
557 # This is how to find at build-time things that will be installed there.
558 rpath-dirs = math elf dlfcn nss nis rt resolv crypt mathvec support
560 $(common-objdir):$(subst $(empty) ,:,$(patsubst ../$(subdir),.,$(rpath-dirs:%=$(common-objpfx)%)))
562 link-libc = $(common-objpfx)libc.a $(otherlibs) $(gnulib) $(common-objpfx)libc.a $(gnulib)
563 link-libc-tests = $(common-objpfx)libc.a $(otherlibs) $(gnulib-tests) $(common-objpfx)libc.a $(gnulib-tests)
567 # Differences in the linkers on the various platforms.
568 LDFLAGS-rpath-ORIGIN = -Wl,-rpath,'$$ORIGIN'
569 LDFLAGS-soname-fname = -Wl,-soname,$(@F)
570 LDFLAGS-rdynamic = -rdynamic
571 LDFLAGS-Bsymbolic = -Bsymbolic
573 # Choose the default search path for the dynamic linker based on
574 # where we will install libraries.
575 ifneq ($(libdir),$(slibdir))
576 default-rpath = $(slibdir):$(libdir)
578 default-rpath = $(libdir)
581 ifndef link-extra-libs
582 link-extra-libs = $(LDLIBS-$(@F))
583 link-extra-libs-static = $(link-extra-libs)
586 # The static libraries.
587 link-libc-static = -Wl,--start-group $(common-objpfx)libc.a $(static-gnulib) -Wl,--end-group
588 link-libc-static-tests = -Wl,--start-group $(common-objpfx)libc.a $(static-gnulib-tests) -Wl,--end-group
590 # How to link against libgcc. Some libgcc functions, such as those
591 # for "long long" arithmetic or software floating point, can always be
592 # built without use of C library headers and do not have any global
593 # state so can safely be linked statically into any executable or
594 # shared library requiring them; these functions are in libgcc.a.
595 # Other functions, relating to exception handling, may require C
596 # library headers to build and it may not be safe to have more than
597 # one copy of them in a process; these functions are only in
598 # libgcc_s.so and libgcc_eh.a.
600 # To avoid circular dependencies when bootstrapping, it is desirable
601 # to avoid use of libgcc_s and libgcc_eh in building glibc. Where any
602 # glibc functionality (in particular, thread cancellation) requires
603 # exception handling, this is implemented through dlopen of libgcc_s
604 # to avoid unnecessary dependencies on libgcc_s by programs not using
605 # that functionality; executables built with glibc do not use
606 # exception handling other than through thread cancellation.
608 # Undefined references to functions from libgcc_eh or libgcc_s may
609 # arise for code built with -fexceptions. In the case of statically
610 # linked programs installed by glibc, unwinding will never actually
611 # occur at runtime and the use of elf/static-stubs.c to resolve these
612 # references is safe. In the case of statically linked test programs
613 # and test programs built with -fexceptions, unwinding may occur in
614 # some cases and it is preferable to link with libgcc_eh or libgcc_s
615 # so that the testing is as similar as possible to how programs will
616 # be built with the installed glibc.
618 # Some architectures have architecture-specific systems for exception
619 # handling that may involve undefined references to
620 # architecture-specific functions. On those architectures,
621 # gnulib-arch and static-gnulib-arch may be defined in sysdeps
622 # makefiles to use additional libraries for linking executables and
623 # shared libraries built by glibc.
625 ifneq ($(have-cc-with-libunwind),yes)
630 libgcc_eh := -Wl,--as-needed -lgcc_s $(libunwind) -Wl,--no-as-needed
632 gnulib = -lgcc $(gnulib-arch)
633 gnulib-tests := -lgcc $(libgcc_eh)
635 # By default, elf/static-stubs.o, instead of -lgcc_eh, is used to
636 # statically link programs. When --disable-shared is used, we use
637 # -lgcc_eh since elf/static-stubs.o isn't sufficient.
638 ifeq (yes,$(build-shared))
639 static-gnulib = -lgcc $(static-gnulib-arch)
641 static-gnulib = -lgcc -lgcc_eh $(static-gnulib-arch)
643 static-gnulib-tests := -lgcc -lgcc_eh $(libunwind)
644 libc.so-gnulib := -lgcc
646 +preinit = $(addprefix $(csu-objpfx),crti.o)
647 +postinit = $(addprefix $(csu-objpfx),crtn.o)
648 +prector = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtbegin.o`
649 +postctor = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtend.o`
650 # Variants of the two previous definitions for linking PIE programs.
651 +prectorS = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtbeginS.o`
652 +postctorS = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtendS.o`
653 # Variants of the two previous definitions for statically linking programs.
654 +prectorT = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtbeginT.o`
655 +postctorT = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtend.o`
656 csu-objpfx = $(common-objpfx)csu/
657 elf-objpfx = $(common-objpfx)elf/
659 # A command that, prepended to the name and arguments of a program,
660 # and run on the build system, causes that program with those
661 # arguments to be run on the host for which the library is built.
665 # Likewise, but the name of the program is preceded by
666 # <variable>=<value> assignments for environment variables.
667 ifndef test-wrapper-env
668 test-wrapper-env = $(test-wrapper) env
670 # Likewise, but the program's environment will be empty except for any
671 # explicit <variable>=<value> assignments preceding the program name.
672 ifndef test-wrapper-env-only
673 test-wrapper-env-only = $(test-wrapper) env -i
676 # Whether to run test programs built for the library's host system.
677 ifndef run-built-tests
678 ifeq (yes|,$(cross-compiling)|$(test-wrapper))
681 run-built-tests = yes
685 # Whether to stop immediately when a test fails. Nonempty means to
686 # stop, empty means not to stop.
687 ifndef stop-on-test-failure
688 stop-on-test-failure =
691 # How to run a program we just linked with our library.
692 # The program binary is assumed to be $(word 2,$^).
693 built-program-file = $(dir $(word 2,$^))$(notdir $(word 2,$^))
694 rtld-prefix = $(elf-objpfx)$(rtld-installed-name) \
696 $(rpath-link)$(patsubst %,:%,$(sysdep-library-path))
697 ifeq (yes,$(build-shared))
699 sysdep-library-path = \
700 $(subst $(empty) ,:,$(strip $(patsubst -Wl$(comma)-rpath-link=%, %,\
701 $(filter -Wl$(comma)-rpath-link=%,\
702 $(sysdep-LDFLAGS)))))
703 # $(run-via-rtld-prefix) is a command that, when prepended to the name
704 # of a program built with the newly built library, produces a command
705 # that, executed on the host for which the library is built, runs that
706 # program. For tests listed in tests-static or xtests-static, it is
708 run-via-rtld-prefix = \
709 $(if $(strip $(filter $(notdir $(built-program-file)), \
710 $(tests-static) $(xtests-static))),, $(rtld-prefix))
712 run-via-rtld-prefix =
714 # $(run-program-env) is the default environment variable settings to
715 # use when running a program built with the newly built library.
716 run-program-env = GCONV_PATH=$(common-objpfx)iconvdata \
717 LOCPATH=$(common-objpfx)localedata LC_ALL=C
718 # $(run-program-prefix) is a command that, when prepended to the name
719 # of a program built with the newly built library, produces a command
720 # that, executed on the build system on which "make" is run, runs that
721 # program. $(run-program-prefix-before-env) and
722 # $(run-program-prefix-after-env) are similar, but separate parts
723 # before and after a list of environment variables.
724 run-program-prefix-before-env = $(test-wrapper-env)
725 run-program-prefix-after-env = $(run-via-rtld-prefix)
726 run-program-prefix = $(run-program-prefix-before-env) $(run-program-env) \
727 $(run-program-prefix-after-env)
728 # $(built-program-cmd) is a command that, executed on the build system
729 # on which "make" is run, runs the newly built program that is the
730 # second dependency of the makefile target in which
731 # $(built-program-cmd) is used. $(built-program-cmd-before-env) and
732 # $(built-program-cmd-after-env) are similar, before and after a list
733 # of environment variables.
734 built-program-cmd-before-env = $(test-wrapper-env)
735 built-program-cmd-after-env = $(run-via-rtld-prefix) $(built-program-file)
736 built-program-cmd = $(built-program-cmd-before-env) $(run-program-env) \
737 $(built-program-cmd-after-env)
738 # $(host-built-program-cmd) is a command that, executed on the host
739 # for which the library is built, runs the newly built program that is
740 # the second dependency of the makefile target in which
741 # $(host-built-program-cmd) is used.
742 host-built-program-cmd = $(run-via-rtld-prefix) $(built-program-file)
748 # $(test-via-rtld-prefix) is a command that, when prepended to the name
749 # of a test program built with the newly built library, produces a command
750 # that, executed on the host for which the library is built, runs that
751 # program. For tests listed in tests-static or xtests-static as well
752 # as when test programs are hardcoded to the newly built libraries, it
755 # $(test-program-prefix) is a command that, when prepended to the name
756 # of a test program built with the newly built library, produces a command
757 # that, executed on the build system on which "make" is run, runs that
758 # test program. $(test-program-prefix-before-env) and
759 # $(test-program-prefix-after-env) are similar, before and after a
760 # list of environment variables.
762 # $(test-program-cmd) is a command that, executed on the build system
763 # on which "make" is run, runs the newly built test program that is the
764 # second dependency of the makefile target in which
765 # $(test-program-cmd) is used. $(test-program-cmd-before-env) and
766 # $(test-program-cmd-after-env) are similar, before and after a list
767 # of environment variables.
769 # $(host-test-program-cmd) is a command that, executed on the host
770 # for which the library is built, runs the newly built test program that
771 # is the second dependency of the makefile target in which
772 # $(host-test-program-cmd) is used.
774 ifeq (yes,$(build-hardcoded-path-in-tests))
775 test-via-rtld-prefix =
776 test-program-prefix-before-env = $(test-wrapper-env)
777 test-program-prefix-after-env =
778 test-program-prefix = $(test-program-prefix-before-env) $(run-program-env) \
779 $(test-program-prefix-after-env)
780 test-program-cmd-before-env = $(test-wrapper-env)
781 test-program-cmd-after-env = $(built-program-file)
782 test-program-cmd = $(test-program-cmd-before-env) $(run-program-env) \
783 $(test-program-cmd-after-env)
784 host-test-program-cmd = $(built-program-file)
786 test-via-rtld-prefix = $(run-via-rtld-prefix)
787 test-program-prefix-before-env = $(run-program-prefix-before-env)
788 test-program-prefix-after-env = $(run-program-prefix-after-env)
789 test-program-prefix = $(run-program-prefix)
790 test-program-cmd-before-env = $(built-program-cmd-before-env)
791 test-program-cmd-after-env = $(built-program-cmd-after-env)
792 test-program-cmd = $(built-program-cmd)
793 host-test-program-cmd = $(host-built-program-cmd)
796 # Extra flags to pass to GCC.
797 ifeq ($(all-warnings),yes)
798 +gccwarn := -Wall -Wwrite-strings -Wcast-qual -Wbad-function-cast -Wmissing-noreturn -Wmissing-prototypes -Wmissing-declarations -Wcomment -Wcomments -Wtrigraphs -Wsign-compare -Wfloat-equal -Wmultichar
800 +gccwarn := -Wall -Wwrite-strings
803 ifeq ($(enable-werror),yes)
806 +gccwarn-c = -Wstrict-prototypes -Wold-style-definition
808 # We do not depend on the address of constants in different files to be
809 # actually different, so allow the compiler to merge them all.
810 +merge-constants = -fmerge-all-constants
812 # We have to assume that glibc functions are called in any rounding
813 # mode and also change the rounding mode in a few functions. So,
814 # disable any optimization that assume default rounding mode.
815 +math-flags = -frounding-math
817 # We might want to compile with some stack-protection flag.
818 ifneq ($(stack-protector),)
819 +stack-protector=$(stack-protector)
822 # This is the program that generates makefile dependencies from C source files.
823 # The -MP flag tells GCC >= 3.2 (which we now require) to produce dummy
824 # targets for headers so that removed headers don't break the build.
826 +mkdep = $(CC) -M -MP
829 # The program that makes Emacs-style TAGS files.
832 # The `xgettext' program for producing .pot files from sources.
837 # The `m4' macro processor; this is used by sysdeps/sparc/Makefile (and
838 # perhaps others) to preprocess assembly code in some cases.
841 # To force installation of files even if they are older than the
842 # installed files. This variable is included in the dependency list
843 # of all installation targets.
844 ifeq ($(force-install),yes)
845 +force = force-install
851 #### End of configuration variables.
854 # This tells some versions of GNU make before 3.63 not to export all variables.
857 # We want to echo the commands we're running without
858 # umpteen zillion filenames along with it (we use `...' instead)
859 # but we don't want this echoing done when the user has said
860 # he doesn't want to see commands echoed by using -s.
861 ifneq "$(findstring s,$(MAKEFLAGS))" "" # if -s
862 +cmdecho := echo >/dev/null
867 # These are the flags given to the compiler to tell
868 # it what sort of optimization and/or debugging output to do.
870 # If `CFLAGS' was defined, use that.
872 +cflags := $(filter-out -I%,$(CFLAGS))
876 # If none of the above worked, default to "-g -O".
877 ifeq "$(strip $(+cflags))" ""
878 +cflags := $(default_cflags)
879 endif # $(+cflags) == ""
881 +cflags += $(cflags-cpu) $(+gccwarn) $(+merge-constants) $(+math-flags) \
885 # Don't duplicate options if we inherited variables from the parent.
886 +cflags := $(sort $(+cflags))
888 # Each sysdeps directory can contain header files that both will be
889 # used to compile and will be installed. Each can also contain an
890 # include/ subdirectory, whose header files will be used to compile
891 # but will not be installed, and will take precedence over the
892 # installed files. This mirrors the top-level include/ subdirectory.
893 +sysdep-includes := $(foreach dir,$(+sysdep_dirs),\
894 $(addprefix -I,$(wildcard $(dir)/include) $(dir)))
896 # These are flags given to the C compiler to tell it to look for
897 # include files (including ones given in angle brackets) in the parent
898 # library source directory, in the include directory, and in the
900 +includes = -I$(..)include $(if $(subdir),$(objpfx:%/=-I%)) \
901 $(+sysdep-includes) $(includes) \
902 $(patsubst %/,-I%,$(..)) $(libio-include) -I. $(sysincludes)
904 # Since libio has several internal header files, we use a -I instead
905 # of many little headers in the include directory.
906 libio-include = -I$(..)libio
908 # List of non-library modules that we build.
909 built-modules = iconvprogs iconvdata ldconfig lddlibc4 libmemusage \
910 libSegFault libpcprofile librpcsvc locale-programs \
911 memusagestat nonlib nscd extramodules libnldbl libsupport
913 in-module = $(subst -,_,$(firstword $(libof-$(basename $(@F))) \
918 # Build ld.so, libc.so and libpthread.so with -ftls-model=initial-exec
919 tls-model = $(if $(filter libpthread rtld \
920 libc,$(in-module)),-ftls-model=initial-exec,)
922 module-cppflags-real = -include $(common-objpfx)libc-modules.h \
923 -DMODULE_NAME=$(in-module)
925 # We don't need libc-modules.h and the MODULE_NAME definition for .v.i
926 # files. These targets don't (and will likely never need to) use the IS_IN
927 # facility. In fact, shlib-versions should not use it because that will
928 # create a circular dependency as libc-modules.h is generated from
930 module-cppflags = $(if $(filter %.v.i,$(@F)),,$(module-cppflags-real))
932 # These are the variables that the implicit compilation rules use.
933 # Note that we can't use -std=* in CPPFLAGS, because it overrides
934 # the implicit -lang-asm and breaks cpp behavior for .S files--notably
935 # it causes cpp to stop predefining __ASSEMBLER__.
936 CPPFLAGS = $(config-extra-cppflags) $(CPPUNDEFS) $(CPPFLAGS-config) \
937 $($(subdir)-CPPFLAGS) \
938 $(+includes) $(defines) $(module-cppflags) \
939 -include $(..)include/libc-symbols.h $(sysdep-CPPFLAGS) \
940 $(CPPFLAGS-$(suffix $@)) \
941 $(foreach lib,$(libof-$(basename $(@F))) \
942 $(libof-$(<F)) $(libof-$(@F)),$(CPPFLAGS-$(lib))) \
943 $(CPPFLAGS-$(<F)) $(CPPFLAGS-$(@F)) $(CPPFLAGS-$(basename $(@F)))
945 ifneq (no,$(have-tunables))
946 CPPFLAGS += -DTOP_NAMESPACE=glibc
949 override CFLAGS = -std=gnu11 -fgnu89-inline $(config-extra-cflags) \
950 $(filter-out %frame-pointer,$(+cflags)) $(+gccwarn-c) \
951 $(sysdep-CFLAGS) $(CFLAGS-$(suffix $@)) $(CFLAGS-$(<F)) \
952 $(CFLAGS-$(@F)) $(tls-model) \
953 $(foreach lib,$(libof-$(basename $(@F))) \
954 $(libof-$(<F)) $(libof-$(@F)),$(CFLAGS-$(lib)))
955 # Use our copies of cstdlib and cmath.
956 override CXXFLAGS = -I$(common-objpfx) $(c++-sysincludes) \
957 $(filter-out %frame-pointer,$(+cflags)) $(sysdep-CFLAGS) \
958 $(CFLAGS-$(suffix $@)) $(CFLAGS-$(<F)) $(CFLAGS-$(@F))
960 # If everything is compiled with -fPIC (implicitly) we must tell this by
961 # defining the PIC symbol.
962 ifeq (yes,$(build-pic-default))
966 # Enable object files for different versions of the library.
967 # Various things use $(object-suffixes) to know what all to make.
968 # The compilation rules use $(CPPFLAGS-${SUFFIX}) and $(CFLAGS-${SUFFIX})
969 # to pass different flags for each flavor.
970 libtypes = $(foreach o,$(object-suffixes-for-libc),$(libtype$o))
971 # .op may be added to all-object-suffixes below.
972 all-object-suffixes := .o .os .oS
974 CPPFLAGS-.o = $(pic-default)
975 CFLAGS-.o = $(filter %frame-pointer,$(+cflags))
977 object-suffixes += .o
978 ifeq (yes,$(build-shared))
979 # Under --enable-shared, we will build a shared library of PIC objects.
980 # The PIC object files are named foo.os.
981 object-suffixes += .os
982 CPPFLAGS-.os = -DPIC -DSHARED
983 CFLAGS-.os = $(filter %frame-pointer,$(+cflags)) $(pic-ccflag)
984 libtype.os := lib%_pic.a
985 # This can be changed by a sysdep makefile
987 # This one should always stay like this unless there is a very good reason.
990 # This can be changed by a sysdep makefile
992 # This one should always stay like this unless there is a very good reason.
994 ifeq (yes,$(build-profile))
995 # Under --enable-profile, we will build a static library of profiled objects.
996 # The profiled object files are named foo.op.
997 all-object-suffixes += .op
998 object-suffixes += .op
999 CPPFLAGS-.op = -DPROF $(pic-default)
1001 libtype.op = lib%_p.a
1004 # Convenience variable for when we want to treat shared-library cases
1005 # differently from the rest.
1006 object-suffixes-noshared := $(filter-out .os,$(object-suffixes))
1008 object-suffixes-for-libc := $(object-suffixes)
1010 ifeq (yes,$(build-shared))
1011 # Build special library that contains the static-only routines for libc.
1012 object-suffixes-for-libc += .oS
1014 # Must build the routines as PIC, though, because they can end up in (users')
1015 # shared objects. We don't want to use CFLAGS-os because users may, for
1016 # example, make that processor-specific.
1017 CFLAGS-.oS = $(CFLAGS-.o) $(PIC-ccflag)
1018 CPPFLAGS-.oS = $(CPPFLAGS-.o) -DPIC -DLIBC_NONSHARED=1
1019 libtype.oS = lib%_nonshared.a
1022 # The assembler can generate debug information too.
1024 ASFLAGS := $(filter -g% -fdebug-prefix-map=%,$(CFLAGS))
1026 ASFLAGS += -Werror=undef $(ASFLAGS-config) $(asflags-cpu)
1032 move-if-change = $(SHELL) $(..)scripts/move-if-change
1034 -include $(common-objpfx)sysd-sorted
1035 subdirs = $(sorted-subdirs)
1036 subdir-srcdirs = $(foreach dir,$(subdirs),\
1037 $(firstword $($(dir)-srcdir) $(..)$(dir)))
1039 # This is a pair of implicit rules to preprocess a file with # comments,
1040 # %ifdef et al, based on config.h settings or other %include'd files.
1041 # We use chained rules instead of a pipeline here so that we can properly
1042 # check the exit status of cpp rather than using its bad output when there
1043 # is a preprocessing error. Another rule should depend on the output file
1044 # `FOO.v', and along with that `FOO.v.i' should be given dependencies
1045 # listing both its input files, and any header files that it may reference
1046 # (but no commands).
1047 %.v.i: $(common-objpfx)config.h $(..)Makeconfig
1048 sed '/^[ ]*%/!s/#.*$$//;/^[ ]*$$/d;s/^[ ]*%/#/' \
1049 $(filter-out FORCE %.h $(..)Makeconfig,$^) \
1050 | $(CC) -E -undef $(CPPFLAGS) -x assembler-with-cpp - \
1054 sed '/^[ ]*#/d;/^[ ]*$$/d' $< > $@T
1057 ifeq (yes, $(build-shared))
1059 # To generate a header to support more than one ABI for different
1060 # architecture variants, the CPU/Makefile defines abi-variants to be a
1061 # list of names for those variants (e.g. 32 64), and, for each variant,
1062 # defines abi-$(variant)-condition to be the condition for those options
1063 # to use in a C #if condition. abi-includes may be defined to a list of
1064 # headers to include in the generated header, if the default does not
1065 # suffice. default-abi is defined to be the ABI for the current glibc
1069 abi-includes := bits/wordsize.h
1072 # Process the shlib-versions file, which tells us what shared library
1073 # version numbers to use when we install shared objects on this system.
1074 # We need to wait until $(subdirs) is complete.
1075 ifeq ($(sysd-sorted-done),t)
1076 -include $(common-objpfx)soversions.mk
1077 ifndef avoid-generated
1078 # This lets add-ons give more-specific matches that override defaults
1079 # in the top-level file.
1080 $(common-objpfx)shlib-versions.v.i: \
1081 $(wildcard $(+sysdep_dirs:=/shlib-versions) \
1082 $(subdir-srcdirs:=/shlib-versions)) \
1085 $(common-objpfx)soversions.i: $(..)scripts/soversions.awk \
1086 $(common-objpfx)shlib-versions.v
1089 $(common-objpfx)soversions.mk: $(common-objpfx)soversions.i $(..)Makeconfig
1090 (while read which lib number setname; do \
1091 eval seen_$$which=1; \
1092 test x"$$which" = xDEFAULT || continue; \
1094 [0-9]*) echo "$$lib.so-version=.$$number"; \
1095 echo "all-sonames+=$$lib=$$lib.so\$$($$lib.so-version)";;\
1096 *) echo "$$lib.so-version=$$number"; \
1097 echo "all-sonames+=$$lib=\$$($$lib.so-version)";;\
1100 echo soversions.mk-done = t;) < $< > $@T; exit 0
1105 postclean-generated += soversions.mk soversions.i \
1106 shlib-versions.v shlib-versions.v.i
1108 before-compile += $(common-objpfx)libc-modules.h
1109 ifeq ($(soversions.mk-done),t)
1110 # Generate a header with macro definitions for use with the IS_IN macro.
1111 # These are the possible values for the MODULE_NAME macro defined when building
1112 # sources, to identify which module the translation unit is going to be built
1114 $(common-objpfx)libc-modules.h: $(common-objpfx)libc-modules.stmp; @:
1115 $(common-objpfx)libc-modules.stmp: $(..)scripts/gen-libc-modules.awk \
1116 $(common-objpfx)soversions.i
1117 $(AWK) -v buildlist="$(subst -,_,$(built-modules))" -f $^ > ${@:stmp=T}
1118 $(move-if-change) ${@:stmp=T} ${@:stmp=h}
1123 # Build the tunables list header early since it could be used by any module in
1125 ifneq (no,$(have-tunables))
1126 before-compile += $(common-objpfx)dl-tunable-list.h
1128 $(common-objpfx)dl-tunable-list.h: $(..)scripts/gen-tunables.awk \
1129 $(..)elf/dl-tunables.list
1130 $(AWK) -f $^ > $@.tmp
1134 common-generated += libc-modules.h libc-modules.stmp
1136 # The name under which the run-time dynamic linker is installed.
1137 # We are currently going for the convention that `/lib/ld.so.1'
1138 # names the SVR4/ELF ABI-compliant dynamic linker.
1139 ifndef rtld-installed-name
1141 rtld-installed-name = $(ld.so-version)
1143 rtld-installed-name = ld.so.1
1147 ifndef rtld-version-installed-name
1148 rtld-version-installed-name = ld-$(version).so
1151 endif # build-shared
1154 ifeq ($(build-shared),yes)
1155 libdl = $(common-objpfx)dlfcn/libdl.so$(libdl.so-version)
1157 libdl = $(common-objpfx)dlfcn/libdl.a
1160 ifeq ($(build-shared),yes)
1161 libm = $(common-objpfx)math/libm.so$(libm.so-version)
1162 libmvec = $(common-objpfx)mathvec/libmvec.so$(libmvec.so-version)
1164 libm = $(common-objpfx)math/libm.a
1165 libmvec = $(common-objpfx)mathvec/libmvec.a
1168 ifeq ($(build-shared),yes)
1169 libsupport = $(common-objpfx)support/libsupport_nonshared.a
1171 libsupport = $(common-objpfx)support/libsupport.a
1174 # These are the subdirectories containing the library source. The order
1175 # is more or less arbitrary. The sorting step will take care of the
1177 all-subdirs = csu assert ctype locale intl catgets math setjmp signal \
1178 stdlib stdio-common libio malloc string wcsmbs time dirent \
1179 grp pwd posix io termios resource misc socket sysvipc gmon \
1180 gnulib iconv iconvdata wctype manual shadow gshadow po argp \
1181 crypt localedata timezone rt conform debug mathvec support \
1182 $(add-on-subdirs) dlfcn elf
1184 ifndef avoid-generated
1185 # sysd-sorted itself will contain rules making the sysd-sorted target
1186 # depend on Depend files. But if you just added a Depend file to an
1187 # existing directory not in all-subdirs, then sysd-sorted needs to
1188 # be regenerated, so it depends on existing $(sorted-subdirs:=/Depend) files.
1189 all-Depend-files := $(wildcard $(sort \
1190 $(foreach dir,$(all-subdirs),\
1191 $(firstword $($(dir)-srcdir) \
1192 $(..)$(dir))/Depend) \
1193 $(sorted-subdirs:=/Depend)))
1194 $(common-objpfx)sysd-sorted: $(..)scripts/gen-sorted.awk \
1195 $(common-objpfx)config.make $(..)Makeconfig \
1196 $(wildcard $(sysdirs:=/Subdirs)) \
1199 -v subdirs='$(all-subdirs)' \
1201 $(filter %/Subdirs %/Depend,$^) > $@-tmp
1203 $(all-Depend-files): ;
1206 # This gives partial TARGET:SOURCE pattern pairs to have rules
1207 # emitted into sysd-rules. A sysdeps Makeconfig fragment can
1208 # add its own special object file prefix to this list with e.g. foo-%:%
1209 # to have foo-*.? compiled from *.? using $(foo-CPPFLAGS).
1210 sysd-rules-patterns := %:% rtld-%:rtld-% rtld-%:% m_%:s_%
1212 # Let sysdeps/ subdirs contain a Makeconfig fragment for us to include here.
1213 sysdep-makeconfigs := $(wildcard $(+sysdep_dirs:=/Makeconfig))
1214 ifneq (,$(sysdep-makeconfigs))
1215 include $(sysdep-makeconfigs)
1218 # Compute just the target patterns. Makeconfig has set sysd-rules-patterns.
1219 sysd-rules-targets := $(sort $(foreach p,$(sysd-rules-patterns),\
1220 $(firstword $(subst :, ,$p))))
1222 # A sysdeps Makeconfig fragment may set libc-reentrant to yes.
1223 ifeq (yes,$(libc-reentrant))
1224 defines += -D_LIBC_REENTRANT
1226 libio-mtsafe = -D_IO_MTSAFE_IO
1229 # The name to give to a test in test results summaries.
1230 test-name = $(strip $(patsubst %.out, %, $(patsubst $(common-objpfx)%, %, $@)))
1232 # Likewise, in XFAIL variable names.
1233 test-xfail-name = $(strip $(patsubst %.out, %, $(patsubst $(objpfx)%, %, $@)))
1235 # Command to output a test status line (such as PASS: test-name). If
1236 # test-xfail-$(test-xfail-name) has a nonempty value, the status will be
1237 # XPASS or XFAIL rather than PASS or FAIL.
1238 evaluate-test = $(..)scripts/evaluate-test.sh $(test-name) $$? \
1239 $(if $(test-xfail-$(test-xfail-name)),true,false) \
1240 $(if $(stop-on-test-failure),true,false) \
1241 > $(common-objpfx)$(test-name).test-result
1243 endif # Makeconfig not yet included