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