README.testsuite
1automatic testsuite for rsync -*- text -*-
2
3We're trying to develop some more substantial tests to prevent rsync
4regressions. Ideally, all code changes or bug reports would come with
5an appropriate test suite.
6
7You can run these tests by typing "make check" in the build directory.
8The tests will run using the rsync binary in the build directory, so
9you do not need to do "make install" first. Indeed, you probably
10should not install rsync before running the tests.
11
12If you instead type "make installcheck" then the suite will test the
13rsync binary from its installed location (e.g. /usr/local/bin/rsync).
14You can use this to test a distribution build, or perhaps to run a new
15test suite against an old version of rsync. Note that in accordance
16with the GNU Standards, installcheck does not look for rsync on the
17path.
18
19If the tests pass, you should see a report to that effect. Some tests
20require being root or some other precondition, and so will normally not
21be checked -- look at the test scripts for more information.
22
23If the tests fail, you will see rather more output. The scratch
24directory will remain in the build directory. It would be useful if
25you could include the log messages when reporting a failure.
26
27These tests also run automatically on the build farm, and you can see
28the results on http://build.samba.org/.
29
30
31