mirror/glibc
2
0
Fork 0
mirror of git://sourceware.org/git/glibc.git synced 2024-11-21 01:12:26 +08:00
Code Issues Packages Projects Releases Wiki Activity

Document do_test in test-skeleton.c

Browse Source 
* test-skeleton.c: Document do_test usage.
This commit is contained in:
Steve Ellcey 2016-11-07 08:28:52 -08:00
parent 0623b9e6a9
commit 5ffc980589
2 changed files with 20 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
ChangeLog
View File

@ -1,3 +1,7 @@
2016-11-07 Steve Ellcey <sellcey@caviumnetworks.com>
* test-skeleton.c: Document do_test usage.
2016-11-06 Aurelien Jarno <aurelien@aurel32.net>
* iconv/gconv.h (__gconv_info): Define __data element using a

17
test-skeleton.c
View File

@ -36,7 +36,22 @@
/* The test function is normally called `do_test' and it is called
with argc and argv as the arguments. We nevertheless provide the
possibility to overwrite this name. */
possibility to overwrite this name.
The TEST_FUNCTION expression should have a type of 'int' and should
return 0 to indicate a passing test, 1 to indicate a failing test,
or 77 to indicate an unsupported test. Other result values could be
used to indicate a failing test, but the result of the expression
is passed to exit and exit only returns the lower 8 bits of its input.
A non-zero return with some values could cause a test to incorrectly
be considered passing when it really failed. For this reason the
expression should always return 0, 1, or 77.
The test function may print out diagnostic or warning messages as well
as messages about failures. These messages should be printed to stdout
and not stderr so that the output is properly ordered with respect to
the rest of the glibc testsuite run output. */
#ifndef TEST_FUNCTION
# define TEST_FUNCTION do_test (argc, argv)
#endif