[metaconfig.git] / U / perl / libperl.U

?RCS: $Id: libperl.U,v $
?RCS:
?RCS: Copyright (c) 1996-1998, Andy Dougherty
?RCS:
?RCS: You may distribute under the terms of either the GNU General Public
?RCS: License or the Artistic License, as specified in the README file.
?RCS:
?MAKE:libperl useshrplib shrpenv ldlibpthname: \
	Myread Oldconfig archlibexp awk cat libc \
	_a osname osvers so patchlevel subversion usedl ld \
	ccdlflags installarchlib userelocatableinc
?MAKE:	-pick wipe $@ %<
?S:libperl:
?S:	The perl executable is obtained by linking perlmain.c with
?S:	libperl, any static extensions (usually just DynaLoader),
?S:	and any other libraries needed on this system.  libperl
?S:	is usually libperl.a, but can also be libperl.so.xxx if
?S:	the user wishes to build a perl executable with a shared
?S:	library.
?S:.
?S:useshrplib:
?S:	This variable is set to 'true' if the user wishes
?S:	to build a shared libperl, and 'false' otherwise.
?S:.
?S:shrpenv:
?S:	If the user builds a shared libperl.so, then we need to tell the
?S:	'perl' executable where it will be able to find the installed libperl.so.
?S:	One way to do this on some systems is to set the environment variable
?S:	LD_RUN_PATH to the directory that will be the final location of the
?S:	shared libperl.so.  The makefile can use this with something like
?S:		$shrpenv $(CC) -o perl perlmain.o $libperl $libs
?S:	Typical values are
?S:		shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
?S:	or
?S:		shrpenv=''
?S:	See the main perl Makefile.SH for actual working usage.
?S: Alternatively, we might be able to use a command line option such
?S:	as -R $archlibexp/CORE (Solaris) or -Wl,-rpath
?S:	$archlibexp/CORE (Linux).
?S:.
?S:ldlibpthname:
?S:	This variable holds the name of the shared library
?S:	search path, often LD_LIBRARY_PATH.  To get an empty
?S:	string, the hints file must set this to 'none'.
?S:.
?T:shrpdir majonly majmin also xxx tmp_shrpenv
?X: metalint gets confused and thinks we're actually setting LDOPTS
?X: and LD_RUN_PATH.
?LINT:extern LDOPTS
?LINT:change LDOPTS
?LINT:extern LD_RUN_PATH
?LINT:change LD_RUN_PATH
?LINT:change ccdlflags
?LINT:extern maintloc maintname
?Y:top
: Do we want a shared libperl?
also=''
case "$usedl" in
$undef)
	# No dynamic loading being used, so don't bother even to prompt.
	useshrplib='false'
	;;
*)	case "$useshrplib" in
	'')	case "$osname" in
		svr4*|nonstopux|dgux|dynixptx|esix|powerux|haiku|cygwin*)
			dflt=y
			also='Building a shared libperl is required for dynamic loading to work on your system.'
			;;
		*)	dflt=n
			;;
		esac
		;;
	$define|true|[Yy]*)
		dflt=y
		;;
	*)	dflt=n
		;;
	esac
	$cat << EOM

The perl executable is normally obtained by linking perlmain.c with
libperl${_a}, any static extensions (usually just DynaLoader), and
any other libraries needed on this system (such as -lm, etc.).  Since
your system supports dynamic loading, it is probably possible to build
a shared libperl.$so.  If you will have more than one executable linked
to libperl.$so, this will significantly reduce the size of each
executable, but it may have a noticeable effect on performance.  The
default is probably sensible for your system.
$also

EOM
	rp="Build a shared libperl.$so (y/n)"
	. ./myread
	case "$ans" in
	true|$define|[Yy]*)
		useshrplib='true'  ;;
	*)	useshrplib='false' ;;
	esac
	;;
esac

case "$useshrplib" in
true)
	case "$userelocatableinc" in
	true|define)
		echo "Cannot build with both -Duserelocatableinc and -Duseshrplib" >&4
		echo "See INSTALL for an explanation why that won't work." >&4
		exit 4
		;;
	esac
	case "$libperl" in
	'')
		# Figure out a good name for libperl.so.  Since it gets stored in
		# a version-specific architecture-dependent library, the version
		# number isn't really that important, except for making cc/ld happy.
		#
		# A name such as libperl.so.10.1
		majmin="libperl.$so.$patchlevel.$subversion"
		# A name such as libperl.so.100
		majonly=`echo $patchlevel $subversion |
			$awk '{printf "%d%02d", $1, $2}'`
		majonly=libperl.$so.$majonly
		# I'd prefer to keep the os-specific stuff here to a minimum, and
		# rely on figuring it out from the naming of libc.
		case "${osname}${osvers}" in
		*linux*|gnu*)  # ld won't link with a bare -lperl otherwise.
			dflt=libperl.$so
			;;
		cygwin*) # ld links now against the dll directly
			majmin="cygperl5_${patchlevel}_${subversion}.${so}"
			majonly=`echo $patchlevel $subversion |
				$awk '{printf "%03d%03d", $1, $2}'`
			majonly=cygperl5.$majonly.$so
			dflt=$majmin
			;;
		*)	# Try to guess based on whether libc has major.minor.
			case "$libc" in
			*libc.$so.[0-9]*.[0-9]*) dflt=$majmin ;;
			*libc.$so.[0-9]*) dflt=$majonly ;;
			*)	dflt=libperl.$so ;;
			esac
			;;
		esac
		;;
	*)	dflt=$libperl
		;;
	esac
	cat << EOM

I need to select a good name for the shared libperl.  If your system uses
library names with major and minor numbers, then you might want something
like $majmin.  Alternatively, if your system uses a single version
number for shared libraries, then you might want to use $majonly.
Or, your system might be quite happy with a simple libperl.$so.

Since the shared libperl will get installed into a version-specific
architecture-dependent directory, the version number of the shared perl
library probably isn't important, so the default should be o.k.

EOM
	rp='What name do you want to give to the shared libperl?'
	. ./myread
	libperl=$ans
	echo "Ok, I'll use $libperl"
	;;
*)
	libperl="libperl${_a}"
	;;
esac

# Detect old use of shrpdir via undocumented Configure -Dshrpdir
case "$shrpdir" in
'') ;;
*)	$cat >&4 <<EOM
WARNING:  Use of the shrpdir variable for the installation location of
the shared $libperl is not supported.  It was never documented and
will not work in this version.  Let me (<$maintloc>)
know of any problems this may cause.

EOM
	case "$shrpdir" in
	"$archlibexp/CORE")
		$cat >&4 <<EOM
But your current setting of $shrpdir is
the default anyway, so it's harmless.
EOM
		;;
	*)
		$cat >&4 <<EOM
Further, your current attempted setting of $shrpdir
conflicts with the value of $archlibexp/CORE
that installperl will use.
EOM
		;;
	esac
	;;
esac

# How will the perl executable find the installed shared $libperl?
# Add $xxx to ccdlflags.
# If we can't figure out a command-line option, use $shrpenv to
# set env LD_RUN_PATH.  The main perl makefile uses this.
shrpdir=$archlibexp/CORE
xxx=''
tmp_shrpenv=''
if "$useshrplib"; then
    case "$osname" in
	aix)
		# We'll set it in Makefile.SH...
		;;
	solaris)
		xxx="-R $shrpdir"
		;;
	freebsd|mirbsd|netbsd|openbsd|interix|dragonfly|bitrig)
		xxx="-Wl,-R$shrpdir"
		;;
	bsdos|linux|irix*|dec_osf|gnu*|haiku)
		xxx="-Wl,-rpath,$shrpdir"
		;;
	hpux*)
		# hpux doesn't like the default, either.
		tmp_shrpenv="env LDOPTS=\"+s +b${shrpdir}\""
		;;
	cygwin)
		# cygwin needs only ldlibpth
		;;
	*)
		tmp_shrpenv="env LD_RUN_PATH=$shrpdir"
		;;
	esac
	case "$xxx" in
	'') ;;
	*)
		# Only add $xxx if it isn't already in ccdlflags.
		case " $ccdlflags " in
		*" $xxx "*)	;;
		*)	ccdlflags="$ccdlflags $xxx"
			cat <<EOM >&4

Adding $xxx to the flags
passed to $ld so that the perl executable will find the
installed shared $libperl.

EOM
			;;
		esac
		;;
	esac
fi
# Fix ccdlflags in AIX for building external extensions.
# (For building Perl itself bare -bE:perl.exp is needed,
#  Makefile.SH takes care of this.)
case "$osname" in
aix) ccdlflags="$ccdlflags -bE:$installarchlib/CORE/perl.exp" ;;
esac
# Respect a hint or command-line value.
case "$shrpenv" in
'') shrpenv="$tmp_shrpenv" ;;
esac
case "$ldlibpthname" in
'')	ldlibpthname=LD_LIBRARY_PATH ;;
none)	ldlibpthname='' ;;
esac
Commit	Line	Data
959f3c4c JH	1	?RCS: $Id: libperl.U,v $
	2	?RCS:
	3	?RCS: Copyright (c) 1996-1998, Andy Dougherty
	4	?RCS:
	5	?RCS: You may distribute under the terms of either the GNU General Public
	6	?RCS: License or the Artistic License, as specified in the README file.
	7	?RCS:
	8	?MAKE:libperl useshrplib shrpenv ldlibpthname: \
	9	Myread Oldconfig archlibexp awk cat libc \
	10	_a osname osvers so patchlevel subversion usedl ld \
ce87fced	11	ccdlflags installarchlib userelocatableinc
959f3c4c JH	12	?MAKE: -pick wipe $@ %<
	13	?S:libperl:
	14	?S: The perl executable is obtained by linking perlmain.c with
	15	?S: libperl, any static extensions (usually just DynaLoader),
	16	?S: and any other libraries needed on this system. libperl
	17	?S: is usually libperl.a, but can also be libperl.so.xxx if
	18	?S: the user wishes to build a perl executable with a shared
	19	?S: library.
	20	?S:.
	21	?S:useshrplib:
472f992b MB	22	?S: This variable is set to 'true' if the user wishes
472f992b MB	23	?S: to build a shared libperl, and 'false' otherwise.
959f3c4c JH	24	?S:.
	25	?S:shrpenv:
	26	?S: If the user builds a shared libperl.so, then we need to tell the
2f125bce	27	?S: 'perl' executable where it will be able to find the installed libperl.so.
959f3c4c JH	28	?S: One way to do this on some systems is to set the environment variable
	29	?S: LD_RUN_PATH to the directory that will be the final location of the
	30	?S: shared libperl.so. The makefile can use this with something like
	31	?S: $shrpenv $(CC) -o perl perlmain.o $libperl $libs
	32	?S: Typical values are
	33	?S: shrpenv="env LD_RUN_PATH=$archlibexp/CORE"
	34	?S: or
	35	?S: shrpenv=''
	36	?S: See the main perl Makefile.SH for actual working usage.
	37	?S: Alternatively, we might be able to use a command line option such
4d5de5cd	38	?S: as -R $archlibexp/CORE (Solaris) or -Wl,-rpath
959f3c4c JH	39	?S: $archlibexp/CORE (Linux).
	40	?S:.
	41	?S:ldlibpthname:
	42	?S: This variable holds the name of the shared library
	43	?S: search path, often LD_LIBRARY_PATH. To get an empty
	44	?S: string, the hints file must set this to 'none'.
	45	?S:.
	46	?T:shrpdir majonly majmin also xxx tmp_shrpenv
	47	?X: metalint gets confused and thinks we're actually setting LDOPTS
	48	?X: and LD_RUN_PATH.
	49	?LINT:extern LDOPTS
	50	?LINT:change LDOPTS
	51	?LINT:extern LD_RUN_PATH
	52	?LINT:change LD_RUN_PATH
	53	?LINT:change ccdlflags
	54	?LINT:extern maintloc maintname
	55	?Y:top
d9c563cf	56	: Do we want a shared libperl?
959f3c4c JH	57	also=''
	58	case "$usedl" in
	59	$undef)
	60	# No dynamic loading being used, so don't bother even to prompt.
	61	useshrplib='false'
	62	;;
	63	*) case "$useshrplib" in
	64	'') case "$osname" in
a3c22f16	65	svr4\|nonstopux\|dgux\|dynixptx\|esix\|powerux\|haiku\|cygwin)
959f3c4c JH	66	dflt=y
	67	also='Building a shared libperl is required for dynamic loading to work on your system.'
	68	;;
959f3c4c JH	69	*) dflt=n
	70	;;
	71	esac
	72	;;
	73	$define\|true\|[Yy]*)
	74	dflt=y
	75	;;
	76	*) dflt=n
	77	;;
	78	esac
	79	$cat << EOM
	80
	81	The perl executable is normally obtained by linking perlmain.c with
	82	libperl${_a}, any static extensions (usually just DynaLoader), and
	83	any other libraries needed on this system (such as -lm, etc.). Since
	84	your system supports dynamic loading, it is probably possible to build
	85	a shared libperl.$so. If you will have more than one executable linked
	86	to libperl.$so, this will significantly reduce the size of each
fc0fa78a	87	executable, but it may have a noticeable effect on performance. The
959f3c4c JH	88	default is probably sensible for your system.
	89	$also
	90
	91	EOM
	92	rp="Build a shared libperl.$so (y/n)"
	93	. ./myread
	94	case "$ans" in
	95	true\|$define\|[Yy]*)
	96	useshrplib='true' ;;
	97	*) useshrplib='false' ;;
	98	esac
	99	;;
	100	esac
	101
	102	case "$useshrplib" in
	103	true)
ce87fced MB	104	case "$userelocatableinc" in
	105	true\|define)
	106	echo "Cannot build with both -Duserelocatableinc and -Duseshrplib" >&4
	107	echo "See INSTALL for an explanation why that won't work." >&4
	108	exit 4
	109	;;
	110	esac
959f3c4c JH	111	case "$libperl" in
	112	'')
	113	# Figure out a good name for libperl.so. Since it gets stored in
	114	# a version-specific architecture-dependent library, the version
	115	# number isn't really that important, except for making cc/ld happy.
	116	#
cfba7844	117	# A name such as libperl.so.10.1
959f3c4c	118	majmin="libperl.$so.$patchlevel.$subversion"
cfba7844	119	# A name such as libperl.so.100
959f3c4c JH	120	majonly=`echo $patchlevel $subversion \|
	121	$awk '{printf "%d%02d", $1, $2}'`
	122	majonly=libperl.$so.$majonly
	123	# I'd prefer to keep the os-specific stuff here to a minimum, and
	124	# rely on figuring it out from the naming of libc.
	125	case "${osname}${osvers}" in
9c11722e	126	linux\|gnu*) # ld won't link with a bare -lperl otherwise.
959f3c4c JH	127	dflt=libperl.$so
959f3c4c JH	128	;;
cfba7844 RU	129	cygwin*) # ld links now against the dll directly
	130	majmin="cygperl5_${patchlevel}_${subversion}.${so}"
	131	majonly=`echo $patchlevel $subversion \|
	132	$awk '{printf "%03d%03d", $1, $2}'`
	133	majonly=cygperl5.$majonly.$so
	134	dflt=$majmin
edd6115f	135	;;
959f3c4c JH	136	*) # Try to guess based on whether libc has major.minor.
	137	case "$libc" in
	138	libc.$so.[0-9].[0-9]*) dflt=$majmin ;;
	139	libc.$so.[0-9]) dflt=$majonly ;;
	140	*) dflt=libperl.$so ;;
	141	esac
	142	;;
	143	esac
	144	;;
	145	*) dflt=$libperl
	146	;;
	147	esac
	148	cat << EOM
	149
	150	I need to select a good name for the shared libperl. If your system uses
	151	library names with major and minor numbers, then you might want something
	152	like $majmin. Alternatively, if your system uses a single version
	153	number for shared libraries, then you might want to use $majonly.
	154	Or, your system might be quite happy with a simple libperl.$so.
	155
	156	Since the shared libperl will get installed into a version-specific
	157	architecture-dependent directory, the version number of the shared perl
	158	library probably isn't important, so the default should be o.k.
	159
	160	EOM
	161	rp='What name do you want to give to the shared libperl?'
	162	. ./myread
	163	libperl=$ans
	164	echo "Ok, I'll use $libperl"
	165	;;
	166	*)
	167	libperl="libperl${_a}"
	168	;;
	169	esac
	170
	171	# Detect old use of shrpdir via undocumented Configure -Dshrpdir
	172	case "$shrpdir" in
	173	'') ;;
	174	*) $cat >&4 <<EOM
	175	WARNING: Use of the shrpdir variable for the installation location of
	176	the shared $libperl is not supported. It was never documented and
	177	will not work in this version. Let me (<$maintloc>)
	178	know of any problems this may cause.
	179
	180	EOM
	181	case "$shrpdir" in
	182	"$archlibexp/CORE")
	183	$cat >&4 <<EOM
	184	But your current setting of $shrpdir is
	185	the default anyway, so it's harmless.
	186	EOM
	187	;;
	188	*)
	189	$cat >&4 <<EOM
	190	Further, your current attempted setting of $shrpdir
	191	conflicts with the value of $archlibexp/CORE
	192	that installperl will use.
	193	EOM
	194	;;
	195	esac
	196	;;
	197	esac
	198
	199	# How will the perl executable find the installed shared $libperl?
200	# Add $xxx to ccdlflags.
201	# If we can't figure out a command-line option, use $shrpenv to
202	# set env LD_RUN_PATH. The main perl makefile uses this.
203	shrpdir=$archlibexp/CORE
204	xxx=''
205	tmp_shrpenv=''
206	if "$useshrplib"; then
2f125bce	207	case "$osname" in
959f3c4c JH	208	aix)
	209	# We'll set it in Makefile.SH...
	210	;;
4d5de5cd	211	solaris)
959f3c4c JH	212	xxx="-R $shrpdir"
959f3c4c JH	213	;;
502c0e7f	214	freebsd\|mirbsd\|netbsd\|openbsd\|interix\|dragonfly\|bitrig)
959f3c4c JH	215	xxx="-Wl,-R$shrpdir"
959f3c4c JH	216	;;
9374e729	217	bsdos\|linux\|irix\|dec_osf\|gnu\|haiku)
959f3c4c JH	218	xxx="-Wl,-rpath,$shrpdir"
959f3c4c JH	219	;;
959f3c4c JH	220	hpux*)
	221	# hpux doesn't like the default, either.
	222	tmp_shrpenv="env LDOPTS=\"+s +b${shrpdir}\""
	223	;;
cfba7844 RU	224	cygwin)
	225	# cygwin needs only ldlibpth
	226	;;
959f3c4c JH	227	*)
	228	tmp_shrpenv="env LD_RUN_PATH=$shrpdir"
	229	;;
	230	esac
	231	case "$xxx" in
	232	'') ;;
2f125bce	233	*)
959f3c4c JH	234	# Only add $xxx if it isn't already in ccdlflags.
	235	case " $ccdlflags " in
	236	" $xxx ") ;;
	237	*) ccdlflags="$ccdlflags $xxx"
	238	cat <<EOM >&4
	239
	240	Adding $xxx to the flags
2f125bce	241	passed to $ld so that the perl executable will find the
959f3c4c JH	242	installed shared $libperl.
	243
	244	EOM
	245	;;
	246	esac
	247	;;
	248	esac
	249	fi
	250	# Fix ccdlflags in AIX for building external extensions.
	251	# (For building Perl itself bare -bE:perl.exp is needed,
	252	# Makefile.SH takes care of this.)
	253	case "$osname" in
	254	aix) ccdlflags="$ccdlflags -bE:$installarchlib/CORE/perl.exp" ;;
	255	esac
	256	# Respect a hint or command-line value.
	257	case "$shrpenv" in
	258	'') shrpenv="$tmp_shrpenv" ;;
	259	esac
	260	case "$ldlibpthname" in
	261	'') ldlibpthname=LD_LIBRARY_PATH ;;
	262	none) ldlibpthname='' ;;
	263	esac
	264