Blame view

Documentation/device-mapper/dm-flakey.txt 1.85 KB
3407ef526   Josef Bacik   dm: add flakey ta...
1
2
  dm-flakey
  =========
b26f5e3d7   Mike Snitzer   dm flakey: add dr...
3
4
5
  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.
3407ef526   Josef Bacik   dm: add flakey ta...
6
7
  
  Starting from the time the table is loaded, the device is available for
b26f5e3d7   Mike Snitzer   dm flakey: add dr...
8
9
  <up interval> seconds, then exhibits unreliable behaviour for <down
  interval> seconds, and then this cycle repeats.
3407ef526   Josef Bacik   dm: add flakey ta...
10

b26f5e3d7   Mike Snitzer   dm flakey: add dr...
11
12
13
14
15
16
17
18
19
20
  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:
3407ef526   Josef Bacik   dm: add flakey ta...
21
22
23
24
25
      <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.
b26f5e3d7   Mike Snitzer   dm flakey: add dr...
26
27
28
29
30
31
32
33
  
  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.
a3998799f   Mike Snitzer   dm flakey: add co...
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
  
    corrupt_bio_byte <Nth_byte> <direction> <value> <flags>:
  	During <down interval>, replace <Nth_byte> of the data of
  	each matching bio with <value>.
  
      <Nth_byte>: The offset of the byte to replace.
  		Counting starts at 1, to replace the first byte.
      <direction>: Either 'r' to corrupt reads or 'w' to corrupt writes.
  		 'w' is incompatible with drop_writes.
      <value>: The value (from 0-255) to write.
      <flags>: Perform the replacement only if bio->bi_rw has all the
  	     selected flags set.
  
  Examples:
    corrupt_bio_byte 32 r 1 0
  	- replaces the 32nd byte of READ bios with the value 1
  
    corrupt_bio_byte 224 w 0 32
  	- replaces the 224th byte of REQ_META (=32) bios with the value 0