perl 5.003_01: hints/os2.sh
[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 # See man vfork.
8 usevfork=false
9
10 d_suidsafe=define
11
12 # Avoid all libraries in /usr/ucblib.
13 set `echo $glibpth | sed -e 's@/usr/ucblib@@'`
14 glibpth="$*"
15
16 # Remove bad libraries.  -lucb contains incompatible routines.
17 # -lld doesn't do anything useful.
18 # -lmalloc can cause a problem with GNU CC & Solaris.  Specifically,
19 # libmalloc.a may allocate memory that is only 4 byte aligned, but
20 # GNU CC on the Sparc assumes that doubles are 8 byte aligned.
21 # Thanks to  Hallvard B. Furuseth <h.b.furuseth@usit.uio.no>
22 set `echo " $libswanted " | sed -e 's@ ld @ @' -e 's@ malloc @ @' -e 's@ ucb @ @'`
23 libswanted="$*"
24
25 # Look for architecture name.  We want to suggest a useful default.
26 case "$archname" in
27 '')
28     if test -f /usr/bin/arch; then
29         archname=`/usr/bin/arch`
30         archname="${archname}-${osname}"
31     elif test -f /usr/ucb/arch; then
32         archname=`/usr/ucb/arch`
33         archname="${archname}-${osname}"
34     fi
35     ;;
36 esac
37
38 # Solaris 2.5 has reintroduced some BSD-ish functions into libc.
39 # This is no problem unless you compile perl under Solaris 2.5 but
40 # try to run the binary on 2.4.  Here, we take the easy way out by
41 # claiming we don't have these functions.  perl.h works around all of
42 # these anyway.
43 # XXX Eventually, I should fix perl.h to prefer the POSIX versions.
44 d_bcmp='undef'
45 d_bcopy='undef'
46 d_safebcpy='undef'
47 d_index='undef'
48
49 ######################################################
50 # General sanity testing.  See below for excerpts from the Solaris FAQ.
51
52 # From roehrich@ironwood-fddi.cray.com Wed Sep 27 12:51:46 1995
53 # Date: Thu, 7 Sep 1995 16:31:40 -0500
54 # From: Dean Roehrich <roehrich@ironwood-fddi.cray.com>
55 # To: perl5-porters@africa.nicoh.com
56 # Subject: Re: On perl5/solaris/gcc
57
58 # Here's another draft of the perl5/solaris/gcc sanity-checker. 
59
60 case $PATH in
61 */usr/ucb*:/usr/bin:*|*/usr/ucb*:/usr/bin) cat <<END
62
63 NOTE:  Some people have reported problems with /usr/ucb/cc.  
64 Remove /usr/ucb from your PATH if you have difficulties.
65
66 END
67 ;;
68 esac
69
70
71 # Check that /dev/fd is mounted.  If it is not mounted, let the
72 # user know that suid scripts may not work.
73 /usr/bin/df /dev/fd 2>&1 > /dev/null
74 case $? in
75 0) ;;
76 *)
77         cat <<END
78
79 NOTE: Your system does not have /dev/fd mounted.  If you want to
80 be able to use set-uid scripts you must ask your system administrator
81 to mount /dev/fd.
82
83 END
84         ;;
85 esac
86
87
88 # See if libucb can be found in /usr/lib.  If it is, warn the user
89 # that this may cause problems while building Perl extensions.
90 /usr/bin/ls /usr/lib/libucb* >/dev/null 2>&1
91 case $? in
92 0)
93         cat <<END
94
95 NOTE: libucb has been found in /usr/lib.  libucb should reside in
96 /usr/ucblib.  You may have trouble while building Perl extensions.
97
98 END
99 ;;
100 esac
101
102
103 # See if make(1) is GNU make(1).
104 # If it is, make sure the setgid bit is not set.
105 make -v > make.vers 2>&1
106 if grep GNU make.vers > /dev/null 2>&1; then
107     tmp=`/usr/bin/which make`
108     case "`/usr/bin/ls -l $tmp`" in
109     ??????s*)
110             cat <<END
111         
112 NOTE: Your PATH points to GNU make, and your GNU make has the set-group-id
113 bit set.  You must either rearrange your PATH to put /usr/ccs/bin before the
114 GNU utilities or you must ask your system administrator to disable the
115 set-group-id bit on GNU make.
116
117 END
118             ;;
119     esac
120 fi
121 rm -f make.vers
122
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 case "`${cc:-cc} -v 2>&1`" in
131 *gcc*)
132         #
133         # Using gcc.
134         #
135         #echo Using gcc
136
137         # Get gcc to share its secrets.
138         echo 'main() { return 0; }' > try.c
139         verbose=`${cc:-cc} -v -o try try.c 2>&1`
140         rm -f try try.c
141         tmp=`echo "$verbose" | grep '^Reading' |
142                 awk '{print $NF}'  | sed 's/specs$/include/'`
143
144         # Determine if the fixed-includes look like they'll work.
145         # Doesn't work anymore for gcc-2.7.2.
146
147         # See if as(1) is GNU as(1).  GNU as(1) won't work for this job.
148         case $verbose in
149         */usr/ccs/bin/as*) ;;
150         *)
151             cat <<END
152
153 NOTE: You are using GNU as(1).  GNU as(1) will not build Perl.
154 You must arrange to use /usr/ccs/bin/as, perhaps by setting
155 GCC_EXEC_PREFIX or by including -B/usr/ccs/bin in your cc command.
156
157 END
158         ;;
159         esac
160
161         # See if ld(1) is GNU ld(1).  GNU ld(1) won't work for this job.
162         case $verbose in
163         */usr/ccs/bin/ld*) ;;
164         *)
165             cat <<END
166
167 NOTE: You are using GNU ld(1).  GNU ld(1) will not build Perl.
168 You must arrange to use /usr/ccs/bin/ld, perhaps by setting
169 GCC_EXEC_PREFIX or by including -B/usr/ccs/bin in your cc command.
170
171 END
172         ;;
173         esac
174
175         ;; #using gcc
176 *)
177         #
178         # Not using gcc.
179         #
180         #echo Not using gcc
181
182         # See if as(1) is GNU as(1).  GNU as(1) won't work for this job.
183         case `as --version < /dev/null 2>&1` in
184         *GNU*)
185                 cat <<END
186
187 NOTE: You are using GNU as(1).  GNU as(1) will not build Perl.
188 You must arrange to use /usr/ccs/bin, perhaps by adding it to the
189 beginning of your PATH.
190
191 END
192                 ;;
193         esac
194
195         # See if ld(1) is GNU ld(1).  GNU ld(1) won't work for this job.
196         case `ld --version < /dev/null 2>&1` in
197         *GNU*)
198                 cat <<END
199
200 NOTE: You are using GNU ld(1).  GNU ld(1) will not build Perl.
201 You must arrange to use /usr/ccs/bin, perhaps by adding it to the
202 beginning of your PATH
203
204 END
205                 ;;
206         esac
207
208         ;; #not using gcc
209 esac
210
211 # as --version or ld --version might dump core.
212 rm -f core
213
214 # This is just a trick to include some useful notes.
215 cat > /dev/null <<'End_of_Solaris_Notes'
216
217 Here are some notes kindly contributed by Dean Roehrich.
218
219 -----
220 Generic notes about building Perl5 on Solaris:
221 - Use /usr/ccs/bin/make.
222 - If you use GNU make, remove its setgid bit.
223 - Remove all instances of *ucb* from your path.
224 - Make sure libucb is not in /usr/lib (it should be in /usr/ucblib).
225 - Do not use GNU as or GNU ld, or any of GNU binutils or GNU libc.
226 - Do not use /usr/ucb/cc.
227 - Do not change Configure's default answers, except for the path names.
228 - Do not use -lmalloc.
229 - Do not build on SunOS 4 and expect it to work properly on SunOS 5.
230 - /dev/fd must be mounted if you want set-uid scripts to work.
231
232
233 Here are the gcc-related questions and answers from the Solaris 2 FAQ.  Note
234 the themes:
235         - run fixincludes
236         - run fixincludes correctly
237         - don't use GNU as or GNU ld
238
239 Question 5.7 covers the __builtin_va_alist problem people are always seeing.
240 Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
241 people.
242 Question 6.9 is for those who are still trying to compile Perl4.
243
244 The latest Solaris 2 FAQ can be found in the following locations:
245         rtfm.mit.edu:/pub/usenet-by-group/comp.sys.sun.admin
246         ftp.fwi.uva.nl:/pub/solaris
247
248 Perl5 comes with a script in the top-level directory called "myconfig" which
249 will print a summary of the configuration in your config.sh.  My summary for
250 Solaris 2.4 and gcc 2.6.3 follows.  I have also built with gcc 2.7.0 and the
251 results are identical.  This configuration was generated with Configure's -d
252 option (take all defaults, don't bother prompting me).  All tests pass for
253 Perl5.001, patch.1m.
254
255 Summary of my perl5 (patchlevel 1) configuration:
256   Platform:
257     osname=solaris, osver=2.4, archname=sun4-solaris
258     uname='sunos poplar 5.4 generic_101945-27 sun4d sparc '
259     hint=recommended
260   Compiler:
261     cc='gcc', optimize='-O', ld='gcc'
262     cppflags=''
263     ccflags =''
264     ldflags =''
265     stdchar='unsigned char', d_stdstdio=define, usevfork=false
266     voidflags=15, castflags=0, d_casti32=define, d_castneg=define
267     intsize=4, alignbytes=8, usemymalloc=y, randbits=15
268   Libraries:
269     so=so
270     libpth=/lib /usr/lib /usr/ccs/lib /usr/local/lib
271     libs=-lsocket -lnsl -ldl -lm -lc -lcrypt
272     libc=/usr/lib/libc.so
273   Dynamic Linking:
274     dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef
275     cccdlflags='-fpic', ccdlflags=' ', lddlflags='-G'
276
277
278 Dean
279 roehrich@cray.com
280 9/7/95
281
282 -----------
283
284 From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
285 Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
286 Date: 25 Jul 1995 12:20:18 GMT
287
288 5.7) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
289
290     You're using gcc without properly installing the gcc fixed
291     include files.  Or you ran fixincludes after installing gcc
292     w/o moving the gcc supplied varargs.h and stdarg.h files
293     out of the way and moving them back again later.  This often
294     happens when people install gcc from a binary distribution.
295     If there's a tmp directory in gcc's include directory, fixincludes
296     didn't complete.  You should have run "just-fixinc" instead.
297
298     Another possible cause is using ``gcc -I/usr/include.''
299
300 6.1) Where is the C compiler or where can I get one?
301
302     [...]
303
304     3) Gcc.
305
306     Gcc is available from the GNU archives in source and binary
307     form.  Look in a directory called sparc-sun-solaris2 for
308     binaries.  You need gcc 2.3.3 or later.  You should not use
309     GNU as or GNU ld.  Make sure you run just-fixinc if you use
310     a binary distribution.  Better is to get a binary version and
311     use that to bootstrap gcc from source.
312
313     [...]
314
315     When you install gcc, don't make the mistake of installing
316     GNU binutils or GNU libc, they are not as capable as their
317     counterparts you get with Solaris 2.x.
318
319 6.9) I can't get perl 4.036 to compile or run.
320
321     Run Configure, and use the solaris_2_0 hints, *don't* use
322     the solaris_2_1 hints and don't use the config.sh you may
323     already have.  First you must make sure Configure and make
324     don't find /usr/ucb/cc.  (It must use gcc or the native C
325     compiler: /opt/SUNWspro/bin/cc)
326
327     Some questions need a special answer.
328
329     Are your system (especially dbm) libraries compiled with gcc? [y] y
330
331     yes: gcc 2.3.3 or later uses the standard calling
332     conventions, same as Sun's C.
333
334     Any additional cc flags? [ -traditional -Dvolatile=__volatile__
335     -I/usr/ucbinclude] -traditional -Dvolatile=__volatile__
336     Remove /usr/ucbinclude.
337
338     Any additional libraries? [-lsocket -lnsl -ldbm -lmalloc -lm
339     -lucb] -lsocket -lnsl  -lm
340
341     Don't include -ldbm, -lmalloc and -lucb.
342
343     Perl 5 compiled out of the box.
344
345 End_of_Solaris_Notes
346