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