This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
5.004 removed deprecated %OVERLOAD support silently
[perl5.git] / hints / dec_osf.sh
1 # hints/dec_osf.sh
2
3 #       * If you want to debug perl or want to send a
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 #
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 #
13 #       * gcc can always have both -g and optimisation on.
14 #
15 #       * debugging optimised code, no matter what compiler
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 #
22 #       * Configure will automatically add the often quoted
23 #       -DDEBUGGING for you if the -g is specified.
24 #
25 #       * There is even more optimisation available in the new
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.
33 #
34 #       * The -std is needed because the following compiled
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 #
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 #
53
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
61 # do NOT, I repeat, *NOT* take away those leading tabs
62         # reset
63         _DEC_uname_r=
64         _DEC_cc_style=
65         # set
66         _DEC_uname_r=`uname -r`
67         # _DEC_cc_style set soon below
68 # Configure Black Magic (TM)
69
70 case "$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
76                         _DEC_cc_style=new
77                         ;;
78         *)              # we have the old MIPS CC
79                         _DEC_cc_style=old
80                         ;;
81         esac
82         # cleanup
83         rm -f /tmp/taint$$.o
84         ;;
85 esac
86
87 # be nauseatingly ANSI
88 case "$cc" in
89 *gcc*)  ccflags="$ccflags -ansi"
90         ;;
91 *)      ccflags="$ccflags -std"
92         ;;
93 esac
94
95 # for gcc the Configure knows about the -fpic:
96 # position-independent code for dynamic loading
97
98 # we want optimisation
99
100 case "$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
108                 ccflags="$ccflags -D_INTRINSICS"
109                 ;;
110         esac
111         ;;
112 esac
113
114 # dlopen() is in libc
115 libswanted="`echo $libswanted | sed -e 's/ dl / /'`"
116
117 # libPW contains nothing useful for perl
118 libswanted="`echo $libswanted | sed -e 's/ PW / /'`"
119
120 # libbsd contains nothing used by perl that is not already in libc
121 libswanted="`echo $libswanted | sed -e 's/ bsd / /'`"
122
123 # libc need not be separately listed
124 libswanted="`echo $libswanted | sed -e 's/ c / /'`"
125
126 # ndbm is already in libc
127 libswanted="`echo $libswanted | sed -e 's/ ndbm / /'`"
128
129 # the basic lddlflags used always
130 lddlflags='-shared -expect_unresolved "*"'
131
132 # Fancy compiler suites use optimising linker as well as compiler.
133 # <spider@Orb.Nashua.NH.US>
134 case "$_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                 ;;
142 esac
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
146
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.
150 case "$optimize" in
151         *-g*) ;; # left intentionally blank
152 *)      case "$_DEC_uname_r" in
153         *[123].*)
154                 case "$useshrplib" in
155                 false|undef|'') lddlflags="$lddlflags -s"       ;;
156                 esac
157                 ;;
158         *) lddlflags="$lddlflags -s"
159                 ;;
160         esac
161         ;;
162 esac
163
164 #
165 # Unset temporary variables no more needed.
166 #
167
168 unset _DEC_cc_style
169 unset _DEC_uname_r
170     
171 #
172 # History:
173 #
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 #
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 #
207 # perl5.003_26:
208 #
209 #       15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
210 #
211 #       * -std and -ansi.
212 #
213 #
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 #
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 #
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 #