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                 case "`${cc:-cc} -mcpu=v9 -m64 -S try.c 2>&1 | grep 'm64 is not supported by this configuration'`" in
 432                 *"m64 is not supported"*)
 433                     cat >&4 <<EOM
 434
 435 Full 64-bit build not supported by this gcc configuration.
 436 Cannot continue, aborting.
 437
 438 EOM
 439                     exit 1
 440                     ;;
 441                 esac
 442                 ccflags="$ccflags -mcpu=v9 -m64"
 443                 if test X`getconf XBS5_LP64_OFF64_CFLAGS 2>/dev/null` != X; then
 444                     ccflags="$ccflags -Wa,`getconf XBS5_LP64_OFF64_CFLAGS 2>/dev/null`"
 445                 fi
 446                 # no changes to ld flags, as (according to man ld):
 447                 #
 448                 # There is no specific option that tells ld to link 64-bit
 449                 # objects; the class of the first object that gets processed
 450                 # by ld determines whether it is to perform a 32-bit or a
 451                 # 64-bit link edit.
 452                 ;;
 453             *)
 454                 ccflags="$ccflags `getconf XBS5_LP64_OFF64_CFLAGS 2>/dev/null`"
 455                 ldflags="$ldflags `getconf XBS5_LP64_OFF64_LDFLAGS 2>/dev/null`"
 456                 lddlflags="$lddlflags -G `getconf XBS5_LP64_OFF64_LDFLAGS 2>/dev/null`"
 457                 ;;
 458             esac
 459             libscheck='case "`/usr/bin/file $xxx`" in
 460 *64-bit*|*SPARCV9*) ;;
 461 *) xxx=/no/64-bit$xxx ;;
 462 esac'
 463             use64bitall_done=yes
 464             ;;
 465 esac
 466 EOCBU
 467
 468 # Actually, we want to run this already now, if so requested,
 469 # because we need to fix up things right now.
 470 case "$use64bitall" in
 471 "$define"|true|[yY]*)
 472         . ./UU/use64bitall.cbu
 473         ;;
 474 esac
 475
 476 cat > UU/uselongdouble.cbu <<'EOCBU'
 477 # This script UU/uselongdouble.cbu will get 'called-back' by Configure
 478 # after it has prompted the user for whether to use long doubles.
 479 case "$uselongdouble-$uselongdouble_done" in
 480 "$define-"|true-|[yY]*-)
 481         case "$ccisworkshop" in
 482         '')     cat >&4 <<EOM
 483
 484 I do not see the Sun Workshop compiler; therefore I do not see
 485 the libsunmath; therefore I do not know how to do long doubles, sorry.
 486 I'm disabling the use of long doubles.
 487 EOM
 488                 uselongdouble="$undef"
 489                 ;;
 490         *)      libswanted="$libswanted sunmath"
 491                 loclibpth="$loclibpth /opt/SUNWspro/lib"
 492                 ;;
 493         esac
 494         uselongdouble_done=yes
 495         ;;
 496 esac
 497 EOCBU
 498
 499 # Actually, we want to run this already now, if so requested,
 500 # because we need to fix up things right now.
 501 case "$uselongdouble" in
 502 "$define"|true|[yY]*)
 503         . ./UU/uselongdouble.cbu
 504         ;;
 505 esac
 506
 507 rm -f try.c try.o try
 508 # keep that leading tab
 509         ccisworkshop=''
 510         ccisgcc=''
 511
 512 # This is just a trick to include some useful notes.
 513 cat > /dev/null <<'End_of_Solaris_Notes'
 514
 515 Here are some notes kindly contributed by Dean Roehrich.
 516
 517 -----
 518 Generic notes about building Perl5 on Solaris:
 519 - Use /usr/ccs/bin/make.
 520 - If you use GNU make, remove its setgid bit.
 521 - Remove all instances of *ucb* from your path.
 522 - Make sure libucb is not in /usr/lib (it should be in /usr/ucblib).
 523 - Do not use GNU as or GNU ld, or any of GNU binutils or GNU libc.
 524 - Do not use /usr/ucb/cc.
 525 - Do not change Configure's default answers, except for the path names.
 526 - Do not use -lmalloc.
 527 - Do not build on SunOS 4 and expect it to work properly on SunOS 5.
 528 - /dev/fd must be mounted if you want set-uid scripts to work.
 529
 530
 531 Here are the gcc-related questions and answers from the Solaris 2 FAQ.  Note
 532 the themes:
 533         - run fixincludes
 534         - run fixincludes correctly
 535         - don't use GNU as or GNU ld
 536
 537 Question 5.7 covers the __builtin_va_alist problem people are always seeing.
 538 Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
 539 people.
 540 Question 6.9 is for those who are still trying to compile Perl4.
 541
 542 The latest Solaris 2 FAQ can be found in the following locations:
 543         rtfm.mit.edu:/pub/usenet-by-group/comp.sys.sun.admin
 544         ftp.fwi.uva.nl:/pub/solaris
 545
 546 Perl5 comes with a script in the top-level directory called "myconfig" which
 547 will print a summary of the configuration in your config.sh.  My summary for
 548 Solaris 2.4 and gcc 2.6.3 follows.  I have also built with gcc 2.7.0 and the
 549 results are identical.  This configuration was generated with Configure's -d
 550 option (take all defaults, don't bother prompting me).  All tests pass for
 551 Perl5.001, patch.1m.
 552
 553 Summary of my perl5 (patchlevel 1) configuration:
 554   Platform:
 555     osname=solaris, osver=2.4, archname=sun4-solaris
 556     uname='sunos poplar 5.4 generic_101945-27 sun4d sparc '
 557     hint=recommended
 558   Compiler:
 559     cc='gcc', optimize='-O', ld='gcc'
 560     cppflags=''
 561     ccflags =''
 562     ldflags =''
 563     stdchar='unsigned char', d_stdstdio=define, usevfork=false
 564     voidflags=15, castflags=0, d_casti32=define, d_castneg=define
 565     intsize=4, alignbytes=8, usemymalloc=y, randbits=15
 566   Libraries:
 567     so=so
 568     libpth=/lib /usr/lib /usr/ccs/lib /usr/local/lib
 569     libs=-lsocket -lnsl -ldl -lm -lc -lcrypt
 570     libc=/usr/lib/libc.so
 571   Dynamic Linking:
 572     dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef
 573     cccdlflags='-fpic', ccdlflags=' ', lddlflags='-G'
 574
 575
 576 Dean
 577 roehrich@cray.com
 578 9/7/95
 579
 580 -----------
 581
 582 From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
 583 Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
 584 Date: 25 Jul 1995 12:20:18 GMT
 585
 586 5.7) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
 587
 588     You're using gcc without properly installing the gcc fixed
 589     include files.  Or you ran fixincludes after installing gcc
 590     w/o moving the gcc supplied varargs.h and stdarg.h files
 591     out of the way and moving them back again later.  This often
 592     happens when people install gcc from a binary distribution.
 593     If there's a tmp directory in gcc's include directory, fixincludes
 594     didn't complete.  You should have run "just-fixinc" instead.
 595
 596     Another possible cause is using ``gcc -I/usr/include.''
 597
 598 6.1) Where is the C compiler or where can I get one?
 599
 600     [...]
 601
 602     3) Gcc.
 603
 604     Gcc is available from the GNU archives in source and binary
 605     form.  Look in a directory called sparc-sun-solaris2 for
 606     binaries.  You need gcc 2.3.3 or later.  You should not use
 607     GNU as or GNU ld.  Make sure you run just-fixinc if you use
 608     a binary distribution.  Better is to get a binary version and
 609     use that to bootstrap gcc from source.
 610
 611     [...]
 612
 613     When you install gcc, don't make the mistake of installing
 614     GNU binutils or GNU libc, they are not as capable as their
 615     counterparts you get with Solaris 2.x.
 616
 617 6.9) I can't get perl 4.036 to compile or run.
 618
 619     Run Configure, and use the solaris_2_0 hints, *don't* use
 620     the solaris_2_1 hints and don't use the config.sh you may
 621     already have.  First you must make sure Configure and make
 622     don't find /usr/ucb/cc.  (It must use gcc or the native C
 623     compiler: /opt/SUNWspro/bin/cc)
 624
 625     Some questions need a special answer.
 626
 627     Are your system (especially dbm) libraries compiled with gcc? [y] y
 628
 629     yes: gcc 2.3.3 or later uses the standard calling
 630     conventions, same as Sun's C.
 631
 632     Any additional cc flags? [ -traditional -Dvolatile=__volatile__
 633     -I/usr/ucbinclude] -traditional -Dvolatile=__volatile__
 634     Remove /usr/ucbinclude.
 635
 636     Any additional libraries? [-lsocket -lnsl -ldbm -lmalloc -lm
 637     -lucb] -lsocket -lnsl  -lm
 638
 639     Don't include -ldbm, -lmalloc and -lucb.
 640
 641     Perl 5 compiled out of the box.
 642
 643 7.0) 64-bitness, from Alan Burlison (added by jhi 2000-02-21)
 644
 645   You need a machine running Solaris 2.7 or above.
 646
 647   Here's some rules:
 648
 649   1. Solaris 2.7 and above will run in either 32 bit or 64 bit mode,
 650      via a reboot.
 651   2. You can build 64 bit apps whilst running 32 bit mode and vice-versa.
 652   3. 32 bit apps will run under Solaris running in either 32 or 64 bit mode.
 653   4. 64 bit apps require Solaris to be running 64 bit mode
 654   5. It is possible to select the appropriate 32 or 64 bit version of an
 655      app at run-time using isaexec(3).
 656   6. You can detect the OS mode using "isainfo -v", e.g.
 657       fubar$ isainfo -v   # Ultra 30 in 64 bit mode
 658       64-bit sparcv9 applications
 659       32-bit sparc applications
 660   7. To compile 64 bit you need to use the flag "-xarch=v9".
 661      getconf(1) will tell you this, e.g.
 662       fubar$ getconf -a | grep v9
 663       XBS5_LP64_OFF64_CFLAGS:         -xarch=v9
 664       XBS5_LP64_OFF64_LDFLAGS:        -xarch=v9
 665       XBS5_LP64_OFF64_LINTFLAGS:      -xarch=v9
 666       XBS5_LPBIG_OFFBIG_CFLAGS:       -xarch=v9
 667       XBS5_LPBIG_OFFBIG_LDFLAGS:      -xarch=v9
 668       XBS5_LPBIG_OFFBIG_LINTFLAGS:    -xarch=v9
 669       _XBS5_LP64_OFF64_CFLAGS:        -xarch=v9
 670       _XBS5_LP64_OFF64_LDFLAGS:       -xarch=v9
 671       _XBS5_LP64_OFF64_LINTFLAGS:     -xarch=v9
 672       _XBS5_LPBIG_OFFBIG_CFLAGS:      -xarch=v9
 673       _XBS5_LPBIG_OFFBIG_LDFLAGS:     -xarch=v9
 674       _XBS5_LPBIG_OFFBIG_LINTFLAGS:   -xarch=v9
 675
 676   > > Now, what should we do, then?  Should -Duse64bits in a v9 box cause
 677   > > Perl to compiled in v9 mode?  Or should we for compatibility stick
 678   > > with 32 bit builds and let the people in the know to add the -xarch=v9
 679   > > to ccflags (and ldflags?)?
 680
 681   > I think the second (explicit) mechanism should be the default.  Unless
 682   > you want to allocate more than ~ 4Gb of memory inside Perl, you don't
 683   > need Perl to be a 64-bit app.  Put it this way, on a machine running
 684   > Solaris 8, there are 463 executables under /usr/bin, but only 15 of
 685   > those require 64 bit versions - mainly because they invade the kernel
 686   > address space, e.g. adb, kgmon etc.  Certainly we don't recommend users
 687   > to build 64 bit apps unless they need the address space.
 688
 689 End_of_Solaris_Notes
 690