Updated Controlling the ZFS Buildbot (markdown)

Giuseppe Di Natale 2017-06-15 15:18:08 -07:00
parent 30634fa728
commit b06e38f28b
1 changed files with 35 additions and 37 deletions

@ -47,41 +47,39 @@ Requires-builders: style test
```
## Controlling Tests with the TEST File
The ZFS Buildbot also has the ability to control which tests are executed by TEST
builders. At the top level of the ZFS source tree, there is the [`TEST`
file](https://github.com/zfsonlinux/zfs/blob/master/TEST). Within this file,
various variables can be defined to control if and how a specific test should
run. Below is a list of variables and a brief description of what each variable
controls.
At the top level of the ZFS source tree, there is the [`TEST`
file](https://github.com/zfsonlinux/zfs/blob/master/TEST) which contains variables
that control if and how a specific test should run. Below is a list of each variable
and a brief description of what each variable controls.
* `TEST_PREPARE_WATCHDOG` -
* `TEST_SPLAT_SKIP` -
* `TEST_SPLAT_OPTIONS` -
* `TEST_ZTEST_SKIP` -
* `TEST_ZTEST_TIMEOUT` -
* `TEST_ZTEST_DIR` -
* `TEST_ZIMPORT_SKIP` -
* `TEST_ZIMPORT_DIR` -
* `TEST_ZIMPORT_VERSIONS` -
* `TEST_ZIMPORT_POOLS` -
* `TEST_ZIMPORT_OPTIONS` -
* `TEST_XFSTESTS_SKIP` -
* `TEST_XFSTESTS_URL` -
* `TEST_XFSTESTS_VER` -
* `TEST_XFSTESTS_POOL` -
* `TEST_XFSTESTS_FS` -
* `TEST_XFSTESTS_VDEV` -
* `TEST_XFSTESTS_OPTIONS` -
* `TEST_ZFSTESTS_SKIP` -
* `TEST_ZFSTESTS_DISKS` -
* `TEST_ZFSTESTS_DISKSIZE` -
* `TEST_ZFSTESTS_RUNFILE` -
* `TEST_ZFSSTRESS_SKIP` -
* `TEST_ZFSSTRESS_URL` -
* `TEST_ZFSSTRESS_VER` -
* `TEST_ZFSSTRESS_RUNTIME` -
* `TEST_ZFSSTRESS_POOL` -
* `TEST_ZFSSTRESS_FS` -
* `TEST_ZFSSTRESS_VDEV` -
* `TEST_ZFSSTRESS_DIR` -
* `TEST_ZFSSTRESS_OPTIONS` -
* `TEST_PREPARE_WATCHDOG` - Enables the Linux kernel watchdog
* `TEST_SPLAT_SKIP` - Determines if `splat` testing is skipped
* `TEST_SPLAT_OPTIONS` - Command line options to provide to `splat`
* `TEST_ZTEST_SKIP` - Determines if `ztest` testing is skipped
* `TEST_ZTEST_TIMEOUT` - The length of time `ztest` should run
* `TEST_ZTEST_DIR` - Directory where `ztest` will create vdevs
* `TEST_ZIMPORT_SKIP` - Determines if `zimport` testing is skipped
* `TEST_ZIMPORT_DIR` - Directory used during `zimport`
* `TEST_ZIMPORT_VERSIONS` - Source versions to test
* `TEST_ZIMPORT_POOLS` - Names of the pools for `zimport` to use for testing
* `TEST_ZIMPORT_OPTIONS` - Command line options to provide to `zimport`
* `TEST_XFSTESTS_SKIP` - Determines if `xfstest` testing is skipped
* `TEST_XFSTESTS_URL` - URL to download `xfstest` from
* `TEST_XFSTESTS_VER` - Name of the tarball to download from `TEST_XFSTESTS_URL`
* `TEST_XFSTESTS_POOL` - Name of pool to create and used by `xfstest`
* `TEST_XFSTESTS_FS` - Name of dataset for use by `xfstest`
* `TEST_XFSTESTS_VDEV` - Name of the vdev used by `xfstest`
* `TEST_XFSTESTS_OPTIONS` - Command line options to provide to `xfstest`
* `TEST_ZFSTESTS_SKIP` - Determines if `zfs-tests` testing is skipped
* `TEST_ZFSTESTS_DISKS` - Space delimited list of disks that `zfs-tests` is allowed to use
* `TEST_ZFSTESTS_DISKSIZE` - File size of file based vdevs used by `zfs-tests`
* `TEST_ZFSTESTS_RUNFILE` - The runfile to use when running `zfs-tests`
* `TEST_ZFSSTRESS_SKIP` - Determines if `zfsstress` testing is skipped
* `TEST_ZFSSTRESS_URL` - URL to download `zfsstress` from
* `TEST_ZFSSTRESS_VER` - Name of the tarball to download from `TEST_ZFSSTRESS_URL`
* `TEST_ZFSSTRESS_RUNTIME` - Duration to run `runstress.sh`
* `TEST_ZFSSTRESS_POOL` - Name of pool to create and use for `zfsstress` testing
* `TEST_ZFSSTRESS_FS` - Name of dataset for use during `zfsstress` tests
* `TEST_ZFSSTRESS_VDEV` - Directory to store vdevs for use during `zfsstress` tests
* `TEST_ZFSSTRESS_DIR` - Unused
* `TEST_ZFSSTRESS_OPTIONS` - Command line options to provide to `runstress.sh`