update from main archive 961208
[glibc.git] / Makerules
blob1cb6855ffa949a3c934ff18260c7c7577ef953c1
1 # Copyright (C) 1991, 92, 93, 94, 95, 96 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 = $(shell echo "$(MAKE_VERSION)" | sed 's/ .*//')
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 # The name of the symbol table archive member.  The default is suitable for
76 # BSD style archives.  It can be overridden in sysdep Makefiles when SYSV
77 # style archive are used.
78 ifeq (no,$(elf))
79 ar-symtab-name = __.SYMDEF
80 else
81 ar-symtab-name = # The null name is used in ELF archives.
82 endif
84 # Include any system-specific makefiles.
86 # This is here so things in sysdep Makefiles can easily depend on foo.h as
87 # appropriate and not worry about where foo.h comes from, which may be
88 # system dependent and not known by that Makefile.
89 vpath %.h $(subst $(empty) ,:,$(strip $(common-objpfx) $(objpfx) \
90                                       $(+sysdep_dirs) $(..)))
92 # Some sysdep makefiles use this to distinguish being included here from
93 # being included individually by a subdir makefile (hurd/Makefile needs this).
94 in-Makerules := yes
96 ifndef avoid-generated
97 -include $(+sysdir_pfx)sysd-Makefile
98 ifneq ($(sysd-Makefile-sysdirs),$(config-sysdirs))
99 sysd-Makefile-force = FORCE
100 FORCE:
101 endif
102 $(+sysdir_pfx)sysd-Makefile: $(+sysdir_pfx)config.make $(..)Makerules \
103                              $(sysd-Makefile-force)
104         -@rm -f $@T
105         (echo 'sysd-Makefile-sysdirs := $(config-sysdirs)';                   \
106          for dir in $(config-sysdirs); do                                     \
107            file=$$dir/Makefile;                                               \
108            case $$dir in                                                      \
109              /*) rel= ;;                                                      \
110              *)  rel=$(..) ;;                                                 \
111            esac;                                                              \
112            if [ -f $$rel$$file ]; then                                        \
113              case $$dir in                                                    \
114                /*) echo include "$$file" ;;                                   \
115                *)  echo include "\$$(..)$$file" ;;                            \
116              esac;                                                            \
117            else true; fi;                                                     \
118          done;                                                                \
119          echo 'sysd-Makefile-done=t') > $@T
120         mv -f $@T $@
121 endif
123 ifndef sysd-Makefile-done
124 # Don't do deps until this exists, because it might change the sources list.
125 no_deps=t
126 endif
129 # Reorder before-compile so that mach things come first, and hurd things
130 # second, before all else.  The mach and hurd subdirectories have many
131 # generated header files which the much of rest of the library depends on,
132 # so it is best to build them first (and mach before hurd, at that).
133 before-compile := $(filter $(common-objpfx)mach% $(common-objpfx)hurd%,\
134                            $(before-compile)) \
135                   $(filter-out $(common-objpfx)mach% $(common-objpfx)hurd%,\
136                                $(before-compile))
138 # Remove existing files from `before-compile'.  Things are added there when
139 # they must exist for dependency generation to work right, but once they
140 # exist there is no further need for every single file to depend on them,
141 # and those gratuitous dependencies result in many gratuitous
142 # recompilations.
143 before-compile := $(filter-out $(wildcard $(before-compile)),$(before-compile))
145 # Don't let any before-compile file be an intermediate and get removed.
146 ifdef before-compile
147 $(before-compile):
148 endif
150 # Generate an ordered list of implicit rules which find the source files in
151 # each sysdep directory.  The old method was to use vpath to search all the
152 # sysdep directories.  However, that had the problem that a .S file in a
153 # later directory would be chosen over a .c file in an earlier directory,
154 # which does not preserve the desired sysdeps ordering behavior.
156 # When making the list of .d files to include, we can't know which ones
157 # have source in .s files, and thus do not in fact need a .d file.
158 # So we must define rules to make .d files for .s files.
159 define make-dummy-dep
160 $(addprefix ln $(common-objpfx)dummy.d ,$(filter-out $(wildcard $@),$@))
161 endef
162 $(common-objpfx)dummy.d:
163         echo '# .s files cannot contain includes, so they need no deps.' > $@
165 # It matters that this set of rules, for compiling from sources in
166 # the current directory (the $srcdir/$subdir) come before the
167 # generated sysdep rules in included from sysd-rules below.  When
168 # compiling in the source tree, generated sources go into the current
169 # directory, and those should be chosen before any sources in sysdeps.
170 $(objpfx)%.o: %.S $(before-compile); $(compile-command.S)
171 $(objpfx)%.so: %.S $(before-compile); $(compile-command.S)
172 $(objpfx)%.po: %.S $(before-compile); $(compile-command.S)
173 $(objpfx)%.go: %.S $(before-compile); $(compile-command.S)
174 $(objpfx)%.d: %.S $(before-compile); $(+make-deps)
175 $(objpfx)%.o: %.s $(before-compile); $(compile-command.s)
176 $(objpfx)%.so: %.s $(before-compile); $(compile-command.s)
177 $(objpfx)%.po: %.s $(before-compile); $(compile-command.s)
178 $(objpfx)%.go: %.s $(before-compile); $(compile-command.s)
179 $(objpfx)%.d: %.s $(common-objpfx)dummy.d; $(make-dummy-dep)
180 $(objpfx)%.o: %.c $(before-compile); $(compile-command.c)
181 $(objpfx)%.so: %.c $(before-compile); $(compile-command.c)
182 $(objpfx)%.po: %.c $(before-compile); $(compile-command.c)
183 $(objpfx)%.go: %.c $(before-compile); $(compile-command.c)
184 $(objpfx)%.d: %.c $(before-compile); $(+make-deps)
186 # Omit the objpfx rules when building in the source tree, because
187 # objpfx is empty and so these rules just override the ones above.
188 ifdef objpfx
189 # Define first rules to find the source files in $(objpfx).
190 # Generated source files will end up there.
191 $(objpfx)%.o: $(objpfx)%.S $(before-compile); $(compile-command.S)
192 $(objpfx)%.so: $(objpfx)%.S $(before-compile); $(compile-command.S)
193 $(objpfx)%.po: $(objpfx)%.S $(before-compile); $(compile-command.S)
194 $(objpfx)%.go: $(objpfx)%.S $(before-compile); $(compile-command.S)
195 $(objpfx)%.d: $(objpfx)%.S $(before-compile); $(+make-deps)
196 $(objpfx)%.o: $(objpfx)%.s $(before-compile); $(compile-command.s)
197 $(objpfx)%.so: $(objpfx)%.s $(before-compile); $(compile-command.s)
198 $(objpfx)%.po: $(objpfx)%.s $(before-compile); $(compile-command.s)
199 $(objpfx)%.go: $(objpfx)%.s $(before-compile); $(compile-command.s)
200 $(objpfx)%.d: $(objpfx)%.s $(common-objpfx)dummy.d; $(make-dummy-dep)
201 $(objpfx)%.o: $(objpfx)%.c $(before-compile); $(compile-command.c)
202 $(objpfx)%.so: $(objpfx)%.c $(before-compile); $(compile-command.c)
203 $(objpfx)%.po: $(objpfx)%.c $(before-compile); $(compile-command.c)
204 $(objpfx)%.go: $(objpfx)%.c $(before-compile); $(compile-command.c)
205 $(objpfx)%.d: $(objpfx)%.c $(before-compile); $(+make-deps)
206 endif
208 # System-dependent makefiles can put in `inhibit-sysdep-asm' wildcard
209 # patterns matching sysdep directories whose assembly source files should
210 # be suppressed.
211 ifdef inhibit-sysdep-asm
212 define open-check-inhibit-asm
213 case $$sysdir in $(subst $(empty) ,|,$(inhibit-sysdep-asm))) : ;; *)
214 endef
215 close-check-inhibit-asm = ;; esac ;
216 endif
218 # Don't include sysd-rules until sysd-Makefile is already there and has been
219 # included.  It might define inhibit-sysdep-asm, which would affect the
220 # contents of sysd-rules.
221 ifdef sysd-Makefile-done
222 -include $(+sysdir_pfx)sysd-rules
223 ifneq ($(sysd-rules-sysdirs),$(config-sysdirs))
224 # The value of $(+sysdep_dirs) the sysd-rules was computed for
225 # differs from the one we are using now.  So force a rebuild of sysd-rules.
226 sysd-rules-force = FORCE
227 FORCE:
228 endif
229 endif
230 $(+sysdir_pfx)sysd-rules: $(+sysdir_pfx)config.make $(..)Makerules \
231                           $(wildcard $(foreach dir,$(sysdirs),\
232                                                $(dir)/Makefile))\
233                           $(sysd-rules-force)
234         -@rm -f $@T
235         (echo 'sysd-rules-sysdirs := $(config-sysdirs)';                      \
236          for sysdir in $(config-sysdirs); do                                  \
237            case $$sysdir in \
238              /*) dir=$$sysdir ;; \
239              *)  dir="\$$(..)$$sysdir" ;; \
240            esac; \
241            for o in $(object-suffixes); do \
242              $(open-check-inhibit-asm) \
243              echo "\$$(objpfx)%$$o: $$dir/%.S \$$(before-compile); \
244                   \$$(compile-command.S)";                                    \
245              echo "\$$(objpfx)%$$o: $$dir/%.s \$$(before-compile); \
246                   \$$(compile-command.s)";                                    \
247              $(close-check-inhibit-asm) \
248              echo "\$$(objpfx)%$$o: $$dir/%.c \$$(before-compile); \
249                   \$$(compile-command.c)";                                    \
250            done; \
251            $(open-check-inhibit-asm) \
252            echo "\$$(objpfx)%.d: $$dir/%.s \$$(common-objpfx)dummy.d; \
253                 \$$(make-dummy-dep)";                          \
254            echo "\$$(objpfx)%.d: $$dir/%.S \$$(before-compile); \
255                 \$$(+make-deps)";                                             \
256            $(close-check-inhibit-asm)   \
257            echo "\$$(objpfx)%.d: $$dir/%.c \$$(before-compile); \
258                 \$$(+make-deps)";                                             \
259          done;                                                                \
260          echo 'sysd-rules-done = t') > $@T
261         mv -f $@T $@
263 ifndef sysd-rules-done
264 # Don't do deps until this exists, because it provides rules to make the deps.
265 no_deps=t
266 endif
269 ifndef compile-command.S
270 compile-command.S = $(compile.S) $(OUTPUT_OPTION)
271 endif
272 ifndef compile-command.s
273 compile-command.s = $(COMPILE.s) $< $(OUTPUT_OPTION)
274 endif
275 ifndef compile-command.c
276 compile-command.c = $(compile.c) $(OUTPUT_OPTION)
277 endif
279 # GCC can grok options after the file name, and it looks nicer that way.
280 compile.c = $(CC) $< -c $(CFLAGS) $(CPPFLAGS)
281 compile.S = $(CC) $< -c $(CPPFLAGS) -DASSEMBLER $(asm-CPPFLAGS)
282 COMPILE.S = $(CC) -c $(CPPFLAGS) -DASSEMBLER $(asm-CPPFLAGS)
283 COMPILE.s = $(filter-out -pipe,$(CC)) -c $(ASFLAGS)
285 # We need this for the output to go in the right place.  It will default to
286 # empty if make was configured to work with a cc that can't grok -c and -o
287 # together.  You can't compile the C library with such a compiler.
288 OUTPUT_OPTION = -o $@
290 S-CPPFLAGS = $(asm-CPPFLAGS)
291 define +make-deps
292 $(make-target-directory)
293 -@rm -f $@
294 $(+mkdep) $< $(CPPFLAGS) $($(<:$*.%=%)-CPPFLAGS) | \
295 sed -e 's,$(subst .,\.,$*)\.o,$(foreach o,$(object-suffixes),$(@:.d=$o)) $@,' \
296 $(sed-remove-objpfx) > $(@:.d=.T)
297 mv -f $(@:.d=.T) $@
298 endef
299 ifneq (,$(objpfx))
300 # Continuation lines here are dangerous because they introduce spaces!
301 define sed-remove-objpfx
302 -e 's@ $(subst .,\.,$(subst @,\@,$(common-objpfx)))@ $$(common-objpfx)@g' \
303 -e 's@^$(subst .,\.,$(subst @,\@,$(common-objpfx)))@$$(common-objpfx)@g'
304 endef
305 endif
307 # Shared library building.
309 ifeq (yes,$(build-shared))
311 # Pattern rule to build a shared object from an archive of PIC objects.
312 # This must come after the installation rules so Make doesn't try to
313 # build shared libraries in place from the installed *_pic.a files.
314 # $(LDLIBS-%.so) may contain -l switches to generate run-time dependencies
315 # on other shared objects.
316 lib%.so: lib%_pic.a; $(build-shlib)
318 ifeq ($(have-no-whole-archive),yes)
319 no-whole-archive = -Wl,--no-whole-archive
320 else
321 no-whole-archive =
322 endif
324 interp-obj = $(common-objpfx)interp.so
325 $(interp-obj): $(common-objpfx)%.so: $(..)%.c
326         $(compile-command.c)
327 common-generated += interp.so
328 CFLAGS-interp.c = -D'RUNTIME_LINKER="$(slibdir)/$(rtld-installed-name)"'
330 $(common-objpfx)libc.so: $(interp-obj)
331 $(patsubst %,$(objpfx)%.so,$(extra-libs)): $(interp-obj)
333 define build-shlib
334 $(LINK.o) -shared -o $@ $(sysdep-LDFLAGS) $(config-LDFLAGS)  \
335           -B$(csu-objpfx) \
336           -Wl,-soname=lib$(libprefix)$(@F:lib%.so=%).so$($(@F)-version) \
337           $(LDFLAGS.so) $(LDFLAGS-$(@F:lib%.so=%).so) \
338           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link) \
339           -Wl,--whole-archive $^ $(no-whole-archive) \
340           $(LDLIBS-$(@F:lib%.so=%).so)
341 endef
343 # Don't try to use -lc when making libc.so itself.
344 # Also omits crti.o and crtn.o, which we do not want
345 # since we define our own `.init' section specially.
346 LDFLAGS-c.so = -nostdlib -nostartfiles
347 # Give libc.so an entry point and make it directly runnable itself.
348 LDFLAGS-c.so += -e __libc_main
349 # Use our own special initializer and finalizer files for libc.so.
350 $(common-objpfx)libc.so: $(elfobjdir)/soinit.so \
351                          $(common-objpfx)libc_pic.a \
352                          $(elfobjdir)/sofini.so $(elfobjdir)/ld.so
353         $(build-shlib)
355 ifdef libc.so-version
356 $(common-objpfx)libc.so$(libc.so-version): $(common-objpfx)libc.so
357         rm -f $@
358         ln -s $(<F) $@ || ln $< $@
359 endif
360 endif
362 # Some files must not be compiled with the exception handler mechanism
363 # enabled (introduced in gcc-2.8).  Use $(no-exceptions) in the
364 # appropriate CFLAGS definition.
365 ifeq ($(have-no-exceptions),yes)
366 no-exceptions = -fno-exceptions
367 else
368 no-exceptions =
369 endif
371 # Figure out the source filenames in this directory.
373 override sources        := $(addsuffix .c,$(filter-out $(elided-routines),\
374                                                        $(routines) $(aux) \
375                                                        $(sysdep_routines)))
376 sysdep_routines := $(sysdep_routines)
378 headers := $(headers) $(sysdep_headers)
380 # This is the list of all object files, gotten by
381 # replacing every ".c" in `sources' with a ".o".
382 override objects        := $(addprefix $(objpfx),$(sources:.c=.o))
385 # This variable is used in ``include $(o-iterator)'' after defining
386 # $(o-iterator-doit) to produce some desired rule using $o for the object
387 # suffix, and setting $(object-suffixes-left) to $(object-suffixes); a copy
388 # is produced for each object suffix in use.
389 o-iterator = $(patsubst %,$(..)o-iterator.mk,$(object-suffixes-left))
391 # The makefile may define $(extra-libs) with `libfoo libbar'
392 # to build libfoo.a et al from the modules listed in $(libfoo-routines).
393 ifdef extra-libs
394 # extra-lib.mk is included once for each extra lib to define rules
395 # to build it, and to add its objects to the various variables.
396 # During its evaluation, $(lib) is set to the name of the library.
397 extra-libs-left := $(extra-libs)
398 include $(patsubst %,$(..)extra-lib.mk,$(extra-libs))
399 endif
401 +depfiles := $(strip $(sources:.c=.d) \
402                      $(patsubst %.o,%.d,$(filter %.o,$(extra-objs:.so=.o))) \
403                      $(addsuffix .d,$(others) $(tests)))
404 +depfiles := $(addprefix $(objpfx),\
405                          $(filter-out $(addsuffix .d,$(omit-deps)),\
406                                       $(+depfiles)))
408 ifdef +depfiles
409 ifneq ($(no_deps),t)
410 -include $(+depfiles)
411 endif
412 endif
413 \f\f
414 # Maximize efficiency by minimizing the number of rules.
415 .SUFFIXES:      # Clear the suffix list.
416 # Add the suffixes we use.
417 .SUFFIXES: .a $(object-suffixes) .S .s .c .h .d
419 # Generic rule for making directories.
421 # mkdir isn't smart enough to strip a trailing /.
422         mkdir $(@:%/=%)
424 # Make sure that object files are not removed
425 # when they are intermediates between sources and library members.
426 .PRECIOUS: $(addprefix $(objpfx)%,$(object-suffixes))
428 # Make sure that the parent library archive is never removed.
429 .PRECIOUS: $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
431 # Use the verbose option of ar and tar when not running silently.
432 ifeq    "$(findstring s,$(MAKEFLAGS))" ""       # if not -s
433 verbose := v
434 else                                            # -s
435 verbose :=
436 endif                                           # not -s
438 ARFLAGS := r$(verbose)
440 # This makes all the object files in the parent library archive.
442 .PHONY: lib libobjs lib-noranlib
443 lib: lib-noranlib $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
445 # Pattern rule for libraries: depend on the __.SYMDEF member updated by ranlib.
446 lib%.a: lib%.a($(ar-symtab-name)) ;
448 # For object-suffix $o, the list of objects with that suffix.
449 # Makefiles can define `elide-routines.so = foo' to leave foo.so out.
450 o-objects = $(patsubst %.o,%$o,$(filter-out $(patsubst %,$(objpfx)%.o,\
451                                                        $(elide-routines$o)),\
452                                             $(objects)))
454 libobjs: $(foreach o,$(object-suffixes),\
455                    $(common-objpfx)$(patsubst %,$(libtype$o),c)(\
456                    $(notdir $(o-objects))))
457 lib-noranlib: libobjs
458 others: $(addprefix $(objpfx),$(install-lib))
460 ifndef objects
462 # Create the stamp$o files to keep the parent makefile happy.
463 subdir_lib: $(foreach o,$(object-suffixes),$(objpfx)stamp$o-$(subdir))
464 $(foreach o,$(object-suffixes),$(objpfx)stamp$o-$(subdir)):
465         $(make-target-directory)
466         rm -f $@; > $@
467 else
469 # Define a pattern rule that will match many targets libc.a(foo.%), for
470 # each foo.o in $(objects) (% will just happen always to match `o').  This is
471 # the only way to define a rule that updates many targets at once with one
472 # sequence of commands.
473 define o-iterator-doit
474 $(common-objpfx)$(patsubst %,$(libtype$o),c)(\
475 $(addsuffix .%,$(filter-out $(elide-routines$o),$(notdir $(objects:.o=))))): \
476   $(objpfx)stamp.%-$(subdir) ;
477 endef
478 object-suffixes-left := $(object-suffixes)
479 include $(o-iterator)
481 # The pattern rule tells Make to remake $(objpfx)stamp.%-$(subdir) as
482 # the way to update all the foo.% object files in $(objects).  Now we
483 # define explicit rules to update each $(objpfx)stamp.SUFFIX-$(subdir)
484 # timestamp file; these rules (one explicit rule is generated for each
485 # object suffix) will update the parent archive with ar.  Use a static
486 # pattern rule so $* is set to the object type during the commands.
487 define o-iterator-doit
488 $(objpfx)stamp$o-$(subdir): $(objpfx)stamp%-$(subdir): $(o-objects); $$(do-ar)
489 endef
490 object-suffixes-left := $(object-suffixes)
491 include $(o-iterator)
492 define do-ar
493 topdir=`cd $(..).; pwd`; \
494 $(patsubst %/,cd %;,$(objpfx)) \
495 $(SHELL) $$topdir/autolock.sh ${O%-lib}.lck $(AR) cru$(verbose) ${O%-lib} \
496                                                   $(patsubst $(objpfx)%,%,$^)
497 rm -f $@
498 touch $@
499 endef
500 O%-lib = $(..)$(patsubst %,$(libtype$*),c)
502 endif
504 # Rules to update the $(ar-symtab-name) member with ranlib,
505 # one for each object flavor.
506 define o-iterator-doit
507 $(common-objpfx)$(patsubst %,$(libtype$o),c)($(ar-symtab-name)): \
508           $(common-objpfx)$(patsubst %,$(libtype$o),c)(\
509             $(patsubst $(objpfx)%,%,$(o-objects))) $(subdirs-stamp-o); \
510         $(SHELL) $$(..)./autolock.sh \
511           $$(common-objpfx)$$(patsubst %,$$(libtype$o),c).lck \
512           $$(RANLIB) $$(common-objpfx)$$(patsubst %,$$(libtype$o),c)
513 endef
514 ifndef subdir
515 subdirs-stamps := $(foreach d,$(subdirs),$(common-objpfx)$d/stamp%-$d)
516 subdirs-stamp-o = $(subst %,$o,$(subdirs-stamps))
517 $(subdirs-stamps): subdir_lib;
518 endif
519 object-suffixes-left = $(object-suffixes)
520 include $(o-iterator)
523 # This makes all the object files.
524 .PHONY: objects objs
525 objects objs: $(foreach o,$(object-suffixes),$(o-objects)) \
526               $(addprefix $(objpfx),$(extra-objs))
528 # Canned sequence for building an extra library archive.
529 define build-extra-lib
530 $(patsubst %/,cd %;,$(objpfx)) \
531 $(AR) cru$(verbose) $(@:$(objpfx)%=%) \
532       $(patsubst $(objpfx)%,%,$^)
533 $(RANLIB) $@
534 endef
536 # Installation.
538 # $(install-lib) are installed from the object directory into $(libdir);
539 # files in $(install-lib) matching `lib%.a' are ranlib'd after installation
540 # unless they also appear in $(non-lib.a).  $(install-data) are installed
541 # as they are into $(datadir).  $(headers) are installed as they are in
542 # $(includedir).  $(install-bin) and $(install-sbin) are installed from the
543 # object directory into $(bindir) and $(sbindir), respectively.
544 # $(install-others) are absolute path names of files to install; rules to
545 # install them are defined elsewhere.
547 # The simple library name to install libc.a under.
548 # This could be defined by a sysdep Makefile.
549 ifndef libc-name
550 libc-name := c
551 endif
553 define do-install
554 $(make-target-directory)
555 $(INSTALL_DATA) $< $@
556 endef
558 # Make the target directory if it doesn't exist, using the `mkinstalldirs'
559 # script that does `mkdir -p' even if `mkdir' doesn't support that flag.
560 define make-target-directory
561 $(addprefix $(..)./mkinstalldirs ,\
562             $(filter-out $(wildcard $(@D:%/=%)),$(@D:%/=%)))
563 endef
565 # Any directory (parent or subdir) that has any object files to build
566 # should install libc.a; this way "make install" in a subdir is guaranteed
567 # to install everything it changes.
568 ifdef objects
569 installed-libcs := $(foreach o,$(object-suffixes),\
570                              $(libdir)/$(patsubst %,$(libtype$o),\
571                                                   $(libprefix)$(libc-name)))
572 installed-libcs := $(filter-out %_pic.a,$(installed-libcs))
573 install: $(installed-libcs)
574 $(installed-libcs): $(libdir)/lib$(libprefix)%: lib
575         $(make-target-directory)
576         $(INSTALL_DATA) $(common-objpfx)lib$(*:$(libc-name)%=c%) $@
577 # Running ranlib after installing makes the __.SYMDEF time stamp up to
578 # date, which avoids messages from some linkers.
579         $(RANLIB) $@
580 endif
582 define do-install-program
583 $(make-target-directory)
584 $(INSTALL_PROGRAM) $< $@.new
585 mv -f $@.new $@
586 endef
588 install-lib.so := $(filter %.so,$(install-lib:%_pic.a=%.so))
589 install-lib := $(filter-out %.so %_pic.a,$(install-lib))
590 ifeq (yes,$(build-shared))
592 install-lib-nosubdir: $(install-lib.so:%=$(libdir)/%)
594 # Find which .so's have versions.
595 versioned := $(strip $(foreach so,$(install-lib.so),\
596                                $(patsubst %,$(so),$($(so)-version))))
598 # Install all the unversioned shared libraries.
599 $(addprefix $(slibdir)/,$(filter-out $(versioned),$(install-lib.so))): \
600 $(slibdir)/%.so: $(objpfx)%.so; $(do-install-program)
602 ifneq ($(findstring -s,$(LN_S)),)
603 define make-link
604 rm -f $@.new; \
605 if test '$(@D)' = '$(<D)'; then \
606   (cd $(@D); $(LN_S) $(<F) $(@F).new); \
607 else \
608   $(SHELL) $(..)rellns-sh $< $@.new; \
609 fi; \
610 mv -f $@.new $@
611 endef
612 else
613 # If we have no symbolic links don't bother with rellns-sh.
614 define make-link
615 rm -f $@.new; \
616 $(LN_S) $< $@.new; \
617 mv -f $@.new $@
618 endef
619 endif
621 ifdef libc.so-version
622 # For a library specified to be version N, install three files:
623 # libc.so       ->      libc.so.N       (e.g. libc.so.6)
624 # libc.so.6     ->      libc-VERSION.so (e.g. libc-1.10.so)
626 $(slibdir)/libc.so$(libc.so-version): $(slibdir)/libc-$(version).so
627         $(make-link)
628 $(slibdir)/libc-$(version).so: $(common-objpfx)libc.so; $(do-install-program)
629 install: $(slibdir)/libc.so$(libc.so-version)
631 ifndef subdir
632 # What we install as libc.so for programs to link against is in fact a
633 # link script.  It contains references for the various libraries we need.
634 # The libc.so object is not complete since some functions are only defined
635 # in libc.a and the dynamic linker is an etra object.
636 install: $(libdir)/libc.so
637 $(libdir)/libc.so: $(common-objpfx)libc.so$(libc.so-version) \
638                    $(elfobjdir)/$(rtld-installed-name) \
639                    $(libdir)/lib$(libc-name).a
640         (echo '/* GNU ld script';\
641          echo '   Use the shared library, but some functions are only in';\
642          echo '   the static library, so try that secondarily.'; \
643          echo '   The dynamic linker defines some functions used by $(<F),';\
644          echo '   but ld uses definitions from libc.a before examining the';\
645          echo '   dependencies of $(<F) to find $(rtld-installed-name).  */';\
646          echo 'GROUP ( $(^F) )') > $@.new
647         mv -f $@.new $@
649 endif
651 else
652 install: $(slibdir)/libc.so
653 $(slibdir)/libc.so: $(common-objpfx)libc.so; $(do-install-program)
654 endif
657 ifneq (,$(versioned))
658 # Produce three sets of rules as above for all the smaller versioned libraries.
660 define o-iterator-doit
661 $(libdir)/$o: $(slibdir)/$o$($o-version); $$(make-link)
662 endef
663 object-suffixes-left := $(versioned)
664 include $(o-iterator)
666 # Make symlinks in the build directory, because the versioned names might
667 # be referenced by a DT_NEEDED in another library.
668 define o-iterator-doit
669 $(objpfx)$o$($o-version): $(objpfx)$o; $$(make-link)
670 endef
671 object-suffixes-left := $(versioned)
672 include $(o-iterator)
675 ifeq (,$($(subdir)-version))
676 define o-iterator-doit
677 $(slibdir)/$o$($o-version): $(slibdir)/$(o:.so=)-$(version).so; $$(make-link)
678 endef
679 object-suffixes-left := $(versioned)
680 include $(o-iterator)
682 define o-iterator-doit
683 $(slibdir)/$(o:.so=)-$(version).so: $(objpfx)$o; $$(do-install-program)
684 endef
685 object-suffixes-left := $(versioned)
686 include $(o-iterator)
687 else
688 define o-iterator-doit
689 $(slibdir)/$o$($o-version): $(slibdir)/$(o:.so=)-$($(subdir)-version).so;
690         $$(make-link)
691 endef
692 object-suffixes-left := $(versioned)
693 include $(o-iterator)
695 define o-iterator-doit
696 $(slibdir)/$(o:.so=)-$($(subdir)-version).so: $(objpfx)$o;
697         $$(do-install-program)
698 endef
699 object-suffixes-left := $(versioned)
700 include $(o-iterator)
701 endif
702 endif
704 define do-install-so
705 $(do-install-program)
706 $(patsubst %,ln -s -f $(@F) $(@D)/$(patsubst %$*.so,%,$(<F))$(libprefix)$*.so,\
707            $(filter-out %.so,$@))
708 endef
710 so-versions := $(sort $(foreach so,$(install-lib.so),.so$($(so)-version)))
711 $(foreach v,$(so-versions),\
712           $(slibdir)/lib$(libprefix)%$v): $(common-objpfx)lib%.so
713         $(do-install-so)
714 $(foreach v,$(so-versions),\
715           $(slibdir)/$(libprefix)%$v): $(common-objpfx)%.so
716         $(do-install-so)
717 endif
719 ifdef install-bin
720 $(addprefix $(bindir)/,$(install-bin)): $(bindir)/%: $(objpfx)%
721         $(do-install-program)
722 endif
723 ifdef install-sbin
724 $(addprefix $(sbindir)/,$(install-sbin)): $(sbindir)/%: $(objpfx)%
725         $(do-install-program)
726 endif
727 ifdef install-lib
728 install-lib.a := $(filter lib%.a,$(install-lib))
729 install-lib-non.a := $(filter-out lib%.a,$(install-lib))
730 ifdef install-lib-non.a
731 $(addprefix $(libdir)/$(libprefix),$(install-lib-non.a)): \
732   $(libdir)/$(libprefix)%: $(objpfx)%
733         $(do-install)
734 endif
735 ifdef install-lib.a
736 $(install-lib.a:lib%.a=$(libdir)/lib$(libprefix)%.a): \
737   $(libdir)/lib$(libprefix)%.a: $(objpfx)lib%.a
738         $(do-install)
739         $(patsubst %,$(RANLIB) $@,$(filter-out $(non-lib.a),$(<F)))
740 endif
741 endif
742 ifdef install-data
743 $(addprefix $(datadir)/,$(install-data)): $(datadir)/%: %;$(do-install)
744 endif
745 headers := $(strip $(headers))
746 ifdef headers
747 $(addprefix $(includedir)/,$(headers)): \
748         $(includedir)/%: %;$(do-install)
749 endif   # headers
751 .PHONY: install-bin-nosubdir install-sbin-nosubdir install-lib-nosubdir \
752         install-data-nosubdir install-headers-nosubdir
753 install-bin-nosubdir: $(addprefix $(bindir)/,$(install-bin))
754 install-sbin-nosubdir: $(addprefix $(sbindir)/,$(install-sbin))
755 install-lib-nosubdir: $(addprefix $(libdir)/,\
756                        $(patsubst lib%.a,lib$(libprefix)%.a,$(install-lib.a)) \
757                        $(addprefix $(libprefix),$(install-lib-non.a)))
758 install-data-nosubdir: $(addprefix $(datadir)/,$(install-data))
759 install-headers-nosubdir: $(addprefix $(includedir)/,$(headers))
760 install-others-nosubdir: $(install-others)
762 # We need all the `-nosubdir' targets so that `install' in the parent
763 # doesn't depend on several things which each iterate over the subdirs.
764 # This rule makes `install-FOO' always use `install-FOO-nosubdir' as a
765 # subroutine.  Then in the parent `install-FOO' also causes subdir makes.
766 install-%:: install-%-nosubdir ;
768 .PHONY: install install-no-libc.a-nosubdir
769 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir\
770                             install-bin-nosubdir install-lib-nosubdir   \
771                             install-others-nosubdir install-sbin-nosubdir
772 install: install-no-libc.a-nosubdir
774 # Command to compile $< in $(objdir) using the native libraries.
775 define native-compile
776 cwd=`pwd`; cd $(@D); $(BUILD_CC) $(BUILD_CFLAGS) \
777            $(addprefix $$cwd/,$^) -o $(@F)
778 endef
780 # Command to compile $< in $(common-objdir) using the native libraries.
781 # We must cd to $(objdir) anyway so that $(..)config.h is valid.
782 define common-objdir-compile
783 cd $(objpfx).; \
784 $(BUILD_CC) $(BUILD_CFLAGS) $(<:$(common-objpfx)%=$(..)%) -o $(..)$(@F)
785 endef
787 # We always want to use configuration definitions.
788 BUILD_CFLAGS = -include $(..)config.h
790 # Support the GNU standard name for this target.
791 .PHONY: check
792 check: tests
794 .PHONY: TAGS
795 TAGS: $(common-objpfx)distinfo-$(subdir) $(..)MakeTAGS
796         $(MAKE) $(addprefix -f ,$^) $@
798 $(..)po/%.pot: $(common-objpfx)distinfo-$(subdir) $(..)MakeTAGS FORCE
799         $(MAKE) $(addprefix -f ,$(filter-out FORCE,$^)) $@
800 FORCE:
803 .PHONY: echo-headers
804 echo-headers:
805         @echo $(headers)
808 # Common cleaning targets.
810 .PHONY: common-mostlyclean common-clean mostlyclean clean
811 clean: common-clean
812 mostlyclean: common-mostlyclean
814 # Remove the object files.
815 common-mostlyclean:
816         -rm -f $(addprefix $(objpfx),$(tests) $(others) \
817                                      $(addsuffix .o,$(tests) $(others)) \
818                                      $(addsuffix .out,$(tests)))
819         -rm -f $(addprefix $(objpfx),$(extra-objs) $(install-lib))
820         -rm -f core $(common-objpfx)stub-$(subdir)
821         $(rmobjs)
822 define rmobjs
823 $(foreach o,$(object-suffixes),
824 -rm -f $(addprefix $(objpfx),stamp$o-$(subdir)) $(o-objects))
825 endef
827 # Also remove the dependencies and generated source files.
828 common-clean: common-mostlyclean
829         -rm -f $(addprefix $(objpfx),$(generated)) $(+depfiles)
830         -rm -f $(addprefix $(common-objpfx),$(common-generated))
831         -rm -f $(common-objpfx)distinfo-$(subdir)
833 # Produce a file `stub-$(subdir)' which contains `#define __stub_FUNCTION'
834 # for each function which is a stub.  We grovel over all the .d files
835 # looking for references to source files in sysdeps/stub.  Then we grovel
836 # over each referenced source file to see what stub function it defines.
838 .PHONY: stubs # The parent Makefile calls this target.
839 stubs: $(common-objpfx)stub-$(subdir)
840 s = $(sysdep_dir)/stub
841 $(common-objpfx)stub-$(subdir): $(+depfiles)
842 # Use /dev/null since `...` might expand to empty.
843         (s=`cd $s; /bin/pwd`; \
844          $(patsubst %/,cd %;,$(objpfx)) \
845          sed -n 's/^stub_warning *(\([^)]*\).*$$/#define __stub_\1/p' \
846              `sed -n 's@^.*$s/\([a-z0-9_-]*\.c\).*$$@'"$$s"/'\1@p' \
847                   $(patsubst $(objpfx)%,%,$^) /dev/null` \
848              /dev/null) > $@T
849         mv -f $@T $@
851 # Make the distribution tar file.
853 .PHONY: dist
854 dist: $(common-objpfx)distinfo-$(subdir) $(..)Make-dist
855         $(MAKE) -f $< -f $(word 2,$^) $(Make-dist-args)
857 # Avoid depending on source files found in sysdeps dirs,
858 # because the references affect implicit rule selection.
859 dist: $(filter-out %.c %.S %.s,$(distribute))
861 # We used to simply export all these variables, but that frequently made the
862 # environment get too large.  Instead, we write all the information into
863 # a generated makefile fragment `distinfo', and then include it with -f in
864 # the sub-make that makes the distribution (above).
865 $(common-objpfx)distinfo-$(subdir): Makefile $(..)Makerules
866         $(distinfo-vars)
867         mv -f $@.new $@
868 .PHONY: subdir_distinfo distinfo
869 subdir_distinfo: distinfo
870 distinfo: $(common-objpfx)distinfo-$(subdir)
872 define distinfo-vars
873 rm -f $@.new
874 echo > $@.new 'subdir := $(subdir)'
875 $(foreach var,subdir-dirs sources elided-routines sysdep_routines \
876               headers sysdep_headers distribute dont_distribute generated \
877               others tests extra-libs $(extra-libs:%=%-routines) \
878               versioned \
879               $(addprefix install-,lib lib.so data bin sbin others),
880 echo >> $@.new '$(subdir)-$(var) := $($(var))'
881 echo >> $@.new '$(var) = $$($(subdir)-$(var))')
882 endef
884 ifneq (,$(strip $(gpl2lgpl)))
885 ifneq (,$(wildcard $(..)gpl2lgpl.sed))
886 # Snarf from the master source and frob the copying notice.
887 $(gpl2lgpl): %: $(..)gpl2lgpl.sed /home/gd/gnu/lib/%
888         sed -f $^ > $@-tmp
889 # So I don't edit them by mistake.
890         chmod a-w $@-tmp
891         mv -f $@-tmp $@
892         test ! -d CVS || cvs commit -m'Updated from $^' $@
893 endif
894 endif