xref: /qemu/include/hw/virtio/virtio-scsi.h (revision da34e65c)
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 /* 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 
26 #define TYPE_VIRTIO_SCSI_COMMON "virtio-scsi-common"
27 #define VIRTIO_SCSI_COMMON(obj) \
28         OBJECT_CHECK(VirtIOSCSICommon, (obj), TYPE_VIRTIO_SCSI_COMMON)
29 
30 #define TYPE_VIRTIO_SCSI "virtio-scsi-device"
31 #define VIRTIO_SCSI(obj) \
32         OBJECT_CHECK(VirtIOSCSI, (obj), TYPE_VIRTIO_SCSI)
33 
34 #define VIRTIO_SCSI_VQ_SIZE     128
35 #define VIRTIO_SCSI_MAX_CHANNEL 0
36 #define VIRTIO_SCSI_MAX_TARGET  255
37 #define VIRTIO_SCSI_MAX_LUN     16383
38 
39 typedef struct virtio_scsi_cmd_req VirtIOSCSICmdReq;
40 typedef struct virtio_scsi_cmd_resp VirtIOSCSICmdResp;
41 typedef struct virtio_scsi_ctrl_tmf_req VirtIOSCSICtrlTMFReq;
42 typedef struct virtio_scsi_ctrl_tmf_resp VirtIOSCSICtrlTMFResp;
43 typedef struct virtio_scsi_ctrl_an_req VirtIOSCSICtrlANReq;
44 typedef struct virtio_scsi_ctrl_an_resp VirtIOSCSICtrlANResp;
45 typedef struct virtio_scsi_event VirtIOSCSIEvent;
46 typedef struct virtio_scsi_config VirtIOSCSIConfig;
47 
48 struct VirtIOSCSIConf {
49     uint32_t num_queues;
50     uint32_t max_sectors;
51     uint32_t cmd_per_lun;
52     char *vhostfd;
53     char *wwpn;
54     uint32_t boot_tpgt;
55     IOThread *iothread;
56 };
57 
58 struct VirtIOSCSI;
59 
60 typedef struct VirtIOSCSICommon {
61     VirtIODevice parent_obj;
62     VirtIOSCSIConf conf;
63 
64     uint32_t sense_size;
65     uint32_t cdb_size;
66     VirtQueue *ctrl_vq;
67     VirtQueue *event_vq;
68     VirtQueue **cmd_vqs;
69 } VirtIOSCSICommon;
70 
71 typedef struct VirtIOSCSIBlkChangeNotifier {
72     Notifier n;
73     struct VirtIOSCSI *s;
74     SCSIDevice *sd;
75     QTAILQ_ENTRY(VirtIOSCSIBlkChangeNotifier) next;
76 } VirtIOSCSIBlkChangeNotifier;
77 
78 typedef struct VirtIOSCSI {
79     VirtIOSCSICommon parent_obj;
80 
81     SCSIBus bus;
82     int resetting;
83     bool events_dropped;
84 
85     /* Fields for dataplane below */
86     AioContext *ctx; /* one iothread per virtio-scsi-pci for now */
87 
88     QTAILQ_HEAD(, VirtIOSCSIBlkChangeNotifier) insert_notifiers;
89     QTAILQ_HEAD(, VirtIOSCSIBlkChangeNotifier) remove_notifiers;
90 
91     bool dataplane_started;
92     bool dataplane_starting;
93     bool dataplane_stopping;
94     bool dataplane_disabled;
95     bool dataplane_fenced;
96     Error *blocker;
97     uint32_t host_features;
98 } VirtIOSCSI;
99 
100 typedef struct VirtIOSCSIReq {
101     /* Note:
102      * - fields up to resp_iov are initialized by virtio_scsi_init_req;
103      * - fields starting at vring are zeroed by virtio_scsi_init_req.
104      * */
105     VirtQueueElement elem;
106 
107     VirtIOSCSI *dev;
108     VirtQueue *vq;
109     QEMUSGList qsgl;
110     QEMUIOVector resp_iov;
111 
112     union {
113         /* Used for two-stage request submission */
114         QTAILQ_ENTRY(VirtIOSCSIReq) next;
115 
116         /* Used for cancellation of request during TMFs */
117         int remaining;
118     };
119 
120     SCSIRequest *sreq;
121     size_t resp_size;
122     enum SCSIXferMode mode;
123     union {
124         VirtIOSCSICmdResp     cmd;
125         VirtIOSCSICtrlTMFResp tmf;
126         VirtIOSCSICtrlANResp  an;
127         VirtIOSCSIEvent       event;
128     } resp;
129     union {
130         VirtIOSCSICmdReq      cmd;
131         VirtIOSCSICtrlTMFReq  tmf;
132         VirtIOSCSICtrlANReq   an;
133     } req;
134 } VirtIOSCSIReq;
135 
136 typedef void (*HandleOutput)(VirtIODevice *, VirtQueue *);
137 
138 void virtio_scsi_common_realize(DeviceState *dev, Error **errp,
139                                 HandleOutput ctrl, HandleOutput evt,
140                                 HandleOutput cmd);
141 
142 void virtio_scsi_common_unrealize(DeviceState *dev, Error **errp);
143 void virtio_scsi_handle_ctrl_req(VirtIOSCSI *s, VirtIOSCSIReq *req);
144 bool virtio_scsi_handle_cmd_req_prepare(VirtIOSCSI *s, VirtIOSCSIReq *req);
145 void virtio_scsi_handle_cmd_req_submit(VirtIOSCSI *s, VirtIOSCSIReq *req);
146 void virtio_scsi_init_req(VirtIOSCSI *s, VirtQueue *vq, VirtIOSCSIReq *req);
147 void virtio_scsi_free_req(VirtIOSCSIReq *req);
148 void virtio_scsi_push_event(VirtIOSCSI *s, SCSIDevice *dev,
149                             uint32_t event, uint32_t reason);
150 
151 void virtio_scsi_set_iothread(VirtIOSCSI *s, IOThread *iothread);
152 void virtio_scsi_dataplane_start(VirtIOSCSI *s);
153 void virtio_scsi_dataplane_stop(VirtIOSCSI *s);
154 void virtio_scsi_dataplane_notify(VirtIODevice *vdev, VirtIOSCSIReq *req);
155 
156 #endif /* _QEMU_VIRTIO_SCSI_H */
157