]> git.ipfire.org Git - thirdparty/glibc.git/blob - Makefile
Move FAQ to wiki
[thirdparty/glibc.git] / Makefile
1 # Copyright (C) 1991-2012 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 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.
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 # Lesser General Public License for more details.
13
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/>.
17
18 #
19 # Master Makefile for the GNU C library
20 #
21 ifneq (,)
22 This makefile requires GNU Make.
23 endif
24
25 include Makeconfig
26
27
28 # This is the default target; it makes everything except the tests.
29 .PHONY: all
30 all: lib others
31 \f
32 ifneq ($(AUTOCONF),no)
33
34 define autoconf-it
35 @-rm -f $@.new
36 $(AUTOCONF) $(ACFLAGS) $< > $@.new
37 chmod a-w$(patsubst %,$(comma)a+x,$(filter .,$(@D))) $@.new
38 mv -f $@.new $@
39 endef
40
41 configure: configure.in aclocal.m4; $(autoconf-it)
42 %/configure: %/configure.in aclocal.m4; $(autoconf-it)
43 %/preconfigure: %/preconfigure.in aclocal.m4; $(autoconf-it)
44
45 endif # $(AUTOCONF) = no
46
47
48 # We don't want to run anything here in parallel.
49 .NOTPARALLEL:
50
51 # These are the targets that are made by making them in each subdirectory.
52 +subdir_targets := subdir_lib objects objs others subdir_mostlyclean \
53 subdir_clean subdir_distclean subdir_realclean \
54 tests xtests subdir_lint.out \
55 subdir_update-abi subdir_check-abi \
56 subdir_echo-headers \
57 subdir_install \
58 subdir_objs subdir_stubs subdir_testclean \
59 $(addprefix install-, no-libc.a bin lib data headers others)
60 \f
61 headers := limits.h values.h features.h gnu-versions.h bits/libc-lock.h \
62 bits/xopen_lim.h gnu/libc-version.h stdc-predef.h
63
64 echo-headers: subdir_echo-headers
65
66 # The headers are in the include directory.
67 subdir-dirs = include
68 vpath %.h $(subdir-dirs)
69
70 # What to install.
71 install-others = $(inst_includedir)/gnu/stubs.h
72 install-bin-script =
73
74 ifeq (yes,$(build-shared))
75 headers += gnu/lib-names.h
76 endif
77
78 include Makerules
79
80 ifeq ($(build-programs),yes)
81 others: $(addprefix $(objpfx),$(install-bin-script))
82 endif
83
84 # Install from subdirectories too.
85 install: subdir_install
86
87 # Explicit dependency so that `make install-headers' works
88 install-headers: install-headers-nosubdir
89
90 # Make sure that the dynamic linker is installed before libc.
91 $(inst_slibdir)/libc-$(version).so: elf/ldso_install
92
93 .PHONY: elf/ldso_install
94 elf/ldso_install:
95 $(MAKE) -C $(@D) $(@F)
96
97 # Create links for shared libraries using the `ldconfig' program if possible.
98 # Ignore the error if we cannot update /etc/ld.so.cache.
99 ifeq (no,$(cross-compiling))
100 ifeq (yes,$(build-shared))
101 install: install-symbolic-link
102 .PHONY: install-symbolic-link
103 install-symbolic-link: subdir_install
104 $(symbolic-link-prog) $(symbolic-link-list)
105 rm -f $(symbolic-link-list)
106
107 install:
108 -test ! -x $(common-objpfx)elf/ldconfig || LC_ALL=C LANGUAGE=C \
109 $(common-objpfx)elf/ldconfig $(addprefix -r ,$(install_root)) \
110 $(slibdir) $(libdir)
111 ifneq (no,$(PERL))
112 ifeq (/usr,$(prefix))
113 ifeq (,$(install_root))
114 CC="$(CC)" $(PERL) scripts/test-installation.pl $(common-objpfx)
115 endif
116 endif
117 endif
118 endif
119 endif
120
121 # Build subdirectory lib objects.
122 lib-noranlib: subdir_lib
123
124 ifeq (yes,$(build-shared))
125 # Build the shared object from the PIC object library.
126 lib: $(common-objpfx)libc.so
127
128 lib: $(common-objpfx)linkobj/libc.so
129
130 $(common-objpfx)linkobj/libc.so: $(elfobjdir)/soinit.os \
131 $(common-objpfx)linkobj/libc_pic.a \
132 $(elfobjdir)/sofini.os \
133 $(elfobjdir)/interp.os \
134 $(elfobjdir)/ld.so \
135 $(shlib-lds)
136 $(build-shlib)
137
138 $(common-objpfx)linkobj/libc_pic.a: $(common-objpfx)libc_pic.a \
139 $(common-objpfx)sunrpc/librpc_compat_pic.a
140 $(..)./scripts/mkinstalldirs $(common-objpfx)linkobj
141 (cd $(common-objpfx)linkobj; \
142 $(AR) x ../libc_pic.a; \
143 rm $$($(AR) t ../sunrpc/librpc_compat_pic.a | sed 's/^compat-//'); \
144 $(AR) x ../sunrpc/librpc_compat_pic.a; \
145 $(AR) cr libc_pic.a *.os; \
146 rm *.os)
147 endif
148
149
150 # This is a handy script for running any dynamically linked program against
151 # the current libc build for testing.
152 $(common-objpfx)testrun.sh: $(common-objpfx)config.make \
153 $(..)Makeconfig $(..)Makefile
154 (echo '#!/bin/sh'; \
155 echo 'builddir=`dirname "$$0"`'; \
156 echo 'GCONV_PATH="$${builddir}/iconvdata" \'; \
157 echo 'exec $(subst $(common-objdir),"$${builddir}",\
158 $(run-program-prefix)) $${1+"$$@"}'; \
159 ) > $@T
160 chmod a+x $@T
161 mv -f $@T $@
162 postclean-generated += testrun.sh
163
164 others: $(common-objpfx)testrun.sh
165 \f
166 # Makerules creates a file `stubs' in each subdirectory, which
167 # contains `#define __stub_FUNCTION' for each function defined in that
168 # directory which is a stub.
169 # Here we paste all of these together into <gnu/stubs.h>.
170
171 subdir-stubs := $(foreach dir,$(subdirs),$(common-objpfx)$(dir)/stubs)
172
173 ifeq ($(biarch),no)
174 installed-stubs = $(inst_includedir)/gnu/stubs.h
175 else
176 installed-stubs = $(inst_includedir)/gnu/stubs-$(biarch).h
177
178 $(inst_includedir)/gnu/stubs.h: include/stubs-biarch.h $(+force)
179 $(make-target-directory)
180 $(INSTALL_DATA) $< $@
181
182 install-others-nosubdir: $(installed-stubs)
183 endif
184
185
186 # Since stubs.h is never needed when building the library, we simplify the
187 # hairy installation process by producing it in place only as the last part
188 # of the top-level `make install'. It depends on subdir_install, which
189 # iterates over all the subdirs; subdir_install in each subdir depends on
190 # the subdir's stubs file. Having more direct dependencies would result in
191 # extra iterations over the list for subdirs and many recursive makes.
192 $(installed-stubs): include/stubs-prologue.h subdir_install
193 $(make-target-directory)
194 @rm -f $(objpfx)stubs.h
195 (sed '/^@/d' $<; LC_ALL=C sort $(subdir-stubs)) > $(objpfx)stubs.h
196 if test -r $@ && cmp -s $(objpfx)stubs.h $@; \
197 then echo 'stubs.h unchanged'; \
198 else $(INSTALL_DATA) $(objpfx)stubs.h $@; fi
199 rm -f $(objpfx)stubs.h
200 \f
201 # This makes the Info or DVI file of the documentation from the Texinfo source.
202 .PHONY: info dvi pdf html
203 info dvi pdf html:
204 $(MAKE) $(PARALLELMFLAGS) -C manual $@
205 \f
206 # This makes all the subdirectory targets.
207
208 # For each target, make it depend on DIR/target for each subdirectory DIR.
209 $(+subdir_targets): %: $(addsuffix /%,$(subdirs))
210
211 # Compute a list of all those targets.
212 all-subdirs-targets := $(foreach dir,$(subdirs),\
213 $(addprefix $(dir)/,$(+subdir_targets)))
214
215 # The action for each of those is to cd into the directory and make the
216 # target there.
217 $(all-subdirs-targets):
218 $(MAKE) $(PARALLELMFLAGS) $(subdir-target-args) $(@F)
219
220 define subdir-target-args
221 subdir=$(@D)$(if $($(@D)-srcdir),\
222 -C $($(@D)-srcdir) ..=`pwd`/,\
223 -C $(@D) ..=../)
224 endef
225
226 .PHONY: $(+subdir_targets) $(all-subdirs-targets)
227 \f
228 # Targets to clean things up to various degrees.
229
230 .PHONY: clean realclean distclean distclean-1 parent-clean parent-mostlyclean \
231 tests-clean
232
233 # Subroutines of all cleaning targets.
234 parent-mostlyclean: common-mostlyclean # common-mostlyclean is in Makerules.
235 -rm -f $(foreach o,$(object-suffixes-for-libc),\
236 $(common-objpfx)$(patsubst %,$(libtype$o),c)) \
237 $(addprefix $(objpfx),$(install-lib))
238 parent-clean: parent-mostlyclean common-clean
239
240 postclean = $(addprefix $(common-objpfx),$(postclean-generated)) \
241 $(addprefix $(objpfx),sysd-dirs sysd-rules) \
242 $(addprefix $(objpfx),sysd-sorted soversions.mk soversions.i)
243
244 clean: parent-clean
245 # This is done this way rather than having `subdir_clean' be a
246 # dependency of this target so that libc.a will be removed before the
247 # subdirectories are dealt with and so they won't try to remove object
248 # files from it when it's going to be removed anyway.
249 @$(MAKE) subdir_clean no_deps=t
250 -rm -f $(postclean)
251 mostlyclean: parent-mostlyclean
252 @$(MAKE) subdir_mostlyclean no_deps=t
253 -rm -f $(postclean)
254
255 tests-clean:
256 @$(MAKE) subdir_testclean no_deps=t
257
258 tests: $(objpfx)c++-types-check.out $(objpfx)check-local-headers.out
259 ifneq ($(CXX),no)
260 check-data := $(firstword $(wildcard \
261 $(foreach D,$(add-ons) scripts,\
262 $(patsubst %,$D/data/c++-types-%.data,\
263 $(abi-name) \
264 $(addsuffix -$(config-os),\
265 $(config-machine) \
266 $(base-machine))))))
267 ifneq (,$(check-data))
268 $(objpfx)c++-types-check.out: $(check-data) scripts/check-c++-types.sh
269 scripts/check-c++-types.sh $< $(CXX) $(filter-out -std=gnu99 -Wstrict-prototypes,$(CFLAGS)) $(CPPFLAGS) > $@
270 else
271 $(objpfx)c++-types-check.out:
272 @echo 'WARNING C++ tests not run; create a c++-types-XXX file'
273 @echo "not run" > $@
274 endif
275 endif
276
277 $(objpfx)check-local-headers.out: scripts/check-local-headers.sh
278 AWK='$(AWK)' scripts/check-local-headers.sh \
279 "$(includedir)" "$(objpfx)" > $@
280
281 ifneq ($(PERL),no)
282 installed-headers = argp/argp.h assert/assert.h catgets/nl_types.h \
283 crypt/crypt.h ctype/ctype.h debug/execinfo.h \
284 dirent/dirent.h dlfcn/dlfcn.h elf/elf.h elf/link.h \
285 gmon/sys/gmon.h gmon/sys/gmon_out.h gmon/sys/profil.h \
286 grp/grp.h gshadow/gshadow.h iconv/iconv.h iconv/gconv.h \
287 $(wildcard inet/netinet/*.h) \
288 $(wildcard inet/arpa/*.h inet/protocols/*.h) \
289 inet/aliases.h inet/ifaddrs.h inet/netinet/ip6.h \
290 inet/netinet/icmp6.h intl/libintl.h io/sys/stat.h \
291 io/sys/statfs.h io/sys/vfs.h io/sys/statvfs.h \
292 io/fcntl.h io/sys/fcntl.h io/poll.h io/sys/poll.h \
293 io/utime.h io/ftw.h io/fts.h io/sys/sendfile.h \
294 libio/stdio.h libio/libio.h locale/locale.h \
295 locale/langinfo.h locale/xlocale.h login/utmp.h \
296 login/lastlog.h login/pty.h malloc/malloc.h \
297 malloc/obstack.h malloc/mcheck.h math/math.h \
298 math/complex.h math/fenv.h math/tgmath.h misc/sys/uio.h \
299 $(wildcard nis/rpcsvc/*.h) nptl_db/thread_db.h \
300 nptl/sysdeps/pthread/pthread.h nptl/semaphore.h \
301 nss/nss.h posix/sys/utsname.h posix/sys/times.h \
302 posix/sys/wait.h posix/sys/types.h posix/unistd.h \
303 posix/glob.h posix/regex.h posix/wordexp.h posix/fnmatch.h\
304 posix/getopt.h posix/tar.h posix/sys/unistd.h \
305 posix/sched.h posix/re_comp.h posix/wait.h \
306 posix/cpio.h posix/spawn.h pwd/pwd.h resolv/resolv.h \
307 resolv/netdb.h $(wildcard resolv/arpa/*.h) \
308 resource/sys/resource.h resource/sys/vlimit.h \
309 resource/sys/vtimes.h resource/ulimit.h rt/aio.h \
310 rt/mqueue.h setjmp/setjmp.h shadow/shadow.h \
311 signal/signal.h signal/sys/signal.h socket/sys/socket.h \
312 socket/sys/un.h stdio-common/printf.h \
313 stdio-common/stdio_ext.h stdlib/stdlib.h stdlib/alloca.h \
314 stdlib/monetary.h stdlib/fmtmsg.h stdlib/ucontext.h \
315 sysdeps/generic/inttypes.h sysdeps/generic/stdint.h \
316 stdlib/errno.h stdlib/sys/errno.h string/string.h \
317 string/strings.h string/memory.h string/endian.h \
318 string/argz.h string/envz.h string/byteswap.h \
319 $(wildcard sunrpc/rpc/*.h sunrpc/rpcsvc/*.h) \
320 sysvipc/sys/ipc.h sysvipc/sys/msg.h sysvipc/sys/sem.h \
321 sysvipc/sys/shm.h termios/termios.h \
322 termios/sys/termios.h termios/sys/ttychars.h time/time.h \
323 time/sys/time.h time/sys/timeb.h wcsmbs/wchar.h \
324 wctype/wctype.h
325
326 tests: $(objpfx)begin-end-check.out
327 $(objpfx)begin-end-check.out: scripts/begin-end-check.pl
328 $(PERL) scripts/begin-end-check.pl $(installed-headers) > $@
329 endif
330
331 # The realclean target is just like distclean for the parent, but we want
332 # the subdirs to know the difference in case they care.
333 realclean distclean: parent-clean
334 # This is done this way rather than having `subdir_distclean' be a
335 # dependency of this target so that libc.a will be removed before the
336 # subdirectories are dealt with and so they won't try to remove object
337 # files from it when it's going to be removed anyway.
338 @$(MAKE) distclean-1 no_deps=t distclean-1=$@ avoid-generated=yes \
339 sysdep-subdirs="$(sysdep-subdirs)"
340 -rm -f $(postclean)
341
342 # Subroutine of distclean and realclean.
343 distclean-1: subdir_$(distclean-1)
344 -rm -f $(config-generated)
345 -rm -f $(addprefix $(objpfx),config.status config.cache config.log)
346 -rm -f $(addprefix $(objpfx),config.make config-name.h config.h)
347 ifdef objdir
348 -rm -f $(objpfx)Makefile
349 endif
350 -rm -f $(sysdep-$(distclean-1))
351 \f
352 # Make the TAGS file for Emacs users.
353
354 .PHONY: TAGS
355 TAGS:
356 scripts/list-sources.sh | sed -n -e '/Makefile/p' \
357 $(foreach S,[chsSyl] cxx sh bash pl,\
358 $(subst .,\.,-e '/.$S\(.in\)*$$/p')) \
359 | $(ETAGS) -o $@ -
360 \f
361 # Make the distribution tarfile.
362 .PHONY: dist dist-prepare
363
364 generated := $(generated) stubs.h
365
366 files-for-dist := README INSTALL configure ChangeLog NEWS
367
368 # Regenerate stuff, then error if these things are not committed yet.
369 dist-prepare: $(files-for-dist)
370 conf=`find sysdeps $(addsuffix /sysdeps,$(sysdeps-add-ons)) \
371 -name configure`; \
372 $(MAKE) $$conf && \
373 git diff --stat HEAD -- $^ $$conf \
374 | $(AWK) '{ print; rc=1 } END { exit rc }'
375
376 %.tar: FORCE
377 git archive --prefix=$*/ $* > $@.new
378 mv -f $@.new $@
379
380 # Do `make dist dist-version=X.Y.Z' to make tar files of an older version.
381
382 ifneq (,$(strip $(dist-version)))
383 dist: $(foreach Z,.bz2 .gz .xz,$(dist-version).tar$Z)
384 md5sum $^
385 else
386 dist: dist-prepare
387 @if v=`git describe`; then \
388 echo Distribution version $$v; \
389 $(MAKE) dist dist-version=$$v; \
390 else \
391 false; \
392 fi
393 endif
394
395 define format-me
396 @rm -f $@
397 makeinfo --no-validate --plaintext --no-number-sections $< -o $@
398 -chmod a-w $@
399 endef
400 INSTALL: manual/install.texi manual/macros.texi; $(format-me)
401 manual/dir-add.texi manual/dir-add.info: FORCE
402 $(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)
403 FORCE:
404
405 iconvdata/% localedata/% po/% manual/%: FORCE
406 $(MAKE) $(PARALLELMFLAGS) -C $(@D) $(@F)
407
408 # glibc 2.0 contains some header files which aren't used with glibc 2.1
409 # anymore.
410 # These rules should remove those headers
411 ifeq (,$(install_root))
412 ifeq ($(old-glibc-headers),yes)
413 install: remove-old-headers
414 endif
415 endif
416
417 headers2_0 := __math.h bytesex.h confname.h direntry.h elfclass.h \
418 errnos.h fcntlbits.h huge_val.h ioctl-types.h \
419 ioctls.h iovec.h jmp_buf.h libc-lock.h local_lim.h \
420 mathcalls.h mpool.h nan.h ndbm.h posix1_lim.h \
421 posix2_lim.h posix_opt.h resourcebits.h schedbits.h \
422 selectbits.h semaphorebits.h sigaction.h sigcontext.h \
423 signum.h sigset.h sockaddrcom.h socketbits.h stab.def \
424 statbuf.h statfsbuf.h stdio-lock.h stdio_lim.h \
425 syscall-list.h termbits.h timebits.h ustatbits.h \
426 utmpbits.h utsnamelen.h waitflags.h waitstatus.h \
427 xopen_lim.h gnu/types.h sys/ipc_buf.h \
428 sys/kernel_termios.h sys/msq_buf.h sys/sem_buf.h \
429 sys/shm_buf.h sys/socketcall.h sigstack.h
430
431 .PHONY: remove-old-headers
432 remove-old-headers:
433 rm -f $(addprefix $(inst_includedir)/, $(headers2_0))