generic: add a writeback error handling test

[xfstests-dev.git] / doc / auxiliary-programs.txt

diff --git a/doc/auxiliary-programs.txt b/doc/auxiliary-programs.txt
index 21ef118596b6c4c967c9e39b438dcdc98ff33871..bcab453c43358e1ac77308039cb4bddbe4a03fa0 100644 (file)
--- a/doc/auxiliary-programs.txt
+++ b/doc/auxiliary-programs.txt
@@ -16,6 +16,8 @@ note the dependency with:
 Contents:
 
  - af_unix             -- Create an AF_UNIX socket
+ - dmerror             -- fault injection block device control
+ - fsync-err           -- tests fsync error reporting after failed writeback
  - open_by_handle      -- open_by_handle_at syscall exercise
  - stat_test           -- statx syscall exercise
  - t_dir_type          -- print directory entries and their file type
@@ -30,6 +32,20 @@ af_unix
 
        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.
+
 open_by_handle
 
        The open_by_handle program exercises the open_by_handle_at() system