(distribute): Add README.libm.
[glibc.git] / Makeconfig
blobb361c4f093ed4264f3603b5ded65f4941029c939
1 # Copyright (C) 1991, 92, 93, 94, 95, 96, 97 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 #       Makefile configuration options for the GNU C library.
22 ifneq (,)
23 This makefile requires GNU Make.
24 endif
26 all: # Make this the default goal
28 ifneq "$(origin +included-Makeconfig)" "file"
30 +included-Makeconfig := yes
32 ifdef subdir
33 .. := ../
34 endif
36 # If config.make exists, the source directory was configured,
37 # so don't try to be clever and find another directory to build in.
38 ifneq (,$(wildcard $(..)config.make))
39 ARCH =
40 machine =
41 else    # Not configured.
42 ifndef ARCH
43 ifdef machine
44 ARCH = $(machine)
45 endif # machine
46 endif # ARCH
47 endif # config.make
49 # Directory for object files and libc.a.  If this is not defined, the
50 # object files live in the subdirectories where their sources live, and
51 # libc.a lives in the parent directory (this probably doesn't work any
52 # more).
53 ifdef ARCH
54 ifeq ($(filter /%,$(ARCH)),)
55 objdir := $(..)$(ARCH)
56 else
57 objdir = $(ARCH)
58 endif
59 endif
61 # $(common-objdir) is the place to put objects and
62 # such that are not specific to a single subdir.
63 ifdef objdir
64 objpfx := $(patsubst %//,%/,$(objdir)/$(subdir)/)
65 common-objpfx = $(objdir)/
66 common-objdir = $(objdir)
67 else
68 objpfx :=
69 ifdef ..
70 common-objpfx = $(..)
71 common-objdir = ..
72 else
73 # This is a kludge.  make wizards might grok.
74 common-objpfx = sysdeps/../
75 common-objdir = .
76 endif
77 endif
79 # Root of the sysdeps tree.
80 sysdep_dir := $(..)sysdeps
81 export sysdep_dir := $(sysdep_dir)
83 # Get the values defined by options to `configure'.
84 include $(common-objpfx)config.make
86 # Complete path to sysdep dirs.
87 full-config-sysdirs := $(filter /%, $(config-sysdirs)) \
88                        $(addprefix $(..), $(filter-out /%, $(config-sysdirs)))
89 export full-config-sysdirs := $(full-config-sysdirs)
91 # Run config.status to update config.make and config.h.  We don't show the
92 # dependence of config.h to Make, because it is only touched when it
93 # changes and so config.status would be run every time; the dependence of
94 # config.make should suffice to force regeneration and re-exec, and the new
95 # image will notice if config.h changed.
96 $(common-objpfx)config.make: $(common-objpfx)config.status \
97                              $(..)config.make.in $(..)config.h.in
98         cd $(<D); $(SHELL) $(<F)
100 # Find all the sysdeps configure fragments, to make sure we re-run
101 # configure when any of them changes.
102 $(common-objpfx)config.status: $(..)version.h $(..)configure \
103                                $(foreach dir,$(full-config-sysdirs),\
104                                          $(wildcard \
105                                            $(dir)/Implies) \
106                                          $(patsubst %.in,%,\
107                                                     $(firstword $(wildcard \
108  $(addprefix $(dir)/,configure configure.in)))))
109         @cd $(@D); if test -f $(@F); then exec $(SHELL) $(@F) --recheck; else \
110          echo The GNU C library has not been configured. >&2; \
111          echo Run \`configure\' to configure it before building. >&2; \
112          echo Try \`configure --help\' for more details. >&2; \
113          exit 1; fi
115 # Get the user's configuration parameters.
116 ifneq ($(wildcard $(..)configparms),)
117 include $(..)configparms
118 endif
119 ifneq ($(objpfx),)
120 ifneq ($(wildcard $(common-objpfx)configparms),)
121 include $(common-objpfx)configparms
122 endif
123 endif
125 ####
126 ####    These are the configuration variables.  You can define values for
127 ####    the variables below in the file `configparms'.
128 ####    Do NOT edit this file.
129 ####
132 # Set this to either `stdio' or `libio', to compile in either GNU stdio
133 # or GNU libio.
134 ifndef stdio
135 stdio = stdio
136 endif
138 # Common prefix for machine-independent installation directories.
139 ifeq ($(origin prefix),undefined) # ifndef would override explicit empty value.
140 prefix = /usr/local
141 endif
143 # Common prefix for machine-dependent installation directories.
144 ifeq ($(origin exec_prefix),undefined)
145 exec_prefix = $(prefix)
146 endif
148 # Where to install the library and object files.
149 ifndef libdir
150 libdir = $(exec_prefix)/lib
151 endif
152 inst_libdir = $(install_root)$(libdir)
154 # Where to install the shared library and dynamic linker.
155 ifndef slibdir
156 slibdir = $(exec_prefix)/lib
157 endif
158 inst_slibdir = $(install_root)$(slibdir)
160 # Prefix to put on files installed in $(libdir).  For libraries `libNAME.a',
161 # the prefix is spliced between `lib' and the name, so the linker switch
162 # `-l$(libprefix)NAME' finds the library; for other files the prefix is
163 # just prepended to the whole file name.
164 ifeq ($(origin libprefix),undefined)
165 libprefix =
166 endif
168 # Where to install the header files.
169 ifndef includedir
170 includedir = $(exec_prefix)/include
171 endif
172 inst_includedir = $(install_root)$(includedir)
174 # Where to install machine-independent data files.
175 # These are the timezone database, and the locale database.
176 ifndef datadir
177 datadir = $(prefix)/share
178 endif
179 inst_datadir = $(install_root)$(datadir)
181 # Where to install the timezone data files (which are machine-independent).
182 ifndef zonedir
183 zonedir = $(datadir)/zoneinfo
184 endif
185 inst_zonedir = $(install_root)$(zonedir)
187 # Where to install the locale and message catalog data files (which are
188 # machine-independent).
189 ifndef localedir
190 localedir = $(datadir)/locale
191 endif
192 inst_localedir = $(install_root)$(localedir)
194 # Where to install the locale charmap source files.
195 ifndef i18ndir
196 i18ndir = $(datadir)/i18n
197 endif
198 inst_i18ndir = $(install_root)$(i18ndir)
201 # Where to install programs.
202 ifndef bindir
203 bindir = $(exec_prefix)/bin
204 endif
205 inst_bindir = $(install_root)$(bindir)
207 # Where to install administrative programs.
208 ifndef rootsbindir
209 rootsbindir = $(exec_prefix)/sbin
210 endif
211 inst_rootsbindir = $(install_root)$(rootsbindir)
213 ifndef sbindir
214 sbindir = $(exec_prefix)/sbin
215 endif
216 inst_sbindir = $(install_root)$(sbindir)
218 # Where to install the Info files.
219 ifndef infodir
220 infodir = $(prefix)/info
221 endif
222 inst_infodir = $(install_root)$(infodir)
224 # Where to install default configuration files.  These include the local
225 # timezone specification and network data base files.
226 ifndef sysconfdir
227 sysconfdir = $(prefix)/etc
228 endif
229 inst_sysconfdir = $(install_root)$(sysconfdir)
231 # What timezone should be the installed default (e.g., US/Eastern).
232 # Run `make -C time echo-zonenames' to see a list of available zone names.
233 # The local timezone can be changed with `zic -l TIMEZONE' at any time.
234 ifndef localtime
235 localtime = Factory
236 endif
238 # Where to install the "localtime" timezone file; this is the file whose
239 # contents $(localtime) specifies.  If this is a relative pathname, it is
240 # relative to $(zonedir).  It is a good idea to put this somewhere
241 # other than there, so the zoneinfo directory contains only universal data,
242 # localizing the configuration data elsewhere.
243 ifndef localtime-file
244 localtime-file = $(sysconfdir)/localtime
245 inst_localtime-file = $(install_root)$(localtime-file)
246 endif
248 # What to use for leap second specifications in compiling the default
249 # timezone files.  Set this to `/dev/null' for no leap second handling as
250 # 1003.1 requires, or to `leapseconds' for proper leap second handling.
251 # Both zone flavors are always available as `posix/ZONE' and `right/ZONE'.
252 # This variable determines the default: if it's `/dev/null',
253 # ZONE==posix/ZONE; if it's `leapseconds', ZONE==right/ZONE.
254 ifndef leapseconds
255 leapseconds = /dev/null
256 endif
258 # What timezone's DST rules should be used when a POSIX-style TZ
259 # environment variable doesn't specify any rules.  For 1003.1 compliance
260 # this timezone must use rules that are as U.S. federal law defines DST.
261 # Run `make -C time echo-zonenames' to see a list of available zone names.
262 # This setting can be changed with `zic -p TIMEZONE' at any time.
263 # If you want POSIX.1 compatibility, use `America/New_York'.
264 ifndef posixrules
265 posixrules = America/New_York
266 endif
268 # Where to install the "posixrules" timezone file; this is file
269 # whose contents $(posixrules) specifies.  If this is a relative
270 # pathname, it is relative to $(zonedir).
271 ifndef posixrules-file
272 posixrules-file = posixrules
273 endif
276 # Directory where your system's native header files live.
277 # This is used on Unix systems to generate some GNU libc header files.
278 ifndef sysincludedir
279 sysincludedir = /usr/include
280 endif
283 # Commands to install files.
284 ifndef INSTALL_DATA
285 INSTALL_DATA = $(INSTALL) -m 644
286 endif
287 ifndef INSTALL_PROGRAM
288 INSTALL_PROGRAM = $(INSTALL)
289 endif
290 ifndef INSTALL
291 INSTALL = install
292 endif
295 # The name of the C compiler.
296 # If you've got GCC, and it works, use it.
297 ifeq ($(origin CC),default)
298 CC := gcc
299 endif
301 # The name of the C compiler to use for compilations of programs to run on
302 # the host that is building the library.  If you set CC to a
303 # cross-compiler, you must set this to the normal compiler.
304 ifndef BUILD_CC
305 BUILD_CC = $(CC)
306 endif
308 # Default flags to pass the C compiler.
309 ifndef default_cflags
310 default_cflags := -g -O
311 endif
313 # Flags to pass the C compiler when assembling preprocessed assembly code
314 # (`.S' files).  On some systems the assembler doesn't understand the `#' line
315 # directives the preprocessor produces.  If you have troubling compiling
316 # assembly code, try using -P here to suppress these directives.
317 ifndef asm-CPPFLAGS
318 asm-CPPFLAGS =
319 endif
321 # Command for linking programs with the C library.
322 ifndef +link
323 +link = $(CC) -nostdlib -nostartfiles -o $@ \
324               $(sysdep-LDFLAGS) $(config-LDFLAGS) $(LDFLAGS)  \
325               $(addprefix $(csu-objpfx),start.o) $(+preinit) $(+prector) \
326               $(filter-out $(addprefix $(csu-objpfx),start.o) $(+preinit) \
327                 $(link-extra-libs) $(common-objpfx)libc% $(+postinit),$^) \
328               $(link-extra-libs) $(link-libc) $(+postctor) $(+postinit)
329 endif
330 ifndef config-LDFLAGS
331 ifeq (yes,$(build-shared))
332 config-LDFLAGS = -Wl,-dynamic-linker=$(slibdir)/$(rtld-installed-name)
333 endif
334 endif
335 ifndef link-libc
336 ifeq (yes,$(build-shared))
337 # We need the versioned name of libc.so in the deps of $(others) et al
338 # so that the symlink to libc.so is created before anything tries to
339 # run the linked programs.
340 link-libc = -Wl,-rpath-link=$(rpath-link) \
341             $(common-objpfx)libc.so$(libc.so-version) \
342             $(elfobjdir)/$(rtld-installed-name) \
343             $(common-objpfx)libc.a $(gnulib)
344 # Choose the default search path for the dynamic linker based on
345 # where we will install libraries.
346 ifneq ($(libdir),$(slibdir))
347 default-rpath = $(slibdir):$(libdir)
348 else
349 default-rpath = $(libdir)
350 endif
351 # This is how to find at build-time things that will be installed there.
352 rpath-link = $(common-objdir):$(elfobjdir):$(nssobjdir)
353 elfobjdir := $(patsubst ../$(subdir),.,$(common-objpfx)elf)
354 nssobjdir := $(patsubst ../$(subdir),.,$(common-objpfx)nss)
355 else
356 link-libc = $(common-objpfx)libc.a $(gnulib) $(common-objpfx)libc.a
357 endif
358 endif
359 ifndef link-extra-libs
360 ifeq (yes,$(build-shared))
361 link-extra-libs = $(foreach lib,$(LDLIBS-$(@F)),$(common-objpfx)$(lib).so$($(notdir $(lib)).so-version))
362 else
363 link-extra-libs = $(foreach lib,$(LDLIBS-$(@F)),$(common-objpfx)$(lib).a)
364 endif
365 endif
366 ifndef gnulib
367 gnulib := -lgcc
368 endif
369 ifeq ($(elf),yes)
370 +preinit = $(addprefix $(csu-objpfx),crti.o)
371 +postinit = $(addprefix $(csu-objpfx),crtn.o)
372 +prector = `$(CC) --print-file-name=crtbegin.o`
373 +postctor = `$(CC) --print-file-name=crtend.o`
374 endif
375 csu-objpfx = $(common-objpfx)csu/
376 elf-objpfx = $(common-objpfx)elf/
377 db-objpfx = $(common-objpfx)db/
379 # How to run a program we just linked with our library.
380 # The program binary is assumed to be $(word 2,$^).
381 built-program-file = $(dir $(word 2,$^))$(notdir $(word 2,$^))
382 ifneq (yes,$(build-shared))
383 built-program-cmd = $(built-program-file)
384 else
385 comma = ,
386 sysdep-library-path = \
387 $(subst $(empty) ,:,$(strip $(patsubst -Wl$(comma)-rpath-link=%, %,\
388                                        $(filter -Wl$(comma)-rpath-link=%,\
389                                                 $(sysdep-LDFLAGS)))))
390 define built-program-cmd
391 LD_LIBRARY_PATH=$(rpath-link)$(patsubst %,:%,$(sysdep-library-path)) \
392 $(elf-objpfx)$(rtld-installed-name) $(built-program-file)
393 endef
394 endif
396 ifndef LD
397 LD := ld -X
398 endif
400 ifndef  RANLIB
401 RANLIB = ranlib
402 endif
404 # Extra flags to pass to GCC.
405 +gccwarn := -Wall -Wwrite-strings -Wno-parentheses -Winline -Wstrict-prototypes
407 # This is the program that generates makefile
408 # dependencies from C source files.
409 ifndef +mkdep
410 +mkdep = $(CC) -M
411 endif
413 # The program that makes Emacs-style TAGS files.
414 ETAGS   := etags -T
416 # The `m4' macro processor; this is used by sysdeps/sparc/Makefile (and
417 # perhaps others) to preprocess assembly code in some cases.
418 M4 = m4
420 ####
421 #### End of configuration variables.
422 ####
424 # This tells some versions of GNU make before 3.63 not to export all variables.
425 .NOEXPORT:
427 # We want to echo the commands we're running without
428 # umpteen zillion filenames along with it (we use `...' instead)
429 # but we don't want this echoing done when the user has said
430 # he doesn't want to see commands echoed by using -s.
431 ifneq   "$(findstring s,$(MAKEFLAGS))" ""       # if -s
432 +cmdecho        := echo >/dev/null
433 else                                            # not -s
434 +cmdecho        := echo
435 endif                                           # -s
437 # These are the flags given to the compiler to tell
438 # it what sort of optimization and/or debugging output to do.
439 ifndef  +cflags
440 # If `CFLAGS' was defined, use that.
441 ifdef           CFLAGS
442 +cflags := $(filter-out -I%,$(CFLAGS))
443 endif           # CFLAGS
444 endif   # +cflags
446 # If none of the above worked, default to "-g -O".
447 ifeq    "$(strip $(+cflags))" ""
448 +cflags := $(default_cflags)
449 endif   # $(+cflags) == ""
451 +cflags := $(+cflags) $(+gccwarn)
452 +gcc-nowarn := -w
454 # Don't duplicate options if we inherited variables from the parent.
455 +cflags := $(sort $(+cflags))
458 # These are flags given to the C compiler to tell it to look for include
459 # files (including ones given in angle brackets) in the current directory
460 # and in the parent library source directory.
461 # `+sysdep-includes' will be defined by Makerules.
462 +includes = -I. $(filter-out -I,-I$(patsubst %/,%,$(..))) $($(stdio)-include) \
463             $(includes) $(+sysdep-includes) $(last-includes)
465 # Since libio has several internal header files, we use a -I instead
466 # of many little headers in the top level source directory.
467 libio-include = -I$(..)libio
469 # These are the variables that the implicit compilation rules use.
470 CPPFLAGS = $(+includes) $(defines) -include $(..)libc-symbols.h \
471            $(sysdep-CPPFLAGS) $(CPPFLAGS-$(suffix $@)) $(CPPFLAGS-$(<F)) \
472            $(CPPFLAGS-$(@F))
473 override CFLAGS = $(+cflags) $(sysdep-CFLAGS) $(CFLAGS-$(suffix $@)) \
474                   $(CFLAGS-$(<F)) $(CFLAGS-$(@F))
477 # This is the macro that the implicit linking rules use.
478 ifneq "$(filter -g,$(+cflags))" "" # -g is in $(+cflags)
479 LDFLAGS := -g
480 endif
483 # Enable object files for different versions of the library.
484 # Various things use $(object-suffixes) to know what all to make.
485 # The compilation rules use $(CPPFLAGS-${SUFFIX}) and $(CFLAGS-${SUFFIX})
486 # to pass different flags for each flavor.
487 libtypes = $(foreach o,$(object-suffixes),$(libtype$o))
488 object-suffixes := .o
489 all-object-suffixes := .o .so .po .go
490 libtype.o := lib%.a
491 ifeq (yes,$(build-shared))
492 # Under --enable-shared, we will build a shared library of PIC objects.
493 # The PIC object files are named foo.so.
494 object-suffixes += .so
495 CPPFLAGS-.so = -DPIC
496 CFLAGS-.so = -fPIC -fno-common
497 libtype.so := lib%_pic.a
498 endif
499 ifeq (yes,$(build-profile))
500 # Under --enable-profile, we will build a static library of profiled objects.
501 # The profiled object files are named foo.po.
502 object-suffixes += .po
503 CPPFLAGS-.po = -DPROF
504 CFLAGS-.po = -pg
505 libtype.po = lib%_p.a
506 endif
507 ifeq (yes,$(build-omitfp))
508 # Under --enable-omitfp, we build an the library optimized without
509 # debugging information using -fomit-frame-pointer, and build an extra
510 # library with debugging information.  The debuggable objects are named foo.go.
511 object-suffixes += .go
512 CFLAGS-.go = -g
513 CFLAGS-.o = -g0 -O99 -fomit-frame-pointer
514 CFLAGS-.so += $(CFLAGS-.o)
515 libtype.go = lib%_g.a
516 endif
519 +gnu-stabs = $(shell echo>&2 '*** BARF ON ME')
521 ifndef BUILD_CC
522 BUILD_CC = $(CC)
523 endif
525 # Figure out the version numbers from version.h.
527 $(common-objpfx)version.mk: $(..)version.h $(..)Makeconfig
528         sed -n -e 's/^.*RELEASE.*"\([^"]*\)".*$$/release=\1/p' \
529                -e 's/^.*VERSION.*"\([^"]*\)".*$$/version=\1/p' \
530             < $< > $@-new
531         mv -f $@-new $@
533 ifeq (yes, $(build-shared))
535 # Process the shlib-versions file, which tells us what shared library
536 # version numbers to use when we install shared objects on this system.
537 -include $(common-objpfx)soversions.mk
538 $(common-objpfx)soversions.mk: $(..)shlib-versions $(..)Makeconfig \
539                                $(wildcard $(patsubst %, $(..)%/shlib-versions,\
540                                                         $(add-ons))) \
541                                $(common-objpfx)config.make
542         (file="$(wildcard $(patsubst %,$(..)%/shlib-versions,$(add-ons))) \
543                $(..)shlib-versions"; \
544          for f in $$file; do \
545            sed 's/#.*$$//' $$f | while read conf versions; do \
546              test -n "$$versions" && \
547              test `expr '$(config-machine)-$(config-vendor)-$(config-os)' \
548                         : "$$conf"` != 0 || continue; \
549              for v in $$versions; do \
550                lib=`echo $$v | sed 's/=.*$$//'`; \
551                if eval "test -z \"\$$vers_lib$$lib\""; then \
552                  eval vers_lib$${lib}=yes; \
553                  number=`echo $$v | sed "s/^.*=//"`; \
554                  case $$number in \
555                    [0-9]*) echo "$$lib.so-version=.$$number"; \
556                            echo "all-sonames+=$$lib.so\$$($$lib.so-version)";;\
557                    *) echo "$$lib.so-version=$$number"; \
558                       echo "all-sonames+=\$$($$lib.so-version)";;  \
559                  esac; \
560                fi; \
561              done; \
562            done; \
563          done;) > $@T; exit 0
564         mv -f $@T $@
566 # Get $(version) defined with the release version number.
567 -include $(common-objpfx)version.mk
569 # Generate the header containing the names of all shared libraries.
570 # We use a stamp file to avoid uncessary recompilations.
571 before-compile += $(common-objpfx)gnu/lib-names.h
572 $(common-objpfx)gnu/lib-names.h: $(common-objpfx)gnu/lib-names.stmp
573 $(common-objpfx)gnu/lib-names.stmp: $(common-objpfx)soversions.mk
574         $(make-target-directory)
575         @rm -f ${@:stmp=T} $@
576         (echo '/* This file is automatically generated.';\
577          echo '   It defines macros to allow user program to find the shared';\
578          echo '   library files which come as part of GNU libc.  */';\
579          echo '#ifndef __GNU_LIB_NAMES_H'; \
580          echo '#define __GNU_LIB_NAMES_H        1'; \
581          echo; \
582          (libs='$(all-sonames)';\
583           for l in $$libs; do \
584             upname=`echo $$l | sed 's/[.]so.*//' | \
585                     tr 'abcdefghijklmnopqrstuvwxyz-' \
586                        'ABCDEFGHIJKLMNOPQRSTUVWXYZ_'`; \
587             echo "#define       $${upname}_SO   \"$$l\""; \
588           done;) | sort; \
589          echo; \
590          echo '#endif   /* gnu/lib-names.h */';) > ${@:stmp=T}
591         if test -r ${@:stmp=h} && cmp -s ${@:stmp=h} ${@:stmp=T}; \
592         then rm -f ${@:stmp=T}; \
593         else mv -f ${@:stmp=T} ${@:stmp=h}; fi
594         touch $@
596 common-generated += gnu/lib-names.h gnu/lib-names.stmp
598 # The name under which the run-time dynamic linker is installed.
599 # We are currently going for the convention that `/lib/ld.so.1'
600 # names the SVR4/ELF ABI-compliant dynamic linker.
601 ifndef rtld-installed-name
602 ifdef ld.so-version
603 rtld-installed-name = $(ld.so-version)
604 else
605 rtld-installed-name = ld.so.1
606 endif
607 endif
609 ifndef rtld-version-installed-name
610 rtld-version-installed-name = ld-$(version).so
611 endif
613 endif # build-shared
615 endif # Makeconfig not yet included