[p5sagit/p5-mst-13.2.git] / hints / dec_osf.sh

# hints/dec_osf.sh

#	* If you want to debug perl or want to send a
#	stack trace for inclusion into an bug report, call
#	Configure with the additional argument  -Doptimize=-g2
#	or uncomment this assignment to "optimize":
#
#optimize=-g2
#
#	If you want both to optimise and debug with the DEC cc
#	you must have -g3, e.g. "-O4 -g3", and (re)run Configure.
#
#	* gcc can always have both -g and optimisation on.
#
#	* debugging optimised code, no matter what compiler
#	one is using, can be surprising and confusing because of
#	the optimisation tricks like code motion, code removal,
#	loop unrolling, and inlining. The source code and the
#	executable code simply do not agree any more while in
#	mid-execution, the optimiser only cares about the results.
#
#	* Configure will automatically add the often quoted
#	-DDEBUGGING for you if the -g is specified.
#
#	* There is even more optimisation available in the new
#	(GEM) DEC cc: -O5 and -fast. "man cc" will tell more about them.
#	The jury is still out whether either or neither help for Perl
#	and how much. Based on very quick testing, -fast boosts
#	raw data copy by about 5-15% (-fast brings in, among other
#	things, inlined, ahem, fast memcpy()), while on the other
#	hand searching things (index, m//, s///), seems to get slower.
#	Your mileage will vary.
#
#	* The -std is needed because the following compiled
#	without the -std and linked with -lm
#
#	#include <math.h>
#	#include <stdio.h>
#	int main(){short x=10,y=sqrt(x);printf("%d\n",y);}
#
#	will in Digital UNIX 3.* and 4.0b print 0 -- and in Digital
#	UNIX 4.0{,a} dump core: Floating point exception in the printf(),
#	the y has become a signaling NaN.
#
#	* Compilation warnings like:
#
#	"Undefined the ANSI standard macro ..."
#
#	can be ignored, at least while compiling the POSIX extension
#	and especially if using the sfio (the latter is not a standard
#	part of Perl, never mind if it says little to you).
#

# If using the DEC compiler we must find out the DEC compiler style:
# the style changed between Digital UNIX (aka DEC OSF/1) 3 and
# Digital UNIX 4. The old compiler was originally from Ultrix and
# the MIPS company, the new compiler is originally from the VAX world
# and it is called GEM. Many of the options we are going to use depend
# on the compiler style.

# do NOT, I repeat, *NOT* take away the leading tabs
# Configure Black Magic (TM)
	# reset
	_DEC_cc_style=
case "$cc" in
*gcc*)	;; # pass
*)	# compile something small: taint.c is fine for this.
    	# the main point is the '-v' flag of 'cc'.
       	case "`cc -v -I. -c taint.c -o /tmp/taint$$.o 2>&1`" in
	*/gemc_cc*)	# we have the new DEC GEM CC
			_DEC_cc_style=new
			;;
	*)		# we have the old MIPS CC
			_DEC_cc_style=old
			;;
	esac
	# cleanup
	rm -f /tmp/taint$$.o
	;;
esac

# be nauseatingly ANSI
case "$cc" in
*gcc*)	ccflags="$ccflags -ansi"
	;;
*)	ccflags="$ccflags -std"
	;;
esac

# for gcc the Configure knows about the -fpic:
# position-independent code for dynamic loading

# we want optimisation

case "$optimize" in
'')	case "$cc" in 
	*gcc*)	
		optimize='-O3'				;;
	*)	case "$_DEC_cc_style" in
		new)	optimize='-O4'
			ccflags="$ccflags -fprm d -ieee"
			;;
		old)	optimize='-O2 -Olimit 3200'	;;
	    	esac
		ccflags="$ccflags -D_INTRINSICS"
		;;
	esac
	;;
esac

# Make glibpth agree with the compiler suite.  Note that /shlib
# is not here.  That's on purpose.  Even though that's where libc
# really lives from V4.0 on, the linker (and /sbin/loader) won't
# look there by default.  The sharable /sbin utilities were all
# built with "-Wl,-rpath,/shlib" to get around that.  This makes
# no attempt to figure out the additional location(s) searched by
# gcc, since not all versions of gcc are easily coerced into
# revealing that information.
glibpth="/usr/shlib /usr/ccs/lib /usr/lib/cmplrs/cc"
glibpth="$glibpth /usr/lib /usr/local/lib /var/shlib"

# dlopen() is in libc
libswanted="`echo $libswanted | sed -e 's/ dl / /'`"

# libPW contains nothing useful for perl
libswanted="`echo $libswanted | sed -e 's/ PW / /'`"

# libnet contains nothing useful for perl here, and doesn't work
libswanted="`echo $libswanted | sed -e 's/ net / /'`"

# libbsd contains nothing used by perl that is not already in libc
libswanted="`echo $libswanted | sed -e 's/ bsd / /'`"

# libc need not be separately listed
libswanted="`echo $libswanted | sed -e 's/ c / /'`"

# ndbm is already in libc
libswanted="`echo $libswanted | sed -e 's/ ndbm / /'`"

# the basic lddlflags used always
lddlflags='-shared -expect_unresolved "*"'

# Fancy compiler suites use optimising linker as well as compiler.
# <spider@Orb.Nashua.NH.US>
case "`uname -r`" in
*[123].*)	# old loader
		lddlflags="$lddlflags -O3"
		;;
*)		lddlflags="$lddlflags $optimize -msym"
		# -msym: If using a sufficiently recent /sbin/loader,
		# keep the module symbols with the modules.
		;;
esac
# Yes, the above loses if gcc does not use the system linker.
# If that happens, let me know about it. <jhi@iki.fi>


# If debugging or (old systems and doing shared)
# then do not strip the lib, otherwise, strip.
# As noted above the -DDEBUGGING is added automagically by Configure if -g.
case "$optimize" in
	*-g*) ;; # left intentionally blank
*)	case "`uname -r`" in
	*[123].*)
		case "$useshrplib" in
		false|undef|'')	lddlflags="$lddlflags -s"	;;
		esac
		;;
        *) lddlflags="$lddlflags -s"
	        ;;
    	esac
    	;;
esac

#
# Make embedding in things like INN and Apache more memory friendly.
# Keep it overridable on the Configure command line, though, so that
# "-Uuseshrplib" prevents this default.
#

# This or the glibpth change above breaks the build. Commented out
# for this snapshot.
#case "$_DEC_cc_style.$useshrplib" in
#	new.)	useshrplib="$define"	;;
#esac

# The EFF_ONLY_OK from <sys/access.h> is present but dysfunctional for
# [RWX]_OK as of Digital UNIX 4.0[A-D]?.  If and when this gets fixed,
# please adjust this appropriately.  See also pp_sys.c just before the
# emulate_eaccess().

pp_sys_cflags='ccflags="$ccflags -DNO_EFF_ONLY_OK"'

#
# Unset temporary variables no more needed.
#

unset _DEC_cc_style
    
