3 # Generate the cflags script, which is used to determine what cflags
4 # to pass to the compiler for compiling the core perl.
6 # This does NOT affect the XS compilation (ext, dist, cpan)
7 # since that uses %Config values directly.
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.
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.
18 # From this we initialise the following variables in the cflags script:
20 # $myccflags (possibly edited version of $Config{ccflags})
26 case $PERL_CONFIG_SH in
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=../../../..;
34 echo "Can't find config.sh."; exit 1
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.
42 */*) cd `expr X$0 : 'X\(.*\)/'` ;;
45 if test -f config_h.SH -a ! -f config.h; then
52 # Add -Wall for the core modules iff gcc and not already -Wall
55 Intel*) ;; # The Intel C++ plays gcc on TV but is not really it.
58 *) warn="$warn -Wall" ;;
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.
67 cat >_cflags.c <<__EOT__
70 /* The stdio.h, errno.h, and setjmp.h should be there in any ANSI C89. */
74 /* Just in case the inclusion of perl.h did not
75 * pull in enough system headers, let's try again. */
95 #include <sys/types.h>
98 #include <sys/param.h>
100 #ifdef I_SYS_RESOURCE
101 #include <sys/resource.h>
104 #include <sys/select.h>
106 #if defined(HAS_SOCKET) && !defined(VMS) && !defined(WIN32) /* See perl.h. */
107 #include <sys/socket.h>
110 #include <sys/stat.h>
113 #include <sys/time.h>
116 #include <sys/times.h>
119 #include <sys/wait.h>
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
124 int main(int argc, char *argv[]) {
126 /* Add here test code found to be problematic in some gcc platform. */
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. */
135 int t0c = (STRLEN)t0a == t0b;
137 printf("%s: %d\n", argv[0], argc);
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.
145 return (!t0c && (iv == 42)) ? 0 : -1; /* Try to avoid 'unused' warnings. */
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
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.
161 case "$gccansipedantic" in
162 define) pedantic='-pedantic' ;;
165 case "$gccversion" in
167 [12]*) ;; # gcc versions 1 (gasp!) and 2 are not good for this.
168 Intel*) ;; # # Is that you, Intel C++?
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.)
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.
184 # NOTE 3: the relative order of these options matters:
185 # -Wextra before -W, and -pedantic* before -Werror=d-a-s.
187 *) for opt in -ansi -std=c89 $pedantic \
188 -Werror=declaration-after-statement \
190 -Wc++-compat -Wwrite-strings
193 *" $opt "*) ;; # Skip if already there.
194 *) rm -f _cflags$_exe
195 flags="-DPERL_NO_INLINE_FUNCTIONS $ccflags $warn $stdflags $opt"
197 *-pedantic*) flags="$flags -DPERL_GCC_PEDANTIC" ;;
199 # echo "opt = $opt, flags = $flags"
200 cmd="$cc $flags _cflags.c -o _cflags$_exe"
202 # echo "$cmd --> $out"
206 *"implicit declaration"*) ;; # Was something useful hidden?
208 *"is valid for C"*) ;;
209 *) if test -x _cflags$_exe
213 echo "cflags.SH: Adding $opt."
214 stdflags="$stdflags $opt"
218 # -Wextra is the modern form of -W, so add
219 # -W only if -Wextra is not there already.
223 echo "cflags.SH: Adding $opt."
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*) ;;
233 echo "cflags.SH: Adding $opt."
239 echo "cflags.SH: Adding $opt."
249 case "$ccflags$warn" in
252 case "$ccflags$optimize" in
253 *-DDEBUGGING*) overlength='-Wno-overlength-strings' ;;
255 for opt2 in -DPERL_GCC_PEDANTIC $overlength
257 case "$ccflags$warn" in
259 *) echo "cflags.SH: Adding $opt2 because of -pedantic."
260 warn="$warn $opt2" ;;
268 rm -f _cflags.c _cflags$_exe
270 case "$gccversion" in
273 case "$warn$ccflags" in
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.
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.
286 # usedtrace (DTrace) uses unportable features (dollars in identifiers,
287 # and gcc statement expressions), it is just easier to turn off pedantic.
289 case "$quadtype:$ivtype:$sPRId64:$usedtrace" in
290 *"long long"*|*lld*|*Ld*) remove='long long' ;;
291 *) case "$usedtrace" in
292 define) remove='usedtrace' ;;
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/ /'`
311 # Extra paranoia in case people have bad canned ccflags:
312 # bad in the sense that the flags are accepted by g++,
313 # but then whined about.
315 # -Werror=d-a-s option is valid for g++, by definition,
316 # but we remove it just for cleanliness and shorter command lines.
317 for f in -Wdeclaration-after-statement \
318 -Werror=declaration-after-statement \
322 case "$ccflags$warn" in
324 echo "cflags.SH: Removing $f because of g++."
325 ccflags=`echo $ccflags|sed 's/$f/ /'`
326 warn=`echo $warn|sed 's/$f/ /'`
333 for f in -Wdeclaration-after-statement -Werror=declaration-after-statement
337 echo "cflags.SH: Removing $f from cppflags."
338 cppflags=`echo $cppflags|sed 's/$f/ /'` ;;
342 echo "cflags.SH: cc = $cc"
343 echo "cflags.SH: ccflags = $ccflags"
344 echo "cflags.SH: stdflags = $stdflags"
345 echo "cflags.SH: optimize = $optimize"
346 echo "cflags.SH: warn = $warn"
348 # Code to set any extra flags here.
351 echo "Extracting cflags (with variable substitutions)"
352 # This section of the file will have variable substitutions done on it.
353 # Move anything that needs config subs from !NO!SUBS! section to !GROK!THIS!.
354 # Protect any dollar signs and backticks that you do not want interpreted
355 # by putting a backslash in front. You may delete these comments.
357 $spitshell >cflags <<!GROK!THIS!
360 # !!!!!!! DO NOT EDIT THIS FILE !!!!!!!
362 # This file is generated by cflags.SH
364 # Used to restore possible edits by cflags.SH.
366 # Extra warnings, used e.g. for gcc.
368 # Extra standardness.
372 # what do executables look like?
377 # In the following dollars and backticks do not need the extra backslash.
378 $spitshell >>cflags <<'!NO!SUBS!'
379 case $PERL_CONFIG_SH in
381 if test -f config.sh; then TOP=.;
382 elif test -f ../config.sh; then TOP=..;
383 elif test -f ../../config.sh; then TOP=../..;
384 elif test -f ../../../config.sh; then TOP=../../..;
385 elif test -f ../../../../config.sh; then TOP=../../../..;
387 echo "Can't find config.sh."; exit 1
390 ccflags="$myccflags" # Restore possible edits by cflags.SH.
394 # syntax: cflags [optimize=XXX] [file[.suffix]] ...
395 # displays the proposed compiler command line for each 'file'
397 # with no file, dispalys it for all *.c files.
398 # The optimise=XXX arg (if present) is evalled, setting the default
399 # value of the $optimise variable, which is output on the command line
400 # (but which may be overridden for specific files below)
403 Xoptimize=*|X"optimize=*")
410 0) set *.c; echo "The current C flags are:" ;;
413 set `echo "$* " | sed -e 's/\.[oc] / /g' -e 's/\.obj / /g' -e "s/\\$obj_ext / /g"`
419 *) echo $n " $file.c $c" ;;
422 # allow variables like toke_cflags to be evaluated
424 if echo $file | grep -v / >/dev/null
426 eval 'eval ${'"${file}_cflags"'-""}'
434 # Customization examples follow.
436 # The examples are intentionally unreachable as the '*)' case above always
437 # matches. To use them, move before the '*)' and edit as appropriate.
438 # It is not a good idea to set ccflags to an absolute value here, as it
439 # often contains general -D defines which are needed for correct
440 # compilation. It is better to edit ccflags as shown, using interpolation
441 # to add flags, or sed to remove flags.
443 av) ccflags=`echo $ccflags | sed -e s/-pipe//` ;;
444 deb) ccflags="$ccflags -fno-jump-tables" ;;
445 hv) warn=`echo $warn | sed -e s/-Wextra//` ;;
446 toke) optimize=-O0 ;;
449 # Can we perhaps use $ansi2knr here
450 echo "$cc -c -DPERL_CORE $ccflags $stdflags $optimize $warn $extra"
454 # end per file behaviour