Fix typo in comment
[glibc.git] / Makeconfig
bloba3d3e70150ef1f8510e235783221fbefc5f7f21d
1 # Copyright (C) 1991-2013 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.
21 ifneq (,)
22 This makefile requires GNU Make.
23 endif
25 all: # Make this the default goal
27 ifneq "$(origin +included-Makeconfig)" "file"
29 +included-Makeconfig := yes
31 ifdef subdir
32 .. := ../
33 endif
35 # $(common-objdir) is the place to put objects and
36 # such that are not specific to a single subdir.
37 ifdef objdir
38 objpfx := $(patsubst %//,%/,$(objdir)/$(subdir)/)
39 common-objpfx = $(objdir)/
40 common-objdir = $(objdir)
41 else
42 objdir must be defined by the build-directory Makefile.
43 endif
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 = $(exceptions)
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)) \
69                                          $(..)$(add-on)))
70 +sysdep_dirs = $(sysdirs) $(sysdeps-srcdirs)
71 ifdef objdir
72 +sysdep_dirs := $(objdir) $(+sysdep_dirs)
73 endif
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) \
89                                          $(patsubst %.in,%,\
90                                                     $(firstword $(wildcard \
91  $(addprefix $(dir)/,configure configure.in))))) \
92                                $(patsubst %.in,%,\
93  $(wildcard $(..)sysdeps/*/preconfigure $(..)sysdeps/*/preconfigure.in)) \
94                                $(patsubst %.in,%,\
95                                           $(foreach add-on,$(add-ons),\
96                                                     $(firstword $(wildcard \
97  $(addprefix $(firstword $(filter /%,$(add-on)) $(..)$(add-on))/,\
98              configure configure.in))) \
99  $(wildcard $(addprefix $(firstword $(filter /%,$(add-on)) $(..)$(add-on))/,\
100                         sysdeps/*/preconfigure sysdeps/*/preconfigure.in))))
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; \
105          exit 1; fi
107 # We don't want CPPFLAGS to be exported to the command running configure.
108 unexport CPPFLAGS
110 # Get the user's configuration parameters.
111 ifneq ($(wildcard $(..)configparms),)
112 include $(..)configparms
113 endif
114 ifneq ($(objpfx),)
115 ifneq ($(wildcard $(common-objpfx)configparms),)
116 include $(common-objpfx)configparms
117 endif
118 endif
120 ####
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.
124 ####
127 # Common prefix for machine-independent installation directories.
128 ifeq ($(origin prefix),undefined) # ifndef would override explicit empty value.
129 prefix = /usr/local
130 endif
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
134 # standalone target.
135 ifndef build-programs
136 ifneq ($(config-os),none)
137 build-programs=yes
138 else
139 build-programs=no
140 endif
141 endif
143 # Common prefix for machine-dependent installation directories.
144 ifeq ($(origin exec_prefix),undefined)
145 exec_prefix = $(prefix)
146 endif
148 # Where to install the library and object files.
149 ifndef libdir
150 libdir = $(exec_prefix)/lib
151 endif
152 inst_libdir = $(install_root)$(libdir)
154 # Where to install the shared library.
155 ifndef slibdir
156 slibdir = $(exec_prefix)/lib
157 endif
158 inst_slibdir = $(install_root)$(slibdir)
160 # Where to install the dynamic linker.
161 ifndef rtlddir
162 rtlddir = $(slibdir)
163 endif
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)
171 libprefix =
172 endif
174 # Where to install the header files.
175 ifndef includedir
176 includedir = $(prefix)/include
177 endif
178 inst_includedir = $(install_root)$(includedir)
180 # Where to install machine-independent data files.
181 # These are the timezone database, and the locale database.
182 ifndef datadir
183 datadir = $(prefix)/share
184 endif
185 inst_datadir = $(install_root)$(datadir)
187 # Where to install the timezone data files (which are machine-independent).
188 ifndef zonedir
189 zonedir = $(datadir)/zoneinfo
190 endif
191 inst_zonedir = $(install_root)$(zonedir)
193 # Where to install the locale files.
194 ifndef localedir
195 localedir = $(libdir)/locale
196 endif
197 inst_localedir = $(install_root)$(localedir)
199 # Where to install the message catalog data files (which are
200 # machine-independent).
201 ifndef msgcatdir
202 msgcatdir = $(datadir)/locale
203 endif
204 inst_msgcatdir = $(install_root)$(msgcatdir)
206 # Where to install the locale charmap source files.
207 ifndef i18ndir
208 i18ndir = $(datadir)/i18n
209 endif
210 inst_i18ndir = $(install_root)$(i18ndir)
212 # Where to install the shared object for charset transformation.
213 ifndef gconvdir
214 gconvdir = $(libdir)/gconv
215 endif
216 inst_gconvdir = $(install_root)$(gconvdir)
218 # Where to install programs.
219 ifndef bindir
220 bindir = $(exec_prefix)/bin
221 endif
222 inst_bindir = $(install_root)$(bindir)
224 # Where to install internal programs.
225 ifndef libexecdir
226 libexecdir = $(exec_prefix)/libexec
227 endif
228 inst_libexecdir = $(install_root)$(libexecdir)
230 # Where to install administrative programs.
231 ifndef rootsbindir
232 rootsbindir = $(exec_prefix)/sbin
233 endif
234 inst_rootsbindir = $(install_root)$(rootsbindir)
236 ifndef sbindir
237 sbindir = $(exec_prefix)/sbin
238 endif
239 inst_sbindir = $(install_root)$(sbindir)
241 # Where to install the Info files.
242 ifndef infodir
243 infodir = $(prefix)/info
244 endif
245 inst_infodir = $(install_root)$(infodir)
247 # Where to install audit libraries.
248 ifndef auditdir
249 auditdir = $(libdir)/audit
250 endif
251 inst_auditdir = $(install_root)$(auditdir)
253 # Where to install default configuration files.  These include the local
254 # timezone specification and network data base files.
255 ifndef sysconfdir
256 sysconfdir = $(prefix)/etc
257 endif
258 inst_sysconfdir = $(install_root)$(sysconfdir)
260 # Directory for the database files and Makefile for nss_db.
261 ifndef vardbdir
262 vardbdir = $(localstatedir)/db
263 endif
264 inst_vardbdir = $(install_root)$(vardbdir)
266 # Where to install the "localtime" timezone file; this is the file whose
267 # contents $(localtime) specifies.  If this is a relative pathname, it is
268 # relative to $(zonedir).  It is a good idea to put this somewhere
269 # other than there, so the zoneinfo directory contains only universal data,
270 # localizing the configuration data elsewhere.
271 ifndef localtime-file
272 localtime-file = $(sysconfdir)/localtime
273 endif
275 # What to use for leap second specifications in compiling the default
276 # timezone files.  Set this to `/dev/null' for no leap second handling as
277 # 1003.1 requires, or to `leapseconds' for proper leap second handling.
278 # Both zone flavors are always available as `posix/ZONE' and `right/ZONE'.
279 # This variable determines the default: if it's `/dev/null',
280 # ZONE==posix/ZONE; if it's `leapseconds', ZONE==right/ZONE.
281 ifndef leapseconds
282 leapseconds = /dev/null
283 endif
285 # What timezone's DST rules should be used when a POSIX-style TZ
286 # environment variable doesn't specify any rules.  For 1003.1 compliance
287 # this timezone must use rules that are as U.S. federal law defines DST.
288 # Run `make -C time echo-zonenames' to see a list of available zone names.
289 # This setting can be changed with `zic -p TIMEZONE' at any time.
290 # If you want POSIX.1 compatibility, use `America/New_York'.
291 ifndef posixrules
292 posixrules = America/New_York
293 endif
295 # Where to install the "posixrules" timezone file; this is file
296 # whose contents $(posixrules) specifies.  If this is a relative
297 # pathname, it is relative to $(zonedir).
298 ifndef posixrules-file
299 posixrules-file = posixrules
300 endif
303 # Directory where your system's native header files live.
304 # This is used on Unix systems to generate some GNU libc header files.
305 ifndef sysincludedir
306 sysincludedir = /usr/include
307 endif
310 # Commands to install files.
311 ifndef INSTALL_DATA
312 INSTALL_DATA = $(INSTALL) -m 644
313 endif
314 ifndef INSTALL_SCRIPT
315 INSTALL_SCRIPT = $(INSTALL)
316 endif
317 ifndef INSTALL_PROGRAM
318 INSTALL_PROGRAM = $(INSTALL)
319 endif
320 ifndef INSTALL
321 INSTALL = install
322 endif
325 # The name of the C compiler.
326 # If you've got GCC, and it works, use it.
327 ifeq ($(origin CC),default)
328 CC := gcc
329 endif
331 # The name of the C compiler to use for compilations of programs to run on
332 # the host that is building the library.  If you set CC to a
333 # cross-compiler, you must set this to the normal compiler.
334 ifndef BUILD_CC
335 BUILD_CC = $(CC)
336 endif
338 # Default flags to pass the C compiler.
339 ifndef default_cflags
340 ifeq ($(release),stable)
341 default_cflags := -g -O2
342 else
343 default_cflags := -g -O
344 endif
345 endif
347 # Flags to pass the C compiler when assembling preprocessed assembly code
348 # (`.S' files).  On some systems the assembler doesn't understand the `#' line
349 # directives the preprocessor produces.  If you have troubling compiling
350 # assembly code, try using -P here to suppress these directives.
351 ifndef asm-CPPFLAGS
352 asm-CPPFLAGS =
353 endif
355 as-needed := -Wl,--as-needed
356 no-as-needed := -Wl,--no-as-needed
358 # Must be supported by the linker.
359 no-whole-archive = -Wl,--no-whole-archive
360 whole-archive = -Wl,--whole-archive
362 # Installed name of the startup code.
363 # The ELF convention is that the startfile is called crt1.o
364 start-installed-name = crt1.o
365 # On systems that do not need a special startfile for statically linked
366 # binaries, simply set it to the normal name.
367 ifndef static-start-installed-name
368 static-start-installed-name = $(start-installed-name)
369 endif
371 ifeq (yesyes,$(build-shared)$(have-z-combreloc))
372 combreloc-LDFLAGS = -Wl,-z,combreloc
373 LDFLAGS.so += $(combreloc-LDFLAGS)
374 LDFLAGS-rtld += $(combreloc-LDFLAGS)
375 endif
377 relro-LDFLAGS = -Wl,-z,relro
378 LDFLAGS.so += $(relro-LDFLAGS)
379 LDFLAGS-rtld += $(relro-LDFLAGS)
381 ifeq (yes,$(have-hash-style))
382 # For the time being we unconditionally use 'both'.  At some time we
383 # should declare statically linked code as 'out of luck' and compile
384 # with --hash-style=gnu only.
385 hashstyle-LDFLAGS = -Wl,--hash-style=both
386 LDFLAGS.so += $(hashstyle-LDFLAGS)
387 LDFLAGS-rtld += $(hashstyle-LDFLAGS)
388 endif
390 # Command for linking PIE programs with the C library.
391 ifndef +link-pie
392 +link-pie-before-libc = $(CC) -pie -Wl,-O1 -nostdlib -nostartfiles -o $@ \
393              $(sysdep-LDFLAGS) $(LDFLAGS) $(LDFLAGS-$(@F)) \
394              $(combreloc-LDFLAGS) $(relro-LDFLAGS) $(hashstyle-LDFLAGS) \
395              $(addprefix $(csu-objpfx),S$(start-installed-name)) \
396              $(+preinit) $(+prectorS) \
397              $(filter-out $(addprefix $(csu-objpfx),start.o \
398                                                     S$(start-installed-name))\
399                           $(+preinit) $(link-extra-libs) \
400                           $(common-objpfx)libc% $(+postinit),$^) \
401              $(link-extra-libs)
402 +link-pie-after-libc = $(+postctorS) $(+postinit)
403 +link-pie = $(+link-pie-before-libc) $(rtld-LDFLAGS) $(link-libc) \
404             $(+link-pie-after-libc)
405 +link-pie-tests = $(+link-pie-before-libc) $(rtld-tests-LDFLAGS) \
406                   $(link-libc-tests) $(+link-pie-after-libc)
407 endif
408 # Command for statically linking programs with the C library.
409 ifndef +link-static
410 +link-static-before-libc = $(CC) -nostdlib -nostartfiles -static -o $@ \
411               $(sysdep-LDFLAGS) $(LDFLAGS) $(LDFLAGS-$(@F))  \
412               $(addprefix $(csu-objpfx),$(static-start-installed-name)) \
413               $(+preinit) $(+prectorT) \
414               $(filter-out $(addprefix $(csu-objpfx),start.o \
415                                                      $(start-installed-name))\
416                            $(+preinit) $(link-extra-libs-static) \
417                            $(common-objpfx)libc% $(+postinit),$^) \
418               $(link-extra-libs-static)
419 +link-static-after-libc = $(+postctorT) $(+postinit)
420 +link-static = $(+link-static-before-libc) $(link-libc-static) \
421                $(+link-static-after-libc)
422 +link-static-tests = $(+link-static-before-libc) $(link-libc-static-tests) \
423                      $(+link-static-after-libc)
424 endif
425 # Commands for linking programs with the C library.
426 ifndef +link
427 ifeq (yes,$(build-shared))
428 +link-before-libc = $(CC) -nostdlib -nostartfiles -o $@ \
429               $(sysdep-LDFLAGS) $(LDFLAGS) $(LDFLAGS-$(@F)) \
430               $(combreloc-LDFLAGS) $(relro-LDFLAGS) $(hashstyle-LDFLAGS) \
431               $(addprefix $(csu-objpfx),$(start-installed-name)) \
432               $(+preinit) $(+prector) \
433               $(filter-out $(addprefix $(csu-objpfx),start.o \
434                                                      $(start-installed-name))\
435                            $(+preinit) $(link-extra-libs) \
436                            $(common-objpfx)libc% $(+postinit),$^) \
437               $(link-extra-libs)
438 +link-after-libc = $(+postctor) $(+postinit)
439 +link = $(+link-before-libc) $(rtld-LDFLAGS) $(link-libc) \
440         $(+link-after-libc)
441 +link-tests = $(+link-before-libc) $(rtld-tests-LDFLAGS) \
442               $(link-libc-tests) $(+link-after-libc)
443 else
444 +link = $(+link-static)
445 +link-tests = $(+link-static-tests)
446 endif
447 endif
448 ifeq (yes,$(build-shared))
449 ifndef rtld-LDFLAGS
450 rtld-LDFLAGS = -Wl,-dynamic-linker=$(rtlddir)/$(rtld-installed-name)
451 endif
452 ifndef rtld-tests-LDFLAGS
453 ifeq (yes,$(build-hardcoded-path-in-tests))
454 rtld-tests-LDFLAGS = -Wl,-dynamic-linker=$(common-objpfx)elf/ld.so
455 else
456 rtld-tests-LDFLAGS = $(rtld-LDFLAGS)
457 endif
458 endif
459 endif
460 ifndef link-libc
461 ifeq (yes,$(build-shared))
462 # We need the versioned name of libc.so in the deps of $(others) et al
463 # so that the symlink to libc.so is created before anything tries to
464 # run the linked programs.
465 link-libc-rpath-link = -Wl,-rpath-link=$(rpath-link)
466 ifeq (yes,$(build-hardcoded-path-in-tests))
467 link-libc-tests-rpath-link = -Wl,-rpath=$(rpath-link)
468 else
469 link-libc-tests-rpath-link = $(link-libc-rpath-link)
470 endif
471 link-libc-before-gnulib = $(common-objpfx)libc.so$(libc.so-version) \
472                           $(common-objpfx)$(patsubst %,$(libtype.oS),c) \
473                           $(as-needed) $(common-objpfx)elf/ld.so \
474                           $(no-as-needed)
475 link-libc = $(link-libc-rpath-link) $(link-libc-before-gnulib) $(gnulib)
476 link-libc-tests = $(link-libc-tests-rpath-link) \
477                   $(link-libc-before-gnulib) $(gnulib-tests)
478 # This is how to find at build-time things that will be installed there.
479 rpath-dirs = math elf dlfcn nss nis rt resolv crypt
480 rpath-link = \
481 $(common-objdir):$(subst $(empty) ,:,$(patsubst ../$(subdir),.,$(rpath-dirs:%=$(common-objpfx)%)))
482 else
483 link-libc = $(common-objpfx)libc.a $(otherlibs) $(gnulib) $(common-objpfx)libc.a $(gnulib)
484 link-libc-tests = $(common-objpfx)libc.a $(otherlibs) $(gnulib-tests) $(common-objpfx)libc.a $(gnulib-tests)
485 endif
486 endif
488 elfobjdir := $(patsubst ../$(subdir),.,$(common-objpfx)elf)
490 # Differences in the linkers on the various platforms.
491 LDFLAGS-rpath-ORIGIN = -Wl,-rpath,'$$ORIGIN'
492 LDFLAGS-soname-fname = -Wl,-soname,$(@F)
493 LDFLAGS-rdynamic = -rdynamic
494 LDFLAGS-Bsymbolic = -Bsymbolic
496 # Choose the default search path for the dynamic linker based on
497 # where we will install libraries.
498 ifneq ($(libdir),$(slibdir))
499 default-rpath = $(slibdir):$(libdir)
500 else
501 default-rpath = $(libdir)
502 endif
504 ifndef link-extra-libs
505 link-extra-libs = $(LDLIBS-$(@F))
506 link-extra-libs-static = $(link-extra-libs)
507 endif
509 # The static libraries.
510 link-libc-static = -Wl,--start-group $(common-objpfx)libc.a $(static-gnulib) -Wl,--end-group
511 link-libc-static-tests = -Wl,--start-group $(common-objpfx)libc.a $(static-gnulib-tests) -Wl,--end-group
513 # How to link against libgcc.  Some libgcc functions, such as those
514 # for "long long" arithmetic or software floating point, can always be
515 # built without use of C library headers and do not have any global
516 # state so can safely be linked statically into any executable or
517 # shared library requiring them; these functions are in libgcc.a.
518 # Other functions, relating to exception handling, may require C
519 # library headers to build and it may not be safe to have more than
520 # one copy of them in a process; these functions are only in
521 # libgcc_s.so and libgcc_eh.a.
523 # To avoid circular dependencies when bootstrapping, it is desirable
524 # to avoid use of libgcc_s and libgcc_eh in building glibc.  Where any
525 # glibc functionality (in particular, thread cancellation) requires
526 # exception handling, this is implemented through dlopen of libgcc_s
527 # to avoid unnecessary dependencies on libgcc_s by programs not using
528 # that functionality; executables built with glibc do not use
529 # exception handling other than through thread cancellation.
531 # Undefined references to functions from libgcc_eh or libgcc_s may
532 # arise for code built with -fexceptions.  In the case of statically
533 # linked programs installed by glibc, unwinding will never actually
534 # occur at runtime and the use of elf/static-stubs.c to resolve these
535 # references is safe.  In the case of statically linked test programs
536 # and test programs built with -fexceptions, unwinding may occur in
537 # some cases and it is preferable to link with libgcc_eh or libgcc_s
538 # so that the testing is as similar as possible to how programs will
539 # be built with the installed glibc.
541 # Some architectures have architecture-specific systems for exception
542 # handling that may involve undefined references to
543 # architecture-specific functions.  On those architectures,
544 # gnulib-arch and static-gnulib-arch may be defined in sysdeps
545 # makefiles to use additional libraries for linking executables and
546 # shared libraries built by glibc.
547 ifndef gnulib
548 ifneq ($(have-cc-with-libunwind),yes)
549   libunwind =
550 else
551   libunwind = -lunwind
552 endif
553 libgcc_eh := -Wl,--as-needed -lgcc_s $(libunwind) -Wl,--no-as-needed
554 gnulib-arch =
555 gnulib = -lgcc $(gnulib-arch)
556 gnulib-tests := -lgcc $(libgcc_eh)
557 static-gnulib-arch =
558 # By default, elf/static-stubs.o, instead of -lgcc_eh, is used to
559 # statically link programs.  When --disable-shared is used, we use
560 # -lgcc_eh since elf/static-stubs.o isn't sufficient.
561 ifeq (yes,$(build-shared))
562 static-gnulib = -lgcc $(static-gnulib-arch)
563 else
564 static-gnulib = -lgcc -lgcc_eh $(static-gnulib-arch)
565 endif
566 static-gnulib-tests := -lgcc -lgcc_eh $(libunwind)
567 libc.so-gnulib := -lgcc
568 endif
569 +preinit = $(addprefix $(csu-objpfx),crti.o)
570 +postinit = $(addprefix $(csu-objpfx),crtn.o)
571 +prector = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtbegin.o`
572 +postctor = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtend.o`
573 # Variants of the two previous definitions for linking PIE programs.
574 +prectorS = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtbeginS.o`
575 +postctorS = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtendS.o`
576 # Variants of the two previous definitions for statically linking programs.
577 +prectorT = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtbeginT.o`
578 +postctorT = `$(CC) $(sysdep-LDFLAGS) --print-file-name=crtend.o`
579 +interp = $(addprefix $(elf-objpfx),interp.os)
580 csu-objpfx = $(common-objpfx)csu/
581 elf-objpfx = $(common-objpfx)elf/
583 # A command that, prepended to the name and arguments of a program,
584 # and run on the build system, causes that program with those
585 # arguments to be run on the host for which the library is built.
586 ifndef test-wrapper
587 test-wrapper =
588 endif
589 # Likewise, but the name of the program is preceded by
590 # <variable>=<value> assignments for environment variables.
591 ifndef test-wrapper-env
592 test-wrapper-env = $(test-wrapper) env
593 endif
595 # Whether to run test programs built for the library's host system.
596 ifndef run-built-tests
597 ifeq (yes|,$(cross-compiling)|$(test-wrapper))
598 run-built-tests = no
599 else
600 run-built-tests = yes
601 endif
602 endif
604 # How to run a program we just linked with our library.
605 # The program binary is assumed to be $(word 2,$^).
606 built-program-file = $(dir $(word 2,$^))$(notdir $(word 2,$^))
607 rtld-prefix = $(elf-objpfx)$(rtld-installed-name)                             \
608               --library-path                                                  \
609               $(rpath-link)$(patsubst %,:%,$(sysdep-library-path))
610 ifeq (yes,$(build-shared))
611 comma = ,
612 sysdep-library-path = \
613 $(subst $(empty) ,:,$(strip $(patsubst -Wl$(comma)-rpath-link=%, %,\
614                                        $(filter -Wl$(comma)-rpath-link=%,\
615                                                 $(sysdep-LDFLAGS)))))
616 # $(run-via-rtld-prefix) is a command that, when prepended to the name
617 # of a program built with the newly built library, produces a command
618 # that, executed on the host for which the library is built, runs that
619 # program.  For tests listed in tests-static or xtests-static, it is
620 # empty.
621 run-via-rtld-prefix =                                                         \
622   $(if $(strip $(filter $(notdir $(built-program-file)),                      \
623                         $(tests-static) $(xtests-static))),, $(rtld-prefix))
624 else
625 run-via-rtld-prefix =
626 endif
627 # $(run-program-prefix) is a command that, when prepended to the name
628 # of a program built with the newly built library, produces a command
629 # that, executed on the build system on which "make" is run, runs that
630 # program.
631 run-program-prefix = $(test-wrapper) $(run-via-rtld-prefix)
632 # $(built-program-cmd) is a command that, executed on the build system
633 # on which "make" is run, runs the newly built program that is the
634 # second dependency of the makefile target in which
635 # $(built-program-cmd) is used.
636 built-program-cmd = $(test-wrapper) \
637                     $(run-via-rtld-prefix) $(built-program-file)
638 # $(host-built-program-cmd) is a command that, executed on the host
639 # for which the library is built, runs the newly built program that is
640 # the second dependency of the makefile target in which
641 # $(host-built-program-cmd) is used.
642 host-built-program-cmd = $(run-via-rtld-prefix) $(built-program-file)
644 ifndef LD
645 LD := ld -X
646 endif
648 # $(test-via-rtld-prefix) is a command that, when prepended to the name
649 # of a test program built with the newly built library, produces a command
650 # that, executed on the host for which the library is built, runs that
651 # program.  For tests listed in tests-static or xtests-static as well
652 # as when test programs are hardcoded to the newly built libraries, it
653 # is empty.
655 # $(test-program-prefix) is a command that, when prepended to the name
656 # of a test program built with the newly built library, produces a command
657 # that, executed on the build system on which "make" is run, runs that
658 # test program.
660 # $(test-program-cmd) is a command that, executed on the build system
661 # on which "make" is run, runs the newly built test program that is the
662 # second dependency of the makefile target in which
663 # $(test-program-cmd) is used.
665 # $(host-test-program-cmd) is a command that, executed on the host
666 # for which the library is built, runs the newly built test program that
667 # is the second dependency of the makefile target in which
668 # $(host-test-program-cmd) is used.
670 ifeq (yes,$(build-hardcoded-path-in-tests))
671 test-via-rtld-prefix =
672 test-program-prefix = $(test-wrapper)
673 test-program-cmd = $(test-wrapper) $(built-program-file)
674 host-test-program-cmd = $(built-program-file)
675 else
676 test-via-rtld-prefix = $(run-via-rtld-prefix)
677 test-program-prefix = $(run-program-prefix)
678 test-program-cmd = $(built-program-cmd)
679 host-test-program-cmd = $(host-built-program-cmd)
680 endif
682 # Extra flags to pass to GCC.
683 ifeq ($(all-warnings),yes)
684 +gccwarn := -Wall -Wwrite-strings -Winline -Wcast-qual -Wbad-function-cast -Wmissing-noreturn -Wmissing-prototypes -Wmissing-declarations -Wcomment -Wcomments -Wtrigraphs -Wsign-compare -Wfloat-equal -Wmultichar
685 else
686 +gccwarn := -Wall -Wwrite-strings -Winline
687 endif
688 +gccwarn-c = -Wstrict-prototypes
690 # We do not depend on the address of constants in different files to be
691 # actually different, so allow the compiler to merge them all.
692 +merge-constants = -fmerge-all-constants
694 # We have to assume that glibc functions are called in any rounding
695 # mode and also change the rounding mode in a few functions. So,
696 # disable any optimization that assume default rounding mode.
697 +math-flags = -frounding-math
699 # This is the program that generates makefile dependencies from C source files.
700 # The -MP flag tells GCC >= 3.2 (which we now require) to produce dummy
701 # targets for headers so that removed headers don't break the build.
702 ifndef +mkdep
703 +mkdep = $(CC) -M -MP
704 endif
706 # The program that makes Emacs-style TAGS files.
707 ETAGS   := etags
709 # The `xgettext' program for producing .pot files from sources.
710 ifndef XGETTEXT
711 XGETTEXT = xgettext
712 endif
714 # The `m4' macro processor; this is used by sysdeps/sparc/Makefile (and
715 # perhaps others) to preprocess assembly code in some cases.
716 M4 = m4
718 # To force installation of files even if they are older than the
719 # installed files.  This variable is included in the dependency list
720 # of all installation targets.
721 ifeq ($(force-install),yes)
722 +force = force-install
723 else
724 +force =
725 endif
727 ####
728 #### End of configuration variables.
729 ####
731 # This tells some versions of GNU make before 3.63 not to export all variables.
732 .NOEXPORT:
734 # We want to echo the commands we're running without
735 # umpteen zillion filenames along with it (we use `...' instead)
736 # but we don't want this echoing done when the user has said
737 # he doesn't want to see commands echoed by using -s.
738 ifneq   "$(findstring s,$(MAKEFLAGS))" ""       # if -s
739 +cmdecho        := echo >/dev/null
740 else                                            # not -s
741 +cmdecho        := echo
742 endif                                           # -s
744 # These are the flags given to the compiler to tell
745 # it what sort of optimization and/or debugging output to do.
746 ifndef  +cflags
747 # If `CFLAGS' was defined, use that.
748 ifdef           CFLAGS
749 +cflags := $(filter-out -I%,$(CFLAGS))
750 endif           # CFLAGS
751 endif   # +cflags
753 # If none of the above worked, default to "-g -O".
754 ifeq    "$(strip $(+cflags))" ""
755 +cflags := $(default_cflags)
756 endif   # $(+cflags) == ""
758 +cflags += $(cflags-cpu) $(+gccwarn) $(+merge-constants) $(+math-flags)
759 +gcc-nowarn := -w
761 # Don't duplicate options if we inherited variables from the parent.
762 +cflags := $(sort $(+cflags))
764 # Each sysdeps directory can contain header files that both will be
765 # used to compile and will be installed.  Each can also contain an
766 # include/ subdirectory, whose header files will be used to compile
767 # but will not be installed, and will take precedence over the
768 # installed files.  This mirrors the top-level include/ subdirectory.
769 +sysdep-includes := $(foreach dir,$(+sysdep_dirs),\
770                               $(addprefix -I,$(wildcard $(dir)/include) $(dir)))
772 # These are flags given to the C compiler to tell it to look for
773 # include files (including ones given in angle brackets) in the parent
774 # library source directory, in the include directory, and in the
775 # current directory.
776 +includes = -I$(..)include $(if $(subdir),$(objpfx:%/=-I%)) \
777             $(+sysdep-includes) $(includes) \
778             $(patsubst %/,-I%,$(..)) $(libio-include) -I. $(sysincludes)
780 # Since libio has several internal header files, we use a -I instead
781 # of many little headers in the include directory.
782 libio-include = -I$(..)libio
784 # These are the variables that the implicit compilation rules use.
785 # Note that we can't use -std=* in CPPFLAGS, because it overrides
786 # the implicit -lang-asm and breaks cpp behavior for .S files--notably
787 # it causes cpp to stop predefining __ASSEMBLER__.
788 CPPFLAGS = $(CPPUNDEFS) $(CPPFLAGS-config) $($(subdir)-CPPFLAGS) \
789            $(+includes) $(defines) \
790            -include $(..)include/libc-symbols.h $(sysdep-CPPFLAGS) \
791            $(CPPFLAGS-$(suffix $@)) \
792            $(foreach lib,$(libof-$(basename $(@F))) \
793                          $(libof-$(<F)) $(libof-$(@F)),$(CPPFLAGS-$(lib))) \
794            $(CPPFLAGS-$(<F)) $(CPPFLAGS-$(@F)) $(CPPFLAGS-$(basename $(@F)))
795 override CFLAGS = -std=gnu99 $(gnu89-inline-CFLAGS) $(config-extra-cflags) \
796                   $(filter-out %frame-pointer,$(+cflags)) $(+gccwarn-c) \
797                   $(sysdep-CFLAGS) $(CFLAGS-$(suffix $@)) $(CFLAGS-$(<F)) \
798                   $(CFLAGS-$(@F)) \
799                   $(foreach lib,$(libof-$(basename $(@F))) \
800                                 $(libof-$(<F)) $(libof-$(@F)),$(CFLAGS-$(lib)))
801 override CXXFLAGS = $(c++-sysincludes) \
802                     $(filter-out %frame-pointer,$(+cflags)) $(sysdep-CFLAGS) \
803                     $(CFLAGS-$(suffix $@)) $(CFLAGS-$(<F)) $(CFLAGS-$(@F))
805 # If everything is compiled with -fPIC (implicitly) we must tell this by
806 # defining the PIC symbol.
807 ifeq (yes,$(build-pic-default))
808 pic-default = -DPIC
809 endif
811 # Enable object files for different versions of the library.
812 # Various things use $(object-suffixes) to know what all to make.
813 # The compilation rules use $(CPPFLAGS-${SUFFIX}) and $(CFLAGS-${SUFFIX})
814 # to pass different flags for each flavor.
815 libtypes = $(foreach o,$(object-suffixes-for-libc),$(libtype$o))
816 all-object-suffixes := .o .os .op .og .oS
817 object-suffixes :=
818 CPPFLAGS-.o = $(pic-default)
819 CFLAGS-.o = $(filter %frame-pointer,$(+cflags))
820 libtype.o := lib%.a
821 object-suffixes += .o
822 ifeq (yes,$(build-shared))
823 # Under --enable-shared, we will build a shared library of PIC objects.
824 # The PIC object files are named foo.os.
825 object-suffixes += .os
826 CPPFLAGS-.os = -DPIC -DSHARED
827 CFLAGS-.os = $(filter %frame-pointer,$(+cflags)) $(pic-ccflag)
828 libtype.os := lib%_pic.a
829 # This can be changed by a sysdep makefile
830 pic-ccflag = -fPIC
831 # This one should always stay like this unless there is a very good reason.
832 PIC-ccflag = -fPIC
833 endif
834 # This can be changed by a sysdep makefile
835 pie-ccflag = -fpie
836 # This one should always stay like this unless there is a very good reason.
837 PIE-ccflag = -fPIE
838 ifeq (yes,$(build-profile))
839 # Under --enable-profile, we will build a static library of profiled objects.
840 # The profiled object files are named foo.op.
841 object-suffixes += .op
842 CPPFLAGS-.op = -DPROF $(pic-default)
843 CFLAGS-.op = -pg
844 libtype.op = lib%_p.a
845 endif
847 # Convenience variable for when we want to treat shared-library cases
848 # differently from the rest.
849 object-suffixes-noshared := $(filter-out .os,$(object-suffixes))
851 object-suffixes-for-libc := $(object-suffixes)
853 ifeq (yes,$(build-shared))
854 # Build special library that contains the static-only routines for libc.
855 object-suffixes-for-libc += .oS
857 # Must build the routines as PIC, though, because they can end up in (users')
858 # shared objects.  We don't want to use CFLAGS-os because users may, for
859 # example, make that processor-specific.
860 CFLAGS-.oS = $(CFLAGS-.o) $(PIC-ccflag)
861 CPPFLAGS-.oS = $(CPPFLAGS-.o) -DPIC -DLIBC_NONSHARED=1
862 libtype.oS = lib%_nonshared.a
863 endif
865 # The assembler can generate debug information too.
866 ifndef ASFLAGS
867 ASFLAGS := $(filter -g% -fdebug-prefix-map=%,$(CFLAGS))
868 endif
869 ASFLAGS += $(ASFLAGS-config) $(asflags-cpu)
871 ifndef BUILD_CC
872 BUILD_CC = $(CC)
873 endif
875 move-if-change = $(SHELL) $(..)scripts/move-if-change
877 -include $(common-objpfx)sysd-sorted
878 subdirs = $(sorted-subdirs)
879 subdir-srcdirs = $(foreach dir,$(subdirs),\
880                            $(firstword $($(dir)-srcdir) $(..)$(dir)))
882 # This is a pair of implicit rules to preprocess a file with # comments,
883 # %ifdef et al, based on config.h settings or other %include'd files.
884 # We use chained rules instead of a pipeline here so that we can properly
885 # check the exit status of cpp rather than using its bad output when there
886 # is a preprocessing error.  Another rule should depend on the output file
887 # `FOO.v', and along with that `FOO.v.i' should be given dependencies
888 # listing both its input files, and any header files that it may reference
889 # (but no commands).
890 %.v.i: $(common-objpfx)config.h $(..)Makeconfig
891         sed '/^[        ]*%/!s/#.*$$//;/^[      ]*$$/d;s/^[     ]*%/#/' \
892             $(filter-out FORCE %.h $(..)Makeconfig,$^) \
893         | $(CC) -E -undef $(CPPFLAGS) -x assembler-with-cpp - \
894                    > $@T
895         mv -f $@T $@
896 %.v: %.v.i
897         sed '/^[        ]*#/d;/^[       ]*$$/d' $< > $@T
898         mv -f $@T $@
900 ifeq (yes, $(build-shared))
902 # To generate a header to support more than one ABI for different
903 # architecture variants, the CPU/Makefile defines abi-variants to be a
904 # list of names for those variants (e.g. 32 64), and, for each variant,
905 # defines abi-$(variant)-condition to be the condition for those options
906 # to use in a C #if condition.  abi-includes may be defined to a list of
907 # headers to include in the generated header, if the default does not
908 # suffice.  default-abi is defined to be the ABI for the current glibc
909 # build.
911 ifndef abi-includes
912 abi-includes := bits/wordsize.h
913 endif
915 # Process the shlib-versions file, which tells us what shared library
916 # version numbers to use when we install shared objects on this system.
917 # We need to wait until $(subdirs) is complete.
918 ifeq ($(sysd-sorted-done),t)
919 -include $(common-objpfx)soversions.mk
920 ifndef avoid-generated
921 # This lets add-ons give more-specific matches that override defaults
922 # in the top-level file.
923 $(common-objpfx)shlib-versions.v.i: \
924         $(wildcard $(+sysdep_dirs:=/shlib-versions) \
925                    $(subdir-srcdirs:=/shlib-versions)) \
926         $(..)shlib-versions
928 soversions-default-setname = $(patsubst %, %,\
929                                         $(filter-out %_default,\
930                                                      $(oldest-abi:%=GLIBC_%)))
931 $(common-objpfx)soversions.i: $(..)scripts/soversions.awk \
932                               $(common-objpfx)shlib-versions.v
933         $(AWK) -v default_setname='$(soversions-default-setname)' \
934                -v cpu='$(config-machine)' \
935                -v vendor='$(config-vendor)' \
936                -v os='$(config-os)' \
937                -f $^ > $@T
938         mv -f $@T $@
939 $(common-objpfx)soversions.mk: $(common-objpfx)soversions.i $(..)Makeconfig
940         (while read which lib number setname; do \
941            eval seen_$$which=1; \
942            test x"$$which" != xABI || echo abi-name = "$$lib"; \
943            test x"$$which" = xDEFAULT || continue; \
944            case $$number in \
945              [0-9]*) echo "$$lib.so-version=.$$number"; \
946                      echo "all-sonames+=$$lib=$$lib.so\$$($$lib.so-version)";;\
947              *)      echo "$$lib.so-version=\$$(if \$$(abi-$(default-abi)-$$lib-soname),\$$(abi-$(default-abi)-$$lib-soname),$$number)"; \
948                      echo "all-sonames+=$$lib=\$$($$lib.so-version)";;\
949            esac; \
950          done; \
951          echo soversions.mk-done = t;) < $< > $@T; exit 0
952         mv -f $@T $@
953 endif
954 endif
956 postclean-generated += soversions.mk soversions.i \
957                        shlib-versions.v shlib-versions.v.i
959 # Generate the header containing the names of all shared libraries.
960 # We use a stamp file to avoid unnecessary recompilations.
961 before-compile += $(common-objpfx)gnu/lib-names.h
962 ifeq ($(soversions.mk-done),t)
963 $(common-objpfx)gnu/lib-names.h: $(common-objpfx)gnu/lib-names.stmp; @:
964 $(common-objpfx)gnu/lib-names.stmp: $(..)scripts/lib-names.awk \
965                                     $(common-objpfx)soversions.i
966         $(make-target-directory)
967         { \
968          echo '/* This file is automatically generated.';\
969          echo '   It defines macros to allow user program to find the shared'; \
970          echo '   library files which come as part of GNU libc.  */'; \
971          echo '#ifndef __GNU_LIB_NAMES_H'; \
972          echo '#define __GNU_LIB_NAMES_H        1'; \
973          echo ''; \
974          $(if $(abi-includes), \
975           $(foreach h,$(abi-includes), echo '#include <$(h)>';) \
976           echo '';) \
977          $(if $(abi-variants), \
978          $(foreach v,$(abi-variants),\
979          $(if $(abi-$(v)-condition),\
980          echo '#if $(abi-$(v)-condition)'; \
981          ($(foreach s,$(all-sonames), \
982            $(if $(abi-$(v)-$(firstword $(subst =, ,$(s)))-soname),\
983              echo $(firstword $(subst =, ,$(s)))=$(abi-$(v)-$(firstword $(subst =, ,$(s)))-soname);, \
984              echo $(s);))) \
985          | LC_ALL=C $(AWK) -v multi=1 -f $(firstword $^) | LC_ALL=C sort;) \
986          $(if $(abi-$(v)-condition),echo '#endif';)), \
987          ($(foreach s,$(all-sonames), echo $(s);)) \
988          | LC_ALL=C $(AWK) -f $(firstword $^) | LC_ALL=C sort;) \
989          echo ''; \
990          echo '#endif   /* gnu/lib-names.h */'; \
991         } >  ${@:stmp=T}
992         $(move-if-change) ${@:stmp=T} ${@:stmp=h}
993         touch $@
994 endif
996 common-generated += gnu/lib-names.h gnu/lib-names.stmp
998 # The name under which the run-time dynamic linker is installed.
999 # We are currently going for the convention that `/lib/ld.so.1'
1000 # names the SVR4/ELF ABI-compliant dynamic linker.
1001 ifndef rtld-installed-name
1002 ifdef ld.so-version
1003 rtld-installed-name = $(ld.so-version)
1004 else
1005 rtld-installed-name = ld.so.1
1006 endif
1007 endif
1009 ifndef rtld-version-installed-name
1010 rtld-version-installed-name = ld-$(version).so
1011 endif
1013 endif # build-shared
1016 ifeq ($(build-shared),yes)
1017 libdl = $(common-objpfx)dlfcn/libdl.so$(libdl.so-version)
1018 else
1019 libdl = $(common-objpfx)dlfcn/libdl.a
1020 endif
1022 ifeq ($(build-shared),yes)
1023 libm = $(common-objpfx)math/libm.so$(libm.so-version)
1024 else
1025 libm = $(common-objpfx)math/libm.a
1026 endif
1028 # These are the subdirectories containing the library source.  The order
1029 # is more or less arbitrary.  The sorting step will take care of the
1030 # dependencies.
1031 all-subdirs = csu assert ctype locale intl catgets math setjmp signal       \
1032               stdlib stdio-common libio malloc string wcsmbs time dirent    \
1033               grp pwd posix io termios resource misc socket sysvipc gmon    \
1034               gnulib iconv iconvdata wctype manual shadow gshadow po argp   \
1035               crypt localedata timezone rt conform debug                    \
1036               $(add-on-subdirs) dlfcn elf
1038 ifndef avoid-generated
1039 # sysd-sorted itself will contain rules making the sysd-sorted target
1040 # depend on Depend files.  But if you just added a Depend file to an
1041 # existing directory not in all-subdirs, then sysd-sorted needs to
1042 # be regenerated, so it depends on existing $(sorted-subdirs:=/Depend) files.
1043 all-Depend-files := $(wildcard $(sort \
1044                         $(foreach dir,$(all-subdirs),\
1045                                   $(firstword $($(dir)-srcdir) \
1046                                   $(..)$(dir))/Depend) \
1047                         $(sorted-subdirs:=/Depend)))
1048 $(common-objpfx)sysd-sorted: $(..)scripts/gen-sorted.awk \
1049                              $(common-objpfx)config.make $(..)Makeconfig \
1050                              $(wildcard $(sysdirs:=/Subdirs)) \
1051                              $(all-Depend-files)
1052         $(AWK) -f $< \
1053                -v subdirs='$(all-subdirs)' \
1054                -v srcpfx='$(..)' \
1055                $(filter %/Subdirs %/Depend,$^) > $@-tmp
1056         mv -f $@-tmp $@
1057 $(all-Depend-files): ;
1058 endif
1060 # This gives partial TARGET:SOURCE pattern pairs to have rules
1061 # emitted into sysd-rules.  A sysdeps Makeconfig fragment can
1062 # add its own special object file prefix to this list with e.g. foo-%:%
1063 # to have foo-*.? compiled from *.? using $(foo-CPPFLAGS).
1064 sysd-rules-patterns := %:% rtld-%:rtld-% rtld-%:% m_%:s_%
1066 # Let sysdeps/ subdirs contain a Makeconfig fragment for us to include here.
1067 sysdep-makeconfigs := $(wildcard $(+sysdep_dirs:=/Makeconfig))
1068 ifneq (,$(sysdep-makeconfigs))
1069 include $(sysdep-makeconfigs)
1070 endif
1072 # Compute just the target patterns.  Makeconfig has set sysd-rules-patterns.
1073 sysd-rules-targets := $(sort $(foreach p,$(sysd-rules-patterns),\
1074                                          $(firstword $(subst :, ,$p))))
1076 # A sysdeps Makeconfig fragment may set libc-reentrant to yes.
1077 ifeq (yes,$(libc-reentrant))
1078 defines += -D_LIBC_REENTRANT
1080 libio-mtsafe = -D_IO_MTSAFE_IO
1081 endif
1083 endif # Makeconfig not yet included
1085 # Local Variables:
1086 # mode: makefile
1087 # End: