2 * vfio based subchannel assignment support
4 * Copyright 2017 IBM Corp.
5 * Copyright 2019 Red Hat, Inc.
7 * Author(s): Dong Jia Shi <bjsdjshi@linux.vnet.ibm.com>
8 * Xiao Feng Ren <renxiaof@linux.vnet.ibm.com>
9 * Pierre Morel <pmorel@linux.vnet.ibm.com>
10 * Cornelia Huck <cohuck@redhat.com>
12 * This work is licensed under the terms of the GNU GPL, version 2 or (at
13 * your option) any later version. See the COPYING file in the top-level
17 #include "qemu/osdep.h"
18 #include <linux/vfio.h>
19 #include <linux/vfio_ccw.h>
20 #include <sys/ioctl.h>
22 #include "qapi/error.h"
23 #include "hw/sysbus.h"
24 #include "hw/vfio/vfio.h"
25 #include "hw/vfio/vfio-common.h"
26 #include "hw/s390x/s390-ccw.h"
27 #include "hw/s390x/vfio-ccw.h"
28 #include "hw/qdev-properties.h"
29 #include "hw/s390x/ccw-device.h"
30 #include "exec/address-spaces.h"
31 #include "qemu/error-report.h"
32 #include "qemu/main-loop.h"
33 #include "qemu/module.h"
35 struct VFIOCCWDevice
{
38 uint64_t io_region_size
;
39 uint64_t io_region_offset
;
40 struct ccw_io_region
*io_region
;
41 uint64_t async_cmd_region_size
;
42 uint64_t async_cmd_region_offset
;
43 struct ccw_cmd_region
*async_cmd_region
;
44 EventNotifier io_notifier
;
49 static inline void warn_once_pfch(VFIOCCWDevice
*vcdev
, SubchDev
*sch
,
52 warn_report_once_cond(&vcdev
->warned_orb_pfch
,
53 "vfio-ccw (devno %x.%x.%04x): %s",
54 sch
->cssid
, sch
->ssid
, sch
->devno
, msg
);
57 static void vfio_ccw_compute_needs_reset(VFIODevice
*vdev
)
59 vdev
->needs_reset
= false;
63 * We don't need vfio_hot_reset_multi and vfio_eoi operations for
64 * vfio_ccw device now.
66 struct VFIODeviceOps vfio_ccw_ops
= {
67 .vfio_compute_needs_reset
= vfio_ccw_compute_needs_reset
,
70 static IOInstEnding
vfio_ccw_handle_request(SubchDev
*sch
)
72 S390CCWDevice
*cdev
= sch
->driver_data
;
73 VFIOCCWDevice
*vcdev
= DO_UPCAST(VFIOCCWDevice
, cdev
, cdev
);
74 struct ccw_io_region
*region
= vcdev
->io_region
;
77 if (!(sch
->orb
.ctrl0
& ORB_CTRL0_MASK_PFCH
)) {
78 if (!(vcdev
->force_orb_pfch
)) {
79 warn_once_pfch(vcdev
, sch
, "requires PFCH flag set");
80 sch_gen_unit_exception(sch
);
81 css_inject_io_interrupt(sch
);
82 return IOINST_CC_EXPECTED
;
84 sch
->orb
.ctrl0
|= ORB_CTRL0_MASK_PFCH
;
85 warn_once_pfch(vcdev
, sch
, "PFCH flag forced");
89 QEMU_BUILD_BUG_ON(sizeof(region
->orb_area
) != sizeof(ORB
));
90 QEMU_BUILD_BUG_ON(sizeof(region
->scsw_area
) != sizeof(SCSW
));
91 QEMU_BUILD_BUG_ON(sizeof(region
->irb_area
) != sizeof(IRB
));
93 memset(region
, 0, sizeof(*region
));
95 memcpy(region
->orb_area
, &sch
->orb
, sizeof(ORB
));
96 memcpy(region
->scsw_area
, &sch
->curr_status
.scsw
, sizeof(SCSW
));
99 ret
= pwrite(vcdev
->vdev
.fd
, region
,
100 vcdev
->io_region_size
, vcdev
->io_region_offset
);
101 if (ret
!= vcdev
->io_region_size
) {
102 if (errno
== EAGAIN
) {
105 error_report("vfio-ccw: write I/O region failed with errno=%d", errno
);
108 ret
= region
->ret_code
;
112 return IOINST_CC_EXPECTED
;
114 return IOINST_CC_BUSY
;
117 return IOINST_CC_NOT_OPERATIONAL
;
120 sch_gen_unit_exception(sch
);
121 css_inject_io_interrupt(sch
);
122 return IOINST_CC_EXPECTED
;
126 static int vfio_ccw_handle_clear(SubchDev
*sch
)
128 S390CCWDevice
*cdev
= sch
->driver_data
;
129 VFIOCCWDevice
*vcdev
= DO_UPCAST(VFIOCCWDevice
, cdev
, cdev
);
130 struct ccw_cmd_region
*region
= vcdev
->async_cmd_region
;
133 if (!vcdev
->async_cmd_region
) {
134 /* Async command region not available, fall back to emulation */
138 memset(region
, 0, sizeof(*region
));
139 region
->command
= VFIO_CCW_ASYNC_CMD_CSCH
;
142 ret
= pwrite(vcdev
->vdev
.fd
, region
,
143 vcdev
->async_cmd_region_size
, vcdev
->async_cmd_region_offset
);
144 if (ret
!= vcdev
->async_cmd_region_size
) {
145 if (errno
== EAGAIN
) {
148 error_report("vfio-ccw: write cmd region failed with errno=%d", errno
);
151 ret
= region
->ret_code
;
160 sch_gen_unit_exception(sch
);
161 css_inject_io_interrupt(sch
);
166 static int vfio_ccw_handle_halt(SubchDev
*sch
)
168 S390CCWDevice
*cdev
= sch
->driver_data
;
169 VFIOCCWDevice
*vcdev
= DO_UPCAST(VFIOCCWDevice
, cdev
, cdev
);
170 struct ccw_cmd_region
*region
= vcdev
->async_cmd_region
;
173 if (!vcdev
->async_cmd_region
) {
174 /* Async command region not available, fall back to emulation */
178 memset(region
, 0, sizeof(*region
));
179 region
->command
= VFIO_CCW_ASYNC_CMD_HSCH
;
182 ret
= pwrite(vcdev
->vdev
.fd
, region
,
183 vcdev
->async_cmd_region_size
, vcdev
->async_cmd_region_offset
);
184 if (ret
!= vcdev
->async_cmd_region_size
) {
185 if (errno
== EAGAIN
) {
188 error_report("vfio-ccw: write cmd region failed with errno=%d", errno
);
191 ret
= region
->ret_code
;
201 sch_gen_unit_exception(sch
);
202 css_inject_io_interrupt(sch
);
207 static void vfio_ccw_reset(DeviceState
*dev
)
209 CcwDevice
*ccw_dev
= DO_UPCAST(CcwDevice
, parent_obj
, dev
);
210 S390CCWDevice
*cdev
= DO_UPCAST(S390CCWDevice
, parent_obj
, ccw_dev
);
211 VFIOCCWDevice
*vcdev
= DO_UPCAST(VFIOCCWDevice
, cdev
, cdev
);
213 ioctl(vcdev
->vdev
.fd
, VFIO_DEVICE_RESET
);
216 static void vfio_ccw_io_notifier_handler(void *opaque
)
218 VFIOCCWDevice
*vcdev
= opaque
;
219 struct ccw_io_region
*region
= vcdev
->io_region
;
220 S390CCWDevice
*cdev
= S390_CCW_DEVICE(vcdev
);
221 CcwDevice
*ccw_dev
= CCW_DEVICE(cdev
);
222 SubchDev
*sch
= ccw_dev
->sch
;
223 SCHIB
*schib
= &sch
->curr_status
;
228 if (!event_notifier_test_and_clear(&vcdev
->io_notifier
)) {
232 size
= pread(vcdev
->vdev
.fd
, region
, vcdev
->io_region_size
,
233 vcdev
->io_region_offset
);
237 /* Generate a deferred cc 3 condition. */
238 schib
->scsw
.flags
|= SCSW_FLAGS_MASK_CC
;
239 schib
->scsw
.ctrl
&= ~SCSW_CTRL_MASK_STCTL
;
240 schib
->scsw
.ctrl
|= (SCSW_STCTL_ALERT
| SCSW_STCTL_STATUS_PEND
);
243 /* Memory problem, generate channel data check. */
244 schib
->scsw
.ctrl
&= ~SCSW_ACTL_START_PEND
;
245 schib
->scsw
.cstat
= SCSW_CSTAT_DATA_CHECK
;
246 schib
->scsw
.ctrl
&= ~SCSW_CTRL_MASK_STCTL
;
247 schib
->scsw
.ctrl
|= SCSW_STCTL_PRIMARY
| SCSW_STCTL_SECONDARY
|
248 SCSW_STCTL_ALERT
| SCSW_STCTL_STATUS_PEND
;
251 /* Error, generate channel program check. */
252 schib
->scsw
.ctrl
&= ~SCSW_ACTL_START_PEND
;
253 schib
->scsw
.cstat
= SCSW_CSTAT_PROG_CHECK
;
254 schib
->scsw
.ctrl
&= ~SCSW_CTRL_MASK_STCTL
;
255 schib
->scsw
.ctrl
|= SCSW_STCTL_PRIMARY
| SCSW_STCTL_SECONDARY
|
256 SCSW_STCTL_ALERT
| SCSW_STCTL_STATUS_PEND
;
259 } else if (size
!= vcdev
->io_region_size
) {
260 /* Information transfer error, generate channel-control check. */
261 schib
->scsw
.ctrl
&= ~SCSW_ACTL_START_PEND
;
262 schib
->scsw
.cstat
= SCSW_CSTAT_CHN_CTRL_CHK
;
263 schib
->scsw
.ctrl
&= ~SCSW_CTRL_MASK_STCTL
;
264 schib
->scsw
.ctrl
|= SCSW_STCTL_PRIMARY
| SCSW_STCTL_SECONDARY
|
265 SCSW_STCTL_ALERT
| SCSW_STCTL_STATUS_PEND
;
269 memcpy(&irb
, region
->irb_area
, sizeof(IRB
));
271 /* Update control block via irb. */
273 copy_scsw_to_guest(&s
, &irb
.scsw
);
276 /* If a uint check is pending, copy sense data. */
277 if ((schib
->scsw
.dstat
& SCSW_DSTAT_UNIT_CHECK
) &&
278 (schib
->pmcw
.chars
& PMCW_CHARS_MASK_CSENSE
)) {
279 memcpy(sch
->sense_data
, irb
.ecw
, sizeof(irb
.ecw
));
283 css_inject_io_interrupt(sch
);
286 static void vfio_ccw_register_io_notifier(VFIOCCWDevice
*vcdev
, Error
**errp
)
288 VFIODevice
*vdev
= &vcdev
->vdev
;
289 struct vfio_irq_info
*irq_info
;
293 if (vdev
->num_irqs
< VFIO_CCW_IO_IRQ_INDEX
+ 1) {
294 error_setg(errp
, "vfio: unexpected number of io irqs %u",
299 argsz
= sizeof(*irq_info
);
300 irq_info
= g_malloc0(argsz
);
301 irq_info
->index
= VFIO_CCW_IO_IRQ_INDEX
;
302 irq_info
->argsz
= argsz
;
303 if (ioctl(vdev
->fd
, VFIO_DEVICE_GET_IRQ_INFO
,
304 irq_info
) < 0 || irq_info
->count
< 1) {
305 error_setg_errno(errp
, errno
, "vfio: Error getting irq info");
309 if (event_notifier_init(&vcdev
->io_notifier
, 0)) {
310 error_setg_errno(errp
, errno
,
311 "vfio: Unable to init event notifier for IO");
315 fd
= event_notifier_get_fd(&vcdev
->io_notifier
);
316 qemu_set_fd_handler(fd
, vfio_ccw_io_notifier_handler
, NULL
, vcdev
);
318 if (vfio_set_irq_signaling(vdev
, VFIO_CCW_IO_IRQ_INDEX
, 0,
319 VFIO_IRQ_SET_ACTION_TRIGGER
, fd
, errp
)) {
320 qemu_set_fd_handler(fd
, NULL
, NULL
, vcdev
);
321 event_notifier_cleanup(&vcdev
->io_notifier
);
328 static void vfio_ccw_unregister_io_notifier(VFIOCCWDevice
*vcdev
)
332 if (vfio_set_irq_signaling(&vcdev
->vdev
, VFIO_CCW_IO_IRQ_INDEX
, 0,
333 VFIO_IRQ_SET_ACTION_TRIGGER
, -1, &err
)) {
334 error_reportf_err(err
, VFIO_MSG_PREFIX
, vcdev
->vdev
.name
);
337 qemu_set_fd_handler(event_notifier_get_fd(&vcdev
->io_notifier
),
339 event_notifier_cleanup(&vcdev
->io_notifier
);
342 static void vfio_ccw_get_region(VFIOCCWDevice
*vcdev
, Error
**errp
)
344 VFIODevice
*vdev
= &vcdev
->vdev
;
345 struct vfio_region_info
*info
;
348 /* Sanity check device */
349 if (!(vdev
->flags
& VFIO_DEVICE_FLAGS_CCW
)) {
350 error_setg(errp
, "vfio: Um, this isn't a vfio-ccw device");
355 * We always expect at least the I/O region to be present. We also
356 * may have a variable number of regions governed by capabilities.
358 if (vdev
->num_regions
< VFIO_CCW_CONFIG_REGION_INDEX
+ 1) {
359 error_setg(errp
, "vfio: too few regions (%u), expected at least %u",
360 vdev
->num_regions
, VFIO_CCW_CONFIG_REGION_INDEX
+ 1);
364 ret
= vfio_get_region_info(vdev
, VFIO_CCW_CONFIG_REGION_INDEX
, &info
);
366 error_setg_errno(errp
, -ret
, "vfio: Error getting config info");
370 vcdev
->io_region_size
= info
->size
;
371 if (sizeof(*vcdev
->io_region
) != vcdev
->io_region_size
) {
372 error_setg(errp
, "vfio: Unexpected size of the I/O region");
377 vcdev
->io_region_offset
= info
->offset
;
378 vcdev
->io_region
= g_malloc0(info
->size
);
380 /* check for the optional async command region */
381 ret
= vfio_get_dev_region_info(vdev
, VFIO_REGION_TYPE_CCW
,
382 VFIO_REGION_SUBTYPE_CCW_ASYNC_CMD
, &info
);
384 vcdev
->async_cmd_region_size
= info
->size
;
385 if (sizeof(*vcdev
->async_cmd_region
) != vcdev
->async_cmd_region_size
) {
386 error_setg(errp
, "vfio: Unexpected size of the async cmd region");
387 g_free(vcdev
->io_region
);
391 vcdev
->async_cmd_region_offset
= info
->offset
;
392 vcdev
->async_cmd_region
= g_malloc0(info
->size
);
398 static void vfio_ccw_put_region(VFIOCCWDevice
*vcdev
)
400 g_free(vcdev
->async_cmd_region
);
401 g_free(vcdev
->io_region
);
404 static void vfio_ccw_put_device(VFIOCCWDevice
*vcdev
)
406 g_free(vcdev
->vdev
.name
);
407 vfio_put_base_device(&vcdev
->vdev
);
410 static void vfio_ccw_get_device(VFIOGroup
*group
, VFIOCCWDevice
*vcdev
,
413 char *name
= g_strdup_printf("%x.%x.%04x", vcdev
->cdev
.hostid
.cssid
,
414 vcdev
->cdev
.hostid
.ssid
,
415 vcdev
->cdev
.hostid
.devid
);
416 VFIODevice
*vbasedev
;
418 QLIST_FOREACH(vbasedev
, &group
->device_list
, next
) {
419 if (strcmp(vbasedev
->name
, name
) == 0) {
420 error_setg(errp
, "vfio: subchannel %s has already been attached",
427 * All vfio-ccw devices are believed to operate in a way compatible with
428 * memory ballooning, ie. pages pinned in the host are in the current
429 * working set of the guest driver and therefore never overlap with pages
430 * available to the guest balloon driver. This needs to be set before
431 * vfio_get_device() for vfio common to handle the balloon inhibitor.
433 vcdev
->vdev
.balloon_allowed
= true;
435 if (vfio_get_device(group
, vcdev
->cdev
.mdevid
, &vcdev
->vdev
, errp
)) {
439 vcdev
->vdev
.ops
= &vfio_ccw_ops
;
440 vcdev
->vdev
.type
= VFIO_DEVICE_TYPE_CCW
;
441 vcdev
->vdev
.name
= name
;
442 vcdev
->vdev
.dev
= &vcdev
->cdev
.parent_obj
.parent_obj
;
450 static VFIOGroup
*vfio_ccw_get_group(S390CCWDevice
*cdev
, Error
**errp
)
452 char *tmp
, group_path
[PATH_MAX
];
456 tmp
= g_strdup_printf("/sys/bus/css/devices/%x.%x.%04x/%s/iommu_group",
457 cdev
->hostid
.cssid
, cdev
->hostid
.ssid
,
458 cdev
->hostid
.devid
, cdev
->mdevid
);
459 len
= readlink(tmp
, group_path
, sizeof(group_path
));
462 if (len
<= 0 || len
>= sizeof(group_path
)) {
463 error_setg(errp
, "vfio: no iommu_group found");
469 if (sscanf(basename(group_path
), "%d", &groupid
) != 1) {
470 error_setg(errp
, "vfio: failed to read %s", group_path
);
474 return vfio_get_group(groupid
, &address_space_memory
, errp
);
477 static void vfio_ccw_realize(DeviceState
*dev
, Error
**errp
)
480 CcwDevice
*ccw_dev
= DO_UPCAST(CcwDevice
, parent_obj
, dev
);
481 S390CCWDevice
*cdev
= DO_UPCAST(S390CCWDevice
, parent_obj
, ccw_dev
);
482 VFIOCCWDevice
*vcdev
= DO_UPCAST(VFIOCCWDevice
, cdev
, cdev
);
483 S390CCWDeviceClass
*cdc
= S390_CCW_DEVICE_GET_CLASS(cdev
);
486 /* Call the class init function for subchannel. */
488 cdc
->realize(cdev
, vcdev
->vdev
.sysfsdev
, &err
);
490 goto out_err_propagate
;
494 group
= vfio_ccw_get_group(cdev
, &err
);
499 vfio_ccw_get_device(group
, vcdev
, &err
);
504 vfio_ccw_get_region(vcdev
, &err
);
509 vfio_ccw_register_io_notifier(vcdev
, &err
);
511 goto out_notifier_err
;
517 vfio_ccw_put_region(vcdev
);
519 vfio_ccw_put_device(vcdev
);
521 vfio_put_group(group
);
523 if (cdc
->unrealize
) {
524 cdc
->unrealize(cdev
, NULL
);
527 error_propagate(errp
, err
);
530 static void vfio_ccw_unrealize(DeviceState
*dev
, Error
**errp
)
532 CcwDevice
*ccw_dev
= DO_UPCAST(CcwDevice
, parent_obj
, dev
);
533 S390CCWDevice
*cdev
= DO_UPCAST(S390CCWDevice
, parent_obj
, ccw_dev
);
534 VFIOCCWDevice
*vcdev
= DO_UPCAST(VFIOCCWDevice
, cdev
, cdev
);
535 S390CCWDeviceClass
*cdc
= S390_CCW_DEVICE_GET_CLASS(cdev
);
536 VFIOGroup
*group
= vcdev
->vdev
.group
;
538 vfio_ccw_unregister_io_notifier(vcdev
);
539 vfio_ccw_put_region(vcdev
);
540 vfio_ccw_put_device(vcdev
);
541 vfio_put_group(group
);
543 if (cdc
->unrealize
) {
544 cdc
->unrealize(cdev
, errp
);
548 static Property vfio_ccw_properties
[] = {
549 DEFINE_PROP_STRING("sysfsdev", VFIOCCWDevice
, vdev
.sysfsdev
),
550 DEFINE_PROP_BOOL("force-orb-pfch", VFIOCCWDevice
, force_orb_pfch
, false),
551 DEFINE_PROP_END_OF_LIST(),
554 static const VMStateDescription vfio_ccw_vmstate
= {
559 static void vfio_ccw_class_init(ObjectClass
*klass
, void *data
)
561 DeviceClass
*dc
= DEVICE_CLASS(klass
);
562 S390CCWDeviceClass
*cdc
= S390_CCW_DEVICE_CLASS(klass
);
564 device_class_set_props(dc
, vfio_ccw_properties
);
565 dc
->vmsd
= &vfio_ccw_vmstate
;
566 dc
->desc
= "VFIO-based subchannel assignment";
567 set_bit(DEVICE_CATEGORY_MISC
, dc
->categories
);
568 dc
->realize
= vfio_ccw_realize
;
569 dc
->unrealize
= vfio_ccw_unrealize
;
570 dc
->reset
= vfio_ccw_reset
;
572 cdc
->handle_request
= vfio_ccw_handle_request
;
573 cdc
->handle_halt
= vfio_ccw_handle_halt
;
574 cdc
->handle_clear
= vfio_ccw_handle_clear
;
577 static const TypeInfo vfio_ccw_info
= {
578 .name
= TYPE_VFIO_CCW
,
579 .parent
= TYPE_S390_CCW
,
580 .instance_size
= sizeof(VFIOCCWDevice
),
581 .class_init
= vfio_ccw_class_init
,
584 static void register_vfio_ccw_type(void)
586 type_register_static(&vfio_ccw_info
);
589 type_init(register_vfio_ccw_type
)