(distribute): Add README.libm.
[glibc.git] / Makefile
blob23c8f240db5de55f91f201496c6854ee025fe9dc
1 # Copyright (C) 1991, 92, 93, 94, 95, 96, 97, 98 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 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.
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.
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 not,
16 # write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
17 # Boston, MA 02111-1307, USA.
20 # Master Makefile for the GNU C library
22 ifneq (,)
23 This makefile requires GNU Make.
24 endif
27 # This is the default target; it makes everything except the tests.
28 .PHONY: all
29 all: lib others
31 define autoconf-it
32 @-rm -f $@.new
33 autoconf $(ACFLAGS) $< > $@.new
34 chmod a-w,a+x $@.new
35 mv -f $@.new $@
36 test ! -d CVS || cvs commit -m'Regenerated: autoconf $(ACFLAGS) $<' $@
37 endef
39 configure: configure.in aclocal.m4; $(autoconf-it)
40 %/configure: %/configure.in aclocal.m4; $(autoconf-it)
42 include Makeconfig
44 ifndef avoid-generated
45 -include $(objpfx)sysd-dirs
46 define \n
49 endef
50 sysdep-subdirs := $(subst $(\n), ,$(sysdep-subdirs))
51 endif
53 # These are the subdirectories containing the library source.
54 subdirs = csu assert ctype db locale intl catgets math setjmp signal stdlib \
55 stdio-common $(stdio) malloc string wcsmbs time dirent grp pwd \
56 posix io termios resource misc login socket sysvipc gmon gnulib \
57 wctype manual shadow md5-crypt nss $(sysdep-subdirs) po \
58 $(add-ons) elf
59 export subdirs := $(subdirs) # Benign, useless in GNU make before 3.63.
61 # The mach and hurd subdirectories have many generated header files which
62 # much of the rest of the library depends on, so it is best to build them
63 # first (and mach before hurd, at that). The before-compile additions in
64 # sysdeps/{mach,hurd}/Makefile should make it reliably work for these files
65 # not to exist when making in other directories, but it will be slower that
66 # way with more somewhat expensive `make' invocations.
67 subdirs := $(filter mach,$(subdirs)) $(filter hurd,$(subdirs)) \
68 $(filter-out mach hurd,$(subdirs))
70 # All initialization source files.
71 +subdir_inits := $(wildcard $(foreach dir,$(subdirs),$(dir)/init-$(dir).c))
72 # All subdirectories containing initialization source files.
73 +init_subdirs := $(patsubst %/,%,$(dir $(+subdir_inits)))
76 # These are the targets that are made by making them in each subdirectory.
77 +subdir_targets := subdir_lib objects objs others subdir_mostlyclean \
78 subdir_clean subdir_distclean subdir_realclean \
79 tests subdir_lint.out \
80 subdir_distinfo \
81 subdir_echo-headers subdir_echo-distinfo \
82 subdir_install \
83 $(addprefix install-, no-libc.a bin lib data headers others)
85 headers := errno.h sys/errno.h errnos.h limits.h values.h \
86 features.h gnu-versions.h libc-lock.h xopen_lim.h
87 aux = sysdep $(libc-init) version
88 before-compile += $(objpfx)version-info.h
90 echo-headers: subdir_echo-headers
92 # What to install.
93 install-others = $(inst_includedir)/gnu/stubs.h
94 install-bin = glibcbug
96 ifeq (yes,$(build-shared))
97 install-others += $(inst_includedir)/gnu/lib-names.h
98 endif
100 ifeq (yes,$(gnu-ld))
101 libc-init = set-init
102 else
103 libc-init = munch-init
104 $(objpfx)munch-init.c: munch.awk munch-tmpl.c $(+subdir_inits)
105 awk -f $< subdirs='$(+init_subdirs)' $(word 2,$^) > $@-t
106 mv -f $@-t $@
107 generated := $(generated) munch-init.c
108 endif
111 include Makerules
113 # Install from subdirectories too.
114 install: subdir_install
116 # Create linkfs for shared libraries using the `ldconfig' program is possible.
117 # Ignore the error if we cannot update /etc/ld.so.cache.
118 ifeq (no,$(cross-compiling))
119 ifeq (yes,$(build-shared))
120 install:
121 -test ! -x $(common-objpfx)elf/ldconfig || \
122 $(common-objpfx)elf/ldconfig -d $(inst_slibdir) $(inst_libdir)
123 endif
124 endif
126 # Build subdirectory lib objects.
127 lib-noranlib: subdir_lib
129 ifeq (yes,$(build-shared))
130 # Build the shared object from the PIC object library.
131 lib: $(common-objpfx)libc.so
132 endif
134 all-Subdirs-files = $(wildcard $(addsuffix /Subdirs, $(config-sysdirs)))
135 $(objpfx)sysd-dirs: $(+sysdir_pfx)config.make $(all-Subdirs-files)
136 (echo define sysdep-subdirs; \
137 sed 's/#.*$$//' $(all-Subdirs-files) /dev/null; \
138 echo endef) > $@-tmp
139 mv -f $@-tmp $@
141 all-Banner-files = $(wildcard $(addsuffix /Banner, $(subdirs)))
142 $(objpfx)version-info.h: $(+sysdir_pfx)config.make $(all-Banner-files)
143 (case $(config-os) in \
144 linux*) version=`(echo -e "#include <linux/version.h>\nUTS_RELEASE"\
145 | $(CC) -E -P - | \
146 sed -e 's/"\([^"]*\)".*/\1/p' -e d) 2>/dev/null`;\
147 if [ -z "$$version" ]; then \
148 if [ -r /proc/version ]; then \
149 version=`sed 's/.*version \([^ ]*\) .*/>>\1<</' \
150 < /proc/version`; \
151 else \
152 version=`uname -r`; \
153 fi; \
154 fi; \
155 echo -n "\"Compiled on a Linux $$version system "; \
156 echo "on `date +%Y/%m/%d`.\\n\"" ;; \
157 *) ;; \
158 esac; \
159 files="$(all-Banner-files)"; \
160 if test -n "$$files"; then \
161 echo "\"Available extensions:"; \
162 sed -e '/^#/d' -e 's/^[[:space:]]*/ /' $$files; \
163 echo "\""; \
164 fi) > $@T
165 mv -f $@T $@
166 generated += version-info.h
168 version.c-objects := $(addprefix $(objpfx)version,$(object-suffixes))
169 $(version.c-objects): $(objpfx)version-info.h
171 # Makerules creates a file `stub-$(subdir)' for each subdirectory, which
172 # contains `#define __stub_FUNCTION' for each function which is a stub.
173 # Here we paste all of these together into <gnu/stubs.h>.
175 subdir-stubs := $(foreach dir,$(subdirs),$(common-objpfx)stub-$(dir))
177 # Since stubs.h is never needed when building the library, we simplify the
178 # hairy installation process by producing it in place only as the last part
179 # of the top-level `make install'. It depends on subdir_install, which
180 # iterates over all the subdirs; subdir_install in each subdir depends on
181 # the subdir's stubs file. Having more direct dependencies would result in
182 # extra iterations over the list for subdirs and many recursive makes.
183 $(inst_includedir)/gnu/stubs.h: subdir_install
184 @rm -f $(objpfx)stubs.h
185 (echo '/* This file is automatically generated.';\
186 echo ' It defines a symbol `__stub_FUNCTION'\'' for each function';\
187 echo ' in the C library which is a stub, meaning it will fail';\
188 echo ' every time called, usually setting errno to ENOSYS. */';\
189 sort $(subdir-stubs)) > $(objpfx)stubs.h
190 if test -r $@ && cmp -s $(objpfx)stubs.h $@; \
191 then echo 'stubs.h unchanged'; \
192 else $(INSTALL_DATA) $(objpfx)stubs.h $@; fi
193 rm -f $(objpfx)stubs.h
195 ifeq (yes,$(build-shared))
197 $(inst_includedir)/gnu/lib-names.h: $(common-objpfx)gnu/lib-names.h
198 if test -r $@ && cmp -s $< $@; \
199 then echo 'gnu/lib-names.h unchanged'; \
200 else $(INSTALL_DATA) $< $@; fi
201 endif
203 # The `glibcbug' script contains the version number and it shall be rebuild
204 # whenever this changes or the `glibcbug.in' file.
205 $(objpfx)glibcbug: $(common-objpfx)config.status glibcbug.in
206 cd $(<D); CONFIG_FILES=$(@F) CONFIG_HEADERS= $(SHELL) $(<F)
208 # This makes the Info or DVI file of the documentation from the Texinfo source.
209 .PHONY: info dvi
210 info dvi:
211 $(MAKE) $(PARALLELMFLAGS) -C manual $@
213 # This makes all the subdirectory targets.
215 # For each target, make it depend on DIR/target for each subdirectory DIR.
216 $(+subdir_targets): %: $(addsuffix /%,$(subdirs))
218 # Compute a list of all those targets.
219 all-subdirs-targets := $(foreach dir,$(subdirs),\
220 $(addprefix $(dir)/,$(+subdir_targets)))
222 # The action for each of those is to cd into the directory and make the
223 # target there.
224 $(all-subdirs-targets):
225 $(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)
227 .PHONY: $(+subdir_targets) $(all-subdirs-targets)
229 # Targets to clean things up to various degrees.
231 .PHONY: clean realclean distclean distclean-1 parent-clean parent-mostlyclean
233 # Subroutines of all cleaning targets.
234 parent-mostlyclean: common-mostlyclean # common-mostlyclean is in Makerules.
235 -rm -f $(foreach o,$(object-suffixes),\
236 $(common-objpfx)$(patsubst %,$(libtype$o),c)) \
237 $(addprefix $(objpfx),$(install-lib))
238 parent-clean: parent-mostlyclean common-clean
239 -rm -f $(addprefix $(common-objpfx),$(common-generated))
240 -rm -f $(addprefix $(objpfx),sysd-Makefile sysd-dirs sysd-rules)
242 clean: parent-clean
243 # This is done this way rather than having `subdir_clean' be a
244 # dependency of this target so that libc.a will be removed before the
245 # subdirectories are dealt with and so they won't try to remove object
246 # files from it when it's going to be removed anyway.
247 @$(MAKE) subdir_clean no_deps=t
248 mostlyclean: parent-mostlyclean
249 @$(MAKE) subdir_mostlyclean no_deps=t
251 # The realclean target is just like distclean for the parent, but we want
252 # the subdirs to know the difference in case they care.
253 realclean distclean: parent-clean
254 # This is done this way rather than having `subdir_distclean' be a
255 # dependency of this target so that libc.a will be removed before the
256 # subdirectories are dealt with and so they won't try to remove object
257 # files from it when it's going to be removed anyway.
258 @$(MAKE) distclean-1 no_deps=t distclean-1=$@ avoid-generated=yes
260 # Subroutine of distclean and realclean.
261 distclean-1: subdir_$(distclean-1)
262 -rm -f $(config-generated)
263 -rm -f $(addprefix $(objpfx),config.status config.cache config.log)
264 -rm -f $(addprefix $(objpfx),config.make config-name.h config.h)
265 ifdef objdir
266 -rm -f $(objpfx)Makefile
267 endif
268 -rm -f $(sysdep-$(distclean-1))
270 .PHONY: echo_subdirs
271 echo_subdirs:;@echo '$(subdirs)'
273 .PHONY: echo-distinfo parent_echo-distinfo
274 echo-distinfo: parent_echo-distinfo subdir_echo-distinfo
275 parent_echo-distinfo:
276 @echo $(addprefix +header+,$(headers)) \
277 $(addprefix +nodist+,$(generated))
280 # Make the distribution tarfile.
282 distribute := README README.libm INSTALL FAQ NOTES NEWS PROJECTS BUGS \
283 COPYING.LIB COPYING ChangeLog ChangeLog.[0-9] \
284 Makefile Makeconfig Makerules Rules Make-dist MakeTAGS \
285 extra-lib.mk o-iterator.mk \
286 ansidecl.h mkinstalldirs move-if-change install-sh \
287 configure configure.in aclocal.m4 config.sub config.guess\
288 config.h.in config.make.in config-name.in Makefile.in \
289 autolock.sh rellns-sh munch-tmpl.c munch.awk interp.c \
290 sysdep.h set-hooks.h libc-symbols.h version.h shlib-versions \
291 rpm/Makefile rpm/template rpm/rpmrc nsswitch.h netgroup.h \
292 mcheck.h glibcbug.in
294 distribute := $(strip $(distribute))
295 generated := $(generated) stubs.h version-info.h
297 README: README.template version.h ; # Make-dist should update README.
299 define format-me
300 @rm -f $@
301 makeinfo --no-validate --no-warn --no-headers $< -o $@
302 -chmod a-w $@
303 endef
304 INSTALL: manual/maint.texi; $(format-me)
305 NOTES: manual/creature.texi; $(format-me)
306 manual/dir-add.texi manual/dir-add.info: FORCE
307 $(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)
308 FORCE:
310 rpm/%: subdir_distinfo
311 $(MAKE) $(PARALLELMFLAGS) -C $(@D) subdirs='$(subdirs)' $(@F)
313 # This is a special goal for people making binary distributions. Normally
314 # everybody uses the DES based crypt library but for the distribution we
315 # need the only-MD5 based one as well.
316 md5-crypt/libmd5crypt:
317 $(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)