diff options
author | Alan Somers <asomers@FreeBSD.org> | 2017-02-21 21:01:01 +0000 |
---|---|---|
committer | Alan Somers <asomers@FreeBSD.org> | 2017-02-21 21:01:01 +0000 |
commit | 1d06be4ab366c2f859b9521b075a9d9d55fea664 (patch) | |
tree | 23c536995d7b04eebd67fb994af8459e59a70a12 /share | |
parent | 90c1b723a515b4ddfcb42d71d62d3814a8a92655 (diff) | |
download | src-1d06be4ab366c2f859b9521b075a9d9d55fea664.tar.gz src-1d06be4ab366c2f859b9521b075a9d9d55fea664.zip |
Improve pjdfstest run instructions
In the Kyua era, it's no longer necessary to set PJDFSTEST_TEST_PATH. Just
use TMPDIR instead.
Reviewed by: ngie
MFC after: 3 weeks
Relnotes: yes
Sponsored by: Spectra Logic Corp
Differential Revision: https://reviews.freebsd.org/D9340
Notes
Notes:
svn path=/head/; revision=314056
Diffstat (limited to 'share')
-rw-r--r-- | share/doc/pjdfstest/README | 27 |
1 files changed, 15 insertions, 12 deletions
diff --git a/share/doc/pjdfstest/README b/share/doc/pjdfstest/README index d09011789e42..fdad7a97b70b 100644 --- a/share/doc/pjdfstest/README +++ b/share/doc/pjdfstest/README @@ -1,6 +1,6 @@ -pjdfstest test suite execution is integrated into kyua. This README describes -how to use pjdfstest in the default configuration (kyua work directory), and -with a specific filesystem path. +The pjdfstest test suite is normally run by kyua. It requires kyua 0.11 or +newer. This README describes how to use pjdfstest in the default configuration +(kyua work directory), with a specific filesystem path, and with prove(1). Method 1. Executing with default configuration (kyua work directory) @@ -23,14 +23,17 @@ Method 2. Executing with a specific filesystem path (in this case /mnt) 2. cd to the tests directory: % cd /usr/tests/sys/pjdfstest 3. Run kyua: - % env PJDFSTEST_TEST_PATH=/mnt kyua test + % env TMPDIR=/mnt kyua test - WARNING: the above method violates the test program isolation algorithm - described in kyua(1); as such, $PJDFSTEST_TEST_PATH must be cleaned up after - executing the testcases. + Note that if HOME is undefined, this will result in kyua's logfile being + placed in TMPDIR, which may not be what you want. You can always use + --logfile to explicitly select the log location. - It's highly recommended that $PJDFSTEST_TEST_PATH be pointed to a sandboxed - filesystem, e.g. a small UFS-formatted memory disk or ZFS dataset with - quotas enabled, so the filesystem can be easily destroyed after the test - execution is complete, and the testcases are properly bounded both in terms - of time and space. +Method 3. Executing pjdfstest with prove + + 1. Elevate privileges: + % su - + 2. cd to the temporary directory of your choice + % cd /mnt + 3. Invoke a specific test manually + % prove -rv /usr/tests/sys/pjdfstest/chmod/00 |