Update todo with POSIX 1003.1 1996 Edition reminder.
[p5sagit/p5-mst-13.2.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 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 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 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 23# -DDEBUGGING for you if the -g is specified.
24#
b971f6e4 25# * There is even more optimisation available in the new
f2c69087 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 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 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 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
b691c02f 61# do NOT, I repeat, *NOT* take away the leading tabs
62# Configure Black Magic (TM)
b971f6e4 63 # reset
e60a08f8 64 _DEC_cc_style=
e60a08f8 65case "$cc" in
66*gcc*) ;; # pass
67*) # compile something small: taint.c is fine for this.
68 # the main point is the '-v' flag of 'cc'.
69 case "`cc -v -I. -c taint.c -o /tmp/taint$$.o 2>&1`" in
70 */gemc_cc*) # we have the new DEC GEM CC
dfa3a3d3 71 _DEC_cc_style=new
8a019ce7 72 ;;
e60a08f8 73 *) # we have the old MIPS CC
dfa3a3d3 74 _DEC_cc_style=old
8a019ce7 75 ;;
e60a08f8 76 esac
77 # cleanup
78 rm -f /tmp/taint$$.o
79 ;;
80esac
81
b971f6e4 82# be nauseatingly ANSI
83case "$cc" in
9607fc9c 84*gcc*) ccflags="$ccflags -ansi"
b971f6e4 85 ;;
86*) ccflags="$ccflags -std"
87 ;;
88esac
89
90# for gcc the Configure knows about the -fpic:
91# position-independent code for dynamic loading
92
e60a08f8 93# we want optimisation
94
95case "$optimize" in
96'') case "$cc" in
97 *gcc*)
98 optimize='-O3' ;;
99 *) case "$_DEC_cc_style" in
313489a2 100 new) optimize='-O4'
101 ccflags="$ccflags -fprm d -ieee"
102 ;;
e60a08f8 103 old) optimize='-O2 -Olimit 3200' ;;
104 esac
b971f6e4 105 ccflags="$ccflags -D_INTRINSICS"
e60a08f8 106 ;;
8e964347 107 esac
108 ;;
1fc4cb55 109esac
28757baa 110
313489a2 111# Make glibpth agree with the compiler suite. Note that /shlib
112# is not here. That's on purpose. Even though that's where libc
113# really lives from V4.0 on, the linker (and /sbin/loader) won't
114# look there by default. The sharable /sbin utilities were all
115# built with "-Wl,-rpath,/shlib" to get around that. This makes
116# no attempt to figure out the additional location(s) searched by
117# gcc, since not all versions of gcc are easily coerced into
118# revealing that information.
b0362887 119glibpth="/usr/shlib /usr/ccs/lib /usr/lib/cmplrs/cc"
120glibpth="$glibpth /usr/lib /usr/local/lib /var/shlib"
313489a2 121
8e964347 122# dlopen() is in libc
123libswanted="`echo $libswanted | sed -e 's/ dl / /'`"
124
b971f6e4 125# libPW contains nothing useful for perl
8a019ce7 126libswanted="`echo $libswanted | sed -e 's/ PW / /'`"
127
723e14d4 128# libnet contains nothing useful for perl here, and doesn't work
129libswanted="`echo $libswanted | sed -e 's/ net / /'`"
130
b971f6e4 131# libbsd contains nothing used by perl that is not already in libc
8a019ce7 132libswanted="`echo $libswanted | sed -e 's/ bsd / /'`"
133
b971f6e4 134# libc need not be separately listed
8a019ce7 135libswanted="`echo $libswanted | sed -e 's/ c / /'`"
136
b971f6e4 137# ndbm is already in libc
138libswanted="`echo $libswanted | sed -e 's/ ndbm / /'`"
8a019ce7 139
140# the basic lddlflags used always
141lddlflags='-shared -expect_unresolved "*"'
142
b971f6e4 143# Fancy compiler suites use optimising linker as well as compiler.
144# <spider@Orb.Nashua.NH.US>
b8f0c030 145case "`uname -r`" in
b971f6e4 146*[123].*) # old loader
147 lddlflags="$lddlflags -O3"
148 ;;
149*) lddlflags="$lddlflags $optimize -msym"
150 # -msym: If using a sufficiently recent /sbin/loader,
151 # keep the module symbols with the modules.
152 ;;
153esac
154# Yes, the above loses if gcc does not use the system linker.
155# If that happens, let me know about it. <jhi@iki.fi>
156
8a019ce7 157
b971f6e4 158# If debugging or (old systems and doing shared)
159# then do not strip the lib, otherwise, strip.
160# As noted above the -DDEBUGGING is added automagically by Configure if -g.
8a019ce7 161case "$optimize" in
162 *-g*) ;; # left intentionally blank
b8f0c030 163*) case "`uname -r`" in
b971f6e4 164 *[123].*)
165 case "$useshrplib" in
166 false|undef|'') lddlflags="$lddlflags -s" ;;
167 esac
168 ;;
8a019ce7 169 *) lddlflags="$lddlflags -s"
b971f6e4 170 ;;
171 esac
172 ;;
8a019ce7 173esac
8e964347 174
175#
313489a2 176# Make embedding in things like INN and Apache more memory friendly.
177# Keep it overridable on the Configure command line, though, so that
178# "-Uuseshrplib" prevents this default.
179#
180
e7f07268 181# This or the glibpth change above breaks the build. Commented out
182# for this snapshot.
183#case "$_DEC_cc_style.$useshrplib" in
184# new.) useshrplib="$define" ;;
185#esac
313489a2 186
85ab1d1d 187# The EFF_ONLY_OK from <sys/access.h> is present but dysfunctional for
188# [RWX]_OK as of Digital UNIX 4.0[A-D]?. If and when this gets fixed,
189# please adjust this appropriately. See also pp_sys.c just before the
190# emulate_eaccess().
5ff3f7a4 191
192pp_sys_cflags='ccflags="$ccflags -DNO_EFF_ONLY_OK"'
193
104d25b7 194# This script UU/usethreads.cbu will get 'called-back' by Configure
195# after it has prompted the user for whether to use threads.
196cat > UU/usethreads.cbu <<'EOCBU'
197case "$usethreads" in
198$define|true|[yY]*)
199 # Threads interfaces changed with V4.0.
200 case "`uname -r`" in
201 *[123].*)
202 libswanted="$libswanted pthreads mach exc c_r"
203 ccflags="-threads $ccflags"
204 ;;
205 *)
206 libswanted="$libswanted pthread exc"
207 ccflags="-pthread $ccflags"
208 ;;
209 esac
210
211 usemymalloc='n'
212 ;;
213esac
214EOCBU
215
313489a2 216#
e60a08f8 217# Unset temporary variables no more needed.
218#
219
220unset _DEC_cc_style
221
222#
8e964347 223# History:
224#
85ab1d1d 225# perl5.005_51:
226#
227# September-1998 Jarkko Hietaniemi <jhi@iki.fi>
228#
229# * Added the -DNO_EFF_ONLY_OK flag ('use filetest;' support).
230#
313489a2 231# perl5.004_57:
232#
233# 19-Dec-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
234#
85ab1d1d 235# * Newer Digital UNIX compilers enforce signaling for NaN without
313489a2 236# -ieee. Added -fprm d at the same time since it's friendlier for
237# embedding.
238#
239# * Fixed the library search path to match cc, ld, and /sbin/loader.
240#
241# * Default to building -Duseshrplib on newer systems. -Uuseshrplib
242# still overrides.
243#
244# * Fix -pthread additions for useshrplib. ld has no -pthread option.
245#
246#
723e14d4 247# perl5.004_04:
248#
249# 19-Sep-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
250#
251# * libnet on Digital UNIX is for JAVA, not for sockets.
252#
253#
b971f6e4 254# perl5.003_28:
255#
256# 22-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
257#
258# * Restructuring Spider's suggestions.
259#
260# * Older Digital UNIXes cannot handle -Olimit ... for $lddlflags.
261#
262# * ld -s cannot be used in older Digital UNIXes when doing shared.
263#
264#
265# 21-Feb-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
266#
267# * -hidden removed.
268#
269# * -DSTANDARD_C removed.
270#
271# * -D_INTRINSICS added. (that -fast does not seem to buy much confirmed)
272#
273# * odbm not in libc, only ndbm. Therefore dbm back to $libswanted.
274#
275# * -msym for the newer runtime loaders.
276#
277# * $optimize also in $lddflags.
278#
279#
e60a08f8 280# perl5.003_27:
281#
282# 18-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
283#
284# * unset _DEC_cc_style and more commentary on -std.
285#
286#
dfa3a3d3 287# perl5.003_26:
288#
289# 15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
290#
e60a08f8 291# * -std and -ansi.
dfa3a3d3 292#
293#
f2c69087 294# perl5.003_24:
295#
296# 30-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
297#
298# * Fixing the note on -DDEBUGGING.
299#
300# * Note on -O5 -fast.
301#
302#
8a019ce7 303# perl5.003_23:
304#
305# 26-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
306#
307# * Notes on how to do both optimisation and debugging.
308#
309#
310# 25-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
311#
312# * Remove unneeded libraries from $libswanted: PW, bsd, c, dbm
313#
314# * Restructure the $lddlflags build.
315#
316# * $optimize based on which compiler we have.
317#
318#
8e964347 319# perl5.003_22:
320#
321# 23-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
322#
323# * Added comments 'how to create a debugging version of perl'
324#
325# * Fixed logic of this script to prevent stripping of shared
326# objects by the loader (see ld man page for -s) is debugging
327# is set via the -g switch.
328#
329#
330# 21-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
331#
332# * now 'dl' is always removed from libswanted. Not only if
333# optimize is an empty string.
334#
335#
336# 17-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
337#
338# * Removed 'dl' from libswanted: When the FreePort binary
339# translator for Sun binaries is installed Configure concludes
340# that it should use libdl.x.yz.fpx.so :-(
341# Because the dlopen, dlclose,... calls are in the
342# C library it not necessary at all to check for the
343# dl library. Therefore dl is removed from libswanted.
344#
345#
346# 1-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
347#
348# * Set -Olimit to 3200 because perl_yylex.c got too big
349# for the optimizer.
350#
104d25b7 351
352