qapi: Improve specificity of type/member descriptions
[qemu/armbru.git] / hw / scsi / vhost-scsi.c
blob6a0fd0dfb13d60eaa0a27b1168e3b86636831829
1 /*
2 * vhost_scsi host device
4 * Copyright IBM, Corp. 2011
6 * Authors:
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 "monitor/monitor.h"
24 #include "migration/blocker.h"
25 #include "hw/virtio/vhost-scsi.h"
26 #include "hw/virtio/vhost.h"
27 #include "hw/virtio/virtio-scsi.h"
28 #include "hw/virtio/virtio-bus.h"
29 #include "hw/virtio/virtio-access.h"
30 #include "hw/fw-path-provider.h"
31 #include "hw/qdev-properties.h"
32 #include "qemu/cutils.h"
33 #include "sysemu/sysemu.h"
35 /* Features supported by host kernel. */
36 static const int kernel_feature_bits[] = {
37 VIRTIO_F_NOTIFY_ON_EMPTY,
38 VIRTIO_RING_F_INDIRECT_DESC,
39 VIRTIO_RING_F_EVENT_IDX,
40 VIRTIO_SCSI_F_HOTPLUG,
41 VIRTIO_F_RING_RESET,
42 VHOST_INVALID_FEATURE_BIT
45 static int vhost_scsi_set_endpoint(VHostSCSI *s)
47 VirtIOSCSICommon *vs = VIRTIO_SCSI_COMMON(s);
48 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(s);
49 const VhostOps *vhost_ops = vsc->dev.vhost_ops;
50 struct vhost_scsi_target backend;
51 int ret;
53 memset(&backend, 0, sizeof(backend));
54 pstrcpy(backend.vhost_wwpn, sizeof(backend.vhost_wwpn), vs->conf.wwpn);
55 ret = vhost_ops->vhost_scsi_set_endpoint(&vsc->dev, &backend);
56 if (ret < 0) {
57 return -errno;
59 return 0;
62 static void vhost_scsi_clear_endpoint(VHostSCSI *s)
64 VirtIOSCSICommon *vs = VIRTIO_SCSI_COMMON(s);
65 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(s);
66 struct vhost_scsi_target backend;
67 const VhostOps *vhost_ops = vsc->dev.vhost_ops;
69 memset(&backend, 0, sizeof(backend));
70 pstrcpy(backend.vhost_wwpn, sizeof(backend.vhost_wwpn), vs->conf.wwpn);
71 vhost_ops->vhost_scsi_clear_endpoint(&vsc->dev, &backend);
74 static int vhost_scsi_start(VHostSCSI *s)
76 int ret, abi_version;
77 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(s);
78 const VhostOps *vhost_ops = vsc->dev.vhost_ops;
80 ret = vhost_ops->vhost_scsi_get_abi_version(&vsc->dev, &abi_version);
81 if (ret < 0) {
82 return -errno;
84 if (abi_version > VHOST_SCSI_ABI_VERSION) {
85 error_report("vhost-scsi: The running tcm_vhost kernel abi_version:"
86 " %d is greater than vhost_scsi userspace supports: %d,"
87 " please upgrade your version of QEMU", abi_version,
88 VHOST_SCSI_ABI_VERSION);
89 return -ENOSYS;
92 ret = vhost_scsi_common_start(vsc);
93 if (ret < 0) {
94 return ret;
97 ret = vhost_scsi_set_endpoint(s);
98 if (ret < 0) {
99 error_report("Error setting vhost-scsi endpoint");
100 vhost_scsi_common_stop(vsc);
103 return ret;
106 static void vhost_scsi_stop(VHostSCSI *s)
108 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(s);
110 vhost_scsi_clear_endpoint(s);
111 vhost_scsi_common_stop(vsc);
114 static void vhost_scsi_set_status(VirtIODevice *vdev, uint8_t val)
116 VHostSCSI *s = VHOST_SCSI(vdev);
117 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(s);
118 bool start = (val & VIRTIO_CONFIG_S_DRIVER_OK);
120 if (!vdev->vm_running) {
121 start = false;
124 if (vhost_dev_is_started(&vsc->dev) == start) {
125 return;
128 if (start) {
129 int ret;
131 ret = vhost_scsi_start(s);
132 if (ret < 0) {
133 error_report("unable to start vhost-scsi: %s", strerror(-ret));
134 exit(1);
136 } else {
137 vhost_scsi_stop(s);
141 static void vhost_dummy_handle_output(VirtIODevice *vdev, VirtQueue *vq)
145 static int vhost_scsi_pre_save(void *opaque)
147 VHostSCSICommon *vsc = opaque;
149 /* At this point, backend must be stopped, otherwise
150 * it might keep writing to memory. */
151 assert(!vhost_dev_is_started(&vsc->dev));
153 return 0;
156 static const VMStateDescription vmstate_virtio_vhost_scsi = {
157 .name = "virtio-vhost_scsi",
158 .minimum_version_id = 1,
159 .version_id = 1,
160 .fields = (VMStateField[]) {
161 VMSTATE_VIRTIO_DEVICE,
162 VMSTATE_END_OF_LIST()
164 .pre_save = vhost_scsi_pre_save,
167 static void vhost_scsi_realize(DeviceState *dev, Error **errp)
169 VirtIOSCSICommon *vs = VIRTIO_SCSI_COMMON(dev);
170 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(dev);
171 Error *err = NULL;
172 int vhostfd = -1;
173 int ret;
174 struct vhost_virtqueue *vqs = NULL;
176 if (!vs->conf.wwpn) {
177 error_setg(errp, "vhost-scsi: missing wwpn");
178 return;
181 if (vs->conf.vhostfd) {
182 vhostfd = monitor_fd_param(monitor_cur(), vs->conf.vhostfd, errp);
183 if (vhostfd == -1) {
184 error_prepend(errp, "vhost-scsi: unable to parse vhostfd: ");
185 return;
187 } else {
188 vhostfd = open("/dev/vhost-scsi", O_RDWR);
189 if (vhostfd < 0) {
190 error_setg(errp, "vhost-scsi: open vhost char device failed: %s",
191 strerror(errno));
192 return;
196 virtio_scsi_common_realize(dev,
197 vhost_dummy_handle_output,
198 vhost_dummy_handle_output,
199 vhost_dummy_handle_output,
200 &err);
201 if (err != NULL) {
202 error_propagate(errp, err);
203 goto close_fd;
206 if (!vsc->migratable) {
207 error_setg(&vsc->migration_blocker,
208 "vhost-scsi does not support migration in all cases. "
209 "When external environment supports it (Orchestrator migrates "
210 "target SCSI device state or use shared storage over network), "
211 "set 'migratable' property to true to enable migration.");
212 if (migrate_add_blocker(vsc->migration_blocker, errp) < 0) {
213 goto free_virtio;
217 vsc->dev.nvqs = VHOST_SCSI_VQ_NUM_FIXED + vs->conf.num_queues;
218 vqs = g_new0(struct vhost_virtqueue, vsc->dev.nvqs);
219 vsc->dev.vqs = vqs;
220 vsc->dev.vq_index = 0;
221 vsc->dev.backend_features = 0;
223 ret = vhost_dev_init(&vsc->dev, (void *)(uintptr_t)vhostfd,
224 VHOST_BACKEND_TYPE_KERNEL, 0, errp);
225 if (ret < 0) {
227 * vhost_dev_init calls vhost_dev_cleanup on error, which closes
228 * vhostfd, don't double close it.
230 vhostfd = -1;
231 goto free_vqs;
234 /* At present, channel and lun both are 0 for bootable vhost-scsi disk */
235 vsc->channel = 0;
236 vsc->lun = 0;
237 /* Note: we can also get the minimum tpgt from kernel */
238 vsc->target = vs->conf.boot_tpgt;
240 return;
242 free_vqs:
243 g_free(vqs);
244 if (!vsc->migratable) {
245 migrate_del_blocker(vsc->migration_blocker);
247 free_virtio:
248 error_free(vsc->migration_blocker);
249 virtio_scsi_common_unrealize(dev);
250 close_fd:
251 if (vhostfd >= 0) {
252 close(vhostfd);
254 return;
257 static void vhost_scsi_unrealize(DeviceState *dev)
259 VirtIODevice *vdev = VIRTIO_DEVICE(dev);
260 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(dev);
261 struct vhost_virtqueue *vqs = vsc->dev.vqs;
263 if (!vsc->migratable) {
264 migrate_del_blocker(vsc->migration_blocker);
265 error_free(vsc->migration_blocker);
268 /* This will stop vhost backend. */
269 vhost_scsi_set_status(vdev, 0);
271 vhost_dev_cleanup(&vsc->dev);
272 g_free(vqs);
274 virtio_scsi_common_unrealize(dev);
277 static struct vhost_dev *vhost_scsi_get_vhost(VirtIODevice *vdev)
279 VHostSCSI *s = VHOST_SCSI(vdev);
280 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(s);
281 return &vsc->dev;
284 static Property vhost_scsi_properties[] = {
285 DEFINE_PROP_STRING("vhostfd", VirtIOSCSICommon, conf.vhostfd),
286 DEFINE_PROP_STRING("wwpn", VirtIOSCSICommon, conf.wwpn),
287 DEFINE_PROP_UINT32("boot_tpgt", VirtIOSCSICommon, conf.boot_tpgt, 0),
288 DEFINE_PROP_UINT32("num_queues", VirtIOSCSICommon, conf.num_queues,
289 VIRTIO_SCSI_AUTO_NUM_QUEUES),
290 DEFINE_PROP_UINT32("virtqueue_size", VirtIOSCSICommon, conf.virtqueue_size,
291 128),
292 DEFINE_PROP_BOOL("seg_max_adjust", VirtIOSCSICommon, conf.seg_max_adjust,
293 true),
294 DEFINE_PROP_UINT32("max_sectors", VirtIOSCSICommon, conf.max_sectors,
295 0xFFFF),
296 DEFINE_PROP_UINT32("cmd_per_lun", VirtIOSCSICommon, conf.cmd_per_lun, 128),
297 DEFINE_PROP_BIT64("t10_pi", VHostSCSICommon, host_features,
298 VIRTIO_SCSI_F_T10_PI,
299 false),
300 DEFINE_PROP_BOOL("migratable", VHostSCSICommon, migratable, false),
301 DEFINE_PROP_END_OF_LIST(),
304 static void vhost_scsi_class_init(ObjectClass *klass, void *data)
306 DeviceClass *dc = DEVICE_CLASS(klass);
307 VirtioDeviceClass *vdc = VIRTIO_DEVICE_CLASS(klass);
308 FWPathProviderClass *fwc = FW_PATH_PROVIDER_CLASS(klass);
310 device_class_set_props(dc, vhost_scsi_properties);
311 dc->vmsd = &vmstate_virtio_vhost_scsi;
312 set_bit(DEVICE_CATEGORY_STORAGE, dc->categories);
313 vdc->realize = vhost_scsi_realize;
314 vdc->unrealize = vhost_scsi_unrealize;
315 vdc->get_features = vhost_scsi_common_get_features;
316 vdc->set_config = vhost_scsi_common_set_config;
317 vdc->set_status = vhost_scsi_set_status;
318 vdc->get_vhost = vhost_scsi_get_vhost;
319 fwc->get_dev_path = vhost_scsi_common_get_fw_dev_path;
322 static void vhost_scsi_instance_init(Object *obj)
324 VHostSCSICommon *vsc = VHOST_SCSI_COMMON(obj);
326 vsc->feature_bits = kernel_feature_bits;
328 device_add_bootindex_property(obj, &vsc->bootindex, "bootindex", NULL,
329 DEVICE(vsc));
332 static const TypeInfo vhost_scsi_info = {
333 .name = TYPE_VHOST_SCSI,
334 .parent = TYPE_VHOST_SCSI_COMMON,
335 .instance_size = sizeof(VHostSCSI),
336 .class_init = vhost_scsi_class_init,
337 .instance_init = vhost_scsi_instance_init,
338 .interfaces = (InterfaceInfo[]) {
339 { TYPE_FW_PATH_PROVIDER },
344 static void virtio_register_types(void)
346 type_register_static(&vhost_scsi_info);
349 type_init(virtio_register_types)