2 * vhost_scsi host device
4 * Copyright IBM, Corp. 2011
7 * Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
9 * Changes for QEMU mainline + tcm_vhost kernel upstream:
10 * Nicholas Bellinger <nab@risingtidesystems.com>
12 * This work is licensed under the terms of the GNU LGPL, version 2 or later.
13 * See the COPYING.LIB file in the top-level directory.
17 #include "qemu/osdep.h"
18 #include <linux/vhost.h>
19 #include <sys/ioctl.h>
20 #include "qapi/error.h"
21 #include "qemu/error-report.h"
22 #include "qemu/module.h"
23 #include "qemu/queue.h"
24 #include "monitor/monitor.h"
25 #include "migration/blocker.h"
26 #include "hw/virtio/vhost-scsi.h"
27 #include "hw/virtio/vhost.h"
28 #include "hw/virtio/virtio-scsi.h"
29 #include "hw/virtio/virtio-bus.h"
30 #include "hw/virtio/virtio-access.h"
31 #include "hw/fw-path-provider.h"
32 #include "qemu/cutils.h"
34 /* Features supported by host kernel. */
35 static const int kernel_feature_bits
[] = {
36 VIRTIO_F_NOTIFY_ON_EMPTY
,
37 VIRTIO_RING_F_INDIRECT_DESC
,
38 VIRTIO_RING_F_EVENT_IDX
,
39 VIRTIO_SCSI_F_HOTPLUG
,
40 VHOST_INVALID_FEATURE_BIT
43 static int vhost_scsi_set_endpoint(VHostSCSI
*s
)
45 VirtIOSCSICommon
*vs
= VIRTIO_SCSI_COMMON(s
);
46 VHostSCSICommon
*vsc
= VHOST_SCSI_COMMON(s
);
47 const VhostOps
*vhost_ops
= vsc
->dev
.vhost_ops
;
48 struct vhost_scsi_target backend
;
51 memset(&backend
, 0, sizeof(backend
));
52 pstrcpy(backend
.vhost_wwpn
, sizeof(backend
.vhost_wwpn
), vs
->conf
.wwpn
);
53 ret
= vhost_ops
->vhost_scsi_set_endpoint(&vsc
->dev
, &backend
);
60 static void vhost_scsi_clear_endpoint(VHostSCSI
*s
)
62 VirtIOSCSICommon
*vs
= VIRTIO_SCSI_COMMON(s
);
63 VHostSCSICommon
*vsc
= VHOST_SCSI_COMMON(s
);
64 struct vhost_scsi_target backend
;
65 const VhostOps
*vhost_ops
= vsc
->dev
.vhost_ops
;
67 memset(&backend
, 0, sizeof(backend
));
68 pstrcpy(backend
.vhost_wwpn
, sizeof(backend
.vhost_wwpn
), vs
->conf
.wwpn
);
69 vhost_ops
->vhost_scsi_clear_endpoint(&vsc
->dev
, &backend
);
72 static int vhost_scsi_start(VHostSCSI
*s
)
75 VHostSCSICommon
*vsc
= VHOST_SCSI_COMMON(s
);
76 const VhostOps
*vhost_ops
= vsc
->dev
.vhost_ops
;
78 ret
= vhost_ops
->vhost_scsi_get_abi_version(&vsc
->dev
, &abi_version
);
82 if (abi_version
> VHOST_SCSI_ABI_VERSION
) {
83 error_report("vhost-scsi: The running tcm_vhost kernel abi_version:"
84 " %d is greater than vhost_scsi userspace supports: %d,"
85 " please upgrade your version of QEMU", abi_version
,
86 VHOST_SCSI_ABI_VERSION
);
90 ret
= vhost_scsi_common_start(vsc
);
95 ret
= vhost_scsi_set_endpoint(s
);
97 error_report("Error setting vhost-scsi endpoint");
98 vhost_scsi_common_stop(vsc
);
104 static void vhost_scsi_stop(VHostSCSI
*s
)
106 VHostSCSICommon
*vsc
= VHOST_SCSI_COMMON(s
);
108 vhost_scsi_clear_endpoint(s
);
109 vhost_scsi_common_stop(vsc
);
112 static void vhost_scsi_set_status(VirtIODevice
*vdev
, uint8_t val
)
114 VHostSCSI
*s
= VHOST_SCSI(vdev
);
115 VHostSCSICommon
*vsc
= VHOST_SCSI_COMMON(s
);
116 bool start
= (val
& VIRTIO_CONFIG_S_DRIVER_OK
);
118 if (!vdev
->vm_running
) {
122 if (vsc
->dev
.started
== start
) {
129 ret
= vhost_scsi_start(s
);
131 error_report("unable to start vhost-scsi: %s", strerror(-ret
));
139 static void vhost_dummy_handle_output(VirtIODevice
*vdev
, VirtQueue
*vq
)
143 static int vhost_scsi_pre_save(void *opaque
)
145 VHostSCSICommon
*vsc
= opaque
;
147 /* At this point, backend must be stopped, otherwise
148 * it might keep writing to memory. */
149 assert(!vsc
->dev
.started
);
154 static const VMStateDescription vmstate_virtio_vhost_scsi
= {
155 .name
= "virtio-vhost_scsi",
156 .minimum_version_id
= 1,
158 .fields
= (VMStateField
[]) {
159 VMSTATE_VIRTIO_DEVICE
,
160 VMSTATE_END_OF_LIST()
162 .pre_save
= vhost_scsi_pre_save
,
165 static void vhost_scsi_realize(DeviceState
*dev
, Error
**errp
)
167 VirtIOSCSICommon
*vs
= VIRTIO_SCSI_COMMON(dev
);
168 VHostSCSICommon
*vsc
= VHOST_SCSI_COMMON(dev
);
173 if (!vs
->conf
.wwpn
) {
174 error_setg(errp
, "vhost-scsi: missing wwpn");
178 if (vs
->conf
.vhostfd
) {
179 vhostfd
= monitor_fd_param(cur_mon
, vs
->conf
.vhostfd
, errp
);
181 error_prepend(errp
, "vhost-scsi: unable to parse vhostfd: ");
185 vhostfd
= open("/dev/vhost-scsi", O_RDWR
);
187 error_setg(errp
, "vhost-scsi: open vhost char device failed: %s",
193 virtio_scsi_common_realize(dev
,
194 vhost_dummy_handle_output
,
195 vhost_dummy_handle_output
,
196 vhost_dummy_handle_output
,
199 error_propagate(errp
, err
);
203 if (!vsc
->migratable
) {
204 error_setg(&vsc
->migration_blocker
,
205 "vhost-scsi does not support migration in all cases. "
206 "When external environment supports it (Orchestrator migrates "
207 "target SCSI device state or use shared storage over network), "
208 "set 'migratable' property to true to enable migration.");
209 migrate_add_blocker(vsc
->migration_blocker
, &err
);
211 error_propagate(errp
, err
);
212 error_free(vsc
->migration_blocker
);
217 vsc
->dev
.nvqs
= VHOST_SCSI_VQ_NUM_FIXED
+ vs
->conf
.num_queues
;
218 vsc
->dev
.vqs
= g_new0(struct vhost_virtqueue
, vsc
->dev
.nvqs
);
219 vsc
->dev
.vq_index
= 0;
220 vsc
->dev
.backend_features
= 0;
222 ret
= vhost_dev_init(&vsc
->dev
, (void *)(uintptr_t)vhostfd
,
223 VHOST_BACKEND_TYPE_KERNEL
, 0);
225 error_setg(errp
, "vhost-scsi: vhost initialization failed: %s",
230 /* At present, channel and lun both are 0 for bootable vhost-scsi disk */
233 /* Note: we can also get the minimum tpgt from kernel */
234 vsc
->target
= vs
->conf
.boot_tpgt
;
239 if (!vsc
->migratable
) {
240 migrate_del_blocker(vsc
->migration_blocker
);
242 g_free(vsc
->dev
.vqs
);
248 static void vhost_scsi_unrealize(DeviceState
*dev
, Error
**errp
)
250 VirtIODevice
*vdev
= VIRTIO_DEVICE(dev
);
251 VHostSCSICommon
*vsc
= VHOST_SCSI_COMMON(dev
);
252 struct vhost_virtqueue
*vqs
= vsc
->dev
.vqs
;
254 if (!vsc
->migratable
) {
255 migrate_del_blocker(vsc
->migration_blocker
);
256 error_free(vsc
->migration_blocker
);
259 /* This will stop vhost backend. */
260 vhost_scsi_set_status(vdev
, 0);
262 vhost_dev_cleanup(&vsc
->dev
);
265 virtio_scsi_common_unrealize(dev
, errp
);
268 static Property vhost_scsi_properties
[] = {
269 DEFINE_PROP_STRING("vhostfd", VirtIOSCSICommon
, conf
.vhostfd
),
270 DEFINE_PROP_STRING("wwpn", VirtIOSCSICommon
, conf
.wwpn
),
271 DEFINE_PROP_UINT32("boot_tpgt", VirtIOSCSICommon
, conf
.boot_tpgt
, 0),
272 DEFINE_PROP_UINT32("num_queues", VirtIOSCSICommon
, conf
.num_queues
, 1),
273 DEFINE_PROP_UINT32("virtqueue_size", VirtIOSCSICommon
, conf
.virtqueue_size
,
275 DEFINE_PROP_UINT32("max_sectors", VirtIOSCSICommon
, conf
.max_sectors
,
277 DEFINE_PROP_UINT32("cmd_per_lun", VirtIOSCSICommon
, conf
.cmd_per_lun
, 128),
278 DEFINE_PROP_BIT64("t10_pi", VHostSCSICommon
, host_features
,
279 VIRTIO_SCSI_F_T10_PI
,
281 DEFINE_PROP_BOOL("migratable", VHostSCSICommon
, migratable
, false),
282 DEFINE_PROP_END_OF_LIST(),
285 static void vhost_scsi_class_init(ObjectClass
*klass
, void *data
)
287 DeviceClass
*dc
= DEVICE_CLASS(klass
);
288 VirtioDeviceClass
*vdc
= VIRTIO_DEVICE_CLASS(klass
);
289 FWPathProviderClass
*fwc
= FW_PATH_PROVIDER_CLASS(klass
);
291 dc
->props
= vhost_scsi_properties
;
292 dc
->vmsd
= &vmstate_virtio_vhost_scsi
;
293 set_bit(DEVICE_CATEGORY_STORAGE
, dc
->categories
);
294 vdc
->realize
= vhost_scsi_realize
;
295 vdc
->unrealize
= vhost_scsi_unrealize
;
296 vdc
->get_features
= vhost_scsi_common_get_features
;
297 vdc
->set_config
= vhost_scsi_common_set_config
;
298 vdc
->set_status
= vhost_scsi_set_status
;
299 fwc
->get_dev_path
= vhost_scsi_common_get_fw_dev_path
;
302 static void vhost_scsi_instance_init(Object
*obj
)
304 VHostSCSICommon
*vsc
= VHOST_SCSI_COMMON(obj
);
306 vsc
->feature_bits
= kernel_feature_bits
;
308 device_add_bootindex_property(obj
, &vsc
->bootindex
, "bootindex", NULL
,
312 static const TypeInfo vhost_scsi_info
= {
313 .name
= TYPE_VHOST_SCSI
,
314 .parent
= TYPE_VHOST_SCSI_COMMON
,
315 .instance_size
= sizeof(VHostSCSI
),
316 .class_init
= vhost_scsi_class_init
,
317 .instance_init
= vhost_scsi_instance_init
,
318 .interfaces
= (InterfaceInfo
[]) {
319 { TYPE_FW_PATH_PROVIDER
},
324 static void virtio_register_types(void)
326 type_register_static(&vhost_scsi_info
);
329 type_init(virtio_register_types
)