testsuite/README

   1 To run the test suite, change to this directory and run "./runtest".  It will
   2 run all of the test cases, and list those with unexpected outcomes.  Adding the
   3 -v option will cause it to show expected outcomes as well.  To only run the test
   4 cases for particular applets:
   5
   6 ./runtest <applet1> <applet2>...
   7
   8 The test cases for an applet reside in the subdirectory of the applet name.  The
   9 name of the test case should be the assertion that is tested.  The test case
  10 should be a shell fragment that returns successfully if the test case passes,
  11 and unsuccessfully otherwise.
  12
  13 Set SKIP_KNOWN_BUGS environment variable to any non-empty value
  14 to exclude tests which are known to fail.
  15
  16 Set SKIP_INTERNET_TESTS to exclude tests which require working
  17 internet connection.
  18
  19 If the test case relies on a certain feature, it should include the string
  20 "FEATURE: " followed by the name of the feature in a comment.  If it is always
  21 expected to fail, it should include the string "XFAIL" in a comment.
  22
  23
  24 Common causes of false positives:
  25
  26 For busybox built against uclibc, /etc/TZ does not exist or does not match
  27 host system timezone setting. For glibc based host systems, timezona settings
  28 are in /etc/localtime.
  29
  30 LANG and LC_xxx environment variables set to non-C locale.
  31
  32
  33 For the entire testsuite, the copyright is as follows:
  34
  35 Copyright (C) 2001, 2002  Matt Kraai
  36
  37 This program is free software; you can redistribute it and/or
  38 modify it under the terms of the GNU General Public License
  39 as published by the Free Software Foundation; either version 2
  40 of the License, or (at your option) any later version.
  41
  42 This program is distributed in the hope that it will be useful,
  43 but WITHOUT ANY WARRANTY; without even the implied warranty of
  44 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  45 GNU General Public License for more details.
  46
  47 You should have received a copy of the GNU General Public License
  48 along with this program; if not, write to the Free Software
  49 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.