This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
lib/timelocal.t fails test 1 for VMS 7.1
[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
b971f6e4
PP
61# do NOT, I repeat, *NOT* take away those leading tabs
62 # reset
63 _DEC_uname_r=
e60a08f8 64 _DEC_cc_style=
b971f6e4
PP
65 # set
66 _DEC_uname_r=`uname -r`
67 # _DEC_cc_style set soon below
e60a08f8
JH
68# Configure Black Magic (TM)
69
70case "$cc" in
71*gcc*) ;; # pass
72*) # compile something small: taint.c is fine for this.
73 # the main point is the '-v' flag of 'cc'.
74 case "`cc -v -I. -c taint.c -o /tmp/taint$$.o 2>&1`" in
75 */gemc_cc*) # we have the new DEC GEM CC
dfa3a3d3 76 _DEC_cc_style=new
8a019ce7 77 ;;
e60a08f8 78 *) # we have the old MIPS CC
dfa3a3d3 79 _DEC_cc_style=old
8a019ce7 80 ;;
e60a08f8
JH
81 esac
82 # cleanup
83 rm -f /tmp/taint$$.o
84 ;;
85esac
86
b971f6e4
PP
87# be nauseatingly ANSI
88case "$cc" in
9607fc9c 89*gcc*) ccflags="$ccflags -ansi"
b971f6e4
PP
90 ;;
91*) ccflags="$ccflags -std"
92 ;;
93esac
94
95# for gcc the Configure knows about the -fpic:
96# position-independent code for dynamic loading
97
e60a08f8
JH
98# we want optimisation
99
100case "$optimize" in
101'') case "$cc" in
102 *gcc*)
103 optimize='-O3' ;;
104 *) case "$_DEC_cc_style" in
105 new) optimize='-O4' ;;
106 old) optimize='-O2 -Olimit 3200' ;;
107 esac
b971f6e4 108 ccflags="$ccflags -D_INTRINSICS"
e60a08f8 109 ;;
8e964347
AB
110 esac
111 ;;
1fc4cb55 112esac
28757baa 113
8e964347
AB
114# dlopen() is in libc
115libswanted="`echo $libswanted | sed -e 's/ dl / /'`"
116
b971f6e4 117# libPW contains nothing useful for perl
8a019ce7
JH
118libswanted="`echo $libswanted | sed -e 's/ PW / /'`"
119
b971f6e4 120# libbsd contains nothing used by perl that is not already in libc
8a019ce7
JH
121libswanted="`echo $libswanted | sed -e 's/ bsd / /'`"
122
b971f6e4 123# libc need not be separately listed
8a019ce7
JH
124libswanted="`echo $libswanted | sed -e 's/ c / /'`"
125
b971f6e4
PP
126# ndbm is already in libc
127libswanted="`echo $libswanted | sed -e 's/ ndbm / /'`"
8a019ce7
JH
128
129# the basic lddlflags used always
130lddlflags='-shared -expect_unresolved "*"'
131
b971f6e4
PP
132# Fancy compiler suites use optimising linker as well as compiler.
133# <spider@Orb.Nashua.NH.US>
134case "$_DEC_uname_r" in
135*[123].*) # old loader
136 lddlflags="$lddlflags -O3"
137 ;;
138*) lddlflags="$lddlflags $optimize -msym"
139 # -msym: If using a sufficiently recent /sbin/loader,
140 # keep the module symbols with the modules.
141 ;;
142esac
143# Yes, the above loses if gcc does not use the system linker.
144# If that happens, let me know about it. <jhi@iki.fi>
145
8a019ce7 146
b971f6e4
PP
147# If debugging or (old systems and doing shared)
148# then do not strip the lib, otherwise, strip.
149# As noted above the -DDEBUGGING is added automagically by Configure if -g.
8a019ce7
JH
150case "$optimize" in
151 *-g*) ;; # left intentionally blank
b971f6e4
PP
152*) case "$_DEC_uname_r" in
153 *[123].*)
154 case "$useshrplib" in
155 false|undef|'') lddlflags="$lddlflags -s" ;;
156 esac
157 ;;
8a019ce7 158 *) lddlflags="$lddlflags -s"
b971f6e4
PP
159 ;;
160 esac
161 ;;
8a019ce7 162esac
8e964347
AB
163
164#
e60a08f8
JH
165# Unset temporary variables no more needed.
166#
167
168unset _DEC_cc_style
b971f6e4 169unset _DEC_uname_r
e60a08f8
JH
170
171#
8e964347
AB
172# History:
173#
b971f6e4
PP
174# perl5.003_28:
175#
176# 22-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
177#
178# * Restructuring Spider's suggestions.
179#
180# * Older Digital UNIXes cannot handle -Olimit ... for $lddlflags.
181#
182# * ld -s cannot be used in older Digital UNIXes when doing shared.
183#
184#
185# 21-Feb-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
186#
187# * -hidden removed.
188#
189# * -DSTANDARD_C removed.
190#
191# * -D_INTRINSICS added. (that -fast does not seem to buy much confirmed)
192#
193# * odbm not in libc, only ndbm. Therefore dbm back to $libswanted.
194#
195# * -msym for the newer runtime loaders.
196#
197# * $optimize also in $lddflags.
198#
199#
e60a08f8
JH
200# perl5.003_27:
201#
202# 18-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
203#
204# * unset _DEC_cc_style and more commentary on -std.
205#
206#
dfa3a3d3
CS
207# perl5.003_26:
208#
209# 15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
210#
e60a08f8 211# * -std and -ansi.
dfa3a3d3
CS
212#
213#
f2c69087
JH
214# perl5.003_24:
215#
216# 30-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
217#
218# * Fixing the note on -DDEBUGGING.
219#
220# * Note on -O5 -fast.
221#
222#
8a019ce7
JH
223# perl5.003_23:
224#
225# 26-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
226#
227# * Notes on how to do both optimisation and debugging.
228#
229#
230# 25-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
231#
232# * Remove unneeded libraries from $libswanted: PW, bsd, c, dbm
233#
234# * Restructure the $lddlflags build.
235#
236# * $optimize based on which compiler we have.
237#
238#
8e964347
AB
239# perl5.003_22:
240#
241# 23-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
242#
243# * Added comments 'how to create a debugging version of perl'
244#
245# * Fixed logic of this script to prevent stripping of shared
246# objects by the loader (see ld man page for -s) is debugging
247# is set via the -g switch.
248#
249#
250# 21-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
251#
252# * now 'dl' is always removed from libswanted. Not only if
253# optimize is an empty string.
254#
255#
256# 17-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
257#
258# * Removed 'dl' from libswanted: When the FreePort binary
259# translator for Sun binaries is installed Configure concludes
260# that it should use libdl.x.yz.fpx.so :-(
261# Because the dlopen, dlclose,... calls are in the
262# C library it not necessary at all to check for the
263# dl library. Therefore dl is removed from libswanted.
264#
265#
266# 1-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
267#
268# * Set -Olimit to 3200 because perl_yylex.c got too big
269# for the optimizer.
270#