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