Update.
[glibc.git] / Makerules
blob485b5c035cb2d12cebf845f7b4135dcc7187e3ca
1 # Copyright (C) 1991-1999, 2000,2001 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 Library General Public License as
6 # published by the Free Software Foundation; either version 2 of the
7 # 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 # Library General Public License for more details.
14 # You should have received a copy of the GNU Library General Public
15 # License along with the GNU C Library; see the file COPYING.LIB.  If not,
16 # write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 # Boston, MA 02111-1307, USA.
20 #       Common rules for making the GNU C library.  This file is included
21 #       by the top-level Makefile and by all subdirectory makefiles
22 #       (through Rules).
24 ifneq (,)
25 This makefile requires GNU Make.
26 endif
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.
34 endif
37 ifdef   subdir
38 ..      := ../
39 endif   # subdir
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))" ""
44 sources :=
45 endif
47 oPATH := $(PATH)
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.
51 else
52 PATH := $(oPATH)
53 endif
55 ifndef +included-Makeconfig
56 include $(..)Makeconfig
57 endif
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)
67 ifdef objdir
68 +sysdep_dirs := $(objdir) $(+sysdep_dirs)
69 endif
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).
95 in-Makerules := yes
97 -include $(+sysdir_pfx)sysd-Makefile
98 ifndef avoid-generated
99 ifneq ($(sysd-Makefile-sysdirs),$(config-sysdirs))
100 sysd-Makefile-force = FORCE
101 FORCE:
102 endif
103 $(+sysdir_pfx)sysd-Makefile: $(+sysdir_pfx)config.make $(..)Makerules \
104                              $(sysd-Makefile-force)
105         -@rm -f $@T
106         (echo 'sysd-Makefile-sysdirs := $(config-sysdirs)';                   \
107          for file in $(config-sysdirs:=/Makefile); do                         \
108            if [ -f $(..)$$file ]; then                                        \
109              echo include "\$$(..)$$file";                                    \
110            else true; fi;                                                     \
111          done;                                                                \
112          echo 'sysd-Makefile-done=t') > $@T
113         mv -f $@T $@
114 endif
116 ifndef sysd-Makefile-done
117 # Don't do deps until this exists, because it might change the sources list.
118 no_deps=t
119 endif
122 # Reorder before-compile so that mach things come first, and hurd things
123 # second, before all else.  The mach and hurd subdirectories have many
124 # generated header files which the much of rest of the library depends on,
125 # so it is best to build them first (and mach before hurd, at that).
126 before-compile := $(filter $(common-objpfx)mach% $(common-objpfx)hurd%,\
127                            $(before-compile)) \
128                   $(filter-out $(common-objpfx)mach% $(common-objpfx)hurd%,\
129                                $(before-compile))
131 # Even before that, we need abi-versions.h which is generated right here.
132 ifeq ($(versioning),yes)
133 ifndef avoid-generated
134 before-compile := $(common-objpfx)abi-versions.h $(before-compile)
135 $(common-objpfx)abi-versions.h: $(..)scripts/abi-versions.awk \
136                                 $(common-objpfx)Versions.all
137         LC_ALL=C $(AWK) -v oldest_abi=$(oldest-abi) -f $^ > $@T
138         mv -f $@T $@
139 endif # avoid-generated
140 endif # $(versioning) = yes
143 # Remove existing files from `before-compile'.  Things are added there when
144 # they must exist for dependency generation to work right, but once they
145 # exist there is no further need for every single file to depend on them,
146 # and those gratuitous dependencies result in many gratuitous
147 # recompilations.
148 before-compile := $(filter-out $(wildcard $(before-compile)),$(before-compile))
150 # Don't let any before-compile file be an intermediate and get removed.
151 ifdef before-compile
152 $(before-compile):
153 endif
155 # Generate an ordered list of implicit rules which find the source files in
156 # each sysdep directory.  The old method was to use vpath to search all the
157 # sysdep directories.  However, that had the problem that a .S file in a
158 # later directory would be chosen over a .c file in an earlier directory,
159 # which does not preserve the desired sysdeps ordering behavior.
161 # When making the list of .d files to include, we can't know which ones
162 # have source in .s files, and thus do not in fact need a .d file.
163 # So we must define rules to make .d files for .s files.
164 define make-dummy-dep
165 $(addprefix ln $(common-objpfx)dummy.d ,$(filter-out $(wildcard $@),$@))
166 endef
167 $(common-objpfx)dummy.d:
168         echo '# .s files cannot contain includes, so they need no deps.' > $@
170 # It matters that this set of rules, for compiling from sources in
171 # the current directory (the $srcdir/$subdir) come before the
172 # generated sysdep rules in included from sysd-rules below.  When
173 # compiling in the source tree, generated sources go into the current
174 # directory, and those should be chosen before any sources in sysdeps.
175 define o-iterator-doit
176 $(objpfx)%$o: %.S $(before-compile); $$(compile-command.S)
177 endef
178 object-suffixes-left := $(all-object-suffixes)
179 include $(o-iterator)
180 $(objpfx)%.d: %.S $(before-compile); $(+make-deps)
182 define o-iterator-doit
183 $(objpfx)%$o: %.s $(before-compile); $$(compile-command.s)
184 endef
185 object-suffixes-left := $(all-object-suffixes)
186 include $(o-iterator)
187 $(objpfx)%.d: %.s $(common-objpfx)dummy.d; $(make-dummy-dep)
189 define o-iterator-doit
190 $(objpfx)%$o: %.c $(before-compile); $$(compile-command.c)
191 endef
192 object-suffixes-left := $(all-object-suffixes)
193 include $(o-iterator)
194 $(objpfx)%.d: %.c $(before-compile); $(+make-deps)
196 # Omit the objpfx rules when building in the source tree, because
197 # objpfx is empty and so these rules just override the ones above.
198 ifdef objpfx
199 # Define first rules to find the source files in $(objpfx).
200 # Generated source files will end up there.
201 define o-iterator-doit
202 $(objpfx)%$o: $(objpfx)%.S $(before-compile); $$(compile-command.S)
203 endef
204 object-suffixes-left := $(all-object-suffixes)
205 include $(o-iterator)
206 $(objpfx)%.d: $(objpfx)%.S $(before-compile); $(+make-deps)
208 define o-iterator-doit
209 $(objpfx)%$o: $(objpfx)%.s $(before-compile); $$(compile-command.s)
210 endef
211 object-suffixes-left := $(all-object-suffixes)
212 include $(o-iterator)
213 $(objpfx)%.d: $(objpfx)%.s $(common-objpfx)dummy.d; $(make-dummy-dep)
215 define o-iterator-doit
216 $(objpfx)%$o: $(objpfx)%.c $(before-compile); $$(compile-command.c)
217 endef
218 object-suffixes-left := $(all-object-suffixes)
219 include $(o-iterator)
220 $(objpfx)%.d: $(objpfx)%.c $(before-compile); $(+make-deps)
221 endif
223 # System-dependent makefiles can put in `inhibit-sysdep-asm' wildcard
224 # patterns matching sysdep directories whose assembly source files should
225 # be suppressed.
226 ifdef inhibit-sysdep-asm
227 define open-check-inhibit-asm
228 case $$sysdir in $(subst $(empty) ,|,$(inhibit-sysdep-asm))) : ;; *)
229 endef
230 close-check-inhibit-asm = ;; esac ;
231 endif
233 # Don't include sysd-rules until sysd-Makefile is already there and has been
234 # included.  It might define inhibit-sysdep-asm, which would affect the
235 # contents of sysd-rules.
236 ifdef sysd-Makefile-done
237 -include $(+sysdir_pfx)sysd-rules
238 ifneq ($(sysd-rules-sysdirs),$(config-sysdirs))
239 # The value of $(+sysdep_dirs) the sysd-rules was computed for
240 # differs from the one we are using now.  So force a rebuild of sysd-rules.
241 sysd-rules-force = FORCE
242 FORCE:
243 endif
244 endif
245 $(+sysdir_pfx)sysd-rules: $(+sysdir_pfx)config.make $(..)Makerules \
246                           $(wildcard $(foreach dir,$(sysdirs),\
247                                                $(dir)/Makefile))\
248                           $(sysd-rules-force)
249         -@rm -f $@T
250         (echo 'sysd-rules-sysdirs := $(config-sysdirs)';                      \
251          for dir in $(config-sysdirs:%='$$(..)%'); do                         \
252            for o in $(all-object-suffixes); do \
253              $(open-check-inhibit-asm) \
254              echo "\$$(objpfx)%$$o: $$dir/%.S \$$(before-compile); \
255                   \$$(compile-command.S)";                                    \
256              echo "\$$(objpfx)%$$o: $$dir/%.s \$$(before-compile); \
257                   \$$(compile-command.s)";                                    \
258              $(close-check-inhibit-asm) \
259              echo "\$$(objpfx)%$$o: $$dir/%.c \$$(before-compile); \
260                   \$$(compile-command.c)";                                    \
261            done; \
262            $(open-check-inhibit-asm) \
263            echo "\$$(objpfx)%.d: $$dir/%.s \$$(common-objpfx)dummy.d; \
264                 \$$(make-dummy-dep)";                          \
265            echo "\$$(objpfx)%.d: $$dir/%.S \$$(before-compile); \
266                 \$$(+make-deps)";                                             \
267            $(close-check-inhibit-asm)   \
268            echo "\$$(objpfx)%.d: $$dir/%.c \$$(before-compile); \
269                 \$$(+make-deps)";                                             \
270          done;                                                                \
271          echo 'sysd-rules-done = t') > $@T
272         mv -f $@T $@
274 ifndef sysd-rules-done
275 # Don't do deps until this exists, because it provides rules to make the deps.
276 no_deps=t
277 endif
279 # Generate version maps, but wait until sysdep-subdirs is known
280 ifeq ($(sysd-sorted-done),t)
281 ifeq ($(versioning),yes)
282 -include $(common-objpfx)sysd-versions
283 $(addprefix $(common-objpfx),$(version-maps)): $(common-objpfx)sysd-versions
284 common-generated += $(version-maps)
285 postclean-generated += sysd-versions Versions.all abi-versions.h
287 ifndef avoid-generated
288 ifneq ($(sysd-versions-subdirs),$(all-subdirs) $(config-sysdirs))
289 sysd-versions-force = FORCE
290 FORCE:
291 endif
292 $(common-objpfx)Versions.all: $(..)scripts/firstversions.awk \
293                               $(common-objpfx)soversions.i \
294                               $(..)Versions.def \
295                               $(wildcard $(add-ons:%=$(..)%/Versions.def))
296         { while read lib version setname; do \
297             test -z "$$setname" || echo "$$lib : $$setname"; \
298           done < $(word 2,$^); \
299           cat $(filter-out $< $(word 2,$^),$^) \
300           | $(preprocess-versions); \
301         } | LC_ALL=C $(AWK) -f $< > $@T
302         mv -f $@T $@
303 $(common-objpfx)sysd-versions: $(common-objpfx)Versions.all \
304                                $(..)scripts/versions.awk \
305                                $(wildcard $(all-subdirs:%=$(..)%/Versions)) \
306                                $(wildcard $(sysdirs:%=%/Versions)) \
307                                $(sysd-versions-force)
308         ( echo 'sysd-versions-subdirs = $(all-subdirs) $(config-sysdirs)' ; \
309           cat $(filter-out $< $(word 2,$^) $(sysd-versions-force),$^) \
310           | $(preprocess-versions) \
311           | LC_ALL=C $(AWK) -v buildroot=$(common-objpfx) -v defsfile=$< \
312                             -v move_if_change='$(move-if-change)' \
313                             -f $(word 2,$^); \
314         ) > $@T
315         mv -f $@T $@
316 endif # avoid-generated
317 endif # $(versioning) = yes
318 endif # sysd-sorted-done
321 ifndef compile-command.S
322 compile-command.S = $(compile.S) $(OUTPUT_OPTION)
323 endif
324 ifndef compile-command.s
325 compile-command.s = $(COMPILE.s) $< $(OUTPUT_OPTION)
326 endif
327 ifndef compile-command.c
328 compile-command.c = $(compile.c) $(OUTPUT_OPTION)
329 endif
331 # GCC can grok options after the file name, and it looks nicer that way.
332 compile.c = $(CC) $< -c $(CFLAGS) $(CPPFLAGS)
333 compile.S = \
334   $(CC) $< -c $(CPPFLAGS) -DASSEMBLER $(asm-CPPFLAGS) $(ASFLAGS-$(suffix $@))
335 COMPILE.S = \
336   $(CC) -c $(CPPFLAGS) -DASSEMBLER $(asm-CPPFLAGS) $(ASFLAGS-$(suffix $@))
337 COMPILE.s = $(filter-out -pipe,$(CC)) -c $(ASFLAGS)
339 # If we want to generate MD% checksums for the sources do this now.
340 ifeq ($(md5),yes)
341 generate-md5 = ; rm -f $(@:.d=.md5); \
342 $(CC) -E $< $(CFLAGS) $(CPPFLAGS) $($(<:$*.%=%)-CPPFLAGS) | \
343 sed '/^\#/d;/^[[:space:]]*$$/d' | md5sum > $(@:.d=.md5)
344 else
345 generate-md5 =
346 endif
348 # We need this for the output to go in the right place.  It will default to
349 # empty if make was configured to work with a cc that can't grok -c and -o
350 # together.  You can't compile the C library with such a compiler.
351 OUTPUT_OPTION = -o $@
353 S-CPPFLAGS = $(asm-CPPFLAGS)
354 define +make-deps
355 $(make-target-directory)
356 -@rm -f $@
357 $(+mkdep) $< $(CFLAGS) $(CPPFLAGS) $($(<:$*.%=%)-CPPFLAGS) | \
358 sed \
359 -e 's,$(subst .,\.,$*)\.o,$(foreach o,$(all-object-suffixes),$(@:.d=$o)) $@,' \
360 $(sed-remove-objpfx) > $(@:.d=.T)
361 mv -f $(@:.d=.T) $@ $(generate-md5)
362 endef
363 ifneq (,$(objpfx))
364 # Continuation lines here are dangerous because they introduce spaces!
365 define sed-remove-objpfx
366 -e 's@ $(subst .,\.,$(subst @,\@,$(common-objpfx)))@ $$(common-objpfx)@g' \
367 -e 's@^$(subst .,\.,$(subst @,\@,$(common-objpfx)))@$$(common-objpfx)@g'
368 endef
369 endif
371 # Modify the list of routines we build for different targets
373 ifeq (yes,$(build-shared))
374 ifndef libc.so-version
375 # Undefine this because it can't work when we libc.so is unversioned.
376 static-only-routines =
377 endif
378 endif
380 # Bounded pointer thunks are only built for *.ob
381 elide-bp-thunks = $(addprefix $(bppfx),$(bp-thunks))
383 elide-routines.oS += $(filter-out $(static-only-routines),\
384                                   $(routines) $(aux) $(sysdep_routines)) \
385                      $(elide-bp-thunks)
386 elide-routines.os += $(static-only-routines) $(elide-bp-thunks)
388 # If we have versioned code we don't need the old versions in any of the
389 # static libraries.
390 elide-routines.o  += $(shared-only-routines) $(elide-bp-thunks)
391 elide-routines.op += $(shared-only-routines) $(elide-bp-thunks)
392 elide-routines.og += $(shared-only-routines) $(elide-bp-thunks)
393 elide-routines.ob += $(shared-only-routines)
395 # Shared library building.
397 ifeq (yes,$(build-shared))
399 # Reference map file only when versioning is selected and a map file name
400 # is given.
401 ifeq ($(versioning),yes)
402 map-file = $(firstword $($(@F:.so=-map)) \
403                        $(addprefix $(common-objpfx), \
404                                    $(filter $(@F:.so=.map),$(version-maps))))
405 load-map-file = $(map-file:%=-Wl,--version-script=%)
406 endif
408 # Pattern rule to build a shared object from an archive of PIC objects.
409 # This must come after the installation rules so Make doesn't try to
410 # build shared libraries in place from the installed *_pic.a files.
411 # $(LDLIBS-%.so) may contain -l switches to generate run-time dependencies
412 # on other shared objects.
413 lib%.so: lib%_pic.a $(+preinit) $(+postinit) $(+interp)
414         $(build-shlib)
416 define build-shlib-helper
417 $(LINK.o) -shared -Wl,-O1 $(sysdep-LDFLAGS) $(config-LDFLAGS) \
418           $(extra-B-$(@F:lib%.so=%).so) -B$(csu-objpfx) \
419           $(extra-B-$(@F:lib%.so=%).so) $(load-map-file) \
420           -Wl,-soname=lib$(libprefix)$(@F:lib%.so=%).so$($(@F)-version) \
421           $(LDFLAGS.so) $(LDFLAGS-$(@F:lib%.so=%).so) \
422           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link)
423 endef
425 ifeq (yes,$(elf))
426 # binutils only position loadable notes into the first page for binaries,
427 # not for shared objects
428 define build-shlib
429 $(build-shlib-helper) \
430           -o $@.new $(csu-objpfx)abi-note.o -Wl,--verbose \
431           $(LDLIBS-$(@F:lib%.so=%).so) 2>&1 | \
432           sed -e '/^=========/,/^=========/!d;/^=========/d' \
433               -e 's/^.*\.hash[  ]*:.*$$/  .note.ABI-tag : { *(.note.ABI-tag) } &/' \
434           > $@.lds
435 rm -f $@.new
436 $(build-shlib-helper) -o $@ -T $@.lds \
437           -Wl,--whole-archive $(csu-objpfx)abi-note.o \
438           $(filter-out $(map-file) $(+preinit) $(+postinit),$^) \
439           $(no-whole-archive) $(LDLIBS-$(@F:lib%.so=%).so)
440 rm -f $@.lds
441 endef
442 else
443 define build-shlib
444 $(build-shlib-helper) \
445           -o $@ -Wl,--whole-archive \
446           $(filter-out $(map-file) $(+preinit) $(+postinit),$^) \
447           $(no-whole-archive) $(LDLIBS-$(@F:lib%.so=%).so)
448 endef
449 endif
451 define build-module-helper
452 $(LINK.o) -shared $(sysdep-LDFLAGS) $(config-LDFLAGS) \
453           -B$(csu-objpfx) $(load-map-file) \
454           $(LDFLAGS.so) $(LDFLAGS-$(@F:%.so=%).so) \
455           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link)
456 endef
458 # This macro is similar to build-shlib but it does not define a soname
459 # and it does not depend on the destination name to start with `lib'.
460 ifeq (yes,$(elf))
461 # binutils only position loadable notes into the first page for binaries,
462 # not for shared objects
463 define build-module
464 $(build-module-helper) \
465           -o $@.new $(csu-objpfx)abi-note.o -Wl,--verbose \
466           $(LDLIBS-$(@F:lib%.so=%).so) 2>&1 | \
467           sed -e '/^=========/,/^=========/!d;/^=========/d' \
468               -e 's/^.*\.hash[  ]*:.*$$/  .note.ABI-tag : { *(.note.ABI-tag) } &/' \
469           > $@.lds
470 rm -f $@.new
471 $(build-module-helper) -o $@ -T $@.lds \
472           -Wl,--whole-archive $(csu-objpfx)abi-note.o \
473           $(filter-out $(map-file) $(+preinit) $(+postinit),$^) \
474           $(no-whole-archive) $(LDLIBS-$(@F:lib%.so=%).so)
475 rm -f $@.lds
476 endef
477 else
478 define build-module
479 $(build-module-helper) \
480           -o $@ -Wl,--whole-archive \
481           $(filter-out $(map-file) $(+preinit) $(+postinit),$^) \
482           $(no-whole-archive) $(LDLIBS-$(@F:%.so=%).so)
483 endef
484 endif
486 # Don't try to use -lc when making libc.so itself.
487 # Also omits crti.o and crtn.o, which we do not want
488 # since we define our own `.init' section specially.
489 LDFLAGS-c.so = -nostdlib -nostartfiles
490 # But we still want to link libc.so against $(gnulib).
491 LDLIBS-c.so += $(gnulib)
492 # Give libc.so an entry point and make it directly runnable itself.
493 LDFLAGS-c.so += -e __libc_main
494 # Force the backward compatibility EH functions to be linked.
495 LDFLAGS-c.so += -u __register_frame
496 # Pre-link the objects of libc_pic.a so that we can locally resolve
497 # COMMON symbols before we link against ld.so.  This is because ld.so
498 # contains some of libc_pic.a already, which will prevent the COMMONs
499 # from being allocated in libc.so, which introduces evil dependencies
500 # between libc.so and ld.so, which can make it impossible to upgrade.
501 $(common-objpfx)libc_pic.os: $(common-objpfx)libc_pic.a
502         $(LINK.o) -nostdlib -nostartfiles -r -o $@ \
503         $(LDFLAGS-c_pic.os) -Wl,-d -Wl,--whole-archive $^
504 # Use our own special initializer and finalizer files for libc.so.
505 $(common-objpfx)libc.so: $(elfobjdir)/soinit.os \
506                          $(common-objpfx)libc_pic.os \
507                          $(elfobjdir)/sofini.os \
508                          $(elfobjdir)/interp.os $(elfobjdir)/ld.so
509         $(build-shlib)
510 ifeq ($(versioning),yes)
511 $(common-objpfx)libc.so: $(common-objpfx)libc.map
512 endif
513 common-generated += libc.so libc_pic.os
514 ifdef libc.so-version
515 $(common-objpfx)libc.so$(libc.so-version): $(common-objpfx)libc.so
516         $(make-link)
517 common-generated += libc.so$(libc.so-version)
518 endif
519 endif
521 # Figure out the source filenames in this directory.
523 override sources := $(addsuffix .c,\
524                         $(filter-out $(elided-routines),\
525                             $(routines) $(aux) \
526                             $(sysdep_routines)))
527 sysdep_routines := $(sysdep_routines)
529 headers := $(headers) $(sysdep_headers)
531 # This is the list of all object files, gotten by
532 # replacing every ".c" in `sources' with a ".o".
533 # We also add bounded-pointer thunks, which are later
534 # elided for all suffixes except for `.ob'.
535 override objects := $(addprefix $(objpfx),$(sources:.c=.o) \
536                       $(patsubst %,$(bppfx)%.o,\
537                         $(filter $(routines) $(sysdep_routines),$(bp-thunks))))
540 # The makefile may define $(extra-libs) with `libfoo libbar'
541 # to build libfoo.a et al from the modules listed in $(libfoo-routines).
542 ifdef extra-libs
543 # extra-lib.mk is included once for each extra lib to define rules
544 # to build it, and to add its objects to the various variables.
545 # During its evaluation, $(lib) is set to the name of the library.
546 extra-libs-left := $(extra-libs)
547 include $(patsubst %,$(..)extra-lib.mk,$(extra-libs))
548 endif
550 +depfiles := $(sources:.c=.d) \
551              $(patsubst %.o,%.d,$(filter %.o,$(extra-objs:.os=.o))) \
552              $(addsuffix .d,$(tests) $(test-srcs))
553 ifeq ($(build-programs),yes)
554 +depfiles += $(addsuffix .d,$(others) $(sysdep-others))
555 endif
556 +depfiles := $(addprefix $(objpfx),\
557                          $(filter-out $(addsuffix .d,$(omit-deps)),\
558                                       $(+depfiles)))
560 ifdef +depfiles
561 ifneq ($(no_deps),t)
562 -include $(+depfiles)
563 endif
564 endif
565 \f\f
566 # Maximize efficiency by minimizing the number of rules.
567 .SUFFIXES:      # Clear the suffix list.  We don't use suffix rules.
568 # Don't define any builtin rules.
569 MAKEFLAGS := $(MAKEFLAGS)r
571 # Generic rule for making directories.
573 # mkdir isn't smart enough to strip a trailing /.
574         mkdir $(@:%/=%)
576 # Make sure that object files are not removed
577 # when they are intermediates between sources and library members.
578 .PRECIOUS: $(addprefix $(objpfx)%,$(all-object-suffixes))
580 # Make sure that the parent library archive is never removed.
581 .PRECIOUS: $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
583 # Use the verbose option of ar and tar when not running silently.
584 ifeq    "$(findstring s,$(MAKEFLAGS))" ""       # if not -s
585 verbose := v
586 else                                            # -s
587 verbose :=
588 endif                                           # not -s
590 ARFLAGS := r$(verbose)
591 CREATE_ARFLAGS := cru$(verbose)
593 # This makes all the object files in the parent library archive.
595 .PHONY: lib lib-noranlib
596 lib: lib-noranlib $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
597 lib-noranlib: libobjs
599 # For object-suffix $o, the list of objects with that suffix.
600 # Makefiles can define `elide-routines.so = foo' to leave foo.so out.
601 o-objects = $(patsubst %.o,%$o,$(filter-out $(patsubst %,$(objpfx)%.o,\
602                                                        $(elide-routines$o)),\
603                                             $(objects))) \
604             $(addprefix $(objpfx),$(o-objects$o))
606 others: $(addprefix $(objpfx),$(install-lib))
608 ifndef objects
610 # Create the stamp$o files to keep the parent makefile happy.
611 subdir_lib: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
612 $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o):
613         $(make-target-directory)
614         rm -f $@; > $@
615 else
617 # Define explicit rules to update each $(objpfx)stamp.SUFFIX
618 # timestamp file; these rules (one explicit rule is generated for each
619 # object suffix) write a list of objects to update in the stamp file.
620 # The parent will then actually add them all to the archive in the
621 # archive rule, below.
622 define o-iterator-doit
623 $(objpfx)stamp$o: $(o-objects); $$(do-stamp)
624 endef
625 define do-stamp
626 echo '$(patsubst $(objpfx)%,$(addsuffix /,$(subdir))%,$^)' > $@T
627 mv -f $@T $@
628 endef
629 object-suffixes-left := $(object-suffixes-for-libc)
630 include $(o-iterator)
632 endif
634 # Now define explicit rules to build the library archives; these depend
635 # on the stamp files built above.
636 define o-iterator-doit
637 $(common-objpfx)$(patsubst %,$(libtype$o),c): \
638                 $(subdirs-stamp-o) $(common-objpfx)stamp$o; $$(do-makelib)
639 endef
640 define do-makelib
641 cd $(common-objdir) && \
642 $(AR) $(CREATE_ARFLAGS) $(@F) `cat $(patsubst $(common-objpfx)%,%,$^)`
643 $(RANLIB) $@
644 endef
645 subdirs-stamps := $(foreach d,$(subdirs),$(common-objpfx)$d/stamp%)
646 subdirs-stamp-o = $(subst %,$o,$(subdirs-stamps))
647 ifndef subdir
648 $(subdirs-stamps): subdir_lib;
649 endif
650 object-suffixes-left = $(object-suffixes-for-libc)
651 include $(o-iterator)
654 # This makes all the object files.
655 .PHONY: objects objs libobjs extra-objs
656 objects objs: libobjs extra-objs
657 libobjs: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
658 extra-objs: $(addprefix $(objpfx),$(extra-objs))
660 # Canned sequence for building an extra library archive.
661 define build-extra-lib
662 $(patsubst %/,cd % &&,$(objpfx)) \
663 $(AR) $(CREATE_ARFLAGS) $(@:$(objpfx)%=%) \
664       $(patsubst $(objpfx)%,%,$^)
665 $(RANLIB) $@
666 endef
668 # Installation.
670 .PHONY: force-install
671 force-install:
673 # $(install-lib) are installed from the object directory into $(libdir);
674 # files in $(install-lib) matching `lib%.a' are ranlib'd after installation
675 # unless they also appear in $(non-lib.a).  $(install-data) are installed
676 # as they are into $(datadir).  $(headers) are installed as they are in
677 # $(includedir).  $(install-bin) and $(install-sbin) are installed from the
678 # object directory into $(bindir) and $(sbindir), respectively.
679 # $(install-others) are absolute path names of files to install; rules to
680 # install them are defined elsewhere.
682 # The simple library name to install libc.a under.
683 # This could be defined by a sysdep Makefile.
684 ifndef libc-name
685 libc-name := c
686 endif
688 define do-install
689 $(make-target-directory)
690 $(INSTALL_DATA) $< $@
691 endef
693 # Make the target directory if it doesn't exist, using the `mkinstalldirs'
694 # script that does `mkdir -p' even if `mkdir' doesn't support that flag.
695 define make-target-directory
696 $(addprefix $(..)./scripts/mkinstalldirs ,\
697             $(filter-out $(wildcard $(@D:%/=%)),$(@D:%/=%)))
698 endef
700 # Any directory (parent or subdir) should install libc.a; this way
701 # "make install" in a subdir is guaranteed to install everything it changes.
702 installed-libcs := $(foreach o,$(filter-out .os,$(object-suffixes-for-libc)),\
703                              $(inst_libdir)/$(patsubst %,$(libtype$o),\
704                                                      $(libprefix)$(libc-name)))
705 install: $(installed-libcs)
706 $(installed-libcs): $(inst_libdir)/lib$(libprefix)%: lib $(+force)
707         $(make-target-directory)
708         $(INSTALL_DATA) $(common-objpfx)lib$(*:$(libc-name)%=c%) $@
709 # Running ranlib after installing makes the __.SYMDEF time stamp up to
710 # date, which avoids messages from some linkers.
711         $(RANLIB) $@
713 define do-install-program
714 $(make-target-directory)
715 $(INSTALL_PROGRAM) $< $@.new
716 mv -f $@.new $@
717 endef
719 install-lib.so := $(filter %.so,$(install-lib:%_pic.a=%.so))
720 install-lib := $(filter-out %.so %_pic.a,$(install-lib))
722 ifeq (yes,$(build-shared))
723 # Find which .so's have versions.
724 versioned := $(strip $(foreach so,$(install-lib.so),\
725                                $(patsubst %,$(so),$($(so)-version))))
727 install-lib.so-versioned := $(filter $(versioned), $(install-lib.so))
728 install-lib.so-unversioned := $(filter-out $(versioned), $(install-lib.so))
730 install-lib-nosubdir: $(install-lib.so-versioned:%=$(inst_libdir)/%) \
731                       $(install-lib.so-unversioned:%=$(inst_slibdir)/%)
733 # Install all the unversioned shared libraries.
734 $(install-lib.so-unversioned:%=$(inst_slibdir)/%): $(inst_slibdir)/%.so: \
735     $(objpfx)%.so $(+force)
736         $(do-install-program)
738 ifneq ($(findstring -s,$(LN_S)),)
739 define make-link
740 rm -f $@.new
741 $(SHELL) $(..)scripts/rellns-sh $< $@.new
742 mv -f $@.new $@
743 endef
744 else
745 # If we have no symbolic links don't bother with rellns-sh.
746 define make-link
747 rm -f $@.new
748 $(LN_S) $< $@.new
749 mv -f $@.new $@
750 endef
751 endif
753 ifeq (yes,$(build-shared))
754 ifeq (no,$(cross-compiling))
755 symbolic-link-prog := $(common-objpfx)elf/sln
756 symbolic-link-list := $(common-objpfx)elf/symlink.list
757 define make-shlib-link
758 echo $(<F) $@ >> $(symbolic-link-list)
759 endef
760 else # cross-compiling
761 # We need a definition that can be used by elf/Makefile's install rules.
762 symbolic-link-prog = $(LN_S)
763 endif
764 endif
765 ifndef make-shlib-link
766 define make-shlib-link
767 rm -f $@
768 $(LN_S) $(<F) $@
769 endef
770 endif
772 ifdef libc.so-version
773 # For a library specified to be version N, install three files:
774 # libc.so       ->      libc.so.N       (e.g. libc.so.6)
775 # libc.so.6     ->      libc-VERSION.so (e.g. libc-1.10.so)
777 $(inst_slibdir)/libc.so$(libc.so-version): $(inst_slibdir)/libc-$(version).so \
778                                            $(+force)
779         $(make-shlib-link)
780 $(inst_slibdir)/libc-$(version).so: $(common-objpfx)libc.so $(+force)
781         $(do-install-program)
782 install: $(inst_slibdir)/libc.so$(libc.so-version)
784 ifndef subdir
785 # What we install as libc.so for programs to link against is in fact a
786 # link script.  It contains references for the various libraries we need.
787 # The libc.so object is not complete since some functions are only defined
788 # in libc_nonshared.a.
789 # We need to use absolute paths since otherwise local copies (if they exist)
790 # of the files are taken by the linker.
791 install: $(inst_libdir)/libc.so
792 $(inst_libdir)/libc.so: $(common-objpfx)libc.so$(libc.so-version) \
793                         $(inst_libdir)/$(patsubst %,$(libtype.oS),\
794                                                   $(libprefix)$(libc-name)) \
795                         $(+force)
796         (echo '/* GNU ld script';\
797          echo '   Use the shared library, but some functions are only in';\
798          echo '   the static library, so try that secondarily.  */';\
799          echo 'GROUP ( $(slibdir)/libc.so$(libc.so-version)' \
800               '$(libdir)/$(patsubst %,$(libtype.oS),$(libprefix)$(libc-name))'\
801               ')' \
802         ) > $@.new
803         mv -f $@.new $@
805 endif
807 else
808 install: $(inst_slibdir)/libc.so
809 $(inst_slibdir)/libc.so: $(common-objpfx)libc.so $(+force)
810         $(do-install-program)
811 endif
813 ifneq (,$(versioned))
814 # Produce three sets of rules as above for all the smaller versioned libraries.
816 define o-iterator-doit
817 $(inst_libdir)/$o: $(inst_slibdir)/$o$($o-version) $(+force); $$(make-link)
818 endef
819 object-suffixes-left := $(versioned)
820 include $(o-iterator)
822 # Make symlinks in the build directory, because the versioned names might
823 # be referenced by a DT_NEEDED in another library.
824 define o-iterator-doit
825 $(objpfx)$o$($o-version): $(objpfx)$o; $$(make-link)
826 endef
827 object-suffixes-left := $(versioned)
828 include $(o-iterator)
830 generated += $(foreach o,$(versioned),$o$($o-version))
832 ifeq (,$($(subdir)-version))
833 define o-iterator-doit
834 $(inst_slibdir)/$o$($o-version): $(inst_slibdir)/$(o:.so=)-$(version).so \
835                                  $(+force);
836         $$(make-shlib-link)
837 endef
838 object-suffixes-left := $(versioned)
839 include $(o-iterator)
841 define o-iterator-doit
842 $(inst_slibdir)/$(o:.so=)-$(version).so: $(objpfx)$o $(+force);
843         $$(do-install-program)
844 endef
845 object-suffixes-left := $(versioned)
846 include $(o-iterator)
847 else
848 define o-iterator-doit
849 $(inst_slibdir)/$o$($o-version): \
850   $(inst_slibdir)/$(o:.so=)-$($(subdir)-version).so $(+force);
851         $$(make-shlib-link)
852 endef
853 object-suffixes-left := $(versioned)
854 include $(o-iterator)
856 define o-iterator-doit
857 $(inst_slibdir)/$(o:.so=)-$($(subdir)-version).so: $(objpfx)$o $(+force);
858         $$(do-install-program)
859 endef
860 object-suffixes-left := $(versioned)
861 include $(o-iterator)
862 endif
863 endif
865 define do-install-so
866 $(do-install-program)
867 $(patsubst %,ln -s -f $(@F) $(@D)/$(patsubst %$*.so,%,$(<F))$(libprefix)$*.so,\
868            $(filter-out %.so,$@))
869 endef
871 so-versions := $(sort $(foreach so,$(install-lib.so),.so$($(so)-version)))
872 $(foreach v,$(so-versions),\
873           $(inst_slibdir)/lib$(libprefix)%$v): $(common-objpfx)lib%.so \
874                                                $(+force)
875         $(do-install-so)
876 $(foreach v,$(so-versions),\
877           $(inst_slibdir)/$(libprefix)%$v): $(common-objpfx)%.so $(+force)
878         $(do-install-so)
879 endif
881 ifdef install-bin
882 $(addprefix $(inst_bindir)/,$(install-bin)): \
883     $(inst_bindir)/%: $(objpfx)% $(+force)
884         $(do-install-program)
885 endif
886 ifdef install-rootsbin
887 $(addprefix $(inst_rootsbindir)/,$(install-rootsbin)): \
888    $(inst_rootsbindir)/%: $(objpfx)% $(+force)
889         $(do-install-program)
890 endif
891 ifdef install-sbin
892 $(addprefix $(inst_sbindir)/,$(install-sbin)): \
893     $(inst_sbindir)/%: $(objpfx)% $(+force)
894         $(do-install-program)
895 endif
896 ifdef install-lib
897 install-lib.a := $(filter lib%.a,$(install-lib))
898 install-lib-non.a := $(filter-out lib%.a,$(install-lib))
899 ifdef install-lib-non.a
900 $(addprefix $(inst_libdir)/$(libprefix),$(install-lib-non.a)): \
901   $(inst_libdir)/$(libprefix)%: $(objpfx)% $(+force)
902         $(do-install)
903 endif
904 ifdef install-lib.a
905 $(install-lib.a:lib%.a=$(inst_libdir)/lib$(libprefix)%.a): \
906   $(inst_libdir)/lib$(libprefix)%.a: $(objpfx)lib%.a $(+force)
907         $(do-install)
908         $(patsubst %,$(RANLIB) $@,$(filter-out $(non-lib.a),$(<F)))
909 endif
910 endif
911 ifdef install-data
912 $(addprefix $(inst_datadir)/,$(install-data)): $(inst_datadir)/%: % $(+force)
913         $(do-install)
914 endif
915 headers := $(strip $(headers))
916 ifdef headers
917 $(addprefix $(inst_includedir)/,$(headers)): $(inst_includedir)/%: % $(+force)
918         $(do-install)
919 endif   # headers
921 .PHONY: install-bin-nosubdir install-rootsbin-nosubdir install-sbin-nosubdir \
922         install-lib-nosubdir install-data-nosubdir install-headers-nosubdir
923 install-bin-nosubdir: $(addprefix $(inst_bindir)/,$(install-bin))
924 install-rootsbin-nosubdir: \
925         $(addprefix $(inst_rootsbindir)/,$(install-rootsbin))
926 install-sbin-nosubdir: $(addprefix $(inst_sbindir)/,$(install-sbin))
927 install-lib-nosubdir: $(addprefix $(inst_libdir)/,\
928                        $(patsubst lib%.a,lib$(libprefix)%.a,$(install-lib.a)) \
929                        $(addprefix $(libprefix),$(install-lib-non.a)))
930 install-data-nosubdir: $(addprefix $(inst_datadir)/,$(install-data))
931 install-headers-nosubdir: $(addprefix $(inst_includedir)/,$(headers))
932 install-others-nosubdir: $(install-others)
934 # We need all the `-nosubdir' targets so that `install' in the parent
935 # doesn't depend on several things which each iterate over the subdirs.
936 # This rule makes `install-FOO' always use `install-FOO-nosubdir' as a
937 # subroutine.  Then in the parent `install-FOO' also causes subdir makes.
938 install-%:: install-%-nosubdir ;
940 .PHONY: install install-no-libc.a-nosubdir
941 ifeq ($(build-programs),yes)
942 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir\
943                             install-bin-nosubdir install-lib-nosubdir   \
944                             install-others-nosubdir install-rootsbin-nosubdir \
945                             install-sbin-nosubdir
946 else
947 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir\
948                             install-lib-nosubdir install-others-nosubdir
949 endif
950 install: install-no-libc.a-nosubdir
952 # Command to compile $< in $(objdir) using the native libraries.
953 define native-compile
954 $(make-target-directory)
955 $(patsubst %/,cd % &&,$(objpfx)) \
956 $(BUILD_CC) $($(basename $(<F))-CFLAGS) $(ALL_BUILD_CFLAGS) \
957             $(firstword $(filter /%,$< $(shell pwd)/$<)) -o $(@F)
958 endef
960 # Command to compile $< in $(common-objdir) using the native libraries.
961 # We must cd to $(objdir) anyway so that $(..)config.h is valid.
962 define common-objdir-compile
963 $(patsubst %/,cd % &&,$(objpfx)) \
964 $(BUILD_CC) $($(basename $(<F))-CFLAGS) $(ALL_BUILD_CFLAGS) \
965             $(firstword $(filter /%,$< $(shell pwd)/$<)) -o $(..)$(@F)
966 endef
968 # We always want to use configuration definitions.
969 # Note that this is only used for commands running in $(objpfx).
970 ALL_BUILD_CFLAGS = $(BUILD_CFLAGS) -include $(..)config.h
972 # Support the GNU standard name for this target.
973 .PHONY: check
974 check: tests
976 .PHONY: TAGS
977 TAGS: $(objpfx)distinfo $(..)MakeTAGS
978         $(MAKE) $(addprefix -f ,$^) $@
980 $(..)po/%.pot: $(objpfx)distinfo $(..)MakeTAGS FORCE
981         $(MAKE) $(addprefix -f ,$(filter-out FORCE,$^)) $@
982 FORCE:
985 .PHONY: echo-headers
986 echo-headers:
987         @echo $(headers)
990 # Common cleaning targets.
992 .PHONY: common-mostlyclean common-clean mostlyclean clean do-tests-clean
993 clean: common-clean
994 mostlyclean: common-mostlyclean
996 do-tests-clean:
997         -rm -f $(addprefix $(objpfx),$(addsuffix .out,$(tests) $(test-srcs)) \
998                                      $(addsuffix -bp.out,$(tests) $(test-srcs)))
1000 # Remove the object files.
1001 common-mostlyclean:
1002         -rm -f $(addprefix $(objpfx),$(tests) $(test-srcs) $(others) \
1003                                      $(sysdep-others) stubs \
1004                                      $(addsuffix .o,$(tests) $(test-srcs) \
1005                                                     $(others) \
1006                                                     $(sysdep-others)) \
1007                                      $(addsuffix -bp,$(tests) $(test-srcs)) \
1008                                      $(addsuffix .out,$(tests) $(test-srcs)) \
1009                                      $(addsuffix -bp.out,$(tests) $(test-srcs)))
1010         -rm -f $(addprefix $(objpfx),$(extra-objs) $(install-lib) \
1011                                      $(install-lib.so) \
1012                                      $(install-lib.so:%.so=%_pic.a))
1013         -rm -f core
1014         $(rmobjs)
1015 define rmobjs
1016 $(foreach o,$(object-suffixes-for-libc),
1017 -rm -f $(objpfx)stamp$o $(o-objects))
1018 endef
1020 # Also remove the dependencies and generated source files.
1021 common-clean: common-mostlyclean
1022         -rm -f $(addprefix $(objpfx),$(generated)) $(+depfiles)
1023         -rm -fr $(addprefix $(objpfx),$(generated-dirs))
1024         -rm -f $(addprefix $(common-objpfx),$(common-generated))
1025         -rm -f $(objpfx)distinfo
1027 # Produce a file `stubs' which contains `#define __stub_FUNCTION'
1028 # for each function which is a stub.  We grovel over all the .d files
1029 # looking for references to <stub-tag.h>.  Then we grovel over each
1030 # referenced source file to see what stub function it defines.
1032 ifdef objpfx
1033 .PHONY: stubs # The parent Makefile calls this target.
1034 stubs: $(objpfx)stubs
1035 endif
1036 s = $(sysdep_dir)/generic
1037 $(objpfx)stubs: $(+depfiles)
1038 # Use /dev/null since `...` might expand to empty.
1039         (s=`cd $s && $(PWD_P)`; \
1040          $(patsubst %/,cd % &&,$(objpfx)) \
1041          sed -n 's/^stub_warning *(\([^)]*\).*$$/#define __stub_\1/p' \
1042           `sed -n -e '\@ $s/[^ ]*\.c@{; s@^.* $s/\([^ ]*\.c\).*$$@'"$$s"'/\1@; h; }' \
1043                 -e '/stub-tag\.h/{; g; p; }' \
1044                   $(patsubst $(objpfx)%,%,$^) /dev/null` \
1045              /dev/null) > $@T
1046         mv -f $@T $@
1048 # Make the distribution tar file.
1050 .PHONY: dist
1051 dist: $(objpfx)distinfo $(..)Make-dist
1052         $(MAKE) -f $< -f $(word 2,$^) $(Make-dist-args)
1054 # Avoid depending on source files found in sysdeps dirs,
1055 # because the references affect implicit rule selection.
1056 dist: $(filter-out %.c %.S %.s,$(distribute))
1058 # We used to simply export all these variables, but that frequently made the
1059 # environment get too large.  Instead, we write all the information into
1060 # a generated makefile fragment `distinfo', and then include it with -f in
1061 # the sub-make that makes the distribution (above).
1062 $(objpfx)distinfo: Makefile $(..)Makerules \
1063                    $(wildcard $(foreach dir,$(sysdirs),$(dir)/Makefile))
1064         $(make-target-directory)
1065         $(distinfo-vars)
1066         mv -f $@.new $@
1067 .PHONY: subdir_distinfo
1068 subdir_distinfo: $(objpfx)distinfo
1070 define distinfo-vars
1071 rm -f $@.new
1072 echo > $@.new 'subdir := $(subdir)'
1073 $(foreach var,subdir-dirs sources elided-routines sysdep_routines \
1074               headers sysdep_headers distribute dont_distribute generated \
1075               others tests test-srcs extra-libs $(extra-libs:%=%-routines) \
1076               versioned \
1077               $(addprefix install-,lib lib.so data bin sbin others),
1078 echo >> $@.new '$(subdir)-$(var) := $($(var))'
1079 echo >> $@.new '$(var) = $$($(subdir)-$(var))')
1080 endef
1082 ifneq (,$(strip $(gpl2lgpl)))
1083 ifneq (,$(wildcard $(..)gpl2lgpl.sed))
1084 # Snarf from the master source and frob the copying notice.
1085 $(gpl2lgpl): %: $(..)gpl2lgpl.sed /home/gd/gnu/lib/%
1086         sed -f $^ > $@-tmp
1087 # So I don't edit them by mistake.
1088         chmod a-w $@-tmp
1089         mv -f $@-tmp $@
1090 ifeq ($(with-cvs),yes)
1091         test ! -d CVS || cvs $(CVSOPTS) commit -m'Updated from $^' $@
1092 endif
1093 endif
1094 endif