This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
dbd24b6cda6c9cfd54dafe6985e02f85239a953d
[perl5.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 = t0a == t0b;
136
137 /* In FreeBSD 6.2 (and probably other releases too), with -Duse64bitint,
138    perl will use atoll(3).  However, that declaration is hidden in <stdlib.h>
139    if we force the compiler to use -std=c89 mode.
140 */
141   iv = Atol("42");
142
143   return (!t0c && (iv == 42)) ? 0 : -1; /* Try to avoid 'unused' warnings. */
144 }
145 __EOT__
146
147 stdflags=''
148
149 # Further gcc warning options.  Build up a list of options that work.
150 # Note that some problems may only show up with combinations of options,
151 # e.g. a warning might show up only with -Wall -ansi, not with either
152 # one individually.
153 # TODO:  Ponder whether to migrate this back to Configure so hints files can
154 # tweak it.  Also, be paranoid about whether results we've deduced in Configure
155 # (especially about things like long long, which are not in C89) will still be
156 # valid if we now add flags like -std=c89.
157
158 case "$gccversion" in
159 '') ;;
160 [12]*) ;; # gcc versions 1 (gasp!) and 2 are not good for this.
161 Intel*) ;; # # Is that you, Intel C++?
162 # XXX Note that -std=c89 without -pedantic is rather pointless.
163 # Just -std=c89 means "if there is room for interpretation,
164 # interpret the C89 way."  It does NOT mean "strict C89",
165 # you would need to add the -pedantic to get that.
166 #
167 # XXX If -pedantic (or -pedantic-errors!) is ever added,
168 # the -Werror=declaration-after-statement can be removed
169 # since "-std=c89 -pedantic" implies the -Werror=d-a-s.
170 *)  for opt in -ansi -std=c89 -Wextra -W \
171                 -Werror=declaration-after-statement \
172                 -Wc++-compat -Wwrite-strings
173     do
174        case " $ccflags " in
175        *" $opt "*) ;; # Skip if already there.
176        *) rm -f _cflags$_exe
177           case "`$cc -DPERL_NO_INLINE_FUNCTIONS $ccflags $warn $stdflags $opt _cflags.c -o _cflags$_exe 2>&1`" in
178           *"unrecognized"*) ;;
179           *"unknown"*) ;;
180           *"implicit declaration"*) ;; # Was something useful hidden?
181           *"Invalid"*) ;;
182           *"is valid for C"*) ;;
183           *) if test -x _cflags$_exe
184              then
185                case "$opt" in
186                -std*)
187                  echo "cflags.SH: Adding $opt."
188                  stdflags="$stdflags $opt"
189                  ;;
190                *) case "$opt" in
191                   -W)
192                     # -Wextra is the modern form of -W, so add
193                     # -W only if -Wextra is not there already.
194                     case " $warn " in
195                     *-Wextra*) ;;
196                     *)
197                       echo "cflags.SH: Adding $opt."
198                       warn="$warn opt"
199                       ;;
200                     esac
201                     ;;
202                   *)
203                      echo "cflags.SH: Adding $opt."
204                      warn="$warn $opt"
205                      ;;
206                   esac
207                esac
208              fi
209              ;;
210           esac
211           ;;
212        esac
213     done
214     ;;
215 esac
216 rm -f _cflags.c _cflags$_exe
217
218 case "$gccversion" in
219 '') ;;
220 *)
221   if [ "$gccansipedantic" = "" ]; then
222     # If we have -Duse64bitint (or equivalent) in effect and the quadtype
223     # has become 'long long', gcc -pedantic becomes unbearable (moreso
224     # when combined with -Wall) because long long and LL and %lld|%Ld
225     # become warn-worthy.  So let's drop the -pedantic in that case.
226     case "$quadtype:$sPRId64" in
227     "long long"*|*lld*|*Ld*)
228       echo "cflags.SH: Removing -pedantic and warn because of quadtype='long long'."
229       ccflags="`echo $ccflags|sed 's/-pedantic/ /'`"
230       warn="`echo $warn|sed 's/-pedantic/ /'`"
231       ;;
232     esac
233     # Similarly, since 'long long' isn't part of C89, FreeBSD 6.2 headers
234     # don't declare atoll() under -std=c89, but we need it.  In general,
235     # insisting on -std=c89 is inconsistent with insisting on using
236     # 'long long'. So drop -std=c89 and -ansi as well if we're using
237     # 'long long' as our main integral type.
238     case "$ivtype" in
239     "long long")
240         echo "cflags.SH: Removing -pedantic, -std=c89, and -ansi because of ivtype='long long'."
241         ccflags=`echo $ccflags|sed -e 's/-pedantic/ /' -e 's/-std=c89/ /' -e 's/-ansi/ /'`
242         warn=`echo $warn|sed -e 's/-pedantic/ /' -e 's/-ansi/ /'`
243         stdflags=`echo $stdflags|sed -e 's/-std=c89/ /'`
244         ;;
245     esac
246   fi
247   # Using certain features (like the gcc statement expressions)
248   # requires knowing whether -pedantic has been specified.
249   case "$warn$ccflags" in
250   *-pedantic*)
251     echo "cflags.SH: Adding -DPERL_PEDANTIC because of -pedantic."
252     warn="$warn -DPERL_GCC_PEDANTIC"
253     ;;
254   esac
255   ;;
256 esac
257
258 case "$cc" in
259 *g++*)
260   # Extra paranoia in case people have bad canned ccflags:
261   # bad in the sense that the flags are accepted by g++,
262   # but then whined about.
263   #
264   # -Werror=d-a-s option is valid for g++, by definition,
265   # but we remove it just for cleanliness and shorter command lines.
266   for f in -Wdeclaration-after-statement \
267                 -Werror=declaration-after-statement \
268                 -Wc++-compat \
269                 -std=c89
270   do
271     case "$ccflags$warn" in
272     *"$f"*)
273       echo "cflags.SH: Removing $f because of g++."
274       ccflags=`echo $ccflags|sed 's/$f/ /'`
275       warn=`echo $warn|sed 's/$f/ /'`
276       ;;
277     esac
278   done
279   ;;
280 esac
281
282 for f in -Wdeclaration-after-statement -Werror=declaration-after-statement
283 do
284   case "$cppflags" in
285   *"$f"*)
286     echo "cflags.SH: Removing $f from cppflags."
287     cppflags=`echo $cppflags|sed 's/$f/ /'` ;;
288   esac
289 done
290
291 # Code to set any extra flags here.
292 extra=''
293
294 echo "Extracting cflags (with variable substitutions)"
295 # This section of the file will have variable substitutions done on it.
296 # Move anything that needs config subs from !NO!SUBS! section to !GROK!THIS!.
297 # Protect any dollar signs and backticks that you do not want interpreted
298 # by putting a backslash in front.  You may delete these comments.
299 rm -f cflags
300 $spitshell >cflags <<!GROK!THIS!
301 $startsh
302
303 # !!!!!!!   DO NOT EDIT THIS FILE   !!!!!!!
304
305 # This file is generated by cflags.SH
306
307 # Used to restore possible edits by cflags.SH.
308 myccflags="$ccflags"
309 # Extra warnings, used e.g. for gcc.
310 warn="$warn"
311 # Extra standardness.
312 stdflags="$stdflags"
313 # Extra extra.
314 extra="$extra"
315 # what do executables look like?
316 _exe="$_exe"
317
318 !GROK!THIS!
319
320 # In the following dollars and backticks do not need the extra backslash.
321 $spitshell >>cflags <<'!NO!SUBS!'
322 case $PERL_CONFIG_SH in
323 '')
324         if test -f config.sh; then TOP=.;
325         elif test -f ../config.sh; then TOP=..;
326         elif test -f ../../config.sh; then TOP=../..;
327         elif test -f ../../../config.sh; then TOP=../../..;
328         elif test -f ../../../../config.sh; then TOP=../../../..;
329         else
330                 echo "Can't find config.sh."; exit 1
331         fi
332         . $TOP/config.sh
333         ccflags="$myccflags"  # Restore possible edits by cflags.SH.
334         ;;
335 esac
336
337 # syntax: cflags [optimize=XXX] [file[.suffix]] ...
338 #   displays the proposed compiler command line for each 'file'
339 #
340 #   with no file, dispalys it for all *.c files.
341 #   The optimise=XXX arg (if present) is evalled, setting the default
342 #   value of the $optimise variable, which is output on the command line
343 #   (but which may be overridden for specific files below)
344
345 case "X$1" in
346 Xoptimize=*|X"optimize=*")
347         eval "$1"
348         shift
349         ;;
350 esac
351
352 case $# in
353 0) set *.c; echo "The current C flags are:" ;;
354 esac
355
356 set `echo "$* " | sed -e 's/\.[oc] / /g' -e 's/\.obj / /g' -e "s/\\$obj_ext / /g"`
357
358 for file do
359
360     case "$#" in
361     1) ;;
362     *) echo $n "    $file.c     $c" ;;
363     esac
364
365     # allow variables like toke_cflags to be evaluated
366
367     if echo $file | grep -v / >/dev/null
368     then
369       eval 'eval ${'"${file}_cflags"'-""}'
370     fi
371
372     # or customize here
373
374     case "$file" in
375     *) ;;
376
377     # Customization examples follow.
378     #
379     # The examples are intentionally unreachable as the '*)' case above always
380     # matches. To use them, move before the '*)' and edit as appropriate.
381     # It is not a good idea to set ccflags to an absolute value here, as it
382     # often contains general -D defines which are needed for correct
383     # compilation. It is better to edit ccflags as shown, using interpolation
384     # to add flags, or sed to remove flags.
385
386     av) ccflags=`echo $ccflags | sed -e s/-pipe//` ;;
387     deb) ccflags="$ccflags -fno-jump-tables" ;;
388     hv) warn=`echo $warn | sed -e s/-Wextra//` ;;
389     toke) optimize=-O0 ;;
390     esac
391
392     # Can we perhaps use $ansi2knr here
393     echo "$cc -c -DPERL_CORE $ccflags $stdflags $optimize $warn $extra"
394
395     . $TOP/config.sh
396
397     # end per file behaviour
398 done
399 !NO!SUBS!
400 chmod 755 cflags
401 $eunicefix cflags