include/hw/virtio/virtio-scsi.h

   1 /*
   2  * Virtio SCSI HBA
   3  *
   4  * Copyright IBM, Corp. 2010
   5  *
   6  * Authors:
   7  *  Stefan Hajnoczi    <[email protected]>
   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 /* Override CDB/sense data size: they are dynamic (guest controlled) in QEMU */
  18 #define VIRTIO_SCSI_CDB_SIZE 0
  19 #define VIRTIO_SCSI_SENSE_SIZE 0
  20 #include "standard-headers/linux/virtio_scsi.h"
  21 #include "hw/virtio/virtio.h"
  22 #include "hw/pci/pci.h"
  23 #include "hw/scsi/scsi.h"
  24 #include "sysemu/iothread.h"
  25 #include "hw/virtio/dataplane/vring.h"
  26
  27 #define TYPE_VIRTIO_SCSI_COMMON "virtio-scsi-common"
  28 #define VIRTIO_SCSI_COMMON(obj) \
  29         OBJECT_CHECK(VirtIOSCSICommon, (obj), TYPE_VIRTIO_SCSI_COMMON)
  30
  31 #define TYPE_VIRTIO_SCSI "virtio-scsi-device"
  32 #define VIRTIO_SCSI(obj) \
  33         OBJECT_CHECK(VirtIOSCSI, (obj), TYPE_VIRTIO_SCSI)
  34
  35 #define VIRTIO_SCSI_VQ_SIZE     128
  36 #define VIRTIO_SCSI_MAX_CHANNEL 0
  37 #define VIRTIO_SCSI_MAX_TARGET  255
  38 #define VIRTIO_SCSI_MAX_LUN     16383
  39
  40 typedef struct virtio_scsi_cmd_req VirtIOSCSICmdReq;
  41 typedef struct virtio_scsi_cmd_resp VirtIOSCSICmdResp;
  42 typedef struct virtio_scsi_ctrl_tmf_req VirtIOSCSICtrlTMFReq;
  43 typedef struct virtio_scsi_ctrl_tmf_resp VirtIOSCSICtrlTMFResp;
  44 typedef struct virtio_scsi_ctrl_an_req VirtIOSCSICtrlANReq;
  45 typedef struct virtio_scsi_ctrl_an_resp VirtIOSCSICtrlANResp;
  46 typedef struct virtio_scsi_event VirtIOSCSIEvent;
  47 typedef struct virtio_scsi_config VirtIOSCSIConfig;
  48
  49 struct VirtIOSCSIConf {
  50     uint32_t num_queues;
  51     uint32_t max_sectors;
  52     uint32_t cmd_per_lun;
  53     char *vhostfd;
  54     char *wwpn;
  55     uint32_t boot_tpgt;
  56     IOThread *iothread;
  57 };
  58
  59 struct VirtIOSCSI;
  60
  61 typedef struct {
  62     struct VirtIOSCSI *parent;
  63     Vring vring;
  64     EventNotifier host_notifier;
  65     EventNotifier guest_notifier;
  66 } VirtIOSCSIVring;
  67
  68 typedef struct VirtIOSCSICommon {
  69     VirtIODevice parent_obj;
  70     VirtIOSCSIConf conf;
  71
  72     uint32_t sense_size;
  73     uint32_t cdb_size;
  74     VirtQueue *ctrl_vq;
  75     VirtQueue *event_vq;
  76     VirtQueue **cmd_vqs;
  77 } VirtIOSCSICommon;
  78
  79 typedef struct VirtIOSCSI {
  80     VirtIOSCSICommon parent_obj;
  81
  82     SCSIBus bus;
  83     int resetting;
  84     bool events_dropped;
  85
  86     /* Fields for dataplane below */
  87     AioContext *ctx; /* one iothread per virtio-scsi-pci for now */
  88
  89     /* Vring is used instead of vq in dataplane code, because of the underlying
  90      * memory layer thread safety */
  91     VirtIOSCSIVring *ctrl_vring;
  92     VirtIOSCSIVring *event_vring;
  93     VirtIOSCSIVring **cmd_vrings;
  94     bool dataplane_started;
  95     bool dataplane_starting;
  96     bool dataplane_stopping;
  97     bool dataplane_disabled;
  98     bool dataplane_fenced;
  99     Error *blocker;
 100     Notifier migration_state_notifier;
 101     uint32_t host_features;
 102 } VirtIOSCSI;
 103
 104 typedef struct VirtIOSCSIReq {
 105     VirtIOSCSI *dev;
 106     VirtQueue *vq;
 107     QEMUSGList qsgl;
 108     QEMUIOVector resp_iov;
 109
 110     /* Note:
 111      * - fields before elem are initialized by virtio_scsi_init_req;
 112      * - elem is uninitialized at the time of allocation.
 113      * - fields after elem are zeroed by virtio_scsi_init_req.
 114      * */
 115
 116     VirtQueueElement elem;
 117     /* Set by dataplane code. */
 118     VirtIOSCSIVring *vring;
 119
 120     union {
 121         /* Used for two-stage request submission */
 122         QTAILQ_ENTRY(VirtIOSCSIReq) next;
 123
 124         /* Used for cancellation of request during TMFs */
 125         int remaining;
 126     };
 127
 128     SCSIRequest *sreq;
 129     size_t resp_size;
 130     enum SCSIXferMode mode;
 131     union {
 132         VirtIOSCSICmdResp     cmd;
 133         VirtIOSCSICtrlTMFResp tmf;
 134         VirtIOSCSICtrlANResp  an;
 135         VirtIOSCSIEvent       event;
 136     } resp;
 137     union {
 138         VirtIOSCSICmdReq      cmd;
 139         VirtIOSCSICtrlTMFReq  tmf;
 140         VirtIOSCSICtrlANReq   an;
 141     } req;
 142 } VirtIOSCSIReq;
 143
 144 #define DEFINE_VIRTIO_SCSI_PROPERTIES(_state, _conf_field)                     \
 145     DEFINE_PROP_UINT32("num_queues", _state, _conf_field.num_queues, 1),       \
 146     DEFINE_PROP_UINT32("max_sectors", _state, _conf_field.max_sectors, 0xFFFF),\
 147     DEFINE_PROP_UINT32("cmd_per_lun", _state, _conf_field.cmd_per_lun, 128)
 148
 149 #define DEFINE_VIRTIO_SCSI_FEATURES(_state, _feature_field)                    \
 150     DEFINE_PROP_BIT("any_layout", _state, _feature_field,                      \
 151                     VIRTIO_F_ANY_LAYOUT, true),                                \
 152     DEFINE_PROP_BIT("hotplug", _state, _feature_field, VIRTIO_SCSI_F_HOTPLUG,  \
 153                                                        true),                  \
 154     DEFINE_PROP_BIT("param_change", _state, _feature_field,                    \
 155                                             VIRTIO_SCSI_F_CHANGE, true)
 156
 157 typedef void (*HandleOutput)(VirtIODevice *, VirtQueue *);
 158
 159 void virtio_scsi_common_realize(DeviceState *dev, Error **errp,
 160                                 HandleOutput ctrl, HandleOutput evt,
 161                                 HandleOutput cmd);
 162
 163 void virtio_scsi_common_unrealize(DeviceState *dev, Error **errp);
 164 void virtio_scsi_handle_ctrl_req(VirtIOSCSI *s, VirtIOSCSIReq *req);
 165 bool virtio_scsi_handle_cmd_req_prepare(VirtIOSCSI *s, VirtIOSCSIReq *req);
 166 void virtio_scsi_handle_cmd_req_submit(VirtIOSCSI *s, VirtIOSCSIReq *req);
 167 VirtIOSCSIReq *virtio_scsi_init_req(VirtIOSCSI *s, VirtQueue *vq);
 168 void virtio_scsi_free_req(VirtIOSCSIReq *req);
 169 void virtio_scsi_push_event(VirtIOSCSI *s, SCSIDevice *dev,
 170                             uint32_t event, uint32_t reason);
 171
 172 void virtio_scsi_set_iothread(VirtIOSCSI *s, IOThread *iothread);
 173 void virtio_scsi_dataplane_start(VirtIOSCSI *s);
 174 void virtio_scsi_dataplane_stop(VirtIOSCSI *s);
 175 void virtio_scsi_vring_push_notify(VirtIOSCSIReq *req);
 176 VirtIOSCSIReq *virtio_scsi_pop_req_vring(VirtIOSCSI *s,
 177                                          VirtIOSCSIVring *vring);
 178
 179 #endif /* _QEMU_VIRTIO_SCSI_H */