summaryrefslogtreecommitdiff
path: root/Documentation/device-mapper/dm-flakey.txt
diff options
context:
space:
mode:
authorMike Snitzer <snitzer@redhat.com>2011-08-02 15:32:05 +0400
committerAlasdair G Kergon <agk@redhat.com>2011-08-02 15:32:05 +0400
commitb26f5e3d7127487e934758c1fbe05d683b082cb0 (patch)
tree8b120e0e45e3a50c1c5adada0eede0870d62457d /Documentation/device-mapper/dm-flakey.txt
parentdfd068b01f02653c6650f1c0eda443b2655d1471 (diff)
downloadlinux-b26f5e3d7127487e934758c1fbe05d683b082cb0.tar.xz
dm flakey: add drop_writes
Add 'drop_writes' option to drop writes silently while the device is 'down'. Reads are not touched. Signed-off-by: Mike Snitzer <snitzer@redhat.com> Signed-off-by: Alasdair G Kergon <agk@redhat.com>
Diffstat (limited to 'Documentation/device-mapper/dm-flakey.txt')
-rw-r--r--Documentation/device-mapper/dm-flakey.txt29
1 files changed, 23 insertions, 6 deletions
diff --git a/Documentation/device-mapper/dm-flakey.txt b/Documentation/device-mapper/dm-flakey.txt
index c8efdfd19a65..1b66c868ee7e 100644
--- a/Documentation/device-mapper/dm-flakey.txt
+++ b/Documentation/device-mapper/dm-flakey.txt
@@ -1,17 +1,34 @@
dm-flakey
=========
-This target is the same as the linear target except that it returns I/O
-errors periodically. It's been found useful in simulating failing
-devices for testing purposes.
+This target is the same as the linear target except that it exhibits
+unreliable behaviour periodically. It's been found useful in simulating
+failing devices for testing purposes.
Starting from the time the table is loaded, the device is available for
-<up interval> seconds, then returns errors for <down interval> seconds,
-and then this cycle repeats.
+<up interval> seconds, then exhibits unreliable behaviour for <down
+interval> seconds, and then this cycle repeats.
-Parameters: <dev path> <offset> <up interval> <down interval>
+Also, consider using this in combination with the dm-delay target too,
+which can delay reads and writes and/or send them to different
+underlying devices.
+
+Table parameters
+----------------
+ <dev path> <offset> <up interval> <down interval> \
+ [<num_features> [<feature arguments>]]
+
+Mandatory parameters:
<dev path>: Full pathname to the underlying block-device, or a
"major:minor" device-number.
<offset>: Starting sector within the device.
<up interval>: Number of seconds device is available.
<down interval>: Number of seconds device returns errors.
+
+Optional feature parameters:
+ If no feature parameters are present, during the periods of
+ unreliability, all I/O returns errors.
+
+ drop_writes:
+ All write I/O is silently ignored.
+ Read I/O is handled correctly.