block: Data integrity infrastructure documentation
[linux-3.10.git] / Documentation / ABI / testing / sysfs-block
1 What:           /sys/block/<disk>/stat
2 Date:           February 2008
3 Contact:        Jerome Marchand <jmarchan@redhat.com>
4 Description:
5                 The /sys/block/<disk>/stat files displays the I/O
6                 statistics of disk <disk>. They contain 11 fields:
7                  1 - reads completed succesfully
8                  2 - reads merged
9                  3 - sectors read
10                  4 - time spent reading (ms)
11                  5 - writes completed
12                  6 - writes merged
13                  7 - sectors written
14                  8 - time spent writing (ms)
15                  9 - I/Os currently in progress
16                 10 - time spent doing I/Os (ms)
17                 11 - weighted time spent doing I/Os (ms)
18                 For more details refer Documentation/iostats.txt
19
20
21 What:           /sys/block/<disk>/<part>/stat
22 Date:           February 2008
23 Contact:        Jerome Marchand <jmarchan@redhat.com>
24 Description:
25                 The /sys/block/<disk>/<part>/stat files display the
26                 I/O statistics of partition <part>. The format is the
27                 same as the above-written /sys/block/<disk>/stat
28                 format.
29
30
31 What:           /sys/block/<disk>/integrity/format
32 Date:           June 2008
33 Contact:        Martin K. Petersen <martin.petersen@oracle.com>
34 Description:
35                 Metadata format for integrity capable block device.
36                 E.g. T10-DIF-TYPE1-CRC.
37
38
39 What:           /sys/block/<disk>/integrity/read_verify
40 Date:           June 2008
41 Contact:        Martin K. Petersen <martin.petersen@oracle.com>
42 Description:
43                 Indicates whether the block layer should verify the
44                 integrity of read requests serviced by devices that
45                 support sending integrity metadata.
46
47
48 What:           /sys/block/<disk>/integrity/tag_size
49 Date:           June 2008
50 Contact:        Martin K. Petersen <martin.petersen@oracle.com>
51 Description:
52                 Number of bytes of integrity tag space available per
53                 512 bytes of data.
54
55
56 What:           /sys/block/<disk>/integrity/write_generate
57 Date:           June 2008
58 Contact:        Martin K. Petersen <martin.petersen@oracle.com>
59 Description:
60                 Indicates whether the block layer should automatically
61                 generate checksums for write requests bound for
62                 devices that support receiving integrity metadata.