nptl: Fix pthread_tryjoin comment.
[glibc.git] / Rules
blobe08a28d9f382f526b5c4fabfe891192e755c15b8
1 # Copyright (C) 1991-2019 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 # <http://www.gnu.org/licenses/>.
19 #       Rules for making a subdirectory in the GNU C library.
20 #       Each subdirectory Makefile defines some variables and includes this.
22 ifneq (,)
23 This makefile requires GNU Make.
24 endif
26 all: # Don't let the default goal come from Makeconfig.
28 include $(firstword $(..) ../)Makeconfig
30 ifndef  subdir
31 Each subdirectory makefile must define the `subdir' variable.
32 endif
33 # This ` unconfuses emacs.
34 # This is benign and useless in GNU make before 3.63.
35 export subdir := $(subdir)
37 # This is the default target; it makes the library and auxiliary programs.
38 .PHONY: all
39 all: objs lib others
41 ifeq ($(build-programs),yes)
42 others: $(addprefix $(objpfx),$(extra-objs) \
43                               $(install-lib) \
44                               $(install-bin) $(install-bin-script) \
45                               $(install-rootsbin) $(install-sbin))
46 else
47 others: $(addprefix $(objpfx),$(extra-objs) \
48                               $(install-lib))
49 endif
51 ifneq   "$(findstring env,$(origin headers))" ""
52 headers :=
53 endif
55 ifneq   "$(findstring env,$(origin generated))" ""
56 generated :=
57 endif
59 ifneq   "$(findstring env,$(origin common-generated))" ""
60 common-generated :=
61 endif
63 # See below.  This must be set before Makerules processes it.
64 before-compile += $(common-objpfx)bits/stdio_lim.h
66 include $(..)Makerules
68 .PHONY: subdir_lib
69 subdir_lib: lib-noranlib
71 # Some subdirs need to install a dummy library.
72 # They can use "$(objpfx)libfnord.a: $(dep-dummy-lib); $(make-dummy-lib)".
73 dep-dummy-lib = $(common-objpfx)dummy.o
74 define make-dummy-lib
75 $(AR) cr$(verbose) $@ $<
76 endef
78 $(common-objpfx)dummy.c:
79         rm -f $@
80         (echo 'extern void __dummy__ (void);'; \
81          echo 'void __dummy__ (void) { }') > $@
82 common-generated += dummy.o dummy.c
84 ifneq "$(headers)" ""
85 # Special test of all the installed headers in this directory.
86 tests-special += $(objpfx)check-installed-headers-c.out
87 libof-check-installed-headers-c := testsuite
88 $(objpfx)check-installed-headers-c.out: \
89     $(..)scripts/check-installed-headers.sh $(headers)
90         $(SHELL) $(..)scripts/check-installed-headers.sh c \
91           "$(CC) $(filter-out -std=%,$(CFLAGS)) -D_ISOMAC $(+includes)" \
92           $(headers) > $@; \
93         $(evaluate-test)
95 ifneq "$(CXX)" ""
96 tests-special += $(objpfx)check-installed-headers-cxx.out
97 libof-check-installed-headers-cxx := testsuite
98 $(objpfx)check-installed-headers-cxx.out: \
99     $(..)scripts/check-installed-headers.sh $(headers)
100         $(SHELL) $(..)scripts/check-installed-headers.sh c++ \
101           "$(CXX) $(filter-out -std=%,$(CXXFLAGS)) -D_ISOMAC $(+includes)" \
102           $(headers) > $@; \
103         $(evaluate-test)
104 endif # $(CXX)
106 tests-special += $(objpfx)check-wrapper-headers.out
107 $(objpfx)check-wrapper-headers.out: \
108   $(..)scripts/check-wrapper-headers.py $(headers)
109         $(PYTHON) $< --root=$(..) --subdir=$(subdir) $(headers) > $@; \
110           $(evaluate-test)
112 endif # $(headers)
114 # This makes all the auxiliary and test programs.
116 .PHONY: others tests bench bench-build
118 # Test programs for the pretty printers.
119 tests-printers-programs := $(addprefix $(objpfx),$(tests-printers))
121 # .out files with the output of running the pretty printer tests.
122 tests-printers-out := $(patsubst %,$(objpfx)%.out,$(tests-printers))
124 ifeq ($(build-programs),yes)
125 others: $(addprefix $(objpfx),$(others) $(sysdep-others) $(extra-objs))
126 else
127 others: $(addprefix $(objpfx),$(extra-objs))
128 endif
130 # Generate constant files for Python pretty printers if required.
131 others: $(py-const)
133 ifeq ($(run-built-tests),no)
134 tests: $(addprefix $(objpfx),$(filter-out $(tests-unsupported), \
135                                           $(tests) $(tests-internal) \
136                                           $(tests-container)) \
137                              $(test-srcs)) $(tests-special) \
138                              $(tests-printers-programs)
139 xtests: tests $(xtests-special)
140 else
141 tests: $(tests:%=$(objpfx)%.out) $(tests-internal:%=$(objpfx)%.out) \
142        $(tests-container:%=$(objpfx)%.out) \
143        $(tests-special) $(tests-printers-out)
144 xtests: tests $(xtests:%=$(objpfx)%.out) $(xtests-special)
145 endif
147 tests-special-notdir = $(patsubst $(objpfx)%, %, $(tests-special))
148 xtests-special-notdir = $(patsubst $(objpfx)%, %, $(xtests-special))
149 ifeq ($(run-built-tests),no)
150 tests-expected =
151 else
152 tests-expected = $(tests) $(tests-internal) $(tests-printers) \
153         $(tests-container)
154 endif
155 tests:
156         $(..)scripts/merge-test-results.sh -s $(objpfx) $(subdir) \
157           $(sort $(tests-expected) $(tests-special-notdir:.out=)) \
158           > $(objpfx)subdir-tests.sum
159 xtests:
160         $(..)scripts/merge-test-results.sh -s $(objpfx) $(subdir) \
161           $(sort $(xtests) $(xtests-special-notdir:.out=)) \
162           > $(objpfx)subdir-xtests.sum
164 ifeq ($(build-programs),yes)
165 binaries-all-notests = $(others) $(sysdep-others)
166 binaries-all-tests = $(tests) $(tests-internal) $(xtests) $(test-srcs) \
167                      $(tests-container)
168 binaries-all = $(binaries-all-notests) $(binaries-all-tests)
169 binaries-static-notests = $(others-static)
170 binaries-static-tests = $(tests-static) $(xtests-static)
171 binaries-static = $(binaries-static-notests) $(binaries-static-tests)
172 ifeq (yesyes,$(have-fpie)$(build-shared))
173 binaries-pie-tests = $(tests-pie) $(xtests-pie)
174 binaries-pie-notests = $(others-pie)
175 else
176 binaries-pie-tests =
177 binaries-pie-notests =
178 endif
179 else
180 binaries-all-notests =
181 binaries-all-tests = $(tests) $(tests-internal) $(xtests) $(test-srcs)
182 binaries-all = $(binaries-all-tests)
183 binaries-static-notests =
184 binaries-static-tests =
185 binaries-static =
186 binaries-pie-tests =
187 binaries-pie-notests =
188 endif
190 binaries-pie = $(binaries-pie-tests) $(binaries-pie-notests)
191 binaries-shared-tests = $(filter-out $(binaries-pie) $(binaries-static), \
192                                      $(binaries-all-tests))
193 binaries-shared-notests = $(filter-out $(binaries-pie) $(binaries-static), \
194                                        $(binaries-all-notests))
196 ifneq "$(strip $(binaries-shared-notests))" ""
197 $(addprefix $(objpfx),$(binaries-shared-notests)): %: %.o \
198   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
199   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
200         $(+link)
201 endif
203 ifneq "$(strip $(binaries-shared-tests))" ""
204 $(addprefix $(objpfx),$(binaries-shared-tests)): %: %.o \
205   $(link-extra-libs-tests) \
206   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
207   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
208         $(+link-tests)
209 endif
211 ifneq "$(strip $(binaries-pie-tests))" ""
212 $(addprefix $(objpfx),$(binaries-pie-tests)): %: %.o \
213   $(link-extra-libs-tests) \
214   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
215   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
216         $(+link-pie-tests)
217 endif
219 ifneq "$(strip $(binaries-pie-notests))" ""
220 $(addprefix $(objpfx),$(binaries-pie-notests)): %: %.o \
221   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
222   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
223         $(+link-pie)
224 endif
226 ifneq "$(strip $(binaries-static-notests))" ""
227 $(addprefix $(objpfx),$(binaries-static-notests)): %: %.o \
228   $(sort $(filter $(common-objpfx)lib%,$(link-libc-static))) \
229   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
230         $(+link-static)
231 endif
233 ifneq "$(strip $(binaries-static-tests))" ""
234 $(addprefix $(objpfx),$(binaries-static-tests)): %: %.o \
235   $(link-extra-libs-tests) \
236   $(sort $(filter $(common-objpfx)lib%,$(link-libc-static-tests))) \
237   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
238         $(+link-static-tests)
239 endif
241 ifneq "$(strip $(tests) $(tests-internal) $(xtests) $(test-srcs))" ""
242 # These are the implicit rules for making test outputs
243 # from the test programs and whatever input files are present.
245 define make-test-out
246 $(if $($*-ENV-only),$(test-wrapper-env-only) $($*-ENV-only),\
247      $(test-wrapper-env) $(run-program-env) $($*-ENV)) \
248 $(host-test-program-cmd) $($*-ARGS)
249 endef
250 $(objpfx)%.out: %.input $(objpfx)%
251         $(make-test-out) > $@ < $(word 1,$^); \
252         $(evaluate-test)
253 $(objpfx)%.out: /dev/null $(objpfx)%    # Make it 2nd arg for canned sequence.
254         $(make-test-out) > $@; \
255         $(evaluate-test)
258 # Any tests that require an isolated container (filesystem, network
259 # and pid namespaces) in which to run, should be added to
260 # tests-container.
261 $(tests-container:%=$(objpfx)%.out): $(objpfx)%.out : $(if $(wildcard $(objpfx)%.files),$(objpfx)%.files,/dev/null) $(objpfx)%
262         $(test-wrapper-env) $(run-program-env) $(run-via-rtld-prefix) \
263           $(common-objpfx)support/test-container env $(run-program-env) $($*-ENV) \
264           $(host-test-program-cmd) $($*-ARGS) > $@; \
265         $(evaluate-test)
268 # tests-unsupported lists tests that we will not try to build at all in
269 # this configuration.  Note this runs every time because it does not
270 # actually create its target.  The dependency on Makefile is meant to
271 # ensure that it runs after a Makefile change to add a test to the list
272 # when it previously ran and produced a .out file (probably for a failure).
273 ifneq "$(strip $(tests-unsupported))" ""
274 $(tests-unsupported:%=$(objpfx)%.out): $(objpfx)%.out: Makefile
275         @rm -f $@
276         $(..)scripts/evaluate-test.sh $(patsubst $(common-objpfx)%.out,%,$@) \
277                                       77 false false > $(@:.out=.test-result)
278 endif
280 endif   # tests
282 ifneq "$(strip $(tests-printers))" ""
284 # Static pattern rule for building the test programs for the pretty printers.
285 $(tests-printers-programs): %: %.o $(tests-printers-libs) \
286   $(sort $(filter $(common-objpfx)lib%,$(link-libc-static-tests))) \
287   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
288         $(+link-printers-tests)
290 # Add the paths to the generated constants file and test_common_printers.py
291 # to PYTHONPATH so the test scripts can find them.
292 py-env := PYTHONPATH=$(py-const-dir):$(..)scripts:$${PYTHONPATH}
294 # Static pattern rule that matches the test-* targets to their .c and .py
295 # prerequisites.  It'll run the corresponding test script for each test program
296 # we compiled and place its output in the corresponding .out file.
297 # The pretty printer files and test_common_printers.py must be present for all.
298 $(tests-printers-out): $(objpfx)%.out: $(objpfx)% %.py %.c $(pretty-printers) \
299                        $(..)scripts/test_printers_common.py
300         $(test-wrapper-env) $(py-env) \
301             $(PYTHON) $*.py $*.c $(objpfx)$* $(pretty-printers) > $@; \
302         $(evaluate-test)
303 endif
306 .PHONY: distclean realclean subdir_distclean subdir_realclean \
307         subdir_clean subdir_mostlyclean subdir_testclean
308 subdir_mostlyclean: mostlyclean
309 subdir_clean: clean
310 subdir_distclean: distclean
311 subdir_realclean: realclean
312 subdir_testclean: do-tests-clean
313 realclean: distclean
314 distclean: clean
316 # We want to install everything except the library itself, but update all
317 # our portions of the library because the parent make will install it later
318 # (likewise the stubs file).
319 .PHONY: subdir_install
320 subdir_install: install-no-libc.a lib-noranlib stubs
322 .PHONY: subdir_objs subdir_stubs
323 subdir_objs: objs
324 subdir_stubs: stubs
326 # Target required by the Hurd to ensure that all the MiG-generated
327 # headers are in place before building a subdirectory.
328 .PHONY: before-compile
329 before-compile: $(before-compile)
331 $(common-objpfx)dummy.o: $(common-objpfx)dummy.c $(before-compile);
332         $(compile-command.c)
334 # Local Variables:
335 # mode: makefile
336 # End: