Makerules

   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.
   4
   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.
   9
  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.
  14
  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.
  19
  20 #
  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).
  24 #
  25 ifneq (,)
  26 This makefile requires GNU Make.
  27 endif
  28
  29 REQUIRED_MAKE_VERSION = 3.74
  30 REAL_MAKE_VERSION = $(firstword $(MAKE_VERSION))
  31
  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
  36
  37
  38 ifdef   subdir
  39 ..      := ../
  40 endif   # subdir
  41
  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
  47
  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
  55 \f
  56 ifndef +included-Makeconfig
  57 include $(..)Makeconfig
  58 endif
  59
  60 # `configure' writes a definition of `config-sysdirs' in `config.make'.
  61 sysdirs = $(strip $(full-config-sysdirs))
  62
  63 +sysdir_pfx = $(common-objpfx)
  64
  65 export sysdirs := $(sysdirs)
  66
  67 +sysdep_dirs := $(full-config-sysdirs)
  68 ifdef objdir
  69 +sysdep_dirs := $(objdir) $(+sysdep_dirs)
  70 endif
  71
  72 # Add -I switches to get the right sysdep directories.
  73 # `+includes' in Makeconfig references $(+sysdep-includes).
  74 +sysdep-includes := $(addprefix -I,$(+sysdep_dirs))
  75
  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))
  81 \f
  82 # Include any system-specific makefiles.
  83
  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) $(..)))
  89
  90 # The same is true for RPC source files.
  91 vpath %.x $(subst $(empty) ,:,$(strip $(common-objpfx) $(objpfx) \
  92                                       $(+sysdep_dirs) $(..)))
  93
  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
  97
  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
 116
 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
 121
 122
 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))
 131
 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
 142
 143
 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))
 150
 151 # Don't let any before-compile file be an intermediate and get removed.
 152 ifdef before-compile
 153 $(before-compile):
 154 endif
 155 \f
 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.
 161
 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.' > $@
 170
 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)
 182
 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)
 189
 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)
 196
 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)
 208
 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)
 215
 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
 223
 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
 233
 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 $@
 274
 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
 279
 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
 287
 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
 320
 321
 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
 331
 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)
 339
 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
 348
 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 $@
 353
 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
 371 \f
 372 # Shared library building.
 373
 374 ifeq (yes,$(build-shared))
 375
 376 # Reference map file only when versioning is selected and a map file name
 377 # is given.
 378 ifeq ($(versioning),yes)
 379 map-file = $(firstword $($(@F:.so=-map)) \
 380                        $(addprefix $(common-objpfx), \
 381                                    $(filter $(@F:.so=.map),$(version-maps))))
 382 load-map-file = $(map-file:%=-Wl,--version-script=%)
 383 endif
 384
 385 # Pattern rule to build a shared object from an archive of PIC objects.
 386 # This must come after the installation rules so Make doesn't try to
 387 # build shared libraries in place from the installed *_pic.a files.
 388 # $(LDLIBS-%.so) may contain -l switches to generate run-time dependencies
 389 # on other shared objects.
 390 lib%.so: lib%_pic.a $(+preinit) $(+postinit) $(+interp)
 391         $(build-shlib)
 392
 393 define build-shlib
 394 $(LINK.o) -shared -Wl,-O1 -o $@ $(sysdep-LDFLAGS) $(config-LDFLAGS)  \
 395           -B$(csu-objpfx) $(load-map-file) \
 396           -Wl,-soname=lib$(libprefix)$(@F:lib%.so=%).so$($(@F)-version) \
 397           $(LDFLAGS.so) $(LDFLAGS-$(@F:lib%.so=%).so) \
 398           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link) \
 399           -Wl,--whole-archive \
 400           $(filter-out $(map-file) $(+preinit) $(+postinit),$^) \
 401           $(no-whole-archive) $(LDLIBS-$(@F:lib%.so=%).so)
 402 endef
 403
 404 # This macro is similar to build-shlib but it does not define a soname
 405 # and it does not depend on the destination name to start with `lib'.
 406 define build-module
 407 $(LINK.o) -shared -o $@ $(sysdep-LDFLAGS) $(config-LDFLAGS)  \
 408           -B$(csu-objpfx) $(load-map-file) \
 409           $(LDFLAGS.so) $(LDFLAGS-$(@F:%.so=%).so) \
 410           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link) \
 411           -Wl,--whole-archive \
 412           $(filter-out $(map-file) $(+preinit) $(+postinit),$^) \
 413           $(no-whole-archive) $(LDLIBS-$(@F:%.so=%).so)
 414 endef
 415
 416 ifndef libc.so-version
 417 # Undefine this because it can't work when we libc.so is unversioned.
 418 static-only-routines =
 419 endif
 420
 421 elide-routines.oS += $(filter-out $(static-only-routines),\
 422                                   $(routines) $(aux) $(sysdep_routines))
 423 elide-routines.os += $(static-only-routines)
 424
 425 # If we have versioned code we don't need the old versions in any of the
 426 # static libraries.
 427 elide-routines.o  += $(shared-only-routines)
 428 elide-routines.op += $(shared-only-routines)
 429 elide-routines.og += $(shared-only-routines)
 430 elide-routines.ob += $(shared-only-routines)
 431
 432 # Don't try to use -lc when making libc.so itself.
 433 # Also omits crti.o and crtn.o, which we do not want
 434 # since we define our own `.init' section specially.
 435 LDFLAGS-c.so = -nostdlib -nostartfiles
 436 # But we still want to link libc.so against $(gnulib).
 437 LDLIBS-c.so += $(gnulib)
 438 # Give libc.so an entry point and make it directly runnable itself.
 439 LDFLAGS-c.so += -e __libc_main
 440 # Force the backward compatibility EH functions to be linked.
 441 LDFLAGS-c.so += -u __register_frame
 442 # Pre-link the objects of libc_pic.a so that we can locally resolve
 443 # COMMON symbols before we link against ld.so.  This is because ld.so
 444 # contains some of libc_pic.a already, which will prevent the COMMONs
 445 # from being allocated in libc.so, which introduces evil dependencies
 446 # between libc.so and ld.so, which can make it impossible to upgrade.
 447 $(common-objpfx)libc_pic.os: $(common-objpfx)libc_pic.a
 448         $(LINK.o) -nostdlib -nostartfiles -r -o $@ \
 449         -Wl,-d -Wl,--whole-archive $^
 450 # Use our own special initializer and finalizer files for libc.so.
 451 $(common-objpfx)libc.so: $(elfobjdir)/soinit.os \
 452                          $(common-objpfx)libc_pic.os \
 453                          $(elfobjdir)/sofini.os \
 454                          $(elfobjdir)/interp.os $(elfobjdir)/ld.so
 455         $(build-shlib)
 456 ifeq ($(versioning),yes)
 457 $(common-objpfx)libc.so: $(common-objpfx)libc.map
 458 endif
 459 common-generated += libc.so libc_pic.os
 460 ifdef libc.so-version
 461 $(common-objpfx)libc.so$(libc.so-version): $(common-objpfx)libc.so
 462         $(make-link)
 463 common-generated += libc.so$(libc.so-version)
 464 endif
 465 endif
 466 \f
 467 # Figure out the source filenames in this directory.
 468
 469 override sources        := $(addsuffix .c,$(filter-out $(elided-routines),\
 470                                                        $(routines) $(aux) \
 471                                                        $(sysdep_routines)))
 472 sysdep_routines := $(sysdep_routines)
 473
 474 headers := $(headers) $(sysdep_headers)
 475
 476 # This is the list of all object files, gotten by
 477 # replacing every ".c" in `sources' with a ".o".
 478 override objects        := $(addprefix $(objpfx),$(sources:.c=.o))
 479
 480
 481 # The makefile may define $(extra-libs) with `libfoo libbar'
 482 # to build libfoo.a et al from the modules listed in $(libfoo-routines).
 483 ifdef extra-libs
 484 # extra-lib.mk is included once for each extra lib to define rules
 485 # to build it, and to add its objects to the various variables.
 486 # During its evaluation, $(lib) is set to the name of the library.
 487 extra-libs-left := $(extra-libs)
 488 include $(patsubst %,$(..)extra-lib.mk,$(extra-libs))
 489 endif
 490 \f
 491 +depfiles := $(sources:.c=.d) \
 492              $(patsubst %.o,%.d,$(filter %.o,$(extra-objs:.os=.o))) \
 493              $(addsuffix .d,$(tests) $(test-srcs))
 494 ifeq ($(build-programs),yes)
 495 +depfiles += $(addsuffix .d,$(others) $(sysdep-others))
 496 endif
 497 +depfiles := $(addprefix $(objpfx),\
 498                          $(filter-out $(addsuffix .d,$(omit-deps)),\
 499                                       $(+depfiles)))
 500
 501 ifdef +depfiles
 502 ifneq ($(no_deps),t)
 503 -include $(+depfiles)
 504 endif
 505 endif
 506 \f\f
 507 # Maximize efficiency by minimizing the number of rules.
 508 .SUFFIXES:      # Clear the suffix list.  We don't use suffix rules.
 509 # Don't define any builtin rules.
 510 MAKEFLAGS := $(MAKEFLAGS)r
 511
 512 # Generic rule for making directories.
 513 %/:
 514 # mkdir isn't smart enough to strip a trailing /.
 515         mkdir $(@:%/=%)
 516 \f
 517 # Make sure that object files are not removed
 518 # when they are intermediates between sources and library members.
 519 .PRECIOUS: $(addprefix $(objpfx)%,$(all-object-suffixes))
 520
 521 # Make sure that the parent library archive is never removed.
 522 .PRECIOUS: $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
 523 \f
 524 # Use the verbose option of ar and tar when not running silently.
 525 ifeq    "$(findstring s,$(MAKEFLAGS))" ""       # if not -s
 526 verbose := v
 527 else                                            # -s
 528 verbose :=
 529 endif                                           # not -s
 530
 531 ARFLAGS := r$(verbose)
 532 CREATE_ARFLAGS := cru$(verbose)
 533 \f
 534 # This makes all the object files in the parent library archive.
 535
 536 .PHONY: lib lib-noranlib
 537 lib: lib-noranlib $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
 538 lib-noranlib: libobjs
 539
 540 # For object-suffix $o, the list of objects with that suffix.
 541 # Makefiles can define `elide-routines.so = foo' to leave foo.so out.
 542 o-objects = $(patsubst %.o,%$o,$(filter-out $(patsubst %,$(objpfx)%.o,\
 543                                                        $(elide-routines$o)),\
 544                                             $(objects)))
 545 others: $(addprefix $(objpfx),$(install-lib))
 546
 547 ifndef objects
 548
 549 # Create the stamp$o files to keep the parent makefile happy.
 550 subdir_lib: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
 551 $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o):
 552         $(make-target-directory)
 553         rm -f $@; > $@
 554 else
 555
 556 # Define explicit rules to update each $(objpfx)stamp.SUFFIX
 557 # timestamp file; these rules (one explicit rule is generated for each
 558 # object suffix) write a list of objects to update in the stamp file.
 559 # The parent will then actually add them all to the archive in the
 560 # archive rule, below.
 561 define o-iterator-doit
 562 $(objpfx)stamp$o: $(o-objects); $$(do-stamp)
 563 endef
 564 define do-stamp
 565 echo '$(patsubst $(objpfx)%,$(addsuffix /,$(subdir))%,$^)' > $@T
 566 mv -f $@T $@
 567 endef
 568 object-suffixes-left := $(object-suffixes-for-libc)
 569 include $(o-iterator)
 570
 571 endif
 572
 573 # Now define explicit rules to build the library archives; these depend
 574 # on the stamp files built above.
 575 define o-iterator-doit
 576 $(common-objpfx)$(patsubst %,$(libtype$o),c): \
 577                 $(subdirs-stamp-o) $(common-objpfx)stamp$o; $$(do-makelib)
 578 endef
 579 define do-makelib
 580 cd $(common-objdir) && \
 581 $(AR) $(CREATE_ARFLAGS) $(@F) `cat $(patsubst $(common-objpfx)%,%,$^)`
 582 $(RANLIB) $@
 583 endef
 584 subdirs-stamps := $(foreach d,$(subdirs),$(common-objpfx)$d/stamp%)
 585 subdirs-stamp-o = $(subst %,$o,$(subdirs-stamps))
 586 ifndef subdir
 587 $(subdirs-stamps): subdir_lib;
 588 endif
 589 object-suffixes-left = $(object-suffixes-for-libc)
 590 include $(o-iterator)
 591
 592
 593 # This makes all the object files.
 594 .PHONY: objects objs libobjs extra-objs
 595 objects objs: libobjs extra-objs
 596 libobjs: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
 597 extra-objs: $(addprefix $(objpfx),$(extra-objs))
 598
 599 # Canned sequence for building an extra library archive.
 600 define build-extra-lib
 601 $(patsubst %/,cd % &&,$(objpfx)) \
 602 $(AR) $(CREATE_ARFLAGS) $(@:$(objpfx)%=%) \
 603       $(patsubst $(objpfx)%,%,$^)
 604 $(RANLIB) $@
 605 endef
 606 \f
 607 # Installation.
 608
 609 .PHONY: force-install
 610 force-install:
 611
 612 # $(install-lib) are installed from the object directory into $(libdir);
 613 # files in $(install-lib) matching `lib%.a' are ranlib'd after installation
 614 # unless they also appear in $(non-lib.a).  $(install-data) are installed
 615 # as they are into $(datadir).  $(headers) are installed as they are in
 616 # $(includedir).  $(install-bin) and $(install-sbin) are installed from the
 617 # object directory into $(bindir) and $(sbindir), respectively.
 618 # $(install-others) are absolute path names of files to install; rules to
 619 # install them are defined elsewhere.
 620
 621 # The simple library name to install libc.a under.
 622 # This could be defined by a sysdep Makefile.
 623 ifndef libc-name
 624 libc-name := c
 625 endif
 626
 627 define do-install
 628 $(make-target-directory)
 629 $(INSTALL_DATA) $< $@
 630 endef
 631
 632 # Make the target directory if it doesn't exist, using the `mkinstalldirs'
 633 # script that does `mkdir -p' even if `mkdir' doesn't support that flag.
 634 define make-target-directory
 635 $(addprefix $(..)./scripts/mkinstalldirs ,\
 636             $(filter-out $(wildcard $(@D:%/=%)),$(@D:%/=%)))
 637 endef
 638
 639 # Any directory (parent or subdir) should install libc.a; this way
 640 # "make install" in a subdir is guaranteed to install everything it changes.
 641 installed-libcs := $(foreach o,$(filter-out .os,$(object-suffixes-for-libc)),\
 642                              $(inst_libdir)/$(patsubst %,$(libtype$o),\
 643                                                      $(libprefix)$(libc-name)))
 644 install: $(installed-libcs)
 645 $(installed-libcs): $(inst_libdir)/lib$(libprefix)%: lib $(+force)
 646         $(make-target-directory)
 647         $(INSTALL_DATA) $(common-objpfx)lib$(*:$(libc-name)%=c%) $@
 648 # Running ranlib after installing makes the __.SYMDEF time stamp up to
 649 # date, which avoids messages from some linkers.
 650         $(RANLIB) $@
 651
 652 define do-install-program
 653 $(make-target-directory)
 654 $(INSTALL_PROGRAM) $< $@.new
 655 mv -f $@.new $@
 656 endef
 657
 658 install-lib.so := $(filter %.so,$(install-lib:%_pic.a=%.so))
 659 install-lib := $(filter-out %.so %_pic.a,$(install-lib))
 660
 661 ifeq (yes,$(build-shared))
 662 # Find which .so's have versions.
 663 versioned := $(strip $(foreach so,$(install-lib.so),\
 664                                $(patsubst %,$(so),$($(so)-version))))
 665
 666 install-lib.so-versioned := $(filter $(versioned), $(install-lib.so))
 667 install-lib.so-unversioned := $(filter-out $(versioned), $(install-lib.so))
 668
 669 install-lib-nosubdir: $(install-lib.so-versioned:%=$(inst_libdir)/%) \
 670                       $(install-lib.so-unversioned:%=$(inst_slibdir)/%)
 671
 672 # Install all the unversioned shared libraries.
 673 $(install-lib.so-unversioned:%=$(inst_slibdir)/%): $(inst_slibdir)/%.so: \
 674     $(objpfx)%.so $(+force)
 675         $(do-install-program)
 676
 677 ifneq ($(findstring -s,$(LN_S)),)
 678 define make-link
 679 rm -f $@.new
 680 $(SHELL) $(..)scripts/rellns-sh $< $@.new
 681 mv -f $@.new $@
 682 endef
 683 else
 684 # If we have no symbolic links don't bother with rellns-sh.
 685 define make-link
 686 rm -f $@.new
 687 $(LN_S) $< $@.new
 688 mv -f $@.new $@
 689 endef
 690 endif
 691
 692 ifeq (yes,$(build-shared))
 693 ifeq (no,$(cross-compiling))
 694 symbolic-link-prog := $(common-objpfx)elf/sln
 695 symbolic-link-list := $(common-objpfx)elf/symlink.list
 696 define make-shlib-link
 697 echo $(<F) $@ >> $(symbolic-link-list)
 698 endef
 699 else # cross-compiling
 700 # We need a definition that can be used by elf/Makefile's install rules.
 701 symbolic-link-prog = $(LN_S)
 702 endif
 703 endif
 704 ifndef make-shlib-link
 705 define make-shlib-link
 706 rm -f $@
 707 $(LN_S) $(<F) $@
 708 endef
 709 endif
 710
 711 ifdef libc.so-version
 712 # For a library specified to be version N, install three files:
 713 # libc.so       ->      libc.so.N       (e.g. libc.so.6)
 714 # libc.so.6     ->      libc-VERSION.so (e.g. libc-1.10.so)
 715
 716 $(inst_slibdir)/libc.so$(libc.so-version): $(inst_slibdir)/libc-$(version).so \
 717                                            $(+force)
 718         $(make-shlib-link)
 719 $(inst_slibdir)/libc-$(version).so: $(common-objpfx)libc.so $(+force)
 720         $(do-install-program)
 721 install: $(inst_slibdir)/libc.so$(libc.so-version)
 722
 723 ifndef subdir
 724 # What we install as libc.so for programs to link against is in fact a
 725 # link script.  It contains references for the various libraries we need.
 726 # The libc.so object is not complete since some functions are only defined
 727 # in libc_nonshared.a.
 728 # We need to use absolute paths since otherwise local copies (if they exist)
 729 # of the files are taken by the linker.
 730 install: $(inst_libdir)/libc.so
 731 $(inst_libdir)/libc.so: $(common-objpfx)libc.so$(libc.so-version) \
 732                         $(inst_libdir)/$(patsubst %,$(libtype.oS),\
 733                                                   $(libprefix)$(libc-name)) \
 734                         $(+force)
 735         (echo '/* GNU ld script';\
 736          echo '   Use the shared library, but some functions are only in';\
 737          echo '   the static library, so try that secondarily.  */';\
 738          echo 'GROUP ( $(slibdir)/libc.so$(libc.so-version)' \
 739               '$(libdir)/$(patsubst %,$(libtype.oS),$(libprefix)$(libc-name))'\
 740               ')' \
 741         ) > $@.new
 742         mv -f $@.new $@
 743
 744 endif
 745
 746 else
 747 install: $(inst_slibdir)/libc.so
 748 $(inst_slibdir)/libc.so: $(common-objpfx)libc.so $(+force)
 749         $(do-install-program)
 750 endif
 751
 752 ifneq (,$(versioned))
 753 # Produce three sets of rules as above for all the smaller versioned libraries.
 754
 755 define o-iterator-doit
 756 $(inst_libdir)/$o: $(inst_slibdir)/$o$($o-version) $(+force); $$(make-link)
 757 endef
 758 object-suffixes-left := $(versioned)
 759 include $(o-iterator)
 760
 761 # Make symlinks in the build directory, because the versioned names might
 762 # be referenced by a DT_NEEDED in another library.
 763 define o-iterator-doit
 764 $(objpfx)$o$($o-version): $(objpfx)$o; $$(make-link)
 765 endef
 766 object-suffixes-left := $(versioned)
 767 include $(o-iterator)
 768
 769 generated += $(foreach o,$(versioned),$o$($o-version))
 770
 771 ifeq (,$($(subdir)-version))
 772 define o-iterator-doit
 773 $(inst_slibdir)/$o$($o-version): $(inst_slibdir)/$(o:.so=)-$(version).so \
 774                                  $(+force);
 775         $$(make-shlib-link)
 776 endef
 777 object-suffixes-left := $(versioned)
 778 include $(o-iterator)
 779
 780 define o-iterator-doit
 781 $(inst_slibdir)/$(o:.so=)-$(version).so: $(objpfx)$o $(+force);
 782         $$(do-install-program)
 783 endef
 784 object-suffixes-left := $(versioned)
 785 include $(o-iterator)
 786 else
 787 define o-iterator-doit
 788 $(inst_slibdir)/$o$($o-version): \
 789   $(inst_slibdir)/$(o:.so=)-$($(subdir)-version).so $(+force);
 790         $$(make-shlib-link)
 791 endef
 792 object-suffixes-left := $(versioned)
 793 include $(o-iterator)
 794
 795 define o-iterator-doit
 796 $(inst_slibdir)/$(o:.so=)-$($(subdir)-version).so: $(objpfx)$o $(+force);
 797         $$(do-install-program)
 798 endef
 799 object-suffixes-left := $(versioned)
 800 include $(o-iterator)
 801 endif
 802 endif
 803
 804 define do-install-so
 805 $(do-install-program)
 806 $(patsubst %,ln -s -f $(@F) $(@D)/$(patsubst %$*.so,%,$(<F))$(libprefix)$*.so,\
 807            $(filter-out %.so,$@))
 808 endef
 809
 810 so-versions := $(sort $(foreach so,$(install-lib.so),.so$($(so)-version)))
 811 $(foreach v,$(so-versions),\
 812           $(inst_slibdir)/lib$(libprefix)%$v): $(common-objpfx)lib%.so \
 813                                                $(+force)
 814         $(do-install-so)
 815 $(foreach v,$(so-versions),\
 816           $(inst_slibdir)/$(libprefix)%$v): $(common-objpfx)%.so $(+force)
 817         $(do-install-so)
 818 endif
 819
 820 ifdef install-bin
 821 $(addprefix $(inst_bindir)/,$(install-bin)): \
 822     $(inst_bindir)/%: $(objpfx)% $(+force)
 823         $(do-install-program)
 824 endif
 825 ifdef install-rootsbin
 826 $(addprefix $(inst_rootsbindir)/,$(install-rootsbin)): \
 827    $(inst_rootsbindir)/%: $(objpfx)% $(+force)
 828         $(do-install-program)
 829 endif
 830 ifdef install-sbin
 831 $(addprefix $(inst_sbindir)/,$(install-sbin)): \
 832     $(inst_sbindir)/%: $(objpfx)% $(+force)
 833         $(do-install-program)
 834 endif
 835 ifdef install-lib
 836 install-lib.a := $(filter lib%.a,$(install-lib))
 837 install-lib-non.a := $(filter-out lib%.a,$(install-lib))
 838 ifdef install-lib-non.a
 839 $(addprefix $(inst_libdir)/$(libprefix),$(install-lib-non.a)): \
 840   $(inst_libdir)/$(libprefix)%: $(objpfx)% $(+force)
 841         $(do-install)
 842 endif
 843 ifdef install-lib.a
 844 $(install-lib.a:lib%.a=$(inst_libdir)/lib$(libprefix)%.a): \
 845   $(inst_libdir)/lib$(libprefix)%.a: $(objpfx)lib%.a $(+force)
 846         $(do-install)
 847         $(patsubst %,$(RANLIB) $@,$(filter-out $(non-lib.a),$(<F)))
 848 endif
 849 endif
 850 ifdef install-data
 851 $(addprefix $(inst_datadir)/,$(install-data)): $(inst_datadir)/%: % $(+force)
 852         $(do-install)
 853 endif
 854 headers := $(strip $(headers))
 855 ifdef headers
 856 $(addprefix $(inst_includedir)/,$(headers)): $(inst_includedir)/%: % $(+force)
 857         $(do-install)
 858 endif   # headers
 859
 860 .PHONY: install-bin-nosubdir install-rootsbin-nosubdir install-sbin-nosubdir \
 861         install-lib-nosubdir install-data-nosubdir install-headers-nosubdir
 862 install-bin-nosubdir: $(addprefix $(inst_bindir)/,$(install-bin))
 863 install-rootsbin-nosubdir: \
 864         $(addprefix $(inst_rootsbindir)/,$(install-rootsbin))
 865 install-sbin-nosubdir: $(addprefix $(inst_sbindir)/,$(install-sbin))
 866 install-lib-nosubdir: $(addprefix $(inst_libdir)/,\
 867                        $(patsubst lib%.a,lib$(libprefix)%.a,$(install-lib.a)) \
 868                        $(addprefix $(libprefix),$(install-lib-non.a)))
 869 install-data-nosubdir: $(addprefix $(inst_datadir)/,$(install-data))
 870 install-headers-nosubdir: $(addprefix $(inst_includedir)/,$(headers))
 871 install-others-nosubdir: $(install-others)
 872
 873 # We need all the `-nosubdir' targets so that `install' in the parent
 874 # doesn't depend on several things which each iterate over the subdirs.
 875 # This rule makes `install-FOO' always use `install-FOO-nosubdir' as a
 876 # subroutine.  Then in the parent `install-FOO' also causes subdir makes.
 877 install-%:: install-%-nosubdir ;
 878
 879 .PHONY: install install-no-libc.a-nosubdir
 880 ifeq ($(build-programs),yes)
 881 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir\
 882                             install-bin-nosubdir install-lib-nosubdir   \
 883                             install-others-nosubdir install-rootsbin-nosubdir \
 884                             install-sbin-nosubdir
 885 else
 886 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir\
 887                             install-lib-nosubdir install-others-nosubdir
 888 endif
 889 install: install-no-libc.a-nosubdir
 890 \f
 891 # Command to compile $< in $(objdir) using the native libraries.
 892 define native-compile
 893 $(make-target-directory)
 894 $(patsubst %/,cd % &&,$(objpfx)) \
 895 $(BUILD_CC) $($(basename $(<F))-CFLAGS) $(ALL_BUILD_CFLAGS) \
 896             $(firstword $(filter /%,$< $(shell pwd)/$<)) -o $(@F)
 897 endef
 898
 899 # Command to compile $< in $(common-objdir) using the native libraries.
 900 # We must cd to $(objdir) anyway so that $(..)config.h is valid.
 901 define common-objdir-compile
 902 $(patsubst %/,cd % &&,$(objpfx)) \
 903 $(BUILD_CC) $($(basename $(<F))-CFLAGS) $(ALL_BUILD_CFLAGS) \
 904             $(firstword $(filter /%,$< $(shell pwd)/$<)) -o $(..)$(@F)
 905 endef
 906
 907 # We always want to use configuration definitions.
 908 # Note that this is only used for commands running in $(objpfx).
 909 ALL_BUILD_CFLAGS = $(BUILD_CFLAGS) -include $(..)config.h
 910
 911 # Support the GNU standard name for this target.
 912 .PHONY: check
 913 check: tests
 914 \f
 915 .PHONY: TAGS
 916 TAGS: $(objpfx)distinfo $(..)MakeTAGS
 917         $(MAKE) $(addprefix -f ,$^) $@
 918
 919 $(..)po/%.pot: $(objpfx)distinfo $(..)MakeTAGS FORCE
 920         $(MAKE) $(addprefix -f ,$(filter-out FORCE,$^)) $@
 921 FORCE:
 922
 923
 924 .PHONY: echo-headers
 925 echo-headers:
 926         @echo $(headers)
 927
 928 \f
 929 # Common cleaning targets.
 930
 931 .PHONY: common-mostlyclean common-clean mostlyclean clean do-tests-clean
 932 clean: common-clean
 933 mostlyclean: common-mostlyclean
 934
 935 do-tests-clean:
 936         -rm -f $(patsubst %,$(objpfx)%.out,$(tests) $(test-srcs))
 937
 938 # Remove the object files.
 939 common-mostlyclean:
 940         -rm -f $(addprefix $(objpfx),$(tests) $(test-srcs) $(others) \
 941                                      $(sysdep-others) stubs \
 942                                      $(addsuffix .o,$(tests) $(test-srcs) \
 943                                                     $(others) \
 944                                                     $(sysdep-others)) \
 945                                      $(addsuffix .out,$(tests) $(test-srcs)))
 946         -rm -f $(addprefix $(objpfx),$(extra-objs) $(install-lib) \
 947                                      $(install-lib.so) \
 948                                      $(install-lib.so:%.so=%_pic.a))
 949         -rm -f core
 950         $(rmobjs)
 951 define rmobjs
 952 $(foreach o,$(object-suffixes-for-libc),
 953 -rm -f $(objpfx)stamp$o $(o-objects))
 954 endef
 955
 956 # Also remove the dependencies and generated source files.
 957 common-clean: common-mostlyclean
 958         -rm -f $(addprefix $(objpfx),$(generated)) $(+depfiles)
 959         -rm -fr $(addprefix $(objpfx),$(generated-dirs))
 960         -rm -f $(addprefix $(common-objpfx),$(common-generated))
 961         -rm -f $(objpfx)distinfo
 962 \f
 963 # Produce a file `stubs' which contains `#define __stub_FUNCTION'
 964 # for each function which is a stub.  We grovel over all the .d files
 965 # looking for references to <stub-tag.h>.  Then we grovel over each
 966 # referenced source file to see what stub function it defines.
 967
 968 ifdef objpfx
 969 .PHONY: stubs # The parent Makefile calls this target.
 970 stubs: $(objpfx)stubs
 971 endif
 972 s = $(sysdep_dir)/generic
 973 $(objpfx)stubs: $(+depfiles)
 974 # Use /dev/null since `...` might expand to empty.
 975         (s=`cd $s && /bin/pwd`; \
 976          $(patsubst %/,cd % &&,$(objpfx)) \
 977          sed -n 's/^stub_warning *(\([^)]*\).*$$/#define __stub_\1/p' \
 978           `sed -n -e '\@ $s/[^ ]*\.c@{; s@^.* $s/\([^ ]*\.c\).*$$@'"$$s"'/\1@; h; }' \
 979                 -e '/stub-tag\.h/{; g; p; }' \
 980                   $(patsubst $(objpfx)%,%,$^) /dev/null` \
 981              /dev/null) > $@T
 982         mv -f $@T $@
 983 \f
 984 # Make the distribution tar file.
 985
 986 .PHONY: dist
 987 dist: $(objpfx)distinfo $(..)Make-dist
 988         $(MAKE) -f $< -f $(word 2,$^) $(Make-dist-args)
 989
 990 # Avoid depending on source files found in sysdeps dirs,
 991 # because the references affect implicit rule selection.
 992 dist: $(filter-out %.c %.S %.s,$(distribute))
 993
 994 # We used to simply export all these variables, but that frequently made the
 995 # environment get too large.  Instead, we write all the information into
 996 # a generated makefile fragment `distinfo', and then include it with -f in
 997 # the sub-make that makes the distribution (above).
 998 $(objpfx)distinfo: Makefile $(..)Makerules \
 999                    $(wildcard $(foreach dir,$(sysdirs),$(dir)/Makefile))
