This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
ecea559439053fa6bc6a07e08fcc79fdb2d2c348
[metaconfig.git] / U / perl / Extensions.U
1 ?RCS: $Id: Extensions.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 ?RCS: $Log: Extensions.U,v $
9 ?RCS:
10 ?MAKE:known_extensions extensions dynamic_ext static_ext nonxs_ext \
11         useposix useopcode : \
12         Myread hint usedl d_sem d_socket i_db i_dbm i_rpcsvcdbm i_gdbm \
13         i_ndbm usethreads use5005threads package test cat rsrc \
14         d_msg d_shm osname use64bitint i_langinfo d_nl_langinfo \
15         libs d_cplusplus sed
16 ?MAKE:  -pick add $@ %<
17 ?Y:BOTTOM
18 ?S:known_extensions:
19 ?S:     This variable holds a list of all XS extensions included in
20 ?S:     the package.
21 ?S:.
22 ?S:dynamic_ext:
23 ?S:     This variable holds a list of XS extension files we want to
24 ?S:     link dynamically into the package.  It is used by Makefile.
25 ?S:.
26 ?S:static_ext:
27 ?S:     This variable holds a list of XS extension files we want to
28 ?S:     link statically into the package.  It is used by Makefile.
29 ?S:.
30 ?S:nonxs_ext:
31 ?S:     This variable holds a list of all non-xs extensions included
32 ?S:     in the package.  All of them will be built.
33 ?S:.
34 ?S:extensions:
35 ?S:     This variable holds a list of all extension files (both XS and
36 ?S:     non-xs linked into the package.  It is propagated to Config.pm
37 ?S:     and is typically used to test whether a particular extesion
38 ?S:     is available.
39 ?S:.
40 ?S:useposix:
41 ?S:     This variable holds either 'true' or 'false' to indicate
42 ?S:     whether the POSIX extension should be used.  The sole
43 ?S:     use for this currently is to allow an easy mechanism
44 ?S:     for hints files to indicate that POSIX will not compile
45 ?S:     on a particular system.
46 ?S:.
47 ?S:useopcode:
48 ?S:     This variable holds either 'true' or 'false' to indicate
49 ?S:     whether the Opcode extension should be used.  The sole
50 ?S:     use for this currently is to allow an easy mechanism
51 ?S:     for users to skip the Opcode extension from the Configure
52 ?S:     command line.
53 ?S:.
54 ?T:xxx avail_ext this_ext leaf tdir nonxs_extensions find_extensions
55 ?INIT:: set useposix=false in your hint file to disable the POSIX extension.
56 ?INIT:useposix=true
57 ?INIT:: set useopcode=false in your hint file to disable the Opcode extension.
58 ?INIT:useopcode=true
59 ?LINT:extern noextensions
60 ?LINT:extern onlyextensions
61 ?T:keepextensions i
62 : Check extensions
63 echo " "
64 echo "Looking for extensions..." >&4
65 : If we are using the old config.sh, known_extensions may contain
66 : old or inaccurate or duplicate values.
67 known_extensions=''
68 nonxs_extensions=''
69 : We do not use find because it might not be available.
70 : We do not just use MANIFEST because the user may have dropped
71 : some additional extensions into the source tree and expect them
72 : to be built.
73
74 : Function to recursively find available extensions, ignoring DynaLoader
75 : NOTE: recursion limit of 10 to prevent runaway in case of symlink madness
76 find_extensions='
77     for xxx in *; do
78         case "$xxx" in
79             DynaLoader|dynaload) ;;
80             *)
81             this_ext=`echo $xxx | $sed -e s/-/\\\//g`;
82             leaf=`echo $xxx | $sed -e s/.*-//`;
83             if $test -d File-Glob; then
84                 : All ext/ flattened
85                 if $test -f $xxx/$leaf.xs -o -f $xxx/$leaf.c; then
86                     known_extensions="$known_extensions $this_ext";
87                 elif $test -d $xxx; then
88                     nonxs_extensions="$nonxs_extensions $this_ext";
89                 fi
90             else
91                 if $test -f $xxx/$leaf.xs -o -f $xxx/$leaf.c; then
92                     known_extensions="$known_extensions $1$this_ext";
93                 elif $test -f $xxx/Makefile.PL; then
94                     nonxs_extensions="$nonxs_extensions $1$this_ext";
95                 else
96                     if $test -d $xxx -a $# -lt 10; then
97                         set $1$xxx/ $*;
98                         cd "$xxx";
99                         eval $find_extensions;
100                         cd ..;
101                         shift;
102                     fi;
103                 fi;
104             fi
105             ;;
106         esac;
107     done'
108 tdir=`pwd`
109 cd "$rsrc/ext"
110 set X
111 shift
112 eval $find_extensions
113 if $test -d File-Glob; then
114     : All ext/ flattened
115 else
116     # Special case:  Add in modules that nest beyond the first level.
117     # Currently threads/shared and Hash/Util/FieldHash, since they are
118     # not picked up by the recursive find above (and adding in general
119     # recursive finding breaks SDBM_File/sdbm).
120     # A.D. 20011025 (SDBM), ajgough 20071008 (FieldHash)
121     known_extensions="$known_extensions threads/shared Hash/Util/FieldHash"
122 fi
123 set X $known_extensions
124 shift
125 known_extensions="$*"
126 set X $nonxs_extensions
127 shift
128 nonxs_extensions="$*"
129 cd "$tdir"
130
131 : Now see which are supported on this system.
132 ?X: avail_ext lists available XS extensions.
133 avail_ext=''
134 for xxx in $known_extensions ; do
135         case "$xxx" in
136 ?X: Handle possible DOS 8.3 filename and case alterations
137         DB_File|db_file)
138                 case "$i_db" in
139                 $define) avail_ext="$avail_ext $xxx" ;;
140                 esac
141                 ;;
142         GDBM_File|gdbm_fil)
143                 case "$i_gdbm" in
144                 $define) avail_ext="$avail_ext $xxx" ;;
145                 esac
146                 ;;
147         I18N/Langinfo|i18n_lan)
148                 case "$i_langinfo$d_nl_langinfo" in
149                 $define$define) avail_ext="$avail_ext $xxx" ;;
150                 esac
151                 ;;
152         IPC/SysV|ipc/sysv)
153                 : XXX Do we need a useipcsysv variable here
154                 case "${d_msg}${d_sem}${d_shm}" in
155                 *"${define}"*) avail_ext="$avail_ext $xxx" ;;
156                 esac
157                 ;;
158         NDBM_File|ndbm_fil)
159                 case "$i_ndbm" in
160                 $define)
161                     case "$osname-$use64bitint" in
162                     hpux-define)
163                         case "$libs" in
164                         *-lndbm*) avail_ext="$avail_ext $xxx" ;;
165                         esac
166                         ;;
167                     *) avail_ext="$avail_ext $xxx" ;;
168                     esac
169                     ;;
170                 esac
171                 ;;
172         ODBM_File|odbm_fil)
173                 case "${i_dbm}${i_rpcsvcdbm}" in
174                 *"${define}"*)
175                     case "$d_cplusplus" in
176                     define) ;; # delete as a function name will not work
177                     *)  case "$osname-$use64bitint" in
178                         hpux-define)
179                             case "$libs" in
180                             *-ldbm*) avail_ext="$avail_ext $xxx" ;;
181                             esac
182                             ;;
183                         *) avail_ext="$avail_ext $xxx" ;;
184                         esac
185                         ;;
186                     esac
187                     ;;
188                 esac
189                 ;;
190         Opcode|opcode)
191                 case "$useopcode" in
192                 true|define|y) avail_ext="$avail_ext $xxx" ;;
193                 esac
194                 ;;
195         POSIX|posix)
196                 case "$useposix" in
197                 true|define|y) avail_ext="$avail_ext $xxx" ;;
198                 esac
199                 ;;
200         Socket|socket)
201                 case "$d_socket" in
202                 true|$define|y)
203                     case "$osname" in
204                     beos) ;; # not unless BONE
205                     *) avail_ext="$avail_ext $xxx" ;;
206                     esac
207                     ;;
208                 esac
209                 ;;
210         Sys/Syslog|sys/syslog)
211                 : XXX syslog requires socket
212                 case "$d_socket" in
213                 true|$define|y) avail_ext="$avail_ext $xxx" ;;
214                 esac
215                 ;;
216         Thread|thread)
217                 case "$usethreads" in
218                 true|$define|y)
219                         case "$use5005threads" in
220                         $define|true|[yY]*) avail_ext="$avail_ext $xxx" ;;
221                         esac
222                 esac
223                 ;;
224         threads|threads/shared)
225                 # threads and threads::shared are special cases.
226                 # To stop people from asking "Perl 5.8.0 was supposed
227                 # to have this new fancy threads implementation but my
228                 # perl doesn't have it" and from people trying to
229                 # (re)install the threads module using CPAN.pm and
230                 # CPAN.pm then offering to reinstall Perl 5.8.0,
231                 # the threads.pm and threads/shared.pm will always be
232                 # there, croaking informatively ("you need to rebuild
233                 # all of Perl with threads, sorry") when threads haven't
234                 # been compiled in.
235                 # --jhi
236                 avail_ext="$avail_ext $xxx"
237                 ;;
238         VMS*)
239                 ;;
240         Win32*)
241                 case "$osname" in
242                 cygwin) avail_ext="$avail_ext $xxx" ;;
243                 esac
244                 ;;
245         XS/APItest|xs/apitest)
246                 # This is just for testing.  Skip it unless we have dynamic loading.
247
248                 case "$usedl" in
249                 $define) avail_ext="$avail_ext $xxx" ;;
250                 esac
251                 ;;
252         XS/Typemap|xs/typemap)
253                 # This is just for testing.  Skip it unless we have dynamic loading.
254                 case "$usedl" in
255                 $define) avail_ext="$avail_ext $xxx" ;;
256                 esac
257                 ;;
258         *)      avail_ext="$avail_ext $xxx"
259                 ;;
260         esac
261 done
262
263 set X $avail_ext
264 shift
265 avail_ext="$*"
266
267 case "$onlyextensions" in
268 '') ;;
269 *)  keepextensions=''
270     echo "You have requested that only certains extensions be included..." >&4
271     for i in $onlyextensions; do
272         case " $avail_ext " in
273         *" $i "*)
274             echo "Keeping extension $i."
275             keepextensions="$keepextensions $i"
276             ;;
277         *) echo "Ignoring extension $i." ;;
278         esac
279     done
280     avail_ext="$keepextensions"
281     ;;
282 esac
283
284 case "$noextensions" in
285 '') ;;
286 *)  keepextensions=''
287     echo "You have requested that certain extensions be ignored..." >&4
288     for i in $avail_ext; do
289         case " $noextensions " in
290         *" $i "*) echo "Ignoring extension $i." ;;
291         *) echo "Keeping extension $i.";
292            keepextensions="$keepextensions $i"
293            ;;
294         esac
295     done
296     avail_ext="$keepextensions"
297     ;;
298 esac
299
300 : Now see which nonxs extensions are supported on this system.
301 : For now assume all are.
302 nonxs_ext=''
303 for xxx in $nonxs_extensions ; do
304         case "$xxx" in
305         *)      nonxs_ext="$nonxs_ext $xxx"
306                 ;;
307         esac
308 done
309
310 set X $nonxs_ext
311 shift
312 nonxs_ext="$*"
313
314 case $usedl in
315 $define)
316         $cat <<EOM
317 A number of extensions are supplied with $package.  You may choose to
318 compile these extensions for dynamic loading (the default), compile
319 them into the $package executable (static loading), or not include
320 them at all.  Answer "none" to include no extensions.
321 Note that DynaLoader is always built and need not be mentioned here.
322
323 EOM
324         case "$dynamic_ext" in
325         '')
326                 : Exclude those listed in static_ext
327                 dflt=''
328                 for xxx in $avail_ext; do
329                         case " $static_ext " in
330                         *" $xxx "*) ;;
331                         *) dflt="$dflt $xxx" ;;
332                         esac
333                 done
334                 set X $dflt
335                 shift
336                 dflt="$*"
337                 ;;
338         *)      dflt="$dynamic_ext"
339                 # Perhaps we are reusing an old out-of-date config.sh.
340                 case "$hint" in
341                 previous)
342                         if test X"$dynamic_ext" != X"$avail_ext"; then
343                                 $cat <<EOM
344 NOTICE:  Your previous config.sh list may be incorrect.
345 The extensions now available to you are
346         ${avail_ext}
347 but the default list from your previous config.sh is
348         ${dynamic_ext}
349
350 EOM
351                         fi
352                         ;;
353                 esac
354                 ;;
355         esac
356         case "$dflt" in
357         '')     dflt=none;;
358         esac
359         rp="What extensions do you wish to load dynamically?"
360         . ./myread
361         case "$ans" in
362 ?X: Use ' ' so a subsequent Configure will preserve that value.
363         none) dynamic_ext=' ' ;;
364         *) dynamic_ext="$ans" ;;
365         esac
366
367         case "$static_ext" in
368         '')
369                 : Exclude those already listed in dynamic linking
370                 dflt=''
371                 for xxx in $avail_ext; do
372                         case " $dynamic_ext " in
373                         *" $xxx "*) ;;
374                         *) dflt="$dflt $xxx" ;;
375                         esac
376                 done
377                 set X $dflt
378                 shift
379                 dflt="$*"
380                 ;;
381         *)  dflt="$static_ext"
382                 ;;
383         esac
384
385         case "$dflt" in
386         '')     dflt=none;;
387         esac
388         rp="What extensions do you wish to load statically?"
389         . ./myread
390         case "$ans" in
391 ?X: Use ' ' so a subsequent Configure will preserve that value.
392         none) static_ext=' ' ;;
393         *) static_ext="$ans" ;;
394         esac
395         ;;
396 *)
397         $cat <<EOM
398 A number of extensions are supplied with $package.  Answer "none"
399 to include no extensions.
400 Note that DynaLoader is always built and need not be mentioned here.
401
402 EOM
403         case "$static_ext" in
404         '') dflt="$avail_ext" ;;
405         *)      dflt="$static_ext"
406                 # Perhaps we are reusing an old out-of-date config.sh.
407                 case "$hint" in
408                 previous)
409                         if test X"$static_ext" != X"$avail_ext"; then
410                                 $cat <<EOM
411 NOTICE:  Your previous config.sh list may be incorrect.
412 The extensions now available to you are
413         ${avail_ext}
414 but the default list from your previous config.sh is
415         ${static_ext}
416
417 EOM
418                         fi
419                         ;;
420                 esac
421                 ;;
422         esac
423         : Exclude those that are not xs extensions
424         case "$dflt" in
425         '')     dflt=none;;
426         esac
427         rp="What extensions do you wish to include?"
428         . ./myread
429         case "$ans" in
430 ?X: Use ' ' so a subsequent Configure will preserve that value.
431         none) static_ext=' ' ;;
432         *) static_ext="$ans" ;;
433         esac
434         ;;
435 esac
436 #
437 # Encode is a special case.  If we are building Encode as a static
438 # extension, we need to explicitly list its subextensions as well.
439 # For other nested extensions, this is handled automatically by
440 # the appropriate Makefile.PL.
441 case " $static_ext " in
442         *" Encode "*) # Add the subextensions of Encode
443         cd "$rsrc/ext"
444         for xxx in `ls Encode/*/Makefile.PL|awk -F/ '{print $2}'`; do
445                 static_ext="$static_ext Encode/$xxx"
446         done
447         cd "$tdir"
448         ;;
449 esac
450
451 set X $dynamic_ext $static_ext $nonxs_ext
452 shift
453 extensions="$*"
454
455 # Sanity check:  We require an extension suitable for use with
456 # AnyDBM_File, as well as Fcntl and IO.  (Failure to have these
457 # should show up as failures in the test suite, but it's helpful to
458 # catch them now.) The 'extensions' list is normally sorted
459 # alphabetically, so we need to accept either
460 #    DB_File ... Fcntl ... IO  ....
461 # or something like
462 #    Fcntl ... NDBM_File ... IO  ....
463 case " $extensions"  in
464 *"_File "*" Fcntl "*" IO "*) ;; # DB_File
465 *" Fcntl "*"_File "*" IO "*) ;; # GDBM_File
466 *" Fcntl "*" IO "*"_File "*) ;; # NDBM_File
467 *) echo "WARNING: Extensions DB_File or *DBM_File, Fcntl, and IO not configured." >&4
468    echo "WARNING: The Perl you are building will be quite crippled." >& 4
469    ;;
470 esac
471