entered into RCS
[kopensolaris-gnu/glibc.git] / Makerules
1 # Copyright (C) 1991, 1992, 1993, 1994 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 Library General Public License as
6 # published by the Free Software Foundation; either version 2 of the
7 # 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 # Library General Public License for more details.
13
14 # You should have received a copy of the GNU Library General Public
15 # License along with the GNU C Library; see the file COPYING.LIB.  If
16 # not, write to the Free Software Foundation, Inc., 675 Mass Ave,
17 # Cambridge, MA 02139, USA.
18
19 #
20 #       Common rules for making the GNU C library.  This file is included
21 #       by the top-level Makefile and by all subdirectory makefiles
22 #       (through Rules).
23 #
24 ifneq (,)
25 This makefile requires GNU Make.
26 endif
27
28
29 ifdef   subdir
30 ..      := ../
31 endif   # subdir
32
33 # If `sources' was defined by the parent makefile, undefine it so
34 # we will later get it from wildcard search in this directory.
35 ifneq   "$(findstring env,$(origin sources))" ""
36 sources :=
37 endif
38
39 headers := $(headers) $(sysdep_headers)
40
41 # This is benign and useless in GNU make before version 3.63.
42 export sources := $(sources)
43 export headers := $(headers)
44
45 oPATH := $(PATH)
46 PATH := this definition should take precedence over $(oPATH)
47 ifeq ($(PATH),$(oPATH))
48 You must not use the -e flag when building the GNU C library.
49 else
50 PATH := $(oPATH)
51 endif
52 \f
53 ifndef +included-Makeconfig
54 include $(..)Makeconfig
55 endif
56
57 # `configure' writes a definition of `config-sysdirs' in `config.make'.
58 sysdirs = $(config-sysdirs)
59
60 +sysdir_pfx = $(common-objpfx)
61
62 sysdep_dir := $(..)sysdeps
63 export sysdirs := $(sysdirs)
64 export sysdep_dir := $(sysdep_dir)
65
66 +sysdep_dirs := $(addprefix $(sysdep_dir)/,$(sysdirs))
67 ifdef objdir
68 +sysdep_dirs := $(objdir) $(+sysdep_dirs)
69 endif
70
71 # Add -I switches to get the right sysdep directories.
72 # `+includes' in Makeconfig references $(+sysdep-includes).
73 +sysdep-includes := $(addprefix -I,$(+sysdep_dirs))
74 \f
75 # Include any system-specific makefiles.
76
77 # This is here so things in sysdep Makefiles can easily depend on foo.h as
78 # appropriate and not worry about where foo.h comes from, which may be
79 # system dependent and not known by that Makefile.
80 vpath %.h $(subst $(empty) ,:,$(strip $(common-objpfx) \
81                                       $(addprefix $(sysdep_dir)/,$(sysdirs)) \
82                                       $(..)))
83
84 ifeq ($(wildcard $(+sysdir_pfx)sysd-Makefile),)
85 # Don't do deps until this exists, because it might change the sources list.
86 no_deps=t
87 endif
88
89 # Some sysdep makefiles use this to distinguish being included here from
90 # being included individually by a subdir makefile (hurd/Makefile needs this).
91 in-Makerules := yes
92
93 include $(+sysdir_pfx)sysd-Makefile
94 $(+sysdir_pfx)sysd-Makefile: $(+sysdir_pfx)config.make $(..)Makerules
95         -@rm -f $@T
96         (for dir in $(sysdirs); do                                            \
97            file=sysdeps/$$dir/Makefile;                                       \
98            if [ -f $(..)$$file ]; then                                        \
99              echo include "\$$(..)$$file";                                    \
100            else true; fi;                                                     \
101          done) > $@T
102         mv $@T $@
103
104
105 # Reorder before-compile so that mach things come first, and hurd things
106 # second, before all else.  The mach and hurd subdirectories have many
107 # generated header files which the much of rest of the library depends on,
108 # so it is best to build them first (and mach before hurd, at that).
109 before-compile := $(filter $(common-objpfx)mach% $(common-objpfx)hurd%,\
110                            $(before-compile)) \
111                   $(filter-out $(common-objpfx)mach% $(common-objpfx)hurd%,\
112                                $(before-compile))
113
114 # Remove existing files from `before-compile'.  Things are added there when
115 # they must exist for dependency generation to work right, but once they
116 # exist there is no further need for every single file to depend on them,
117 # and those gratuitous dependencies result in many gratuitous
118 # recompilations.
119 before-compile := $(filter-out $(wildcard $(before-compile)),$(before-compile))
120
121 # Don't let any before-compile file be an intermediate and get removed.
122 ifdef before-compile
123 $(before-compile):
124 endif
125 \f
126 # Generate an ordered list of implicit rules which find the source files in
127 # each sysdep directory.  The old method was to use vpath to search all the
128 # sysdep directories.  However, that had the problem that a .S file in a
129 # later directory would be chosen over a .c file in an earlier directory,
130 # which does not preserve the desired sysdeps ordering behavior.
131
132 # When making the list of .dep files to include, we can't know which ones
133 # have source in .s files, and thus do not in fact need a .dep file.
134 # So we must define rules to make .dep files for .s files.
135 define make-dummy-dep
136 $(addprefix ln $(objpfx)dummy.dep ,$(filter-out $(wildcard $@),$@))
137 endef
138 $(objpfx)dummy.dep:
139         echo '# .s files cannot contain includes, so they need no deps.' > $@
140
141 # It matters that this set of rules, for compiling from sources in
142 # the current directory (the $srcdir/$subdir) come before the
143 # generated sysdep rules in included from sysd-rules below.  When
144 # compiling in the source tree, generated sources go into the current
145 # directory, and those should be chosen before any sources in sysdeps.
146 $(objpfx)%.o: %.S $(before-compile); $(compile-command.S)
147 $(objpfx)%.dep: %.S $(before-compile); $(+make-deps)
148 $(objpfx)%.o: %.s $(before-compile); $(compile-command.s)
149 $(objpfx)%.dep: %.s $(objpfx)dummy.dep; $(make-dummy-dep)
150 $(objpfx)%.o: %.c $(before-compile); $(compile-command.c)
151 $(objpfx)%.dep: %.c $(before-compile); $(+make-deps)
152
153 # Omit the objpfx rules when building in the source tree, because
154 # objpfx is empty and so these rules just override the ones above.
155 ifdef objpfx
156 # Define first rules to find the source files in $(objpfx).
157 # Generated source files will end up there.
158 $(objpfx)%.o: $(objpfx)%.S $(before-compile); $(compile-command.S)
159 $(objpfx)%.dep: $(objpfx)%.S $(before-compile); $(+make-deps)
160 $(objpfx)%.o: $(objpfx)%.s $(before-compile); $(compile-command.s)
161 $(objpfx)%.dep: $(objpfx)%.s $(objpfx)dummy.dep; $(make-dummy-dep)
162 $(objpfx)%.o: $(objpfx)%.c $(before-compile); $(compile-command.c)
163 $(objpfx)%.dep: $(objpfx)%.c $(before-compile); $(+make-deps)
164 endif
165
166 # System-dependent makefiles can put in `inhibit-sysdep-asm' wildcard
167 # patterns matching sysdep directories whose assembly source files should
168 # be suppressed.
169 ifdef inhibit-sysdep-asm
170 define open-check-inhibit-asm
171 case $$sysdir in $(subst $(empty) ,|,$(inhibit-sysdep-asm))) : ;; *)
172 endef
173 close-check-inhibit-asm = ;; esac
174 endif
175
176 include $(+sysdir_pfx)sysd-rules
177 $(+sysdir_pfx)sysd-rules: $(+sysdir_pfx)config.make $(..)Makerules \
178                           $(wildcard $(foreach dir,$(sysdirs),\
179                                                $(sysdep_dir)/$(dir)/Makefile))
180         -@rm -f $@T
181         (for sysdir in $(sysdirs); do                                         \
182            dir="\$$(sysdep_dir)/$$sysdir";                                    \
183            $(open-check-inhibit-asm) \
184            echo "\$$(objpfx)%.o: $$dir/%.S \$$(before-compile); \
185                 \$$(compile-command.S)";                                      \
186            echo "\$$(objpfx)%.dep: $$dir/%.S \$$(before-compile); \
187                 \$$(+make-deps)";                                             \
188            echo "\$$(objpfx)%.o: $$dir/%.s \$$(before-compile); \
189                 \$$(compile-command.s)";                                      \
190            echo "\$$(objpfx)%.dep: $$dir/%.s \$$(objpfx)dummy.dep; \
191                 \$$(make-dummy-dep)" $(close-check-inhibit-asm);        \
192            echo "\$$(objpfx)%.o: $$dir/%.c \$$(before-compile); \
193                 \$$(compile-command.c)";                                      \
194            echo "\$$(objpfx)%.dep: $$dir/%.c \$$(before-compile); \
195                 \$$(+make-deps)";                                             \
196          done) > $@T
197         mv $@T $@
198
199 ifndef compile-command.S
200 compile-command.S = $(compile.S) $(OUTPUT_OPTION)
201 endif
202 ifndef compile-command.s
203 compile-command.s = $(COMPILE.s) $< $(OUTPUT_OPTION)
204 endif
205 ifndef compile-command.c
206 compile-command.c = $(compile.c) $(OUTPUT_OPTION)
207 endif
208
209 ifeq ($(notdir $(firstword $(CC))),gcc)
210 # GCC can grok options after the file name, and it looks nicer that way.
211 compile.S = $(CC) $< -c $(CPPFLAGS) $(asm-CPPFLAGS)
212 compile.c = $(CC) $< -c $(CFLAGS) $(CPPFLAGS)
213 else
214 compile.S = $(COMPILE.S) $(asm-CPPFLAGS) $<
215 compile.c = $(COMPILE.c) $<
216 endif
217
218 ifndef OUTPUT_OPTION
219 ifdef objpfx
220 # We need this for the output to go in the right place.  It will default to
221 # empty if make was configured to work with a cc that can't grok -c and -o
222 # together.  You can't compile the C library with such a compiler.
223 OUTPUT_OPTION = -o $@
224 endif
225 endif
226
227 S-CPPFLAGS = $(asm-CPPFLAGS)
228 define +make-deps
229 -@rm -f $@
230 $(+mkdep) $< $(CPPFLAGS) $($(<:$*.%=%)-CPPFLAGS) | \
231 sed $(sed-remove-objpfx) -e 's,$*\.o,$(@:.dep=.o) $@,' > $(@:.dep=.dtm)
232 mv $(@:.dep=.dtm) $@
233 endef
234 ifneq (,$(objpfx))
235 sed-remove-objpfx = -e 's@ $(subst @,\@,$(objpfx))@ $$(objpfx)@g'
236 endif
237 \f
238 # Figure out the source filenames in this directory.
239
240 override sources        := $(addsuffix .c,$(routines) $(aux) \
241                                           $(sysdep_routines))
242 export sysdep_routines := $(sysdep_routines)
243
244 # This is the list of all object files, gotten by
245 # replacing every ".c" in `sources' with a ".o".
246 override objects        := $(addprefix $(objpfx),$(sources:.c=.o))
247 \f
248 +depfiles := $(strip $(sources:.c=.dep) $(addsuffix .dep,$(others) $(tests)))
249 +depfiles := $(addprefix $(objpfx),$(+depfiles))
250
251 $(objpfx)depend-$(subdir): Makefile
252 ifdef +depfiles
253 # This used to simply use $(+depfiles) on the command line, but that tended
254 # to overflow the arg limit on USG systems.  Since `sources' is in the
255 # environment anyway, we do some shell processing on it instead.
256         for file in $(patsubst %,%.dep,$(others) $(tests)) \
257                     `echo $${sources} | sed 's/\.c/.dep/g'`; do \
258           echo "include \$$(objpfx)$$file";     \
259         done > $@
260 else
261         cp /dev/null $@
262 endif
263
264 ifneq ($(no_deps),t)
265 # Include the generated dependencies of the sources in this directory.
266 include $(objpfx)depend-$(subdir)
267 endif
268 \f\f
269 # Maximize efficiency by minimizing the number of rules.
270 .SUFFIXES:      # Clear the suffix list.
271 # Add the suffixes we use.
272 .SUFFIXES: .a .o .S .s .c .h .dep
273
274 # Generic rule for making directories.
275 %/:
276 # mkdir isn't smart enough to strip a trailing /.
277         mkdir $(@:%/=%)
278 \f
279 # Make sure that object files are not removed
280 # when they are intermediates between sources and library members.
281 # This can go away with make v4.
282 .PRECIOUS: %.o
283
284 # Make sure that the parent library archive is never removed.
285 .PRECIOUS: $(libc.a)
286 \f
287 # Use the verbose option of ar and tar when not running silently.
288 ifeq    "$(findstring s,$(MAKEFLAGS))" ""       # if not -s
289 verbose := v
290 else                                            # -s
291 verbose :=
292 endif                                           # not -s
293
294 ARFLAGS := r$(verbose)
295 \f
296 # This makes all the object files in the parent library archive.
297
298 .PHONY: lib libobjs lib-noranlib
299 $(libc.a): lib-noranlib
300         $(RANLIB) $@
301 lib: $(libc.a)
302
303 +libobjs := $(patsubst %,$(libc.a)(%),$(notdir $(objects)))
304 ifdef +libobjs
305 $(+libobjs): $(libc.a)(%): $(objpfx)%;
306 endif
307 libobjs: $(+libobjs)
308 lib-noranlib: libobjs ar-it
309
310 #$(libc.a): %: $(addprefix %,$(patsubst $(objpfx)%,(%),$(objects)))
311 #       $(AR) $(ARFLAGS) $@ $(patsubst $@(%),%,$?)
312
313 define +libc_lock_open
314 @. $(..)libc-lock-open
315 endef
316 define +libc_lock_close
317 @rm -f $(..)LOCK-libc.a
318 endef
319
320 # Temporary until I get a better solution.
321 .PHONY: ar-it
322 ar-it: $(objects)
323 ifdef objects
324 #       $(+libc_lock_open)
325 ifdef objdir
326         cd $(objdir); $(AR) cru$(verbose) libc.a $(patsubst $(objpfx)%,%,$^)
327 else
328         $(AR) cru$(verbose) $(..)libc.a $^
329 endif
330 #       $(+libc_lock_close)
331 endif
332
333
334
335 # This makes all the object files.
336 .PHONY: objects objs
337 objects objs: $(objects)
338 \f
339 # Installation.
340
341 # install-lib are installed from the object directory into $(libdir).
342 # install-data are installed as they are into $(datadir).  headers are
343 # installed as they are in $(includedir).  install-others are absolute path
344 # names of files to install; rules to install them are defined elsewhere.
345
346 define do-install
347 $(make-target-directory)
348 $(INSTALL_DATA) $< $@
349 endef
350
351 # Make the target directory if it doesn't exist.  Because of make's
352 # directory cache, this will produce the `mkdir' command when the directory
353 # already exists, if it didn't exist at the start of the `make' run.  The
354 # `-' prefix ignores errors from mkdir, so there will just be some
355 # gratuitous but harmless `File exists' messages.
356 define make-target-directory
357 $(addprefix -mkdir ,$(filter-out $(wildcard $(@D:%/=%)),$(@D:%/=%)))
358 endef
359
360 # Don't attempt binaries for the Hurd version (yet).
361 ifdef mib_hacks
362 install :=
363 ifeq ($(subdir),time)
364 install-others :=
365 endif
366 endif
367
368
369
370 # Any directory (parent or subdir) that has any object files to build
371 # should install libc.a; this way "make install" in a subdir is guaranteed
372 # to install everything it changes.
373 ifdef objects
374 install: $(libdir)/lib$(libprefix)c.a
375 # We avoid depending on lib-noranlib because that makes the parent make
376 # subdir_lib in all the subdirs, when the make install run they do will
377 # update the library anyway.  Running ranlib after installing makes the
378 # __.SYMDEF time stamp up to date, which avoids messages from some linkers.
379 # Depending on subdir_install gets all the subdirs to update the library,
380 # and is optimal for `make install' at top level.
381 $(libdir)/lib$(libprefix)c.a: libobjs ar-it subdir_install
382         $(make-target-directory)
383         $(INSTALL_DATA) $(libc.a) $@
384         $(RANLIB) $@
385 endif
386
387 ifdef install
388 $(addprefix $(bindir)/,$(install)): $(bindir)/%: $(objpfx)%
389         $(make-target-directory)
390         $(INSTALL_PROGRAM) $< $@
391 endif
392 ifdef install-lib
393 install-lib.a := $(filter lib%.a,$(install-lib))
394 install-lib-non.a := $(filter-out lib%.a,$(install-lib))
395 ifdef install-lib-non.a
396 $(addprefix $(libdir)/$(libprefix),$(install-lib-non.a)): \
397   $(libdir)/$(libprefix)%: $(objpfx)%
398         $(do-install)
399 endif
400 ifdef install-lib.a
401 $(install-lib.a:lib%.a=$(libdir)/lib$(libprefix)%.a): \
402   $(libdir)/lib$(libprefix)%.a: $(objpfx)lib%.a
403         $(do-install)
404 endif
405 endif
406 ifdef install-data
407 $(addprefix $(datadir)/,$(install-data)): $(datadir)/%: %;$(do-install)
408 endif
409 headers := $(strip $(headers))
410 ifdef headers
411 $(addprefix $(includedir)/,$(headers)): \
412         $(includedir)/%: %;$(do-install)
413 endif   # headers
414
415 .PHONY: install-bin-nosubdir install-lib-nosubdir \
416         install-data-nosubdir install-headers-nosubdir
417 install-bin-nosubdir: $(addprefix $(bindir)/,$(install))
418 install-lib-nosubdir: $(addprefix $(libdir)/,$(install-lib))
419 install-data-nosubdir: $(addprefix $(datadir)/,$(install-data))
420 install-headers-nosubdir: $(addprefix $(includedir)/,$(headers))
421 install-others-nosubdir: $(install-others)
422
423 # We need all the `-nosubdir' targets so that `install' in the parent
424 # doesn't depend on several things which each iterate over the subdirs.
425 # This rule makes `install-FOO' always use `install-FOO-nosubdir' as a
426 # subroutine.  Then in the parent `install-FOO' also causes subdir makes.
427 install-%:: install-%-nosubdir ;
428
429 .PHONY: install install-no-libc.a-nosubdir
430 install-no-libc.a-nosubdir: install-headers-nosubdir install-data-nosubdir\
431                             install-bin-nosubdir install-lib-nosubdir   \
432                             install-others-nosubdir 
433 install: install-no-libc.a-nosubdir
434 \f
435 # Command to compile $< in $(objdir) using the native libraries.
436 native-compile = cwd=`pwd`; cd $(@D); $(CC) $(native-CFLAGS) \
437                                             $(addprefix $$cwd/,$^) -o $(@F)
438
439 # Command to compile $< in $(common-objdir) using the native libraries.
440 define common-objdir-compile
441 cd $(@D); $(CC) $(native-CFLAGS) $(<:$(common-objpfx)%=%) -o $(@F)
442 endef
443
444 # We always want to use configuration -D switches.
445 native-CFLAGS = $(config-defines)
446
447 # Support the GNU standard name for this target.
448 .PHONY: check
449 check: tests
450 \f
451 .PHONY: TAGS
452 TAGS: $(..)MakeTAGS
453         $(MAKE) -f $< $@
454
455 .PHONY: echo-headers
456 echo-headers:
457         @echo $(headers)
458
459 \f
460 # Common cleaning targets.
461
462 .PHONY: common-mostlyclean common-clean mostlyclean clean
463 clean: common-clean
464 mostlyclean: common-mostlyclean
465
466 # Remove the object files.
467 common-mostlyclean:
468         -rm -f $(addprefix $(objpfx),$(tests) $(others) \
469                                      $(addsuffix .o,$(tests) $(others)))
470         -rm -f $(objects) $(addprefix $(objpfx),$(extra-objs))
471         -rm -f core TAGS
472
473 # Also remove the dependencies and generated source files.
474 common-clean: common-mostlyclean
475         -rm -f $(objpfx)depend-$(subdir) $(+depfiles)
476         -rm -f $(generated)
477 \f
478 # Produce a file `stub-$(subdir)' which contains `#define __stub_FUNCTION'
479 # for each function which is a stub.  We grovel over all the .dep files
480 # looking for references to source files in sysdeps/stub.  Then we grovel
481 # over each referenced source file to see what stub function it defines.
482
483 .PHONY: stubs # The parent Makefile calls this target.
484 stubs: $(common-objpfx)stub-$(subdir)
485 $(common-objpfx)stub-$(subdir): $(+depfiles)
486 # Use /dev/null since `...` might expand to empty.
487         sed -n 's/^stub_warning *(\([^)]*\).*$$/#define __stub_\1/p' \
488             `sed -n 's@^.*\($(sysdep_dir)/stub/[a-z0-9_]*\.c\).*$$@\1@p' \
489                  $^ /dev/null` \
490             /dev/null > $@T
491         mv $@T $@
492 \f
493 ifneq (,$(strip $(gpl2lgpl)))
494 ifneq (,$(wildcard $(..)gpl2lgpl.sed))
495 # Snarf from the master source and frob the copying notice.
496 $(gpl2lgpl): %: $(..)gpl2lgpl.sed /home/gd/gnu/lib/%
497         sed -f $^ > $@-tmp
498 # So I don't edit them by mistake.
499         chmod a-w $@-tmp
500         mv -f $@-tmp $@
501 endif
502 endif