This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
completion and docs for dynamic loading on OS/390
[perl5.git] / hints / os390.sh
1 # hints/os390.sh
2 #
3 # OS/390 hints by David J. Fiander <davidf@mks.com>
4 #
5 # OS/390 OpenEdition Release 3 Mon Sep 22 1997 thanks to:
6
7 #     John Goodyear <johngood@us.ibm.com>
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>
12 #     Andy Dougherty  <doughera@lafcol.lafayette.edu>
13 #     Tim Bunce  <Tim.Bunce@ig.co.uk>
14 #
15 #  as well as the authors of the aix.sh file
16 #
17
18 # To get ANSI C, we need to use c89, and ld doesn't exist
19 # You can override this with Configure -Dcc=gcc -Dld=ld.
20 case "$cc" in
21 '') cc='c89' ;;
22 esac
23 case "$ld" in
24 '') ld='c89' ;;
25 esac
26
27 # -DMAXSIG=38 maximum signal number
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.
32 # YYDYNAMIC ensures that the OS/390 yacc generated parser is reentrant.
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
36 '') ccflags='-DMAXSIG=38 -DOEMVS -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -DYYDYNAMIC' ;;
37 *) ccflags="$ccflags -DMAXSIG=38 -DOEMVS -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -DYYDYNAMIC" ;;
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
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
49 '') cccdlflags='-W 0,dll' ;;
50 esac
51
52 case "$so" in
53 '') so='a' ;;
54 esac
55
56 case "$alignbytes" in
57 '') alignbytes=8 ;;
58 esac
59
60 case "$usemymalloc" in
61 '') usemymalloc='n' ;;
62 esac
63
64 # On OS/390, libc.a doesn't really hold anything at all,
65 # so running nm on it is pretty useless.
66 # You can override this with Configure -Dusenm.
67 case "$usenm" in
68 '') usenm='false' ;;
69 esac
70
71 # Dynamic loading doesn't work on OS/390 quite yet.
72 # However the easiest way to experiment with dynamic loading is with:
73 #  Configure -Dusedl
74 # You can even override some of this with things like:
75 #  Configure -Dusedl -Ddlext=so -Ddlsrc=dl_dllload.xs.
76 case "$usedl" in
77 '')
78     usedl='n' 
79     case "$dlext" in
80     '') dlext='none' ;;
81     esac
82     ;;
83 define)
84     case "$useshrplib" in
85     '') useshrplib='true' ;;
86     esac
87     case "$dlsrc" in
88     '') dlsrc='dl_dllload.xs' ;;
89     esac
90     # For performance use 'so' at or beyond v2.8, 'dll' for 2.7 and prior versions
91     case "`uname -v`x`uname -r`" in
92     02x0[89].*|02x1[0-9].*|[0-9][3-9]x*) 
93         so='so'
94         case "$dlext" in
95         '') dlext='so' ;;
96         esac
97         ;;
98     *) 
99         so='dll'
100         case "$dlext" in
101         '') dlext='dll' ;;
102         esac
103         ;;
104     esac
105     libperl="libperl.$so"
106     ccflags="$ccflags -D_SHR_ENVIRON -DPERL_EXTERNAL_GLOB -Wc,dll"
107     cccdlflags='-c -Wc,dll,EXPORTALL'
108     # You might add '-Wl,EDIT=NO' to get rid of the symbol
109     # information at the end of the executable (=> smaller binaries).
110     # Do so with -Dldflags='-Wl,EDIT=NO'.
111     case "$ldflags" in
112     '') ldflags='' ;;
113     esac
114     # The following will need to be modified for the installed libperl.x.
115     # The modification to Config.pm is done by the installperl script after the build and test.
116     ccdlflags="-W l,dll `pwd`/libperl.x"
117     lddlflags="-W l,dll `pwd`/libperl.x"
118     ;;
119 esac
120 # even on static builds using LIBPATH should be OK.
121 case "$ldlibpthname" in
122 '') ldlibpthname=LIBPATH ;;
123 esac
124
125 # Header files to include.
126 # You can override these with Configure -Ui_time -Ui_systime.
127 case "$i_time" in
128 '') i_time='define' ;;
129 esac
130 case "$i_systime" in
131 '') i_systime='define' ;;
132 esac
133
134 # (from aix.sh)
135 # uname -m output is too specific and not appropriate here
136 # osname should come from Configure
137 # You can override this with Configure -Darchname='s390' but please don't.
138 case "$archname" in
139 '') archname="$osname" ;;
140 esac
141
142 # Architecture related object files.
143 # ebcdic.c contains special \cX mapping code for EBCDIC char sets.
144 # Prepend your preference with Configure -Darchobs=your_preference.o.
145 case "$archname" in
146 '') archobjs="ebcdic.o" ;;
147 *) archobjs="$archobjs ebcdic.o" ;;
148 esac
149
150 # We have our own cppstdin script.  This is not a variable since 
151 # Configure sees the presence of the script file.
152 # We put system header -D definitions in so that Configure
153 # can find the shmat() prototype in <sys/shm.h> and various
154 # other things.  Unfortunately, cppflags occurs too late to be of 
155 # value external to the script.  This may need to be revisited 
156 # under a compiler other than c89.
157 case "$usedl" in
158 define)
159 echo 'cat >.$$.c; '"$cc"' -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -D_SHR_ENVIRON -E -Wc,NOLOC ${1+"$@"} .$$.c; rm .$$.c' > cppstdin
160     ;;
161 *)
162 echo 'cat >.$$.c; '"$cc"' -D_OE_SOCKETS -D_XOPEN_SOURCE_EXTENDED -D_ALL_SOURCE -E -Wc,NOLOC ${1+"$@"} .$$.c; rm .$$.c' > cppstdin
163     ;;
164 esac
165
166 #
167 # Note that Makefile.SH employs a bare yacc command to generate 
168 # perly.[hc] and a2p.[hc], hence you may wish to:
169 #
170 #    alias yacc='myyacc'
171 #
172 # Then if you would like to use myyacc and skip past the
173 # following warnings try invoking Configure like so: 
174 #
175 #    sh Configure -Dbyacc=yacc
176 #
177 # This trick ought to work even if your yacc is byacc.
178 #
179 if test "X$byacc" = "Xbyacc" ; then
180     if test -e /etc/yyparse.c ; then
181         : we should be OK - perhaps do a test -r?
182     else
183         cat <<EOWARN >&4
184
185 Warning.  You do not have a copy of yyparse.c, the default 
186 yacc parser template file, in place in /etc.
187 EOWARN
188         if test -e /samples/yyparse.c ; then
189             cat <<EOWARN >&4
190
191 There does appear to be a template file in /samples though.
192 Please run:
193
194       cp /samples/yyparse.c /etc
195
196 before attempting to Configure the build of $package.
197
198 EOWARN
199         else
200             cat <<EOWARN >&4
201
202 There does not appear to be one in /samples either.  
203 If you feel you can make use of an alternate yacc-like 
204 parser generator then please read the comments in the
205 hints/os390.sh file carefully.
206
207 EOWARN
208         fi
209         exit 1
210     fi
211 fi
212