1000         $(make-target-directory)
1001         $(distinfo-vars)
1002         mv -f $@.new $@
1003 .PHONY: subdir_distinfo
1004 subdir_distinfo: $(objpfx)distinfo
1005
1006 define distinfo-vars
1007 rm -f $@.new
1008 echo > $@.new 'subdir := $(subdir)'
1009 $(foreach var,subdir-dirs sources elided-routines sysdep_routines \
1010               headers sysdep_headers distribute dont_distribute generated \
1011               others tests test-srcs extra-libs $(extra-libs:%=%-routines) \
1012               versioned \
1013               $(addprefix install-,lib lib.so data bin sbin others),
1014 echo >> $@.new '$(subdir)-$(var) := $($(var))'
1015 echo >> $@.new '$(var) = $$($(subdir)-$(var))')
1016 endef
1017 \f
1018 ifneq (,$(strip $(gpl2lgpl)))
1019 ifneq (,$(wildcard $(..)gpl2lgpl.sed))
1020 # Snarf from the master source and frob the copying notice.
1021 $(gpl2lgpl): %: $(..)gpl2lgpl.sed /home/gd/gnu/lib/%
1022         sed -f $^ > $@-tmp
1023 # So I don't edit them by mistake.
1024         chmod a-w $@-tmp
1025         mv -f $@-tmp $@
1026 ifeq ($(with-cvs),yes)
1027         test ! -d CVS || cvs $(CVSOPTS) commit -m'Updated from $^' $@
1028 endif
1029 endif
1030 endif