This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Perl Social Contract
[perl5.git] / hints / solaris_2.sh
CommitLineData
8e07c86e 1# hints/solaris_2.sh
b1db1e90 2# Last modified: Thu Feb 8 11:38:12 EST 1996
8e07c86e
AD
3# Andy Dougherty <doughera@lafcol.lafayette.edu>
4# Based on input from lots of folks, especially
5# Dean Roehrich <roehrich@ironwood-fddi.cray.com>
7beaa944
AD
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#
a81c337c 13
8e07c86e 14# See man vfork.
a0d0e21e 15usevfork=false
b1db1e90 16
a0d0e21e 17d_suidsafe=define
b1db1e90 18
8e07c86e 19# Avoid all libraries in /usr/ucblib.
a0d0e21e
LW
20set `echo $glibpth | sed -e 's@/usr/ucblib@@'`
21glibpth="$*"
b1db1e90 22
40000a8c
AD
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>
29set `echo " $libswanted " | sed -e 's@ ld @ @' -e 's@ malloc @ @' -e 's@ ucb @ @'`
a0d0e21e
LW
30libswanted="$*"
31
b1db1e90 32# Look for architecture name. We want to suggest a useful default.
a0d0e21e
LW
33case "$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 ;;
43esac
a0d0e21e 44
b1db1e90
PP
45######################################################
46# General sanity testing. See below for excerpts from the Solaris FAQ.
8e07c86e
AD
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
a0d0e21e 56case $PATH in
68dc0745 57*/usr/ucb*:/usr/bin:*|*/usr/ucb*:/usr/bin) cat <<END >&4
8e07c86e 58
a0d0e21e
LW
59NOTE: Some people have reported problems with /usr/ucb/cc.
60Remove /usr/ucb from your PATH if you have difficulties.
8e07c86e
AD
61
62END
63;;
64esac
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
70case $? in
710) ;;
72*)
68dc0745 73 cat <<END >&4
8e07c86e
AD
74
75NOTE: Your system does not have /dev/fd mounted. If you want to
76be able to use set-uid scripts you must ask your system administrator
77to mount /dev/fd.
78
79END
80 ;;
81esac
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
87case $? in
880)
68dc0745 89 cat <<END >&4
8e07c86e
AD
90
91NOTE: libucb has been found in /usr/lib. libucb should reside in
92/usr/ucblib. You may have trouble while building Perl extensions.
93
a0d0e21e
LW
94END
95;;
96esac
40000a8c 97
8e07c86e
AD
98
99# See if make(1) is GNU make(1).
100# If it is, make sure the setgid bit is not set.
101make -v > make.vers 2>&1
102if 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*)
68dc0745 106 cat <<END >&2
8e07c86e
AD
107
108NOTE: Your PATH points to GNU make, and your GNU make has the set-group-id
109bit set. You must either rearrange your PATH to put /usr/ccs/bin before the
110GNU utilities or you must ask your system administrator to disable the
111set-group-id bit on GNU make.
112
113END
114 ;;
115 esac
116fi
117rm -f make.vers
118
693762b4
AD
119# XXX EXPERIMENTAL A.D. 2/27/1998
120# XXX This script UU/cc.cbu will get 'called-back' by Configure after it
121# XXX has prompted the user for the C compiler to use.
122cat > UU/cc.cbu <<'EOSH'
8e07c86e
AD
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.
1acf53c5
SZ
130
131# Get gcc to share its secrets.
132echo 'main() { return 0; }' > try.c
133verbose=`${cc:-cc} -v -o try try.c 2>&1`
134rm -f try try.c
135
136if echo "$verbose" | grep '^Reading specs from' >/dev/null 2>&1; then
8e07c86e
AD
137 #
138 # Using gcc.
139 #
140 #echo Using gcc
141
8e07c86e
AD
142 tmp=`echo "$verbose" | grep '^Reading' |
143 awk '{print $NF}' | sed 's/specs$/include/'`
144
145 # Determine if the fixed-includes look like they'll work.
cee5ebb5 146 # Doesn't work anymore for gcc-2.7.2.
8e07c86e
AD
147
148 # See if as(1) is GNU as(1). GNU as(1) won't work for this job.
1acf53c5
SZ
149 if echo "$verbose" | grep ' /usr/ccs/bin/as ' >/dev/null 2>&1; then
150 :
151 else
68dc0745 152 cat <<END >&2
8e07c86e
AD
153
154NOTE: You are using GNU as(1). GNU as(1) will not build Perl.
1acf53c5
SZ
155I'm arranging to use /usr/ccs/bin/as by setting including
156-B/usr/ccs/bin/ in your ${cc:-cc} command.
aa689395 157(Note that the trailing "/" is required.)
8e07c86e
AD
158
159END
1acf53c5
SZ
160 cc="${cc:-cc} -B/usr/ccs/bin/"
161 fi
8e07c86e
AD
162
163 # See if ld(1) is GNU ld(1). GNU ld(1) won't work for this job.
1acf53c5
SZ
164 if echo "$verbose" | grep ' /usr/ccs/bin/as ' >/dev/null 2>&1; then
165 :
166 else
68dc0745 167 cat <<END >&2
8e07c86e 168
1acf53c5
SZ
169NOTE: You are using GNU as(1). GNU as(1) will not build Perl.
170I'm arranging to use /usr/ccs/bin/as by setting including
171-B/usr/ccs/bin/ in your ${cc:-cc} command.
172(Note that the trailing "/" is required.)
8e07c86e
AD
173
174END
1acf53c5
SZ
175 cc="${cc:-cc} -B/usr/ccs/bin/"
176 fi
8e07c86e 177
1acf53c5 178else
8e07c86e
AD
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*)
68dc0745 187 cat <<END >&2
8e07c86e
AD
188
189NOTE: You are using GNU as(1). GNU as(1) will not build Perl.
190You must arrange to use /usr/ccs/bin, perhaps by adding it to the
191beginning of your PATH.
192
193END
194 ;;
195 esac
196
197 # See if ld(1) is GNU ld(1). GNU ld(1) won't work for this job.
91d1e749
PP
198 # ld --version doesn't properly report itself as a GNU tool,
199 # as of ld version 2.6, so we need to be more strict. TWP 9/5/96
200 gnu_ld=false
8e07c86e 201 case `ld --version < /dev/null 2>&1` in
91d1e749
PP
202 *GNU*|ld\ version\ 2*)
203 gnu_ld=true ;;
204 *) ;;
205 esac
206 if $gnu_ld ; then :
207 else
208 case `which ld` in
209 no\ ld\ in*|[Cc]ommand\ not\ found*)
210 ;;
211 /*gnu*/ld|/*GNU*/ld)
212 gnu_ld=true ;;
213 esac
214 fi
215 if $gnu_ld ; then
68dc0745 216 cat <<END >&2
8e07c86e
AD
217
218NOTE: You are using GNU ld(1). GNU ld(1) will not build Perl.
219You must arrange to use /usr/ccs/bin, perhaps by adding it to the
91d1e749 220beginning of your PATH.
8e07c86e
AD
221
222END
91d1e749 223 fi
8e07c86e 224
1acf53c5 225fi
8e07c86e
AD
226
227# as --version or ld --version might dump core.
228rm -f core
229
693762b4
AD
230# XXX
231EOSH
232
e5c9fcd0 233if [ "X$usethreads" = "X$define" ]; then
dfe9444c 234 ccflags="-D_REENTRANT $ccflags"
b981e18e
MB
235 # -lpthread needs to come before -lc but after other libraries such
236 # as -lgdbm and such like. We assume here that -lc is present in
237 # libswanted. If that fails to be true in future, then this can be
238 # changed to add pthread to the very end of libswanted.
239 set `echo X "$libswanted "| sed -e 's/ c / pthread c /'`
240 shift
241 libswanted="$*"
242fi
243
8e07c86e
AD
244# This is just a trick to include some useful notes.
245cat > /dev/null <<'End_of_Solaris_Notes'
246
247Here are some notes kindly contributed by Dean Roehrich.
248
249-----
250Generic notes about building Perl5 on Solaris:
251- Use /usr/ccs/bin/make.
252- If you use GNU make, remove its setgid bit.
253- Remove all instances of *ucb* from your path.
254- Make sure libucb is not in /usr/lib (it should be in /usr/ucblib).
255- Do not use GNU as or GNU ld, or any of GNU binutils or GNU libc.
256- Do not use /usr/ucb/cc.
257- Do not change Configure's default answers, except for the path names.
258- Do not use -lmalloc.
259- Do not build on SunOS 4 and expect it to work properly on SunOS 5.
260- /dev/fd must be mounted if you want set-uid scripts to work.
261
262
263Here are the gcc-related questions and answers from the Solaris 2 FAQ. Note
264the themes:
265 - run fixincludes
266 - run fixincludes correctly
267 - don't use GNU as or GNU ld
268
269Question 5.7 covers the __builtin_va_alist problem people are always seeing.
270Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
271people.
272Question 6.9 is for those who are still trying to compile Perl4.
273
274The latest Solaris 2 FAQ can be found in the following locations:
275 rtfm.mit.edu:/pub/usenet-by-group/comp.sys.sun.admin
276 ftp.fwi.uva.nl:/pub/solaris
277
278Perl5 comes with a script in the top-level directory called "myconfig" which
279will print a summary of the configuration in your config.sh. My summary for
280Solaris 2.4 and gcc 2.6.3 follows. I have also built with gcc 2.7.0 and the
281results are identical. This configuration was generated with Configure's -d
282option (take all defaults, don't bother prompting me). All tests pass for
283Perl5.001, patch.1m.
284
285Summary of my perl5 (patchlevel 1) configuration:
286 Platform:
287 osname=solaris, osver=2.4, archname=sun4-solaris
288 uname='sunos poplar 5.4 generic_101945-27 sun4d sparc '
289 hint=recommended
290 Compiler:
291 cc='gcc', optimize='-O', ld='gcc'
292 cppflags=''
293 ccflags =''
294 ldflags =''
295 stdchar='unsigned char', d_stdstdio=define, usevfork=false
296 voidflags=15, castflags=0, d_casti32=define, d_castneg=define
297 intsize=4, alignbytes=8, usemymalloc=y, randbits=15
298 Libraries:
299 so=so
300 libpth=/lib /usr/lib /usr/ccs/lib /usr/local/lib
301 libs=-lsocket -lnsl -ldl -lm -lc -lcrypt
302 libc=/usr/lib/libc.so
303 Dynamic Linking:
304 dlsrc=dl_dlopen.xs, dlext=so, d_dlsymun=undef
305 cccdlflags='-fpic', ccdlflags=' ', lddlflags='-G'
306
307
308Dean
309roehrich@cray.com
3109/7/95
311
312-----------
313
314From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
315Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
316Date: 25 Jul 1995 12:20:18 GMT
317
3185.7) Why do I get __builtin_va_alist or __builtin_va_arg_incr undefined?
319
320 You're using gcc without properly installing the gcc fixed
321 include files. Or you ran fixincludes after installing gcc
322 w/o moving the gcc supplied varargs.h and stdarg.h files
323 out of the way and moving them back again later. This often
324 happens when people install gcc from a binary distribution.
325 If there's a tmp directory in gcc's include directory, fixincludes
326 didn't complete. You should have run "just-fixinc" instead.
327
328 Another possible cause is using ``gcc -I/usr/include.''
329
3306.1) Where is the C compiler or where can I get one?
331
332 [...]
333
334 3) Gcc.
335
336 Gcc is available from the GNU archives in source and binary
337 form. Look in a directory called sparc-sun-solaris2 for
338 binaries. You need gcc 2.3.3 or later. You should not use
339 GNU as or GNU ld. Make sure you run just-fixinc if you use
340 a binary distribution. Better is to get a binary version and
341 use that to bootstrap gcc from source.
342
343 [...]
344
345 When you install gcc, don't make the mistake of installing
346 GNU binutils or GNU libc, they are not as capable as their
347 counterparts you get with Solaris 2.x.
348
3496.9) I can't get perl 4.036 to compile or run.
350
351 Run Configure, and use the solaris_2_0 hints, *don't* use
352 the solaris_2_1 hints and don't use the config.sh you may
353 already have. First you must make sure Configure and make
354 don't find /usr/ucb/cc. (It must use gcc or the native C
355 compiler: /opt/SUNWspro/bin/cc)
356
357 Some questions need a special answer.
358
359 Are your system (especially dbm) libraries compiled with gcc? [y] y
360
361 yes: gcc 2.3.3 or later uses the standard calling
362 conventions, same as Sun's C.
363
364 Any additional cc flags? [ -traditional -Dvolatile=__volatile__
365 -I/usr/ucbinclude] -traditional -Dvolatile=__volatile__
366 Remove /usr/ucbinclude.
367
368 Any additional libraries? [-lsocket -lnsl -ldbm -lmalloc -lm
369 -lucb] -lsocket -lnsl -lm
370
371 Don't include -ldbm, -lmalloc and -lucb.
372
373 Perl 5 compiled out of the box.
374
375End_of_Solaris_Notes
376