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