testsuite/testing.sh

   1 # Simple test harness infrastructure for BusyBox
   2 #
   3 # Copyright 2005 by Rob Landley
   4 #
   5 # License is GPLv2, see LICENSE in the busybox tarball for full license text.
   6
   7 # This file defines two functions, "testing" and "optional"
   8 # and a couple more...
   9
  10 # The following environment variables may be set to enable optional behavior
  11 # in "testing":
  12 #    VERBOSE - Print the diff -u of each failed test case.
  13 #    DEBUG - Enable command tracing.
  14 #    SKIP - do not perform this test (this is set by "optional")
  15 #
  16 # The "testing" function takes five arguments:
  17 #       $1) Test description
  18 #       $2) Command(s) to run. May have pipes, redirects, etc
  19 #       $3) Expected result on stdout
  20 #       $4) Data to be written to file "input"
  21 #       $5) Data to be written to stdin
  22 #
  23 # The exit value of testing is the exit value of $2 it ran.
  24 #
  25 # The environment variable "FAILCOUNT" contains a cumulative total of the
  26 # number of failed tests.
  27
  28 # The "optional" function is used to skip certain tests, ala:
  29 #   optional FEATURE_THINGY
  30 #
  31 # The "optional" function checks the environment variable "OPTIONFLAGS",
  32 # which is either empty (in which case it always clears SKIP) or
  33 # else contains a colon-separated list of features (in which case the function
  34 # clears SKIP if the flag was found, or sets it to 1 if the flag was not found).
  35
  36 export FAILCOUNT=0
  37 export SKIP=
  38
  39 # Helper for helpers. Oh my...
  40
  41 test x"$ECHO" != x"" || {
  42         ECHO="echo"
  43         test x"`echo -ne`" = x"" || {
  44                 # Compile and use a replacement 'echo' which understands -e -n
  45                 ECHO="$PWD/echo-ne"
  46                 test -x "$ECHO" || {
  47                         gcc -Os -o "$ECHO" ../scripts/echo.c || exit 1
  48                 }
  49         }
  50         export ECHO
  51 }
  52
  53 # Helper functions
  54
  55 optional()
  56 {
  57         SKIP=
  58         while test "$1"; do
  59                 if test x"${OPTIONFLAGS/*:$1:*/y}" != x"y"; then
  60                         SKIP=1
  61                         return
  62                 fi
  63                 shift
  64         done
  65 }
  66
  67 # The testing function
  68
  69 testing()
  70 {
  71   NAME="$1"
  72   [ -n "$1" ] || NAME="$2"
  73
  74   if [ $# -ne 5 ]
  75   then
  76     echo "Test $NAME has wrong number of arguments: $# (must be 5)" >&2
  77     exit 1
  78   fi
  79
  80   [ -z "$DEBUG" ] || set -x
  81
  82   if [ -n "$SKIP" ]
  83   then
  84     echo "SKIPPED: $NAME"
  85     return 0
  86   fi
  87
  88   $ECHO -ne "$3" > expected
  89   $ECHO -ne "$4" > input
  90   [ -z "$VERBOSE" ] || echo "echo -ne '$4' >input"
  91   [ -z "$VERBOSE" ] || echo "echo -ne '$5' | $2"
  92   $ECHO -ne "$5" | eval "$2" > actual
  93   RETVAL=$?
  94
  95   if cmp expected actual >/dev/null 2>/dev/null
  96   then
  97     echo "PASS: $NAME"
  98   else
  99     FAILCOUNT=$(($FAILCOUNT + 1))
 100     echo "FAIL: $NAME"
 101     [ -z "$VERBOSE" ] || diff -u expected actual
 102   fi
 103   rm -f input expected actual
 104
 105   [ -z "$DEBUG" ] || set +x
 106
 107   return $RETVAL
 108 }
 109
 110 # Recursively grab an executable and all the libraries needed to run it.
 111 # Source paths beginning with / will be copied into destpath, otherwise
 112 # the file is assumed to already be there and only its library dependencies
 113 # are copied.
 114
 115 mkchroot()
 116 {
 117   [ $# -lt 2 ] && return
 118
 119   $ECHO -n .
 120
 121   dest=$1
 122   shift
 123   for i in "$@"
 124   do
 125     #bashism: [ "${i:0:1}" == "/" ] || i=$(which $i)
 126     i=$(which $i) # no-op for /bin/prog
 127     [ -f "$dest/$i" ] && continue
 128     if [ -e "$i" ]
 129     then
 130       d=`echo "$i" | grep -o '.*/'` &&
 131       mkdir -p "$dest/$d" &&
 132       cat "$i" > "$dest/$i" &&
 133       chmod +x "$dest/$i"
 134     else
 135       echo "Not found: $i"
 136     fi
 137     mkchroot "$dest" $(ldd "$i" | egrep -o '/.* ')
 138   done
 139 }
 140
 141 # Set up a chroot environment and run commands within it.
 142 # Needed commands listed on command line
 143 # Script fed to stdin.
 144
 145 dochroot()
 146 {
 147   mkdir tmpdir4chroot
 148   mount -t ramfs tmpdir4chroot tmpdir4chroot
 149   mkdir -p tmpdir4chroot/{etc,sys,proc,tmp,dev}
 150   cp -L testing.sh tmpdir4chroot
 151
 152   # Copy utilities from command line arguments
 153
 154   $ECHO -n "Setup chroot"
 155   mkchroot tmpdir4chroot $*
 156   echo
 157
 158   mknod tmpdir4chroot/dev/tty c 5 0
 159   mknod tmpdir4chroot/dev/null c 1 3
 160   mknod tmpdir4chroot/dev/zero c 1 5
 161
 162   # Copy script from stdin
 163
 164   cat > tmpdir4chroot/test.sh
 165   chmod +x tmpdir4chroot/test.sh
 166   chroot tmpdir4chroot /test.sh
 167   umount -l tmpdir4chroot
 168   rmdir tmpdir4chroot
 169 }