This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
PATCH: 5.005_56: perldata.pod (UPDATE)
[perl5.git] / hints / solaris_2.sh
CommitLineData
8e07c86e 1# hints/solaris_2.sh
bd89102f 2# Last modified: Wed May 27 13:04:45 EDT 1998
8e07c86e
AD
3# Andy Dougherty <doughera@lafcol.lafayette.edu>
4# Based on input from lots of folks, especially
5# Dean Roehrich <roehrich@ironwood-fddi.cray.com>
7beaa944
AD
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#
a81c337c 13
8e07c86e 14# See man vfork.
a0d0e21e 15usevfork=false
b1db1e90 16
a0d0e21e 17d_suidsafe=define
b1db1e90 18
8e07c86e 19# Avoid all libraries in /usr/ucblib.
a0d0e21e
LW
20set `echo $glibpth | sed -e 's@/usr/ucblib@@'`
21glibpth="$*"
b1db1e90 22
40000a8c
AD
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>
29set `echo " $libswanted " | sed -e 's@ ld @ @' -e 's@ malloc @ @' -e 's@ ucb @ @'`
a0d0e21e
LW
30libswanted="$*"
31
b1db1e90 32# Look for architecture name. We want to suggest a useful default.
a0d0e21e
LW
33case "$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 ;;
43esac
a0d0e21e 44
b1db1e90
PP
45######################################################
46# General sanity testing. See below for excerpts from the Solaris FAQ.
8e07c86e
AD
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
bd89102f
AD
56case `type ${cc:-cc}` in
57*/usr/ucb/cc*) cat <<END >&4
8e07c86e 58
a0d0e21e 59NOTE: Some people have reported problems with /usr/ucb/cc.
bd89102f
AD
60If you have difficulties, please make sure the directory
61containing your C compiler is before /usr/ucb in your PATH.
8e07c86e
AD
62
63END
64;;
65esac
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
71case $? in
720) ;;
73*)
68dc0745 74 cat <<END >&4
8e07c86e
AD
75
76NOTE: Your system does not have /dev/fd mounted. If you want to
77be able to use set-uid scripts you must ask your system administrator
78to mount /dev/fd.
79
80END
81 ;;
82esac
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
88case $? in
890)
68dc0745 90 cat <<END >&4
8e07c86e
AD
91
92NOTE: libucb has been found in /usr/lib. libucb should reside in
93/usr/ucblib. You may have trouble while building Perl extensions.
94
a0d0e21e
LW
95END
96;;
97esac
40000a8c 98
bd89102f
AD
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'
8e07c86e
AD
108
109# See if make(1) is GNU make(1).
110# If it is, make sure the setgid bit is not set.
111make -v > make.vers 2>&1
112if grep GNU make.vers > /dev/null 2>&1; then
bd89102f
AD
113 tmp=`type make | awk '{print $NF}' | sed 's/[()]//g'`
114 case "`/usr/bin/ls -lL $tmp`" in
8e07c86e 115 ??????s*)
68dc0745 116 cat <<END >&2
8e07c86e
AD
117
118NOTE: Your PATH points to GNU make, and your GNU make has the set-group-id
119bit set. You must either rearrange your PATH to put /usr/ccs/bin before the
120GNU utilities or you must ask your system administrator to disable the
121set-group-id bit on GNU make.
122
123END
124 ;;
125 esac
126fi
127rm -f make.vers
128
693762b4
AD
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.
132cat > UU/cc.cbu <<'EOSH'
8e07c86e
AD
133# If the C compiler is gcc:
134# - check the fixed-includes
135# - check as(1) and ld(1), they should not be GNU
bd89102f 136# (GNU as and ld 2.8.1 and later are reportedly ok, however.)
8e07c86e
AD
137# If the C compiler is not gcc:
138# - check as(1) and ld(1), they should not be GNU
bd89102f 139# (GNU as and ld 2.8.1 and later are reportedly ok, however.)
8e07c86e
AD
140#
141# Watch out in case they have not set $cc.
1acf53c5
SZ
142
143# Get gcc to share its secrets.
144echo 'main() { return 0; }' > try.c
bd89102f
AD
145 # Indent to avoid propagation to config.sh
146 verbose=`${cc:-cc} -v -o try try.c 2>&1`
1acf53c5
SZ
147
148if echo "$verbose" | grep '^Reading specs from' >/dev/null 2>&1; then
8e07c86e
AD
149 #
150 # Using gcc.
151 #
152 #echo Using gcc
153
8e07c86e
AD
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.
cee5ebb5 158 # Doesn't work anymore for gcc-2.7.2.
8e07c86e
AD
159
160 # See if as(1) is GNU as(1). GNU as(1) won't work for this job.
1acf53c5
SZ
161 if echo "$verbose" | grep ' /usr/ccs/bin/as ' >/dev/null 2>&1; then
162 :
163 else
68dc0745 164 cat <<END >&2
8e07c86e
AD
165
166NOTE: You are using GNU as(1). GNU as(1) will not build Perl.
bd89102f
AD
167I'm arranging to use /usr/ccs/bin/as by including -B/usr/ccs/bin/
168in your ${cc:-cc} command. (Note that the trailing "/" is required.)
8e07c86e
AD
169
170END
1acf53c5
SZ
171 cc="${cc:-cc} -B/usr/ccs/bin/"
172 fi
8e07c86e
AD
173
174 # See if ld(1) is GNU ld(1). GNU ld(1) won't work for this job.
bd89102f 175 # Recompute $verbose since we may have just changed $cc.
d5fdf557 176 verbose=`${cc:-cc} -v -o try try.c 2>&1 | grep ld 2>&1`
bd89102f 177 if echo "$verbose" | grep ' /usr/ccs/bin/ld ' >/dev/null 2>&1; then
1acf53c5
SZ
178 :
179 else
d5fdf557
TS
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
193Aha. You're using egcs and /usr/ccs/bin/ld.
194
195END
196
197 else
68dc0745 198 cat <<END >&2
8e07c86e 199
bd89102f
AD
200NOTE: You are using GNU ld(1). GNU ld(1) will not build Perl.
201I'm arranging to use /usr/ccs/bin/ld by including -B/usr/ccs/bin/
202in your ${cc:-cc} command. (Note that the trailing "/" is required.)
8e07c86e
AD
203
204END
1acf53c5 205 cc="${cc:-cc} -B/usr/ccs/bin/"
d5fdf557 206 fi
1acf53c5 207 fi
8e07c86e 208
1acf53c5 209else
8e07c86e
AD
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*)
68dc0745 218 cat <<END >&2
8e07c86e
AD
219
220NOTE: You are using GNU as(1). GNU as(1) will not build Perl.
bd89102f
AD
221You must arrange to use /usr/ccs/bin/as, perhaps by adding /usr/ccs/bin
222to the beginning of your PATH.
8e07c86e
AD
223
224END
225 ;;
226 esac
227
228 # See if ld(1) is GNU ld(1). GNU ld(1) won't work for this job.
91d1e749
PP
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
8e07c86e 232 case `ld --version < /dev/null 2>&1` in
91d1e749
PP
233 *GNU*|ld\ version\ 2*)
234 gnu_ld=true ;;
235 *) ;;
236 esac
237 if $gnu_ld ; then :
238 else
bd89102f
AD
239 # Try to guess from path
240 case `type ld | awk '{print $NF}'` in
241 *gnu*|*GNU*|*FSF*)
91d1e749
PP
242 gnu_ld=true ;;
243 esac
244 fi
245 if $gnu_ld ; then
68dc0745 246 cat <<END >&2
8e07c86e 247
bd89102f
AD
248NOTE: You are apparently using GNU ld(1). GNU ld(1) will not build Perl.
249You must arrange to use /usr/ccs/bin/ld, perhaps by adding /usr/ccs/bin
250to the beginning of your PATH.
8e07c86e
AD
251
252END
91d1e749 253 fi
8e07c86e 254
1acf53c5 255fi
8e07c86e
AD
256
257# as --version or ld --version might dump core.
bd89102f 258rm -f try try.c
8e07c86e
AD
259rm -f core
260
693762b4
AD
261# XXX
262EOSH
263
104d25b7
JH
264# This script UU/usethreads.cbu will get 'called-back' by Configure
265# after it has prompted the user for whether to use threads.
266cat > UU/usethreads.cbu <<'EOCBU'
267case "$usethreads" in
268$define|true|[yY]*)
104d25b7
JH
269 ccflags="-D_REENTRANT $ccflags"
270
271 # sched_yield is in -lposix4
272 set `echo X "$libswanted "| sed -e 's/ c / posix4 pthread c /'`
273 shift
274 libswanted="$*"
275
276 # On Solaris 2.6 x86 there is a bug with sigsetjmp() and siglongjmp()
277 # when linked with the threads library, such that whatever positive
278 # value you pass to siglongjmp(), sigsetjmp() returns 1.
279 # Thanks to Simon Parsons <S.Parsons@ftel.co.uk> for this report.
280 # Sun BugID is 4117946, "sigsetjmp always returns 1 when called by
281 # siglongjmp in a MT program". As of 19980622, there is no patch
282 # available.
283 cat >try.c <<'EOM'
284 /* Test for sig(set|long)jmp bug. */
285 #include <setjmp.h>
286
287 main()
288 {
289 sigjmp_buf env;
290 int ret;
291
292 ret = sigsetjmp(env, 1);
293 if (ret) { return ret == 2; }
294 siglongjmp(env, 2);
295 }
296EOM
297 if test "`arch`" = i86pc -a "$osvers" = 2.6 && \
298 ${cc:-cc} try.c -lpthread >/dev/null 2>&1 && ./a.out; then
299 d_sigsetjmp=$undef
300 cat << 'EOM' >&2
301
302You will see a *** WHOA THERE!!! *** message from Configure for
303d_sigsetjmp. Keep the recommended value. See hints/solaris_2.sh
304for more information.
305
306EOM
307 fi
308 ;;
123f9af1 309esac
104d25b7
JH
310EOCBU
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.
314cat > UU/use64bits.cbu <<'EOCBU'
315case "$use64bits" in
316$define|true|[yY]*)
317 case "`uname -r`" in
318 2.[1-5])
319 cat >&4 <<EOM
320Solaris `uname -r` does not support 64-bit interfaces.
321You should upgrade to at least Solaris 2.6.
322EOM
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 ;;
332esac
333EOCBU
334
8e07c86e
AD
335# This is just a trick to include some useful notes.
336cat > /dev/null <<'End_of_Solaris_Notes'
337
338Here are some notes kindly contributed by Dean Roehrich.
339
340-----
341Generic 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
354Here are the gcc-related questions and answers from the Solaris 2 FAQ. Note
355the themes:
356 - run fixincludes
357 - run fixincludes correctly
358 - don't use GNU as or GNU ld
359
360Question 5.7 covers the __builtin_va_alist problem people are always seeing.
361Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
362people.
363Question 6.9 is for those who are still trying to compile Perl4.
364
365The 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
369Perl5 comes with a script in the top-level directory called "myconfig" which
370will print a summary of the configuration in your config.sh. My summary for
371Solaris 2.4 and gcc 2.6.3 follows. I have also built with gcc 2.7.0 and the
372results are identical. This configuration was generated with Configure's -d
373option (take all defaults, don't bother prompting me). All tests pass for
374Perl5.001, patch.1m.
375
376Summary 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
399Dean
400roehrich@cray.com
4019/7/95
402
403-----------
404
405From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
406Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
407Date: 25 Jul 1995 12:20:18 GMT
408
4095.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
4216.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
4406.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
466End_of_Solaris_Notes
467