Jerome Marchand | 0e53c2b | 2008-02-08 11:10:56 +0100 | [diff] [blame] | 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. |
Martin K. Petersen | c1c72b5 | 2008-06-17 18:59:57 +0200 | [diff] [blame] | 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. |
Martin K. Petersen | c72758f | 2009-05-22 17:17:53 -0400 | [diff] [blame^] | 63 | |
| 64 | What: /sys/block/<disk>/alignment_offset |
| 65 | Date: April 2009 |
| 66 | Contact: Martin K. Petersen <martin.petersen@oracle.com> |
| 67 | Description: |
| 68 | Storage devices may report a physical block size that is |
| 69 | bigger than the logical block size (for instance a drive |
| 70 | with 4KB physical sectors exposing 512-byte logical |
| 71 | blocks to the operating system). This parameter |
| 72 | indicates how many bytes the beginning of the device is |
| 73 | offset from the disk's natural alignment. |
| 74 | |
| 75 | What: /sys/block/<disk>/<partition>/alignment_offset |
| 76 | Date: April 2009 |
| 77 | Contact: Martin K. Petersen <martin.petersen@oracle.com> |
| 78 | Description: |
| 79 | Storage devices may report a physical block size that is |
| 80 | bigger than the logical block size (for instance a drive |
| 81 | with 4KB physical sectors exposing 512-byte logical |
| 82 | blocks to the operating system). This parameter |
| 83 | indicates how many bytes the beginning of the partition |
| 84 | is offset from the disk's natural alignment. |
| 85 | |
| 86 | What: /sys/block/<disk>/queue/logical_block_size |
| 87 | Date: May 2009 |
| 88 | Contact: Martin K. Petersen <martin.petersen@oracle.com> |
| 89 | Description: |
| 90 | This is the smallest unit the storage device can |
| 91 | address. It is typically 512 bytes. |
| 92 | |
| 93 | What: /sys/block/<disk>/queue/physical_block_size |
| 94 | Date: May 2009 |
| 95 | Contact: Martin K. Petersen <martin.petersen@oracle.com> |
| 96 | Description: |
| 97 | This is the smallest unit the storage device can write |
| 98 | without resorting to read-modify-write operation. It is |
| 99 | usually the same as the logical block size but may be |
| 100 | bigger. One example is SATA drives with 4KB sectors |
| 101 | that expose a 512-byte logical block size to the |
| 102 | operating system. |
| 103 | |
| 104 | What: /sys/block/<disk>/queue/minimum_io_size |
| 105 | Date: April 2009 |
| 106 | Contact: Martin K. Petersen <martin.petersen@oracle.com> |
| 107 | Description: |
| 108 | Storage devices may report a preferred minimum I/O size, |
| 109 | which is the smallest request the device can perform |
| 110 | without incurring a read-modify-write penalty. For disk |
| 111 | drives this is often the physical block size. For RAID |
| 112 | arrays it is often the stripe chunk size. |
| 113 | |
| 114 | What: /sys/block/<disk>/queue/optimal_io_size |
| 115 | Date: April 2009 |
| 116 | Contact: Martin K. Petersen <martin.petersen@oracle.com> |
| 117 | Description: |
| 118 | Storage devices may report an optimal I/O size, which is |
| 119 | the device's preferred unit of receiving I/O. This is |
| 120 | rarely reported for disk drives. For RAID devices it is |
| 121 | usually the stripe width or the internal block size. |