Add comments for the generic lowlevellock implementation.
[glibc.git] / Rules
blob82d8e974e573a5d3002dc6fc18763b79edb39839
1 # Copyright (C) 1991-2014 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 # This makes all the auxiliary and test programs.
86 .PHONY: others tests bench
88 ifeq ($(build-programs),yes)
89 others: $(addprefix $(objpfx),$(others) $(sysdep-others) $(extra-objs))
90 else
91 others: $(addprefix $(objpfx),$(extra-objs))
92 endif
93 ifeq ($(run-built-tests),no)
94 tests: $(addprefix $(objpfx),$(tests) $(test-srcs)) $(tests-special)
95 xtests: tests $(xtests-special)
96 else
97 tests: $(tests:%=$(objpfx)%.out) $(tests-special)
98 xtests: tests $(xtests:%=$(objpfx)%.out) $(xtests-special)
99 endif
101 tests-special-notdir = $(patsubst $(objpfx)%, %, $(tests-special))
102 xtests-special-notdir = $(patsubst $(objpfx)%, %, $(xtests-special))
103 tests:
104         $(..)scripts/merge-test-results.sh -s $(objpfx) $(subdir) \
105           $(sort $(tests) $(tests-special-notdir:.out=)) \
106           > $(objpfx)subdir-tests.sum
107 xtests:
108         $(..)scripts/merge-test-results.sh -s $(objpfx) $(subdir) \
109           $(sort $(xtests) $(xtests-special-notdir:.out=)) \
110           > $(objpfx)subdir-xtests.sum
112 ifeq ($(build-programs),yes)
113 binaries-all-notests = $(others) $(sysdep-others)
114 binaries-all-tests = $(tests) $(xtests) $(test-srcs)
115 binaries-all = $(binaries-all-notests) $(binaries-all-tests)
116 binaries-static-notests = $(others-static)
117 binaries-static-tests = $(tests-static) $(xtests-static)
118 binaries-static = $(binaries-static-notests) $(binaries-static-tests)
119 ifeq (yesyes,$(have-fpie)$(build-shared))
120 binaries-pie-tests = $(tests-pie) $(xtests-pie)
121 binaries-pie-notests = $(others-pie)
122 else
123 binaries-pie-tests =
124 binaries-pie-notests =
125 endif
126 else
127 binaries-all-notests =
128 binaries-all-tests = $(tests) $(xtests) $(test-srcs)
129 binaries-all = $(binaries-all-tests)
130 binaries-static-notests =
131 binaries-static-tests =
132 binaries-static =
133 binaries-pie-tests =
134 binaries-pie-notests =
135 endif
137 binaries-pie = $(binaries-pie-tests) $(binaries-pie-notests)
138 binaries-shared-tests = $(filter-out $(binaries-pie) $(binaries-static), \
139                                      $(binaries-all-tests))
140 binaries-shared-notests = $(filter-out $(binaries-pie) $(binaries-static), \
141                                        $(binaries-all-notests))
143 ifneq "$(strip $(binaries-shared-notests))" ""
144 $(addprefix $(objpfx),$(binaries-shared-notests)): %: %.o \
145   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
146   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
147         $(+link)
148 endif
150 ifneq "$(strip $(binaries-shared-tests))" ""
151 $(addprefix $(objpfx),$(binaries-shared-tests)): %: %.o \
152   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
153   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
154         $(+link-tests)
155 endif
157 ifneq "$(strip $(binaries-pie-tests))" ""
158 $(addprefix $(objpfx),$(binaries-pie-tests)): %: %.o \
159   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
160   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
161         $(+link-pie-tests)
162 endif
164 ifneq "$(strip $(binaries-pie-notests))" ""
165 $(addprefix $(objpfx),$(binaries-pie-notests)): %: %.o \
166   $(sort $(filter $(common-objpfx)lib%,$(link-libc))) \
167   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
168         $(+link-pie)
169 endif
171 ifneq "$(strip $(binaries-static-notests))" ""
172 $(addprefix $(objpfx),$(binaries-static-notests)): %: %.o \
173   $(sort $(filter $(common-objpfx)lib%,$(link-libc-static))) \
174   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
175         $(+link-static)
176 endif
178 ifneq "$(strip $(binaries-static-tests))" ""
179 $(addprefix $(objpfx),$(binaries-static-tests)): %: %.o \
180   $(sort $(filter $(common-objpfx)lib%,$(link-libc-static-tests))) \
181   $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+postinit)
182         $(+link-static-tests)
183 endif
185 ifneq "$(strip $(tests) $(xtests) $(test-srcs))" ""
186 # These are the implicit rules for making test outputs
187 # from the test programs and whatever input files are present.
189 make-test-out = $(test-wrapper-env) \
190                 $(run-program-env) \
191                 $($*-ENV) $(host-test-program-cmd) $($*-ARGS)
192 $(objpfx)%.out: %.input $(objpfx)%
193         $(make-test-out) > $@ < $(word 1,$^); \
194         $(evaluate-test)
195 $(objpfx)%.out: /dev/null $(objpfx)%    # Make it 2nd arg for canned sequence.
196         $(make-test-out) > $@; \
197         $(evaluate-test)
199 endif   # tests
202 .PHONY: distclean realclean subdir_distclean subdir_realclean \
203         subdir_clean subdir_mostlyclean subdir_testclean
204 subdir_mostlyclean: mostlyclean
205 subdir_clean: clean
206 subdir_distclean: distclean
207 subdir_realclean: realclean
208 subdir_testclean: do-tests-clean
209 realclean: distclean
210 distclean: clean
212 # We want to install everything except the library itself, but update all
213 # our portions of the library because the parent make will install it later
214 # (likewise the stubs file).
215 .PHONY: subdir_install
216 subdir_install: install-no-libc.a lib-noranlib stubs
218 .PHONY: subdir_objs subdir_stubs
219 subdir_objs: objs
220 subdir_stubs: stubs
222 # Target required by the Hurd to ensure that all the MiG-generated
223 # headers are in place before building a subdirectory.
224 .PHONY: before-compile
225 before-compile: $(before-compile)
227 $(common-objpfx)dummy.o: $(common-objpfx)dummy.c $(before-compile);
228         $(compile-command.c)
230 # Local Variables:
231 # mode: makefile
232 # End: