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