1274016Sngiepjdfstest test suite execution is integrated into kyua. This README describes 2274016Sngiehow to use pjdfstest in the default configuration (kyua work directory), and 3274016Sngiewith a specific filesystem path. 4274016Sngie 5274016SngieMethod 1. Executing with default configuration (kyua work directory) 6274016Sngie 7274016Sngie 1. Elevate privileges: 8274016Sngie % su - 9274016Sngie 2. cd to the tests directory: 10274016Sngie % cd /usr/tests/sys/pjdfstest 11274016Sngie 3. Run kyua: 12274016Sngie % kyua test 13274016Sngie 14274016Sngie Executing the commands as shown above will run pjdfstest in the kyua work 15274016Sngie directory. The kyua work directory defaults to a random generated path under 16274016Sngie /tmp; please see TMPDIR in kyua(1) for more details on how the temporary path 17274016Sngie is chosen with kyua. 18274016Sngie 19274016SngieMethod 2. Executing with a specific filesystem path (in this case /mnt) 20274016Sngie 21274016Sngie 1. Elevate privileges: 22274016Sngie % su - 23274016Sngie 2. cd to the tests directory: 24274016Sngie % cd /usr/tests/sys/pjdfstest 25274016Sngie 3. Run kyua: 26274016Sngie % env PJDFSTEST_TEST_PATH=/mnt kyua test 27274016Sngie 28274016Sngie WARNING: the above method violates the test program isolation algorithm 29274016Sngie described in kyua(1); as such, $PJDFSTEST_TEST_PATH must be cleaned up after 30274016Sngie executing the testcases. 31274016Sngie 32274016Sngie It's highly recommended that $PJDFSTEST_TEST_PATH be pointed to a sandboxed 33274016Sngie filesystem, e.g. a small UFS-formatted memory disk or ZFS dataset with 34274016Sngie quotas enabled, so the filesystem can be easily destroyed after the test 35274016Sngie execution is complete, and the testcases are properly bounded both in terms 36274016Sngie of time and space. 37