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