This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
40395de80de31b945232feecc50b122824f335e9
[perl5.git] / hints / darwin.sh
1 ##
2 # Darwin (Mac OS) hints
3 # Wilfredo Sanchez <wsanchez@wsanchez.net>
4 ##
5
6 ##
7 # Paths
8 ##
9
10 # Configure hasn't figured out the version number yet.  Bummer.
11 perl_revision=`awk '/define[    ]+PERL_REVISION/ {print $3}' $src/patchlevel.h`
12 perl_version=`awk '/define[     ]+PERL_VERSION/ {print $3}' $src/patchlevel.h`
13 perl_subversion=`awk '/define[  ]+PERL_SUBVERSION/ {print $3}' $src/patchlevel.h`
14 version="${perl_revision}.${perl_version}.${perl_subversion}"
15
16 # Pretend that Darwin doesn't know about those system calls in Tiger
17 # (10.4/darwin 8) and earlier [perl #24122]
18 case "$osvers" in
19 [1-8].*)
20     d_setregid='undef'
21     d_setreuid='undef'
22     d_setrgid='undef'
23     d_setruid='undef'
24     ;;
25 esac
26
27 # finite() deprecated in 10.9, use isfinite() instead.
28 case "$osvers" in
29 [1-8].*) ;;
30 *) d_finite='undef' ;;
31 esac
32
33 # This was previously used in all but causes three cases
34 # (no -Ddprefix=, -Dprefix=/usr, -Dprefix=/some/thing/else)
35 # but that caused too much grief.
36 # vendorlib="/System/Library/Perl/${version}"; # Apple-supplied modules
37
38 # BSD paths
39 case "$prefix" in
40 '')     # Default install; use non-system directories
41         prefix='/usr/local';
42         siteprefix='/usr/local';
43         ;;
44 '/usr') # We are building/replacing the built-in perl
45         prefix='/';
46         installprefix='/';
47         bin='/usr/bin';
48         siteprefix='/usr/local';
49         # We don't want /usr/bin/HEAD issues.
50         sitebin='/usr/local/bin';
51         sitescript='/usr/local/bin';
52         installusrbinperl='define'; # You knew what you were doing.
53         privlib="/System/Library/Perl/${version}";
54         sitelib="/Library/Perl/${version}";
55         vendorprefix='/';
56         usevendorprefix='define';
57         vendorbin='/usr/bin';
58         vendorscript='/usr/bin';
59         vendorlib="/Network/Library/Perl/${version}";
60         # 4BSD uses ${prefix}/share/man, not ${prefix}/man.
61         man1dir='/usr/share/man/man1';
62         man3dir='/usr/share/man/man3';
63         # But users' installs shouldn't touch the system man pages.
64         # Transient obsoleted style.
65         siteman1='/usr/local/share/man/man1';
66         siteman3='/usr/local/share/man/man3';
67         # New style.
68         siteman1dir='/usr/local/share/man/man1';
69         siteman3dir='/usr/local/share/man/man3';
70         ;;
71   *)    # Anything else; use non-system directories, use Configure defaults
72         ;;
73 esac
74
75 ##
76 # Tool chain settings
77 ##
78
79 # Since we can build fat, the archname doesn't need the processor type
80 archname='darwin';
81
82 # nm isn't known to work after Snow Leopard and XCode 4; testing with OS X 10.5
83 # and Xcode 3 shows a working nm, but pretending it doesn't work produces no
84 # problems.
85 usenm='false';
86
87 case "$optimize" in
88 '')
89 #    Optimizing for size also mean less resident memory usage on the part
90 # of Perl.  Apple asserts that this is a more important optimization than
91 # saving on CPU cycles.  Given that memory speed has not increased at
92 # pace with CPU speed over time (on any platform), this is probably a
93 # reasonable assertion.
94 if [ -z "${optimize}" ]; then
95   case "`${cc:-gcc} -v 2>&1`" in
96     *"gcc version 3."*) optimize='-Os' ;;
97     *) optimize='-O3' ;;
98   esac
99 else
100   optimize='-O3'
101 fi
102 ;;
103 esac
104
105 # -fno-common because common symbols are not allowed in MH_DYLIB
106 # -DPERL_DARWIN: apparently the __APPLE__ is not sanctioned by Apple
107 # as the way to differentiate Mac OS X.  (The official line is that
108 # *no* cpp symbol does differentiate Mac OS X.)
109 ccflags="${ccflags} -fno-common -DPERL_DARWIN"
110
111 # At least on Darwin 1.3.x:
112 #
113 # # define INT32_MIN -2147483648
114 # int main () {
115 #  double a = INT32_MIN;
116 #  printf ("INT32_MIN=%g\n", a);
117 #  return 0;
118 # }
119 # will output:
120 # INT32_MIN=2.14748e+09
121 # Note that the INT32_MIN has become positive.
122 # INT32_MIN is set in /usr/include/stdint.h by:
123 # #define INT32_MIN        -2147483648
124 # which seems to break the gcc.  Defining INT32_MIN as (-2147483647-1)
125 # seems to work.  INT64_MIN seems to be similarly broken.
126 # -- Nicholas Clark, Ken Williams, and Edward Moy
127 #
128 # This seems to have been fixed since at least Mac OS X 10.1.3,
129 # stdint.h defining INT32_MIN as (-INT32_MAX-1)
130 # -- Edward Moy
131 #
132 if test -f /usr/include/stdint.h; then
133   case "$(grep '^#define INT32_MIN' /usr/include/stdint.h)" in
134   *-2147483648) ccflags="${ccflags} -DINT32_MIN_BROKEN -DINT64_MIN_BROKEN" ;;
135   esac
136 fi
137
138 # Avoid Apple's cpp precompiler, better for extensions
139 if [ "X`echo | ${cc} -no-cpp-precomp -E - 2>&1 >/dev/null`" = "X" ]; then
140     cppflags="${cppflags} -no-cpp-precomp"
141
142     # This is necessary because perl's build system doesn't
143     # apply cppflags to cc compile lines as it should.
144     ccflags="${ccflags} ${cppflags}"
145 fi
146
147 # Known optimizer problems.
148 case "`cc -v 2>&1`" in
149   *"3.1 20020105"*) toke_cflags='optimize=""' ;;
150 esac
151
152 # Shared library extension is .dylib.
153 # Bundle extension is .bundle.
154 so='dylib';
155 dlext='bundle';
156 usedl='define';
157
158 # 10.4 can use dlopen.
159 # 10.4 broke poll().
160 case "$osvers" in
161 [1-7].*)
162     dlsrc='dl_dyld.xs';
163     ;;
164 *)
165     dlsrc='dl_dlopen.xs';
166     d_poll='undef';
167     i_poll='undef';
168     ;;
169 esac
170
171 case "$ccdlflags" in            # If passed in from command line, presume user knows best
172 '')
173    cccdlflags=' '; # space, not empty, because otherwise we get -fpic
174 ;;
175 esac
176
177 # Allow the user to override ld, but modify it as necessary below
178 case "$ld" in
179     '') case "$cc" in
180         # If the cc is explicitly something else than cc (or empty),
181         # set the ld to be that explicitly something else.  Conversely,
182         # if the cc is 'cc' (or empty), set the ld to be 'cc'.
183         cc|'') ld='cc';;
184         *) ld="$cc" ;;
185         esac
186         ;;
187 esac
188
189 # From http://ftp.netbsd.org/pub/pkgsrc/current/pkgsrc/mk/platform/Darwin.mk
190 # and https://trac.macports.org/wiki/XcodeVersionInfo
191 # and https://trac.macports.org/wiki/UsingTheRightCompiler
192 # and https://gist.github.com/yamaya/2924292
193 # and http://opensource.apple.com/source/clang/
194 #
195 # Note that Xcode gets updates on older systems sometimes, and in
196 # general that the OS levels and XCode levels are not synchronized
197 # since new releases of XCode usually support both some new and some
198 # old OS releases.
199 #
200 # Note that Apple hijacks the clang preprocessor symbols __clang_major__
201 # and __clang_minor__ so they cannot be used (easily) to detect the
202 # actual clang release.  For example:
203 #
204 # "Yosemite 10.10.x 14.x.y 6.3 (clang 3.6 as 6.1/602.0.49)"
205 #
206 # means that the Xcode 6.3 provided the clang 6.3 but called it 6.1
207 # (__clang_major__, __clang_minor__) and in addition the preprocessor
208 # symbol __apple_build_version__ was 6020049.
209 #
210 # Codename        OS      Kernel  Xcode
211 #
212 # Cheetah         10.0.x  1.3.1
213 # Puma            10.1    1.4.1
214 #                 10.1.x  5.x.y
215 # Jaguar          10.2.x  6.x.y
216 # Panther         10.3.x  7.x.y
217 # Tiger           10.4.x  8.x.y   2.0   (gcc4 4.0.0)
218 #                                 2.2   (gcc4 4.0.1)
219 #                                 2.2.1 (gcc 3.3)
220 #                                 2.5 ?
221 # Leopard         10.5.x  9.x.y   3.0   (gcc 4.0.1 default)
222 #                                 3.1   (gcc 4.2.1)
223 # Snow Leopard    10.6.x  10.x.y  3.2   (llvm gcc 4.2, clang 2.3 as 1.0)
224 #                                 3.2.1 (clang 1.0.1 as 1.0.1/24)
225 #                                 3.2.2 (clang 1.0.2 as 1.0.2/32)
226 #                                 3.2.3 (clang 1.5 as 1.5/60)
227 #                                 4.0.1 (clang 2.9 as 2.0/138)
228 # Lion            10.7.x  11.x.y  4.1   (llvm gcc 4.2.1, clang 3.0 as 2.1/163.7.1)
229 #                                 4.2   (clang 3.0 as 3.0/211.10.1)
230 #                                 4.3.3 (clang 3.1 as 3.1/318.0.61)
231 #                                 4.4   (clang 3.1 as 4.0/421.0.57)
232 # Mountain Lion   10.8.x  12.x.y  4.5   (clang 3.1 as 4.1/421.11.65, real gcc removed, there is gcc but it's really clang)
233 #                                 4.6   (clang 3.2 as 4.2/425.0.24)
234 #                                 5.0   (clang 3.3 as 5.0/500.2.75)
235 #                                 5.1   (clang 3.4 as 5.1/503.0.38)
236 #                                 5.1.1 (clang 3.4 as 5.1/503.0.40)
237 # Mavericks       10.9.x  13.x.y  6.0.1 (clang 3.5 as 6.0/600.0.51)
238 #                                 6.1   (clang 3.5 as 6.0/600.0.54)
239 #                                 6.1.1 (clang 3.5 as 6.0/600.0.56)
240 #                                 6.2   (clang 3.5 as 6.0/600.0.57)
241 # Yosemite        10.10.x 14.x.y  6.3   (clang 3.6 as 6.1/602.0.49)
242 #                                 6.3.1 (clang 3.6 as 6.1/602.0.49)
243 #                                 6.3.2 (clang 3.6 as 6.1/602.0.53)
244 # El Capitan      10.11.x 15.x.y  7.0   (clang 3.7 as 7.0/700.0.72)
245 #                                 7.1   (clang 3.7 as 7.0/700.1.76)
246 #                                 7.2   (clang 3.7 as 7.0.2/700.1.81)
247 #                                 7.2.1 (clang 3.7 as 7.0.2/700.1.81)
248 #                                 7.3   (clang 3.8 as 7.3.0/703.0.29)
249 # Sierra          10.12.x 16.x.y  8.0.0 (clang 3.8 as 8.0/800.0.38)
250 #
251
252 # Processors Supported
253 #
254 # PowerPC (PPC):       10.0.x - 10.5.8 (final 10.5.x)
255 # PowerPC via Rosetta: 10.4.4 - 10.6.8 (final 10.6.x)
256 # IA-32:               10.4.4 - 10.6.8 (though still supported on x86-64)
257 # x86-64:              10.4.7 - current
258
259 # MACOSX_DEPLOYMENT_TARGET selects the minimum OS level we want to support
260 #
261 # It is needed for OS releases before 10.6.
262 #
263 # https://developer.apple.com/library/mac/documentation/DeveloperTools/Conceptual/cross_development/Configuring/configuring.html
264 #
265 # If it is set, we also propagate its value to ccflags and ldflags
266 # using the -mmacosx-version-min flag.  If it is not set, we use
267 # the OS X release as the min value for the flag.
268
269 # Adds "-mmacosx-version-min=$2" to "$1" unless it already is there.
270 add_macosx_version_min () {
271   local v
272   eval "v=\$$1"
273   case " $v " in
274   *"-mmacosx-version-min"*)
275      echo "NOT adding -mmacosx-version-min=$2 to $1 ($v)" >&4
276      ;;
277   *) echo "Adding -mmacosx-version-min=$2 to $1" >&4
278      eval "$1='$v -mmacosx-version-min=$2'"
279      ;;
280   esac
281 }
282
283 # Perl bundles do not expect two-level namespace, added in Darwin 1.4.
284 # But starting from perl 5.8.1/Darwin 7 the default is the two-level.
285 case "$osvers" in  # Note: osvers is the kernel version, not the 10.x
286 1.[0-3].*) # OS X 10.0.x
287    lddlflags="${ldflags} -bundle -undefined suppress"
288    ;;
289 1.*)       # OS X 10.1
290    ldflags="${ldflags} -flat_namespace"
291    lddlflags="${ldflags} -bundle -undefined suppress"
292    ;;
293 [2-6].*)   # OS X 10.1.x - 10.2.x (though [2-4] never existed publicly)
294    ldflags="${ldflags} -flat_namespace"
295    lddlflags="${ldflags} -bundle -undefined suppress"
296    ;;
297 [7-9].*)   # OS X 10.3.x - 10.5.x
298    lddlflags="${ldflags} -bundle -undefined dynamic_lookup"
299    case "$ld" in
300        *MACOSX_DEPLOYMENT_TARGET*) ;;
301        *) ld="env MACOSX_DEPLOYMENT_TARGET=10.3 ${ld}" ;;
302    esac
303    ;;
304 *)        # OS X 10.6.x - current
305    # The MACOSX_DEPLOYMENT_TARGET is not needed,
306    # but the -mmacosx-version-min option is always used.
307
308    # We now use MACOSX_DEPLOYMENT_TARGET, if set, as an override by
309    # capturing its value and adding it to the flags.
310     case "$MACOSX_DEPLOYMENT_TARGET" in
311     10.*)
312       add_macosx_version_min ccflags $MACOSX_DEPLOYMENT_TARGET
313       add_macosx_version_min ldflags $MACOSX_DEPLOYMENT_TARGET
314       ;;
315     '')
316       # Empty MACOSX_DEPLOYMENT_TARGET is okay.
317       ;;
318     *)
319       cat <<EOM >&4
320
321 *** Unexpected MACOSX_DEPLOYMENT_TARGET=$MACOSX_DEPLOYMENT_TARGET
322 ***
323 *** Please either set it to 10.something, or to empty.
324
325 EOM
326       exit 1
327       ;;
328     esac
329
330     # Keep the prodvers leading whitespace (Configure magic).
331     # Cannot use $osvers here since that is the kernel version.
332     # sw_vers output                 what we want
333     # "ProductVersion:    10.10.5"   "10.10"
334     # "ProductVersion:    10.11"     "10.11"
335         prodvers=`sw_vers|awk '/^ProductVersion:/{print $2}'|awk -F. '{print $1"."$2}'`
336     case "$prodvers" in
337     10.*)
338       add_macosx_version_min ccflags $prodvers
339       add_macosx_version_min ldflags $prodvers
340       ;;
341     *)
342       cat <<EOM >&4
343
344 *** Unexpected product version $prodvers.
345 ***
346 *** Try running sw_vers and see what its ProductVersion says.
347
348 EOM
349       exit 1
350     esac
351
352     # The X in 10.X
353     prodvers_minor=$(echo $prodvers|awk -F. '{print $2}')
354
355     # macOS (10.12) deprecated syscall().
356     if [ "$prodvers_minor" -ge 12 ]; then
357         d_syscall='undef'
358     fi
359
360    lddlflags="${ldflags} -bundle -undefined dynamic_lookup"
361    ;;
362 esac
363
364 ldlibpthname='DYLD_LIBRARY_PATH';
365
366 # useshrplib=true results in much slower startup times.
367 # 'false' is the default value.  Use Configure -Duseshrplib to override.
368
369 cat > UU/archname.cbu <<'EOCBU'
370 # This script UU/archname.cbu will get 'called-back' by Configure 
371 # after it has otherwise determined the architecture name.
372 case "$ldflags" in
373 *"-flat_namespace"*) ;; # Backward compat, be flat.
374 # If we are using two-level namespace, we will munge the archname to show it.
375 *) archname="${archname}-2level" ;;
376 esac
377 EOCBU
378
379 # 64-bit addressing support. Currently strictly experimental. DFD 2005-06-06
380 case "$use64bitall" in
381 $define|true|[yY]*)
382 case "$osvers" in
383 [1-7].*)
384      cat <<EOM >&4
385
386
387
388 *** 64-bit addressing is not supported for Mac OS X versions
389 *** below 10.4 ("Tiger") or Darwin versions below 8. Please try
390 *** again without -Duse64bitall. (-Duse64bitint will work, however.)
391
392 EOM
393      exit 1
394   ;;
395 *)
396     case "$osvers" in
397     8.*)
398         cat <<EOM >&4
399
400
401
402 *** Perl 64-bit addressing support is experimental for Mac OS X
403 *** 10.4 ("Tiger") and Darwin version 8. System V IPC is disabled
404 *** due to problems with the 64-bit versions of msgctl, semctl,
405 *** and shmctl. You should also expect the following test failures:
406 ***
407 ***    ext/threads-shared/t/wait (threaded builds only)
408
409 EOM
410
411         [ "$d_msgctl" ] || d_msgctl='undef'
412         [ "$d_semctl" ] || d_semctl='undef'
413         [ "$d_shmctl" ] || d_shmctl='undef'
414     ;;
415     esac
416
417     case `uname -p` in 
418     powerpc) arch=ppc64 ;;
419     i386) arch=x86_64 ;;
420     *) cat <<EOM >&4
421
422 *** Don't recognize processor, can't specify 64 bit compilation.
423
424 EOM
425     ;;
426     esac
427     for var in ccflags cppflags ld ldflags
428     do
429        eval $var="\$${var}\ -arch\ $arch"
430     done
431
432     ;;
433 esac
434 ;;
435 esac
436
437 ##
438 # System libraries
439 ##
440
441 # vfork works
442 usevfork='true';
443
444 # malloc wrap works
445 case "$usemallocwrap" in
446 '') usemallocwrap='define' ;;
447 esac
448
449 # our malloc works (but allow users to override)
450 case "$usemymalloc" in
451 '') usemymalloc='n' ;;
452 esac
453 # However sbrk() returns -1 (failure) somewhere in lib/unicore/mktables at
454 # around 14M, so we need to use system malloc() as our sbrk()
455 #
456 # sbrk() in Darwin deprecated since Mavericks (10.9), it still exists
457 # in Yosemite (10.10) but that is just an emulation, and fails for
458 # allocations beyond 4MB.  One should use e.g. mmap instead (or system
459 # malloc, as suggested above, that but is kind of backward).
460 malloc_cflags='ccflags="-DUSE_PERL_SBRK -DPERL_SBRK_VIA_MALLOC $ccflags"'
461
462 # Locales aren't feeling well.
463 LC_ALL=C; export LC_ALL;
464 LANG=C; export LANG;
465
466 #
467 # The libraries are not threadsafe as of OS X 10.1.
468 #
469 # Fix when Apple fixes libc.
470 #
471 case "$usethreads$useithreads" in
472   *define*)
473   case "$osvers" in
474     [12345].*)     cat <<EOM >&4
475
476
477
478 *** Warning, there might be problems with your libraries with
479 *** regards to threading.  The test ext/threads/t/libc.t is likely
480 *** to fail.
481
482 EOM
483     ;;
484     *) usereentrant='define';;
485   esac
486
487 esac
488
489 # Fink can install a GDBM library that claims to have the ODBM interfaces
490 # but Perl dynaloader cannot for some reason use that library.  We don't
491 # really need ODBM_FIle, though, so let's just hint ODBM away.
492 i_dbm=undef;
493
494 # Configure doesn't detect ranlib on Tiger properly.
495 # NeilW says this should be acceptable on all darwin versions.
496 ranlib='ranlib'
497
498 # Catch MacPorts gcc/g++ extra libdir
499 case "$($cc -v 2>&1)" in
500 *"MacPorts gcc"*) loclibpth="$loclibpth /opt/local/lib/libgcc" ;;
501 esac
502
503 ##
504 # Build process
505 ##
506
507 # Case-insensitive filesystems don't get along with Makefile and
508 # makefile in the same place.  Since Darwin uses GNU make, this dodges
509 # the problem.
510 firstmakefile=GNUmakefile;
511
512 # Parts of the system call setenv(), in particular in an atfork handler.
513 # This causes problems when the child tries to clean up environ[], so
514 # let libc manage environ[].
515 cat >> config.over <<'EOOVER'
516 if test "$d_unsetenv" = "$define" -a \
517     `expr "$ccflags" : '.*-DPERL_USE_SAFE_PUTENV'` -eq 0; then
518         ccflags="$ccflags -DPERL_USE_SAFE_PUTENV"
519 fi
520 EOOVER