This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
cba8db2f3b221b4e87daaa124d650ba1e590cb55
[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 cc=${cc:-cc}
62
63 # do NOT, I repeat, *NOT* take away the leading tabs
64 # Configure Black Magic (TM)
65         # reset
66         _DEC_cc_style=
67 case "`$cc -v 2>&1 | grep cc`" in
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 taint$$.o 2>&1`" in
72         */gemc_cc*)     # we have the new DEC GEM CC
73                         _DEC_cc_style=new
74                         ;;
75         *)              # we have the old MIPS CC
76                         _DEC_cc_style=old
77                         ;;
78         esac
79         # cleanup
80         rm -f taint$$.o
81         ;;
82 esac
83
84 # be nauseatingly ANSI
85 case "`$cc -v 2>&1 | grep gcc`" in
86 *gcc*)  ccflags="$ccflags -ansi"
87         ;;
88 *)      ccflags="$ccflags -std"
89         ;;
90 esac
91
92 # for gcc the Configure knows about the -fpic:
93 # position-independent code for dynamic loading
94
95 # we want optimisation
96
97 case "$optimize" in
98 '')     case "`$cc -v 2>&1 | grep gcc`" in
99         *gcc*)  
100                 optimize='-O3'                          ;;
101         *)      case "$_DEC_cc_style" in
102                 new)    optimize='-O4'
103                         ccflags="$ccflags -fprm d -ieee"
104                         ;;
105                 old)    optimize='-O2 -Olimit 3200'     ;;
106                 esac
107                 ccflags="$ccflags -D_INTRINSICS"
108                 ;;
109         esac
110         ;;
111 esac
112
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.
121 glibpth="/usr/shlib /usr/ccs/lib /usr/lib/cmplrs/cc"
122 glibpth="$glibpth /usr/lib /usr/local/lib /var/shlib"
123
124 # dlopen() is in libc
125 libswanted="`echo $libswanted | sed -e 's/ dl / /'`"
126
127 # libPW contains nothing useful for perl
128 libswanted="`echo $libswanted | sed -e 's/ PW / /'`"
129
130 # libnet contains nothing useful for perl here, and doesn't work
131 libswanted="`echo $libswanted | sed -e 's/ net / /'`"
132
133 # libbsd contains nothing used by perl that is not already in libc
134 libswanted="`echo $libswanted | sed -e 's/ bsd / /'`"
135
136 # libc need not be separately listed
137 libswanted="`echo $libswanted | sed -e 's/ c / /'`"
138
139 # ndbm is already in libc
140 libswanted="`echo $libswanted | sed -e 's/ ndbm / /'`"
141
142 # the basic lddlflags used always
143 lddlflags='-shared -expect_unresolved "*"'
144
145 # Fancy compiler suites use optimising linker as well as compiler.
146 # <spider@Orb.Nashua.NH.US>
147 case "`uname -r`" in
148 *[123].*)       # old loader
149                 lddlflags="$lddlflags -O3"
150                 ;;
151 *)            if $test "X$optimize" = "X$undef"; then
152                       lddlflags="$lddlflags -msym"
153               else
154                   case "`/usr/sbin/sizer -v`" in
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.
165                   lddlflags="$lddlflags -msym -std"
166               fi
167                 ;;
168 esac
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
172
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.
176 case "$optimize" in
177         *-g*) ;; # left intentionally blank
178 *)      case "`uname -r`" in
179         *[123].*)
180                 case "$useshrplib" in
181                 false|undef|'') lddlflags="$lddlflags -s"       ;;
182                 esac
183                 ;;
184         *) lddlflags="$lddlflags -s"
185                 ;;
186         esac
187         ;;
188 esac
189
190 #
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
196 case "$_DEC_cc_style.$useshrplib" in
197         new.)   useshrplib="$define"    ;;
198 esac
199
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().
204
205 # Fixed in V5.0A.
206 case "`/usr/sbin/sizer -v`" in
207 *5.0[A-Z]*|*5.[1-9]*|*[6-9].[0-9]*)
208         : ok
209         ;;
210 *)
211 # V5.0 or previous
212 pp_sys_cflags='ccflags="$ccflags -DNO_EFF_ONLY_OK"'
213         ;;
214 esac
215
216 # The off_t is already 8 bytes, so we do have largefileness.
217
218 cat > UU/usethreads.cbu <<'EOCBU'
219 # This script UU/usethreads.cbu will get 'called-back' by Configure 
220 # after it has prompted the user for whether to use threads.
221 case "$usethreads" in
222 $define|true|[yY]*)
223         # Threads interfaces changed with V4.0.
224         case "`$cc -v 2>&1 | grep gcc`" in
225         *gcc*)ccflags="-D_REENTRANT $ccflags" ;;
226         *)  case "`uname -r`" in
227             *[123].*)   ccflags="-threads $ccflags" ;;
228             *)          ccflags="-pthread $ccflags" ;;
229             esac
230             ;;
231         esac    
232         case "`uname -r`" in
233         *[123].*) libswanted="$libswanted pthreads mach exc c_r" ;;
234         *)        libswanted="$libswanted pthread exc" ;;
235         esac
236
237         case "$usemymalloc" in
238         '')
239                 usemymalloc='n'
240                 ;;
241         esac
242         ;;
243 esac
244 EOCBU
245
246 cat > UU/uselongdouble.cbu <<'EOCBU'
247 # This script UU/uselongdouble.cbu will get 'called-back' by Configure 
248 # after it has prompted the user for whether to use long doubles.
249 case "$uselongdouble" in
250 $define|true|[yY]*) d_Gconvert='sprintf((b),"%.*Lg",(n),(x))' ;;
251 esac
252 EOCBU
253
254 #
255 # Unset temporary variables no more needed.
256 #
257
258 unset _DEC_cc_style
259     
260 #
261 # History:
262 #
263 # perl5.005_51:
264 #
265 #       September-1998 Jarkko Hietaniemi <jhi@iki.fi>
266 #
267 #       * Added the -DNO_EFF_ONLY_OK flag ('use filetest;' support).
268 #
269 # perl5.004_57:
270 #
271 #       19-Dec-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
272 #
273 #       * Newer Digital UNIX compilers enforce signaling for NaN without
274 #         -ieee.  Added -fprm d at the same time since it's friendlier for
275 #         embedding.
276 #
277 #       * Fixed the library search path to match cc, ld, and /sbin/loader.
278 #
279 #       * Default to building -Duseshrplib on newer systems.  -Uuseshrplib
280 #         still overrides.
281 #
282 #       * Fix -pthread additions for useshrplib.  ld has no -pthread option.
283 #
284 #
285 # perl5.004_04:
286 #
287 #       19-Sep-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
288 #
289 #       * libnet on Digital UNIX is for JAVA, not for sockets.
290 #
291 #
292 # perl5.003_28:
293 #
294 #       22-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
295 #
296 #       * Restructuring Spider's suggestions.
297 #
298 #       * Older Digital UNIXes cannot handle -Olimit ... for $lddlflags.
299 #       
300 #       * ld -s cannot be used in older Digital UNIXes when doing shared.
301 #
302 #
303 #       21-Feb-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
304 #
305 #       * -hidden removed.
306 #       
307 #       * -DSTANDARD_C removed.
308 #
309 #       * -D_INTRINSICS added. (that -fast does not seem to buy much confirmed)
310 #
311 #       * odbm not in libc, only ndbm. Therefore dbm back to $libswanted.
312 #
313 #       * -msym for the newer runtime loaders.
314 #
315 #       * $optimize also in $lddflags.
316 #
317 #
318 # perl5.003_27:
319 #
320 #       18-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
321 #
322 #       * unset _DEC_cc_style and more commentary on -std.
323 #
324 #
325 # perl5.003_26:
326 #
327 #       15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
328 #
329 #       * -std and -ansi.
330 #
331 #
332 # perl5.003_24:
333 #
334 #       30-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
335 #
336 #       * Fixing the note on -DDEBUGGING.
337 #
338 #       * Note on -O5 -fast.
339 #
340 #
341 # perl5.003_23:
342 #
343 #       26-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
344 #
345 #       * Notes on how to do both optimisation and debugging.
346 #
347 #
348 #       25-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
349 #
350 #       * Remove unneeded libraries from $libswanted: PW, bsd, c, dbm
351 #
352 #       * Restructure the $lddlflags build.
353 #
354 #       * $optimize based on which compiler we have.
355 #
356 #
357 # perl5.003_22:
358 #
359 #       23-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
360 #
361 #       * Added comments 'how to create a debugging version of perl'
362 #
363 #       * Fixed logic of this script to prevent stripping of shared
364 #         objects by the loader (see ld man page for -s) is debugging
365 #         is set via the -g switch.
366 #
367 #
368 #       21-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
369 #
370 #       * now 'dl' is always removed from libswanted. Not only if
371 #         optimize is an empty string.
372 #        
373 #
374 #       17-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
375 #
376 #       * Removed 'dl' from libswanted: When the FreePort binary
377 #         translator for Sun binaries is installed Configure concludes
378 #         that it should use libdl.x.yz.fpx.so :-(
379 #         Because the dlopen, dlclose,... calls are in the
380 #         C library it not necessary at all to check for the
381 #         dl library.  Therefore dl is removed from libswanted.
382 #       
383 #
384 #       1-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
385 #       
386 #       * Set -Olimit to 3200 because perl_yylex.c got too big
387 #         for the optimizer.
388 #