Added 5.21.5 release to perlhist
[perl.git] / cflags.SH
1 #!/bin/sh
2
3 # Generate the cflags script, which is used to determine what cflags
4 # to pass to the compiler for compiling the core perl.
5 #
6 # This does NOT affect the XS compilation (ext, dist, cpan)
7 # since that uses %Config values directly.
8 #
9 # For example, since -Wall adds -Wunused-*, a bare -Wall (without
10 # amending that with -Wno-unused-..., or with the PERL_UNUSED_...)
11 # would be too much for XS code because there are too many generated
12 # but often unused things.
13 #
14 # We create a temporary test C program and repeatedly compile it with
15 # various candidate flags, and from the compiler output, determine what
16 # flags are supported.
17 #
18 # From this we initialise the following variables in the cflags script:
19 #
20 #   $myccflags (possibly edited version of $Config{ccflags})
21 #   $warn
22 #   $stdflags
23 #   $extra
24 #   $_exe
25
26 case $PERL_CONFIG_SH in
27 '')
28         if test -f config.sh; then TOP=.;
29         elif test -f ../config.sh; then TOP=..;
30         elif test -f ../../config.sh; then TOP=../..;
31         elif test -f ../../../config.sh; then TOP=../../..;
32         elif test -f ../../../../config.sh; then TOP=../../../..;
33         else
34                 echo "Can't find config.sh."; exit 1
35         fi
36         . $TOP/config.sh
37         ;;
38 esac
39 # This forces SH files to create target in same directory as SH file.
40 # This is so that make depend always knows where to find SH derivatives.
41 case "$0" in
42 */*) cd `expr X$0 : 'X\(.*\)/'` ;;
43 esac
44
45 if test -f config_h.SH -a ! -f config.h; then
46     . ./config_h.SH
47     CONFIG_H=already-done
48 fi
49
50 warn=''
51
52 # Add -Wall for the core modules iff gcc and not already -Wall
53 case "$gccversion" in
54 '') ;;
55 Intel*) ;; # The Intel C++ plays gcc on TV but is not really it.
56 *)  case "$ccflags" in
57     *-Wall*) ;;
58     *) warn="$warn -Wall" ;;
59     esac
60     ;;
61 esac
62
63 # Create a test source file for testing what options can be fed to
64 # gcc in this system; include a selection of most common and commonly
65 # hairy include files.
66
67 cat >_cflags.c <<__EOT__
68 #include "EXTERN.h"
69 #include "perl.h"
70 /* The stdio.h, errno.h, and setjmp.h should be there in any ANSI C89. */
71 #include <stdio.h>
72 #include <errno.h>
73 #include <setjmp.h>
74 /* Just in case the inclusion of perl.h did not
75  * pull in enough system headers, let's try again. */
76 #ifdef I_STDLIB
77 #include <stdlib.h>
78 #endif
79 #ifdef I_STDDEF
80 #include <stddef.h>
81 #endif
82 #ifdef I_STDARG
83 #include <stdarg.h>
84 #endif
85 #ifdef I_LIMITS
86 #include <limits.h>
87 #endif
88 #ifdef I_DIRENT
89 #include <dirent.h>
90 #endif
91 #ifdef I_UNISTD
92 #include <unistd.h>
93 #endif
94 #ifdef I_SYS_TYPES
95 #include <sys/types.h>
96 #endif
97 #ifdef I_SYS_PARAM
98 #include <sys/param.h>
99 #endif
100 #ifdef I_SYS_RESOURCE
101 #include <sys/resource.h>
102 #endif
103 #ifdef I_SYS_SELECT
104 #include <sys/select.h>
105 #endif
106 #if defined(HAS_SOCKET) && !defined(VMS) && !defined(WIN32) /* See perl.h. */
107 #include <sys/socket.h>
108 #endif
109 #ifdef I_SYS_STAT
110 #include <sys/stat.h>
111 #endif
112 #ifdef I_SYS_TIME
113 #include <sys/time.h>
114 #endif
115 #ifdef I_SYS_TIMES
116 #include <sys/times.h>
117 #endif
118 #ifdef I_SYS_WAIT
119 #include <sys/wait.h>
120 #endif
121 /* The gcc -ansi can cause a lot of noise in Solaris because of:
122  /usr/include/sys/resource.h:148: warning: 'struct rlimit64' declared inside parameter list
123  */
124 int main(int argc, char *argv[]) {
125
126 /* Add here test code found to be problematic in some gcc platform. */
127
128 /* Off_t/off_t is a struct in Solaris with largefiles, and with gcc -ansi
129  * that struct cannot be compared in some gcc releases with a flat
130  * integer, such as a STRLEN. */
131
132   IV iv;
133   Off_t t0a = 2;
134   STRLEN t0b = 3;
135   int t0c = (STRLEN)t0a == t0b;
136
137   printf("%s: %d\n", argv[0], argc);
138
139 /* In FreeBSD 6.2 (and probably other releases too), with -Duse64bitint,
140    perl will use atoll(3).  However, that declaration is hidden in <stdlib.h>
141    if we force the compiler to use -std=c89 mode.
142 */
143   iv = Atol("42");
144
145   return (!t0c && (iv == 42)) ? 0 : -1; /* Try to avoid 'unused' warnings. */
146 }
147 __EOT__
148
149 stdflags=''
150
151 # Further gcc warning options.  Build up a list of options that work.
152 # Note that some problems may only show up with combinations of options,
153 # e.g. a warning might show up only with -Wall -ansi, not with either
154 # one individually.
155 # TODO:  Ponder whether to migrate this back to Configure so hints files can
156 # tweak it.  Also, be paranoid about whether results we've deduced in Configure
157 # (especially about things like long long, which are not in C89) will still be
158 # valid if we now add flags like -std=c89.
159
160 pedantic=''
161 case "$gccansipedantic" in
162 define) pedantic='-pedantic' ;;
163 esac
164
165 case "$gccversion" in
166 '') ;;
167 [12]*) ;; # gcc versions 1 (gasp!) and 2 are not good for this.
168 Intel*) ;; # # Is that you, Intel C++?
169 #
170 # NOTE 1: the -std=c89 without -pedantic is a bit pointless.
171 # Just -std=c89 means "if there is room for interpretation,
172 # interpret the C89 way."  It does NOT mean "strict C89" on its own.
173 # You need to add the -pedantic for that.  To do this with Configure,
174 # do -Dgccansipedantic (note that the -ansi is included in any case,
175 # the option is a bit oddly named, for historical reasons.)
176 #
177 # NOTE 2: -pedantic necessitates adding a couple of flags:
178 # * -PERL_GCC_PEDANTIC so that the perl code can adapt: there's nothing
179 #   added by gcc itself to indicate pedanticness.
180 # * -Wno-overlength-strings under -DDEBUGGING because quite many of
181 #   the LEAVE_with_name() and assert() calls generate string literals
182 #   longer then the ANSI minimum of 509 bytes.
183 #
184 # NOTE 3: the relative order of these options matters:
185 # -Wextra before -W, and -pedantic* before -Werror=d-a-s.
186 #
187 *)  for opt in -ansi -std=c89 $pedantic \
188                 -Werror=declaration-after-statement \
189                 -Wextra -W \
190                 -Wc++-compat -Wwrite-strings
191     do
192        case " $ccflags " in
193        *" $opt "*) ;; # Skip if already there.
194        *) rm -f _cflags$_exe
195           flags="-DPERL_NO_INLINE_FUNCTIONS $ccflags $warn $stdflags $opt"
196           case "$opt" in
197           *-pedantic*) flags="$flags -DPERL_GCC_PEDANTIC" ;;
198           esac
199           # echo "opt = $opt, flags = $flags"
200           cmd="$cc $flags _cflags.c -o _cflags$_exe"
201           out="`$cmd 2>&1`"
202           # echo "$cmd --> $out"
203           case "$out" in
204           *"unrecognized"*) ;;
205           *"unknown"*) ;;
206           *"implicit declaration"*) ;; # Was something useful hidden?
207           *"Invalid"*) ;;
208           *"is valid for C"*) ;;
209           *) if test -x _cflags$_exe
210              then
211                case "$opt" in
212                -std*)
213                  echo "cflags.SH: Adding $opt."
214                  stdflags="$stdflags $opt"
215                  ;;
216                *) case "$opt" in
217                   -W)
218                     # -Wextra is the modern form of -W, so add
219                     # -W only if -Wextra is not there already.
220                     case " $warn " in
221                     *-Wextra*) ;;
222                     *)
223                       echo "cflags.SH: Adding $opt."
224                       warn="$warn $opt"
225                       ;;
226                     esac
227                     ;;
228                   -Werror=declaration-after-statement)
229                     # -pedantic* (with -std=c89) covers -Werror=d-a-s.
230                     case "$stdflags$warn" in
231                     *-std=c89*-pedantic*|*-pedantic*-std=c89*) ;;
232                     *)
233                       echo "cflags.SH: Adding $opt."
234                       warn="$warn $opt"
235                       ;;
236                     esac
237                     ;;
238                   *)
239                      echo "cflags.SH: Adding $opt."
240                      warn="$warn $opt"
241                      ;;
242                   esac
243                esac
244              fi
245              ;;
246           esac
247           ;;
248        esac
249        case "$ccflags$warn" in
250        *-pedantic*)
251          overlength=''
252          case "$ccflags$optimize" in
253          *-DDEBUGGING*) overlength='-Wno-overlength-strings' ;;
254          esac
255          for opt2 in -DPERL_GCC_PEDANTIC $overlength
256          do
257            case "$ccflags$warn" in
258            *"$opt2"*) ;;
259            *) echo "cflags.SH: Adding $opt2 because of -pedantic."
260               warn="$warn $opt2" ;;
261            esac
262          done
263          ;;
264        esac
265     done
266     ;;
267 esac
268 rm -f _cflags.c _cflags$_exe
269
270 case "$gccversion" in
271 '') ;;
272 *)
273   case "$warn$ccflags" in
274   *-pedantic*)
275     # If we have -Duse64bitint (or equivalent) in effect and the quadtype
276     # has become 'long long', gcc -pedantic* becomes unbearable
277     # (moreso when combined with -Wall) because long long and LL and %lld|%Ld
278     # become warn-worthy.  So let's drop the -pedantic in that case.
279     #
280     # Similarly, since 'long long' isn't part of C89, FreeBSD 6.2 headers
281     # don't declare atoll() under -std=c89, but we need it.  In general,
282     # insisting on -std=c89 is inconsistent with insisting on using
283     # 'long long'. So drop -std=c89 and -ansi as well if we're using
284     # 'long long' as our main integral type.
285     #
286     # usedtrace (DTrace) uses unportable features (dollars in identifiers,
287     # and gcc statement expressions), it is just easier to turn off pedantic.
288     remove=''
289     case "$quadtype:$ivtype:$sPRId64:$usedtrace" in
290     *"long long"*|*lld*|*Ld*) remove='long long' ;;
291     *) case "$usedtrace" in
292        define) remove='usedtrace' ;;
293        esac
294        ;;
295     esac
296     case "$remove" in
297     '') ;;
298     *) echo "cflags.SH: Removing -pedantic*, -std=c89, and -ansi because of $remove."
299       ccflags=`echo $ccflags|sed -e 's/-pedantic-errors/ /' -e 's/-pedantic/ /' -e 's/-std=c89/ /' -e 's/-ansi/ /' -e 's/-DPERL_GCC_PEDANTIC/ /'`
300       warn=`echo $warn|sed -e 's/-pedantic-errors/ /' -e 's/-pedantic/ /' -e 's/-ansi/ /' -e 's/-DPERL_GCC_PEDANTIC/ /'`
301       stdflags=`echo $stdflags|sed -e 's/-std=c89/ /'`
302       ;;
303     esac
304     ;;
305   esac
306   ;;
307 esac
308
309 # Older clang releases are not wise enough for -Wunused-value.
310 case "$gccversion" in
311 *"Apple LLVM "[34]*|*"Apple LLVM version "[34]*)
312   for f in -Wno-unused-value
313   do
314     echo "cflags.SH: Adding $f because clang version '$gccversion'" 
315     warn="$warn $f"
316   done
317   ;;
318 esac
319
320 # The quadmath Q format specifier will cause -Wformat to whine.
321 case "$gccversion" in
322 '') ;;
323 *) case "$usequadmath" in
324    define)
325      for f in -Wno-format
326      do
327        echo "cflags.SH: Adding $f because of usequadmath."
328        warn="$warn $f"
329      done
330     ;;
331   esac
332   ;;
333 esac
334
335 case "$cc" in
336 *g++*)
337   # Extra paranoia in case people have bad canned ccflags:
338   # bad in the sense that the flags are accepted by g++,
339   # but then whined about.
340   #
341   # -Werror=d-a-s option is valid for g++, by definition,
342   # but we remove it just for cleanliness and shorter command lines.
343   for f in -Wdeclaration-after-statement \
344                 -Werror=declaration-after-statement \
345                 -Wc++-compat \
346                 -std=c89
347   do
348     case "$ccflags$warn" in
349     *"$f"*)
350       echo "cflags.SH: Removing $f because of g++."
351       ccflags=`echo $ccflags|sed 's/$f/ /'`
352       warn=`echo $warn|sed 's/$f/ /'`
353       ;;
354     esac
355   done
356   ;;
357 esac
358
359 for f in -Wdeclaration-after-statement -Werror=declaration-after-statement
360 do
361   case "$cppflags" in
362   *"$f"*)
363     echo "cflags.SH: Removing $f from cppflags."
364     cppflags=`echo $cppflags|sed 's/$f/ /'` ;;
365   esac
366 done
367
368 echo "cflags.SH: cc       = $cc"
369 echo "cflags.SH: ccflags  = $ccflags"
370 echo "cflags.SH: stdflags = $stdflags"
371 echo "cflags.SH: optimize = $optimize"
372 echo "cflags.SH: warn     = $warn"
373
374 # Code to set any extra flags here.
375 extra=''
376
377 echo "Extracting cflags (with variable substitutions)"
378 # This section of the file will have variable substitutions done on it.
379 # Move anything that needs config subs from !NO!SUBS! section to !GROK!THIS!.
380 # Protect any dollar signs and backticks that you do not want interpreted
381 # by putting a backslash in front.  You may delete these comments.
382 rm -f cflags
383 $spitshell >cflags <<!GROK!THIS!
384 $startsh
385
386 # !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
387
388 # This file is generated by cflags.SH
389
390 # Used to restore possible edits by cflags.SH.
391 myccflags="$ccflags"
392 # Extra warnings, used e.g. for gcc.
393 warn="$warn"
394 # Extra standardness.
395 stdflags="$stdflags"
396 # Extra extra.
397 extra="$extra"
398 # what do executables look like?
399 _exe="$_exe"
400
401 !GROK!THIS!
402
403 # In the following dollars and backticks do not need the extra backslash.
404 $spitshell >>cflags <<'!NO!SUBS!'
405 case $PERL_CONFIG_SH in
406 '')
407         if test -f config.sh; then TOP=.;
408         elif test -f ../config.sh; then TOP=..;
409         elif test -f ../../config.sh; then TOP=../..;
410         elif test -f ../../../config.sh; then TOP=../../..;
411         elif test -f ../../../../config.sh; then TOP=../../../..;
412         else
413                 echo "Can't find config.sh."; exit 1
414         fi
415         . $TOP/config.sh
416         ccflags="$myccflags"  # Restore possible edits by cflags.SH.
417         ;;
418 esac
419
420 # syntax: cflags [optimize=XXX] [file[.suffix]] ...
421 #   displays the proposed compiler command line for each 'file'
422 #
423 #   with no file, dispalys it for all *.c files.
424 #   The optimise=XXX arg (if present) is evalled, setting the default
425 #   value of the $optimise variable, which is output on the command line
426 #   (but which may be overridden for specific files below)
427
428 case "X$1" in
429 Xoptimize=*|X"optimize=*")
430         eval "$1"
431         shift
432         ;;
433 esac
434
435 case $# in
436 0) set *.c; echo "The current C flags are:" ;;
437 esac
438
439 set `echo "$* " | sed -e 's/\.[oc] / /g' -e 's/\.obj / /g' -e "s/\\$obj_ext / /g"`
440
441 for file do
442
443     case "$#" in
444     1) ;;
445     *) echo $n "    $file.c     $c" ;;
446     esac
447
448     # allow variables like toke_cflags to be evaluated
449
450     if echo $file | grep -v / >/dev/null
451     then
452       eval 'eval ${'"${file}_cflags"'-""}'
453     fi
454
455     # or customize here
456
457     case "$file" in
458     regcomp) : work around http://bugs.debian.org/754054
459         case $archname in
460         mips-*|mipsel-*)
461             optimize="$optimize -fno-tree-vrp";;
462         esac;;
463     *) ;;
464
465     # Customization examples follow.
466     #
467     # The examples are intentionally unreachable as the '*)' case above always
468     # matches. To use them, move before the '*)' and edit as appropriate.
469     # It is not a good idea to set ccflags to an absolute value here, as it
470     # often contains general -D defines which are needed for correct
471     # compilation. It is better to edit ccflags as shown, using interpolation
472     # to add flags, or sed to remove flags.
473
474     av) ccflags=`echo $ccflags | sed -e s/-pipe//` ;;
475     deb) ccflags="$ccflags -fno-jump-tables" ;;
476     hv) warn=`echo $warn | sed -e s/-Wextra//` ;;
477     toke) optimize=-O0 ;;
478     esac
479
480     # Can we perhaps use $ansi2knr here
481     echo "$cc -c -DPERL_CORE $ccflags $stdflags $optimize $warn $extra"
482
483     . $TOP/config.sh
484
485     # end per file behaviour
486 done
487 !NO!SUBS!
488 chmod 755 cflags
489 $eunicefix cflags