a few random cleanups
[p5sagit/p5-mst-13.2.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 the leading tabs
62 # Configure Black Magic (TM)
63         # reset
64         _DEC_cc_style=
65 case "$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
71                         _DEC_cc_style=new
72                         ;;
73         *)              # we have the old MIPS CC
74                         _DEC_cc_style=old
75                         ;;
76         esac
77         # cleanup
78         rm -f /tmp/taint$$.o
79         ;;
80 esac
81
82 # be nauseatingly ANSI
83 case "$cc" in
84 *gcc*)  ccflags="$ccflags -ansi"
85         ;;
86 *)      ccflags="$ccflags -std"
87         ;;
88 esac
89
90 # for gcc the Configure knows about the -fpic:
91 # position-independent code for dynamic loading
92
93 # we want optimisation
94
95 case "$optimize" in
96 '')     case "$cc" in 
97         *gcc*)  
98                 optimize='-O3'                          ;;
99         *)      case "$_DEC_cc_style" in
100                 new)    optimize='-O4'
101                         ccflags="$ccflags -fprm d -ieee"
102                         ;;
103                 old)    optimize='-O2 -Olimit 3200'     ;;
104                 esac
105                 ccflags="$ccflags -D_INTRINSICS"
106                 ;;
107         esac
108         ;;
109 esac
110
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.
119 glibpth="/usr/shlib /usr/ccs/lib /usr/lib/cmplrs/cc"
120 glibpth="$glibpth /usr/lib /usr/local/lib /var/shlib"
121
122 # dlopen() is in libc
123 libswanted="`echo $libswanted | sed -e 's/ dl / /'`"
124
125 # libPW contains nothing useful for perl
126 libswanted="`echo $libswanted | sed -e 's/ PW / /'`"
127
128 # libnet contains nothing useful for perl here, and doesn't work
129 libswanted="`echo $libswanted | sed -e 's/ net / /'`"
130
131 # libbsd contains nothing used by perl that is not already in libc
132 libswanted="`echo $libswanted | sed -e 's/ bsd / /'`"
133
134 # libc need not be separately listed
135 libswanted="`echo $libswanted | sed -e 's/ c / /'`"
136
137 # ndbm is already in libc
138 libswanted="`echo $libswanted | sed -e 's/ ndbm / /'`"
139
140 # the basic lddlflags used always
141 lddlflags='-shared -expect_unresolved "*"'
142
143 # Fancy compiler suites use optimising linker as well as compiler.
144 # <spider@Orb.Nashua.NH.US>
145 case "`uname -r`" in
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                 ;;
153 esac
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
157
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.
161 case "$optimize" in
162         *-g*) ;; # left intentionally blank
163 *)      case "`uname -r`" in
164         *[123].*)
165                 case "$useshrplib" in
166                 false|undef|'') lddlflags="$lddlflags -s"       ;;
167                 esac
168                 ;;
169         *) lddlflags="$lddlflags -s"
170                 ;;
171         esac
172         ;;
173 esac
174
175 #
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
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
186
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().
191
192 pp_sys_cflags='ccflags="$ccflags -DNO_EFF_ONLY_OK"'
193
194 #
195 # Unset temporary variables no more needed.
196 #
197
198 unset _DEC_cc_style
199     
200 #
201 # History:
202 #
203 # perl5.005_51:
204 #
205 #       September-1998 Jarkko Hietaniemi <jhi@iki.fi>
206 #
207 #       * Added the -DNO_EFF_ONLY_OK flag ('use filetest;' support).
208 #
209 # perl5.004_57:
210 #
211 #       19-Dec-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
212 #
213 #       * Newer Digital UNIX compilers enforce signaling for NaN without
214 #         -ieee.  Added -fprm d at the same time since it's friendlier for
215 #         embedding.
216 #
217 #       * Fixed the library search path to match cc, ld, and /sbin/loader.
218 #
219 #       * Default to building -Duseshrplib on newer systems.  -Uuseshrplib
220 #         still overrides.
221 #
222 #       * Fix -pthread additions for useshrplib.  ld has no -pthread option.
223 #
224 #
225 # perl5.004_04:
226 #
227 #       19-Sep-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
228 #
229 #       * libnet on Digital UNIX is for JAVA, not for sockets.
230 #
231 #
232 # perl5.003_28:
233 #
234 #       22-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
235 #
236 #       * Restructuring Spider's suggestions.
237 #
238 #       * Older Digital UNIXes cannot handle -Olimit ... for $lddlflags.
239 #       
240 #       * ld -s cannot be used in older Digital UNIXes when doing shared.
241 #
242 #
243 #       21-Feb-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
244 #
245 #       * -hidden removed.
246 #       
247 #       * -DSTANDARD_C removed.
248 #
249 #       * -D_INTRINSICS added. (that -fast does not seem to buy much confirmed)
250 #
251 #       * odbm not in libc, only ndbm. Therefore dbm back to $libswanted.
252 #
253 #       * -msym for the newer runtime loaders.
254 #
255 #       * $optimize also in $lddflags.
256 #
257 #
258 # perl5.003_27:
259 #
260 #       18-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
261 #
262 #       * unset _DEC_cc_style and more commentary on -std.
263 #
264 #
265 # perl5.003_26:
266 #
267 #       15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
268 #
269 #       * -std and -ansi.
270 #
271 #
272 # perl5.003_24:
273 #
274 #       30-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
275 #
276 #       * Fixing the note on -DDEBUGGING.
277 #
278 #       * Note on -O5 -fast.
279 #
280 #
281 # perl5.003_23:
282 #
283 #       26-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
284 #
285 #       * Notes on how to do both optimisation and debugging.
286 #
287 #
288 #       25-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
289 #
290 #       * Remove unneeded libraries from $libswanted: PW, bsd, c, dbm
291 #
292 #       * Restructure the $lddlflags build.
293 #
294 #       * $optimize based on which compiler we have.
295 #
296 #
297 # perl5.003_22:
298 #
299 #       23-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
300 #
301 #       * Added comments 'how to create a debugging version of perl'
302 #
303 #       * Fixed logic of this script to prevent stripping of shared
304 #         objects by the loader (see ld man page for -s) is debugging
305 #         is set via the -g switch.
306 #
307 #
308 #       21-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
309 #
310 #       * now 'dl' is always removed from libswanted. Not only if
311 #         optimize is an empty string.
312 #        
313 #
314 #       17-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
315 #
316 #       * Removed 'dl' from libswanted: When the FreePort binary
317 #         translator for Sun binaries is installed Configure concludes
318 #         that it should use libdl.x.yz.fpx.so :-(
319 #         Because the dlopen, dlclose,... calls are in the
320 #         C library it not necessary at all to check for the
321 #         dl library.  Therefore dl is removed from libswanted.
322 #       
323 #
324 #       1-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
325 #       
326 #       * Set -Olimit to 3200 because perl_yylex.c got too big
327 #         for the optimizer.
328 #