check: allow '-e testid' to exclude a single test
[xfstests-dev.git] / doc / auxiliary-programs.txt
index 2e2060a0cec65fd6d79bea81783b53e28f114ecb..de158322ab5eb646afca1077cb8e4ca808d2f7c7 100644 (file)
@@ -16,8 +16,12 @@ note the dependency with:
 Contents:
 
  - af_unix             -- Create an AF_UNIX socket
 Contents:
 
  - af_unix             -- Create an AF_UNIX socket
+ - dmerror             -- fault injection block device control
+ - fsync-err           -- tests fsync error reporting after failed writeback
+ - log-writes/replay-log -- Replay log from device mapper log-writes target
  - open_by_handle      -- open_by_handle_at syscall exercise
  - stat_test           -- statx syscall exercise
  - open_by_handle      -- open_by_handle_at syscall exercise
  - stat_test           -- statx syscall exercise
+ - t_dir_type          -- print directory entries and their file type
  - xfs_io              -- General I/O operation exercise
 
 
  - xfs_io              -- General I/O operation exercise
 
 
@@ -29,6 +33,27 @@ af_unix
 
        The af_unix program creates an AF_UNIX socket at the given location.
 
 
        The af_unix program creates an AF_UNIX socket at the given location.
 
+dmerror
+
+       dmerror is a program for creating, destroying and controlling a
+       fault injection device. The device can be set up as initially
+       working and then flip to throwing errors for testing purposes.
+
+fsync-err
+
+       Specialized program for testing how the kernel reports errors that
+       occur during writeback. Works in conjunction with the dmerror script
+       in tools/ to write data to a device, and then force it to fail
+       writeback and test that errors are reported during fsync and cleared
+       afterward.
+
+log-writes/replay-log
+
+       Specialized program for replaying a write log that was recorded by
+       device mapper log-writes target.  The tools is used to perform crash
+       consistency tests, allowing to run an arbitrary check tool (fsck) at
+       specified checkpoints in the write log.
+
 open_by_handle
 
        The open_by_handle program exercises the open_by_handle_at() system
 open_by_handle
 
        The open_by_handle program exercises the open_by_handle_at() system
@@ -48,6 +73,12 @@ stat_test
                _require_statx
 
 
                _require_statx
 
 
+t_dir_type
+
+       The t_dir_type program exercises the getdents64() system call.
+       It prints directory entry names returned from getdents64() and
+       thier d_type, optionally filtered by type or by inode number.
+
 xfs_io
 
        The xfs_io program can be found in the xfsprogs package and can be used
 xfs_io
 
        The xfs_io program can be found in the xfsprogs package and can be used