This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Add Todo.5.005 to MANIFEST and submit remade embed.h.
[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
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.
126case "`${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`
4633a7c4 136 rm -f try try.c
8e07c86e
AD
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.
cee5ebb5 141 # Doesn't work anymore for gcc-2.7.2.
8e07c86e
AD
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 *)
68dc0745 147 cat <<END >&2
8e07c86e
AD
148
149NOTE: You are using GNU as(1). GNU as(1) will not build Perl.
150You must arrange to use /usr/ccs/bin/as, perhaps by setting
a81c337c 151GCC_EXEC_PREFIX or by including -B/usr/ccs/bin/ in your cc command.
aa689395 152(Note that the trailing "/" is required.)
8e07c86e
AD
153
154END
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 *)
68dc0745 162 cat <<END >&2
8e07c86e
AD
163
164NOTE: You are using GNU ld(1). GNU ld(1) will not build Perl.
165You must arrange to use /usr/ccs/bin/ld, perhaps by setting
a81c337c 166GCC_EXEC_PREFIX or by including -B/usr/ccs/bin/ in your cc command.
8e07c86e
AD
167
168END
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*)
68dc0745 182 cat <<END >&2
8e07c86e
AD
183
184NOTE: You are using GNU as(1). GNU as(1) will not build Perl.
185You must arrange to use /usr/ccs/bin, perhaps by adding it to the
186beginning of your PATH.
187
188END
189 ;;
190 esac
191
192 # See if ld(1) is GNU ld(1). GNU ld(1) won't work for this job.
91d1e749
PP
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
8e07c86e 196 case `ld --version < /dev/null 2>&1` in
91d1e749
PP
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
68dc0745 211 cat <<END >&2
8e07c86e
AD
212
213NOTE: You are using GNU ld(1). GNU ld(1) will not build Perl.
214You must arrange to use /usr/ccs/bin, perhaps by adding it to the
91d1e749 215beginning of your PATH.
8e07c86e
AD
216
217END
91d1e749 218 fi
8e07c86e
AD
219
220 ;; #not using gcc
221esac
222
223# as --version or ld --version might dump core.
224rm -f core
225
226# This is just a trick to include some useful notes.
227cat > /dev/null <<'End_of_Solaris_Notes'
228
229Here are some notes kindly contributed by Dean Roehrich.
230
231-----
232Generic 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
245Here are the gcc-related questions and answers from the Solaris 2 FAQ. Note
246the themes:
247 - run fixincludes
248 - run fixincludes correctly
249 - don't use GNU as or GNU ld
250
251Question 5.7 covers the __builtin_va_alist problem people are always seeing.
252Question 6.1.3 covers the GNU as and GNU ld issues which are always biting
253people.
254Question 6.9 is for those who are still trying to compile Perl4.
255
256The 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
260Perl5 comes with a script in the top-level directory called "myconfig" which
261will print a summary of the configuration in your config.sh. My summary for
262Solaris 2.4 and gcc 2.6.3 follows. I have also built with gcc 2.7.0 and the
263results are identical. This configuration was generated with Configure's -d
264option (take all defaults, don't bother prompting me). All tests pass for
265Perl5.001, patch.1m.
266
267Summary 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
290Dean
291roehrich@cray.com
2929/7/95
293
294-----------
295
296From: Casper.Dik@Holland.Sun.COM (Casper H.S. Dik - Network Security Engineer)
297Subject: Solaris 2 Frequently Asked Questions (FAQ) 1.48
298Date: 25 Jul 1995 12:20:18 GMT
299
3005.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
3126.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
3316.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
357End_of_Solaris_Notes
358