This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
NetBSD update, based on patches from the NetBSD packages system.
[perl5.git] / hints / solaris_2.sh
1 # hints/solaris_2.sh
2 # Last modified:  Wed May 27 13:04:45 EDT 1998
3 # Andy Dougherty  <doughera@lafcol.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  
14 # See man vfork.
15 usevfork=false
16
17 d_suidsafe=define
18
19 # Avoid all libraries in /usr/ucblib.
20 set `echo $glibpth | sed -e 's@/usr/ucblib@@'`
21 glibpth="$*"
22
23 # Remove bad libraries.  -lucb contains incompatible routines.
24 # -lld doesn't do anything useful.
25 # -lmalloc can cause a problem with GNU CC & Solaris.  Specifically,
26 # libmalloc.a may allocate memory that is only 4 byte aligned, but
27 # GNU CC on the Sparc assumes that doubles are 8 byte aligned.
28 # Thanks to  Hallvard B. Furuseth <h.b.furuseth@usit.uio.no>
29 set `echo " $libswanted " | sed -e 's@ ld @ @' -e 's@ malloc @ @' -e 's@ ucb @ @'`
30 libswanted="$*"
31
32 # Look for architecture name.  We want to suggest a useful default.
33 case "$archname" in
34 '')
35     if test -f /usr/bin/arch; then
36         archname=`/usr/bin/arch`
37         archname="${archname}-${osname}"
38     elif test -f /usr/ucb/arch; then
39         archname=`/usr/ucb/arch`
40         archname="${archname}-${osname}"
41     fi
42     ;;
43 esac
44
45 ######################################################
46 # General sanity testing.  See below for excerpts from the Solaris FAQ.
47
48 # From roehrich@ironwood-fddi.cray.com Wed Sep 27 12:51:46 1995
49 # Date: Thu, 7 Sep 1995 16:31:40 -0500
50 # From: Dean Roehrich <roehrich@ironwood-fddi.cray.com>
51 # To: perl5-porters@africa.nicoh.com
52 # Subject: Re: On perl5/solaris/gcc
53
54 # Here's another draft of the perl5/solaris/gcc sanity-checker. 
55
56 case `type ${cc:-cc}` in
57 */usr/ucb/cc*) cat <<END >&4
58
59 NOTE:  Some people have reported problems with /usr/ucb/cc.  
60 If you have difficulties, please make sure the directory
61 containing your C compiler is before /usr/ucb in your PATH.
62
63 END
64 ;;
65 esac
66
67
68 # Check that /dev/fd is mounted.  If it is not mounted, let the
69 # user know that suid scripts may not work.
70 /usr/bin/df /dev/fd 2>&1 > /dev/null
71 case $? in
72 0) ;;
73 *)
74         cat <<END >&4
75
76 NOTE: Your system does not have /dev/fd mounted.  If you want to
77 be able to use set-uid scripts you must ask your system administrator
78 to mount /dev/fd.
79
80 END
81         ;;
82 esac
83
84
85 # See if libucb can be found in /usr/lib.  If it is, warn the user
86 # that this may cause problems while building Perl extensions.
87 /usr/bin/ls /usr/lib/libucb* >/dev/null 2>&1
88 case $? in
89 0)
90         cat <<END >&4
91
92 NOTE: libucb has been found in /usr/lib.  libucb should reside in
93 /usr/ucblib.  You may have trouble while building Perl extensions.
94
95 END
96 ;;
97 esac
98
99 # Use shell built-in 'type' command instead of /usr/bin/which to
100 # avoid possible csh start-up problems and also to use the same shell
101 # we'll be using to Configure and make perl.
102 # The path name is the last field in the output, but the type command
103 # has an annoying array of possible outputs, e.g.:
104 #       make is hashed (/opt/gnu/bin/make)
105 #       cc is /usr/ucb/cc
106 #       foo not found
107 # use a command like type make | awk '{print $NF}' | sed 's/[()]//g'
108
109 # See if make(1) is GNU make(1).
110 # If it is, make sure the setgid bit is not set.
111 make -v > make.vers 2>&1
112 if grep GNU make.vers > /dev/null 2>&1; then
113     tmp=`type make | awk '{print $NF}' | sed 's/[()]//g'`
114     case "`/usr/bin/ls -lL $tmp`" in
115     ??????s*)
116             cat <<END >&2
117         
118 NOTE: Your PATH points to GNU make, and your GNU make has the set-group-id
119 bit set.  You must either rearrange your PATH to put /usr/ccs/bin before the
120 GNU utilities or you must ask your system administrator to disable the
121 set-group-id bit on GNU make.
122
123 END
124             ;;
125     esac
126 fi
127 rm -f make.vers
128
129 # XXX EXPERIMENTAL  A.D.  2/27/1998
130 # XXX This script UU/cc.cbu will get 'called-back' by Configure after it
131 # XXX has prompted the user for the C compiler to use.
132 cat > UU/cc.cbu <<'EOSH'
133 # If the C compiler is gcc:
134 #   - check the fixed-includes
135 #   - check as(1) and ld(1), they should not be GNU
136 #       (GNU as and ld 2.8.1 and later are reportedly ok, however.)
137 # If the C compiler is not gcc:
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 #
141 # Watch out in case they have not set $cc.
142
143 # Get gcc to share its secrets.
144 echo 'main() { return 0; }' > try.c
145         # Indent to avoid propagation to config.sh
146         verbose=`${cc:-cc} -v -o try try.c 2>&1`
147
148 if echo "$verbose" | grep '^Reading specs from' >/dev/null 2>&1; then
149         #
150         # Using gcc.
151         #
152         #echo Using gcc
153
154         tmp=`echo "$verbose" | grep '^Reading' |
155                 awk '{print $NF}'  | sed 's/specs$/include/'`
156
157         # Determine if the fixed-includes look like they'll work.
158         # Doesn't work anymore for gcc-2.7.2.
159
160         # See if as(1) is GNU as(1).  GNU as(1) won't work for this job.
161         if echo "$verbose" | grep ' /usr/ccs/bin/as ' >/dev/null 2>&1; then
162             :
163         else
164             cat <<END >&2
165
166 NOTE: You are using GNU as(1).  GNU as(1) will not build Perl.
167 I'm arranging to use /usr/ccs/bin/as by including -B/usr/ccs/bin/
168 in your ${cc:-cc} command.  (Note that the trailing "/" is required.)
169
170 END
171             cc="${cc:-cc} -B/usr/ccs/bin/"
172         fi
173
174         # See if ld(1) is GNU ld(1).  GNU ld(1) won't work for this job.
175         # Recompute $verbose since we may have just changed $cc.
176         verbose=`${cc:-cc} -v -o try try.c 2>&1 | grep ld 2>&1`
177         if echo "$verbose" | grep ' /usr/ccs/bin/ld ' >/dev/null 2>&1; then
178             :
179         else
180         # It's not /usr/ccs/bin/ld - but it might be egcs's ld wrapper,
181         # which calls /usr/ccs/bin/ld in turn. Passing -V to it will
182         # make it show its true colors.
183
184             myld=`echo $verbose| grep ld | awk '/\/ld/ {print $1}'`
185             # This assumes that gcc's output will not change, and that
186             # /full/path/to/ld will be the first word of the output.
187
188             # all Solaris versions of ld I've seen contain the magic
189             # string used in the grep below.
190             if $myld -V 2>&1 | grep "ld: Software Generation Utilities" >/dev/null 2>&1; then
191                 cat <<END >&2
192
193 Aha. You're using egcs and /usr/ccs/bin/ld.
194
195 END
196
197             else
198             cat <<END >&2
199
200 NOTE: You are using GNU ld(1).  GNU ld(1) will not build Perl.
201 I'm arranging to use /usr/ccs/bin/ld by including -B/usr/ccs/bin/
202 in your ${cc:-cc} command.  (Note that the trailing "/" is required.)
203
204 END
205             cc="${cc:-cc} -B/usr/ccs/bin/"
206             fi
207         fi
208
209 else
210         #
211         # Not using gcc.
212         #
213         #echo Not using gcc
214
215         # See if as(1) is GNU as(1).  GNU as(1) won't work for this job.
216         case `as --version < /dev/null 2>&1` in
217         *GNU*)
218                 cat <<END >&2
219
220 NOTE: You are using GNU as(1).  GNU as(1) will not build Perl.
221 You must arrange to use /usr/ccs/bin/as, perhaps by adding /usr/ccs/bin
222 to the beginning of your PATH.
223
224 END
225                 ;;
226         esac
227
228         # See if ld(1) is GNU ld(1).  GNU ld(1) won't work for this job.
229         # ld --version doesn't properly report itself as a GNU tool,
230         # as of ld version 2.6, so we need to be more strict. TWP 9/5/96
231         gnu_ld=false
232         case `ld --version < /dev/null 2>&1` in
233         *GNU*|ld\ version\ 2*)
234                 gnu_ld=true ;;
235         *) ;;
236         esac
237         if $gnu_ld ; then :
238         else
239                 # Try to guess from path
240                 case `type ld | awk '{print $NF}'` in
241                 *gnu*|*GNU*|*FSF*)
242                         gnu_ld=true ;;
243                 esac
244         fi
245         if $gnu_ld ; then
246                 cat <<END >&2
247
248 NOTE: You are apparently using GNU ld(1).  GNU ld(1) will not build Perl.
249 You must arrange to use /usr/ccs/bin/ld, perhaps by adding /usr/ccs/bin
250 to the beginning of your PATH.
251
252 END
253         fi
254
255 fi
256
257 # as --version or ld --version might dump core.
258 rm -f try try.c
259 rm -f core
260
261 # XXX
262 EOSH
263
264 # This script UU/usethreads.cbu will get 'called-back' by Configure 
265 # after it has prompted the user for whether to use threads.
266 cat > UU/usethreads.cbu <<'EOCBU'
267 case "$usethreads" in
268 $define|true|[yY]*)
269 esac
270         ccflags="-D_REENTRANT $ccflags"
271
272         # sched_yield is in -lposix4
273         set `echo X "$libswanted "| sed -e 's/ c / posix4 pthread c /'`
274         shift
275         libswanted="$*"
276
277         # On Solaris 2.6 x86 there is a bug with sigsetjmp() and siglongjmp()
278         # when linked with the threads library, such that whatever positive
279         # value you pass to siglongjmp(), sigsetjmp() returns 1.
280         # Thanks to Simon Parsons <S.Parsons@ftel.co.uk> for this report.
281         # Sun BugID is 4117946, "sigsetjmp always returns 1 when called by
282         # siglongjmp in a MT program". As of 19980622, there is no patch
283         # available.
284         cat >try.c <<'EOM'
285         /* Test for sig(set|long)jmp bug. */
286         #include <setjmp.h>
287          
288         main()
289         {
290             sigjmp_buf env;
291             int ret;
292         
293             ret = sigsetjmp(env, 1);
294             if (ret) { return ret == 2; }
295             siglongjmp(env, 2);
296         }
297 EOM
298         if test "`arch`" = i86pc -a "$osvers" = 2.6 && \
299            ${cc:-cc} try.c -lpthread >/dev/null 2>&1 && ./a.out; then
300             d_sigsetjmp=$undef
301             cat << 'EOM' >&2
302
303 You will see a *** WHOA THERE!!! ***  message from Configure for
304 d_sigsetjmp.  Keep the recommended value.  See hints/solaris_2.sh
305 for more information.
306
307 EOM
308         fi
309         ;;
310 EOCBU
311
312 # This script UU/use64bits.cbu will get 'called-back' by Configure 
313 # after it has prompted the user for whether to use 64 bits.
314 cat > UU/use64bits.cbu <<'EOCBU'
315 case "$use64bits" in
316 $define|true|[yY]*)
317             case "`uname -r`" in
318             2.[1-5])
319                 cat >&4 <<EOM
320 Solaris `uname -r` does not support 64-bit interfaces.
321 You should upgrade to at least Solaris 2.6.
322 EOM
323                 exit 1
324                 ;;
325             esac
326             ccflags="$ccflags `getconf LFS_CFLAGS` -DUSE_LONG_LONG"
327             ldflags="$ldflags `getconf LFS_LDFLAGS`"
328             libswanted="$libswanted `getconf LFS_LIBS`"
329             # When a 64-bit cc becomes available $archname64
330             # may need setting so that $archname gets it attached.
331             ;;
332 esac
333 EOCBU
334
335 # This is just a trick to include some useful notes.
336 cat > /dev/null <<'End_of_Solaris_Notes'
337
338 Here are some notes kindly contributed by Dean Roehrich.
339
340 -----
341 Generic notes about building Perl5 on Solaris:
342 - Use /usr/ccs/bin/make.
343 - If you use GNU make, remove its setgid bit.
344 - Remove all instances of *ucb* from your path.
345 - Make sure libucb is not in /usr/lib (it should be in /usr/ucblib).
346 - Do not use GNU as or GNU ld, or any of GNU binutils or GNU libc.
347 - Do not use /usr/ucb/cc.
348 - Do not change Configure's default answers, except for the path names.
349 - Do not use -lmalloc.
350 - Do not build on SunOS 4 and expect it to work properly on SunOS 5.
351 - /dev/fd must be mounted if you want set-uid scripts to work.
352
353
354 Here are the gcc-related questions and answers from the Solaris 2 FAQ.  Note
355 the themes:
356         - run fixincludes
357         - run fixincludes correctly
358         - don't use GNU as or GNU ld
359
360 Question 5.7 covers the __builtin_va_alist problem people are always seeing.
361 Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
362 people.
363 Question 6.9 is for those who are still trying to compile Perl4.
364
365 The latest Solaris 2 FAQ can be found in the following locations:
366         rtfm.mit.edu:/pub/usenet-by-group/comp.sys.sun.admin
367         ftp.fwi.uva.nl:/pub/solaris
368
369 Perl5 comes with a script in the top-level directory called "myconfig" which
370 will print a summary of the configuration in your config.sh.  My summary for
371 Solaris 2.4 and gcc 2.6.3 follows.  I have also built with gcc 2.7.0 and the
372 results are identical.  This configuration was generated with Configure's -d
373 option (take all defaults, don't bother prompting me).  All tests pass for
374 Perl5.001, patch.1m.
375
376 Summary of my perl5 (patchlevel 1) configuration:
377   Platform:
378     osname=solaris, osver=2.4, archname=sun4-solaris
379     uname='sunos poplar 5.4 generic_101945-27 sun4d sparc '
380     hint=recommended
381   Compiler:
382     cc='gcc', optimize='-O', ld='gcc'
383     cppflags=''
384     ccflags =''
385     ldflags =''
386     stdchar='unsigned char', d_stdstdio=define, usevfork=false
387     voidflags=15, castflags=0, d_casti32=define, d_castneg=define
388     intsize=4, alignbytes=8, usemymalloc=y, randbits=15
389   Libraries:
390     so=so
391     libpth=/lib /usr/lib /usr/ccs/lib /usr/local/lib
392     libs=-lsocket -lnsl -ldl -lm -lc -lcrypt
393     libc=/usr/lib/libc.so
394   Dynamic Linking:
395     dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef
396     cccdlflags='-fpic', ccdlflags=' ', lddlflags='-G'
397
398
399 Dean
400 roehrich@cray.com
401 9/7/95
402
403 -----------
404
405 From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
406 Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
407 Date: 25 Jul 1995 12:20:18 GMT
408
409 5.7) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
410
411     You're using gcc without properly installing the gcc fixed
412     include files.  Or you ran fixincludes after installing gcc
413     w/o moving the gcc supplied varargs.h and stdarg.h files
414     out of the way and moving them back again later.  This often
415     happens when people install gcc from a binary distribution.
416     If there's a tmp directory in gcc's include directory, fixincludes
417     didn't complete.  You should have run "just-fixinc" instead.
418
419     Another possible cause is using ``gcc -I/usr/include.''
420
421 6.1) Where is the C compiler or where can I get one?
422
423     [...]
424
425     3) Gcc.
426
427     Gcc is available from the GNU archives in source and binary
428     form.  Look in a directory called sparc-sun-solaris2 for
429     binaries.  You need gcc 2.3.3 or later.  You should not use
430     GNU as or GNU ld.  Make sure you run just-fixinc if you use
431     a binary distribution.  Better is to get a binary version and
432     use that to bootstrap gcc from source.
433
434     [...]
435
436     When you install gcc, don't make the mistake of installing
437     GNU binutils or GNU libc, they are not as capable as their
438     counterparts you get with Solaris 2.x.
439
440 6.9) I can't get perl 4.036 to compile or run.
441
442     Run Configure, and use the solaris_2_0 hints, *don't* use
443     the solaris_2_1 hints and don't use the config.sh you may
444     already have.  First you must make sure Configure and make
445     don't find /usr/ucb/cc.  (It must use gcc or the native C
446     compiler: /opt/SUNWspro/bin/cc)
447
448     Some questions need a special answer.
449
450     Are your system (especially dbm) libraries compiled with gcc? [y] y
451
452     yes: gcc 2.3.3 or later uses the standard calling
453     conventions, same as Sun's C.
454
455     Any additional cc flags? [ -traditional -Dvolatile=__volatile__
456     -I/usr/ucbinclude] -traditional -Dvolatile=__volatile__
457     Remove /usr/ucbinclude.
458
459     Any additional libraries? [-lsocket -lnsl -ldbm -lmalloc -lm
460     -lucb] -lsocket -lnsl  -lm
461
462     Don't include -ldbm, -lmalloc and -lucb.
463
464     Perl 5 compiled out of the box.
465
466 End_of_Solaris_Notes
467