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