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 # This script UU/usethreads.cbu will get 'called-back' by Configure
 289 # after it has prompted the user for whether to use threads.
 290 cat > UU/usethreads.cbu <<'EOCBU'
 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 # This script UU/uselfs.cbu will get 'called-back' by Configure
 337 # after it has prompted the user for whether to use large files.
 338 cat > UU/uselfs.cbu <<'EOCBU'
 339 case "$uselargefiles" in
 340 $define|true|[yY]*)
 341         lfcflags="`getconf LFS_CFLAGS 2>/dev/null`"
 342         lfldflags="`getconf LFS_LDFLAGS 2>/dev/null`"
 343         lflibs="`getconf LFS_LIBS 2>/dev/null|sed -e 's@^-l@@' -e 's@ -l@ @g`"
 344         case "$lfcflags$lfldflags$lflibs" in
 345         '');;
 346         *) uselonglong="$define"
 347            echo "(Large files in Solaris require also long longs, using long longs...)"
 348            ccflags="$ccflags -DUSE_LONG_LONG $lfcflags"
 349            ldflags="$ldflags $ldldflags"
 350            libswanted="$libswanted $lflibs"
 351            ;;
 352         esac
 353         lfcflags=''
 354         lfldflags=''
 355         lflibs=''
 356         ;;
 357 esac
 358 EOCBU
 359
 360 # This script UU/use64bits.cbu will get 'called-back' by Configure
 361 # after it has prompted the user for whether to use 64 bits.
 362 cat > UU/use64bits.cbu <<'EOCBU'
 363 case "$use64bits" in
 364 $define|true|[yY]*)
 365             case "`uname -r`" in
 366             2.[1-5])
 367                 cat >&4 <<EOM
 368 Solaris `uname -r` does not support 64-bit interfaces.
 369 You should upgrade to at least Solaris 2.6.
 370 EOM
 371                 exit 1
 372                 ;;
 373             esac
 374             case "$ccflags" in
 375             *-DUSE_LONG_LONG*) ;;
 376             *) ccflags="$ccflags -DUSE_LONG_LONG" ;;
 377             esac
 378             # When a 64-bit cc becomes available $archname64
 379             # may need setting so that $archname gets it attached.
 380             ;;
 381 esac
 382 EOCBU
 383
 384 # This is just a trick to include some useful notes.
 385 cat > /dev/null <<'End_of_Solaris_Notes'
 386
 387 Here are some notes kindly contributed by Dean Roehrich.
 388
 389 -----
 390 Generic notes about building Perl5 on Solaris:
 391 - Use /usr/ccs/bin/make.
 392 - If you use GNU make, remove its setgid bit.
 393 - Remove all instances of *ucb* from your path.
 394 - Make sure libucb is not in /usr/lib (it should be in /usr/ucblib).
 395 - Do not use GNU as or GNU ld, or any of GNU binutils or GNU libc.
 396 - Do not use /usr/ucb/cc.
 397 - Do not change Configure's default answers, except for the path names.
 398 - Do not use -lmalloc.
 399 - Do not build on SunOS 4 and expect it to work properly on SunOS 5.
 400 - /dev/fd must be mounted if you want set-uid scripts to work.
 401
 402
 403 Here are the gcc-related questions and answers from the Solaris 2 FAQ.  Note
 404 the themes:
 405         - run fixincludes
 406         - run fixincludes correctly
 407         - don't use GNU as or GNU ld
 408
 409 Question 5.7 covers the __builtin_va_alist problem people are always seeing.
 410 Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
 411 people.
 412 Question 6.9 is for those who are still trying to compile Perl4.
 413
 414 The latest Solaris 2 FAQ can be found in the following locations:
 415         rtfm.mit.edu:/pub/usenet-by-group/comp.sys.sun.admin
 416         ftp.fwi.uva.nl:/pub/solaris
 417
 418 Perl5 comes with a script in the top-level directory called "myconfig" which
 419 will print a summary of the configuration in your config.sh.  My summary for
 420 Solaris 2.4 and gcc 2.6.3 follows.  I have also built with gcc 2.7.0 and the
 421 results are identical.  This configuration was generated with Configure's -d
 422 option (take all defaults, don't bother prompting me).  All tests pass for
 423 Perl5.001, patch.1m.
 424
 425 Summary of my perl5 (patchlevel 1) configuration:
 426   Platform:
 427     osname=solaris, osver=2.4, archname=sun4-solaris
 428     uname='sunos poplar 5.4 generic_101945-27 sun4d sparc '
 429     hint=recommended
 430   Compiler:
 431     cc='gcc', optimize='-O', ld='gcc'
 432     cppflags=''
 433     ccflags =''
 434     ldflags =''
 435     stdchar='unsigned char', d_stdstdio=define, usevfork=false
 436     voidflags=15, castflags=0, d_casti32=define, d_castneg=define
 437     intsize=4, alignbytes=8, usemymalloc=y, randbits=15
 438   Libraries:
 439     so=so
 440     libpth=/lib /usr/lib /usr/ccs/lib /usr/local/lib
 441     libs=-lsocket -lnsl -ldl -lm -lc -lcrypt
 442     libc=/usr/lib/libc.so
 443   Dynamic Linking:
 444     dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef
 445     cccdlflags='-fpic', ccdlflags=' ', lddlflags='-G'
 446
 447
 448 Dean
 449 roehrich@cray.com
 450 9/7/95
 451
 452 -----------
 453
 454 From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
 455 Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
 456 Date: 25 Jul 1995 12:20:18 GMT
 457
 458 5.7) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
 459
 460     You're using gcc without properly installing the gcc fixed
 461     include files.  Or you ran fixincludes after installing gcc
 462     w/o moving the gcc supplied varargs.h and stdarg.h files
 463     out of the way and moving them back again later.  This often
 464     happens when people install gcc from a binary distribution.
 465     If there's a tmp directory in gcc's include directory, fixincludes
 466     didn't complete.  You should have run "just-fixinc" instead.
 467
 468     Another possible cause is using ``gcc -I/usr/include.''
 469
 470 6.1) Where is the C compiler or where can I get one?
 471
 472     [...]
 473
 474     3) Gcc.
 475
 476     Gcc is available from the GNU archives in source and binary
 477     form.  Look in a directory called sparc-sun-solaris2 for
 478     binaries.  You need gcc 2.3.3 or later.  You should not use
 479     GNU as or GNU ld.  Make sure you run just-fixinc if you use
 480     a binary distribution.  Better is to get a binary version and
 481     use that to bootstrap gcc from source.
 482
 483     [...]
 484
 485     When you install gcc, don't make the mistake of installing
 486     GNU binutils or GNU libc, they are not as capable as their
 487     counterparts you get with Solaris 2.x.
 488
 489 6.9) I can't get perl 4.036 to compile or run.
 490
 491     Run Configure, and use the solaris_2_0 hints, *don't* use
 492     the solaris_2_1 hints and don't use the config.sh you may
 493     already have.  First you must make sure Configure and make
 494     don't find /usr/ucb/cc.  (It must use gcc or the native C
 495     compiler: /opt/SUNWspro/bin/cc)
 496
 497     Some questions need a special answer.
 498
 499     Are your system (especially dbm) libraries compiled with gcc? [y] y
 500
 501     yes: gcc 2.3.3 or later uses the standard calling
 502     conventions, same as Sun's C.
 503
 504     Any additional cc flags? [ -traditional -Dvolatile=__volatile__
 505     -I/usr/ucbinclude] -traditional -Dvolatile=__volatile__
 506     Remove /usr/ucbinclude.
 507
 508     Any additional libraries? [-lsocket -lnsl -ldbm -lmalloc -lm
 509     -lucb] -lsocket -lnsl  -lm
 510
 511     Don't include -ldbm, -lmalloc and -lucb.
 512
 513     Perl 5 compiled out of the box.
 514
 515 End_of_Solaris_Notes
 516