1 # Copyright (C) 1991-1999,2000,01,02 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, write to the Free
16 # Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
20 # Common rules for making the GNU C library. This file is included
21 # by the top-level Makefile and by all subdirectory makefiles
25 This makefile requires GNU Make.
28 REQUIRED_MAKE_VERSION = 3.74
29 REAL_MAKE_VERSION = $(firstword $(MAKE_VERSION))
31 ifneq ($(REQUIRED_MAKE_VERSION), \
32 $(firstword $(sort $(REAL_MAKE_VERSION) $(REQUIRED_MAKE_VERSION))))
33 Wrong GNU Make version. See above for the version needed.
41 # If `sources' was defined by the parent makefile, undefine it so
42 # we will later get it from wildcard search in this directory.
43 ifneq "$(findstring env,$(origin sources))" ""
48 PATH := this definition should take precedence over $(oPATH)
49 ifeq ($(PATH),$(oPATH))
50 You must not use the -e flag when building the GNU C library.
55 ifndef +included-Makeconfig
56 include $(..)Makeconfig
59 # `configure' writes a definition of `config-sysdirs' in `config.make'.
60 sysdirs = $(strip $(full_config_sysdirs))
62 +sysdir_pfx = $(common-objpfx)
64 export sysdirs := $(sysdirs)
66 +sysdep_dirs := $(full_config_sysdirs)
68 +sysdep_dirs := $(objdir) $(+sysdep_dirs)
71 # Add -I switches to get the right sysdep directories.
72 # `+includes' in Makeconfig references $(+sysdep-includes).
73 +sysdep-includes := $(addprefix -I,$(+sysdep_dirs))
75 # This variable is used in ``include $(o-iterator)'' after defining
76 # $(o-iterator-doit) to produce some desired rule using $o for the object
77 # suffix, and setting $(object-suffixes-left) to $(object-suffixes); a copy
78 # is produced for each object suffix in use.
79 o-iterator = $(patsubst %,$(..)o-iterator.mk,$(object-suffixes-left))
81 # Include any system-specific makefiles.
83 # This is here so things in sysdep Makefiles can easily depend on foo.h as
84 # appropriate and not worry about where foo.h comes from, which may be
85 # system dependent and not known by that Makefile.
86 vpath %.h $(subst $(empty) ,:,$(strip $(common-objpfx) $(objpfx) \
87 $(+sysdep_dirs) $(..)))
89 # The same is true for RPC source files.
90 vpath %.x $(subst $(empty) ,:,$(strip $(common-objpfx) $(objpfx) \
91 $(+sysdep_dirs) $(..)))
93 # Some sysdep makefiles use this to distinguish being included here from
94 # being included individually by a subdir makefile (hurd/Makefile needs this).
97 sysdep-makefiles := $(wildcard $(full_config_sysdirs:=/Makefile))
98 ifneq (,$(sysdep-makefiles))
99 include $(sysdep-makefiles)
103 # Reorder before-compile so that mach things come first, and hurd things
104 # second, before all else. The mach and hurd subdirectories have many
105 # generated header files which the much of rest of the library depends on,
106 # so it is best to build them first (and mach before hurd, at that).
107 before-compile := $(filter $(common-objpfx)mach% $(common-objpfx)hurd%,\
109 $(filter-out $(common-objpfx)mach% $(common-objpfx)hurd%,\
112 # Even before that, we need abi-versions.h which is generated right here.
113 ifeq ($(versioning),yes)
114 ifndef avoid-generated
115 before-compile := $(common-objpfx)abi-versions.h $(before-compile)
116 $(common-objpfx)abi-versions.h: $(..)scripts/abi-versions.awk \
117 $(common-objpfx)Versions.all
118 LC_ALL=C $(AWK) -v oldest_abi=$(oldest-abi) -f $^ > $@T
121 $(common-objpfx)%.latest: $(common-objpfx)abi-versions.h
122 sed -n '/ VERSION_$*_/{s/^.*_\([A-Z0-9_]*\).*$$/\1/;h;};$${g;p;}' \
123 $(common-objpfx)abi-versions.h > $@T
125 endif # avoid-generated
126 endif # $(versioning) = yes
129 # Remove existing files from `before-compile'. Things are added there when
130 # they must exist for dependency generation to work right, but once they
131 # exist there is no further need for every single file to depend on them,
132 # and those gratuitous dependencies result in many gratuitous
134 before-compile := $(filter-out $(wildcard $(before-compile)),$(before-compile))
136 # Don't let any before-compile file be an intermediate and get removed.
141 # Generate an ordered list of implicit rules which find the source files in
142 # each sysdep directory. The old method was to use vpath to search all the
143 # sysdep directories. However, that had the problem that a .S file in a
144 # later directory would be chosen over a .c file in an earlier directory,
145 # which does not preserve the desired sysdeps ordering behavior.
147 # When making the list of .d files to include, we can't know which ones
148 # have source in .s files, and thus do not in fact need a .d file.
149 # So we must define rules to make .d files for .s files.
150 define make-dummy-dep
151 $(addprefix ln $(common-objpfx)dummy.d ,$(filter-out $(wildcard $@),$@))
153 $(common-objpfx)dummy.d:
154 echo '# .s files cannot contain includes, so they need no deps.' > $@
156 # It matters that this set of rules, for compiling from sources in
157 # the current directory (the $srcdir/$subdir) come before the
158 # generated sysdep rules in included from sysd-rules below. When
159 # compiling in the source tree, generated sources go into the current
160 # directory, and those should be chosen before any sources in sysdeps.
161 define o-iterator-doit
162 $(objpfx)%$o: %.S $(before-compile); $$(compile-command.S)
164 object-suffixes-left := $(all-object-suffixes)
165 include $(o-iterator)
166 $(objpfx)%.d: %.S $(before-compile); $(+make-deps)
168 define o-iterator-doit
169 $(objpfx)%$o: %.s $(before-compile); $$(compile-command.s)
171 object-suffixes-left := $(all-object-suffixes)
172 include $(o-iterator)
173 $(objpfx)%.d: %.s $(common-objpfx)dummy.d; $(make-dummy-dep)
175 define o-iterator-doit
176 $(objpfx)%$o: %.c $(before-compile); $$(compile-command.c)
178 object-suffixes-left := $(all-object-suffixes)
179 include $(o-iterator)
180 $(objpfx)%.d: %.c $(before-compile); $(+make-deps)
182 # Omit the objpfx rules when building in the source tree, because
183 # objpfx is empty and so these rules just override the ones above.
185 # Define first rules to find the source files in $(objpfx).
186 # Generated source files will end up there.
187 define o-iterator-doit
188 $(objpfx)%$o: $(objpfx)%.S $(before-compile); $$(compile-command.S)
190 object-suffixes-left := $(all-object-suffixes)
191 include $(o-iterator)
192 $(objpfx)%.d: $(objpfx)%.S $(before-compile); $(+make-deps)
194 define o-iterator-doit
195 $(objpfx)%$o: $(objpfx)%.s $(before-compile); $$(compile-command.s)
197 object-suffixes-left := $(all-object-suffixes)
198 include $(o-iterator)
199 $(objpfx)%.d: $(objpfx)%.s $(common-objpfx)dummy.d; $(make-dummy-dep)
201 define o-iterator-doit
202 $(objpfx)%$o: $(objpfx)%.c $(before-compile); $$(compile-command.c)
204 object-suffixes-left := $(all-object-suffixes)
205 include $(o-iterator)
206 $(objpfx)%.d: $(objpfx)%.c $(before-compile); $(+make-deps)
209 # System-dependent makefiles can put in `inhibit-sysdep-asm' wildcard
210 # patterns matching sysdep directories whose assembly source files should
212 ifdef inhibit-sysdep-asm
213 define open-check-inhibit-asm
214 case $$sysdir in $(subst $(empty) ,|,$(inhibit-sysdep-asm))) : ;; *)
216 close-check-inhibit-asm = ;; esac ;
219 -include $(+sysdir_pfx)sysd-rules
220 ifneq ($(sysd-rules-sysdirs),$(config-sysdirs))
221 # The value of $(+sysdep_dirs) the sysd-rules was computed for
222 # differs from the one we are using now. So force a rebuild of sysd-rules.
223 sysd-rules-force = FORCE
226 $(+sysdir_pfx)sysd-rules: $(+sysdir_pfx)config.make $(..)Makerules \
227 $(wildcard $(foreach dir,$(sysdirs),\
231 (echo 'sysd-rules-sysdirs := $(config-sysdirs)'; \
232 for dir in $(config-sysdirs:%='$$(..)%'); do \
233 for o in $(all-object-suffixes); do \
234 $(open-check-inhibit-asm) \
235 echo "\$$(objpfx)%$$o: $$dir/%.S \$$(before-compile); \
236 \$$(compile-command.S)"; \
237 echo "\$$(objpfx)%$$o: $$dir/%.s \$$(before-compile); \
238 \$$(compile-command.s)"; \
239 $(close-check-inhibit-asm) \
240 echo "\$$(objpfx)%$$o: $$dir/%.c \$$(before-compile); \
241 \$$(compile-command.c)"; \
243 $(open-check-inhibit-asm) \
244 echo "\$$(objpfx)%.d: $$dir/%.s \$$(common-objpfx)dummy.d; \
245 \$$(make-dummy-dep)"; \
246 echo "\$$(objpfx)%.d: $$dir/%.S \$$(before-compile); \
248 $(close-check-inhibit-asm) \
249 echo "\$$(objpfx)%.d: $$dir/%.c \$$(before-compile); \
252 echo 'sysd-rules-done = t') > $@T
255 ifndef sysd-rules-done
256 # Don't do deps until this exists, because it provides rules to make the deps.
260 # Generate version maps, but wait until sysdep-subdirs is known
261 ifeq ($(sysd-sorted-done),t)
262 ifeq ($(versioning),yes)
263 -include $(common-objpfx)sysd-versions
264 $(addprefix $(common-objpfx),$(version-maps)): $(common-objpfx)sysd-versions
265 common-generated += $(version-maps)
266 postclean-generated += sysd-versions Versions.all abi-versions.h \
267 Versions.def.v.i Versions.def.v Versions.v.i Versions.v
269 ifndef avoid-generated
270 ifneq ($(sysd-versions-subdirs),$(all-subdirs) $(config-sysdirs))
271 sysd-versions-force = FORCE
274 # See %.v/%.v.i implicit rules in Makeconfig.
275 $(common-objpfx)Versions.def.v.i: $(..)Versions.def \
276 $(wildcard $(add-ons:%=$(..)%/Versions.def))
277 $(common-objpfx)Versions.all: $(..)scripts/firstversions.awk \
278 $(common-objpfx)soversions.i \
279 $(common-objpfx)Versions.def.v
280 { while read lib version setname; do \
281 test -z "$$setname" || echo "$$lib : $$setname"; \
282 done < $(word 2,$^); \
284 } | LC_ALL=C $(AWK) -f $< > $@T
286 # See %.v/%.v.i implicit rules in Makeconfig.
287 $(common-objpfx)Versions.v.i: $(wildcard $(all-subdirs:%=$(..)%/Versions)) \
288 $(wildcard $(sysdirs:%=%/Versions)) \
289 $(common-objpfx)abi-versions.h \
290 $(sysd-versions-force)
291 $(common-objpfx)sysd-versions: $(common-objpfx)Versions.all \
292 $(common-objpfx)Versions.v \
293 $(..)scripts/versions.awk
294 ( echo 'sysd-versions-subdirs = $(all-subdirs) $(config-sysdirs)' ; \
296 | LC_ALL=C $(AWK) -v buildroot=$(common-objpfx) -v defsfile=$< \
297 -v move_if_change='$(move-if-change)' \
301 endif # avoid-generated
302 endif # $(versioning) = yes
303 endif # sysd-sorted-done
306 ifndef compile-command.S
307 compile-command.S = $(compile.S) $(OUTPUT_OPTION)
309 ifndef compile-command.s
310 compile-command.s = $(COMPILE.s) $< $(OUTPUT_OPTION)
312 ifndef compile-command.c
313 compile-command.c = $(compile.c) $(OUTPUT_OPTION)
316 # GCC can grok options after the file name, and it looks nicer that way.
317 compile.c = $(CC) $< -c $(CFLAGS) $(CPPFLAGS)
319 $(CC) $< -c $(CPPFLAGS) -DASSEMBLER $(asm-CPPFLAGS) $(ASFLAGS-$(suffix $@))
321 $(CC) -c $(CPPFLAGS) -DASSEMBLER $(asm-CPPFLAGS) $(ASFLAGS-$(suffix $@))
322 COMPILE.s = $(filter-out -pipe,$(CC)) -c $(ASFLAGS)
324 # If we want to generate MD5 checksums for the sources do this now.
326 generate-md5 = ; rm -f $(@:.d=.md5); \
327 $(CC) -E $< $(CFLAGS) $(CPPFLAGS) $($(<:$*.%=%)-CPPFLAGS) | \
328 sed '/^\#/d;/^[[:space:]]*$$/d' | md5sum > $(@:.d=.md5)
333 # We need this for the output to go in the right place. It will default to
334 # empty if make was configured to work with a cc that can't grok -c and -o
335 # together. You can't compile the C library with such a compiler.
336 OUTPUT_OPTION = -o $@
338 S-CPPFLAGS = $(asm-CPPFLAGS)
340 $(make-target-directory)
342 $(+mkdep) $< $(CFLAGS) $(CPPFLAGS) $($(<:$*.%=%)-CPPFLAGS) | \
344 -e 's,$(subst .,\.,$*)\.o,$(foreach o,$(all-object-suffixes),$(@:.d=$o)) $@,' \
345 $(sed-remove-objpfx) > $(@:.d=.T)
346 mv -f $(@:.d=.T) $@ $(generate-md5)
349 # Continuation lines here are dangerous because they introduce spaces!
350 define sed-remove-objpfx
351 -e 's@ $(subst .,\.,$(subst @,\@,$(common-objpfx)))@ $$(common-objpfx)@g' \
352 -e 's@^$(subst .,\.,$(subst @,\@,$(common-objpfx)))@$$(common-objpfx)@g'
356 # Modify the list of routines we build for different targets
358 ifeq (yesyes,$(build-shared)$(elf))
359 ifndef libc.so-version
360 # Undefine this because it can't work when we libc.so is unversioned.
361 static-only-routines =
365 # Bounded pointer thunks are only built for *.ob
366 elide-bp-thunks = $(addprefix $(bppfx),$(bp-thunks))
368 elide-routines.oS += $(filter-out $(static-only-routines),\
369 $(routines) $(aux) $(sysdep_routines)) \
371 elide-routines.os += $(static-only-routines) $(elide-bp-thunks)
373 # If we have versioned code we don't need the old versions in any of the
375 elide-routines.o += $(shared-only-routines) $(elide-bp-thunks)
376 elide-routines.op += $(shared-only-routines) $(elide-bp-thunks)
377 elide-routines.og += $(shared-only-routines) $(elide-bp-thunks)
378 elide-routines.ob += $(shared-only-routines)
380 # Shared library building.
382 ifeq (yes,$(build-shared))
384 # Reference map file only when versioning is selected and a map file name
386 ifeq ($(versioning),yes)
387 map-file = $(firstword $($(@F:.so=-map)) \
388 $(addprefix $(common-objpfx), \
389 $(filter $(@F:.so=.map),$(version-maps))))
390 load-map-file = $(map-file:%=-Wl,--version-script=%)
393 # Pattern rule to build a shared object from an archive of PIC objects.
394 # This must come after the installation rules so Make doesn't try to
395 # build shared libraries in place from the installed *_pic.a files.
396 # $(LDLIBS-%.so) may contain -l switches to generate run-time dependencies
397 # on other shared objects.
398 lib%.so: lib%_pic.a $(+preinit) $(+postinit) $(+interp)
399 ifneq (,$(findstring aix,$(config-os)))
401 dump -g $< | sed '1,6d' | cut -f2 | sort | uniq) > $(<:a=exp)
406 define build-shlib-helper
407 $(LINK.o) -shared $(static-libgcc) -Wl,-O1 $(sysdep-LDFLAGS) $(config-LDFLAGS) \
408 $(extra-B-$(@F:lib%.so=%).so) -B$(csu-objpfx) \
409 $(extra-B-$(@F:lib%.so=%).so) $(load-map-file) \
410 -Wl,-soname=lib$(libprefix)$(@F:lib%.so=%).so$($(@F)-version) \
411 $(LDFLAGS.so) $(LDFLAGS-$(@F:lib%.so=%).so) \
412 -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link)
415 ifneq (,$(findstring aix,$(config-os)))
416 define build-shlib-helper
417 $(LINK.o) -Wl,-G,-bM:SRE,-bnoentry,-bE:$(<:a=exp) \
418 $(sysdep-LDFLAGS) $(config-LDFLAGS) $(extra-B-$(@F:lib%.so=%).so) \
419 $(extra-B-$(@F:lib%.so=%).so) $(load-map-file) \
420 $(LDFLAGS.so) $(LDFLAGS-$(@F:lib%.so=%).so) \
421 -L$(subst :, -L,$(rpath-link))
428 # binutils only position loadable notes into the first page for binaries,
429 # not for shared objects
431 $(build-shlib-helper) \
432 -o $@.new $(csu-objpfx)abi-note.o -Wl,--verbose \
433 $(LDLIBS-$(@F:lib%.so=%).so) 2>&1 | \
434 sed -e '/^=========/,/^=========/!d;/^=========/d' \
435 -e 's/^.*\.hash[ ]*:.*$$/ .note.ABI-tag : { *(.note.ABI-tag) } &/' \
438 $(build-shlib-helper) -o $@ -T $@.lds \
439 $(csu-objpfx)abi-note.o $(build-shlib-objlist)
443 ifneq (,$(findstring aix,$(config-os)))
445 $(build-shlib-helper) \
447 $(filter-out $(map-file) $(+preinit) $(+postinit),$^) \
448 $(no-whole-archive) $(LDLIBS-$(@F:lib%.so=%).so)
451 $(build-shlib-helper) \
452 $(build-shlib-objlist)
457 ifneq (,$(findstring aix,$(config-os)))
458 define build-module-helper
459 $(LINK.o) -Wl,-G -Wl,-bM:SRE -Wl,-bnoentry -Wl,-bexpall \
460 $(sysdep-LDFLAGS) $(config-LDFLAGS) \
462 $(LDFLAGS.so) $(LDFLAGS-$(@F:%.so=%).so) \
463 -L$(subst :, -L,$(rpath-link)) -Wl,-L=$(rpath-link)
466 define build-module-helper
467 $(LINK.o) -shared $(static-libgcc) $(sysdep-LDFLAGS) $(config-LDFLAGS) \
468 -B$(csu-objpfx) $(load-map-file) \
469 $(LDFLAGS.so) $(LDFLAGS-$(@F:%.so=%).so) \
470 -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link)
474 # This macro is similar to build-shlib but it does not define a soname
475 # and it does not depend on the destination name to start with `lib'.
477 # binutils only position loadable notes into the first page for binaries,
478 # not for shared objects
480 $(build-module-helper) \
481 -o $@.new $(csu-objpfx)abi-note.o -Wl,--verbose \
482 $(LDLIBS-$(@F:lib%.so=%).so) 2>&1 | \
483 sed -e '/^=========/,/^=========/!d;/^=========/d' \
484 -e 's/^.*\.hash[ ]*:.*$$/ .note.ABI-tag : { *(.note.ABI-tag) } &/' \
487 $(build-module-helper) -o $@ -T $@.lds \
488 $(csu-objpfx)abi-note.o $(build-module-objlist)
492 ifneq (,$(findstring aix,$(config-os)))
494 $(build-module-helper) \
496 $(filter-out $(map-file) $(+preinit) $(+postinit),$^) \
497 $(no-whole-archive) $(LDLIBS-$(@F:%.so=%).so)
502 $(build-module-helper) \
504 $(build-module-objlist)
509 build-module-helper-objlist = \
510 $(patsubst %_pic.a,$(whole-archive) %_pic.a $(no-whole-archive),\
511 $(filter-out $(map-file) $(+preinit) $(+postinit),$^))
512 whole-archive := -Wl,--whole-archive
514 build-module-objlist = $(build-module-helper-objlist) $(LDLIBS-$(@F:%.so=%).so)
515 build-shlib-objlist = $(build-module-helper-objlist) \
516 $(LDLIBS-$(@F:lib%.so=%).so)
518 # Don't try to use -lc when making libc.so itself.
519 # Also omits crti.o and crtn.o, which we do not want
520 # since we define our own `.init' section specially.
521 LDFLAGS-c.so = -nostdlib -nostartfiles
522 # But we still want to link libc.so against $(gnulib).
523 LDLIBS-c.so += $(gnulib)
524 # Give libc.so an entry point and make it directly runnable itself.
525 LDFLAGS-c.so += -e __libc_main
526 # Force the backward compatibility EH functions to be linked.
527 LDFLAGS-c.so += -u __register_frame
528 # Pre-link the objects of libc_pic.a so that we can locally resolve
529 # COMMON symbols before we link against ld.so. This is because ld.so
530 # contains some of libc_pic.a already, which will prevent the COMMONs
531 # from being allocated in libc.so, which introduces evil dependencies
532 # between libc.so and ld.so, which can make it impossible to upgrade.
534 $(common-objpfx)libc_pic.os: $(common-objpfx)libc_pic.a
535 $(LINK.o) -nostdlib -nostartfiles -r -o $@ \
536 $(LDFLAGS-c_pic.os) -Wl,-d -Wl,--whole-archive $^
537 # Use our own special initializer and finalizer files for libc.so.
538 $(common-objpfx)libc.so: $(elfobjdir)/soinit.os \
539 $(common-objpfx)libc_pic.os \
540 $(elfobjdir)/sofini.os \
541 $(elfobjdir)/interp.os $(elfobjdir)/ld.so
543 ifeq ($(versioning),yes)
544 $(common-objpfx)libc.so: $(common-objpfx)libc.map
546 common-generated += libc.so libc_pic.os
547 ifdef libc.so-version
548 $(common-objpfx)libc.so$(libc.so-version): $(common-objpfx)libc.so
550 common-generated += libc.so$(libc.so-version)
554 ifneq (,$(findstring aix,$(config-os)))
555 $(common-objpfx)libc.so: $(common-objpfx)libc_pic.a
558 dump -g $^ | sed '1,6d' | cut -f2 | sort | uniq) > $(^:a=exp)
559 sed '/__mulh/d;/__mull/d;/__divss/d;/__divus/d;/__quoss/d;/__quous/d' \
560 /lib/syscalls.exp > $(common-objpfx)syscalls.exp
561 $(LINK.o) -G -bM:SRE -bnoentry -bE:$(^:a=exp) \
562 -bE:$(common-objpfx)syscalls.exp \
563 -bI:$(common-objpfx)syscalls.exp \
564 -L$(common-objpfx) -o $@ $^
565 # AIX runtime ld wants libc.so to be libc.a(shr.o) hardwired
566 cp $@ $(common-objpfx)shr.o
567 $(AR) $(ARFLAGS) $(common-objpfx)libc.a $(common-objpfx)shr.o
571 # Figure out the source filenames in this directory.
573 override sources := $(addsuffix .c,\
574 $(filter-out $(elided-routines),\
577 sysdep_routines := $(sysdep_routines)
579 headers := $(headers) $(sysdep_headers)
581 # This is the list of all object files, gotten by
582 # replacing every ".c" in `sources' with a ".o".
583 # We also add bounded-pointer thunks, which are later
584 # elided for all suffixes except for `.ob'.
585 override objects := $(addprefix $(objpfx),$(sources:.c=.o) \
586 $(patsubst %,$(bppfx)%.o,\
587 $(filter $(routines) $(sysdep_routines),$(bp-thunks))))
590 # The makefile may define $(extra-libs) with `libfoo libbar'
591 # to build libfoo.a et al from the modules listed in $(libfoo-routines).
593 # extra-lib.mk is included once for each extra lib to define rules
594 # to build it, and to add its objects to the various variables.
595 # During its evaluation, $(lib) is set to the name of the library.
596 extra-libs-left := $(extra-libs)
597 include $(patsubst %,$(..)extra-lib.mk,$(extra-libs))
600 +depfiles := $(sources:.c=.d) \
601 $(patsubst %.o,%.d,$(filter %.o,$(extra-objs:.os=.o))) \
602 $(addsuffix .d,$(tests) $(xtests) $(test-srcs))
603 ifeq ($(build-programs),yes)
604 +depfiles += $(addsuffix .d,$(others) $(sysdep-others))
606 +depfiles := $(addprefix $(objpfx),\
607 $(filter-out $(addsuffix .d,$(omit-deps)),\
612 -include $(+depfiles)
616 # Maximize efficiency by minimizing the number of rules.
617 .SUFFIXES: # Clear the suffix list. We don't use suffix rules.
618 # Don't define any builtin rules.
619 MAKEFLAGS := $(MAKEFLAGS)r
621 # Generic rule for making directories.
623 # mkdir isn't smart enough to strip a trailing /.
626 # Make sure that object files are not removed
627 # when they are intermediates between sources and library members.
628 .PRECIOUS: $(addprefix $(objpfx)%,$(all-object-suffixes))
630 # Make sure that the parent library archive is never removed.
631 .PRECIOUS: $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
633 # Use the verbose option of ar and tar when not running silently.
634 ifeq "$(findstring s,$(MAKEFLAGS))" "" # if not -s
640 ARFLAGS := r$(verbose)
641 CREATE_ARFLAGS := cru$(verbose)
643 # This makes all the object files in the parent library archive.
645 .PHONY: lib lib-noranlib
646 lib: lib-noranlib $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
647 lib-noranlib: libobjs
649 # For object-suffix $o, the list of objects with that suffix.
650 # Makefiles can define `elide-routines.so = foo' to leave foo.so out.
651 o-objects = $(patsubst %.o,%$o,$(filter-out $(patsubst %,$(objpfx)%.o,\
652 $(elide-routines$o)),\
654 $(addprefix $(objpfx),$(o-objects$o))
656 others: $(addprefix $(objpfx),$(install-lib))
660 # Create the stamp$o files to keep the parent makefile happy.
661 subdir_lib: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
662 $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o):
663 $(make-target-directory)
667 # Define explicit rules to update each $(objpfx)stamp.SUFFIX
668 # timestamp file; these rules (one explicit rule is generated for each
669 # object suffix) write a list of objects to update in the stamp file.
670 # The parent will then actually add them all to the archive in the
671 # archive rule, below.
672 define o-iterator-doit
673 $(objpfx)stamp$o: $(o-objects); $$(do-stamp)
676 echo '$(patsubst $(objpfx)%,$(addsuffix /,$(subdir))%,$^)' > $@T
679 object-suffixes-left := $(object-suffixes-for-libc)
680 include $(o-iterator)
684 # Now define explicit rules to build the library archives; these depend
685 # on the stamp files built above.
686 define o-iterator-doit
687 $(common-objpfx)$(patsubst %,$(libtype$o),c): \
688 $(subdirs-stamp-o) $(common-objpfx)stamp$o; $$(do-makelib)
691 cd $(common-objdir) && \
692 $(AR) $(CREATE_ARFLAGS) $(@F) `cat $(patsubst $(common-objpfx)%,%,$^)`
695 subdirs-stamps := $(foreach d,$(subdirs),$(common-objpfx)$d/stamp%)
696 subdirs-stamp-o = $(subst %,$o,$(subdirs-stamps))
698 $(subdirs-stamps): subdir_lib;
700 object-suffixes-left = $(object-suffixes-for-libc)
701 include $(o-iterator)
704 # This makes all the object files.
705 .PHONY: objects objs libobjs extra-objs
706 objects objs: libobjs extra-objs
707 libobjs: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
708 extra-objs: $(addprefix $(objpfx),$(extra-objs))
710 # Canned sequence for building an extra library archive.
711 define build-extra-lib
712 $(patsubst %/,cd % &&,$(objpfx)) \
713 $(AR) $(CREATE_ARFLAGS) $(@:$(objpfx)%=%) \
714 $(patsubst $(objpfx)%,%,$^)
720 .PHONY: force-install
723 # $(install-lib) are installed from the object directory into $(libdir);
724 # files in $(install-lib) matching `lib%.a' are ranlib'd after installation
725 # unless they also appear in $(non-lib.a). $(install-data) are installed
726 # as they are into $(datadir). $(headers) are installed as they are in
727 # $(includedir). $(install-bin), $(install-bin-script) and $(install-sbin)
728 # are installed from the object directory into $(bindir), $(bindir) and
729 # $(sbindir), respectively. $(install-others) are absolute path names of
730 # files to install; rules to install them are defined elsewhere.
732 # The simple library name to install libc.a under.
733 # This could be defined by a sysdep Makefile.
739 $(make-target-directory)
740 $(INSTALL_DATA) $< $@
743 # Make the target directory if it doesn't exist, using the `mkinstalldirs'
744 # script that does `mkdir -p' even if `mkdir' doesn't support that flag.
745 define make-target-directory
746 $(addprefix $(..)./scripts/mkinstalldirs ,\
747 $(filter-out $(wildcard $(@D:%/=%)),$(@D:%/=%)))
750 # Any directory (parent or subdir) should install libc.a; this way
751 # "make install" in a subdir is guaranteed to install everything it changes.
752 installed-libcs := $(foreach o,$(filter-out .os,$(object-suffixes-for-libc)),\
753 $(inst_libdir)/$(patsubst %,$(libtype$o),\
754 $(libprefix)$(libc-name)))
755 install: $(installed-libcs)
756 $(installed-libcs): $(inst_libdir)/lib$(libprefix)%: lib $(+force)
757 $(make-target-directory)
758 $(INSTALL_DATA) $(common-objpfx)lib$(*:$(libc-name)%=c%) $@
759 # Running ranlib after installing makes the __.SYMDEF time stamp up to
760 # date, which avoids messages from some linkers.
763 define do-install-program
764 $(make-target-directory)
765 $(INSTALL_PROGRAM) $< $@.new
769 define do-install-script
770 $(make-target-directory)
771 $(INSTALL_SCRIPT) $< $@.new
775 install-lib.so := $(filter %.so,$(install-lib:%_pic.a=%.so))
776 install-lib := $(filter-out %.so %_pic.a,$(install-lib))
778 ifeq (yes,$(build-shared))
779 # Find which .so's have versions.
780 versioned := $(strip $(foreach so,$(install-lib.so),\
781 $(patsubst %,$(so),$($(so)-version))))
783 install-lib.so-versioned := $(filter $(versioned), $(install-lib.so))
784 install-lib.so-unversioned := $(filter-out $(versioned), $(install-lib.so))
786 install-lib-nosubdir: $(install-lib.so-versioned:%=$(inst_libdir)/%) \
787 $(install-lib.so-unversioned:%=$(inst_slibdir)/%)
789 # Install all the unversioned shared libraries.
790 $(install-lib.so-unversioned:%=$(inst_slibdir)/%): $(inst_slibdir)/%.so: \
791 $(objpfx)%.so $(+force)
792 $(do-install-program)
794 ifneq ($(findstring -s,$(LN_S)),)
797 $(SHELL) $(..)scripts/rellns-sh $< $@.new
801 # If we have no symbolic links don't bother with rellns-sh.
809 ifeq (yes,$(build-shared))
810 ifeq (no,$(cross-compiling))
811 symbolic-link-prog := $(common-objpfx)elf/sln
812 symbolic-link-list := $(common-objpfx)elf/symlink.list
813 define make-shlib-link
814 echo $(<F) $@ >> $(symbolic-link-list)
816 else # cross-compiling
817 # We need a definition that can be used by elf/Makefile's install rules.
818 symbolic-link-prog = $(LN_S)
821 ifndef make-shlib-link
822 define make-shlib-link
828 ifdef libc.so-version
829 # For a library specified to be version N, install three files:
830 # libc.so -> libc.so.N (e.g. libc.so.6)
831 # libc.so.6 -> libc-VERSION.so (e.g. libc-1.10.so)
833 $(inst_slibdir)/libc.so$(libc.so-version): $(inst_slibdir)/libc-$(version).so \
836 $(inst_slibdir)/libc-$(version).so: $(common-objpfx)libc.so $(+force)
837 $(do-install-program)
838 install: $(inst_slibdir)/libc.so$(libc.so-version)
841 # What we install as libc.so for programs to link against is in fact a
842 # link script. It contains references for the various libraries we need.
843 # The libc.so object is not complete since some functions are only defined
844 # in libc_nonshared.a.
845 # We need to use absolute paths since otherwise local copies (if they exist)
846 # of the files are taken by the linker.
847 install: $(inst_libdir)/libc.so
848 $(inst_libdir)/libc.so: $(common-objpfx)libc.so$(libc.so-version) \
849 $(inst_libdir)/$(patsubst %,$(libtype.oS),\
850 $(libprefix)$(libc-name)) \
852 (echo '/* GNU ld script';\
853 echo ' Use the shared library, but some functions are only in';\
854 echo ' the static library, so try that secondarily. */';\
855 echo 'GROUP ( $(slibdir)/libc.so$(libc.so-version)' \
856 '$(libdir)/$(patsubst %,$(libtype.oS),$(libprefix)$(libc-name))'\
864 install: $(inst_slibdir)/libc.so
865 $(inst_slibdir)/libc.so: $(common-objpfx)libc.so $(+force)
866 $(do-install-program)
869 ifneq (,$(versioned))
870 # Produce three sets of rules as above for all the smaller versioned libraries.
872 define o-iterator-doit
873 $(inst_libdir)/$o: $(inst_slibdir)/$o$($o-version) $(+force); $$(make-link)
875 object-suffixes-left := $(versioned)
876 include $(o-iterator)
878 # Make symlinks in the build directory, because the versioned names might
879 # be referenced by a DT_NEEDED in another library.
880 define o-iterator-doit
881 $(objpfx)$o$($o-version): $(objpfx)$o; $$(make-link)
883 object-suffixes-left := $(versioned)
884 include $(o-iterator)
886 generated += $(foreach o,$(versioned),$o$($o-version))
888 ifeq (,$($(subdir)-version))
889 define o-iterator-doit
890 $(inst_slibdir)/$o$($o-version): $(inst_slibdir)/$(o:.so=)-$(version).so \
894 object-suffixes-left := $(versioned)
895 include $(o-iterator)
897 define o-iterator-doit
898 $(inst_slibdir)/$(o:.so=)-$(version).so: $(objpfx)$o $(+force);
899 $$(do-install-program)
901 object-suffixes-left := $(versioned)
902 include $(o-iterator)
904 define o-iterator-doit
905 $(inst_slibdir)/$o$($o-version): \
906 $(inst_slibdir)/$(o:.so=)-$($(subdir)-version).so $(+force);
909 object-suffixes-left := $(versioned)
910 include $(o-iterator)
912 define o-iterator-doit
913 $(inst_slibdir)/$(o:.so=)-$($(subdir)-version).so: $(objpfx)$o $(+force);
914 $$(do-install-program)
916 object-suffixes-left := $(versioned)
917 include $(o-iterator)
922 $(do-install-program)
923 $(patsubst %,ln -s -f $(@F) $(@D)/$(patsubst %$*.so,%,$(<F))$(libprefix)$*.so,\
924 $(filter-out %.so,$@))
927 so-versions := $(sort $(foreach so,$(install-lib.so),.so$($(so)-version)))
928 $(foreach v,$(so-versions),\
929 $(inst_slibdir)/lib$(libprefix)%$v): $(common-objpfx)lib%.so \
932 $(foreach v,$(so-versions),\
933 $(inst_slibdir)/$(libprefix)%$v): $(common-objpfx)%.so $(+force)
938 $(addprefix $(inst_bindir)/,$(install-bin)): \
939 $(inst_bindir)/%: $(objpfx)% $(+force)
940 $(do-install-program)
942 ifdef install-bin-script
943 $(addprefix $(inst_bindir)/,$(install-bin-script)): \
944 $(inst_bindir)/%: $(objpfx)% $(+force)
947 ifdef install-rootsbin
948 $(addprefix $(inst_rootsbindir)/,$(install-rootsbin)): \
949 $(inst_rootsbindir)/%: $(objpfx)% $(+force)
950 $(do-install-program)
953 $(addprefix $(inst_sbindir)/,$(install-sbin)): \
954 $(inst_sbindir)/%: $(objpfx)% $(+force)
955 $(do-install-program)
958 install-lib.a := $(filter lib%.a,$(install-lib))
959 install-lib-non.a := $(filter-out lib%.a,$(install-lib))
960 ifdef install-lib-non.a
961 $(addprefix $(inst_libdir)/$(libprefix),$(install-lib-non.a)): \
962 $(inst_libdir)/$(libprefix)%: $(objpfx)% $(+force)
966 $(install-lib.a:lib%.a=$(inst_libdir)/lib$(libprefix)%.a): \
967 $(inst_libdir)/lib$(libprefix)%.a: $(objpfx)lib%.a $(+force)
969 $(patsubst %,$(RANLIB) $@,$(filter-out $(non-lib.a),$(<F)))
973 $(addprefix $(inst_datadir)/,$(install-data)): $(inst_datadir)/%: % $(+force)
976 headers := $(strip $(headers))
978 $(addprefix $(inst_includedir)/,$(headers)): $(inst_includedir)/%: % $(+force)
982 .PHONY: install-bin-nosubdir install-bin-script-nosubdir \
983 install-rootsbin-nosubdir install-sbin-nosubdir install-lib-nosubdir \
984 install-data-nosubdir install-headers-nosubdir
985 install-bin-nosubdir: $(addprefix $(inst_bindir)/,$(install-bin))
986 install-bin-script-nosubdir: $(addprefix $(inst_bindir)/,$(install-bin-script))
987 install-rootsbin-nosubdir: \
988 $(addprefix $(inst_rootsbindir)/,$(install-rootsbin))
989 install-sbin-nosubdir: $(addprefix $(inst_sbindir)/,$(install-sbin))
990 install-lib-nosubdir: $(addprefix $(inst_libdir)/,\
991 $(patsubst lib%.a,lib$(libprefix)%.a,$(install-lib.a)) \
992 $(addprefix $(libprefix),$(install-lib-non.a)))
993 install-data-nosubdir: $(addprefix $(inst_datadir)/,$(install-data))
994 install-headers-nosubdir: $(addprefix $(inst_includedir)/,$(headers))
995 install-others-nosubdir: $(install-others)
997 # We need all the `-nosubdir' targets so that `install' in the parent
998 # doesn't depend on several things which each iterate over the subdirs.
999 # This rule makes `install-FOO' always use `install-FOO-nosubdir' as a
1000 # subroutine. Then in the parent `install-FOO' also causes subdir makes.
1001 install-%:: install-%-nosubdir ;
1003 .PHONY: install install-no-libc.a-nosubdir
1004 ifeq ($(build-programs),yes)
1005 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir\
1006 install-bin-nosubdir install-bin-script-nosubdir \
1007 install-lib-nosubdir install-others-nosubdir \
1008 install-rootsbin-nosubdir install-sbin-nosubdir
1010 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir\
1011 install-lib-nosubdir install-others-nosubdir
1013 install: install-no-libc.a-nosubdir
1015 # Command to compile $< in $(objdir) using the native libraries.
1016 define native-compile
1017 $(make-target-directory)
1018 $(patsubst %/,cd % &&,$(objpfx)) \
1019 $(BUILD_CC) $($(basename $(<F))-CFLAGS) $(ALL_BUILD_CFLAGS) \
1020 $(firstword $(filter /%,$< $(shell pwd)/$<)) -o $(@F)
1023 # Command to compile $< in $(common-objdir) using the native libraries.
1024 # We must cd to $(objdir) anyway so that $(..)config.h is valid.
1025 define common-objdir-compile
1026 $(patsubst %/,cd % &&,$(objpfx)) \
1027 $(BUILD_CC) $($(basename $(<F))-CFLAGS) $(ALL_BUILD_CFLAGS) \
1028 $(firstword $(filter /%,$< $(shell pwd)/$<)) -o $(..)$(@F)
1031 # We always want to use configuration definitions.
1032 # Note that this is only used for commands running in $(objpfx).
1033 ALL_BUILD_CFLAGS = $(BUILD_CFLAGS) -include $(..)config.h
1035 # Support the GNU standard name for this target.
1038 # Special target to run tests which cannot be run unconditionally.
1039 # Maintainers should use this target.
1043 all-nonlib = $(strip $(tests) $(xtests) $(test-srcs) $(others))
1044 ifneq (,$(all-nonlib))
1045 cpp-srcs-left = $(all-nonlib:=.c)
1047 include $(patsubst %,$(..)cppflags-iterator.mk,$(all-nonlib))
1051 TAGS: $(objpfx)distinfo $(..)MakeTAGS
1052 $(MAKE) $(addprefix -f ,$^) $@
1054 $(..)po/%.pot: $(objpfx)distinfo $(..)MakeTAGS FORCE
1055 $(MAKE) $(addprefix -f ,$(filter-out FORCE,$^)) $@
1059 .PHONY: echo-headers
1064 # Common cleaning targets.
1066 .PHONY: common-mostlyclean common-clean mostlyclean clean do-tests-clean
1068 mostlyclean: common-mostlyclean
1071 -rm -f $(addprefix $(objpfx),$(addsuffix .out,$(tests) $(xtests) \
1073 $(addsuffix -bp.out,$(tests) $(xtests) \
1076 # Remove the object files.
1078 -rm -f $(addprefix $(objpfx),$(tests) $(xtests) $(test-srcs) \
1079 $(others) $(sysdep-others) stubs \
1080 $(addsuffix .o,$(tests) $(xtests) \
1081 $(test-srcs) $(others) \
1083 $(addsuffix -bp,$(tests) $(xtests) \
1085 $(addsuffix .out,$(tests) $(xtests) \
1087 $(addsuffix -bp.out,$(tests) $(xtests) \
1089 -rm -f $(addprefix $(objpfx),$(extra-objs) $(install-lib) \
1091 $(install-lib.so:%.so=%_pic.a))
1095 $(foreach o,$(object-suffixes-for-libc),
1096 -rm -f $(objpfx)stamp$o $(o-objects))
1099 # Also remove the dependencies and generated source files.
1100 common-clean: common-mostlyclean
1101 -rm -f $(addprefix $(objpfx),$(generated)) $(+depfiles)
1102 -rm -fr $(addprefix $(objpfx),$(generated-dirs))
1103 -rm -f $(addprefix $(common-objpfx),$(common-generated))
1104 -rm -f $(objpfx)distinfo
1106 # Produce a file `stubs' which contains `#define __stub_FUNCTION'
1107 # for each function which is a stub. We grovel over all the .d files
1108 # looking for references to <stub-tag.h>. Then we grovel over each
1109 # referenced source file to see what stub function it defines.
1112 .PHONY: stubs # The parent Makefile calls this target.
1113 stubs: $(objpfx)stubs
1115 s = $(sysdep_dir)/generic
1116 $(objpfx)stubs: $(+depfiles)
1117 # Use /dev/null since `...` might expand to empty.
1118 (s=`cd $s && $(PWD_P)`; \
1119 $(patsubst %/,cd % &&,$(objpfx)) \
1120 sed -n 's/^stub_warning *(\([^)]*\).*$$/#define __stub_\1/p' \
1121 `sed -n -e '\@ $s/[^ ]*\.c@{; s@^.* $s/\([^ ]*\.c\).*$$@'"$$s"'/\1@; h; }' \
1122 -e '/stub-tag\.h/{; g; p; }' \
1123 $(patsubst $(objpfx)%,%,$^) /dev/null` \
1127 # Make the distribution tar file.
1130 dist: $(objpfx)distinfo $(..)Make-dist
1131 $(MAKE) -f $< -f $(word 2,$^) $(Make-dist-args)
1133 # Avoid depending on source files found in sysdeps dirs,
1134 # because the references affect implicit rule selection.
1135 dist: $(filter-out %.c %.S %.s,$(distribute))
1137 # We used to simply export all these variables, but that frequently made the
1138 # environment get too large. Instead, we write all the information into
1139 # a generated makefile fragment `distinfo', and then include it with -f in
1140 # the sub-make that makes the distribution (above).
1141 $(objpfx)distinfo: Makefile $(..)Makerules \
1142 $(wildcard $(foreach dir,$(sysdirs),$(dir)/Makefile))
1143 $(make-target-directory)
1146 .PHONY: subdir_distinfo
1147 subdir_distinfo: $(objpfx)distinfo
1149 define distinfo-vars
1151 echo > $@.new 'subdir := $(subdir)'
1152 $(foreach var,subdir-dirs sources elided-routines sysdep_routines \
1153 headers sysdep_headers distribute dont_distribute generated \
1154 others tests xtests test-srcs extra-libs versioned \
1155 $(extra-libs:%=%-routines) \
1156 $(addprefix install-,lib lib.so data bin bin-script sbin others),
1157 echo >> $@.new '$(subdir)-$(var) := $($(var))'
1158 echo >> $@.new '$(var) = $$($(subdir)-$(var))')
1161 ifneq (,$(strip $(gpl2lgpl)))
1162 ifneq (,$(wildcard $(..)gpl2lgpl.sed))
1163 # Snarf from the master source and frob the copying notice.
1164 $(gpl2lgpl): %: $(..)gpl2lgpl.sed /home/gd/gnu/lib/%
1166 # So I don't edit them by mistake.
1169 ifeq ($(with-cvs),yes)
1170 test ! -d CVS || cvs $(CVSOPTS) commit -m'Updated from $^' $@