#
# History:
#
# perl5.005_51:
#
#	September-1998 Jarkko Hietaniemi <jhi@iki.fi>
#
#	* Added the -DNO_EFF_ONLY_OK flag ('use filetest;' support).
#
# perl5.004_57:
#
#	19-Dec-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
#
#	* Newer Digital UNIX compilers enforce signaling for NaN without
#	  -ieee.  Added -fprm d at the same time since it's friendlier for
#	  embedding.
#
#	* Fixed the library search path to match cc, ld, and /sbin/loader.
#
#	* Default to building -Duseshrplib on newer systems.  -Uuseshrplib
#	  still overrides.
#
#	* Fix -pthread additions for useshrplib.  ld has no -pthread option.
#
#
# perl5.004_04:
#
#       19-Sep-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
#
#	* libnet on Digital UNIX is for JAVA, not for sockets.
#
#
# perl5.003_28:
#
#       22-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
#
#	* Restructuring Spider's suggestions.
#
#	* Older Digital UNIXes cannot handle -Olimit ... for $lddlflags.
#	
#	* ld -s cannot be used in older Digital UNIXes when doing shared.
#
#
#       21-Feb-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
#
#	* -hidden removed.
#	
#	* -DSTANDARD_C removed.
#
#	* -D_INTRINSICS added. (that -fast does not seem to buy much confirmed)
#
#	* odbm not in libc, only ndbm. Therefore dbm back to $libswanted.
#
#	* -msym for the newer runtime loaders.
#
#	* $optimize also in $lddflags.
#
#
# perl5.003_27:
#
#	18-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
#
#	* unset _DEC_cc_style and more commentary on -std.
#
#
# perl5.003_26:
#
#	15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
#
#	* -std and -ansi.
#
#
# perl5.003_24:
#
#	30-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
#
#	* Fixing the note on -DDEBUGGING.
#
#	* Note on -O5 -fast.
#
#
# perl5.003_23:
#
#	26-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
#
#	* Notes on how to do both optimisation and debugging.
#
#
#	25-Jan-1997 Jarkko Hietaniemi <jhi@iki.fi>
#
#	* Remove unneeded libraries from $libswanted: PW, bsd, c, dbm
#
#	* Restructure the $lddlflags build.
#
#	* $optimize based on which compiler we have.
#
#
# perl5.003_22:
#
#	23-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
#
#	* Added comments 'how to create a debugging version of perl'
#
#	* Fixed logic of this script to prevent stripping of shared
#         objects by the loader (see ld man page for -s) is debugging
#         is set via the -g switch.
#
#
#	21-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
#
#	* now 'dl' is always removed from libswanted. Not only if
#	  optimize is an empty string.
#	 
#
#	17-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
#
#	* Removed 'dl' from libswanted: When the FreePort binary
#	  translator for Sun binaries is installed Configure concludes
#	  that it should use libdl.x.yz.fpx.so :-(
#	  Because the dlopen, dlclose,... calls are in the
#	  C library it not necessary at all to check for the
#	  dl library.  Therefore dl is removed from libswanted.
#	
#
#	1-Jan-1997 Achim Bohnet <ach@rosat.mpe-garching.mpg.de>
#	
#	* Set -Olimit to 3200 because perl_yylex.c got too big
#	  for the optimizer.
#
Commit	Line	Data
a0d0e21e	1	# hints/dec_osf.sh
8e964347	2
b971f6e4	3	# * If you want to debug perl or want to send a
8e964347	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	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	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	23	# -DDEBUGGING for you if the -g is specified.
f2c69087	24	#
b971f6e4	25	# * There is even more optimisation available in the new
f2c69087	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	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	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	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
b691c02f	61	# do NOT, I repeat, NOT take away the leading tabs
b691c02f	62	# Configure Black Magic (TM)
b971f6e4	63	# reset
e60a08f8	64	_DEC_cc_style=
e60a08f8	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
dfa3a3d3	71	_DEC_cc_style=new
8a019ce7	72	;;
e60a08f8	73	*) # we have the old MIPS CC
dfa3a3d3	74	_DEC_cc_style=old
8a019ce7	75	;;
e60a08f8	76	esac
	77	# cleanup
	78	rm -f /tmp/taint$$.o
	79	;;
	80	esac
	81
b971f6e4	82	# be nauseatingly ANSI
b971f6e4	83	case "$cc" in
9607fc9c	84	gcc) ccflags="$ccflags -ansi"
b971f6e4	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
e60a08f8	93	# we want optimisation
	94
	95	case "$optimize" in
	96	'') case "$cc" in
	97	gcc)
	98	optimize='-O3' ;;
	99	*) case "$_DEC_cc_style" in
313489a2	100	new) optimize='-O4'
	101	ccflags="$ccflags -fprm d -ieee"
	102	;;
e60a08f8	103	old) optimize='-O2 -Olimit 3200' ;;
e60a08f8	104	esac
b971f6e4	105	ccflags="$ccflags -D_INTRINSICS"
e60a08f8	106	;;
8e964347	107	esac
8e964347	108	;;
1fc4cb55	109	esac
28757baa	110
313489a2	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.
b0362887	119	glibpth="/usr/shlib /usr/ccs/lib /usr/lib/cmplrs/cc"
b0362887	120	glibpth="$glibpth /usr/lib /usr/local/lib /var/shlib"
313489a2	121
8e964347	122	# dlopen() is in libc
	123	libswanted="`echo $libswanted \| sed -e 's/ dl / /'`"
	124
b971f6e4	125	# libPW contains nothing useful for perl
8a019ce7	126	libswanted="`echo $libswanted \| sed -e 's/ PW / /'`"
8a019ce7	127
723e14d4	128	# libnet contains nothing useful for perl here, and doesn't work
	129	libswanted="`echo $libswanted \| sed -e 's/ net / /'`"
	130
b971f6e4	131	# libbsd contains nothing used by perl that is not already in libc
8a019ce7	132	libswanted="`echo $libswanted \| sed -e 's/ bsd / /'`"
8a019ce7	133
b971f6e4	134	# libc need not be separately listed
8a019ce7	135	libswanted="`echo $libswanted \| sed -e 's/ c / /'`"
8a019ce7	136
b971f6e4	137	# ndbm is already in libc
b971f6e4	138	libswanted="`echo $libswanted \| sed -e 's/ ndbm / /'`"
8a019ce7	139
	140	# the basic lddlflags used always
	141	lddlflags='-shared -expect_unresolved "*"'
	142
b971f6e4	143	# Fancy compiler suites use optimising linker as well as compiler.
b971f6e4	144	# <spider@Orb.Nashua.NH.US>
b8f0c030	145	case "`uname -r`" in
b971f6e4	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
8a019ce7	157
b971f6e4	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.
8a019ce7	161	case "$optimize" in
8a019ce7	162	-g) ;; # left intentionally blank
b8f0c030	163	*) case "`uname -r`" in
b971f6e4	164	[123].)
	165	case "$useshrplib" in
	166	false\|undef\|'') lddlflags="$lddlflags -s" ;;
	167	esac
	168	;;
8a019ce7	169	*) lddlflags="$lddlflags -s"
b971f6e4	170	;;
	171	esac
	172	;;
8a019ce7	173	esac
8e964347	174
8e964347	175	#
313489a2	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
e7f07268	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
313489a2	186
85ab1d1d	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().
5ff3f7a4	191
	192	pp_sys_cflags='ccflags="$ccflags -DNO_EFF_ONLY_OK"'
	193
313489a2	194	#
e60a08f8	195	# Unset temporary variables no more needed.
	196	#
	197
	198	unset _DEC_cc_style
	199
	200	#
8e964347	201	# History:
8e964347	202	#
85ab1d1d	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	#
313489a2	209	# perl5.004_57:
	210	#
	211	# 19-Dec-1997 Spider Boardman <spider@Orb.Nashua.NH.US>
	212	#
85ab1d1d	213	# * Newer Digital UNIX compilers enforce signaling for NaN without
313489a2	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	#
723e14d4	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	#
b971f6e4	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	#
e60a08f8	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	#
dfa3a3d3	265	# perl5.003_26:
	266	#
	267	# 15-Feb-1997 Jarkko Hietaniemi <jhi@iki.fi>
	268	#
e60a08f8	269	# * -std and -ansi.
dfa3a3d3	270	#
dfa3a3d3	271	#
f2c69087	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	#
8a019ce7	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	#
8e964347	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	#