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