Merge maint-5.004 branch (5.004_04) with mainline.
[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 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 # libnet contains nothing useful for perl here, and doesn't work
121 libswanted="`echo $libswanted | sed -e 's/ net / /'`"
122
123 # libbsd contains nothing used by perl that is not already in libc
124 libswanted="`echo $libswanted | sed -e 's/ bsd / /'`"
125
126 # libc need not be separately listed
127 libswanted="`echo $libswanted | sed -e 's/ c / /'`"
128
129 # ndbm is already in libc
130 libswanted="`echo $libswanted | sed -e 's/ ndbm / /'`"
131
132 # the basic lddlflags used always
133 lddlflags='-shared -expect_unresolved "*"'
134
135 # Fancy compiler suites use optimising linker as well as compiler.
136 # <spider@Orb.Nashua.NH.US>
137 case "$_DEC_uname_r" in
138 *[123].*)       # old loader
139                 lddlflags="$lddlflags -O3"
140                 ;;
141 *)              lddlflags="$lddlflags $optimize -msym"
142                 # -msym: If using a sufficiently recent /sbin/loader,
143                 # keep the module symbols with the modules.
144                 ;;
145 esac
146 # Yes, the above loses if gcc does not use the system linker.
147 # If that happens, let me know about it. <jhi@iki.fi>
148
149
150 # If debugging or (old systems and doing shared)
151 # then do not strip the lib, otherwise, strip.
152 # As noted above the -DDEBUGGING is added automagically by Configure if -g.
153 case "$optimize" in
154         *-g*) ;; # left intentionally blank
155 *)      case "$_DEC_uname_r" in
156         *[123].*)
157                 case "$useshrplib" in
158                 false|undef|'') lddlflags="$lddlflags -s"       ;;
159                 esac
160                 ;;
161         *) lddlflags="$lddlflags -s"
162                 ;;
163         esac
164         ;;
165 esac
166
167 if [ "X$usethreads" != "X" ]; then
168     ccflags="-DUSE_THREADS $ccflags"
169     optimize="-pthread $optimize"
170     ldflags="-pthread $ldflags"
171     set `echo X "$libswanted "| sed -e 's/ c / pthread c_r /'`
172     shift
173     libswanted="$*"
174     usemymalloc='n'
175 fi
176
177 #
178 # Unset temporary variables no more needed.
179 #
180
181 unset _DEC_cc_style
182 unset _DEC_uname_r
183     
184 #
185 # History:
186 #
187 # perl5.004_04:
188 #
189 #       19-Sep-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
190 #
191 #       * libnet on Digital UNIX is for JAVA, not for sockets.
192 #
193 #
194 # perl5.003_28:
195 #
196 #       22-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
197 #
198 #       * Restructuring Spider's suggestions.
199 #
200 #       * Older Digital UNIXes cannot handle -Olimit ... for $lddlflags.
201 #       
202 #       * ld -s cannot be used in older Digital UNIXes when doing shared.
203 #
204 #
205 #       21-Feb-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
206 #
207 #       * -hidden removed.
208 #       
209 #       * -DSTANDARD_C removed.
210 #
211 #       * -D_INTRINSICS added. (that -fast does not seem to buy much confirmed)
212 #
213 #       * odbm not in libc, only ndbm. Therefore dbm back to $libswanted.
214 #
215 #       * -msym for the newer runtime loaders.
216 #
217 #       * $optimize also in $lddflags.
218 #
219 #
220 # perl5.003_27:
221 #
222 #       18-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
223 #
224 #       * unset _DEC_cc_style and more commentary on -std.
225 #
226 #
227 # perl5.003_26:
228 #
229 #       15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
230 #
231 #       * -std and -ansi.
232 #
233 #
234 # perl5.003_24:
235 #
236 #       30-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
237 #
238 #       * Fixing the note on -DDEBUGGING.
239 #
240 #       * Note on -O5 -fast.
241 #
242 #
243 # perl5.003_23:
244 #
245 #       26-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
246 #
247 #       * Notes on how to do both optimisation and debugging.
248 #
249 #
250 #       25-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
251 #
252 #       * Remove unneeded libraries from $libswanted: PW, bsd, c, dbm
253 #
254 #       * Restructure the $lddlflags build.
255 #
256 #       * $optimize based on which compiler we have.
257 #
258 #
259 # perl5.003_22:
260 #
261 #       23-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
262 #
263 #       * Added comments 'how to create a debugging version of perl'
264 #
265 #       * Fixed logic of this script to prevent stripping of shared
266 #         objects by the loader (see ld man page for -s) is debugging
267 #         is set via the -g switch.
268 #
269 #
270 #       21-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
271 #
272 #       * now 'dl' is always removed from libswanted. Not only if
273 #         optimize is an empty string.
274 #        
275 #
276 #       17-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
277 #
278 #       * Removed 'dl' from libswanted: When the FreePort binary
279 #         translator for Sun binaries is installed Configure concludes
280 #         that it should use libdl.x.yz.fpx.so :-(
281 #         Because the dlopen, dlclose,... calls are in the
282 #         C library it not necessary at all to check for the
283 #         dl library.  Therefore dl is removed from libswanted.
284 #       
285 #
286 #       1-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
287 #       
288 #       * Set -Olimit to 3200 because perl_yylex.c got too big
289 #         for the optimizer.
290 #