Makerules

   1 # Copyright (C) 1991-2022 Free Software Foundation, Inc.
   2 # This file is part of the GNU C Library.
   3
   4 # The GNU C Library is free software; you can redistribute it and/or
   5 # modify it under the terms of the GNU Lesser General Public
   6 # License as published by the Free Software Foundation; either
   7 # version 2.1 of the License, or (at your option) any later version.
   8
   9 # The GNU C Library is distributed in the hope that it will be useful,
  10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12 # Lesser General Public License for more details.
  13
  14 # You should have received a copy of the GNU Lesser General Public
  15 # License along with the GNU C Library; if not, see
  16 # <https://www.gnu.org/licenses/>.
  17
  18 #
  19 #       Common rules for making the GNU C library.  This file is included
  20 #       by the top-level Makefile and by all subdirectory makefiles
  21 #       (through Rules).
  22 #
  23 ifneq (,)
  24 This makefile requires GNU Make.
  25 endif
  26
  27 REQUIRED_MAKE_VERSION = 3.74
  28 REAL_MAKE_VERSION = $(firstword $(MAKE_VERSION))
  29
  30 ifneq ($(REQUIRED_MAKE_VERSION), \
  31        $(firstword $(sort $(REAL_MAKE_VERSION) $(REQUIRED_MAKE_VERSION))))
  32 Wrong GNU Make version.  See above for the version needed.
  33 endif
  34
  35
  36 ifdef   subdir
  37 ..      := ../
  38 endif   # subdir
  39
  40 # If `sources' was defined by the parent makefile, undefine it so
  41 # we will later get it from wildcard search in this directory.
  42 ifneq   "$(findstring env,$(origin sources))" ""
  43 sources :=
  44 endif
  45
  46 oPATH := $(PATH)
  47 PATH := this definition should take precedence over $(oPATH)
  48 ifeq ($(PATH),$(oPATH))
  49 You must not use the -e flag when building the GNU C library.
  50 else
  51 PATH := $(oPATH)
  52 endif
  53 \f
  54 ifndef +included-Makeconfig
  55 include $(..)Makeconfig
  56 endif
  57
  58 # This variable is used in ``include $(o-iterator)'' after defining
  59 # $(o-iterator-doit) to produce some desired rule using $o for the object
  60 # suffix, and setting $(object-suffixes-left) to $(object-suffixes); a copy
  61 # is produced for each object suffix in use.
  62 o-iterator = $(patsubst %,$(..)o-iterator.mk,$(object-suffixes-left))
  63 \f
  64 # Include any system-specific makefiles.
  65
  66 # This is here so things in sysdep Makefiles can easily depend on foo.h as
  67 # appropriate and not worry about where foo.h comes from, which may be
  68 # system dependent and not known by that Makefile.
  69 vpath %.h $(subst $(empty) ,:,$(strip $(common-objpfx) $(objpfx) \
  70                                       $(+sysdep_dirs) $(..)))
  71
  72 # The same is true for RPC source files.
  73 vpath %.x $(subst $(empty) ,:,$(strip $(common-objpfx) $(objpfx) \
  74                                       $(+sysdep_dirs) $(..)))
  75
  76 # Some sysdep makefiles use this to distinguish being included here from
  77 # being included individually by a subdir makefile (hurd/Makefile needs this).
  78 in-Makerules := yes
  79
  80 sysdep-makefiles := $(wildcard $(sysdirs:=/Makefile))
  81 ifneq (,$(sysdep-makefiles))
  82 include $(sysdep-makefiles)
  83 endif
  84
  85
  86 # Reorder before-compile so that mach things come first, and hurd things
  87 # second, before all else.  The mach and hurd subdirectories have many
  88 # generated header files which the much of rest of the library depends on,
  89 # so it is best to build them first (and mach before hurd, at that).
  90 before-compile := $(filter $(common-objpfx)mach% $(common-objpfx)hurd%,\
  91                            $(before-compile)) \
  92                   $(filter-out $(common-objpfx)mach% $(common-objpfx)hurd%,\
  93                                $(before-compile))
  94
  95 # Even before that, we need abi-versions.h which is generated right here.
  96 ifeq ($(build-shared),yes)
  97 ifndef avoid-generated
  98 before-compile := $(common-objpfx)abi-versions.h $(before-compile)
  99 $(common-objpfx)abi-versions.h: $(..)scripts/abi-versions.awk \
 100                                 $(common-objpfx)Versions.all
 101         LC_ALL=C $(AWK) -f $^ > $@T
 102         mv -f $@T $@
 103
 104 $(common-objpfx)%.latest: $(common-objpfx)abi-versions.h
 105         sed -n '/ VERSION_$*_/{s/^.*_\([A-Z0-9_]*\).*$$/\1/;h;};$${g;p;}' \
 106             $(common-objpfx)abi-versions.h > $@T
 107         mv -f $@T $@
 108
 109 # first-versions.h and ldbl-compat-choose.h provide macros used in
 110 # various symbol versioning macro calls.
 111 before-compile := $(common-objpfx)first-versions.h \
 112                   $(common-objpfx)ldbl-compat-choose.h $(before-compile)
 113 $(common-objpfx)first-versions.h: $(common-objpfx)versions.stmp
 114 $(common-objpfx)ldbl-compat-choose.h: $(common-objpfx)versions.stmp
 115 endif # avoid-generated
 116 endif # $(build-shared) = yes
 117
 118 ifndef avoid-generated
 119 ifneq (,$(CXX))
 120 # If C++ headers <cstdlib> or <cmath> are used, GCC 6 will include
 121 # /usr/include/stdlib.h or /usr/include/math.h from "#include_next"
 122 # (instead of stdlib/stdlib.h or math/math.h in the glibc source
 123 # directory), and this turns up as a make dependency.  An implicit
 124 # rule will kick in and make will try to install stdlib/stdlib.h or
 125 # math/math.h as /usr/include/stdlib.h or /usr/include/math.h because
 126 # the target is out of date.  We make a copy of <cstdlib> and <cmath>
 127 # in the glibc build directory so that stdlib/stdlib.h and math/math.h
 128 # will be used instead of /usr/include/stdlib.h and /usr/include/math.h.
 129 before-compile := $(common-objpfx)cstdlib $(common-objpfx)cmath \
 130                   $(before-compile)
 131 $(common-objpfx)cstdlib: $(c++-cstdlib-header)
 132         $(INSTALL_DATA) $< $@T
 133         $(move-if-change) $@T $@
 134 $(common-objpfx)cmath: $(c++-cmath-header)
 135         $(INSTALL_DATA) $< $@T
 136         $(move-if-change) $@T $@
 137 ifneq (,$(c++-bits-std_abs-h))
 138 # Also make a copy of <bits/std_abs.h> from GCC 7 to prevent it from
 139 # including /usr/include/stdlib.h.
 140 before-compile := $(common-objpfx)bits/std_abs.h $(before-compile)
 141 $(common-objpfx)bits/std_abs.h: $(c++-bits-std_abs-h)
 142         $(INSTALL_DATA) $< $@T
 143         $(move-if-change) $@T $@
 144 endif
 145 endif
 146
 147 before-compile := $(common-objpfx)libc-abis.h $(before-compile)
 148 $(common-objpfx)libc-abis.h: $(common-objpfx)libc-abis.stamp; @:
 149 $(common-objpfx)libc-abis.stamp: $(..)scripts/gen-libc-abis \
 150                              $(firstword $(wildcard $(sysdirs:=/libc-abis)) \
 151                                          $(..)libc-abis) \
 152                              $(..)Makerules
 153         $(SHELL) $< \
 154                  $(base-machine)-$(config-vendor)-$(config-os) \
 155                  < $(word 2,$^) > $(@:.stamp=.h)T
 156         $(move-if-change) $(@:.stamp=.h)T $(@:.stamp=.h)
 157         touch $@
 158 common-generated += $(common-objpfx)libc-abis.h
 159 endif # avoid-generated
 160
 161 ifeq (yes,$(build-shared))
 162 $(common-objpfx)runtime-linker.h: $(common-objpfx)runtime-linker.stamp; @:
 163 $(common-objpfx)runtime-linker.stamp: $(common-objpfx)config.make
 164         $(make-target-directory)
 165         echo '#define RUNTIME_LINKER "$(rtlddir)/$(rtld-installed-name)"' \
 166                 > ${@:stamp=T}
 167         $(move-if-change) ${@:stamp=T} ${@:stamp=h}
 168         touch $@
 169 endif
 170
 171 # Make sure the subdirectory for object files gets created.
 172 ifdef objpfx
 173 ifeq (,$(wildcard $(objpfx).))
 174 before-compile += $(objpfx).
 175 $(objpfx).:
 176         $(make-target-directory)
 177 endif
 178 endif
 179
 180 # Remove existing files from `before-compile'.  Things are added there when
 181 # they must exist for dependency generation to work right, but once they
 182 # exist there is no further need for every single file to depend on them,
 183 # and those gratuitous dependencies result in many gratuitous
 184 # recompilations.
 185 before-compile := $(filter-out $(wildcard $(before-compile)),$(before-compile))
 186
 187 # Don't let any before-compile file be an intermediate and get removed.
 188 ifdef before-compile
 189 $(before-compile):
 190 endif
 191
 192 # We don't want $(common-objpfx) files to depend on miscellaneous stuff
 193 # in subdirs.
 194 ifdef subdir
 195 common-before-compile := $(filter-out $(objpfx)%,$(before-compile))
 196 else
 197 common-before-compile = $(before-compile)
 198 endif
 199
 200 ifndef subdir
 201 # If a makefile needs to do something conditional on something that
 202 # can only be figured out from headers, write a FOO.make.c input
 203 # file that uses cpp contructs and contains @@@ LINE @@@ for each LINE
 204 # to emit in the generated makefile, and use -include $(common-objpfx)FOO.make.
 205 #
 206 # We only generate these in the top-level makefile, to avoid any weirdness
 207 # from subdir-specific makefile tweaks creeping in on an update.
 208 $(common-objpfx)%.make: $(..)%.make.c $(..)Makerules $(common-before-compile)
 209         rm -f $@T $@.dT
 210         (echo '# Generated from $*.make.c by Makerules.'; \
 211          $(CC) $(CFLAGS) $(CPPFLAGS) -E -DASSEMBLER $< \
 212                -MD -MP -MT '$$(common-objpfx)$*.make' -MF $@.dT \
 213          | sed -n '/@@@/{s/@@@[  ]*\(.*\)@@@/\1/;s/[     ]*$$//p;}'; \
 214          echo 'common-generated += $(@F)'; \
 215          sed $(sed-remove-objpfx) $(sed-remove-dotdot) $@.dT; \
 216          rm -f $@.dT) > $@T
 217         mv -f $@T $@
 218 endif
 219
 220 ifdef subdir
 221 sed-remove-dotdot := -e 's@  *\.\.\/\([^        \]*\)@ $$(..)\1@g' \
 222                      -e 's@^\.\.\/\([^  \]*\)@$$(..)\1@g'
 223 else
 224 sed-remove-dotdot := -e 's@  *\([^      \/$$][^         \]*\)@ $$(..)\1@g' \
 225                      -e 's@^\([^        \/$$][^         \]*\)@$$(..)\1@g'
 226 endif
 227
 228 ifdef gen-py-const-headers
 229 # We'll use a static pattern rule to match .pysym files with their
 230 # corresponding generated .py files.
 231 # The generated .py files go in the submodule's dir in the glibc build dir.
 232 py-const-files := $(patsubst %.pysym,%.py,$(gen-py-const-headers))
 233 py-const-dir := $(objpfx)
 234 py-const := $(addprefix $(py-const-dir),$(py-const-files))
 235 py-const-script := $(..)scripts/gen-as-const.py
 236
 237 # This is a hack we use to generate .py files with constants for
 238 # Python code.
 239 #
 240 # $@.tmp is a temporary file we use to store the partial contents of
 241 # the target file.  We do this instead of just writing on $@ because,
 242 # if the build process terminates prematurely, re-running Make
 243 # wouldn't run this rule since Make would see that the target file
 244 # already exists (despite it being incomplete).
 245 #
 246 # The output is redirected to a .py file; we'll import it in the main
 247 # Python code to read the constants generated by gen-as-const.py.
 248 $(py-const): $(py-const-dir)%.py: %.pysym $(py-const-script) \
 249              $(common-before-compile)
 250         $(make-target-directory)
 251         $(PYTHON) $(py-const-script) --python \
 252                   --cc="$(CC) $(CFLAGS) $(CPPFLAGS)" $< \
 253                   > $@.tmp
 254         mv -f $@.tmp $@
 255
 256 generated += $(py-const)
 257 endif  # gen-py-const-headers
 258
 259 ifdef gen-as-const-headers
 260 # Generating headers for assembly constants.
 261 # We need this defined early to get into before-compile before
 262 # it's used in sysd-rules, below.
 263 # Define GEN_AS_CONST_HEADERS to avoid circular dependency [BZ #22792].
 264 # NB: <tcb-offsets.h> is generated from tcb-offsets.sym to define
 265 # offsets and sizes of types in <tls.h> and maybe <pthread.h> which
 266 # may include <tcb-offsets.h>.  Target header files can check if
 267 # GEN_AS_CONST_HEADERS is defined to avoid circular dependency which
 268 # may lead to build hang on a many-core machine.
 269 $(common-objpfx)%.h $(common-objpfx)%.h.d: $(..)scripts/gen-as-const.py \
 270                                            %.sym $(common-before-compile)
 271         $(PYTHON) $< --cc="$(CC) $(CFLAGS) $(CPPFLAGS) -DGEN_AS_CONST_HEADERS \
 272                            -MD -MP -MF $(@:.h=.h.d)T \
 273                            -MT '$(@:.h=.h.d) $(@:.h.d=.h)'" \
 274                   $(filter %.sym,$^) > $(@:.h.d=.h)T
 275         sed $(sed-remove-objpfx) $(sed-remove-dotdot) \
 276             $(@:.h=.h.d)T > $(@:.h=.h.d)T2
 277         rm -f $(@:.h=.h.d)T
 278         mv -f $(@:.h=.h.d)T2 $(@:.h=.h.d)
 279         mv -f $(@:.h.d=.h)T $(@:.h.d=.h)
 280 vpath %.sym $(sysdirs)
 281 before-compile += $(gen-as-const-headers:%.sym=$(common-objpfx)%.h)
 282
 283 tests-internal += $(gen-as-const-headers:%.sym=test-as-const-%)
 284 generated += $(gen-as-const-headers:%.sym=test-as-const-%.c)
 285 $(objpfx)test-as-const-%.c: $(..)scripts/gen-as-const.py $(..)Makerules \
 286                             %.sym $(common-objpfx)%.h
 287         ($(AWK) '{ sub(/^/, "asconst_", $$2); print; }' $(filter %.h,$^); \
 288          $(PYTHON) $< --test $(filter %.sym,$^)) > $@T
 289         mv -f $@T $@
 290 endif
 291 \f
 292 ifeq (yes,$(build-shared))
 293 # Generate the header containing the names of all shared libraries.
 294 # We use a stamp file to avoid unnecessary recompilations.
 295 before-compile += $(common-objpfx)gnu/lib-names.h
 296 ifeq ($(soversions.mk-done),t)
 297 ifndef abi-variants
 298 lib-names-h-abi = gnu/lib-names.h
 299 lib-names-stmp-abi = gnu/lib-names.stmp
 300 else
 301 lib-names-h-abi = gnu/lib-names-$(default-abi).h
 302 lib-names-stmp-abi = gnu/lib-names-$(default-abi).stmp
 303 before-compile += $(common-objpfx)$(lib-names-h-abi)
 304 common-generated += gnu/lib-names.h
 305 install-others-nosubdir: $(inst_includedir)/$(lib-names-h-abi)
 306 $(common-objpfx)gnu/lib-names.h:
 307         $(make-target-directory)
 308         { \
 309          echo '/* This file is automatically generated.';\
 310          echo '   It defines macros to allow user program to find the shared'; \
 311          echo '   library files which come as part of GNU libc.  */'; \
 312          echo '#ifndef __GNU_LIB_NAMES_H'; \
 313          echo '#define __GNU_LIB_NAMES_H        1'; \
 314          echo ''; \
 315          $(if $(abi-includes), \
 316           $(foreach h,$(abi-includes), echo '#include <$(h)>';) \
 317           echo '';) \
 318          $(foreach v,$(abi-variants),\
 319          $(if $(abi-$(v)-condition),\
 320          echo '#if $(abi-$(v)-condition)'; \
 321          echo '# include <gnu/lib-names-$(v).h>'); \
 322          $(if $(abi-$(v)-condition),echo '#endif';)) \
 323          echo ''; \
 324          echo '#endif   /* gnu/lib-names.h */'; \
 325         } >  $@
 326 endif
 327 $(common-objpfx)$(lib-names-h-abi): $(common-objpfx)$(lib-names-stmp-abi); @:
 328 $(common-objpfx)$(lib-names-stmp-abi): $(..)scripts/lib-names.awk \
 329                                        $(common-objpfx)soversions.i
 330         $(make-target-directory)
 331         { \
 332          $(if $(abi-variants), \
 333          echo '/* This file is automatically generated.  */';\
 334          echo '#ifndef __GNU_LIB_NAMES_H'; \
 335          echo '# error "Never use <$(lib-names-h-abi)> directly; include <gnu/lib-names.h> instead."'; \
 336          echo '#endif';, \
 337          echo '/* This file is automatically generated.';\
 338          echo '   It defines macros to allow user program to find the shared'; \
 339          echo '   library files which come as part of GNU libc.  */'; \
 340          echo '#ifndef __GNU_LIB_NAMES_H'; \
 341          echo '#define __GNU_LIB_NAMES_H        1';) \
 342          echo ''; \
 343          ($(foreach s,$(all-sonames), echo $(s);)) \
 344          | LC_ALL=C $(AWK) -f $(firstword $^) | LC_ALL=C sort; \
 345          $(if $(abi-variants),, \
 346          echo ''; \
 347          echo '#endif   /* gnu/lib-names.h */';) \
 348         } >  ${@:stmp=T}
 349         $(move-if-change) ${@:stmp=T} ${@:stmp=h}
 350         touch $@
 351 endif
 352 common-generated += $(lib-names-h-abi) $(lib-names-stmp-abi)
 353 endif
 354 \f
 355 ###############################################################################
 356 # NOTE!  Everything adding to before-compile needs to come before this point! #
 357 ###############################################################################
 358
 359 # Generate an ordered list of implicit rules which find the source files in
 360 # each sysdep directory.  The old method was to use vpath to search all the
 361 # sysdep directories.  However, that had the problem that a .S file in a
 362 # later directory would be chosen over a .c file in an earlier directory,
 363 # which does not preserve the desired sysdeps ordering behavior.
 364
 365 # System-dependent makefiles can put in `inhibit-sysdep-asm' regexps
 366 # matching sysdep directories whose assembly source files should be
 367 # suppressed.
 368
 369 -include $(common-objpfx)sysd-rules
 370 ifneq ($(sysd-rules-sysdirs),$(config-sysdirs))
 371 # The value of $(+sysdep_dirs) the sysd-rules was computed for
 372 # differs from the one we are using now.  So force a rebuild of sysd-rules.
 373 sysd-rules-force = FORCE
 374 FORCE:
 375 endif
 376 $(common-objpfx)sysd-rules: $(..)scripts/sysd-rules.awk \
 377                             $(common-objpfx)config.make $(..)Makerules \
 378                             $(sysdep-makefiles) $(sysdep-makeconfigs) \
 379                             $(sysd-rules-force)
 380         -@rm -f $@T
 381         LC_ALL=C $(AWK) -f $< > $@T \
 382                         -v all_object_suffixes='$(all-object-suffixes)' \
 383                         -v inhibit_sysdep_asm='$(inhibit-sysdep-asm)' \
 384                         -v sysd_rules_patterns='$(sysd-rules-patterns)' \
 385                         -v config_sysdirs='$(config-sysdirs)'
 386         mv -f $@T $@
 387
 388 ifndef sysd-rules-done
 389 # Don't do deps until this exists, because it provides rules to make the deps.
 390 no_deps=t
 391 endif
 392
 393 define o-iterator-doit
 394 $(objpfx)%$o: %.S $(before-compile); $$(compile-command.S)
 395 endef
 396 object-suffixes-left := $(all-object-suffixes)
 397 include $(o-iterator)
 398
 399 define o-iterator-doit
 400 $(objpfx)%$o: %.c $(before-compile); $$(compile-command.c)
 401 endef
 402 object-suffixes-left := $(all-object-suffixes)
 403 include $(o-iterator)
 404
 405 define o-iterator-doit
 406 $(objpfx)%$o: %.cc $(before-compile); $$(compile-command.cc)
 407 endef
 408 object-suffixes-left := $(all-object-suffixes)
 409 include $(o-iterator)
 410
 411 # Omit the objpfx rules when building in the source tree, because
 412 # objpfx is empty and so these rules just override the ones above.
 413 ifdef objpfx
 414 # Define first rules to find the source files in $(objpfx).
 415 # Generated source files will end up there.
 416 define o-iterator-doit
 417 $(objpfx)%$o: $(objpfx)%.S $(before-compile); $$(compile-command.S)
 418 endef
 419 object-suffixes-left := $(all-object-suffixes)
 420 include $(o-iterator)
 421
 422 define o-iterator-doit
 423 $(objpfx)%$o: $(objpfx)%.c $(before-compile); $$(compile-command.c)
 424 endef
 425 object-suffixes-left := $(all-object-suffixes)
 426 include $(o-iterator)
 427
 428 define o-iterator-doit
 429 $(objpfx)%$o: $(objpfx)%.cc $(before-compile); $$(compile-command.cc)
 430 endef
 431 object-suffixes-left := $(all-object-suffixes)
 432 include $(o-iterator)
 433 endif
 434
 435 # Generate .dT files as we compile.
 436 compile-mkdep-flags = -MD -MP -MF $@.dt -MT $@
 437 compile-command.S = $(compile.S) $(OUTPUT_OPTION) $(compile-mkdep-flags)
 438 compile-command.c = $(compile.c) $(OUTPUT_OPTION) $(compile-mkdep-flags)
 439 compile-command.cc = $(compile.cc) $(OUTPUT_OPTION) $(compile-mkdep-flags)
 440
 441 # Like compile-mkdep-flags, but for use with $(BUILD_CC).  We don't want to
 442 # track system includes here, they may spuriously trigger an install rule,
 443 # and would cause the check-local-headers test to fail.
 444 native-compile-mkdep-flags = -MMD -MP -MF $@.dt -MT $@
 445
 446 # GCC can grok options after the file name, and it looks nicer that way.
 447 compile.c = $(CC) $< -c $(CFLAGS) $(CPPFLAGS)
 448 compile.cc = $(CXX) $< -c $(CXXFLAGS) $(CPPFLAGS)
 449 compile.S = $(CC) $< -c $(CPPFLAGS) $(S-CPPFLAGS) \
 450                   $(ASFLAGS) $(ASFLAGS-$(suffix $@))
 451 COMPILE.c = $(CC) -c $(CFLAGS) $(CPPFLAGS)
 452 COMPILE.S = $(CC) -c $(CPPFLAGS) $(S-CPPFLAGS) \
 453                   $(ASFLAGS) $(ASFLAGS-$(suffix $@))
 454
 455 # We need this for the output to go in the right place.  It will default to
 456 # empty if make was configured to work with a cc that can't grok -c and -o
 457 # together.  You can't compile the C library with such a compiler.
 458 OUTPUT_OPTION = -o $@
 459
 460 # This is the end of the pipeline for compiling generated C code.
 461 compile-stdin.c = $(COMPILE.c) -o $@ -x c - $(compile-mkdep-flags)
 462
 463 # We need the $(CFLAGS) to be in there to have the right predefines during
 464 # the dependency run for C sources.  But having it for assembly sources can
 465 # get the wrong predefines.
 466 S-CPPFLAGS = -DASSEMBLER $(asm-CPPFLAGS)
 467
 468 ifneq (,$(objpfx))
 469 # Continuation lines here are dangerous because they introduce spaces!
 470 define sed-remove-objpfx
 471 -e 's@ $(subst .,\.,$(subst @,\@,$(common-objpfx)))@ $$(common-objpfx)@g' \
 472 -e 's@^$(subst .,\.,$(subst @,\@,$(common-objpfx)))@$$(common-objpfx)@g'
 473 endef
 474 endif
 475 \f
 476 # Modify the list of routines we build for different targets
 477
 478 ifeq (yes,$(build-shared))
 479 ifndef libc.so-version
 480 # Undefine this because it can't work when we libc.so is unversioned.
 481 static-only-routines =
 482 endif
 483 endif
 484
 485 elide-routines.oS += $(filter-out $(static-only-routines),\
 486                                   $(routines) $(aux) $(sysdep_routines))
 487 elide-routines.os += $(static-only-routines)
 488
 489 # If we have versioned code we don't need the old versions in any of the
 490 # static libraries.
 491 elide-routines.o  += $(shared-only-routines)
 492 elide-routines.op += $(shared-only-routines)
 493 \f
 494 # Shared library building.
 495
 496 ifeq (yes,$(build-shared))
 497
 498 # Reference map file only when shared libraries are built and a map file name
 499 # is given.
 500 ifeq ($(build-shared),yes)
 501 map-file = $(firstword $($(@F:.so=-map)) \
 502                        $(addprefix $(common-objpfx), \
 503                                    $(filter $(@F:.so=.map),$(version-maps))))
 504 load-map-file = $(map-file:%=-Wl,--version-script=%)
 505 endif
 506
 507 # Compiler arguments to use to link a shared object with libc and
 508 # ld.so.  This is intended to be as similar as possible to a default
 509 # link with an installed libc.
 510 link-libc-args = -Wl,--start-group \
 511                  $(libc-for-link) \
 512                  $(common-objpfx)libc_nonshared.a \
 513                  -Wl,--as-needed $(elf-objpfx)ld.so -Wl,--no-as-needed \
 514                  -Wl,--end-group
 515
 516 # The corresponding shared libc to use.  This may be modified for a
 517 # particular target.
 518 libc-for-link = $(common-objpfx)libc.so
 519
 520 # The corresponding dependencies.  As these are used in dependencies,
 521 # not just commands, they cannot use target-specific variables so need
 522 # to name both possible libc.so objects.
 523 link-libc-deps = $(common-objpfx)libc.so $(common-objpfx)linkobj/libc.so \
 524                  $(common-objpfx)libc_nonshared.a $(elf-objpfx)ld.so
 525
 526 # Pattern rule to build a shared object from an archive of PIC objects.
 527 # This must come after the installation rules so Make doesn't try to
 528 # build shared libraries in place from the installed *_pic.a files.
 529 # $(LDLIBS-%.so) may contain -l switches to generate run-time dependencies
 530 # on other shared objects.  The linking with libc and ld.so is intended
 531 # to be as similar as possible to a default link with an installed libc.
 532 lib%.so: lib%_pic.a $(+preinit) $(+postinit) $(link-libc-deps)
 533         $(build-shlib) $(link-libc-args)
 534         $(call after-link,$@)
 535
 536 define build-shlib-helper
 537 $(LINK.o) -shared -static-libgcc -Wl,-O1 $(sysdep-LDFLAGS) \
 538           $(if $($(@F)-no-z-defs)$(no-z-defs),,-Wl,-z,defs) $(rtld-LDFLAGS) \
 539           $(if $($(@F)-no-dt-relr),$(no-dt-relr-ldflag),$(dt-relr-ldflag)) \
 540           $(extra-B-$(@F:lib%.so=%).so) -B$(csu-objpfx) \
 541           $(extra-B-$(@F:lib%.so=%).so) $(load-map-file) \
 542           -Wl,-soname=lib$(libprefix)$(@F:lib%.so=%).so$($(@F)-version) \
 543           $(LDFLAGS.so) $(LDFLAGS-lib.so) $(LDFLAGS-$(@F:lib%.so=%).so) \
 544           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link)
 545 endef
 546
 547 ifeq (yes,$(use-default-link))
 548 # If the linker is good enough, we can let it use its default linker script.
 549 # In the long term the custom linker script will be removed.
 550 shlib-lds =
 551 shlib-lds-flags =
 552 else
 553 # binutils only position loadable notes into the first page for binaries,
 554 # not for shared objects
 555 # lld --verbose does not dump a linker script.  Use -fuse-ld=bfd.
 556 $(common-objpfx)shlib.lds: $(common-objpfx)config.make $(..)Makerules
 557         $(LINK.o) -shared -Wl,-O1 \
 558                   -nostdlib -nostartfiles -fuse-ld=bfd \
 559                   $(sysdep-LDFLAGS) $(rtld-LDFLAGS) $(LDFLAGS.so) \
 560                   -Wl,--verbose 2>/dev/null | \
 561           sed > $@T \
 562               -e '/^=========/,/^=========/!d;/^=========/d' \
 563               -e 's/^.*\*(\.dynbss).*$$/& \
 564                  PROVIDE(__start___libc_freeres_ptrs = .); \
 565                  *(__libc_freeres_ptrs) \
 566                  PROVIDE(__stop___libc_freeres_ptrs = .);/'\
 567               -e 's@^.*\*(\.jcr).*$$@& \
 568                  PROVIDE(__start___libc_subfreeres = .);\
 569                  __libc_subfreeres : { *(__libc_subfreeres) }\
 570                  PROVIDE(__stop___libc_subfreeres = .);\
 571                  PROVIDE(__start___libc_atexit = .);\
 572                  __libc_atexit : { *(__libc_atexit) }\
 573                  PROVIDE(__stop___libc_atexit = .);\
 574                  PROVIDE(__start___libc_IO_vtables = .);\
 575                  __libc_IO_vtables : { *(__libc_IO_vtables) }\
 576                  PROVIDE(__stop___libc_IO_vtables = .);\
 577                  /DISCARD/ : { *(.gnu.glibc-stub.*) }@'
 578         test -s $@T
 579         mv -f $@T $@
 580 common-generated += shlib.lds
 581
 582 shlib-lds = $(common-objpfx)shlib.lds
 583 shlib-lds-flags = -T $(shlib-lds)
 584 endif
 585
 586 define build-shlib
 587 $(build-shlib-helper) -o $@ $(shlib-lds-flags) \
 588           $(csu-objpfx)abi-note.o $(build-shlib-objlist)
 589 endef
 590
 591 define build-module-helper
 592 $(LINK.o) -shared -static-libgcc $(sysdep-LDFLAGS) $(rtld-LDFLAGS) \
 593           $(if $($(@F)-no-z-defs)$(no-z-defs),,-Wl,-z,defs) \
 594           $(if $($(@F)-no-dt-relr),$(no-dt-relr-ldflag),$(dt-relr-ldflag)) \
 595           -B$(csu-objpfx) $(load-map-file) \
 596           $(LDFLAGS.so) $(LDFLAGS-$(@F:%.so=%).so) \
 597           $(link-test-modules-rpath-link) \
 598           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link)
 599 endef
 600
 601 # This macro is similar to build-shlib but it does not define a soname
 602 # and it does not depend on the destination name to start with `lib'.
 603 # binutils only position loadable notes into the first page for binaries,
 604 # not for shared objects
 605 define build-module
 606 $(build-module-helper) -o $@ $(shlib-lds-flags) \
 607           $(csu-objpfx)abi-note.o $(build-module-objlist) $(link-libc-args)
 608 $(call after-link,$@)
 609 endef
 610 define build-module-asneeded
 611 $(build-module-helper) -o $@ $(shlib-lds-flags) \
 612           $(csu-objpfx)abi-note.o \
 613           -Wl,--as-needed $(build-module-objlist) -Wl,--no-as-needed \
 614           $(link-libc-args)
 615 $(call after-link,$@)
 616 endef
 617
 618 # sofini.os must be placed last since it terminates .eh_frame section.
 619 build-module-helper-objlist = \
 620         $(patsubst %_pic.a,$(whole-archive) %_pic.a $(no-whole-archive),\
 621                    $(filter-out %.lds $(map-file) $(+preinit) $(+postinit) \
 622                                 $(elf-objpfx)sofini.os \
 623                                 $(link-libc-deps),$^))
 624
 625 build-module-objlist = $(build-module-helper-objlist) $(LDLIBS-$(@F:%.so=%).so)
 626 build-shlib-objlist = $(build-module-helper-objlist) \
 627                       $(LDLIBS-$(@F:lib%.so=%).so) \
 628                       $(filter $(elf-objpfx)sofini.os,$^)
 629
 630 # Don't try to use -lc when making libc.so itself.
 631 # Also omits crti.o and crtn.o, which we do not want
 632 # since we define our own `.init' section specially.
 633 LDFLAGS-c.so = -nostdlib -nostartfiles
 634 # But we still want to link libc.so against $(libc.so-gnulib).
 635 LDLIBS-c.so += $(libc.so-gnulib)
 636 # Give libc.so an entry point and make it directly runnable itself.
 637 LDFLAGS-c.so += -e __libc_main
 638 # Pre-link the objects of libc_pic.a for .gnu.glibc-stub.* processing.
 639 $(common-objpfx)libc_pic.os: $(common-objpfx)libc_pic.a
 640         $(LINK.o) -nostdlib -nostartfiles -r -o $@ \
 641         $(LDFLAGS-c_pic.os) $(whole-archive) $^ -o $@
 642
 643 ifeq (,$(strip $(shlib-lds-flags)))
 644 # Generate a list of -R options to excise .gnu.glibc-stub.* sections.
 645 $(common-objpfx)libc_pic.opts: $(common-objpfx)libc_pic.os
 646         $(OBJDUMP) -h $< | \
 647         $(AWK) '$$2 ~ /\.gnu\.glibc-stub\./ { print "-R", $$2 }' \
 648                 > $@T
 649         mv -f $@T $@
 650 # Apply those -R options.
 651 $(common-objpfx)libc_pic.os.clean: $(common-objpfx)libc_pic.opts \
 652                                    $(common-objpfx)libc_pic.os
 653         $(OBJCOPY) @$^ $@
 654 generated += libc_pic.opts libc_pic.os.clean
 655
 656 libc_pic_clean := .clean
 657 endif
 658
 659 # Build a possibly-modified version of libc_pic.a for use in building
 660 # linkobj/libc.so.
 661 ifeq (,$(filter sunrpc,$(subdirs)))
 662 $(common-objpfx)linkobj/libc_pic.a: $(common-objpfx)libc_pic.a
 663         $(make-target-directory)
 664         ln -f $< $@
 665 else
 666 $(common-objpfx)linkobj/libc_pic.a: $(common-objpfx)libc_pic.a \
 667                                     $(common-objpfx)sunrpc/librpc_compat_pic.a
 668         $(make-target-directory)
 669         (cd $(common-objpfx)linkobj; \
 670          $(AR) x ../libc_pic.a; \
 671          rm $$($(AR) t ../sunrpc/librpc_compat_pic.a | sed 's/^compat-//'); \
 672          $(AR) x ../sunrpc/librpc_compat_pic.a; \
 673          $(AR) cr libc_pic.a *.os; \
 674          rm *.os)
 675 endif # $(subdirs) contains sunrpc
 676
 677 # Clear link-libc-deps for the libc.so libraries so build-shlibs does not
 678 # filter ld.so out of the list of linked objects.
 679 $(common-objpfx)libc.so: link-libc-deps = # empty
 680 $(common-objpfx)linkobj/libc.so: link-libc-deps = # empty
 681
 682 # Use our own special initializer and finalizer files for the libc.so
 683 # libraries.
 684 $(common-objpfx)libc.so: $(common-objpfx)libc_pic.os$(libc_pic_clean) \
 685                          $(elf-objpfx)sofini.os \
 686                          $(elf-objpfx)interp.os \
 687                          $(elf-objpfx)ld.so \
 688                          $(shlib-lds)
 689         $(build-shlib)
 690         $(call after-link,$@)
 691
 692 $(common-objpfx)linkobj/libc.so: $(common-objpfx)linkobj/libc_pic.a \
 693                          $(elf-objpfx)sofini.os \
 694                          $(elf-objpfx)interp.os \
 695                          $(elf-objpfx)ld.so \
 696                          $(shlib-lds)
 697         $(build-shlib)
 698         $(call after-link,$@)
 699
 700 ifeq ($(build-shared),yes)
 701 $(common-objpfx)libc.so: $(common-objpfx)libc.map
 702 endif
 703 common-generated += libc.so libc_pic.os
 704 ifdef libc.so-version
 705 $(common-objpfx)libc.so$(libc.so-version): $(common-objpfx)libc.so
 706         $(make-link)
 707 common-generated += libc.so$(libc.so-version)
 708 endif
 709 endif
 710 \f
 711 # Figure out the source filenames in this directory.
 712
 713 override sources := $(addsuffix .c,\
 714                         $(filter-out $(elided-routines),\
 715                             $(routines) $(aux) \
 716                             $(sysdep_routines)))
 717 sysdep_routines := $(sysdep_routines)
 718
 719 headers := $(headers) $(sysdep_headers)
 720
 721 # This is the list of all object files, gotten by
 722 # replacing every ".c" in `sources' with a ".o".
 723 override objects := $(addprefix $(objpfx),$(sources:.c=.o))
 724
 725
 726 # The makefile may define $(extra-libs) with `libfoo libbar'
 727 # to build libfoo.a et al from the modules listed in $(libfoo-routines).
 728 ifdef extra-libs
 729 # extra-lib.mk is included once for each extra lib to define rules
 730 # to build it, and to add its objects to the various variables.
 731 # During its evaluation, $(lib) is set to the name of the library.
 732 extra-libs-left := $(extra-libs)
 733 include $(patsubst %,$(..)extra-lib.mk,$(extra-libs))
 734 endif
 735
 736
 737 # The makefile may define $(modules-names) to build additional modules.
 738 # These are built with $(build-module), except any in $(modules-names-nobuild).
 739 # MODULE_NAME=extramodules, except any in $(modules-names-tests).
 740 ifdef modules-names
 741 cpp-srcs-left := $(filter-out $(modules-names-tests),$(modules-names))
 742 ifneq (,$(cpp-srcs-left))
 743 lib := extramodules
 744 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
 745 endif
 746
 747 ifdef modules-names-tests
 748 cpp-srcs-left := $(filter $(modules-names-tests),$(modules-names))
 749 ifneq (,$(cpp-srcs-left))
 750 lib := testsuite
 751 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
 752 endif
 753 endif
 754
 755 extra-modules-build := $(filter-out $(modules-names-nobuild),$(modules-names))
 756 $(extra-modules-build:%=$(objpfx)%.so): $(objpfx)%.so: \
 757                 $(objpfx)%.os $(shlib-lds) $(link-libs-deps)
 758         $(build-module)
 759 endif
 760 \f
 761 +depfiles := $(sources:.c=.d) \
 762              $(patsubst %.o,%.d,$(filter %.o,$(extra-objs:.os=.o))) \
 763              $(patsubst %.oS,%.d,$(filter %.oS,$(extra-objs))) \
 764              $(patsubst %.o,%.d,$(filter %.o,$(extra-test-objs:.os=.o))) \
 765              $(addsuffix .d,$(tests) $(tests-internal) $(xtests) \
 766                 $(tests-container) $(tests-printers) \
 767                 $(test-srcs) $(tests-time64) $(xtests-time64))
 768 ifeq ($(build-programs),yes)
 769 +depfiles += $(addsuffix .d,$(others) $(sysdep-others))
 770 endif
 771 +depfiles := $(addprefix $(objpfx),\
 772                          $(filter-out $(addsuffix .d,$(omit-deps)),\
 773                                       $(+depfiles)))
 774 all-dt-files := $(foreach o,$(object-suffixes-for-libc),$(+depfiles:.d=$o.dt))
 775 +depfiles := $(patsubst %.dt,%.d,$(wildcard $(all-dt-files))) \
 776              $(wildcard $(all-dt-files:.dt=.d))
 777
 778 # This is a funny rule in that it removes its input file.
 779 %.d: %.dt
 780         @sed $(sed-remove-objpfx) $< > $(@:.d=.T) && \
 781          mv -f $(@:.d=.T) $@ && \
 782          rm -f $<
 783
 784 # Avoid the .h.d files for any .sym files whose .h files don't exist yet.
 785 # They will be generated when they're needed, and trying too early won't work.
 786 +gen-as-const := $(gen-as-const-headers:%.sym=$(common-objpfx)%.h)
 787 +depfiles += $(addsuffix .d,$(filter $(wildcard $(+gen-as-const)),\
 788                                                 $(+gen-as-const)))
 789
 790 ifdef +depfiles
 791 ifneq ($(no_deps),t)
 792 -include $(+depfiles)
 793 endif
 794 endif
 795 \f\f
 796 # Maximize efficiency by minimizing the number of rules.
 797 .SUFFIXES:      # Clear the suffix list.  We don't use suffix rules.
 798 # Don't define any builtin rules.
 799 MAKEFLAGS := $(MAKEFLAGS) -r
 800
 801 # Generic rule for making directories.
 802 %/:
 803 # mkdir isn't smart enough to strip a trailing /.
 804 # We always require a mkdir which supports the -p option to avoid error
 805 # messages in case of races.
 806         mkdir -p $(@:%/=%)
 807 \f
 808 # Make sure that object files are not removed
 809 # when they are intermediates between sources and library members.
 810 .PRECIOUS: $(addprefix $(objpfx)%,$(all-object-suffixes))
 811
 812 # Make sure that the parent library archive is never removed.
 813 .PRECIOUS: $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
 814 \f
 815 # Use the verbose option of ar and tar when not running silently.
 816 ifeq ($(silent-make),no)                        # if not -s
 817 verbose := v
 818 else                                            # -s
 819 verbose :=
 820 endif                                           # not -s
 821
 822 ARFLAGS := r$(verbose)
 823 CREATE_ARFLAGS := cru$(verbose)
 824 \f
 825 # This makes all the object files in the parent library archive.
 826
 827 .PHONY: lib lib-noranlib
 828 lib: lib-noranlib $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
 829 lib-noranlib: libobjs
 830
 831 # For object-suffix $o, the list of objects with that suffix.
 832 # Makefiles can define `elide-routines.so = foo' to leave foo.so out.
 833 o-objects = $(patsubst %.o,%$o,$(filter-out $(patsubst %,$(objpfx)%.o,\
 834                                                        $(elide-routines$o)),\
 835                                             $(objects))) \
 836             $(addprefix $(objpfx),$(o-objects$o))
 837
 838 others: $(addprefix $(objpfx),$(install-lib))
 839
 840 ifndef objects
 841
 842 # Create the stamp$o files to keep the parent makefile happy.
 843 subdir_lib: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
 844 $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o):
 845         $(make-target-directory)
 846         rm -f $@; > $@
 847 else
 848
 849 # Define explicit rules to update each $(objpfx)stamp.SUFFIX
 850 # timestamp file; these rules (one explicit rule is generated for each
 851 # object suffix) write a list of objects to update in the stamp file.
 852 # The parent will then actually add them all to the archive in the
 853 # archive rule, below.
 854 define o-iterator-doit
 855 $(objpfx)stamp$o: $(o-objects); $$(do-stamp)
 856 endef
 857 define do-stamp
 858 $(make-target-directory)
 859 echo '$(patsubst $(objpfx)%,$(addsuffix /,$(subdir))%,$^)' > $@T
 860 mv -f $@T $@
 861 endef
 862 object-suffixes-left := $(object-suffixes-for-libc)
 863 include $(o-iterator)
 864
 865 endif
 866
 867 # Now define explicit rules to build the library archives; these depend
 868 # on the stamp files built above.
 869 define o-iterator-doit
 870 $(common-objpfx)$(patsubst %,$(libtype$o),c): \
 871                 $(subdirs-stamp-o) $(common-objpfx)stamp$o; $$(do-makelib)
 872 endef
 873 define do-makelib
 874 cd $(common-objdir) && \
 875 $(AR) $(CREATE_ARFLAGS) $(@F) `cat $(patsubst $(common-objpfx)%,%,$^)`
 876 endef
 877 subdirs-stamps := $(foreach d,$(subdirs),$(common-objpfx)$d/stamp%)
 878 subdirs-stamp-o = $(subst %,$o,$(subdirs-stamps))
 879 ifndef subdir
 880 $(subdirs-stamps): subdir_lib;
 881 endif
 882 object-suffixes-left = $(object-suffixes-for-libc)
 883 include $(o-iterator)
 884
 885
 886 # This makes all the object files.
 887 .PHONY: objects objs libobjs extra-objs
 888 objects objs: libobjs extra-objs
 889 libobjs: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
 890 extra-objs: $(addprefix $(objpfx),$(extra-objs))
 891
 892 # Canned sequence for building an extra library archive.
 893 define build-extra-lib
 894 $(patsubst %/,cd % &&,$(objpfx)) \
 895 $(AR) $(CREATE_ARFLAGS) $(@:$(objpfx)%=%) \
 896       $(patsubst $(objpfx)%,%,$^)
 897 endef
 898 \f
 899 # Installation.
 900
 901 .PHONY: force-install
 902 force-install:
 903
 904 # $(install-lib) are installed from the object directory into $(libdir);
 905 # files in $(install-lib) matching `lib%.a' are ranlib'd after installation
 906 # unless they also appear in $(non-lib.a).  $(install-data) are installed as
 907 # they are into $(datadir).  $(headers) are installed as they are in
 908 # $(includedir).  $(install-bin), $(install-bin-script) and $(install-sbin)
 909 # are installed from the object directory into $(bindir), $(bindir) and
 910 # $(sbindir), respectively.  $(install-others) and $(install-others-programs)
 911 # are absolute path names of files to install; rules to install them are
 912 # defined elsewhere.
 913
 914 # The simple library name to install libc.a under.
 915 # This could be defined by a sysdep Makefile.
 916 ifndef libc-name
 917 libc-name := c
 918 endif
 919
 920 define do-install
 921 $(make-target-directory)
 922 $(INSTALL_DATA) $< $@
 923 endef
 924
 925 # Make the target directory if it doesn't exist, using the `mkinstalldirs'
 926 # script that does `mkdir -p' even if `mkdir' doesn't support that flag.
 927 define make-target-directory
 928 $(addprefix $(..)./scripts/mkinstalldirs ,\
 929             $(filter-out $(wildcard $(@D:%/=%)),$(@D:%/=%)))
 930 endef
 931
 932 # Any directory (parent or subdir) should install libc.a; this way
 933 # "make install" in a subdir is guaranteed to install everything it changes.
 934 installed-libcs := $(foreach o,$(filter-out .os,$(object-suffixes-for-libc)),\
 935                              $(inst_libdir)/$(patsubst %,$(libtype$o),\
 936                                                      $(libprefix)$(libc-name)))
 937
 938 .PHONY: check-install-supported
 939 check-install-supported:
 940
 941 # Check to see if the prefix or exec_prefix GNU standard variable
 942 # has been overridden on the command line and, if so, fail with
 943 # an error message since doing so is not supported (set DESTDIR
 944 # instead).
 945 ifeq ($(origin prefix),command line)
 946 check-install-supported:
 947         $(error Overriding prefix is not supported. Set DESTDIR instead.)
 948 endif
 949
 950 ifeq ($(origin exec_prefix),command line)
 951 check-install-supported:
 952         $(error Overriding exec_prefix is not supported. Set DESTDIR instead.)
 953 endif
 954
 955 install: check-install-supported
 956
 957 install: $(installed-libcs)
 958 $(installed-libcs): $(inst_libdir)/lib$(libprefix)%: lib $(+force)
 959         $(make-target-directory)
 960         $(INSTALL_DATA) $(common-objpfx)lib$(*:$(libc-name)%=c%) $@
 961
 962 define do-install-program
 963 $(make-target-directory)
 964 $(INSTALL_PROGRAM) $< $@.new
 965 mv -f $@.new $@
 966 endef
 967
 968 define do-install-script
 969 $(make-target-directory)
 970 $(INSTALL_SCRIPT) $< $@.new
 971 mv -f $@.new $@
 972 endef
 973
 974 install-lib.so := $(filter %.so,$(install-lib:%_pic.a=%.so))
 975 install-lib := $(filter-out %.so %_pic.a,$(install-lib))
 976
 977 ifeq (yes,$(build-shared))
 978 # Find which .so's have a version number in their soname.
 979 versioned := $(strip $(foreach so,$(install-lib.so),\
 980                                $(patsubst %,$(so),$($(so)-version))))
 981
 982 install-lib.so-versioned := $(filter $(versioned), $(install-lib.so))
 983 install-lib.so-unversioned := $(filter-out $(versioned), $(install-lib.so))
 984
 985 # For libraries whose soname have version numbers, we install two files:
 986 #       $(inst_libdir)/libfoo.so        -- for linking, symlink or ld script
 987 #       $(inst_slibdir)/libfoo.so.NN    -- for loading by SONAME
 988 install-lib-nosubdir: $(install-lib.so-unversioned:%=$(inst_slibdir)/%) \
 989                       $(foreach L,$(install-lib.so-versioned),\
 990                                 $(inst_libdir)/$L \
 991                                 $(inst_slibdir)/$L$($L-version))
 992
 993 # Install all the unversioned shared libraries.
 994 $(install-lib.so-unversioned:%=$(inst_slibdir)/%): $(inst_slibdir)/%.so: \
 995     $(objpfx)%.so $(+force)
 996         $(do-install-program)
 997
 998 ifneq ($(findstring -s,$(LN_S)),)
 999 define make-link
