Fix the ccversion detection for 5.1 and beyond.
[p5sagit/p5-mst-13.2.git] / hints / solaris_2.sh
1 # hints/solaris_2.sh
2 # Last modified:  Tue Apr 13 13:12:49 EDT 1999
3 # Andy Dougherty  <doughera@lafayette.edu>
4 # Based on input from lots of folks, especially
5 # Dean Roehrich <roehrich@ironwood-fddi.cray.com>
6
7 # If perl fails tests that involve dynamic loading of extensions, and
8 # you are using gcc, be sure that you are NOT using GNU as and ld.  One
9 # way to do that is to invoke Configure with
10
11 #     sh Configure -Dcc='gcc -B/usr/ccs/bin/'
12 #
13 #  (Note that the trailing slash is *required*.)
14 #  gcc will occasionally emit warnings about "unused prefix", but
15 #  these ought to be harmless.  See below for more details.
16  
17 # See man vfork.
18 usevfork=false
19
20 d_suidsafe=define
21
22 # Avoid all libraries in /usr/ucblib.
23 set `echo $glibpth | sed -e 's@/usr/ucblib@@'`
24 glibpth="$*"
25
26 # Remove bad libraries.  -lucb contains incompatible routines.
27 # -lld doesn't do anything useful.
28 # -lmalloc can cause a problem with GNU CC & Solaris.  Specifically,
29 # libmalloc.a may allocate memory that is only 4 byte aligned, but
30 # GNU CC on the Sparc assumes that doubles are 8 byte aligned.
31 # Thanks to  Hallvard B. Furuseth <h.b.furuseth@usit.uio.no>
32 set `echo " $libswanted " | sed -e 's@ ld @ @' -e 's@ malloc @ @' -e 's@ ucb @ @'`
33 libswanted="$*"
34
35 # Look for architecture name.  We want to suggest a useful default.
36 case "$archname" in
37 '')
38     if test -f /usr/bin/arch; then
39         archname=`/usr/bin/arch`
40         archname="${archname}-${osname}"
41     elif test -f /usr/ucb/arch; then
42         archname=`/usr/ucb/arch`
43         archname="${archname}-${osname}"
44     fi
45     ;;
46 esac
47
48 cc=${cc:-cc}
49
50 ccversion="`$cc -V 2>&1|head -1|sed 's/^cc: //'`"
51 case "$ccversion" in
52 *WorkShop*) ccname=workshop ;;
53 *) ccversion='' ;;
54 esac
55
56 cat >UU/workshoplibpth.cbu<<'EOCBU'
57 case "$workshoplibpth_done" in
58 '')     case "$use64bitall" in
59         "$define"|true|[yY]*)
60             loclibpth="$loclibpth /usr/lib/sparcv9"
61             if test -n "$workshoplibs"; then
62                 loclibpth=`echo $loclibpth | sed -e "s% $workshoplibs%%" `
63                 for lib in $workshoplibs; do
64                     # Logically, it should be sparcv9.
65                     # But the reality fights back, it's v9.
66                     loclibpth="$loclibpth $lib/sparcv9 $lib/v9"
67                 done
68             fi 
69             ;;
70         *)  loclibpth="$loclibpth $workshoplibs"  
71             ;;
72         esac
73         workshoplibpth_done="$define"
74         ;;
75 esac
76 EOCBU
77
78 case "$ccname" in
79 workshop)
80         cat >try.c <<EOF
81 #include <sunmath.h>
82 int main() { return(0); }
83 EOF
84         workshoplibs=`cc -### try.c -lsunmath -o try 2>&1|grep " -Y "|sed 's%.* -Y "P,\(.*\)".*%\1%'|tr ':' '\n'|grep '/SUNWspro/'`
85         . ./UU/workshoplibpth.cbu
86         ;;
87 esac
88
89 ######################################################
90 # General sanity testing.  See below for excerpts from the Solaris FAQ.
91 #
92 # From roehrich@ironwood-fddi.cray.com Wed Sep 27 12:51:46 1995
93 # Date: Thu, 7 Sep 1995 16:31:40 -0500
94 # From: Dean Roehrich <roehrich@ironwood-fddi.cray.com>
95 # To: perl5-porters@africa.nicoh.com
96 # Subject: Re: On perl5/solaris/gcc
97 #
98 # Here's another draft of the perl5/solaris/gcc sanity-checker. 
99
100 case `type ${cc:-cc}` in
101 */usr/ucb/cc*) cat <<END >&4
102
103 NOTE:  Some people have reported problems with /usr/ucb/cc.  
104 If you have difficulties, please make sure the directory
105 containing your C compiler is before /usr/ucb in your PATH.
106
107 END
108 ;;
109 esac
110
111
112 # Check that /dev/fd is mounted.  If it is not mounted, let the
113 # user know that suid scripts may not work.
114 /usr/bin/df /dev/fd 2>&1 > /dev/null
115 case $? in
116 0) ;;
117 *)
118         cat <<END >&4
119
120 NOTE: Your system does not have /dev/fd mounted.  If you want to
121 be able to use set-uid scripts you must ask your system administrator
122 to mount /dev/fd.
123
124 END
125         ;;
126 esac
127
128
129 # See if libucb can be found in /usr/lib.  If it is, warn the user
130 # that this may cause problems while building Perl extensions.
131 /usr/bin/ls /usr/lib/libucb* >/dev/null 2>&1
132 case $? in
133 0)
134         cat <<END >&4
135
136 NOTE: libucb has been found in /usr/lib.  libucb should reside in
137 /usr/ucblib.  You may have trouble while building Perl extensions.
138
139 END
140 ;;
141 esac
142
143 # Use shell built-in 'type' command instead of /usr/bin/which to
144 # avoid possible csh start-up problems and also to use the same shell
145 # we'll be using to Configure and make perl.
146 # The path name is the last field in the output, but the type command
147 # has an annoying array of possible outputs, e.g.:
148 #       make is hashed (/opt/gnu/bin/make)
149 #       cc is /usr/ucb/cc
150 #       foo not found
151 # use a command like type make | awk '{print $NF}' | sed 's/[()]//g'
152
153 # See if make(1) is GNU make(1).
154 # If it is, make sure the setgid bit is not set.
155 make -v > make.vers 2>&1
156 if grep GNU make.vers > /dev/null 2>&1; then
157     tmp=`type make | awk '{print $NF}' | sed 's/[()]//g'`
158     case "`/usr/bin/ls -lL $tmp`" in
159     ??????s*)
160             cat <<END >&2
161         
162 NOTE: Your PATH points to GNU make, and your GNU make has the set-group-id
163 bit set.  You must either rearrange your PATH to put /usr/ccs/bin before the
164 GNU utilities or you must ask your system administrator to disable the
165 set-group-id bit on GNU make.
166
167 END
168             ;;
169     esac
170 fi
171 rm -f make.vers
172
173 # XXX EXPERIMENTAL  A.D.  2/27/1998
174 # XXX This script UU/cc.cbu will get 'called-back' by Configure after it
175 # XXX has prompted the user for the C compiler to use.
176 cat > UU/cc.cbu <<'EOSH'
177 # If the C compiler is gcc:
178 #   - check the fixed-includes
179 #   - check as(1) and ld(1), they should not be GNU
180 #       (GNU as and ld 2.8.1 and later are reportedly ok, however.)
181 # If the C compiler is not gcc:
182 #   - check as(1) and ld(1), they should not be GNU
183 #       (GNU as and ld 2.8.1 and later are reportedly ok, however.)
184 #
185 # Watch out in case they have not set $cc.
186
187 # Perl compiled with some combinations of GNU as and ld may not 
188 # be able to perform dynamic loading of extensions.  If you have a
189 # problem with dynamic loading, be sure that you are using the Solaris
190 # /usr/ccs/bin/as and /usr/ccs/bin/ld.  You can do that with
191 #               sh Configure -Dcc='gcc -B/usr/ccs/bin/'
192 # (note the trailing slash is required). 
193 # Combinations that are known to work with the following hints:
194 #
195 #  gcc-2.7.2, GNU as 2.7, GNU ld 2.7
196 #  egcs-1.0.3, GNU as 2.9.1 and GNU ld 2.9.1
197 #       --Andy Dougherty  <doughera@lafayette.edu>  
198 #       Tue Apr 13 17:19:43 EDT 1999
199
200 # Get gcc to share its secrets.
201 echo 'main() { return 0; }' > try.c
202         # Indent to avoid propagation to config.sh
203         verbose=`${cc:-cc} -v -o try try.c 2>&1`
204
205 if echo "$verbose" | grep '^Reading specs from' >/dev/null 2>&1; then
206         #
207         # Using gcc.
208         #
209
210         tmp=`echo "$verbose" | grep '^Reading' |
211                 awk '{print $NF}'  | sed 's/specs$/include/'`
212
213         # Determine if the fixed-includes look like they'll work.
214         # Doesn't work anymore for gcc-2.7.2.
215
216         # See if as(1) is GNU as(1).  GNU as(1) might not work for this job.
217         if echo "$verbose" | grep ' /usr/ccs/bin/as ' >/dev/null 2>&1; then
218             :
219         else
220             cat <<END >&2
221
222 NOTE: You are using GNU as(1).  GNU as(1) might not build Perl.  If you
223 have trouble, you can use /usr/ccs/bin/as by including -B/usr/ccs/bin/
224 in your ${cc:-cc} command.  (Note that the trailing "/" is required.)
225
226 END
227             # Apparently not needed, at least for as 2.7 and later.
228             # cc="${cc:-cc} -B/usr/ccs/bin/"
229         fi
230
231         # See if ld(1) is GNU ld(1).  GNU ld(1) might not work for this job.
232         # Recompute $verbose since we may have just changed $cc.
233         verbose=`${cc:-cc} -v -o try try.c 2>&1 | grep ld 2>&1`
234
235         if echo "$verbose" | grep ' /usr/ccs/bin/ld ' >/dev/null 2>&1; then
236             # Ok, gcc directly calls the Solaris /usr/ccs/bin/ld.
237             :
238         elif echo "$verbose" | grep "ld: Software Generation Utilities" >/dev/null 2>&1; then
239             # Hmm.  gcc doesn't call /usr/ccs/bin/ld directly, but it
240             # does appear to be using it eventually.  egcs-1.0.3's ld
241             # wrapper does this.
242             # All Solaris versions of ld I've seen contain the magic
243             # string used in the grep.
244             :
245         else
246             # No evidence yet of /usr/ccs/bin/ld.  Some versions
247             # of egcs's ld wrapper call /usr/ccs/bin/ld in turn but
248             # apparently don't reveal that unless you pass in -V.
249             # (This may all depend on local configurations too.)
250
251             myld=`echo $verbose| grep ld | awk '/\/ld/ {print $1}'`
252             # This assumes that gcc's output will not change, and that
253             # /full/path/to/ld will be the first word of the output.
254             # Thus myld is something like opt/gnu/sparc-sun-solaris2.5/bin/ld
255
256             if $myld -V 2>&1 | grep "ld: Software Generation Utilities" >/dev/null 2>&1; then
257                 # Ok, /usr/ccs/bin/ld eventually does get called.
258                 :
259             else
260                 cat <<END >&2
261
262 NOTE: You are using GNU ld(1).  GNU ld(1) might not build Perl.  If you
263 have trouble, you can use /usr/ccs/bin/ld by including -B/usr/ccs/bin/
264 in your ${cc:-cc} command.  (Note that the trailing "/" is required.)
265
266 I will try to use GNU ld by passing in the -Wl,-E flag, but if that
267 doesn't work, you should use -B/usr/ccs/bin/ instead.
268
269 END
270                 ccdlflags="$ccdlflags -Wl,-E"
271                 lddlflags="$lddlflags -W,l-E -G"
272             fi
273         fi
274
275 else
276         #
277         # Not using gcc.
278         #
279
280         # See if as(1) is GNU as(1).  GNU might not work for this job.
281         case `as --version < /dev/null 2>&1` in
282         *GNU*)
283                 cat <<END >&2
284
285 NOTE: You are using GNU as(1).  GNU as(1) might not build Perl.
286 You must arrange to use /usr/ccs/bin/as, perhaps by adding /usr/ccs/bin
287 to the beginning of your PATH.
288
289 END
290                 ;;
291         esac
292
293         # See if ld(1) is GNU ld(1).  GNU ld(1) might not work for this job.
294         # ld --version doesn't properly report itself as a GNU tool,
295         # as of ld version 2.6, so we need to be more strict. TWP 9/5/96
296         gnu_ld=false
297         case `ld --version < /dev/null 2>&1` in
298         *GNU*|ld\ version\ 2*)
299                 gnu_ld=true ;;
300         *) ;;
301         esac
302         if $gnu_ld ; then :
303         else
304                 # Try to guess from path
305                 case `type ld | awk '{print $NF}'` in
306                 *gnu*|*GNU*|*FSF*)
307                         gnu_ld=true ;;
308                 esac
309         fi
310         if $gnu_ld ; then
311                 cat <<END >&2
312
313 NOTE: You are apparently using GNU ld(1).  GNU ld(1) might not build Perl.
314 You should arrange to use /usr/ccs/bin/ld, perhaps by adding /usr/ccs/bin
315 to the beginning of your PATH.
316
317 END
318         fi
319
320 fi
321
322 # as --version or ld --version might dump core.
323 rm -f try try.c
324 rm -f core
325
326 # XXX
327 EOSH
328
329 cat > UU/usethreads.cbu <<'EOCBU'
330 # This script UU/usethreads.cbu will get 'called-back' by Configure 
331 # after it has prompted the user for whether to use threads.
332 case "$usethreads" in
333 $define|true|[yY]*)
334         ccflags="-D_REENTRANT $ccflags"
335
336         # sched_yield is in -lposix4 up to Solaris 2.6, in -lrt starting with Solaris 7
337         case `uname -r` in
338         5.[0-6] | 5.5.1) sched_yield_lib="posix4" ;;
339         *) sched_yield_lib="rt";
340         esac
341         set `echo X "$libswanted "| sed -e "s/ c / $sched_yield_lib pthread c /"`
342         shift
343         libswanted="$*"
344
345         # On Solaris 2.6 x86 there is a bug with sigsetjmp() and siglongjmp()
346         # when linked with the threads library, such that whatever positive
347         # value you pass to siglongjmp(), sigsetjmp() returns 1.
348         # Thanks to Simon Parsons <S.Parsons@ftel.co.uk> for this report.
349         # Sun BugID is 4117946, "sigsetjmp always returns 1 when called by
350         # siglongjmp in a MT program". As of 19980622, there is no patch
351         # available.
352         cat >try.c <<'EOM'
353         /* Test for sig(set|long)jmp bug. */
354         #include <setjmp.h>
355          
356         main()
357         {
358             sigjmp_buf env;
359             int ret;
360         
361             ret = sigsetjmp(env, 1);
362             if (ret) { return ret == 2; }
363             siglongjmp(env, 2);
364         }
365 EOM
366         if test "`arch`" = i86pc -a `uname -r` = 5.6 && \
367            ${cc:-cc} try.c -lpthread >/dev/null 2>&1 && ./a.out; then
368             d_sigsetjmp=$undef
369             cat << 'EOM' >&2
370
371 You will see a *** WHOA THERE!!! ***  message from Configure for
372 d_sigsetjmp.  Keep the recommended value.  See hints/solaris_2.sh
373 for more information.
374
375 EOM
376         fi
377         ;;
378 esac
379 EOCBU
380
381 cat > UU/uselargefiles.cbu <<'EOCBU'
382 # This script UU/uselargefiles.cbu will get 'called-back' by Configure 
383 # after it has prompted the user for whether to use large files.
384 case "$uselargefiles" in
385 ''|$define|true|[yY]*)
386
387 # Keep these in the left margin.
388 ccflags_uselargefiles="`getconf LFS_CFLAGS 2>/dev/null`"
389 ldflags_uselargefiles="`getconf LFS_LDFLAGS 2>/dev/null`"
390 libswanted_uselargefiles="`getconf LFS_LIBS 2>/dev/null|sed -e 's@^-l@@' -e 's@ -l@ @g`"
391
392     ccflags="$ccflags $ccflags_uselargefiles"
393     ldflags="$ldflags $ldflags_uselargefiles"
394     libswanted="$libswanted $libswanted_uselargefiles"
395     ;;
396 esac
397 EOCBU
398
399 # This is truly a mess.
400 case "$usemorebits" in
401 "$define"|true|[yY]*)
402         use64bitint="$define"    
403         uselongdouble="$define"    
404         ;;
405 esac
406
407 cat > UU/use64bitall.cbu <<'EOCBU'
408 # This script UU/use64bitall.cbu will get 'called-back' by Configure 
409 # after it has prompted the user for whether to be maximally 64 bitty.
410 case "$use64bitall-$use64bitall_done" in
411 "$define-"|true-|[yY]*-)
412             case "`uname -r`" in
413             5.[1-6])
414                 cat >&4 <<EOM
415 Solaris `uname -r|sed -e 's/^5\.\([789]\)$/\1/'` does not support 64-bit pointers.
416 You should upgrade to at least Solaris 7.
417 EOM
418                 exit 1
419                 ;;
420             esac
421             libc='/usr/lib/sparcv9/libc.so'
422             if test ! -f $libc; then
423                 cat >&4 <<EOM
424
425 I do not see the 64-bit libc, $libc.
426 (You are either in an old sparc or in an x86.)
427 Cannot continue, aborting.
428
429 EOM
430                 exit 1
431             fi 
432             . ./UU/workshoplibpth.cbu
433             case "$cc -v 2>/dev/null" in
434             *gcc*)
435                 echo 'main() { return 0; }' > try.c
436                 case "`${cc:-cc} -mcpu=v9 -m64 -S try.c 2>&1 | grep 'm64 is not supported by this configuration'`" in
437                 *"m64 is not supported"*)
438                     cat >&4 <<EOM
439
440 Full 64-bit build not supported by this gcc configuration.
441 Cannot continue, aborting.
442
443 EOM
444                     exit 1
445                     ;;
446                 esac    
447                 ccflags="$ccflags -mcpu=v9 -m64"
448                 if test X`getconf XBS5_LP64_OFF64_CFLAGS 2>/dev/null` != X; then
449                     ccflags="$ccflags -Wa,`getconf XBS5_LP64_OFF64_CFLAGS 2>/dev/null`"
450                 fi
451                 # no changes to ld flags, as (according to man ld):
452                 #
453                 # There is no specific option that tells ld to link 64-bit
454                 # objects; the class of the first object that gets processed
455                 # by ld determines whether it is to perform a 32-bit or a
456                 # 64-bit link edit.
457                 ;;
458             *)
459                 ccflags="$ccflags `getconf XBS5_LP64_OFF64_CFLAGS 2>/dev/null`"
460                 ldflags="$ldflags `getconf XBS5_LP64_OFF64_LDFLAGS 2>/dev/null`"
461                 lddlflags="$lddlflags -G `getconf XBS5_LP64_OFF64_LDFLAGS 2>/dev/null`"
462                 ;;
463             esac        
464             libscheck='case "`/usr/bin/file $xxx`" in
465 *64-bit*|*SPARCV9*) ;;
466 *) xxx=/no/64-bit$xxx ;;
467 esac'
468             use64bitall_done=yes
469             ;;
470 esac
471 EOCBU
472  
473 # Actually, we want to run this already now, if so requested,
474 # because we need to fix up things right now.
475 case "$use64bitall" in
476 "$define"|true|[yY]*)
477         . ./UU/use64bitall.cbu
478         ;;
479 esac
480
481 cat > UU/uselongdouble.cbu <<'EOCBU'
482 # This script UU/uselongdouble.cbu will get 'called-back' by Configure 
483 # after it has prompted the user for whether to use long doubles.
484 case "$uselongdouble-$uselongdouble_done" in
485 "$define-"|true-|[yY]*-)
486         case "$ccname" in
487         workshop)
488                 libswanted="$libswanted sunmath"
489                 loclibpth="$loclibpth /opt/SUNWspro/lib"
490                 ;;
491         *)      cat >&4 <<EOM
492
493 The Sun Workshop compiler is not being used; therefore I do not see
494 the libsunmath; therefore I do not know how to do long doubles, sorry.
495 I'm disabling the use of long doubles.
496 EOM
497                 uselongdouble="$undef"
498                 ;;
499         esac
500         uselongdouble_done=yes
501         ;;
502 esac
503 EOCBU
504
505 # Actually, we want to run this already now, if so requested,
506 # because we need to fix up things right now.
507 case "$uselongdouble" in
508 "$define"|true|[yY]*)
509         . ./UU/uselongdouble.cbu
510         ;;
511 esac
512
513 rm -f try.c try.o try
514
515 # This is just a trick to include some useful notes.
516 cat > /dev/null <<'End_of_Solaris_Notes'
517
518 Here are some notes kindly contributed by Dean Roehrich.
519
520 -----
521 Generic notes about building Perl5 on Solaris:
522 - Use /usr/ccs/bin/make.
523 - If you use GNU make, remove its setgid bit.
524 - Remove all instances of *ucb* from your path.
525 - Make sure libucb is not in /usr/lib (it should be in /usr/ucblib).
526 - Do not use GNU as or GNU ld, or any of GNU binutils or GNU libc.
527 - Do not use /usr/ucb/cc.
528 - Do not change Configure's default answers, except for the path names.
529 - Do not use -lmalloc.
530 - Do not build on SunOS 4 and expect it to work properly on SunOS 5.
531 - /dev/fd must be mounted if you want set-uid scripts to work.
532
533
534 Here are the gcc-related questions and answers from the Solaris 2 FAQ.  Note
535 the themes:
536         - run fixincludes
537         - run fixincludes correctly
538         - don't use GNU as or GNU ld
539
540 Question 5.7 covers the __builtin_va_alist problem people are always seeing.
541 Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
542 people.
543 Question 6.9 is for those who are still trying to compile Perl4.
544
545 The latest Solaris 2 FAQ can be found in the following locations:
546         rtfm.mit.edu:/pub/usenet-by-group/comp.sys.sun.admin
547         ftp.fwi.uva.nl:/pub/solaris
548
549 Perl5 comes with a script in the top-level directory called "myconfig" which
550 will print a summary of the configuration in your config.sh.  My summary for
551 Solaris 2.4 and gcc 2.6.3 follows.  I have also built with gcc 2.7.0 and the
552 results are identical.  This configuration was generated with Configure's -d
553 option (take all defaults, don't bother prompting me).  All tests pass for
554 Perl5.001, patch.1m.
555
556 Summary of my perl5 (patchlevel 1) configuration:
557   Platform:
558     osname=solaris, osver=2.4, archname=sun4-solaris
559     uname='sunos poplar 5.4 generic_101945-27 sun4d sparc '
560     hint=recommended
561   Compiler:
562     cc='gcc', optimize='-O', ld='gcc'
563     cppflags=''
564     ccflags =''
565     ldflags =''
566     stdchar='unsigned char', d_stdstdio=define, usevfork=false
567     voidflags=15, castflags=0, d_casti32=define, d_castneg=define
568     intsize=4, alignbytes=8, usemymalloc=y, randbits=15
569   Libraries:
570     so=so
571     libpth=/lib /usr/lib /usr/ccs/lib /usr/local/lib
572     libs=-lsocket -lnsl -ldl -lm -lc -lcrypt
573     libc=/usr/lib/libc.so
574   Dynamic Linking:
575     dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef
576     cccdlflags='-fpic', ccdlflags=' ', lddlflags='-G'
577
578
579 Dean
580 roehrich@cray.com
581 9/7/95
582
583 -----------
584
585 From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
586 Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
587 Date: 25 Jul 1995 12:20:18 GMT
588
589 5.7) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
590
591     You're using gcc without properly installing the gcc fixed
592     include files.  Or you ran fixincludes after installing gcc
593     w/o moving the gcc supplied varargs.h and stdarg.h files
594     out of the way and moving them back again later.  This often
595     happens when people install gcc from a binary distribution.
596     If there's a tmp directory in gcc's include directory, fixincludes
597     didn't complete.  You should have run "just-fixinc" instead.
598
599     Another possible cause is using ``gcc -I/usr/include.''
600
601 6.1) Where is the C compiler or where can I get one?
602
603     [...]
604
605     3) Gcc.
606
607     Gcc is available from the GNU archives in source and binary
608     form.  Look in a directory called sparc-sun-solaris2 for
609     binaries.  You need gcc 2.3.3 or later.  You should not use
610     GNU as or GNU ld.  Make sure you run just-fixinc if you use
611     a binary distribution.  Better is to get a binary version and
612     use that to bootstrap gcc from source.
613
614     [...]
615
616     When you install gcc, don't make the mistake of installing
617     GNU binutils or GNU libc, they are not as capable as their
618     counterparts you get with Solaris 2.x.
619
620 6.9) I can't get perl 4.036 to compile or run.
621
622     Run Configure, and use the solaris_2_0 hints, *don't* use
623     the solaris_2_1 hints and don't use the config.sh you may
624     already have.  First you must make sure Configure and make
625     don't find /usr/ucb/cc.  (It must use gcc or the native C
626     compiler: /opt/SUNWspro/bin/cc)
627
628     Some questions need a special answer.
629
630     Are your system (especially dbm) libraries compiled with gcc? [y] y
631
632     yes: gcc 2.3.3 or later uses the standard calling
633     conventions, same as Sun's C.
634
635     Any additional cc flags? [ -traditional -Dvolatile=__volatile__
636     -I/usr/ucbinclude] -traditional -Dvolatile=__volatile__
637     Remove /usr/ucbinclude.
638
639     Any additional libraries? [-lsocket -lnsl -ldbm -lmalloc -lm
640     -lucb] -lsocket -lnsl  -lm
641
642     Don't include -ldbm, -lmalloc and -lucb.
643
644     Perl 5 compiled out of the box.
645
646 7.0) 64-bitness, from Alan Burlison (added by jhi 2000-02-21)
647
648   You need a machine running Solaris 2.7 or above.
649
650   Here's some rules:
651   
652   1. Solaris 2.7 and above will run in either 32 bit or 64 bit mode,
653      via a reboot.
654   2. You can build 64 bit apps whilst running 32 bit mode and vice-versa.
655   3. 32 bit apps will run under Solaris running in either 32 or 64 bit mode.
656   4. 64 bit apps require Solaris to be running 64 bit mode
657   5. It is possible to select the appropriate 32 or 64 bit version of an
658      app at run-time using isaexec(3).
659   6. You can detect the OS mode using "isainfo -v", e.g.
660       fubar$ isainfo -v   # Ultra 30 in 64 bit mode
661       64-bit sparcv9 applications
662       32-bit sparc applications
663   7. To compile 64 bit you need to use the flag "-xarch=v9".
664      getconf(1) will tell you this, e.g.
665       fubar$ getconf -a | grep v9
666       XBS5_LP64_OFF64_CFLAGS:         -xarch=v9
667       XBS5_LP64_OFF64_LDFLAGS:        -xarch=v9
668       XBS5_LP64_OFF64_LINTFLAGS:      -xarch=v9
669       XBS5_LPBIG_OFFBIG_CFLAGS:       -xarch=v9
670       XBS5_LPBIG_OFFBIG_LDFLAGS:      -xarch=v9
671       XBS5_LPBIG_OFFBIG_LINTFLAGS:    -xarch=v9
672       _XBS5_LP64_OFF64_CFLAGS:        -xarch=v9
673       _XBS5_LP64_OFF64_LDFLAGS:       -xarch=v9
674       _XBS5_LP64_OFF64_LINTFLAGS:     -xarch=v9
675       _XBS5_LPBIG_OFFBIG_CFLAGS:      -xarch=v9
676       _XBS5_LPBIG_OFFBIG_LDFLAGS:     -xarch=v9
677       _XBS5_LPBIG_OFFBIG_LINTFLAGS:   -xarch=v9
678
679   > > Now, what should we do, then?  Should -Duse64bits in a v9 box cause
680   > > Perl to compiled in v9 mode?  Or should we for compatibility stick
681   > > with 32 bit builds and let the people in the know to add the -xarch=v9
682   > > to ccflags (and ldflags?)?
683
684   > I think the second (explicit) mechanism should be the default.  Unless
685   > you want to allocate more than ~ 4Gb of memory inside Perl, you don't
686   > need Perl to be a 64-bit app.  Put it this way, on a machine running
687   > Solaris 8, there are 463 executables under /usr/bin, but only 15 of
688   > those require 64 bit versions - mainly because they invade the kernel
689   > address space, e.g. adb, kgmon etc.  Certainly we don't recommend users
690   > to build 64 bit apps unless they need the address space.
691
692 End_of_Solaris_Notes
693