Update URL to fate samples
[libav.git] / doc / fate.txt
CommitLineData
c535d089
LB
1FATE Automated Testing Environment
2
3FATE provides a regression testsuite that can be run locally or configured
4to send reports to fate.libav.org.
5In order to run, it needs a large amount of data (samples and references)
6that is provided separately from the actual source distribution.
7
8Use the following command to get the fate test samples
9
a28b0587 10# rsync -aL rsync://fate-suite.libav.org:/fate-suite/ fate-suite
c535d089
LB
11
12To inform the build system about the testsuite location, pass
13`--samples=<path to the samples>` to configure or set the SAMPLES Make
14variable or the FATE_SAMPLES environment variable to a suitable value.
15
16For information on how to set up FATE to send results to the official Libav
17testing framework, please refer to the following wiki page:
18http://wiki.multimedia.cx/index.php?title=FATE
19
20FATE Makefile targets:
21
22fate-list
23 Will list all fate/regression test targets.
24
25fate
26 Run the FATE test suite (requires the fate-suite dataset).
27
28Fate Makefile variables:
29
30V
31 Verbosity level, can be set to 0, 1 or 2.
32 * 0: show just the test arguments
33 * 1: show just the command used in the test
34 * 2: show everything
35
36SAMPLES
37 Specify or override the path to the FATE samples at make time, it has a
38 meaning only while running the regression tests.
39
40THREADS
41 Specify how many threads to use while running regression tests, it is
42 quite useful to detect thread-related regressions.
43
44Example:
45 make V=1 SAMPLES=/var/fate/samples THREADS=2 fate