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