testsuite/README.testsuite

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