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