744b131fadb203e89c7fc898bc6dab8018f1b687
[p5sagit/p5-mst-13.2.git] / hints / solaris_2.sh
1 # hints/solaris_2.sh
2 # Last modified:  Thu Feb  8 11:38:12 EST 1996
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 $PATH in
57 */usr/ucb*:/usr/bin:*|*/usr/ucb*:/usr/bin) cat <<END >&4
58
59 NOTE:  Some people have reported problems with /usr/ucb/cc.  
60 Remove /usr/ucb from your PATH if you have difficulties.
61
62 END
63 ;;
64 esac
65
66
67 # Check that /dev/fd is mounted.  If it is not mounted, let the
68 # user know that suid scripts may not work.
69 /usr/bin/df /dev/fd 2>&1 > /dev/null
70 case $? in
71 0) ;;
72 *)
73         cat <<END >&4
74
75 NOTE: Your system does not have /dev/fd mounted.  If you want to
76 be able to use set-uid scripts you must ask your system administrator
77 to mount /dev/fd.
78
79 END
80         ;;
81 esac
82
83
84 # See if libucb can be found in /usr/lib.  If it is, warn the user
85 # that this may cause problems while building Perl extensions.
86 /usr/bin/ls /usr/lib/libucb* >/dev/null 2>&1
87 case $? in
88 0)
89         cat <<END >&4
90
91 NOTE: libucb has been found in /usr/lib.  libucb should reside in
92 /usr/ucblib.  You may have trouble while building Perl extensions.
93
94 END
95 ;;
96 esac
97
98
99 # See if make(1) is GNU make(1).
100 # If it is, make sure the setgid bit is not set.
101 make -v > make.vers 2>&1
102 if grep GNU make.vers > /dev/null 2>&1; then
103     tmp=`/usr/bin/which make`
104     case "`/usr/bin/ls -l $tmp`" in
105     ??????s*)
106             cat <<END >&2
107         
108 NOTE: Your PATH points to GNU make, and your GNU make has the set-group-id
109 bit set.  You must either rearrange your PATH to put /usr/ccs/bin before the
110 GNU utilities or you must ask your system administrator to disable the
111 set-group-id bit on GNU make.
112
113 END
114             ;;
115     esac
116 fi
117 rm -f make.vers
118
119 # XXX EXPERIMENTAL  A.D.  2/27/1998
120 # XXX This script UU/cc.cbu will get 'called-back' by Configure after it
121 # XXX has prompted the user for the C compiler to use.
122 cat > UU/cc.cbu <<'EOSH'
123 # If the C compiler is gcc:
124 #   - check the fixed-includes
125 #   - check as(1) and ld(1), they should not be GNU
126 #       (GNU ad and ld 2.8.1 and later are reportedly ok, however.)
127 # If the C compiler is not gcc:
128 #   - check as(1) and ld(1), they should not be GNU
129 #       (GNU ad and ld 2.8.1 and later are reportedly ok, however.)
130 #
131 # Watch out in case they have not set $cc.
132
133 # Get gcc to share its secrets.
134 echo 'main() { return 0; }' > try.c
135 verbose=`${cc:-cc} -v -o try try.c 2>&1`
136 rm -f try try.c
137
138 if echo "$verbose" | grep '^Reading specs from' >/dev/null 2>&1; then
139         #
140         # Using gcc.
141         #
142         #echo Using gcc
143
144         tmp=`echo "$verbose" | grep '^Reading' |
145                 awk '{print $NF}'  | sed 's/specs$/include/'`
146
147         # Determine if the fixed-includes look like they'll work.
148         # Doesn't work anymore for gcc-2.7.2.
149
150         # See if as(1) is GNU as(1).  GNU as(1) won't work for this job.
151         if echo "$verbose" | grep ' /usr/ccs/bin/as ' >/dev/null 2>&1; then
152             :
153         else
154             cat <<END >&2
155
156 NOTE: You are using GNU as(1).  GNU as(1) will not build Perl.
157 I'm arranging to use /usr/ccs/bin/as by setting including
158 -B/usr/ccs/bin/ in your ${cc:-cc} command.
159 (Note that the trailing "/" is required.)
160
161 END
162             cc="${cc:-cc} -B/usr/ccs/bin/"
163         fi
164
165         # See if ld(1) is GNU ld(1).  GNU ld(1) won't work for this job.
166         if echo "$verbose" | grep ' /usr/ccs/bin/as ' >/dev/null 2>&1; then
167             :
168         else
169             cat <<END >&2
170
171 NOTE: You are using GNU as(1).  GNU as(1) will not build Perl.
172 I'm arranging to use /usr/ccs/bin/as by setting including
173 -B/usr/ccs/bin/ in your ${cc:-cc} command.
174 (Note that the trailing "/" is required.)
175
176 END
177             cc="${cc:-cc} -B/usr/ccs/bin/"
178         fi
179
180 else
181         #
182         # Not using gcc.
183         #
184         #echo Not using gcc
185
186         # See if as(1) is GNU as(1).  GNU as(1) won't work for this job.
187         case `as --version < /dev/null 2>&1` in
188         *GNU*)
189                 cat <<END >&2
190
191 NOTE: You are using GNU as(1).  GNU as(1) will not build Perl.
192 You must arrange to use /usr/ccs/bin, perhaps by adding it to the
193 beginning of your PATH.
194
195 END
196                 ;;
197         esac
198
199         # See if ld(1) is GNU ld(1).  GNU ld(1) won't work for this job.
200         # ld --version doesn't properly report itself as a GNU tool,
201         # as of ld version 2.6, so we need to be more strict. TWP 9/5/96
202         gnu_ld=false
203         case `ld --version < /dev/null 2>&1` in
204         *GNU*|ld\ version\ 2*)
205                 gnu_ld=true ;;
206         *) ;;
207         esac
208         if $gnu_ld ; then :
209         else
210                 case `which ld` in
211                 no\ ld\ in*|[Cc]ommand\ not\ found*)
212                         ;;
213                 /*gnu*/ld|/*GNU*/ld)
214                         gnu_ld=true ;;
215                 esac
216         fi
217         if $gnu_ld ; then
218                 cat <<END >&2
219
220 NOTE: You are using GNU ld(1).  GNU ld(1) will not build Perl.
221 You must arrange to use /usr/ccs/bin, perhaps by adding it to the
222 beginning of your PATH.
223
224 END
225         fi
226
227 fi
228
229 # as --version or ld --version might dump core.
230 rm -f core
231
232 # XXX
233 EOSH
234
235 if [ "X$usethreads" = "X$define" ]; then
236     ccflags="-D_REENTRANT $ccflags"
237     # -lpthread needs to come before -lc but after other libraries such
238     # as -lgdbm and such like. We assume here that -lc is present in
239     # libswanted. If that fails to be true in future, then this can be
240     # changed to add pthread to the very end of libswanted.
241     # sched_yield is in -lposix4
242     set `echo X "$libswanted "| sed -e 's/ c / posix4 pthread c /'`
243     shift
244     libswanted="$*"
245
246     # On Solaris 2.6 x86 there is a bug with sigsetjmp() and siglongjmp()
247     # when linked with the threads library, such that whatever positive value
248     # you pass to siglongjmp(), sigsetjmp() returns 1.
249     # Thanks to Simon Parsons <S.Parsons@ftel.co.uk> for this report.
250     if test "`arch`" = i86pc -a "$osvers" = 2.6; then
251         d_sigaction=$undef
252         cat << 'EOM' >&2
253
254 You will see a *** WHOA THERE!!! ***  message from Configure for
255 d_sigaction.  Keep the recommended value.  See hints/solaris_2.sh
256 for more information.
257
258 EOM
259     fi
260 fi
261
262 # This is just a trick to include some useful notes.
263 cat > /dev/null <<'End_of_Solaris_Notes'
264
265 Here are some notes kindly contributed by Dean Roehrich.
266
267 -----
268 Generic notes about building Perl5 on Solaris:
269 - Use /usr/ccs/bin/make.
270 - If you use GNU make, remove its setgid bit.
271 - Remove all instances of *ucb* from your path.
272 - Make sure libucb is not in /usr/lib (it should be in /usr/ucblib).
273 - Do not use GNU as or GNU ld, or any of GNU binutils or GNU libc.
274 - Do not use /usr/ucb/cc.
275 - Do not change Configure's default answers, except for the path names.
276 - Do not use -lmalloc.
277 - Do not build on SunOS 4 and expect it to work properly on SunOS 5.
278 - /dev/fd must be mounted if you want set-uid scripts to work.
279
280
281 Here are the gcc-related questions and answers from the Solaris 2 FAQ.  Note
282 the themes:
283         - run fixincludes
284         - run fixincludes correctly
285         - don't use GNU as or GNU ld
286
287 Question 5.7 covers the __builtin_va_alist problem people are always seeing.
288 Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
289 people.
290 Question 6.9 is for those who are still trying to compile Perl4.
291
292 The latest Solaris 2 FAQ can be found in the following locations:
293         rtfm.mit.edu:/pub/usenet-by-group/comp.sys.sun.admin
294         ftp.fwi.uva.nl:/pub/solaris
295
296 Perl5 comes with a script in the top-level directory called "myconfig" which
297 will print a summary of the configuration in your config.sh.  My summary for
298 Solaris 2.4 and gcc 2.6.3 follows.  I have also built with gcc 2.7.0 and the
299 results are identical.  This configuration was generated with Configure's -d
300 option (take all defaults, don't bother prompting me).  All tests pass for
301 Perl5.001, patch.1m.
302
303 Summary of my perl5 (patchlevel 1) configuration:
304   Platform:
305     osname=solaris, osver=2.4, archname=sun4-solaris
306     uname='sunos poplar 5.4 generic_101945-27 sun4d sparc '
307     hint=recommended
308   Compiler:
309     cc='gcc', optimize='-O', ld='gcc'
310     cppflags=''
311     ccflags =''
312     ldflags =''
313     stdchar='unsigned char', d_stdstdio=define, usevfork=false
314     voidflags=15, castflags=0, d_casti32=define, d_castneg=define
315     intsize=4, alignbytes=8, usemymalloc=y, randbits=15
316   Libraries:
317     so=so
318     libpth=/lib /usr/lib /usr/ccs/lib /usr/local/lib
319     libs=-lsocket -lnsl -ldl -lm -lc -lcrypt
320     libc=/usr/lib/libc.so
321   Dynamic Linking:
322     dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef
323     cccdlflags='-fpic', ccdlflags=' ', lddlflags='-G'
324
325
326 Dean
327 roehrich@cray.com
328 9/7/95
329
330 -----------
331
332 From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
333 Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
334 Date: 25 Jul 1995 12:20:18 GMT
335
336 5.7) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
337
338     You're using gcc without properly installing the gcc fixed
339     include files.  Or you ran fixincludes after installing gcc
340     w/o moving the gcc supplied varargs.h and stdarg.h files
341     out of the way and moving them back again later.  This often
342     happens when people install gcc from a binary distribution.
343     If there's a tmp directory in gcc's include directory, fixincludes
344     didn't complete.  You should have run "just-fixinc" instead.
345
346     Another possible cause is using ``gcc -I/usr/include.''
347
348 6.1) Where is the C compiler or where can I get one?
349
350     [...]
351
352     3) Gcc.
353
354     Gcc is available from the GNU archives in source and binary
355     form.  Look in a directory called sparc-sun-solaris2 for
356     binaries.  You need gcc 2.3.3 or later.  You should not use
357     GNU as or GNU ld.  Make sure you run just-fixinc if you use
358     a binary distribution.  Better is to get a binary version and
359     use that to bootstrap gcc from source.
360
361     [...]
362
363     When you install gcc, don't make the mistake of installing
364     GNU binutils or GNU libc, they are not as capable as their
365     counterparts you get with Solaris 2.x.
366
367 6.9) I can't get perl 4.036 to compile or run.
368
369     Run Configure, and use the solaris_2_0 hints, *don't* use
370     the solaris_2_1 hints and don't use the config.sh you may
371     already have.  First you must make sure Configure and make
372     don't find /usr/ucb/cc.  (It must use gcc or the native C
373     compiler: /opt/SUNWspro/bin/cc)
374
375     Some questions need a special answer.
376
377     Are your system (especially dbm) libraries compiled with gcc? [y] y
378
379     yes: gcc 2.3.3 or later uses the standard calling
380     conventions, same as Sun's C.
381
382     Any additional cc flags? [ -traditional -Dvolatile=__volatile__
383     -I/usr/ucbinclude] -traditional -Dvolatile=__volatile__
384     Remove /usr/ucbinclude.
385
386     Any additional libraries? [-lsocket -lnsl -ldbm -lmalloc -lm
387     -lucb] -lsocket -lnsl  -lm
388
389     Don't include -ldbm, -lmalloc and -lucb.
390
391     Perl 5 compiled out of the box.
392
393 End_of_Solaris_Notes
394