1 /* 2 * Virtio SCSI HBA 3 * 4 * Copyright IBM, Corp. 2010 5 * 6 * Authors: 7 * Stefan Hajnoczi <stefanha@linux.vnet.ibm.com> 8 * 9 * This work is licensed under the terms of the GNU GPL, version 2. See 10 * the COPYING file in the top-level directory. 11 * 12 */ 13 14 #ifndef _QEMU_VIRTIO_SCSI_H 15 #define _QEMU_VIRTIO_SCSI_H 16 17 #include "hw/virtio/virtio.h" 18 #include "hw/pci/pci.h" 19 #include "hw/scsi/scsi.h" 20 #include "sysemu/iothread.h" 21 #include "hw/virtio/dataplane/vring.h" 22 23 #define TYPE_VIRTIO_SCSI_COMMON "virtio-scsi-common" 24 #define VIRTIO_SCSI_COMMON(obj) \ 25 OBJECT_CHECK(VirtIOSCSICommon, (obj), TYPE_VIRTIO_SCSI_COMMON) 26 27 #define TYPE_VIRTIO_SCSI "virtio-scsi-device" 28 #define VIRTIO_SCSI(obj) \ 29 OBJECT_CHECK(VirtIOSCSI, (obj), TYPE_VIRTIO_SCSI) 30 31 32 /* The ID for virtio_scsi */ 33 #define VIRTIO_ID_SCSI 8 34 35 /* Feature Bits */ 36 #define VIRTIO_SCSI_F_INOUT 0 37 #define VIRTIO_SCSI_F_HOTPLUG 1 38 #define VIRTIO_SCSI_F_CHANGE 2 39 40 #define VIRTIO_SCSI_VQ_SIZE 128 41 #define VIRTIO_SCSI_CDB_SIZE 32 42 #define VIRTIO_SCSI_SENSE_SIZE 96 43 #define VIRTIO_SCSI_MAX_CHANNEL 0 44 #define VIRTIO_SCSI_MAX_TARGET 255 45 #define VIRTIO_SCSI_MAX_LUN 16383 46 47 /* Response codes */ 48 #define VIRTIO_SCSI_S_OK 0 49 #define VIRTIO_SCSI_S_OVERRUN 1 50 #define VIRTIO_SCSI_S_ABORTED 2 51 #define VIRTIO_SCSI_S_BAD_TARGET 3 52 #define VIRTIO_SCSI_S_RESET 4 53 #define VIRTIO_SCSI_S_BUSY 5 54 #define VIRTIO_SCSI_S_TRANSPORT_FAILURE 6 55 #define VIRTIO_SCSI_S_TARGET_FAILURE 7 56 #define VIRTIO_SCSI_S_NEXUS_FAILURE 8 57 #define VIRTIO_SCSI_S_FAILURE 9 58 #define VIRTIO_SCSI_S_FUNCTION_SUCCEEDED 10 59 #define VIRTIO_SCSI_S_FUNCTION_REJECTED 11 60 #define VIRTIO_SCSI_S_INCORRECT_LUN 12 61 62 /* Controlq type codes. */ 63 #define VIRTIO_SCSI_T_TMF 0 64 #define VIRTIO_SCSI_T_AN_QUERY 1 65 #define VIRTIO_SCSI_T_AN_SUBSCRIBE 2 66 67 /* Valid TMF subtypes. */ 68 #define VIRTIO_SCSI_T_TMF_ABORT_TASK 0 69 #define VIRTIO_SCSI_T_TMF_ABORT_TASK_SET 1 70 #define VIRTIO_SCSI_T_TMF_CLEAR_ACA 2 71 #define VIRTIO_SCSI_T_TMF_CLEAR_TASK_SET 3 72 #define VIRTIO_SCSI_T_TMF_I_T_NEXUS_RESET 4 73 #define VIRTIO_SCSI_T_TMF_LOGICAL_UNIT_RESET 5 74 #define VIRTIO_SCSI_T_TMF_QUERY_TASK 6 75 #define VIRTIO_SCSI_T_TMF_QUERY_TASK_SET 7 76 77 /* Events. */ 78 #define VIRTIO_SCSI_T_EVENTS_MISSED 0x80000000 79 #define VIRTIO_SCSI_T_NO_EVENT 0 80 #define VIRTIO_SCSI_T_TRANSPORT_RESET 1 81 #define VIRTIO_SCSI_T_ASYNC_NOTIFY 2 82 #define VIRTIO_SCSI_T_PARAM_CHANGE 3 83 84 /* Reasons for transport reset event */ 85 #define VIRTIO_SCSI_EVT_RESET_HARD 0 86 #define VIRTIO_SCSI_EVT_RESET_RESCAN 1 87 #define VIRTIO_SCSI_EVT_RESET_REMOVED 2 88 89 /* SCSI command request, followed by CDB and data-out */ 90 typedef struct { 91 uint8_t lun[8]; /* Logical Unit Number */ 92 uint64_t tag; /* Command identifier */ 93 uint8_t task_attr; /* Task attribute */ 94 uint8_t prio; 95 uint8_t crn; 96 } QEMU_PACKED VirtIOSCSICmdReq; 97 98 /* Response, followed by sense data and data-in */ 99 typedef struct { 100 uint32_t sense_len; /* Sense data length */ 101 uint32_t resid; /* Residual bytes in data buffer */ 102 uint16_t status_qualifier; /* Status qualifier */ 103 uint8_t status; /* Command completion status */ 104 uint8_t response; /* Response values */ 105 } QEMU_PACKED VirtIOSCSICmdResp; 106 107 /* Task Management Request */ 108 typedef struct { 109 uint32_t type; 110 uint32_t subtype; 111 uint8_t lun[8]; 112 uint64_t tag; 113 } QEMU_PACKED VirtIOSCSICtrlTMFReq; 114 115 typedef struct { 116 uint8_t response; 117 } QEMU_PACKED VirtIOSCSICtrlTMFResp; 118 119 /* Asynchronous notification query/subscription */ 120 typedef struct { 121 uint32_t type; 122 uint8_t lun[8]; 123 uint32_t event_requested; 124 } QEMU_PACKED VirtIOSCSICtrlANReq; 125 126 typedef struct { 127 uint32_t event_actual; 128 uint8_t response; 129 } QEMU_PACKED VirtIOSCSICtrlANResp; 130 131 typedef struct { 132 uint32_t event; 133 uint8_t lun[8]; 134 uint32_t reason; 135 } QEMU_PACKED VirtIOSCSIEvent; 136 137 typedef struct { 138 uint32_t num_queues; 139 uint32_t seg_max; 140 uint32_t max_sectors; 141 uint32_t cmd_per_lun; 142 uint32_t event_info_size; 143 uint32_t sense_size; 144 uint32_t cdb_size; 145 uint16_t max_channel; 146 uint16_t max_target; 147 uint32_t max_lun; 148 } QEMU_PACKED VirtIOSCSIConfig; 149 150 struct VirtIOSCSIConf { 151 uint32_t num_queues; 152 uint32_t max_sectors; 153 uint32_t cmd_per_lun; 154 char *vhostfd; 155 char *wwpn; 156 uint32_t boot_tpgt; 157 IOThread *iothread; 158 }; 159 160 struct VirtIOSCSI; 161 162 typedef struct { 163 struct VirtIOSCSI *parent; 164 Vring vring; 165 EventNotifier host_notifier; 166 EventNotifier guest_notifier; 167 } VirtIOSCSIVring; 168 169 typedef struct VirtIOSCSICommon { 170 VirtIODevice parent_obj; 171 VirtIOSCSIConf conf; 172 173 uint32_t sense_size; 174 uint32_t cdb_size; 175 VirtQueue *ctrl_vq; 176 VirtQueue *event_vq; 177 VirtQueue **cmd_vqs; 178 } VirtIOSCSICommon; 179 180 typedef struct VirtIOSCSI { 181 VirtIOSCSICommon parent_obj; 182 183 SCSIBus bus; 184 int resetting; 185 bool events_dropped; 186 187 /* Fields for dataplane below */ 188 AioContext *ctx; /* one iothread per virtio-scsi-pci for now */ 189 190 /* Vring is used instead of vq in dataplane code, because of the underlying 191 * memory layer thread safety */ 192 VirtIOSCSIVring *ctrl_vring; 193 VirtIOSCSIVring *event_vring; 194 VirtIOSCSIVring **cmd_vrings; 195 bool dataplane_started; 196 bool dataplane_starting; 197 bool dataplane_stopping; 198 bool dataplane_disabled; 199 bool dataplane_fenced; 200 Error *blocker; 201 Notifier migration_state_notifier; 202 } VirtIOSCSI; 203 204 typedef struct VirtIOSCSIReq { 205 VirtIOSCSI *dev; 206 VirtQueue *vq; 207 QEMUSGList qsgl; 208 QEMUIOVector resp_iov; 209 210 /* Note: 211 * - fields before elem are initialized by virtio_scsi_init_req; 212 * - elem is uninitialized at the time of allocation. 213 * - fields after elem (except the ending cdb[]) are zeroed by 214 * virtio_scsi_init_req. 215 * */ 216 217 VirtQueueElement elem; 218 /* Set by dataplane code. */ 219 VirtIOSCSIVring *vring; 220 221 union { 222 /* Used for two-stage request submission */ 223 QTAILQ_ENTRY(VirtIOSCSIReq) next; 224 225 /* Used for cancellation of request during TMFs */ 226 int remaining; 227 }; 228 229 SCSIRequest *sreq; 230 size_t resp_size; 231 enum SCSIXferMode mode; 232 union { 233 VirtIOSCSICmdResp cmd; 234 VirtIOSCSICtrlTMFResp tmf; 235 VirtIOSCSICtrlANResp an; 236 VirtIOSCSIEvent event; 237 } resp; 238 union { 239 struct { 240 VirtIOSCSICmdReq cmd; 241 uint8_t cdb[]; 242 } QEMU_PACKED; 243 VirtIOSCSICtrlTMFReq tmf; 244 VirtIOSCSICtrlANReq an; 245 } req; 246 } VirtIOSCSIReq; 247 248 QEMU_BUILD_BUG_ON(offsetof(VirtIOSCSIReq, req.cdb) != 249 offsetof(VirtIOSCSIReq, req.cmd) + sizeof(VirtIOSCSICmdReq)); 250 251 #define DEFINE_VIRTIO_SCSI_PROPERTIES(_state, _conf_field) \ 252 DEFINE_PROP_UINT32("num_queues", _state, _conf_field.num_queues, 1), \ 253 DEFINE_PROP_UINT32("max_sectors", _state, _conf_field.max_sectors, 0xFFFF),\ 254 DEFINE_PROP_UINT32("cmd_per_lun", _state, _conf_field.cmd_per_lun, 128) 255 256 #define DEFINE_VIRTIO_SCSI_FEATURES(_state, _feature_field) \ 257 DEFINE_PROP_BIT("any_layout", _state, _feature_field, \ 258 VIRTIO_F_ANY_LAYOUT, true), \ 259 DEFINE_PROP_BIT("hotplug", _state, _feature_field, VIRTIO_SCSI_F_HOTPLUG, \ 260 true), \ 261 DEFINE_PROP_BIT("param_change", _state, _feature_field, \ 262 VIRTIO_SCSI_F_CHANGE, true) 263 264 typedef void (*HandleOutput)(VirtIODevice *, VirtQueue *); 265 266 void virtio_scsi_common_realize(DeviceState *dev, Error **errp, 267 HandleOutput ctrl, HandleOutput evt, 268 HandleOutput cmd); 269 270 void virtio_scsi_common_unrealize(DeviceState *dev, Error **errp); 271 void virtio_scsi_handle_ctrl_req(VirtIOSCSI *s, VirtIOSCSIReq *req); 272 bool virtio_scsi_handle_cmd_req_prepare(VirtIOSCSI *s, VirtIOSCSIReq *req); 273 void virtio_scsi_handle_cmd_req_submit(VirtIOSCSI *s, VirtIOSCSIReq *req); 274 VirtIOSCSIReq *virtio_scsi_init_req(VirtIOSCSI *s, VirtQueue *vq); 275 void virtio_scsi_free_req(VirtIOSCSIReq *req); 276 void virtio_scsi_push_event(VirtIOSCSI *s, SCSIDevice *dev, 277 uint32_t event, uint32_t reason); 278 279 void virtio_scsi_set_iothread(VirtIOSCSI *s, IOThread *iothread); 280 void virtio_scsi_dataplane_start(VirtIOSCSI *s); 281 void virtio_scsi_dataplane_stop(VirtIOSCSI *s); 282 void virtio_scsi_vring_push_notify(VirtIOSCSIReq *req); 283 VirtIOSCSIReq *virtio_scsi_pop_req_vring(VirtIOSCSI *s, 284 VirtIOSCSIVring *vring); 285 286 #endif /* _QEMU_VIRTIO_SCSI_H */ 287