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