virtio_blk.h 7.3 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222
  1. #ifndef _LINUX_VIRTIO_BLK_H
  2. #define _LINUX_VIRTIO_BLK_H
  3. /* This header is BSD licensed so anyone can use the definitions to implement
  4. * compatible drivers/servers.
  5. *
  6. * Redistribution and use in source and binary forms, with or without
  7. * modification, are permitted provided that the following conditions
  8. * are met:
  9. * 1. Redistributions of source code must retain the above copyright
  10. * notice, this list of conditions and the following disclaimer.
  11. * 2. Redistributions in binary form must reproduce the above copyright
  12. * notice, this list of conditions and the following disclaimer in the
  13. * documentation and/or other materials provided with the distribution.
  14. * 3. Neither the name of IBM nor the names of its contributors
  15. * may be used to endorse or promote products derived from this software
  16. * without specific prior written permission.
  17. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS ``AS IS'' AND
  18. * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  19. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  20. * ARE DISCLAIMED. IN NO EVENT SHALL IBM OR CONTRIBUTORS BE LIABLE
  21. * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  22. * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  23. * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  24. * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  25. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  26. * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  27. * SUCH DAMAGE. */
  28. #include <linux/types.h>
  29. #include <linux/virtio_ids.h>
  30. #include <linux/virtio_config.h>
  31. #include <linux/virtio_types.h>
  32. /* Feature bits */
  33. #define VIRTIO_BLK_F_SIZE_MAX 1 /* Indicates maximum segment size */
  34. #define VIRTIO_BLK_F_SEG_MAX 2 /* Indicates maximum # of segments */
  35. #define VIRTIO_BLK_F_GEOMETRY 4 /* Legacy geometry available */
  36. #define VIRTIO_BLK_F_RO 5 /* Disk is read-only */
  37. #define VIRTIO_BLK_F_BLK_SIZE 6 /* Block size of disk is available*/
  38. #define VIRTIO_BLK_F_TOPOLOGY 10 /* Topology information is available */
  39. #define VIRTIO_BLK_F_MQ 12 /* support more than one vq */
  40. #define VIRTIO_BLK_F_DISCARD 13 /* DISCARD is supported */
  41. #define VIRTIO_BLK_F_WRITE_ZEROES 14 /* WRITE ZEROES is supported */
  42. #define VIRTIO_BLK_F_SECURE_ERASE 16 /* Secure Erase is supported */
  43. /* Legacy feature bits */
  44. #ifndef VIRTIO_BLK_NO_LEGACY
  45. #define VIRTIO_BLK_F_BARRIER 0 /* Does host support barriers? */
  46. #define VIRTIO_BLK_F_SCSI 7 /* Supports scsi command passthru */
  47. #define VIRTIO_BLK_F_FLUSH 9 /* Flush command supported */
  48. #define VIRTIO_BLK_F_CONFIG_WCE 11 /* Writeback mode available in config */
  49. #ifndef __KERNEL__
  50. /* Old (deprecated) name for VIRTIO_BLK_F_FLUSH. */
  51. #define VIRTIO_BLK_F_WCE VIRTIO_BLK_F_FLUSH
  52. #endif
  53. #endif /* !VIRTIO_BLK_NO_LEGACY */
  54. #define VIRTIO_BLK_ID_BYTES 20 /* ID string length */
  55. struct virtio_blk_config {
  56. /* The capacity (in 512-byte sectors). */
  57. __virtio64 capacity;
  58. /* The maximum segment size (if VIRTIO_BLK_F_SIZE_MAX) */
  59. __virtio32 size_max;
  60. /* The maximum number of segments (if VIRTIO_BLK_F_SEG_MAX) */
  61. __virtio32 seg_max;
  62. /* geometry of the device (if VIRTIO_BLK_F_GEOMETRY) */
  63. struct virtio_blk_geometry {
  64. __virtio16 cylinders;
  65. __u8 heads;
  66. __u8 sectors;
  67. } geometry;
  68. /* block size of device (if VIRTIO_BLK_F_BLK_SIZE) */
  69. __virtio32 blk_size;
  70. /* the next 4 entries are guarded by VIRTIO_BLK_F_TOPOLOGY */
  71. /* exponent for physical block per logical block. */
  72. __u8 physical_block_exp;
  73. /* alignment offset in logical blocks. */
  74. __u8 alignment_offset;
  75. /* minimum I/O size without performance penalty in logical blocks. */
  76. __virtio16 min_io_size;
  77. /* optimal sustained I/O size in logical blocks. */
  78. __virtio32 opt_io_size;
  79. /* writeback mode (if VIRTIO_BLK_F_CONFIG_WCE) */
  80. __u8 wce;
  81. __u8 unused;
  82. /* number of vqs, only available when VIRTIO_BLK_F_MQ is set */
  83. __virtio16 num_queues;
  84. /* the next 3 entries are guarded by VIRTIO_BLK_F_DISCARD */
  85. /*
  86. * The maximum discard sectors (in 512-byte sectors) for
  87. * one segment.
  88. */
  89. __virtio32 max_discard_sectors;
  90. /*
  91. * The maximum number of discard segments in a
  92. * discard command.
  93. */
  94. __virtio32 max_discard_seg;
  95. /* Discard commands must be aligned to this number of sectors. */
  96. __virtio32 discard_sector_alignment;
  97. /* the next 3 entries are guarded by VIRTIO_BLK_F_WRITE_ZEROES */
  98. /*
  99. * The maximum number of write zeroes sectors (in 512-byte sectors) in
  100. * one segment.
  101. */
  102. __virtio32 max_write_zeroes_sectors;
  103. /*
  104. * The maximum number of segments in a write zeroes
  105. * command.
  106. */
  107. __virtio32 max_write_zeroes_seg;
  108. /*
  109. * Set if a VIRTIO_BLK_T_WRITE_ZEROES request may result in the
  110. * deallocation of one or more of the sectors.
  111. */
  112. __u8 write_zeroes_may_unmap;
  113. __u8 unused1[3];
  114. /* the next 3 entries are guarded by VIRTIO_BLK_F_SECURE_ERASE */
  115. /*
  116. * The maximum secure erase sectors (in 512-byte sectors) for
  117. * one segment.
  118. */
  119. __virtio32 max_secure_erase_sectors;
  120. /*
  121. * The maximum number of secure erase segments in a
  122. * secure erase command.
  123. */
  124. __virtio32 max_secure_erase_seg;
  125. /* Secure erase commands must be aligned to this number of sectors. */
  126. __virtio32 secure_erase_sector_alignment;
  127. } __attribute__((packed));
  128. /*
  129. * Command types
  130. *
  131. * Usage is a bit tricky as some bits are used as flags and some are not.
  132. *
  133. * Rules:
  134. * VIRTIO_BLK_T_OUT may be combined with VIRTIO_BLK_T_SCSI_CMD or
  135. * VIRTIO_BLK_T_BARRIER. VIRTIO_BLK_T_FLUSH is a command of its own
  136. * and may not be combined with any of the other flags.
  137. */
  138. /* These two define direction. */
  139. #define VIRTIO_BLK_T_IN 0
  140. #define VIRTIO_BLK_T_OUT 1
  141. #ifndef VIRTIO_BLK_NO_LEGACY
  142. /* This bit says it's a scsi command, not an actual read or write. */
  143. #define VIRTIO_BLK_T_SCSI_CMD 2
  144. #endif /* VIRTIO_BLK_NO_LEGACY */
  145. /* Cache flush command */
  146. #define VIRTIO_BLK_T_FLUSH 4
  147. /* Get device ID command */
  148. #define VIRTIO_BLK_T_GET_ID 8
  149. /* Discard command */
  150. #define VIRTIO_BLK_T_DISCARD 11
  151. /* Write zeroes command */
  152. #define VIRTIO_BLK_T_WRITE_ZEROES 13
  153. /* Secure erase command */
  154. #define VIRTIO_BLK_T_SECURE_ERASE 14
  155. #ifndef VIRTIO_BLK_NO_LEGACY
  156. /* Barrier before this op. */
  157. #define VIRTIO_BLK_T_BARRIER 0x80000000
  158. #endif /* !VIRTIO_BLK_NO_LEGACY */
  159. /*
  160. * This comes first in the read scatter-gather list.
  161. * For legacy virtio, if VIRTIO_F_ANY_LAYOUT is not negotiated,
  162. * this is the first element of the read scatter-gather list.
  163. */
  164. struct virtio_blk_outhdr {
  165. /* VIRTIO_BLK_T* */
  166. __virtio32 type;
  167. /* io priority. */
  168. __virtio32 ioprio;
  169. /* Sector (ie. 512 byte offset) */
  170. __virtio64 sector;
  171. };
  172. /* Unmap this range (only valid for write zeroes command) */
  173. #define VIRTIO_BLK_WRITE_ZEROES_FLAG_UNMAP 0x00000001
  174. /* Discard/write zeroes range for each request. */
  175. struct virtio_blk_discard_write_zeroes {
  176. /* discard/write zeroes start sector */
  177. __le64 sector;
  178. /* number of discard/write zeroes sectors */
  179. __le32 num_sectors;
  180. /* flags for this range */
  181. __le32 flags;
  182. };
  183. #ifndef VIRTIO_BLK_NO_LEGACY
  184. struct virtio_scsi_inhdr {
  185. __virtio32 errors;
  186. __virtio32 data_len;
  187. __virtio32 sense_len;
  188. __virtio32 residual;
  189. };
  190. #endif /* !VIRTIO_BLK_NO_LEGACY */
  191. /* And this is the final byte of the write scatter-gather list. */
  192. #define VIRTIO_BLK_S_OK 0
  193. #define VIRTIO_BLK_S_IOERR 1
  194. #define VIRTIO_BLK_S_UNSUPP 2
  195. #endif /* _LINUX_VIRTIO_BLK_H */