xref: /freebsd/share/doc/pjdfstest/README (revision 6ae9acde636a6411b14ec781205654c718866745)
1*1d06be4aSAlan SomersThe pjdfstest test suite is normally run by kyua.  It requires kyua 0.11 or
2*1d06be4aSAlan Somersnewer. This README describes how to use pjdfstest in the default configuration
3*1d06be4aSAlan Somers(kyua work directory), with a specific filesystem path, and with prove(1).
4fa809347SEnji Cooper
5fa809347SEnji CooperMethod 1. Executing with default configuration (kyua work directory)
6fa809347SEnji Cooper
7fa809347SEnji Cooper    1. Elevate privileges:
8fa809347SEnji Cooper       % su -
9fa809347SEnji Cooper    2. cd to the tests directory:
10fa809347SEnji Cooper       % cd /usr/tests/sys/pjdfstest
11fa809347SEnji Cooper    3. Run kyua:
12fa809347SEnji Cooper       % kyua test
13fa809347SEnji Cooper
14fa809347SEnji Cooper   Executing the commands as shown above will run pjdfstest in the kyua work
15fa809347SEnji Cooper   directory. The kyua work directory defaults to a random generated path under
16fa809347SEnji Cooper   /tmp; please see TMPDIR in kyua(1) for more details on how the temporary path
17fa809347SEnji Cooper   is chosen with kyua.
18fa809347SEnji Cooper
19fa809347SEnji CooperMethod 2. Executing with a specific filesystem path (in this case /mnt)
20fa809347SEnji Cooper
21fa809347SEnji Cooper    1. Elevate privileges:
22fa809347SEnji Cooper       % su -
23fa809347SEnji Cooper    2. cd to the tests directory:
24fa809347SEnji Cooper       % cd /usr/tests/sys/pjdfstest
25fa809347SEnji Cooper    3. Run kyua:
26*1d06be4aSAlan Somers       % env TMPDIR=/mnt kyua test
27fa809347SEnji Cooper
28*1d06be4aSAlan Somers   Note that if HOME is undefined, this will result in kyua's logfile being
29*1d06be4aSAlan Somers   placed in TMPDIR, which may not be what you want.  You can always use
30*1d06be4aSAlan Somers   --logfile to explicitly select the log location.
31fa809347SEnji Cooper
32*1d06be4aSAlan SomersMethod 3. Executing pjdfstest with prove
33*1d06be4aSAlan Somers
34*1d06be4aSAlan Somers    1. Elevate privileges:
35*1d06be4aSAlan Somers       % su -
36*1d06be4aSAlan Somers    2. cd to the temporary directory of your choice
37*1d06be4aSAlan Somers       % cd /mnt
38*1d06be4aSAlan Somers    3. Invoke a specific test manually
39*1d06be4aSAlan Somers       % prove -rv /usr/tests/sys/pjdfstest/chmod/00
40