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