btrfs: add test for send/receive with file capabilities set
[xfstests-dev.git] / doc / auxiliary-programs.txt
index 21ef118596b6c4c967c9e39b438dcdc98ff33871..de158322ab5eb646afca1077cb8e4ca808d2f7c7 100644 (file)
@@ -16,6 +16,9 @@ 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
+ - 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
  - t_dir_type          -- print directory entries and their file type
@@ -30,6 +33,27 @@ 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.
+
+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