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