1e5a92d33SSascha Wildner$FreeBSD: src/lib/libc_r/test/README,v 1.1.2.1 2000/07/17 22:18:32 jasone Exp $ 2e5a92d33SSascha Wildner 3e5a92d33SSascha WildnerThis test suite is meant to test general functionality of pthreads, as well as 4e5a92d33SSascha Wildnerprovide a simple framework for regression tests. In general, this test suite 5*62481538SSascha Wildnercan be used with any pthreads library. 6e5a92d33SSascha Wildner 7e5a92d33SSascha WildnerThere are two forms of test that the 'verify' script understands. The simpler 8e5a92d33SSascha Wildnerform is the diff format, where the output of the test program is diff'ed with 9e5a92d33SSascha Wildnerthe correspondingly named .exp file. If there is diff output, the test fails. 10e5a92d33SSascha WildnerThe sequence test format is somewhat more complex, and is documented in the 11e5a92d33SSascha Wildnercommand line usage output for verify. The advantage of this format is that it 12e5a92d33SSascha Wildnerallows multiple tests to pass/fail within one program. 13e5a92d33SSascha Wildner 14e5a92d33SSascha WildnerThere is no driving need for test naming consistency, but the existing tests 15e5a92d33SSascha Wildnergenerally follow these conventions: 16e5a92d33SSascha Wildner 17e5a92d33SSascha Wildner<name>_d.c <name>_d.exp : Diff mode C test and expected output file. 18e5a92d33SSascha Wildner<name>_s.c : Sequence mode C test. 19e5a92d33SSascha Wildner<name>_b*.c : Back end C program used by perl tests. 20e5a92d33SSascha Wildner<name>_d.pl <name>_d.pl.exp : Diff mode perl test and expected output file. 21e5a92d33SSascha Wildner<name>_s.pl : Sequence mode perl test. 22e5a92d33SSascha Wildner 23e5a92d33SSascha Wildner<name> is something descriptive, such as "pr14685" in the case of a PR-related 24e5a92d33SSascha Wildnerregression test, or "mutex" in the case of a test of mutexes. 25