X-Git-Url: http://git.apps.os.sepia.ceph.com/?p=xfstests-dev.git;a=blobdiff_plain;f=doc%2Frequirement-checking.txt;h=45d2756bd2ceec07cb6b2ed5b4e6997dc0a14f60;hp=f3fc9f49eba2a61bbac9a158406eec3437713c94;hb=9f8584434b588ed0b2be0eba4f8d02b6640e56aa;hpb=b22a8fe0c7af5cc008f0d7ea8c10fdbb24f277b3 diff --git a/doc/requirement-checking.txt b/doc/requirement-checking.txt index f3fc9f49..45d2756b 100644 --- a/doc/requirement-checking.txt +++ b/doc/requirement-checking.txt @@ -12,10 +12,19 @@ they have. This is done with _require_ macros, which may take parameters. _require_test_program _require_xfs_io_command [] - (2) System call requirements. + (2) Filesystem capability requirements. + + _require_chattr + _require_exportfs + + (3) System call requirements. _require_statx + (4) Device mapper requirement. + + _require_dm_target + _require_log_writes ==================== GENERAL REQUIREMENTS @@ -60,13 +69,35 @@ _require_xfs_io_command [] switch. For example: _require_xfs_io_command "falloc" - _require_xfs_io_command "chattr" "+/-x" + _require_xfs_io_command "chattr" "x" The first requires that xfs_io support the falloc command and the second that it supports the chattr command and that the chattr command supports the +x and -x arguments (DAX attribute). +================================== +FILESYSTEM CAPABILITY REQUIREMENTS +================================== + +_require_chattr + + The test requires that the filesystem attribute set by the chattr command + with + as an argument be available and supported by the $TEST_DEV + filesystem. No check is made of the scratch filesystem. For example: + + _require_chattr ai + + tests to see if setting the append-only and immutable attributes on a file + (chattr +a +i) is supported. + +_require_exportfs + + The test requires that the $TEST_DEV filesystem supports NFS export. + The test also requires the use of the open_by_handle_at() system call and + will be skipped if it isn't available in the kernel. + + ======================== SYSTEM CALL REQUIREMENTS ======================== @@ -75,3 +106,28 @@ _require_statx The test requires the use of the statx() system call and will be skipped if it isn't available in the kernel. + + +========================== +DEVICE MAPPER REQUIREMENTS +========================== + +_require_dm_target + + The test requires the use of the device mapper target and will be skipped + if it isn't available in the kernel. + +_require_log_writes + + The test requires the use of the device mapper target log-writes. + The test also requires the test program log-writes/replay-log is built + and will be skipped if either isn't available. + +====================== +PERF TEST REQUIREMENTS +====================== + +_require_fio_results + + This test requires the supporting tools for saving and comparing fio based + perf test results.