libio: Improve fortify with clang
[glibc.git] / Makerules
blob275110dda82fa77e91e7064a77e98ca2bb19d5db
1 # Copyright (C) 1991-2024 Free Software Foundation, Inc.
2 # This file is part of the GNU C Library.
4 # The GNU C Library is free software; you can redistribute it and/or
5 # modify it under the terms of the GNU 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.
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.
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/>.
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).
23 ifneq (,)
24 This makefile requires GNU Make.
25 endif
27 REQUIRED_MAKE_VERSION = 3.74
28 REAL_MAKE_VERSION = $(firstword $(MAKE_VERSION))
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
36 ifdef   subdir
37 ..      := ../
38 endif   # subdir
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
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
54 ifndef +included-Makeconfig
55 include $(..)Makeconfig
56 endif
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))
64 # Include any system-specific makefiles.
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) $(..)))
72 # The same is true for RPC source files.
73 vpath %.x $(subst $(empty) ,:,$(strip $(common-objpfx) $(objpfx) \
74                                       $(+sysdep_dirs) $(..)))
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
80 sysdep-makefiles := $(wildcard $(sysdirs:=/Makefile))
81 ifneq (,$(sysdep-makefiles))
82 include $(sysdep-makefiles)
83 endif
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))
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 $@
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 $@
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
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
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
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
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
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))
187 # Don't let any before-compile file be an intermediate and get removed.
188 ifdef before-compile
189 $(before-compile):
190 endif
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
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 constructs and contains @@@ LINE @@@ for each LINE
204 # to emit in the generated makefile, and use -include $(common-objpfx)FOO.make.
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
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
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
237 # This is a hack we use to generate .py files with constants for
238 # Python code.
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).
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 $@
256 generated += $(py-const)
257 endif  # gen-py-const-headers
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)
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
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
355 ###############################################################################
356 # NOTE!  Everything adding to before-compile needs to come before this point! #
357 ###############################################################################
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.
365 # System-dependent makefiles can put in `inhibit-sysdep-asm' regexps
366 # matching sysdep directories whose assembly source files should be
367 # suppressed.
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 $@
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
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)
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)
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)
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)
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)
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
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)
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 $@
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 $@)) $(sysdep-ASFLAGS) \
451                   $(ASFLAGS-$(<F)) $(ASFLAGS-$(@F))
452 COMPILE.c = $(CC) -c $(CFLAGS) $(CPPFLAGS)
453 COMPILE.S = $(CC) -c $(CPPFLAGS) $(S-CPPFLAGS) \
454                   $(ASFLAGS) $(ASFLAGS-$(suffix $@)) $(sysdep-ASFLAGS) \
455                   $(ASFLAGS-$(<F)) $(ASFLAGS-$(@F))
457 # We need this for the output to go in the right place.  It will default to
458 # empty if make was configured to work with a cc that can't grok -c and -o
459 # together.  You can't compile the C library with such a compiler.
460 OUTPUT_OPTION = -o $@
462 # This is the end of the pipeline for compiling generated C code.
463 compile-stdin.c = $(COMPILE.c) -o $@ -x c - $(compile-mkdep-flags)
465 # We need the $(CFLAGS) to be in there to have the right predefines during
466 # the dependency run for C sources.  But having it for assembly sources can
467 # get the wrong predefines.
468 S-CPPFLAGS = -DASSEMBLER $(asm-CPPFLAGS)
470 ifneq (,$(objpfx))
471 # Continuation lines here are dangerous because they introduce spaces!
472 define sed-remove-objpfx
473 -e 's@ $(subst .,\.,$(subst @,\@,$(common-objpfx)))@ $$(common-objpfx)@g' \
474 -e 's@^$(subst .,\.,$(subst @,\@,$(common-objpfx)))@$$(common-objpfx)@g'
475 endef
476 endif
478 # Modify the list of routines we build for different targets
480 ifeq (yes,$(build-shared))
481 ifndef libc.so-version
482 # Undefine this because it can't work when we libc.so is unversioned.
483 static-only-routines =
484 endif
485 endif
487 elide-routines.oS += $(filter-out $(static-only-routines),\
488                                   $(routines) $(aux) $(sysdep_routines))
489 elide-routines.os += $(static-only-routines)
491 # If we have versioned code we don't need the old versions in any of the
492 # static libraries.
493 elide-routines.o  += $(shared-only-routines)
494 elide-routines.op += $(shared-only-routines)
496 # Shared library building.
498 ifeq (yes,$(build-shared))
500 # Reference map file only when shared libraries are built and a map file name
501 # is given.
502 ifeq ($(build-shared),yes)
503 map-file = $(firstword $($(@F:.so=-map)) \
504                        $(addprefix $(common-objpfx), \
505                                    $(filter $(@F:.so=.map),$(version-maps))))
506 load-map-file = $(map-file:%=-Wl,--version-script=%)
507 endif
509 # Compiler arguments to use to link a shared object with libc and
510 # ld.so.  This is intended to be as similar as possible to a default
511 # link with an installed libc.
512 link-libc-args = -Wl,--start-group \
513                  $(libc-for-link) \
514                  $(common-objpfx)libc_nonshared.a \
515                  -Wl,--as-needed $(elf-objpfx)ld.so -Wl,--no-as-needed \
516                  -Wl,--end-group
518 # The corresponding shared libc to use.  This may be modified for a
519 # particular target.
520 libc-for-link = $(common-objpfx)libc.so
522 # The corresponding dependencies.  As these are used in dependencies,
523 # not just commands, they cannot use target-specific variables so need
524 # to name both possible libc.so objects.
525 link-libc-deps = $(common-objpfx)libc.so $(common-objpfx)linkobj/libc.so \
526                  $(common-objpfx)libc_nonshared.a $(elf-objpfx)ld.so
528 # Pattern rule to build a shared object from an archive of PIC objects.
529 # This must come after the installation rules so Make doesn't try to
530 # build shared libraries in place from the installed *_pic.a files.
531 # $(LDLIBS-%.so) may contain -l switches to generate run-time dependencies
532 # on other shared objects.  The linking with libc and ld.so is intended
533 # to be as similar as possible to a default link with an installed libc.
534 lib%.so: lib%_pic.a $(+preinit) $(+postinit) $(link-libc-deps)
535         $(build-shlib) $(link-libc-args)
536         $(call after-link,$@)
538 define build-shlib-helper
539 $(LINK.o) -shared -static-libgcc -Wl,-O1 $(sysdep-LDFLAGS) \
540           $(if $($(@F)-no-z-defs)$(no-z-defs),,-Wl,-z,defs) $(rtld-LDFLAGS) \
541           $(if $($(@F)-no-dt-relr),$(no-dt-relr-ldflag),$(dt-relr-ldflag)) \
542           $(extra-B-$(@F:lib%.so=%).so) -B$(csu-objpfx) \
543           $(extra-B-$(@F:lib%.so=%).so) $(load-map-file) \
544           -Wl,-soname=lib$(libprefix)$(@F:lib%.so=%).so$($(@F)-version) \
545           $(LDFLAGS.so) $(LDFLAGS-lib.so) $(LDFLAGS-$(@F:lib%.so=%).so) \
546           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link)
547 endef
549 define build-shlib
550 $(build-shlib-helper) -o $@ \
551           $(csu-objpfx)abi-note.o $(build-shlib-objlist)
552 endef
554 define build-module-helper
555 $(LINK.o) -shared -static-libgcc $(sysdep-LDFLAGS) $(rtld-LDFLAGS) \
556           $(if $($(@F)-no-z-defs)$(no-z-defs),,-Wl,-z,defs) \
557           $(if $($(@F)-no-dt-relr),$(no-dt-relr-ldflag),$(dt-relr-ldflag)) \
558           -B$(csu-objpfx) $(load-map-file) \
559           $(LDFLAGS.so) $(LDFLAGS-$(@F:%.so=%).so) \
560           $(link-test-modules-rpath-link) \
561           -L$(subst :, -L,$(rpath-link)) -Wl,-rpath-link=$(rpath-link)
562 endef
564 # This macro is similar to build-shlib but it does not define a soname
565 # and it does not depend on the destination name to start with `lib'.
566 # binutils only position loadable notes into the first page for binaries,
567 # not for shared objects
568 define build-module
569 $(build-module-helper) -o $@ \
570           $(csu-objpfx)abi-note.o $(build-module-objlist) $(link-libc-args)
571 $(call after-link,$@)
572 endef
573 define build-module-asneeded
574 $(build-module-helper) -o $@ \
575           $(csu-objpfx)abi-note.o \
576           -Wl,--as-needed $(build-module-objlist) -Wl,--no-as-needed \
577           $(link-libc-args)
578 $(call after-link,$@)
579 endef
581 # sofini.os must be placed last since it terminates .eh_frame section.
582 build-module-helper-objlist = \
583         $(patsubst %_pic.a,$(whole-archive) %_pic.a $(no-whole-archive),\
584                    $(filter-out %.lds $(map-file) $(+preinit) $(+postinit) \
585                                 $(elf-objpfx)sofini.os \
586                                 $(link-libc-deps),$^))
588 build-module-objlist = $(build-module-helper-objlist) $(LDLIBS-$(@F:%.so=%).so)
589 build-shlib-objlist = $(build-module-helper-objlist) \
590                       $(LDLIBS-$(@F:lib%.so=%).so) \
591                       $(filter $(elf-objpfx)sofini.os,$^)
593 # Don't try to use -lc when making libc.so itself.
594 # Also omits crti.o and crtn.o, which we do not want
595 # since we define our own `.init' section specially.
596 LDFLAGS-c.so = -nostdlib -nostartfiles
597 # But we still want to link libc.so against $(libc.so-gnulib).
598 LDLIBS-c.so += $(libc.so-gnulib)
599 # Give libc.so an entry point and make it directly runnable itself.
600 LDFLAGS-c.so += -e __libc_main
601 # Pre-link the objects of libc_pic.a for .gnu.glibc-stub.* processing.
602 $(common-objpfx)libc_pic.os: $(common-objpfx)libc_pic.a
603         $(LINK.o) -nostdlib -nostartfiles -r -o $@ \
604         $(LDFLAGS-c_pic.os) $(whole-archive) $^ -o $@
606 # Generate a list of -R options to excise .gnu.glibc-stub.* sections.
607 $(common-objpfx)libc_pic.opts: $(common-objpfx)libc_pic.os
608         $(OBJDUMP) -h $< | \
609         $(AWK) '$$2 ~ /\.gnu\.glibc-stub\./ { print "-R", $$2 }' \
610                 > $@T
611         mv -f $@T $@
612 # Apply those -R options.
613 $(common-objpfx)libc_pic.os.clean: $(common-objpfx)libc_pic.opts \
614                                    $(common-objpfx)libc_pic.os
615         $(OBJCOPY) @$^ $@
616 generated += libc_pic.opts libc_pic.os.clean
618 libc_pic_clean := .clean
620 # Build a possibly-modified version of libc_pic.a for use in building
621 # linkobj/libc.so.
622 ifeq (,$(filter sunrpc,$(subdirs)))
623 $(common-objpfx)linkobj/libc_pic.a: $(common-objpfx)libc_pic.a
624         $(make-target-directory)
625         ln -f $< $@
626 else
627 $(common-objpfx)linkobj/libc_pic.a: $(common-objpfx)libc_pic.a \
628                                     $(common-objpfx)sunrpc/librpc_compat_pic.a
629         $(make-target-directory)
630         (cd $(common-objpfx)linkobj; \
631          $(AR) x ../libc_pic.a; \
632          rm $$($(AR) t ../sunrpc/librpc_compat_pic.a | sed 's/^compat-//'); \
633          $(AR) x ../sunrpc/librpc_compat_pic.a; \
634          $(AR) cr libc_pic.a *.os; \
635          rm *.os)
636 endif # $(subdirs) contains sunrpc
638 # Clear link-libc-deps for the libc.so libraries so build-shlibs does not
639 # filter ld.so out of the list of linked objects.
640 $(common-objpfx)libc.so: link-libc-deps = # empty
641 $(common-objpfx)linkobj/libc.so: link-libc-deps = # empty
643 # Use our own special initializer and finalizer files for the libc.so
644 # libraries.
645 $(common-objpfx)libc.so: $(common-objpfx)libc_pic.os$(libc_pic_clean) \
646                          $(elf-objpfx)sofini.os \
647                          $(elf-objpfx)interp.os \
648                          $(elf-objpfx)ld.so
649         $(build-shlib)
650         $(call after-link,$@)
652 $(common-objpfx)linkobj/libc.so: $(common-objpfx)linkobj/libc_pic.a \
653                          $(elf-objpfx)sofini.os \
654                          $(elf-objpfx)interp.os \
655                          $(elf-objpfx)ld.so
656         $(build-shlib)
657         $(call after-link,$@)
659 ifeq ($(build-shared),yes)
660 $(common-objpfx)libc.so: $(common-objpfx)libc.map
661 endif
662 common-generated += libc.so libc_pic.os
663 ifdef libc.so-version
664 $(common-objpfx)libc.so$(libc.so-version): $(common-objpfx)libc.so
665         $(make-link)
666 common-generated += libc.so$(libc.so-version)
667 endif
668 endif
670 # Figure out the source filenames in this directory.
672 override sources := $(addsuffix .c,\
673                         $(filter-out $(elided-routines),\
674                             $(routines) $(aux) \
675                             $(sysdep_routines)))
676 sysdep_routines := $(sysdep_routines)
678 headers := $(headers) $(sysdep_headers)
680 # This is the list of all object files, gotten by
681 # replacing every ".c" in `sources' with a ".o".
682 override objects := $(addprefix $(objpfx),$(sources:.c=.o))
685 # The makefile may define $(extra-libs) with `libfoo libbar'
686 # to build libfoo.a et al from the modules listed in $(libfoo-routines).
687 ifdef extra-libs
688 # extra-lib.mk is included once for each extra lib to define rules
689 # to build it, and to add its objects to the various variables.
690 # During its evaluation, $(lib) is set to the name of the library.
691 extra-libs-left := $(extra-libs)
692 include $(patsubst %,$(..)extra-lib.mk,$(extra-libs))
693 endif
696 # The makefile may define $(modules-names) to build additional modules.
697 # These are built with $(build-module), except any in $(modules-names-nobuild).
698 # MODULE_NAME=extramodules, except any in $(modules-names-tests).
699 ifdef modules-names
700 cpp-srcs-left := $(filter-out $(modules-names-tests),$(modules-names))
701 ifneq (,$(cpp-srcs-left))
702 lib := extramodules
703 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
704 endif
706 ifdef modules-names-tests
707 cpp-srcs-left := $(filter $(modules-names-tests),$(modules-names))
708 ifneq (,$(cpp-srcs-left))
709 lib := testsuite
710 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
711 endif
712 endif
714 extra-modules-build := $(filter-out $(modules-names-nobuild),$(modules-names))
715 $(extra-modules-build:%=$(objpfx)%.so): $(objpfx)%.so: \
716                 $(objpfx)%.os $(link-libs-deps)
717         $(build-module)
718 endif
720 +depfiles := $(sources:.c=.d) \
721              $(patsubst %.o,%.d,$(filter %.o,$(extra-objs:.os=.o))) \
722              $(patsubst %.oS,%.d,$(filter %.oS,$(extra-objs))) \
723              $(patsubst %.o,%.d,$(filter %.o,$(extra-test-objs:.os=.o))) \
724              $(addsuffix .d,$(tests) $(tests-internal) $(xtests) \
725                 $(tests-container) $(tests-printers) \
726                 $(test-srcs) $(tests-time64) $(xtests-time64))
727 ifeq ($(build-programs),yes)
728 +depfiles += $(addsuffix .d,$(others) $(sysdep-others))
729 endif
730 +depfiles := $(addprefix $(objpfx),\
731                          $(filter-out $(addsuffix .d,$(omit-deps)),\
732                                       $(+depfiles)))
733 all-dt-files := $(foreach o,$(object-suffixes-for-libc),$(+depfiles:.d=$o.dt))
734 +depfiles := $(patsubst %.dt,%.d,$(wildcard $(all-dt-files))) \
735              $(wildcard $(all-dt-files:.dt=.d))
737 # This is a funny rule in that it removes its input file.
738 %.d: %.dt
739         @sed $(sed-remove-objpfx) $< > $(@:.d=.T) && \
740          mv -f $(@:.d=.T) $@ && \
741          rm -f $<
743 # Avoid the .h.d files for any .sym files whose .h files don't exist yet.
744 # They will be generated when they're needed, and trying too early won't work.
745 +gen-as-const := $(gen-as-const-headers:%.sym=$(common-objpfx)%.h)
746 +depfiles += $(addsuffix .d,$(filter $(wildcard $(+gen-as-const)),\
747                                                 $(+gen-as-const)))
749 ifdef +depfiles
750 ifneq ($(no_deps),t)
751 -include $(+depfiles)
752 endif
753 endif
754 \f\f
755 # Maximize efficiency by minimizing the number of rules.
756 .SUFFIXES:      # Clear the suffix list.  We don't use suffix rules.
757 # Don't define any builtin rules.
758 MAKEFLAGS := $(MAKEFLAGS) -r
760 # Generic rule for making directories.
762 # mkdir isn't smart enough to strip a trailing /.
763 # We always require a mkdir which supports the -p option to avoid error
764 # messages in case of races.
765         mkdir -p $(@:%/=%)
767 # Make sure that object files are not removed
768 # when they are intermediates between sources and library members.
769 .PRECIOUS: $(addprefix $(objpfx)%,$(all-object-suffixes))
771 # Make sure that the parent library archive is never removed.
772 .PRECIOUS: $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
774 # Use the verbose option of ar and tar when not running silently.
775 ifeq ($(silent-make),no)                        # if not -s
776 verbose := v
777 else                                            # -s
778 verbose :=
779 endif                                           # not -s
781 ARFLAGS := r$(verbose)
782 CREATE_ARFLAGS := cru$(verbose)
784 # This makes all the object files in the parent library archive.
786 .PHONY: lib lib-noranlib
787 lib: lib-noranlib $(foreach l,$(libtypes),$(patsubst %,$(common-objpfx)$l,c))
788 lib-noranlib: libobjs
790 # For object-suffix $o, the list of objects with that suffix.
791 # Makefiles can define `elide-routines.so = foo' to leave foo.so out.
792 o-objects = $(patsubst %.o,%$o,$(filter-out $(patsubst %,$(objpfx)%.o,\
793                                                        $(elide-routines$o)),\
794                                             $(objects))) \
795             $(addprefix $(objpfx),$(o-objects$o))
797 others: $(addprefix $(objpfx),$(install-lib))
799 ifndef objects
801 # Create the stamp$o files to keep the parent makefile happy.
802 subdir_lib: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
803 $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o):
804         $(make-target-directory)
805         rm -f $@; > $@
806 else
808 # Define explicit rules to update each $(objpfx)stamp.SUFFIX
809 # timestamp file; these rules (one explicit rule is generated for each
810 # object suffix) write a list of objects to update in the stamp file.
811 # The parent will then actually add them all to the archive in the
812 # archive rule, below.
813 define o-iterator-doit
814 $(objpfx)stamp$o: $(o-objects); $$(do-stamp)
815 endef
816 define do-stamp
817 $(make-target-directory)
818 echo '$(patsubst $(objpfx)%,$(addsuffix /,$(subdir))%,$^)' > $@T
819 mv -f $@T $@
820 endef
821 object-suffixes-left := $(object-suffixes-for-libc)
822 include $(o-iterator)
824 endif
826 # Now define explicit rules to build the library archives; these depend
827 # on the stamp files built above.
828 define o-iterator-doit
829 $(common-objpfx)$(patsubst %,$(libtype$o),c): \
830                 $(subdirs-stamp-o) $(common-objpfx)stamp$o; $$(do-makelib)
831 endef
832 define do-makelib
833 cd $(common-objdir) && \
834 $(AR) $(CREATE_ARFLAGS) $(@F) `cat $(patsubst $(common-objpfx)%,%,$^)`
835 endef
836 subdirs-stamps := $(foreach d,$(subdirs),$(common-objpfx)$d/stamp%)
837 subdirs-stamp-o = $(subst %,$o,$(subdirs-stamps))
838 ifndef subdir
839 $(subdirs-stamps): subdir_lib;
840 endif
841 object-suffixes-left = $(object-suffixes-for-libc)
842 include $(o-iterator)
845 # This makes all the object files.
846 .PHONY: objects objs libobjs extra-objs
847 objects objs: libobjs extra-objs
848 libobjs: $(foreach o,$(object-suffixes-for-libc),$(objpfx)stamp$o)
849 extra-objs: $(addprefix $(objpfx),$(extra-objs))
851 # Canned sequence for building an extra library archive.
852 define build-extra-lib
853 $(patsubst %/,cd % &&,$(objpfx)) \
854 $(AR) $(CREATE_ARFLAGS) $(@:$(objpfx)%=%) \
855       $(patsubst $(objpfx)%,%,$^)
856 endef
858 # Installation.
860 .PHONY: force-install
861 force-install:
863 # $(install-lib) are installed from the object directory into $(libdir);
864 # files in $(install-lib) matching `lib%.a' are ranlib'd after installation
865 # unless they also appear in $(non-lib.a).  $(install-data) are installed as
866 # they are into $(datadir).  $(headers) are installed as they are in
867 # $(includedir).  $(install-bin), $(install-bin-script) and $(install-sbin)
868 # are installed from the object directory into $(bindir), $(bindir) and
869 # $(sbindir), respectively.  $(install-others) and $(install-others-programs)
870 # are absolute path names of files to install; rules to install them are
871 # defined elsewhere.
873 # The simple library name to install libc.a under.
874 # This could be defined by a sysdep Makefile.
875 ifndef libc-name
876 libc-name := c
877 endif
879 define do-install
880 $(make-target-directory)
881 $(INSTALL_DATA) $< $@
882 endef
884 # Make the target directory if it doesn't exist, using the `mkinstalldirs'
885 # script that does `mkdir -p' even if `mkdir' doesn't support that flag.
886 define make-target-directory
887 $(addprefix $(..)./scripts/mkinstalldirs ,\
888             $(filter-out $(wildcard $(@D:%/=%)),$(@D:%/=%)))
889 endef
891 # Any directory (parent or subdir) should install libc.a; this way
892 # "make install" in a subdir is guaranteed to install everything it changes.
893 installed-libcs := $(foreach o,$(filter-out .os,$(object-suffixes-for-libc)),\
894                              $(inst_libdir)/$(patsubst %,$(libtype$o),\
895                                                      $(libprefix)$(libc-name)))
897 .PHONY: check-install-supported
898 check-install-supported:
900 # Check to see if the prefix or exec_prefix GNU standard variable
901 # has been overridden on the command line and, if so, fail with
902 # an error message since doing so is not supported (set DESTDIR
903 # instead).
904 ifeq ($(origin prefix),command line)
905 check-install-supported:
906         $(error Overriding prefix is not supported. Set DESTDIR instead.)
907 endif
909 ifeq ($(origin exec_prefix),command line)
910 check-install-supported:
911         $(error Overriding exec_prefix is not supported. Set DESTDIR instead.)
912 endif
914 install: check-install-supported
916 install: $(installed-libcs)
917 $(installed-libcs): $(inst_libdir)/lib$(libprefix)%: lib $(+force)
918         $(make-target-directory)
919         $(INSTALL_DATA) $(common-objpfx)lib$(*:$(libc-name)%=c%) $@
921 define do-install-program
922 $(make-target-directory)
923 $(INSTALL_PROGRAM) $< $@.new
924 mv -f $@.new $@
925 endef
927 define do-install-script
928 $(make-target-directory)
929 $(INSTALL_SCRIPT) $< $@.new
930 mv -f $@.new $@
931 endef
933 install-lib.so := $(filter %.so,$(install-lib:%_pic.a=%.so))
934 install-lib := $(filter-out %.so %_pic.a,$(install-lib))
936 ifeq (yes,$(build-shared))
937 # Find which .so's have a version number in their soname.
938 versioned := $(strip $(foreach so,$(install-lib.so),\
939                                $(patsubst %,$(so),$($(so)-version))))
941 install-lib.so-versioned := $(filter $(versioned), $(install-lib.so))
942 install-lib.so-unversioned := $(filter-out $(versioned), $(install-lib.so))
944 # For libraries whose soname have version numbers, we install two files:
945 #       $(inst_libdir)/libfoo.so        -- for linking, symlink or ld script
946 #       $(inst_slibdir)/libfoo.so.NN    -- for loading by SONAME
947 install-lib-nosubdir: $(install-lib.so-unversioned:%=$(inst_slibdir)/%) \
948                       $(foreach L,$(install-lib.so-versioned),\
949                                 $(inst_libdir)/$L \
950                                 $(inst_slibdir)/$L$($L-version))
952 # Install all the unversioned shared libraries.
953 $(install-lib.so-unversioned:%=$(inst_slibdir)/%): $(inst_slibdir)/%.so: \
954     $(objpfx)%.so $(+force)
955         $(do-install-program)
957 ifneq ($(findstring -s,$(LN_S)),)
958 define make-link
959 rm -f $@.new
960 $(SHELL) $(..)scripts/rellns-sh $< $@.new
961 mv -f $@.new $@
962 endef
963 define make-link-multidir
964 $(patsubst %/,cd %,$(objpfx)); \
965   $(addprefix $(abspath $(..)scripts/mkinstalldirs) ,$(dir $(multidir))); \
966   $(LN_S) . $(multidir) 2> /dev/null; \
967   test -L $(multidir)
968 endef
969 else
970 # If we have no symbolic links don't bother with rellns-sh.
971 define make-link
972 rm -f $@.new
973 $(LN_S) $< $@.new
974 mv -f $@.new $@
975 endef
976 define make-link-multidir
977 $(make-target-directory)
978 ln -f $(objpfx)/$(@F) $@
979 endef
980 endif
982 ifdef libc.so-version
983 $(inst_slibdir)/libc.so$(libc.so-version): $(common-objpfx)libc.so $(+force)
984         $(do-install-program)
986 install: $(inst_slibdir)/libc.so$(libc.so-version)
988 # This fragment of linker script gives the OUTPUT_FORMAT statement
989 # for the configuration we are building.  We put this statement into
990 # the linker scripts we install for -lc et al so that they will not be
991 # used by a link for a different format on a multi-architecture system.
992 $(common-objpfx)format.lds: $(common-objpfx)config.make \
993                             $(common-objpfx)config.h $(..)Makerules
994         $(LINK.o) -shared -nostdlib -nostartfiles \
995                   -x assembler /dev/null -o $@.so
996         $(OBJDUMP) -f $@.so | sed -n 's/.*file format \(.*\)/OUTPUT_FORMAT(\1)/;T;p' > $@
997         rm -f $@.so
998 common-generated += format.lds
1000 ifndef subdir
1001 # What we install as libc.so for programs to link against is in fact a
1002 # link script.  It contains references for the various libraries we need.
1003 # The libc.so object is not complete since some functions are only defined
1004 # in libc_nonshared.a.
1005 # We need to use absolute paths since otherwise local copies (if they exist)
1006 # of the files are taken by the linker.
1007 install: $(inst_libdir)/libc.so
1008 $(inst_libdir)/libc.so: $(common-objpfx)format.lds \
1009                         $(common-objpfx)libc.so$(libc.so-version) \
1010                         $(inst_libdir)/$(patsubst %,$(libtype.oS),\
1011                                                   $(libprefix)$(libc-name)) \
1012                         $(+force)
1013         (echo '/* GNU ld script';\
1014          echo '   Use the shared library, but some functions are only in';\
1015          echo '   the static library, so try that secondarily.  */';\
1016          cat $<; \
1017          echo 'GROUP ( $(slibdir)/libc.so$(libc.so-version)' \
1018               '$(libdir)/$(patsubst %,$(libtype.oS),$(libprefix)$(libc-name))'\
1019               ' AS_NEEDED (' $(rtlddir)/$(rtld-installed-name) ') )' \
1020         ) > $@.new
1021         mv -f $@.new $@
1023 endif
1025 else
1026 install: $(inst_slibdir)/libc.so
1027 $(inst_slibdir)/libc.so: $(common-objpfx)libc.so $(+force)
1028         $(do-install-program)
1029 endif
1031 ifneq (,$(versioned))
1032 # Produce three sets of rules as above for all the smaller versioned libraries.
1034 define o-iterator-doit
1035 $(inst_libdir)/$o: $(inst_slibdir)/$o$($o-version) $(+force); $$(make-link)
1036 endef
1037 object-suffixes-left := $(filter-out $(install-lib-ldscripts),$(versioned))
1038 ifneq (,$(object-suffixes-left))
1039 include $(o-iterator)
1040 endif
1042 # Make symlinks in the build directory, because the versioned names might
1043 # be referenced by a DT_NEEDED in another library.
1044 define o-iterator-doit
1045 $(objpfx)$o$($o-version): $(objpfx)$o; $$(make-link)
1046 endef
1047 object-suffixes-left := $(versioned)
1048 include $(o-iterator)
1050 generated += $(foreach o,$(versioned),$o$($o-version))
1052 define o-iterator-doit
1053 $(inst_slibdir)/$o$($o-version): $(objpfx)$o $(+force);
1054         $$(do-install-program)
1055 endef
1056 object-suffixes-left := $(versioned)
1057 include $(o-iterator)
1058 endif # ifneq (,$(versioned))
1060 define do-install-so
1061 $(do-install-program)
1062 $(patsubst %,$(LN_S) -f $(@F) \
1063                         $(@D)/$(patsubst %$*.so,%,$(<F))$(libprefix)$*.so,\
1064            $(filter-out %.so,$@))
1065 endef
1067 so-versions := $(sort $(foreach so,$(install-lib.so),.so$($(so)-version)))
1068 $(foreach v,$(so-versions),\
1069           $(inst_slibdir)/lib$(libprefix)%$v): $(common-objpfx)lib%.so \
1070                                                $(+force)
1071         $(do-install-so)
1072 $(foreach v,$(so-versions),\
1073           $(inst_slibdir)/$(libprefix)%$v): $(common-objpfx)%.so $(+force)
1074         $(do-install-so)
1075 endif
1077 ifdef install-bin
1078 $(addprefix $(inst_bindir)/,$(install-bin)): \
1079     $(inst_bindir)/%: $(objpfx)% $(+force)
1080         $(do-install-program)
1081 endif
1082 ifdef install-bin-script
1083 $(addprefix $(inst_bindir)/,$(install-bin-script)): \
1084     $(inst_bindir)/%: $(objpfx)% $(+force)
1085         $(do-install-script)
1086 endif
1087 ifdef install-rootsbin
1088 $(addprefix $(inst_rootsbindir)/,$(install-rootsbin)): \
1089    $(inst_rootsbindir)/%: $(objpfx)% $(+force)
1090         $(do-install-program)
1091 endif
1092 ifdef install-sbin
1093 $(addprefix $(inst_sbindir)/,$(install-sbin)): \
1094     $(inst_sbindir)/%: $(objpfx)% $(+force)
1095         $(do-install-program)
1096 endif
1097 ifdef install-lib
1098 install-lib.a := $(filter lib%.a,$(install-lib))
1099 install-lib.a := $(filter-out $(install-lib-ldscripts),$(install-lib.a))
1100 install-lib-non.a := $(filter-out lib%.a,$(install-lib))
1101 ifdef install-lib-non.a
1102 $(addprefix $(inst_libdir)/$(libprefix),$(install-lib-non.a)): \
1103   $(inst_libdir)/$(libprefix)%: $(objpfx)% $(+force)
1104         $(do-install)
1105 endif
1106 ifdef install-lib.a
1107 $(install-lib.a:lib%.a=$(inst_libdir)/lib$(libprefix)%.a): \
1108   $(inst_libdir)/lib$(libprefix)%.a: $(objpfx)lib%.a $(+force)
1109         $(do-install)
1110 endif
1111 endif
1112 ifdef install-data
1113 $(addprefix $(inst_datadir)/,$(install-data)): $(inst_datadir)/%: % $(+force)
1114         $(do-install)
1115 endif
1116 headers := $(strip $(headers))
1117 ifdef headers
1118 # This implicit rule installs headers from the source directory.
1119 # It may be ignored in preference to rules from sysd-rules to find
1120 # headers in the sysdeps tree.
1121 $(inst_includedir)/%.h: $(objpfx)%.h $(+force)
1122         $(do-install)
1123 $(inst_includedir)/%.h: $(common-objpfx)%.h $(+force)
1124         $(do-install)
1125 $(inst_includedir)/%.h: %.h $(+force)
1126         $(do-install)
1127 headers-nonh := $(filter-out %.h,$(headers))
1128 ifdef headers-nonh
1129 $(addprefix $(inst_includedir)/,$(headers-nonh)): $(inst_includedir)/%: \
1130                                                  % $(+force)
1131         $(do-install)
1132 endif   # headers-nonh
1133 endif   # headers
1135 .PHONY: install-bin-nosubdir install-bin-script-nosubdir \
1136         install-rootsbin-nosubdir install-sbin-nosubdir install-lib-nosubdir \
1137         install-data-nosubdir install-headers-nosubdir
1138 install-bin-nosubdir: $(addprefix $(inst_bindir)/,$(install-bin))
1139 install-bin-script-nosubdir: $(addprefix $(inst_bindir)/,$(install-bin-script))
1140 install-rootsbin-nosubdir: \
1141         $(addprefix $(inst_rootsbindir)/,$(install-rootsbin))
1142 install-sbin-nosubdir: $(addprefix $(inst_sbindir)/,$(install-sbin))
1143 install-lib-nosubdir: $(addprefix $(inst_libdir)/,\
1144                        $(patsubst lib%.a,lib$(libprefix)%.a,$(install-lib.a)) \
1145                        $(addprefix $(libprefix),$(install-lib-non.a)))
1146 install-data-nosubdir: $(addprefix $(inst_datadir)/,$(install-data))
1147 install-headers-nosubdir: $(addprefix $(inst_includedir)/,$(headers))
1148 install-others-nosubdir: $(install-others)
1149 install-others-programs-nosubdir: $(install-others-programs)
1151 # We need all the `-nosubdir' targets so that `install' in the parent
1152 # doesn't depend on several things which each iterate over the subdirs.
1153 # This rule makes `install-FOO' always use `install-FOO-nosubdir' as a
1154 # subroutine.  Then in the parent `install-FOO' also causes subdir makes.
1155 install-%:: install-%-nosubdir ;
1157 .PHONY: install install-no-libc.a-nosubdir
1158 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir \
1159                             install-lib-nosubdir install-others-nosubdir
1160 ifeq ($(build-programs),yes)
1161 install-no-libc.a-nosubdir: install-bin-nosubdir install-bin-script-nosubdir \
1162                             install-rootsbin-nosubdir install-sbin-nosubdir \
1163                             install-others-programs-nosubdir
1164 endif
1165 install: install-no-libc.a-nosubdir
1167 # Command to compile $< using the native libraries.
1168 define native-compile
1169 $(make-target-directory)
1170 $(BUILD_CC) $($(basename $(<F))-CFLAGS) $(ALL_BUILD_CFLAGS) \
1171             $< $(OUTPUT_OPTION) $(BUILD_LDFLAGS)
1172 endef
1174 # We always want to use configuration definitions.
1175 ALL_BUILD_CFLAGS = $(BUILD_CFLAGS) $(BUILD_CPPFLAGS) -D_GNU_SOURCE \
1176                    -DIS_IN_build -include $(common-objpfx)config.h
1178 # Support the GNU standard name for this target.
1179 .PHONY: check
1180 check: tests
1181 # Special target to run tests which cannot be run unconditionally.
1182 # Maintainers should use this target.
1183 .PHONY: xcheck
1184 xcheck: xtests
1186 # Handle tests-time64 and xtests-time64 that should built with LFS
1187 # and 64-bit time support.
1188 include $(o-iterator)
1189 define o-iterator-doit
1190 $(foreach f,$(tests-time64) $(xtests-time64),\
1191             $(objpfx)$(f)$(o)): CFLAGS += -D_TIME_BITS=64 -D_FILE_OFFSET_BITS=64
1192 endef
1193 object-suffixes-left := $(all-object-suffixes)
1194 include $(o-iterator)
1196 ifeq ($(have-time64-compat),yes)
1197 tests += $(foreach t,$(tests-time64),$(t))
1198 xtests += $(foreach t,$(xtests-time64),$(t))
1199 endif
1201 # The only difference between MODULE_NAME=testsuite and MODULE_NAME=nonlib is
1202 # that almost all internal declarations from config.h, libc-symbols.h, and
1203 # include/*.h are not available to 'testsuite' code, but are to 'nonlib' code.
1204 all-testsuite := $(strip $(tests) $(xtests) $(test-srcs) $(test-extras) \
1205                  $(tests-container))
1206 ifneq (,$(all-testsuite))
1207 cpp-srcs-left = $(all-testsuite)
1208 lib := testsuite
1209 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
1210 endif
1212 all-nonlib := $(strip $(others) $(others-extras))
1213 ifneq (,$(all-nonlib))
1214 cpp-srcs-left = $(all-nonlib)
1215 lib := nonlib
1216 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
1217 endif
1219 # All internal tests use testsuite-internal module since for 64 bit time
1220 # support is set as default for MODULE_NAME=nonlib (which include some
1221 # installed programs).
1222 all-testsuite-internal := $(strip $(tests-internal) $(test-internal-extras))
1223 ifneq (,$(all-testsuite-internal))
1224 cpp-srcs-left = $(all-testsuite-internal)
1225 lib := testsuite-internal
1226 include $(patsubst %,$(..)libof-iterator.mk,$(cpp-srcs-left))
1227 endif
1229 ifeq ($(build-shared),yes)
1230 # Generate normalized lists of symbols, versions, and data sizes.
1231 # This is handy for checking against existing library binaries.
1233 %.symlist: $(..)scripts/abilist.awk %.dynsym
1234         LC_ALL=C $(AWK) -f $^ > $@T
1235         mv -f $@T $@
1237 %.dynsym: %.so
1238         LC_ALL=C $(OBJDUMP) --dynamic-syms $< > $@T
1239         mv -f $@T $@
1241 vpath %.abilist $(+sysdep_dirs)
1243 # The .PRECIOUS rule prevents the files built by an implicit rule whose
1244 # target pattern is %.symlist from being considered "intermediate files"
1245 # and automatically removed.  We only want these files to be removed by
1246 # 'make clean', which is handled by the 'generated' variable.
1247 .PRECIOUS: %.symlist
1248 generated += $(extra-libs:=.symlist)
1250 $(objpfx)check-abi-%.out: $(common-objpfx)config.make %.abilist \
1251                           $(objpfx)%.symlist
1252         $(check-abi); \
1253         $(evaluate-test)
1254 $(objpfx)check-abi-%.out: $(common-objpfx)config.make %.abilist \
1255                           $(common-objpfx)%.symlist
1256         $(check-abi); \
1257         $(evaluate-test)
1258 define check-abi
1259         diff -p -U 0 $(filter %.abilist,$^) $(filter %.symlist,$^) > $@
1260 endef
1262 update-abi-%: $(objpfx)%.symlist %.abilist
1263         $(update-abi)
1264 update-abi-%: $(common-objpfx)%.symlist %.abilist
1265         $(update-abi)
1266 define update-abi
1267 @if cmp -s $^ 2> /dev/null; \
1268  then \
1269       echo '+++ $(filter %.abilist,$^) is unchanged'; \
1270  else cp -f $^; \
1271       echo '*** Now check $(filter %.abilist,$^) changes for correctness ***'; \
1272  fi
1273 endef
1275 # Patch all .abilist files for one DSO.  The find command locates abilist
1276 # files for all architectures.  The abilist files in /generic/ are
1277 # filtered out because these are expected to remain empty.
1278 define update-all-abi
1279 $(SHELL) $(..)scripts/update-abilist.sh $^ \
1280   $$(find $(..)sysdeps -name '$*.abilist' \! -path '*/generic/*')
1281 endef
1282 update-all-abi-%: %.abilist $(objpfx)%.symlist
1283         $(update-all-abi)
1284 update-all-abi-%: %.abilist $(common-objpfx)%.symlist
1285         $(update-all-abi)
1287 .PHONY: update-abi update-all-abi check-abi
1288 update-abi: $(patsubst %.so,update-abi-%,$(install-lib.so-versioned))
1289 update-all-abi: $(patsubst %.so,update-all-abi-%,$(install-lib.so-versioned))
1290 check-abi-list = $(patsubst %.so,$(objpfx)check-abi-%.out, \
1291                                  $(install-lib.so-versioned))
1292 check-abi: $(check-abi-list)
1293 ifdef subdir
1294 subdir_check-abi: check-abi
1295 subdir_update-abi: update-abi
1296 subdir_update-all-abi: update-all-abi
1297 else
1298 check-abi: subdir_check-abi
1299         if grep -q '^FAIL:' $(objpfx)*/check-abi*.test-result; then \
1300                 cat $(objpfx)*/check-abi*.out && exit 1; fi
1301 update-abi: subdir_update-abi
1302 update-all-abi: subdir_update-all-abi
1303 endif
1305 ifeq ($(subdir),elf)
1306 check-abi: $(objpfx)check-abi-libc.out
1307 tests-special += $(objpfx)check-abi-libc.out
1308 update-abi: update-abi-libc
1309 update-all-abi: update-all-abi-libc
1310 common-generated += libc.symlist
1311 endif
1313 ifeq ($(build-shared),yes)
1314 ifdef subdir
1315 tests-special += $(check-abi-list)
1316 endif
1317 endif
1319 endif
1321 FORCE:
1323 .PHONY: echo-headers
1324 echo-headers:
1325         @echo $(headers)
1327 %.bz2: %; bzip2 -9vk $<
1328 %.gz: %; gzip -9vnc $< > $@.new && mv -f $@.new $@
1329 %.xz: %; xz -9evk $<
1331 # Common cleaning targets.
1333 .PHONY: common-mostlyclean common-clean mostlyclean clean do-tests-clean
1334 clean: common-clean
1335 mostlyclean: common-mostlyclean
1337 # Remove test artifacts from a given directory
1338 do-tests-clean:
1339         -find $(objpfx) -name '*.out' -delete
1340         -find $(objpfx) -name '*.test-result' -delete
1342 # Remove the object files.
1343 common-mostlyclean: do-tests-clean
1344         -rm -f $(addprefix $(objpfx),$(tests) $(tests-internal) $(xtests) \
1345                                      $(test-srcs) \
1346                                      $(others) $(sysdep-others) stubs \
1347                                      $(addsuffix .o,$(tests) \
1348                                                     $(tests-internal) \
1349                                                     $(xtests) \
1350                                                     $(test-srcs) \
1351                                                     $(others) \
1352                                                     $(sysdep-others)))
1353         -rm -f $(addprefix $(objpfx),$(extra-objs) $(extra-test-objs) \
1354                                      $(install-lib) $(install-lib.so) \
1355                                      $(install-lib.so:%.so=%_pic.a))
1356         -rm -f core
1357         -rm -f $(objpfx)rtld-*.os
1358         $(rmobjs)
1359 define rmobjs
1360 $(foreach o,$(object-suffixes-for-libc),
1361 -rm -f $(objpfx)stamp$o $(o-objects))
1362 endef
1364 # Also remove the dependencies and generated source files.
1365 common-clean: common-mostlyclean
1366         -rm -f $(addprefix $(objpfx),$(generated))
1367         -rm -f $(objpfx)*.d $(objpfx)*.dt
1368         -rm -fr $(addprefix $(objpfx),$(generated-dirs))
1369         -rm -f $(addprefix $(common-objpfx),$(common-generated))
1370         -rm -f $(gen-as-const-headers:%.sym=$(common-objpfx)%.h)
1372 # Produce a file `stubs' which contains `#define __stub_FUNCTION'
1373 # for each function which is a stub.
1375 ifdef objpfx
1376 .PHONY: stubs # The parent Makefile calls this target.
1377 stubs: $(objpfx)stubs
1378 endif
1379 objs-for-stubs := $(foreach o,$(object-suffixes-for-libc),$(o-objects)) \
1380                   $(addprefix $(objpfx),$(extra-objs))
1381 $(objpfx)stubs: $(objs-for-stubs)
1382 ifneq (,$(strip $(objs-for-stubs)))
1383         (cd $(objpfx).; $(OBJDUMP) -h $(patsubst $(objpfx)%,%,$^)) | \
1384         $(AWK) '/\.gnu\.glibc-stub\./ { \
1385                   sub(/\.gnu\.glibc-stub\./, "", $$2); \
1386                   stubs[$$2] = 1; } \
1387                 END { for (s in stubs) print "#define __stub_" s }' > $@T
1388         mv -f $@T $@
1389 else
1390         > $@
1391 endif
1393 ifneq (,$(strip $(gpl2lgpl)))
1394 ifneq (,$(wildcard $(..)gpl2lgpl.sed))
1395 # Snarf from the master source and frob the copying notice.
1396 $(gpl2lgpl): %: $(..)gpl2lgpl.sed /home/gd/gnu/lib/%
1397         sed -f $^ > $@-tmp
1398 # So I don't edit them by mistake.
1399         chmod a-w $@-tmp
1400         mv -f $@-tmp $@
1401 endif
1402 endif
1404 # Local Variables:
1405 # mode: makefile
1406 # End: