t/ax/am-test-lib.sh

   1 # -*- shell-script -*-
   2 #
   3 # Copyright (C) 1996-2012 Free Software Foundation, Inc.
   4 #
   5 # This program is free software; you can redistribute it and/or modify
   6 # it under the terms of the GNU General Public License as published by
   7 # the Free Software Foundation; either version 2, or (at your option)
   8 # any later version.
   9 #
  10 # This program is distributed in the hope that it will be useful,
  11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
  12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  13 # GNU General Public License for more details.
  14 #
  15 # You should have received a copy of the GNU General Public License
  16 # along with this program.  If not, see <http://www.gnu.org/licenses/>.
  17
  18 ########################################################
  19 ###  IMPORTANT NOTE: keep this file 'set -e' clean.  ###
  20 ########################################################
  21
  22 # Do not source several times.
  23 test ${am_test_lib_sourced-no} = yes && return 0
  24 am_test_lib_sourced=yes
  25
  26 # A literal escape character.  Used by test checking colored output.
  27 esc='\e'
  28
  29 # This might be used in testcases checking distribution-related features.
  30 # Test scripts are free to override this if they need to.
  31 distdir=$me-1.0
  32
  33 ## ---------------------- ##
  34 ##  Environment cleanup.  ##
  35 ## ---------------------- ##
  36
  37 # Temporarily disable this, since some shells (e.g., older version
  38 # of Bash) can return a non-zero exit status upon the when a non-set
  39 # variable is unset.
  40 set +e
  41
  42 # Unset some make-related variables that may cause $MAKE to act like
  43 # a recursively invoked sub-make.  Any $MAKE invocation in a test is
  44 # conceptually an independent invocation, not part of the main
  45 # 'automake' build.
  46 unset MFLAGS MAKEFLAGS AM_MAKEFLAGS MAKELEVEL
  47 unset __MKLVL__ MAKE_JOBS_FIFO                     # For BSD make.
  48 unset DMAKE_CHILD DMAKE_DEF_PRINTED DMAKE_MAX_JOBS # For Solaris dmake.
  49 # Unset verbosity flag.
  50 unset V
  51 # Also unset variables that will let "make -e install" divert
  52 # files into unwanted directories.
  53 unset DESTDIR
  54 unset prefix exec_prefix bindir datarootdir datadir docdir dvidir
  55 unset htmldir includedir infodir libdir libexecdir localedir mandir
  56 unset oldincludedir pdfdir psdir sbindir sharedstatedir sysconfdir
  57 # Unset variables that might change the "make distcheck" behaviour.
  58 unset DISTCHECK_CONFIGURE_FLAGS AM_DISTCHECK_CONFIGURE_FLAGS
  59 # Used by install rules for info files.
  60 unset AM_UPDATE_INFO_DIR
  61 # The tests call "make -e" but we do not want $srcdir from the environment
  62 # to override the definition from the Makefile.
  63 unset srcdir
  64 # Also unset variables that control our test driver.  While not
  65 # conceptually independent, they cause some changed semantics we
  66 # need to control (and test for) in some of the tests to ensure
  67 # backward-compatible behavior.
  68 unset TESTS_ENVIRONMENT AM_TESTS_ENVIRONMENT
  69 unset DISABLE_HARD_ERRORS
  70 unset AM_COLOR_TESTS
  71 unset TESTS
  72 unset XFAIL_TESTS
  73 unset TEST_LOGS
  74 unset TEST_SUITE_LOG
  75 unset RECHECK_LOGS
  76 unset VERBOSE
  77 for pfx in TEST_ SH_ TAP_ ''; do
  78   unset ${pfx}LOG_COMPILER
  79   unset ${pfx}LOG_COMPILE # Not a typo!
  80   unset ${pfx}LOG_FLAGS
  81   unset AM_${pfx}LOG_FLAGS
  82   unset ${pfx}LOG_DRIVER
  83   unset ${pfx}LOG_DRIVER_FLAGS
  84   unset AM_${pfx}LOG_DRIVER_FLAGS
  85 done
  86 unset pfx
  87
  88 # Re-enable, it had been temporarily disabled above.
  89 set -e
  90
  91 # cross_compiling
  92 # ---------------
  93 # Tell whether we are cross-compiling.  This is especially useful to skip
  94 # tests (or portions of them) that requires a native compiler.
  95 cross_compiling ()
  96 {
  97   # Quoting from the autoconf manual:
  98   #   ... [$host_alias and $build both] default to the result of running
  99   #   config.guess, unless you specify either --build or --host.  In
 100   #   this case, the default becomes the system type you specified.
 101   #   If you specify both, *and they're different*, configure enters
 102   #   cross compilation mode (so it doesn't run any tests that require
 103   #   execution).
 104   test x"$host_alias" != x && test x"$build_alias" != x"$host_alias"
 105 }
 106
 107 # is_blocked_signal SIGNAL-NUMBER
 108 # --------------------------------
 109 # Return success if the given signal number is blocked in the shell,
 110 # return a non-zero exit status and print a proper diagnostic otherwise.
 111 is_blocked_signal ()
 112 {
 113   # Use perl, since trying to do this portably in the shell can be
 114   # very tricky, if not downright impossible.  For reference, see:
 115   # <http://lists.gnu.org/archive/html/bug-autoconf/2011-09/msg00004.html>
 116   if $PERL -w -e '
 117     use strict;
 118     use warnings FATAL => "all";
 119     use POSIX;
 120     my %oldsigaction = ();
 121     sigaction('"$1"', 0, \%oldsigaction);
 122     exit ($oldsigaction{"HANDLER"} eq "IGNORE" ? 0 : 77);
 123   '; then
 124     return 0
 125   elif test $? -eq 77; then
 126     return 1
 127   else
 128     fatal_ "couldn't determine whether signal $1 is blocked"
 129   fi
 130 }
 131
 132 # AUTOMAKE_run [-e STATUS] [-d DESCRIPTION] [--] [AUTOMAKE-ARGS...]
 133 # -----------------------------------------------------------------
 134 # Run automake with AUTOMAKE-ARGS, and fail if it doesn't exit with
 135 # STATUS.  Should be polymorphic for TAP and "plain" tests.  The
 136 # DESCRIPTION, when provided, is used for console reporting, only if
 137 # the TAP protocol is in use in the current test script.
 138 AUTOMAKE_run ()
 139 {
 140   am__desc=
 141   am__exp_rc=0
 142   while test $# -gt 0; do
 143     case $1 in
 144       -d) am__desc=$2; shift;;
 145       -e) am__exp_rc=$2; shift;;
 146       --) shift; break;;
 147        # Don't fail on unknown option: assume they (and the rest of the
 148        # command line) are to be passed verbatim to automake (so stop our
 149        # own option parsing).
 150        *) break;;
 151     esac
 152     shift
 153   done
 154   am__got_rc=0
 155   $AUTOMAKE ${1+"$@"} >stdout 2>stderr || am__got_rc=$?
 156   cat stderr >&2
 157   cat stdout
 158   if test $am_test_protocol = none; then
 159     test $am__got_rc -eq $am__exp_rc || exit 1
 160     return
 161   fi
 162   if test -z "$am__desc"; then
 163     if test $am__got_rc -eq $am__exp_rc; then
 164       am__desc="automake exited $am__got_rc"
 165     else
 166       am__desc="automake exited $am__got_rc, expecting $am__exp_rc"
 167     fi
 168   fi
 169   command_ok_ "$am__desc" test $am__got_rc -eq $am__exp_rc
 170 }
 171
 172 # AUTOMAKE_fails [-d DESCRIPTION] [OPTIONS...]
 173 # --------------------------------------------
 174 # Run automake with OPTIONS, and fail if doesn't exit with status 1.
 175 # Should be polymorphic for TAP and "plain" tests.  The DESCRIPTION,
 176 # when provided, is used for console reporting, only if the TAP
 177 # protocol is in use in the current test script.
 178 AUTOMAKE_fails ()
 179 {
 180   AUTOMAKE_run -e 1 ${1+"$@"}
 181 }
 182
 183 # extract_configure_help { --OPTION | VARIABLE-NAME } [FILES]
 184 # -----------------------------------------------------------
 185 # Use this to extract from the output of "./configure --help" (or similar)
 186 # the description or help message associated to the given --OPTION or
 187 # VARIABLE-NAME.
 188 extract_configure_help ()
 189 {
 190   am__opt_re='' am__var_re=''
 191   case $1 in
 192     --*'=')   am__opt_re="^  $1";;
 193     --*'[=]') am__opt_re='^  '$(printf '%s\n' "$1" | sed 's/...$//')'\[=';;
 194     --*)      am__opt_re="^  $1( .*|$)";;
 195       *)      am__var_re="^  $1( .*|$)";;
 196   esac
 197   shift
 198   if test x"$am__opt_re" != x; then
 199     LC_ALL=C awk '
 200       /'"$am__opt_re"'/        { print; do_print = 1; next; }
 201       /^$/                     { do_print = 0; next }
 202       /^  --/                  { do_print = 0; next }
 203       (do_print == 1)          { print }
 204     ' ${1+"$@"}
 205   else
 206     LC_ALL=C awk '
 207       /'"$am__var_re"'/        { print; do_print = 1; next; }
 208       /^$/                     { do_print = 0; next }
 209       /^  [A-Z][A-Z0-9_]* /    { do_print = 0; next }
 210       /^  [A-Z][A-Z0-9_]*$/    { do_print = 0; next }
 211       (do_print == 1)          { print }
 212     ' ${1+"$@"}
 213   fi
 214 }
 215
 216 # grep_configure_help { --OPTION | VARIABLE-NAME } REGEXP
 217 # -------------------------------------------------------
 218 # Grep the section of "./configure --help" output associated with either
 219 # --OPTION or VARIABLE-NAME for the given *extended* regular expression.
 220 grep_configure_help ()
 221 {
 222   ./configure --help > am--all-help \
 223     || { cat am--all-help; exit 1; }
 224   cat am--all-help
 225   extract_configure_help "$1" am--all-help > am--our-help \
 226     || { cat am--our-help; exit 1; }
 227   cat am--our-help
 228   $EGREP "$2" am--our-help || exit 1
 229 }
 230
 231 # using_gmake
 232 # -----------
 233 # Return success if $MAKE is GNU make, return failure otherwise.
 234 # Caches the result for speed reasons.
 235 using_gmake ()
 236 {
 237   case $am__using_gmake in
 238     yes)
 239       return 0;;
 240     no)
 241       return 1;;
 242     '')
 243       # Use --version AND -v, because SGI Make doesn't fail on --version.
 244       # Also grep for GNU because newer versions of FreeBSD make do
 245       # not complain about --version (they seem to silently ignore it).
 246       if $MAKE --version -v | grep GNU; then
 247         am__using_gmake=yes
 248         return 0
 249       else
 250         am__using_gmake=no
 251         return 1
 252       fi;;
 253     *)
 254       fatal_ "invalid value for \$am__using_gmake: '$am__using_gmake'";;
 255   esac
 256 }
 257 am__using_gmake="" # Avoid interferences from the environment.
 258
 259 # make_can_chain_suffix_rules
 260 # ---------------------------
 261 # Return 0 if $MAKE is a make implementation that can chain suffix rules
 262 # automatically, return 1 otherwise.  Caches the result for speed reasons.
 263 make_can_chain_suffix_rules ()
 264 {
 265   if test -z "$am__can_chain_suffix_rules"; then
 266     if using_gmake; then
 267       am__can_chain_suffix_rules=yes
 268       return 0
 269     else
 270       mkdir am__chain.dir$$
 271       cd am__chain.dir$$
 272       unindent > Makefile << 'END'
 273         .SUFFIXES: .u .v .w
 274         .u.v: ; cp $< $@
 275         .v.w: ; cp $< $@
 276 END
 277       echo make can chain suffix rules > foo.u
 278       if $MAKE foo.w && diff foo.u foo.w; then
 279         am__can_chain_suffix_rules=yes
 280       else
 281         am__can_chain_suffix_rules=no
 282       fi
 283       cd ..
 284       rm -rf am__chain.dir$$
 285     fi
 286   fi
 287   case $am__can_chain_suffix_rules in
 288     yes) return 0;;
 289      no) return 1;;
 290       *) fatal_ "make_can_chain_suffix_rules: internal error";;
 291   esac
 292 }
 293 am__can_chain_suffix_rules="" # Avoid interferences from the environment.
 294
 295 # useless_vpath_rebuild
 296 # ---------------------
 297 # Tell whether $MAKE suffers of the bug triggering automake bug#7884.
 298 # For example, this happens with FreeBSD make, since in a VPATH build
 299 # it tends to rebuilt files for which there is an explicit or even just
 300 # a suffix rule, even if said files are already available in the VPATH
 301 # directory.
 302 useless_vpath_rebuild ()
 303 {
 304   if test -z "$am__useless_vpath_rebuild"; then
 305     if using_gmake; then
 306       am__useless_vpath_rebuild=no
 307       return 1
 308     fi
 309     mkdir am__vpath.dir$$
 310     cd am__vpath.dir$$
 311     touch foo.a foo.b bar baz
 312     mkdir build
 313     cd build
 314     unindent > Makefile << 'END'
 315         .SUFFIXES: .a .b
 316         VPATH = ..
 317         all: foo.b baz
 318         .PHONY: all
 319         .a.b: ; cp $< $@
 320         baz: bar ; cp ../baz bar
 321 END
 322     if $MAKE all && test ! -e foo.b && test ! -e bar; then
 323       am__useless_vpath_rebuild=no
 324     else
 325       am__useless_vpath_rebuild=yes
 326     fi
 327     cd ../..
 328     rm -rf am__vpath.dir$$
 329   fi
 330   case $am__useless_vpath_rebuild in
 331     yes) return 0;;
 332      no) return 1;;
 333      "") ;;
 334       *) fatal_ "no_useless_builddir_remake: internal error";;
 335   esac
 336 }
 337 am__useless_vpath_rebuild=""
 338
 339 yl_distcheck () { useless_vpath_rebuild || $MAKE distcheck ${1+"$@"}; }
 340
 341 # count_test_results total=N pass=N fail=N xpass=N xfail=N skip=N error=N
 342 # -----------------------------------------------------------------------
 343 # Check that a testsuite run driven by the parallel-tests harness has
 344 # had the specified numbers of test results (specified by kind).
 345 # This function assumes that the output of "make check" or "make recheck"
 346 # has been saved in the 'stdout' file in the current directory, and its
 347 # log in the 'test-suite.log' file.
 348 count_test_results ()
 349 {
 350   # Use a subshell so that we won't pollute the script namespace.
 351   (
 352     # TODO: Do proper checks on the arguments?
 353     total=ERR pass=ERR fail=ERR xpass=ERR xfail=ERR skip=ERR error=ERR
 354     eval "$@"
 355     # For debugging.
 356     $EGREP -i '(total|x?pass|x?fail|skip|error)' stdout || :
 357     rc=0
 358     # Avoid spurious failures with shells with "overly sensible"
 359     # errexit shell flag, such as e.g., Solaris /bin/sh.
 360     set +e
 361     test $(grep -c '^PASS:'  stdout) -eq $pass  || rc=1
 362     test $(grep -c '^XFAIL:' stdout) -eq $xfail || rc=1
 363     test $(grep -c '^SKIP:'  stdout) -eq $skip  || rc=1
 364     test $(grep -c '^FAIL:'  stdout) -eq $fail  || rc=1
 365     test $(grep -c '^XPASS:' stdout) -eq $xpass || rc=1
 366     test $(grep -c '^ERROR:' stdout) -eq $error || rc=1
 367     grep "^# TOTAL:  *$total$" stdout || rc=1
 368     grep "^# PASS:  *$pass$"   stdout || rc=1
 369     grep "^# XFAIL:  *$xfail$" stdout || rc=1
 370     grep "^# SKIP:  *$skip$"   stdout || rc=1
 371     grep "^# FAIL:  *$fail$"   stdout || rc=1
 372     grep "^# XPASS:  *$xpass$" stdout || rc=1
 373     grep "^# ERROR:  *$error$" stdout || rc=1
 374     test $rc -eq 0
 375   )
 376 }
 377
 378 # get_shell_script SCRIPT-NAME
 379 # -----------------------------
 380 # Fetch an Automake-provided shell script from the 'lib/' directory into
 381 # the current directory, and, if the '$am_test_prefer_config_shell'
 382 # variable is set to "yes", modify its shebang line to use $SHELL instead
 383 # of /bin/sh.
 384 get_shell_script ()
 385 {
 386   test ! -f "$1" || rm -f "$1" || return 99
 387   if test x"$am_test_prefer_config_shell" = x"yes"; then
 388     sed "1s|#!.*|#! $SHELL|" "$am_scriptdir/$1" > "$1" \
 389      && chmod a+x "$1" \
 390      || return 99
 391   else
 392     cp -f "$am_scriptdir/$1" . || return 99
 393   fi
 394   sed 10q "$1" # For debugging.
 395 }
 396
 397 # require_xsi SHELL
 398 # -----------------
 399 # Skip the test if the given shell fails to support common XSI constructs.
 400 require_xsi ()
 401 {
 402   test $# -eq 1 || fatal_ "require_xsi needs exactly one argument"
 403   echo "$me: trying some XSI constructs with $1"
 404   $1 -c "$xsi_shell_code" || skip_all_ "$1 lacks XSI features"
 405 }
 406 # Shell code supposed to work only with XSI shells.  Keep this in sync
 407 # with libtool.m4:_LT_CHECK_SHELL_FEATURES.
 408 xsi_shell_code='
 409   _lt_dummy="a/b/c"
 410   test "${_lt_dummy##*/},${_lt_dummy%/*},${_lt_dummy#??}"${_lt_dummy%"$_lt_dummy"}, \
 411       = c,a/b,b/c, \
 412     && eval '\''test $(( 1 + 1 )) -eq 2 \
 413     && test "${#_lt_dummy}" -eq 5'\'
 414
 415 # fetch_tap_driver
 416 # ----------------
 417 # Fetch the Automake-provided TAP driver from the 'lib/' directory into
 418 # the current directory, and edit its shebang line so that it will be
 419 # run with the perl interpreter determined at configure time.
 420 fetch_tap_driver ()
 421 {
 422   # TODO: we should devise a way to make the shell TAP driver tested also
 423   # TODO: with /bin/sh, for better coverage.
 424   case $am_tap_implementation in
 425     # Extra quoting required to avoid maintainer-check spurious failures.
 426    'perl')
 427       $PERL -MTAP::Parser -e 1 \
 428         || skip_all_ "cannot import TAP::Parser perl module"
 429       sed "1s|#!.*|#! $PERL -w|" "$am_scriptdir"/tap-driver.pl >tap-driver
 430       ;;
 431     shell)
 432       AM_TAP_AWK=$AWK; export AM_TAP_AWK
 433       sed "1s|#!.*|#! $SHELL|" "$am_scriptdir"/tap-driver.sh >tap-driver
 434       ;;
 435     *)
 436       fatal_ "invalid \$am_tap_implementation '$am_tap_implementation'" ;;
 437   esac \
 438     && chmod a+x tap-driver \
 439     || framework_failure_ "couldn't fetch $am_tap_implementation TAP driver"
 440   sed 10q tap-driver # For debugging.
 441 }
 442 # The shell/awk implementation of the TAP driver is still mostly dummy, so
 443 # use the perl implementation by default for the moment.
 444 am_tap_implementation=${am_tap_implementation-shell}
 445
 446 # $PYTHON and support for PEP-3147.  Needed to check our python-related
 447 # install rules.
 448 python_has_pep3147 ()
 449 {
 450   if test -z "$am_pep3147_tag"; then
 451     am_pep3147_tag=$($PYTHON -c 'import imp; print(imp.get_tag())') \
 452       || am_pep3147_tag=none
 453   fi
 454   test $am_pep3147_tag != none
 455 }
 456 am_pep3147_tag=
 457
 458 # pyc_location [-p] [FILE]
 459 # ------------------------
 460 # Determine what the actual location of the given '.pyc' or '.pyo'
 461 # byte-compiled file should be, taking into account PEP-3147.  Save
 462 # the location in the '$am_pyc_file' variable.  If the '-p' option
 463 # is given, print the location on the standard output as well.
 464 pyc_location ()
 465 {
 466   case $#,$1 in
 467     2,-p) am_pyc_print=yes; shift;;
 468      1,*) am_pyc_print=no;;
 469        *) fatal_ "pyc_location: invalid usage";;
 470   esac
 471   if python_has_pep3147; then
 472     case $1 in
 473       */*) am_pyc_dir=${1%/*} am_pyc_base=${1##*/};;
 474         *) am_pyc_dir=. am_pyc_base=$1;;
 475     esac
 476     am_pyc_ext=${am_pyc_base##*.}
 477     am_pyc_base=${am_pyc_base%.py?}
 478     am_pyc_file=$am_pyc_dir/__pycache__/$am_pyc_base.$am_pep3147_tag.$am_pyc_ext
 479   else
 480     am_pyc_file=$1
 481   fi
 482   test $am_pyc_print = no || printf '%s\n' "$am_pyc_file"
 483 }
 484
 485 # py_installed [--not] FILE
 486 # --------------------------
 487 # Check that the given python FILE has been installed (resp. *not*
 488 # installed, if the '--not' option is specified).  If FILE is a
 489 # byte-compiled '.pyc' file, the new installation layout specified
 490 # by PEP-3147 will be taken into account.
 491 py_installed ()
 492 {
 493   case $#,$1 in
 494         1,*) am_test_py_file='test -f';;
 495     2,--not) am_test_py_file='test ! -e'; shift;;
 496           *) fatal_ "pyc_installed: invalid usage";;
 497   esac
 498   case $1 in
 499     *.py[co]) pyc_location "$1"; am_target_py_file=$am_pyc_file;;
 500            *) am_target_py_file=$1;;
 501   esac
 502   $am_test_py_file "$am_target_py_file"
 503 }
 504
 505 # Usage: require_compiler_ {cc|c++|fortran|fortran77}
 506 require_compiler_ ()
 507 {
 508   case $# in
 509     0) fatal_ "require_compiler_: missing argument";;
 510     1) ;;
 511     *) fatal_ "require_compiler_: too many arguments";;
 512   esac
 513   case $1 in
 514     cc)
 515       am__comp_lang="C"
 516       am__comp_var=CC
 517       am__comp_flag_vars='CFLAGS CPPFLAGS'
 518       ;;
 519     c++)
 520       am__comp_lang="C++"
 521       am__comp_var=CXX
 522       am__comp_flag_vars='CXXFLAGS CPPFLAGS'
 523       ;;
 524     fortran)
 525       am__comp_lang="Fortran"
 526       am__comp_var=FC
 527       am__comp_flag_vars='FCFLAGS'
 528       ;;
 529     fortran77)
 530       am__comp_lang="Fortran 77"
 531       am__comp_var=F77
 532       am__comp_flag_vars='FFLAGS'
 533       ;;
 534   esac
 535   shift
 536   eval "am__comp_prog=\${$am__comp_var}" \
 537     || fatal_ "expanding \${$am__comp_var} in require_compiler_"
 538   case $am__comp_prog in
 539     "")
 540       fatal_ "botched configuration: \$$am__comp_var is empty";;
 541     false)
 542       skip_all_ "no $am__comp_lang compiler available";;
 543     autodetect|autodetected)
 544       # Let the ./configure commands in the test script try to determine
 545       # these automatically.
 546       unset $am__comp_var $am__comp_flag_vars;;
 547     *)
 548       # Pre-set these for the ./configure commands in the test script.
 549       export $am__comp_var $am__comp_flag_vars;;
 550   esac
 551   # Delete private variables.
 552   unset am__comp_lang am__comp_prog am__comp_var am__comp_flag_vars
 553 }
 554
 555 ## ----------------------------------------------------------- ##
 556 ##  Checks for required tools, and additional setups (if any)  ##
 557 ##  required by them.                                          ##
 558 ## ----------------------------------------------------------- ##
 559
 560 require_tool ()
 561 {
 562   am_tool=$1
 563   case $1 in
 564     cc|c++|fortran|fortran77)
 565       require_compiler_ $1;;
 566     xsi-lib-shell)
 567       if test x"$am_test_prefer_config_shell" = x"yes"; then
 568         require_xsi "$SHELL"
 569       else
 570         require_xsi "/bin/sh"
 571       fi
 572       ;;
 573     bzip2)
 574       # Do not use --version, older versions bzip2 still tries to compress
 575       # stdin.
 576       echo "$me: running bzip2 --help"
 577       bzip2 --help \
 578         || skip_all_ "required program 'bzip2' not available"
 579       ;;
 580     cl)
 581       CC=cl
 582       # Don't export CFLAGS, as that could have been initialized to only
 583       # work with the C compiler detected at configure time.  If the user
 584       # wants CFLAGS to also influence 'cl', he can still export CFLAGS
 585       # in the environment "by hand" before calling the testsuite.
 586       export CC CPPFLAGS
 587       echo "$me: running $CC -?"
 588       $CC -? || skip_all_ "Microsoft C compiler '$CC' not available"
 589       ;;
 590     etags)
 591       # Exuberant Ctags will create a TAGS file even
 592       # when asked for --help or --version.  (Emacs's etags
 593       # does not have such problem.)  Use -o /dev/null
 594       # to make sure we do not pollute the build directory.
 595       echo "$me: running etags --version -o /dev/null"
 596       etags --version -o /dev/null \
 597         || skip_all_ "required program 'etags' not available"
 598       ;;
 599     GNUmake)
 600       for make_ in "$MAKE" gmake gnumake :; do
 601         MAKE=$make_ am__using_gmake=''
 602         test "$MAKE" =  : && break
 603         echo "$me: determine whether $MAKE is GNU make"
 604         using_gmake && break
 605         : For shells with busted 'set -e'.
 606       done
 607       test "$MAKE" = : && skip_all_ "this test requires GNU make"
 608       export MAKE
 609       unset make_
 610       ;;
 611     gcj)
 612       GCJ=$GNU_GCJ GCJFLAGS=$GNU_GCJFLAGS; export GCJ GCJFLAGS
 613       test "$GCJ" = false && skip_all_ "GNU Java compiler unavailable"
 614       : For shells with busted 'set -e'.
 615       ;;
 616     gcc)
 617       CC=$GNU_CC CFLAGS=$GNU_CFLAGS; export CC CFLAGS CPPFLAGS
 618       test "$CC" = false && skip_all_ "GNU C compiler unavailable"
 619       : For shells with busted 'set -e'.
 620       ;;
 621     g++)
 622       CXX=$GNU_CXX CXXFLAGS=$GNU_CXXFLAGS; export CXX CXXFLAGS CPPFLAGS
 623       test "$CXX" = false && skip_all_ "GNU C++ compiler unavailable"
 624       : For shells with busted 'set -e'.
 625       ;;
 626     gfortran)
 627       FC=$GNU_FC FCFLAGS=$GNU_FCFLAGS; export FC FCFLAGS
 628       test "$FC" = false && skip_all_ "GNU Fortran compiler unavailable"
 629       case " $required " in
 630         *\ g77\ *) ;;
 631         *) F77=$FC FFLAGS=$FCFLAGS; export F77 FFLAGS;;
 632       esac
 633       ;;
 634     g77)
 635       F77=$GNU_F77 FFLAGS=$GNU_FFLAGS; export F77 FFLAGS
 636       test "$F77" = false && skip_all_ "GNU Fortran 77 compiler unavailable"
 637       case " $required " in
 638         *\ gfortran\ *) ;;
 639         *) FC=$F77 FCFLAGS=$FFLAGS; export FC FCFLAGS;;
 640       esac
 641       ;;
 642     grep-nonprint)
 643       # Check that grep can parse nonprinting characters correctly.
 644       # BSD 'grep' works from a pipe, but not a seekable file.
 645       # GNU or BSD 'grep -a' works on files, but is not portable.
 646       case $(echo "$esc" | grep .)$(echo "$esc" | grep "$esc") in
 647         "$esc$esc") ;;
 648         *) skip_ "grep can't handle nonprinting characters correctly";;
 649       esac
 650       ;;
 651     javac)
 652       # The Java compiler from JDK 1.5 (and presumably earlier versions)
 653       # cannot handle the '-version' option by itself: it bails out
 654       # telling that source files are missing.  Adding also the '-help'
 655       # option seems to solve the problem.
 656       echo "$me: running javac -version -help"
 657       javac -version -help || skip_all_ "Sun Java compiler not available"
 658       ;;
 659     java)
 660       # See the comments above about 'javac' for why we use also '-help'.
 661       echo "$me: running java -version -help"
 662       java -version -help || skip_all_ "Sun Java interpreter not found"
 663       ;;
 664     lib)
 665       AR=lib
 666       export AR
 667       # Attempting to create an empty archive will actually not
 668       # create the archive, but lib will output its version.
 669       echo "$me: running $AR -out:defstest.lib"
 670       $AR -out:defstest.lib \
 671         || skip_all_ "Microsoft 'lib' utility not available"
 672       ;;
 673     makedepend)
 674       echo "$me: running makedepend -f-"
 675       makedepend -f- \
 676         || skip_all_ "required program 'makedepend' not available"
 677       ;;
 678     makeinfo-html)
 679       # Make sure we have makeinfo, and it understands '--html'.
 680       echo "$me: running makeinfo --html --version"
 681       makeinfo --html --version \
 682         || skip_all_ "cannot find a makeinfo program that groks" \
 683                      "the '--html' option"
 684       ;;
 685     mingw)
 686       uname_s=$(uname -s || echo UNKNOWN)
 687       echo "$me: system name: $uname_s"
 688       case $uname_s in
 689         MINGW*) ;;
 690         *) skip_all_ "this test requires MSYS in MinGW mode" ;;
 691       esac
 692       unset uname_s
 693       ;;
 694     non-root)
 695       # Skip this test case if the user is root.
 696       # We try to append to a read-only file to detect this.
 697       priv_check_temp=priv-check.$$
 698       touch $priv_check_temp && chmod a-w $priv_check_temp \
 699         || framework_failure_ "creating unwritable file $priv_check_temp"
 700       # Not a useless use of subshell: lesser shells might bail
 701       # out if a builtin fails.
 702       overwrite_status=0
 703       (echo foo >> $priv_check_temp) || overwrite_status=$?
 704       rm -f $priv_check_temp
 705       if test $overwrite_status -eq 0; then
 706         skip_all_ "cannot drop file write permissions"
 707       fi
 708       unset priv_check_temp overwrite_status
 709       ;;
 710     # Extra quoting required to avoid maintainer-check spurious failures.
 711     'perl-threads')
 712       if test "$WANT_NO_THREADS" = "yes"; then
 713         skip_all_ "Devel::Cover cannot cope with threads"
 714       fi
 715       ;;
 716     native)
 717       # Don't use "&&" here, to avoid a bug of 'set -e' present in
 718       # some (even relatively recent) versions of the BSD shell.
 719       # We add the dummy "else" branch for extra safety.
 720       ! cross_compiling || skip_all_ "doesn't work in cross-compile mode"
 721       ;;
 722     python)
 723       PYTHON=${PYTHON-python}
 724       # Older python versions don't support --version, they have -V.
 725       echo "$me: running $PYTHON -V"
 726       $PYTHON -V || skip_all_ "python interpreter not available"
 727       ;;
 728     ro-dir)
 729       # Skip this test case if read-only directories aren't supported
 730       # (e.g., under DOS.)
 731       ro_dir_temp=ro_dir.$$
 732       mkdir $ro_dir_temp && chmod a-w $ro_dir_temp \
 733         || framework_failure_ "creating unwritable directory $ro_dir_temp"
 734       # Not a useless use of subshell: lesser shells might bail
 735       # out if a builtin fails.
 736       create_status=0
 737       (: > $ro_dir_temp/probe) || create_status=$?
 738       rm -rf $ro_dir_temp
 739       if test $create_status -eq 0; then
 740         skip_all_ "cannot drop directory write permissions"
 741       fi
 742       unset ro_dir_temp create_status
 743       ;;
 744     runtest)
 745       # DejaGnu's runtest program. We rely on being able to specify
 746       # the program on the runtest command-line. This requires
 747       # DejaGnu 1.4.3 or later.
 748       echo "$me: running runtest SOMEPROGRAM=someprogram --version"
 749       runtest SOMEPROGRAM=someprogram --version \
 750         || skip_all_ "DejaGnu is not available"
 751       ;;
 752     tex)
 753       # No all versions of Tex support '--version', so we use
 754       # a configure check.
 755       if test -z "$TEX"; then
 756         skip_all_ "TeX is required, but it wasn't found by configure"
 757       fi
 758       ;;
 759     texi2dvi-o)
 760       # Texi2dvi supports '-o' since Texinfo 4.1.
 761       echo "$me: running texi2dvi -o /dev/null --version"
 762       texi2dvi -o /dev/null --version \
 763         || skip_all_ "required program 'texi2dvi' not available"
 764       ;;
 765     lex)
 766       test x"$LEX" = x"false" && skip_all_ "lex not found or disabled"
 767       export LEX
 768       ;;
 769     yacc)
 770       test x"$YACC" = x"false" && skip_all_ "yacc not found or disabled"
 771       export YACC
 772       ;;
 773     flex)
 774       LEX=flex; export LEX
 775       echo "$me: running flex --version"
 776       flex --version || skip_all_ "required program 'flex' not available"
 777       ;;
 778     bison)
 779       YACC='bison -y'; export YACC
 780       echo "$me: running bison --version"
 781       bison --version || skip_all_ "required program 'bison' not available"
 782       ;;
 783     *)
 784       # Generic case: the tool must support --version.
 785       echo "$me: running $1 --version"
 786       # It is not likely but possible that the required tool is a special
 787       # builtin, in which case the shell is allowed to exit after an error.
 788       # So we need the subshell here.  Also, some tools, like Sun cscope,
 789       # can be interactive without redirection.
 790       ($1 --version) </dev/null \
 791         || skip_all_ "required program '$1' not available"
 792       ;;
 793   esac
 794 }
 795
 796 process_requirements ()
 797 {
 798   # Look for (and maybe set up) required tools and/or system features;
 799   # skip the current test if they are not found.
 800   for am_tool in $*; do
 801     require_tool $am_tool
 802   done
 803   # We might need extra m4 macros, e.g., for Libtool or Gettext.
 804   for am_tool in gettext libtool pkg-config; do
 805     case " $required " in
 806       # The lack of whitespace after $am_tool is intended.
 807       *" $am_tool"*) . ./t/$am_tool-macros.dir/get.sh;;
 808     esac
 809   done
 810   am_tool=; unset am_tool
 811 }
 812
 813 ## ---------------------------------------------------------------- ##
 814 ##  Create and set up of the temporary directory used by the test.  ##
 815 ## ---------------------------------------------------------------- ##
 816
 817 am_setup_testdir ()
 818 {
 819   # The subdirectory where the current test script will run and write its
 820   # temporary/data files.  This will be created shortly, and will be removed
 821   # by the cleanup trap below if the test passes.  If the test doesn't pass,
 822   # this directory will be kept, to facilitate debugging.
 823   am_test_subdir=${argv0#$am_rel_srcdir/}
 824   case $am_test_subdir in
 825     */*) am_test_subdir=${am_test_subdir%/*}/$me.dir;;
 826       *) am_test_subdir=$me.dir;;
 827   esac
 828   test ! -e $am_test_subdir || rm_rf_ $am_test_subdir \
 829     || framework_failure_ "removing old test subdirectory"
 830   $MKDIR_P $am_test_subdir \
 831     || framework_failure_ "creating test subdirectory"
 832   cd $am_test_subdir \
 833     || framework_failure_ "cannot chdir into test subdirectory"
 834   if test x"$am_create_testdir" != x"empty"; then
 835     cp "$am_scriptdir"/install-sh "$am_scriptdir"/missing \
 836        "$am_scriptdir"/depcomp . \
 837       || framework_failure_ "fetching common files from $am_scriptdir"
 838     # Build appropriate environment in test directory.  E.g., create
 839     # configure.ac, touch all necessary files, etc.  Don't use AC_OUTPUT,
 840     # but AC_CONFIG_FILES so that appending still produces a valid
 841     # configure.ac.  But then, tests running config.status really need
 842     # to append AC_OUTPUT.
 843     {
 844       echo "AC_INIT([$me], [1.0])"
 845       if test x"$am_serial_tests" = x"yes"; then
 846         echo "AM_INIT_AUTOMAKE"
 847       else
 848         echo "AM_INIT_AUTOMAKE([parallel-tests])"
 849       fi
 850       echo "AC_CONFIG_FILES([Makefile])"
 851     } >configure.ac || framework_failure_ "creating configure.ac skeleton"
 852   fi
 853 }
 854
 855 am_extra_info ()
 856 {
 857   echo "Running from installcheck: $am_running_installcheck"
 858   echo "Test Protocol: $am_test_protocol"
 859   echo "PATH = $PATH"
 860 }