testsuite/README - busybox - Git at Google

 To run the test suite, change to this directory and run "./runtest".  It will
 run all of the test cases, and list those with unexpected outcomes.  Adding the
 -v option will cause it to show expected outcomes as well.  To only run the test
 cases for particular applets:

 ./runtest <applet1> <applet2>...

 Set SKIP_KNOWN_BUGS environment variable to any non-empty value
 to exclude tests which are known to fail.

 Set SKIP_INTERNET_TESTS to exclude tests which require working
 internet connection.


 Common causes of false positives:

 For busybox built against uclibc, /etc/TZ does not exist or does not match
 host system timezone setting. For glibc based host systems, timezone settings
 are in /etc/localtime.

 LANG and LC_xxx environment variables set to non-C locale.


 Developer's notes:

 The test cases for an applet reside in the subdirectory of the applet name.
 The name of the test case should be the assertion that is tested.
 The test case should be a shell fragment that returns successfully
 if the test case passes, and unsuccessfully otherwise.

 If the test case relies on a certain feature, it should include the string
 "FEATURE: " followed by the name of the feature in a comment.  If it is always
 expected to fail, it should include the string "XFAIL" in a comment.


 For the entire testsuite, the copyright is as follows:

 Copyright (C) 2001, 2002  Matt Kraai

 This program is free software; you can redistribute it and/or
 modify it under the terms of the GNU General Public License
 as published by the Free Software Foundation; either version 2
 of the License, or (at your option) any later version.

 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.

 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
	To run the test suite, change to this directory and run "./runtest". It will
	run all of the test cases, and list those with unexpected outcomes. Adding the
	-v option will cause it to show expected outcomes as well. To only run the test
	cases for particular applets:

	./runtest <applet1> <applet2>...

	Set SKIP_KNOWN_BUGS environment variable to any non-empty value
	to exclude tests which are known to fail.

	Set SKIP_INTERNET_TESTS to exclude tests which require working
	internet connection.


	Common causes of false positives:

	For busybox built against uclibc, /etc/TZ does not exist or does not match
	host system timezone setting. For glibc based host systems, timezone settings
	are in /etc/localtime.

	LANG and LC_xxx environment variables set to non-C locale.


	Developer's notes:

	The test cases for an applet reside in the subdirectory of the applet name.
	The name of the test case should be the assertion that is tested.
	The test case should be a shell fragment that returns successfully
	if the test case passes, and unsuccessfully otherwise.

	If the test case relies on a certain feature, it should include the string
	"FEATURE: " followed by the name of the feature in a comment. If it is always
	expected to fail, it should include the string "XFAIL" in a comment.


	For the entire testsuite, the copyright is as follows:

	Copyright (C) 2001, 2002 Matt Kraai

	This program is free software; you can redistribute it and/or
	modify it under the terms of the GNU General Public License
	as published by the Free Software Foundation; either version 2
	of the License, or (at your option) any later version.

	This program is distributed in the hope that it will be useful,
	but WITHOUT ANY WARRANTY; without even the implied warranty of
	MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	GNU General Public License for more details.

	You should have received a copy of the GNU General Public License
	along with this program; if not, write to the Free Software
	Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.