1000 rm -f $@.new
1001 $(SHELL) $(..)scripts/rellns-sh $< $@.new
1002 mv -f $@.new $@
1003 endef
1004 define make-link-multidir
1005 $(patsubst %/,cd %,$(objpfx)); \
1006   $(addprefix $(abspath $(..)scripts/mkinstalldirs) ,$(dir $(multidir))); \
1007   $(LN_S) . $(multidir) 2> /dev/null; \
1008   test -L $(multidir)
1009 endef
1010 else
1011 # If we have no symbolic links don't bother with rellns-sh.
1012 define make-link
1013 rm -f $@.new
1014 $(LN_S) $< $@.new
1015 mv -f $@.new $@
1016 endef
1017 define make-link-multidir
1018 $(make-target-directory)
1019 ln -f $(objpfx)/$(@F) $@
1020 endef
1021 endif
1022
1023 ifdef libc.so-version
1024 $(inst_slibdir)/libc.so$(libc.so-version): $(common-objpfx)libc.so $(+force)
1025         $(do-install-program)
1026
1027 install: $(inst_slibdir)/libc.so$(libc.so-version)
1028
1029 # This fragment of linker script gives the OUTPUT_FORMAT statement
1030 # for the configuration we are building.  We put this statement into
1031 # the linker scripts we install for -lc et al so that they will not be
1032 # used by a link for a different format on a multi-architecture system.
1033 $(common-objpfx)format.lds: $(common-objpfx)config.make \
1034                             $(common-objpfx)config.h $(..)Makerules
1035         $(LINK.o) -shared -nostdlib -nostartfiles \
1036                   -x assembler /dev/null -o $@.so
1037         $(OBJDUMP) -f $@.so | sed -n 's/.*file format \(.*\)/OUTPUT_FORMAT(\1)/;T;p' > $@
1038         rm -f $@.so
1039 common-generated += format.lds
1040
1041 ifndef subdir
1042 # What we install as libc.so for programs to link against is in fact a
1043 # link script.  It contains references for the various libraries we need.
1044 # The libc.so object is not complete since some functions are only defined
1045 # in libc_nonshared.a.
1046 # We need to use absolute paths since otherwise local copies (if they exist)
1047 # of the files are taken by the linker.
1048 install: $(inst_libdir)/libc.so
1049 $(inst_libdir)/libc.so: $(common-objpfx)format.lds \
1050                         $(common-objpfx)libc.so$(libc.so-version) \
1051                         $(inst_libdir)/$(patsubst %,$(libtype.oS),\
1052                                                   $(libprefix)$(libc-name)) \
1053                         $(+force)
1054         (echo '/* GNU ld script';\
1055          echo '   Use the shared library, but some functions are only in';\
1056          echo '   the static library, so try that secondarily.  */';\
1057          cat $<; \
1058          echo 'GROUP ( $(slibdir)/libc.so$(libc.so-version)' \
1059               '$(libdir)/$(patsubst %,$(libtype.oS),$(libprefix)$(libc-name))'\
1060               ' AS_NEEDED (' $(rtlddir)/$(rtld-installed-name) ') )' \
1061         ) > $@.new
1062         mv -f $@.new $@
1063
1064 endif
1065
1066 else
1067 install: $(inst_slibdir)/libc.so
1068 $(inst_slibdir)/libc.so: $(common-objpfx)libc.so $(+force)
1069         $(do-install-program)
1070 endif
1071
1072 ifneq (,$(versioned))
1073 # Produce three sets of rules as above for all the smaller versioned libraries.
1074
1075 define o-iterator-doit
1076 $(inst_libdir)/$o: $(inst_slibdir)/$o$($o-version) $(+force); $$(make-link)
1077 endef
1078 object-suffixes-left := $(filter-out $(install-lib-ldscripts),$(versioned))
1079 ifneq (,$(object-suffixes-left))
1080 include $(o-iterator)
1081 endif
1082
1083 # Make symlinks in the build directory, because the versioned names might
1084 # be referenced by a DT_NEEDED in another library.
1085 define o-iterator-doit
1086 $(objpfx)$o$($o-version): $(objpfx)$o; $$(make-link)
1087 endef
1088 object-suffixes-left := $(versioned)
1089 include $(o-iterator)
1090
1091 generated += $(foreach o,$(versioned),$o$($o-version))
1092
1093 define o-iterator-doit
1094 $(inst_slibdir)/$o$($o-version): $(objpfx)$o $(+force);
1095         $$(do-install-program)
1096 endef
1097 object-suffixes-left := $(versioned)
1098 include $(o-iterator)
1099 endif # ifneq (,$(versioned))
1100
1101 define do-install-so
1102 $(do-install-program)
1103 $(patsubst %,$(LN_S) -f $(@F) \
1104                         $(@D)/$(patsubst %$*.so,%,$(<F))$(libprefix)$*.so,\
1105            $(filter-out %.so,$@))
1106 endef
1107
1108 so-versions := $(sort $(foreach so,$(install-lib.so),.so$($(so)-version)))
1109 $(foreach v,$(so-versions),\
1110           $(inst_slibdir)/lib$(libprefix)%$v): $(common-objpfx)lib%.so \
1111                                                $(+force)
1112         $(do-install-so)
1113 $(foreach v,$(so-versions),\
1114           $(inst_slibdir)/$(libprefix)%$v): $(common-objpfx)%.so $(+force)
1115         $(do-install-so)
1116 endif
1117
1118 ifdef install-bin
1119 $(addprefix $(inst_bindir)/,$(install-bin)): \
1120     $(inst_bindir)/%: $(objpfx)% $(+force)
1121         $(do-install-program)
1122 endif
1123 ifdef install-bin-script
1124 $(addprefix $(inst_bindir)/,$(install-bin-script)): \
1125     $(inst_bindir)/%: $(objpfx)% $(+force)
1126         $(do-install-script)
1127 endif
1128 ifdef install-rootsbin
1129 $(addprefix $(inst_rootsbindir)/,$(install-rootsbin)): \
1130    $(inst_rootsbindir)/%: $(objpfx)% $(+force)
1131         $(do-install-program)
1132 endif
1133 ifdef install-sbin
1134 $(addprefix $(inst_sbindir)/,$(install-sbin)): \
1135     $(inst_sbindir)/%: $(objpfx)% $(+force)
1136         $(do-install-program)
1137 endif
1138 ifdef install-lib
1139 install-lib.a := $(filter lib%.a,$(install-lib))
1140 install-lib.a := $(filter-out $(install-lib-ldscripts),$(install-lib.a))
1141 install-lib-non.a := $(filter-out lib%.a,$(install-lib))
1142 ifdef install-lib-non.a
1143 $(addprefix $(inst_libdir)/$(libprefix),$(install-lib-non.a)): \
1144   $(inst_libdir)/$(libprefix)%: $(objpfx)% $(+force)
1145         $(do-install)
1146 endif
1147 ifdef install-lib.a
1148 $(install-lib.a:lib%.a=$(inst_libdir)/lib$(libprefix)%.a): \
1149   $(inst_libdir)/lib$(libprefix)%.a: $(objpfx)lib%.a $(+force)
1150         $(do-install)
1151 endif
1152 endif
1153 ifdef install-data
1154 $(addprefix $(inst_datadir)/,$(install-data)): $(inst_datadir)/%: % $(+force)
1155         $(do-install)
1156 endif
1157 headers := $(strip $(headers))
1158 ifdef headers
1159 # This implicit rule installs headers from the source directory.
1160 # It may be ignored in preference to rules from sysd-rules to find
1161 # headers in the sysdeps tree.
1162 $(inst_includedir)/%.h: $(objpfx)%.h $(+force)
1163         $(do-install)
1164 $(inst_includedir)/%.h: $(common-objpfx)%.h $(+force)
1165         $(do-install)
1166 $(inst_includedir)/%.h: %.h $(+force)
1167         $(do-install)
1168 $(inst_includedir)/%.h: $(..)include/%.h $(+force)
1169         $(do-install)
1170 headers-nonh := $(filter-out %.h,$(headers))
1171 ifdef headers-nonh
1172 $(addprefix $(inst_includedir)/,$(headers-nonh)): $(inst_includedir)/%: \
1173                                                  % $(+force)
1174         $(do-install)
1175 endif   # headers-nonh
1176 endif   # headers
1177
1178 .PHONY: install-bin-nosubdir install-bin-script-nosubdir \
1179         install-rootsbin-nosubdir install-sbin-nosubdir install-lib-nosubdir \
1180         install-data-nosubdir install-headers-nosubdir
1181 install-bin-nosubdir: $(addprefix $(inst_bindir)/,$(install-bin))
1182 install-bin-script-nosubdir: $(addprefix $(inst_bindir)/,$(install-bin-script))
1183 install-rootsbin-nosubdir: \
1184         $(addprefix $(inst_rootsbindir)/,$(install-rootsbin))
1185 install-sbin-nosubdir: $(addprefix $(inst_sbindir)/,$(install-sbin))
1186 install-lib-nosubdir: $(addprefix $(inst_libdir)/,\
1187                        $(patsubst lib%.a,lib$(libprefix)%.a,$(install-lib.a)) \
1188                        $(addprefix $(libprefix),$(install-lib-non.a)))
1189 install-data-nosubdir: $(addprefix $(inst_datadir)/,$(install-data))
1190 install-headers-nosubdir: $(addprefix $(inst_includedir)/,$(headers))
1191 install-others-nosubdir: $(install-others)
1192 install-others-programs-nosubdir: $(install-others-programs)
1193
1194 # We need all the `-nosubdir' targets so that `install' in the parent
1195 # doesn't depend on several things which each iterate over the subdirs.
1196 # This rule makes `install-FOO' always use `install-FOO-nosubdir' as a
1197 # subroutine.  Then in the parent `install-FOO' also causes subdir makes.
1198 install-%:: install-%-nosubdir ;
1199
1200 .PHONY: install install-no-libc.a-nosubdir
1201 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir \
1202                             install-lib-nosubdir install-others-nosubdir
1203 ifeq ($(build-programs),yes)
1204 install-no-libc.a-nosubdir: install-bin-nosubdir install-bin-script-nosubdir \
1205                             install-rootsbin-nosubdir install-sbin-nosubdir \
1206                             install-others-programs-nosubdir
1207 endif
1208 install: install-no-libc.a-nosubdir
1209 \f
1210 # Command to compile $< using the native libraries.
1211 define native-compile
1212 $(make-target-directory)
1213 $(BUILD_CC) $($(basename $(<F))-CFLAGS) $(ALL_BUILD_CFLAGS) \
1214             $< $(OUTPUT_OPTION) $(BUILD_LDFLAGS)
1215 endef
1216
1217 # We always want to use configuration definitions.
1218 ALL_BUILD_CFLAGS = $(BUILD_CFLAGS) $(BUILD_CPPFLAGS) -D_GNU_SOURCE \
1219                    -DIS_IN_build -include $(common-objpfx)config.h
1220
1221 # Support the GNU standard name for this target.
1222 .PHONY: check
1223 check: tests
1224 # Special target to run tests which cannot be run unconditionally.
1225 # Maintainers should use this target.
1226 .PHONY: xcheck
1227 xcheck: xtests
1228
1229 # Handle tests-time64 and xtests-time64 that should built with LFS
1230 # and 64-bit time support.
1231 include $(o-iterator)
1232 define o-iterator-doit
1233 $(foreach f,$(tests-time64) $(xtests-time64),\
1234             $(objpfx)$(f)$(o)): CFLAGS += -D_TIME_BITS=64 -D_FILE_OFFSET_BITS=64
1235 endef
1236 object-suffixes-left := $(all-object-suffixes)
1237 include $(o-iterator)
1238
1239 ifeq ($(have-time64-compat),yes)
1240 tests += $(foreach t,$(tests-time64),$(t))
1241 xtests += $(foreach t,$(xtests-time64),$(t))
1242 endif
1243
1244 # The only difference between MODULE_NAME=testsuite and MODULE_NAME=nonlib is
1245 # that almost all internal declarations from config.h, libc-symbols.h, and
1246 # include/*.h are not available to 'testsuite' code, but are to 'nonlib' code.
1247 all-testsuite := $(strip $(tests) $(xtests) $(test-srcs) $(test-extras) \
1248                  $(tests-container))
1249 ifneq (,$(all-testsuite))
1250 cpp-srcs-left = $(all-testsuite)
1251 lib := testsuite
1252 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
1253 endif
1254
1255 all-nonlib := $(strip $(others) $(others-extras))
1256 ifneq (,$(all-nonlib))
1257 cpp-srcs-left = $(all-nonlib)
1258 lib := nonlib
1259 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
1260 endif
1261
1262 # All internal tests use testsuite-internal module since for 64 bit time
1263 # support is set as default for MODULE_NAME=nonlib (which include some
1264 # installed programs).
1265 all-testsuite-internal := $(strip $(tests-internal) $(test-internal-extras))
1266 ifneq (,$(all-testsuite-internal))
1267 cpp-srcs-left = $(all-testsuite-internal)
1268 lib := testsuite-internal
1269 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
1270 endif
1271
1272 ifeq ($(build-shared),yes)
1273 # Generate normalized lists of symbols, versions, and data sizes.
1274 # This is handy for checking against existing library binaries.
1275
1276 %.symlist: $(..)scripts/abilist.awk %.dynsym
1277         LC_ALL=C $(AWK) -f $^ > $@T
1278         mv -f $@T $@
1279
1280 %.dynsym: %.so
1281         LC_ALL=C $(OBJDUMP) --dynamic-syms $< > $@T
1282         mv -f $@T $@
1283
1284 vpath %.abilist $(+sysdep_dirs)
1285
1286 # The .PRECIOUS rule prevents the files built by an implicit rule whose
1287 # target pattern is %.symlist from being considered "intermediate files"
1288 # and automatically removed.  We only want these files to be removed by
1289 # 'make clean', which is handled by the 'generated' variable.
1290 .PRECIOUS: %.symlist
1291 generated += $(extra-libs:=.symlist)
1292
1293 $(objpfx)check-abi-%.out: $(common-objpfx)config.make %.abilist \
1294                           $(objpfx)%.symlist
1295         $(check-abi); \
1296         $(evaluate-test)
1297 $(objpfx)check-abi-%.out: $(common-objpfx)config.make %.abilist \
1298                           $(common-objpfx)%.symlist
1299         $(check-abi); \
1300         $(evaluate-test)
1301 define check-abi
1302         diff -p -U 0 $(filter %.abilist,$^) $(filter %.symlist,$^) > $@
1303 endef
1304
1305 update-abi-%: $(objpfx)%.symlist %.abilist
1306         $(update-abi)
1307 update-abi-%: $(common-objpfx)%.symlist %.abilist
1308         $(update-abi)
1309 define update-abi
1310 @if cmp -s $^ 2> /dev/null; \
1311  then \
1312       echo '+++ $(filter %.abilist,$^) is unchanged'; \
1313  else cp -f $^; \
1314       echo '*** Now check $(filter %.abilist,$^) changes for correctness ***'; \
1315  fi
1316 endef
1317
1318 # Patch all .abilist files for one DSO.  The find command locates abilist
1319 # files for all architectures.  The abilist files in /generic/ are
1320 # filtered out because these are expected to remain empty.
1321 define update-all-abi
1322 $(SHELL) $(..)scripts/update-abilist.sh $^ \
1323   $$(find $(..)sysdeps -name '$*.abilist' \! -path '*/generic/*')
1324 endef
1325 update-all-abi-%: %.abilist $(objpfx)%.symlist
1326         $(update-all-abi)
1327 update-all-abi-%: %.abilist $(common-objpfx)%.symlist
1328         $(update-all-abi)
1329
1330 .PHONY: update-abi update-all-abi check-abi
1331 update-abi: $(patsubst %.so,update-abi-%,$(install-lib.so-versioned))
1332 update-all-abi: $(patsubst %.so,update-all-abi-%,$(install-lib.so-versioned))
1333 check-abi-list = $(patsubst %.so,$(objpfx)check-abi-%.out, \
1334                                  $(install-lib.so-versioned))
1335 check-abi: $(check-abi-list)
1336 ifdef subdir
1337 subdir_check-abi: check-abi
1338 subdir_update-abi: update-abi
1339 subdir_update-all-abi: update-all-abi
1340 else
1341 check-abi: subdir_check-abi
1342         if grep -q '^FAIL:' $(objpfx)*/check-abi*.test-result; then \
1343                 cat $(objpfx)*/check-abi*.out && exit 1; fi
1344 update-abi: subdir_update-abi
1345 update-all-abi: subdir_update-all-abi
1346 endif
1347
1348 ifeq ($(subdir),elf)
1349 check-abi: $(objpfx)check-abi-libc.out
1350 tests-special += $(objpfx)check-abi-libc.out
1351 update-abi: update-abi-libc
1352 update-all-abi: update-all-abi-libc
1353 common-generated += libc.symlist
1354 endif
1355
1356 ifeq ($(build-shared),yes)
1357 ifdef subdir
1358 tests-special += $(check-abi-list)
1359 endif
1360 endif
1361
1362 endif
1363 \f
1364 # These will have been set by sysdeps/posix/Makefile.
1365 L_tmpnam  ?= 1
1366 TMP_MAX   ?= 0
1367 L_ctermid ?= 1
1368 L_cuserid ?= 1
1369
1370 stdio_lim = $(common-objpfx)bits/stdio_lim.h
1371
1372 $(stdio_lim:lim.h=%.h) $(stdio_lim:lim.h=%.d): $(stdio_lim:lim.h=%.st); @:
1373 $(stdio_lim:h=st): $(..)stdio-common/stdio_lim.h.in $(..)Rules \
1374                    $(common-objpfx)config.make
1375         $(make-target-directory)
1376         { echo '#include "$(..)posix/bits/posix1_lim.h"';               \
1377         } |                                                             \
1378         $(CC) -E -dM -MD -MP -MF $(@:st=dT) -MT '$(@:st=h) $(@:st=d)'   \
1379               $(CPPUNDEFS) $(+includes) -xc - -o $(@:st=hT)
1380         sed $(sed-remove-objpfx) $(sed-remove-dotdot)                   \
1381             $(@:st=dT) > $(@:st=dt)
1382         mv -f $(@:st=dt) $(@:st=d)
1383         fopen_max=`sed -n 's/^#define OPEN_MAX //1p' $(@:st=hT)`;       \
1384         filename_max=`sed -n 's/^#define PATH_MAX //1p' $(@:st=hT)`;    \
1385         fopen_max=$${fopen_max:-16};                                    \
1386         filename_max=$${filename_max:-1024};                            \
1387         sed -e "s/@FOPEN_MAX@/$$fopen_max/"                             \
1388             -e "s/@FILENAME_MAX@/$$filename_max/"                       \
1389             -e "s/@L_tmpnam@/$(L_tmpnam)/"                              \
1390             -e "s/@TMP_MAX@/$(TMP_MAX)/"                                \
1391             -e "s/@L_ctermid@/$(L_ctermid)/"                            \
1392             -e "s/@L_cuserid@/$(L_cuserid)/"                            \
1393             $< > $(@:st=h.new)
1394         $(move-if-change) $(@:st=h.new) $(@:st=h)
1395 # Remove these last so that they can be examined if something went wrong.
1396         rm -f $(@:st=hT) $(@:st=dT) $(@:st=dt)
1397         touch $@
1398 # Get dependencies.
1399 ifndef no_deps
1400 -include $(stdio_lim:h=d)
1401 endif
1402 common-generated += bits/stdio_lim.h bits/stdio_lim.d bits/stdio_lim.st
1403 \f
1404 FORCE:
1405
1406 .PHONY: echo-headers
1407 echo-headers:
1408         @echo $(headers)
1409
1410 %.bz2: %; bzip2 -9vk $<
1411 %.gz: %; gzip -9vnc $< > $@.new && mv -f $@.new $@
1412 %.xz: %; xz -9evk $<
1413 \f
1414 # Common cleaning targets.
1415
1416 .PHONY: common-mostlyclean common-clean mostlyclean clean do-tests-clean
1417 clean: common-clean
1418 mostlyclean: common-mostlyclean
1419
1420 do-tests-clean:
1421         -rm -f $(addprefix $(objpfx),$(addsuffix .out,$(tests) \
1422                                                       $(tests-internal) \
1423                                                       $(xtests) \
1424                                                       $(test-srcs)) \
1425                                      $(addsuffix .test-result,$(tests) \
1426                                                               $(tests-internal) \
1427                                                               $(xtests) \
1428                                                               $(test-srcs)))
1429
1430 # Remove the object files.
1431 common-mostlyclean:
1432         -rm -f $(addprefix $(objpfx),$(tests) $(tests-internal) $(xtests) \
1433                                      $(test-srcs) \
1434                                      $(others) $(sysdep-others) stubs \
1435                                      $(addsuffix .o,$(tests) \
1436                                                     $(tests-internal) \
1437                                                     $(xtests) \
1438                                                     $(test-srcs) \
1439                                                     $(others) \
1440                                                     $(sysdep-others)) \
1441                                      $(addsuffix .out,$(tests) \
1442                                                       $(tests-internal) \
1443                                                       $(xtests) \
1444                                                       $(test-srcs)) \
1445                                      $(addsuffix .test-result,$(tests) \
1446                                                               $(tests-internal) \
1447                                                               $(xtests) \
1448                                                               $(test-srcs)))
1449         -rm -f $(addprefix $(objpfx),$(extra-objs) $(extra-test-objs) \
1450                                      $(install-lib) $(install-lib.so) \
1451                                      $(install-lib.so:%.so=%_pic.a))
1452         -rm -f core
1453         -rm -f $(objpfx)rtld-*.os
1454         $(rmobjs)
1455 define rmobjs
1456 $(foreach o,$(object-suffixes-for-libc),
1457 -rm -f $(objpfx)stamp$o $(o-objects))
1458 endef
1459
1460 # Also remove the dependencies and generated source files.
1461 common-clean: common-mostlyclean
1462         -rm -f $(addprefix $(objpfx),$(generated))
1463         -rm -f $(objpfx)*.d $(objpfx)*.dt
1464         -rm -fr $(addprefix $(objpfx),$(generated-dirs))
1465         -rm -f $(addprefix $(common-objpfx),$(common-generated))
1466         -rm -f $(gen-as-const-headers:%.sym=$(common-objpfx)%.h)
1467 \f
1468 # Produce a file `stubs' which contains `#define __stub_FUNCTION'
1469 # for each function which is a stub.
1470
1471 ifdef objpfx
1472 .PHONY: stubs # The parent Makefile calls this target.
1473 stubs: $(objpfx)stubs
1474 endif
1475 objs-for-stubs := $(foreach o,$(object-suffixes-for-libc),$(o-objects)) \
1476                   $(addprefix $(objpfx),$(extra-objs))
1477 $(objpfx)stubs: $(objs-for-stubs)
1478 ifneq (,$(strip $(objs-for-stubs)))
1479         (cd $(objpfx).; $(OBJDUMP) -h $(patsubst $(objpfx)%,%,$^)) | \
1480         $(AWK) '/\.gnu\.glibc-stub\./ { \
1481                   sub(/\.gnu\.glibc-stub\./, "", $$2); \
1482                   stubs[$$2] = 1; } \
1483                 END { for (s in stubs) print "#define __stub_" s }' > $@T
1484         mv -f $@T $@
1485 else
1486         > $@
1487 endif
1488 \f
1489 ifneq (,$(strip $(gpl2lgpl)))
1490 ifneq (,$(wildcard $(..)gpl2lgpl.sed))
1491 # Snarf from the master source and frob the copying notice.
1492 $(gpl2lgpl): %: $(..)gpl2lgpl.sed /home/gd/gnu/lib/%
1493         sed -f $^ > $@-tmp
1494 # So I don't edit them by mistake.
1495         chmod a-w $@-tmp
1496         mv -f $@-tmp $@
1497 endif
1498 endif
1499
1500 # Local Variables:
1501 # mode: makefile
1502 # End: