[perl5.git] / hints / os390.sh

# hints/os390.sh
#
# OS/390 hints by David J. Fiander <davidf@mks.com>
#
# OS/390 OpenEdition Release 3 Mon Sep 22 1997 thanks to:
# 
#     John Goodyear <johngood@us.ibm.com>
#     John Pfuntner <pfuntner@vnet.ibm.com>
#     Len Johnson <lenjay@ibm.net>
#     Bud Huff  <BAHUFF@us.oracle.com>
#     Peter Prymmer <pvhp@forte.com>
#     Andy Dougherty  <doughera@lafayette.edu>
#     Tim Bunce  <Tim.Bunce@ig.co.uk>
#
#  as well as the authors of the aix.sh file
#

# To get ANSI C, we need to use c89, and ld doesn't exist
# You can override this with Configure -Dcc=gcc -Dld=ld.
case "$cc" in
'') cc='c99' ;;
esac
case "$ld" in
'') ld='c99' ;;
esac

# -DMAXSIG=39 maximum signal number
# -DOEMVS is used in place of #ifdef __MVS__ in certain places.
# -D_OE_SOCKETS alters system headers.
# -D_XOPEN_SOURCE_EXTENDEDA alters system headers.
# c89 hides most of the useful header stuff, _ALL_SOURCE turns it on again.
# YYDYNAMIC ensures that the OS/390 yacc generated parser is reentrant.
# -DEBCDIC should come from Configure and need not be mentioned here.
# Prepend your favorites with Configure -Dccflags=your_favorites
case "$ccflags" in
'') ccflags='-qlanglvl=extended:extc89:extc99 -qlongname -qxplink -qdll -qfloat=ieee -qhaltonmsg=3296:4108 -DMAXSIG=39 -DOEMVS -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -DYYDYNAMIC -D_POSIX_SOURCE=1' ;;
*) ccflags='$ccflags -qlanglvl=extended:extc89:extc99 -qlongname -qxplink -qdll -qfloat=ieee -qhaltonmsg=3296:4108 -DMAXSIG=39 -DOEMVS -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -DYYDYNAMIC -D_POSIX_SOURCE=1' ;;
esac

# Turning on optimization breaks perl.
# You can override this with Configure -Doptimize='-O' or somesuch.
case "$optimize" in
'') optimize='none' ;;
esac

# To link via definition side decks we need the dll option
# You can override this with Configure -Ucccdlflags or somesuch.
case "$cccdlflags" in
'') cccdlflags='-qxplink -qdll' ;;
esac

case "$so" in
'') so='a' ;;
esac

case "$alignbytes" in
'') alignbytes=8 ;;
esac

case "$usemymalloc" in
'') usemymalloc='n' ;;
esac

# On OS/390, libc.a doesn't really hold anything at all,
# so running nm on it is pretty useless.
# You can override this with Configure -Dusenm.
case "$usenm" in
'') usenm='false' ;;
esac

# Setting ldflags='-Wl,EDIT=NO' will get rid of the symbol
# information at the end of the executable (=> smaller binaries).
# Override this option with -Dldflags='whatever else you wanted'.
case "$ldflags" in
'') ldflags='-qxplink -qdll' ;;
esac

# In order to build with dynamic be sure to specify:
#   Configure -Dusedl
# Do not forget to add $archlibexp/CORE to your LIBPATH.
# You might want to override some of this with things like:
#  Configure -Dusedl -Ddlext=so -Ddlsrc=dl_dllload.xs.
case "$usedl" in
'')
    usedl='n' 
    case "$dlext" in
    '') dlext='none' ;;
    esac
    ;;
define)
    case "$useshrplib" in
    '') useshrplib='true' ;;
    esac
    case "$dlsrc" in
    '') dlsrc='dl_dllload.xs' ;;
    esac
    # For performance use 'so' at or beyond v2.8, 'dll' for 2.7 and prior versions
    case "`uname -v`x`uname -r`" in
    02x0[89].*|02x1[0-9].*|[0-9][3-9]x*) 
        so='so'
        case "$dlext" in
        '') dlext='so' ;;
        esac
        ;;
    *) 
        so='dll'
        case "$dlext" in
        '') dlext='dll' ;;
        esac
        ;;
    esac
    libperl="libperl.$so"
    ccflags="$ccflags -D_SHR_ENVIRON -DPERL_EXTERNAL_GLOB -qexportall -qdll -qxplink"
    cccdlflags='-c -qexportall -qxplink -qdll'
    # The following will need to be modified for the installed libperl.x.
    # The modification to Config.pm is done by the installperl script after the build and test.
    ccdlflags="-qxplink -qdll `pwd`/libperl.x"
    lddlflags="-qxplink -qdll `pwd`/libperl.x"
    ;;
esac
# even on static builds using LIBPATH should be OK.
case "$ldlibpthname" in
'') ldlibpthname=LIBPATH ;;
esac

# The following should always be used
d_oldpthreads='define'

# Header files to include.
# You can override these with Configure -Ui_time -Ui_systime -Dd_pthread_atfork.
case "$i_time" in
'') i_time='define' ;;
esac
case "$i_systime" in
'') i_systime='define' ;;
esac
case "$d_pthread_atfork" in
'') d_pthread_atfork='undef' ;;
esac
case "$d_pthread_atfork" in                                                  
'') d_pthread_atfork='undef' ;;                                              
esac                                                                         

# (from aix.sh)
# uname -m output is too specific and not appropriate here
# osname should come from Configure
# You can override this with Configure -Darchname='s390' but please don't.
case "$archname" in
'') archname="$osname" ;;
esac

# We have our own cppstdin script.  This is not a variable since 
# Configure sees the presence of the script file.
# We put system header -D definitions in so that Configure
# can find the shmat() prototype in <sys/shm.h> and various
# other things.  Unfortunately, cppflags occurs too late to be of 
# value external to the script.  This may need to be revisited 
# under a compiler other than c89.
case "$usedl" in
define)
echo 'cat >.$$.c; '"$cc"' -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -D_SHR_ENVIRON -E -Wc,"LANGLVL(DOLLARINNAMES)",NOLOC ${1+"$@"} .$$.c | fgrep -v "??="; rm .$$.c' > cppstdin
    ;;
*)
echo 'cat >.$$.c; '"$cc"' -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -E -Wc,"LANGLVL(DOLLARINNAMES)",NOLOC ${1+"$@"} .$$.c | fgrep -v "??="; rm .$$.c' > cppstdin
    ;;
esac

#
# Note that Makefile.SH employs a bare yacc command to generate 
# perly.[hc], hence you may wish to:
#
#    alias yacc='myyacc'
#
# Then if you would like to use myyacc and skip past the
# following warnings try invoking Configure like so: 
#
#    sh Configure -Dbyacc=yacc
#
# This trick ought to work even if your yacc is byacc.
#
if test "X$byacc" = "Xbyacc" ; then
    if test -e /etc/yyparse.c ; then
        : we should be OK - perhaps do a test -r?
    else
        cat <<EOWARN >&4

Warning.  You do not have a copy of yyparse.c, the default 
yacc parser template file, in place in /etc.
EOWARN
        if test -e /samples/yyparse.c ; then
            cat <<EOWARN >&4

There does appear to be a template file in /samples though.
Please run:

      cp /samples/yyparse.c /etc

before attempting to Configure the build of $package.

EOWARN
        else
            cat <<EOWARN >&4

There does not appear to be one in /samples either.  
If you feel you can make use of an alternate yacc-like 
parser generator then please read the comments in the
hints/os390.sh file carefully.

EOWARN
        fi
        exit 1
    fi
fi

# Most of the time gcvt() seems to work fine but
# sometimes values like 0.1, 0.2, come out as "10", "20",
# a trivial Perl demonstration snippet is 'print 0.1'.
# The -W 0,float(ieee) seems to be the switch breaking gcvt().
# sprintf() seems to get things right(er).
gconvert_preference=sprintf

# Configure gets these wrong for some reason.
d_gethostbyaddr_r='undef'
d_gethostbyname_r='undef'
d_gethostent_r='undef'

# The z/OS C compiler compiler supports the attribute keyword, but in a
# limited manner.
#
# Ideally, Configure's tests should test the attributes as they are expected
# to be used in perl, and, ideally, those tests would fail on z/OS.
# Until then, just tell Configure to ignore the attributes.  Currently,
# Configure thinks attributes are supported because it does not recognize
# warning messages like this:
#
# INFORMATIONAL CCN4108 ./proto.h:4534  The use of keyword '__attribute__' is non-portable.

d_attribute_deprecated='undef'
d_attribute_format='undef'
d_attribute_malloc='undef'
d_attribute_nonnull='undef'
d_attribute_noreturn='undef'
d_attribute_pure='undef'
d_attribute_unused='undef'
d_attribute_warn_unused_result='undef'

# nan() is in libm but doesn't work as expected: nan("") or nan("0")
# returns zero, not a nan:
# http://www-01.ibm.com/support/knowledgecenter/SSLTBW_1.12.0/com.ibm.zos.r12.bpxbd00/nan.htm%23nan?lang=en
# contrast with e.g.
# http://www.cplusplus.com/reference/cmath/nan-function/
# (C++ but C99 math agrees)
# XXX: Configure scan for proper behavior
d_nan='undef'

# Configures says this exists, but it doesn't work properly.  See
# <54DCE073.4010100@khwilliamson.com>
d_dir_dd_fd='undef'
Commit	Line	Data
86339dc9	1	# hints/os390.sh
9d116dd7 JH	2	#
	3	# OS/390 hints by David J. Fiander <davidf@mks.com>
	4	#
86339dc9	5	# OS/390 OpenEdition Release 3 Mon Sep 22 1997 thanks to:
ac9901e0 PP	6	#
ac9901e0 PP	7	# John Goodyear <johngood@us.ibm.com>
86339dc9 TB	8	# John Pfuntner <pfuntner@vnet.ibm.com>
	9	# Len Johnson <lenjay@ibm.net>
	10	# Bud Huff <BAHUFF@us.oracle.com>
	11	# Peter Prymmer <pvhp@forte.com>
1973dd96	12	# Andy Dougherty <doughera@lafayette.edu>
86339dc9 TB	13	# Tim Bunce <Tim.Bunce@ig.co.uk>
	14	#
	15	# as well as the authors of the aix.sh file
	16	#
	17
9d116dd7	18	# To get ANSI C, we need to use c89, and ld doesn't exist
5f912e1c PP	19	# You can override this with Configure -Dcc=gcc -Dld=ld.
5f912e1c PP	20	case "$cc" in
9bf21945	21	'') cc='c99' ;;
5f912e1c PP	22	esac
5f912e1c PP	23	case "$ld" in
9bf21945	24	'') ld='c99' ;;
5f912e1c PP	25	esac
5f912e1c PP	26
4144573e	27	# -DMAXSIG=39 maximum signal number
5f912e1c PP	28	# -DOEMVS is used in place of #ifdef __MVS__ in certain places.
	29	# -D_OE_SOCKETS alters system headers.
	30	# -D_XOPEN_SOURCE_EXTENDEDA alters system headers.
	31	# c89 hides most of the useful header stuff, _ALL_SOURCE turns it on again.
9d116dd7	32	# YYDYNAMIC ensures that the OS/390 yacc generated parser is reentrant.
5f912e1c PP	33	# -DEBCDIC should come from Configure and need not be mentioned here.
	34	# Prepend your favorites with Configure -Dccflags=your_favorites
	35	case "$ccflags" in
9bf21945 KW	36	'') ccflags='-qlanglvl=extended:extc89:extc99 -qlongname -qxplink -qdll -qfloat=ieee -qhaltonmsg=3296:4108 -DMAXSIG=39 -DOEMVS -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -DYYDYNAMIC -D_POSIX_SOURCE=1' ;;
9bf21945 KW	37	*) ccflags='$ccflags -qlanglvl=extended:extc89:extc99 -qlongname -qxplink -qdll -qfloat=ieee -qhaltonmsg=3296:4108 -DMAXSIG=39 -DOEMVS -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -DYYDYNAMIC -D_POSIX_SOURCE=1' ;;
5f912e1c PP	38	esac
	39
	40	# Turning on optimization breaks perl.
	41	# You can override this with Configure -Doptimize='-O' or somesuch.
	42	case "$optimize" in
	43	'') optimize='none' ;;
	44	esac
	45
5f912e1c PP	46	# To link via definition side decks we need the dll option
	47	# You can override this with Configure -Ucccdlflags or somesuch.
	48	case "$cccdlflags" in
9bf21945	49	'') cccdlflags='-qxplink -qdll' ;;
5f912e1c PP	50	esac
5f912e1c PP	51
5f912e1c PP	52	case "$so" in
	53	'') so='a' ;;
	54	esac
9d116dd7	55
5f912e1c PP	56	case "$alignbytes" in
	57	'') alignbytes=8 ;;
	58	esac
9d116dd7	59
5f912e1c PP	60	case "$usemymalloc" in
	61	'') usemymalloc='n' ;;
	62	esac
9d116dd7 JH	63
	64	# On OS/390, libc.a doesn't really hold anything at all,
	65	# so running nm on it is pretty useless.
5f912e1c PP	66	# You can override this with Configure -Dusenm.
	67	case "$usenm" in
	68	'') usenm='false' ;;
	69	esac
9d116dd7	70
59c9e5d6 PP	71	# Setting ldflags='-Wl,EDIT=NO' will get rid of the symbol
	72	# information at the end of the executable (=> smaller binaries).
	73	# Override this option with -Dldflags='whatever else you wanted'.
	74	case "$ldflags" in
9bf21945	75	'') ldflags='-qxplink -qdll' ;;
59c9e5d6 PP	76	esac
	77
	78	# In order to build with dynamic be sure to specify:
	79	# Configure -Dusedl
	80	# Do not forget to add $archlibexp/CORE to your LIBPATH.
	81	# You might want to override some of this with things like:
ac9901e0	82	# Configure -Dusedl -Ddlext=so -Ddlsrc=dl_dllload.xs.
5f912e1c	83	case "$usedl" in
ac9901e0 PP	84	'')
	85	usedl='n'
	86	case "$dlext" in
	87	'') dlext='none' ;;
	88	esac
	89	;;
	90	define)
	91	case "$useshrplib" in
	92	'') useshrplib='true' ;;
	93	esac
ac9901e0 PP	94	case "$dlsrc" in
	95	'') dlsrc='dl_dllload.xs' ;;
	96	esac
f2766b05 PP	97	# For performance use 'so' at or beyond v2.8, 'dll' for 2.7 and prior versions
	98	case "`uname -v`x`uname -r`" in
	99	02x0[89].\|02x1[0-9].\|[0-9][3-9]x*)
	100	so='so'
	101	case "$dlext" in
	102	'') dlext='so' ;;
	103	esac
	104	;;
	105	*)
	106	so='dll'
	107	case "$dlext" in
	108	'') dlext='dll' ;;
	109	esac
	110	;;
	111	esac
	112	libperl="libperl.$so"
9bf21945 KW	113	ccflags="$ccflags -D_SHR_ENVIRON -DPERL_EXTERNAL_GLOB -qexportall -qdll -qxplink"
9bf21945 KW	114	cccdlflags='-c -qexportall -qxplink -qdll'
f2766b05 PP	115	# The following will need to be modified for the installed libperl.x.
f2766b05 PP	116	# The modification to Config.pm is done by the installperl script after the build and test.
9bf21945 KW	117	ccdlflags="-qxplink -qdll `pwd`/libperl.x"
9bf21945 KW	118	lddlflags="-qxplink -qdll `pwd`/libperl.x"
ac9901e0	119	;;
5f912e1c	120	esac
ac9901e0	121	# even on static builds using LIBPATH should be OK.
5f912e1c PP	122	case "$ldlibpthname" in
	123	'') ldlibpthname=LIBPATH ;;
	124	esac
9d116dd7	125
dca46f05	126	# The following should always be used
20b634c2 JH	127	d_oldpthreads='define'
20b634c2 JH	128
5f912e1c	129	# Header files to include.
20b634c2	130	# You can override these with Configure -Ui_time -Ui_systime -Dd_pthread_atfork.
5f912e1c PP	131	case "$i_time" in
	132	'') i_time='define' ;;
	133	esac
	134	case "$i_systime" in
	135	'') i_systime='define' ;;
	136	esac
20b634c2 JH	137	case "$d_pthread_atfork" in
	138	'') d_pthread_atfork='undef' ;;
	139	esac
6cfe8af5 JH	140	case "$d_pthread_atfork" in
	141	'') d_pthread_atfork='undef' ;;
	142	esac
86339dc9 TB	143
	144	# (from aix.sh)
	145	# uname -m output is too specific and not appropriate here
9d116dd7	146	# osname should come from Configure
5f912e1c	147	# You can override this with Configure -Darchname='s390' but please don't.
86339dc9 TB	148	case "$archname" in
	149	'') archname="$osname" ;;
	150	esac
	151
5f912e1c PP	152	# We have our own cppstdin script. This is not a variable since
	153	# Configure sees the presence of the script file.
	154	# We put system header -D definitions in so that Configure
	155	# can find the shmat() prototype in <sys/shm.h> and various
	156	# other things. Unfortunately, cppflags occurs too late to be of
	157	# value external to the script. This may need to be revisited
	158	# under a compiler other than c89.
f2766b05 PP	159	case "$usedl" in
f2766b05 PP	160	define)
a4c2c75a	161	echo 'cat >.$$.c; '"$cc"' -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -D_SHR_ENVIRON -E -Wc,"LANGLVL(DOLLARINNAMES)",NOLOC ${1+"$@"} .$$.c \| fgrep -v "??="; rm .$$.c' > cppstdin
f2766b05 PP	162	;;
f2766b05 PP	163	*)
a4c2c75a	164	echo 'cat >.$$.c; '"$cc"' -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -E -Wc,"LANGLVL(DOLLARINNAMES)",NOLOC ${1+"$@"} .$$.c \| fgrep -v "??="; rm .$$.c' > cppstdin
f2766b05 PP	165	;;
f2766b05 PP	166	esac
23e2eca9 PP	167
23e2eca9 PP	168	#
5f912e1c	169	# Note that Makefile.SH employs a bare yacc command to generate
c67aee7a	170	# perly.[hc], hence you may wish to:
23e2eca9 PP	171	#
	172	# alias yacc='myyacc'
	173	#
	174	# Then if you would like to use myyacc and skip past the
	175	# following warnings try invoking Configure like so:
	176	#
	177	# sh Configure -Dbyacc=yacc
	178	#
	179	# This trick ought to work even if your yacc is byacc.
	180	#
	181	if test "X$byacc" = "Xbyacc" ; then
	182	if test -e /etc/yyparse.c ; then
	183	: we should be OK - perhaps do a test -r?
	184	else
	185	cat <<EOWARN >&4
	186
	187	Warning. You do not have a copy of yyparse.c, the default
	188	yacc parser template file, in place in /etc.
	189	EOWARN
	190	if test -e /samples/yyparse.c ; then
	191	cat <<EOWARN >&4
	192
	193	There does appear to be a template file in /samples though.
	194	Please run:
	195
	196	cp /samples/yyparse.c /etc
	197
	198	before attempting to Configure the build of $package.
	199
	200	EOWARN
	201	else
	202	cat <<EOWARN >&4
	203
	204	There does not appear to be one in /samples either.
	205	If you feel you can make use of an alternate yacc-like
	206	parser generator then please read the comments in the
	207	hints/os390.sh file carefully.
	208
	209	EOWARN
	210	fi
	211	exit 1
	212	fi
	213	fi
	214
eecdb66e JH	215	# Most of the time gcvt() seems to work fine but
	216	# sometimes values like 0.1, 0.2, come out as "10", "20",
	217	# a trivial Perl demonstration snippet is 'print 0.1'.
1f361dc9	218	# The -W 0,float(ieee) seems to be the switch breaking gcvt().
eecdb66e	219	# sprintf() seems to get things right(er).
aade5aff	220	gconvert_preference=sprintf
eecdb66e	221
4144573e JH	222	# Configure gets these wrong for some reason.
	223	d_gethostbyaddr_r='undef'
	224	d_gethostbyname_r='undef'
	225	d_gethostent_r='undef'
	226
636a024b AD	227	# The z/OS C compiler compiler supports the attribute keyword, but in a
	228	# limited manner.
	229	#
	230	# Ideally, Configure's tests should test the attributes as they are expected
	231	# to be used in perl, and, ideally, those tests would fail on z/OS.
	232	# Until then, just tell Configure to ignore the attributes. Currently,
	233	# Configure thinks attributes are supported because it does not recognize
	234	# warning messages like this:
	235	#
	236	# INFORMATIONAL CCN4108 ./proto.h:4534 The use of keyword '__attribute__' is non-portable.
	237
	238	d_attribute_deprecated='undef'
	239	d_attribute_format='undef'
	240	d_attribute_malloc='undef'
	241	d_attribute_nonnull='undef'
	242	d_attribute_noreturn='undef'
	243	d_attribute_pure='undef'
	244	d_attribute_unused='undef'
	245	d_attribute_warn_unused_result='undef'
d3ac2b76 JH	246
	247	# nan() is in libm but doesn't work as expected: nan("") or nan("0")
	248	# returns zero, not a nan:
	249	# http://www-01.ibm.com/support/knowledgecenter/SSLTBW_1.12.0/com.ibm.zos.r12.bpxbd00/nan.htm%23nan?lang=en
	250	# contrast with e.g.
	251	# http://www.cplusplus.com/reference/cmath/nan-function/
	252	# (C++ but C99 math agrees)
	253	# XXX: Configure scan for proper behavior
	254	d_nan='undef'
cc404f89 KW	255
	256	# Configures says this exists, but it doesn't work properly. See
	257	# <54DCE073.4010100@khwilliamson.com>
	258	d_dir_dd_fd='undef'