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