This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
Integrate with Sarathy.
[perl5.git] / hints / dec_osf.sh
CommitLineData
a0d0e21e 1# hints/dec_osf.sh
8e964347 2
b971f6e4 3# * If you want to debug perl or want to send a
8e964347
AB
4# stack trace for inclusion into an bug report, call
5# Configure with the additional argument -Doptimize=-g2
6# or uncomment this assignment to "optimize":
7#
8#optimize=-g2
9#
8a019ce7
JH
10# If you want both to optimise and debug with the DEC cc
11# you must have -g3, e.g. "-O4 -g3", and (re)run Configure.
12#
b971f6e4 13# * gcc can always have both -g and optimisation on.
8a019ce7 14#
b971f6e4 15# * debugging optimised code, no matter what compiler
8a019ce7
JH
16# one is using, can be surprising and confusing because of
17# the optimisation tricks like code motion, code removal,
18# loop unrolling, and inlining. The source code and the
19# executable code simply do not agree any more while in
20# mid-execution, the optimiser only cares about the results.
21#
b971f6e4 22# * Configure will automatically add the often quoted
f2c69087
JH
23# -DDEBUGGING for you if the -g is specified.
24#
b971f6e4 25# * There is even more optimisation available in the new
f2c69087
JH
26# (GEM) DEC cc: -O5 and -fast. "man cc" will tell more about them.
27# The jury is still out whether either or neither help for Perl
28# and how much. Based on very quick testing, -fast boosts
29# raw data copy by about 5-15% (-fast brings in, among other
30# things, inlined, ahem, fast memcpy()), while on the other
31# hand searching things (index, m//, s///), seems to get slower.
32# Your mileage will vary.
8e964347 33#
b971f6e4 34# * The -std is needed because the following compiled
e60a08f8
JH
35# without the -std and linked with -lm
36#
37# #include <math.h>
38# #include <stdio.h>
39# int main(){short x=10,y=sqrt(x);printf("%d\n",y);}
40#
41# will in Digital UNIX 3.* and 4.0b print 0 -- and in Digital
42# UNIX 4.0{,a} dump core: Floating point exception in the printf(),
43# the y has become a signaling NaN.
44#
b971f6e4
PP
45# * Compilation warnings like:
46#
47# "Undefined the ANSI standard macro ..."
48#
49# can be ignored, at least while compiling the POSIX extension
50# and especially if using the sfio (the latter is not a standard
51# part of Perl, never mind if it says little to you).
52#
8e964347 53
e60a08f8
JH
54# If using the DEC compiler we must find out the DEC compiler style:
55# the style changed between Digital UNIX (aka DEC OSF/1) 3 and
56# Digital UNIX 4. The old compiler was originally from Ultrix and
57# the MIPS company, the new compiler is originally from the VAX world
58# and it is called GEM. Many of the options we are going to use depend
59# on the compiler style.
60
a68015de
JH
61cc=${cc:-cc}
62
b691c02f
JH
63# do NOT, I repeat, *NOT* take away the leading tabs
64# Configure Black Magic (TM)
b971f6e4 65 # reset
e60a08f8 66 _DEC_cc_style=
8d5a0f9f 67case "`$cc -v 2>&1 | grep cc`" in
e60a08f8
JH
68*gcc*) ;; # pass
69*) # compile something small: taint.c is fine for this.
70 # the main point is the '-v' flag of 'cc'.
71 case "`cc -v -I. -c taint.c -o /tmp/taint$$.o 2>&1`" in
72 */gemc_cc*) # we have the new DEC GEM CC
dfa3a3d3 73 _DEC_cc_style=new
8a019ce7 74 ;;
e60a08f8 75 *) # we have the old MIPS CC
dfa3a3d3 76 _DEC_cc_style=old
8a019ce7 77 ;;
e60a08f8
JH
78 esac
79 # cleanup
80 rm -f /tmp/taint$$.o
81 ;;
82esac
83
b971f6e4 84# be nauseatingly ANSI
8d5a0f9f 85case "`$cc -v 2>&1 | grep gcc`" in
9607fc9c 86*gcc*) ccflags="$ccflags -ansi"
b971f6e4
PP
87 ;;
88*) ccflags="$ccflags -std"
89 ;;
90esac
91
92# for gcc the Configure knows about the -fpic:
93# position-independent code for dynamic loading
94
e60a08f8
JH
95# we want optimisation
96
97case "$optimize" in
8d5a0f9f 98'') case "`$cc -v 2>&1 | grep gcc`" in
e60a08f8
JH
99 *gcc*)
100 optimize='-O3' ;;
101 *) case "$_DEC_cc_style" in
313489a2
SB
102 new) optimize='-O4'
103 ccflags="$ccflags -fprm d -ieee"
104 ;;
e60a08f8
JH
105 old) optimize='-O2 -Olimit 3200' ;;
106 esac
b971f6e4 107 ccflags="$ccflags -D_INTRINSICS"
e60a08f8 108 ;;
8e964347
AB
109 esac
110 ;;
1fc4cb55 111esac
28757baa 112
313489a2
SB
113# Make glibpth agree with the compiler suite. Note that /shlib
114# is not here. That's on purpose. Even though that's where libc
115# really lives from V4.0 on, the linker (and /sbin/loader) won't
116# look there by default. The sharable /sbin utilities were all
117# built with "-Wl,-rpath,/shlib" to get around that. This makes
118# no attempt to figure out the additional location(s) searched by
119# gcc, since not all versions of gcc are easily coerced into
120# revealing that information.
b0362887
SB
121glibpth="/usr/shlib /usr/ccs/lib /usr/lib/cmplrs/cc"
122glibpth="$glibpth /usr/lib /usr/local/lib /var/shlib"
313489a2 123
8e964347
AB
124# dlopen() is in libc
125libswanted="`echo $libswanted | sed -e 's/ dl / /'`"
126
b971f6e4 127# libPW contains nothing useful for perl
8a019ce7
JH
128libswanted="`echo $libswanted | sed -e 's/ PW / /'`"
129
723e14d4
SB
130# libnet contains nothing useful for perl here, and doesn't work
131libswanted="`echo $libswanted | sed -e 's/ net / /'`"
132
b971f6e4 133# libbsd contains nothing used by perl that is not already in libc
8a019ce7
JH
134libswanted="`echo $libswanted | sed -e 's/ bsd / /'`"
135
b971f6e4 136# libc need not be separately listed
8a019ce7
JH
137libswanted="`echo $libswanted | sed -e 's/ c / /'`"
138
b971f6e4
PP
139# ndbm is already in libc
140libswanted="`echo $libswanted | sed -e 's/ ndbm / /'`"
8a019ce7
JH
141
142# the basic lddlflags used always
143lddlflags='-shared -expect_unresolved "*"'
144
b971f6e4
PP
145# Fancy compiler suites use optimising linker as well as compiler.
146# <spider@Orb.Nashua.NH.US>
b8f0c030 147case "`uname -r`" in
b971f6e4
PP
148*[123].*) # old loader
149 lddlflags="$lddlflags -O3"
150 ;;
a07564da
KS
151*) if $test "X$optimize" = "X$undef"; then
152 lddlflags="$lddlflags -msym"
153 else
baa8820a 154 case "`/usr/sbin/sizer -v`" in
e3159d07
JH
155 *4.0D*)
156 # QAR 56761: -O4 + .so may produce broken code,
157 # fixed in 4.0E or better.
158 ;;
159 *)
160 lddlflags="$lddlflags $optimize"
161 ;;
162 esac
163 # -msym: If using a sufficiently recent /sbin/loader,
164 # keep the module symbols with the modules.
baa8820a 165 lddlflags="$lddlflags -msym -std"
a07564da 166 fi
b971f6e4
PP
167 ;;
168esac
169# Yes, the above loses if gcc does not use the system linker.
170# If that happens, let me know about it. <jhi@iki.fi>
171
8a019ce7 172
b971f6e4
PP
173# If debugging or (old systems and doing shared)
174# then do not strip the lib, otherwise, strip.
175# As noted above the -DDEBUGGING is added automagically by Configure if -g.
8a019ce7
JH
176case "$optimize" in
177 *-g*) ;; # left intentionally blank
b8f0c030 178*) case "`uname -r`" in
b971f6e4
PP
179 *[123].*)
180 case "$useshrplib" in
181 false|undef|'') lddlflags="$lddlflags -s" ;;
182 esac
183 ;;
8a019ce7 184 *) lddlflags="$lddlflags -s"
b971f6e4
PP
185 ;;
186 esac
187 ;;
8a019ce7 188esac
8e964347
AB
189
190#
313489a2
SB
191# Make embedding in things like INN and Apache more memory friendly.
192# Keep it overridable on the Configure command line, though, so that
193# "-Uuseshrplib" prevents this default.
194#
195
2bf2710f
GS
196case "$_DEC_cc_style.$useshrplib" in
197 new.) useshrplib="$define" ;;
198esac
313489a2 199
85ab1d1d
JH
200# The EFF_ONLY_OK from <sys/access.h> is present but dysfunctional for
201# [RWX]_OK as of Digital UNIX 4.0[A-D]?. If and when this gets fixed,
202# please adjust this appropriately. See also pp_sys.c just before the
203# emulate_eaccess().
5ff3f7a4 204
baa8820a
JH
205# Fixed in V5.0A.
206case "`/usr/sbin/sizer -v`" in
207*5.0[A-Z]*|*[6-9].[0-9]*)
208 : ok
209 ;;
210*)
211# V5.0 or previous
5ff3f7a4 212pp_sys_cflags='ccflags="$ccflags -DNO_EFF_ONLY_OK"'
baa8820a
JH
213 ;;
214esac
5ff3f7a4 215
6b8eaf93
JH
216# The off_t is already 8 bytes, so we do have largefileness.
217
104d25b7
JH
218# This script UU/usethreads.cbu will get 'called-back' by Configure
219# after it has prompted the user for whether to use threads.
220cat > UU/usethreads.cbu <<'EOCBU'
221case "$usethreads" in
222$define|true|[yY]*)
75d72f2c 223 # Threads interfaces changed with V4.0.
8d5a0f9f 224 case "`$cc -v 2>&1 | grep gcc`" in
75d72f2c
JH
225 *gcc*)ccflags="-D_REENTRANT $ccflags" ;;
226 *) case "`uname -r`" in
227 *[123].*) ccflags="-threads $ccflags" ;;
228 *) ccflags="-pthread $ccflags" ;;
229 esac
104d25b7 230 ;;
75d72f2c
JH
231 esac
232 case "`uname -r`" in
233 *[123].*) libswanted="$libswanted pthreads mach exc c_r" ;;
234 *) libswanted="$libswanted pthread exc" ;;
235 esac
e883c329 236
baa8820a
JH
237 case "$usemymalloc" in
238 '')
239 usemymalloc='n'
240 ;;
241 esac
104d25b7
JH
242 ;;
243esac
244EOCBU
245
313489a2 246#
e60a08f8
JH
247# Unset temporary variables no more needed.
248#
249
250unset _DEC_cc_style
251
252#
8e964347
AB
253# History:
254#
85ab1d1d
JH
255# perl5.005_51:
256#
257# September-1998 Jarkko Hietaniemi <jhi@iki.fi>
258#
259# * Added the -DNO_EFF_ONLY_OK flag ('use filetest;' support).
260#
313489a2
SB
261# perl5.004_57:
262#
263# 19-Dec-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
264#
85ab1d1d 265# * Newer Digital UNIX compilers enforce signaling for NaN without
313489a2
SB
266# -ieee. Added -fprm d at the same time since it's friendlier for
267# embedding.
268#
269# * Fixed the library search path to match cc, ld, and /sbin/loader.
270#
271# * Default to building -Duseshrplib on newer systems. -Uuseshrplib
272# still overrides.
273#
274# * Fix -pthread additions for useshrplib. ld has no -pthread option.
275#
276#
723e14d4
SB
277# perl5.004_04:
278#
279# 19-Sep-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
280#
281# * libnet on Digital UNIX is for JAVA, not for sockets.
282#
283#
b971f6e4
PP
284# perl5.003_28:
285#
286# 22-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
287#
288# * Restructuring Spider's suggestions.
289#
290# * Older Digital UNIXes cannot handle -Olimit ... for $lddlflags.
291#
292# * ld -s cannot be used in older Digital UNIXes when doing shared.
293#
294#
295# 21-Feb-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
296#
297# * -hidden removed.
298#
299# * -DSTANDARD_C removed.
300#
301# * -D_INTRINSICS added. (that -fast does not seem to buy much confirmed)
302#
303# * odbm not in libc, only ndbm. Therefore dbm back to $libswanted.
304#
305# * -msym for the newer runtime loaders.
306#
307# * $optimize also in $lddflags.
308#
309#
e60a08f8
JH
310# perl5.003_27:
311#
312# 18-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
313#
314# * unset _DEC_cc_style and more commentary on -std.
315#
316#
dfa3a3d3
CS
317# perl5.003_26:
318#
319# 15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
320#
e60a08f8 321# * -std and -ansi.
dfa3a3d3
CS
322#
323#
f2c69087
JH
324# perl5.003_24:
325#
326# 30-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
327#
328# * Fixing the note on -DDEBUGGING.
329#
330# * Note on -O5 -fast.
331#
332#
8a019ce7
JH
333# perl5.003_23:
334#
335# 26-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
336#
337# * Notes on how to do both optimisation and debugging.
338#
339#
340# 25-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
341#
342# * Remove unneeded libraries from $libswanted: PW, bsd, c, dbm
343#
344# * Restructure the $lddlflags build.
345#
346# * $optimize based on which compiler we have.
347#
348#
8e964347
AB
349# perl5.003_22:
350#
351# 23-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
352#
353# * Added comments 'how to create a debugging version of perl'
354#
355# * Fixed logic of this script to prevent stripping of shared
356# objects by the loader (see ld man page for -s) is debugging
357# is set via the -g switch.
358#
359#
360# 21-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
361#
362# * now 'dl' is always removed from libswanted. Not only if
363# optimize is an empty string.
364#
365#
366# 17-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
367#
368# * Removed 'dl' from libswanted: When the FreePort binary
369# translator for Sun binaries is installed Configure concludes
370# that it should use libdl.x.yz.fpx.so :-(
371# Because the dlopen, dlclose,... calls are in the
372# C library it not necessary at all to check for the
373# dl library. Therefore dl is removed from libswanted.
374#
375#
376# 1-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
377#
378# * Set -Olimit to 3200 because perl_yylex.c got too big
379# for the optimizer.
380#