1 /** 2 * QEMU vfio-user-server server object 3 * 4 * Copyright © 2022 Oracle and/or its affiliates. 5 * 6 * This work is licensed under the terms of the GNU GPL-v2, version 2 or later. 7 * 8 * See the COPYING file in the top-level directory. 9 * 10 */ 11 12 /** 13 * Usage: add options: 14 * -machine x-remote,vfio-user=on,auto-shutdown=on 15 * -device <PCI-device>,id=<pci-dev-id> 16 * -object x-vfio-user-server,id=<id>,type=unix,path=<socket-path>, 17 * device=<pci-dev-id> 18 * 19 * Note that x-vfio-user-server object must be used with x-remote machine only. 20 * This server could only support PCI devices for now. 21 * 22 * type - SocketAddress type - presently "unix" alone is supported. Required 23 * option 24 * 25 * path - named unix socket, it will be created by the server. It is 26 * a required option 27 * 28 * device - id of a device on the server, a required option. PCI devices 29 * alone are supported presently. 30 * 31 * notes - x-vfio-user-server could block IO and monitor during the 32 * initialization phase. 33 * 34 * When x-remote machine has the auto-shutdown property 35 * enabled (default), x-vfio-user-server terminates after the last 36 * client disconnects. Otherwise, it will continue running until 37 * explicitly killed. 38 */ 39 40 #include "qemu/osdep.h" 41 42 #include "qom/object.h" 43 #include "qom/object_interfaces.h" 44 #include "qemu/error-report.h" 45 #include "trace.h" 46 #include "sysemu/runstate.h" 47 #include "hw/boards.h" 48 #include "hw/remote/machine.h" 49 #include "qapi/error.h" 50 #include "qapi/qapi-visit-sockets.h" 51 #include "qapi/qapi-events-misc.h" 52 #include "qemu/notify.h" 53 #include "qemu/thread.h" 54 #include "qemu/main-loop.h" 55 #include "sysemu/sysemu.h" 56 #include "libvfio-user.h" 57 #include "hw/qdev-core.h" 58 #include "hw/pci/pci.h" 59 #include "qemu/timer.h" 60 #include "exec/memory.h" 61 #include "hw/pci/msi.h" 62 #include "hw/pci/msix.h" 63 #include "hw/remote/vfio-user-obj.h" 64 65 #define TYPE_VFU_OBJECT "x-vfio-user-server" 66 OBJECT_DECLARE_TYPE(VfuObject, VfuObjectClass, VFU_OBJECT) 67 68 /** 69 * VFU_OBJECT_ERROR - reports an error message. 70 * 71 * If auto_shutdown is set, it aborts the machine on error. Otherwise, 72 * it logs an error message without aborting. auto_shutdown is disabled 73 * when the server serves clients from multiple VMs; as such, an error 74 * from one VM shouldn't be able to disrupt other VM's services. 75 */ 76 #define VFU_OBJECT_ERROR(o, fmt, ...) \ 77 { \ 78 if (vfu_object_auto_shutdown()) { \ 79 error_setg(&error_abort, (fmt), ## __VA_ARGS__); \ 80 } else { \ 81 error_report((fmt), ## __VA_ARGS__); \ 82 } \ 83 } \ 84 85 struct VfuObjectClass { 86 ObjectClass parent_class; 87 88 unsigned int nr_devs; 89 }; 90 91 struct VfuObject { 92 /* private */ 93 Object parent; 94 95 SocketAddress *socket; 96 97 char *device; 98 99 Error *err; 100 101 Notifier machine_done; 102 103 vfu_ctx_t *vfu_ctx; 104 105 PCIDevice *pci_dev; 106 107 Error *unplug_blocker; 108 109 int vfu_poll_fd; 110 111 MSITriggerFunc *default_msi_trigger; 112 MSIPrepareMessageFunc *default_msi_prepare_message; 113 MSIxPrepareMessageFunc *default_msix_prepare_message; 114 }; 115 116 static void vfu_object_init_ctx(VfuObject *o, Error **errp); 117 118 static bool vfu_object_auto_shutdown(void) 119 { 120 bool auto_shutdown = true; 121 Error *local_err = NULL; 122 123 if (!current_machine) { 124 return auto_shutdown; 125 } 126 127 auto_shutdown = object_property_get_bool(OBJECT(current_machine), 128 "auto-shutdown", 129 &local_err); 130 131 /* 132 * local_err would be set if no such property exists - safe to ignore. 133 * Unlikely scenario as auto-shutdown is always defined for 134 * TYPE_REMOTE_MACHINE, and TYPE_VFU_OBJECT only works with 135 * TYPE_REMOTE_MACHINE 136 */ 137 if (local_err) { 138 auto_shutdown = true; 139 error_free(local_err); 140 } 141 142 return auto_shutdown; 143 } 144 145 static void vfu_object_set_socket(Object *obj, Visitor *v, const char *name, 146 void *opaque, Error **errp) 147 { 148 VfuObject *o = VFU_OBJECT(obj); 149 150 if (o->vfu_ctx) { 151 error_setg(errp, "vfu: Unable to set socket property - server busy"); 152 return; 153 } 154 155 qapi_free_SocketAddress(o->socket); 156 157 o->socket = NULL; 158 159 visit_type_SocketAddress(v, name, &o->socket, errp); 160 161 if (o->socket->type != SOCKET_ADDRESS_TYPE_UNIX) { 162 error_setg(errp, "vfu: Unsupported socket type - %s", 163 SocketAddressType_str(o->socket->type)); 164 qapi_free_SocketAddress(o->socket); 165 o->socket = NULL; 166 return; 167 } 168 169 trace_vfu_prop("socket", o->socket->u.q_unix.path); 170 171 vfu_object_init_ctx(o, errp); 172 } 173 174 static void vfu_object_set_device(Object *obj, const char *str, Error **errp) 175 { 176 VfuObject *o = VFU_OBJECT(obj); 177 178 if (o->vfu_ctx) { 179 error_setg(errp, "vfu: Unable to set device property - server busy"); 180 return; 181 } 182 183 g_free(o->device); 184 185 o->device = g_strdup(str); 186 187 trace_vfu_prop("device", str); 188 189 vfu_object_init_ctx(o, errp); 190 } 191 192 static void vfu_object_ctx_run(void *opaque) 193 { 194 VfuObject *o = opaque; 195 const char *vfu_id; 196 char *vfu_path, *pci_dev_path; 197 int ret = -1; 198 199 while (ret != 0) { 200 ret = vfu_run_ctx(o->vfu_ctx); 201 if (ret < 0) { 202 if (errno == EINTR) { 203 continue; 204 } else if (errno == ENOTCONN) { 205 vfu_id = object_get_canonical_path_component(OBJECT(o)); 206 vfu_path = object_get_canonical_path(OBJECT(o)); 207 g_assert(o->pci_dev); 208 pci_dev_path = object_get_canonical_path(OBJECT(o->pci_dev)); 209 /* o->device is a required property and is non-NULL here */ 210 g_assert(o->device); 211 qapi_event_send_vfu_client_hangup(vfu_id, vfu_path, 212 o->device, pci_dev_path); 213 qemu_set_fd_handler(o->vfu_poll_fd, NULL, NULL, NULL); 214 o->vfu_poll_fd = -1; 215 object_unparent(OBJECT(o)); 216 g_free(vfu_path); 217 g_free(pci_dev_path); 218 break; 219 } else { 220 VFU_OBJECT_ERROR(o, "vfu: Failed to run device %s - %s", 221 o->device, strerror(errno)); 222 break; 223 } 224 } 225 } 226 } 227 228 static void vfu_object_attach_ctx(void *opaque) 229 { 230 VfuObject *o = opaque; 231 GPollFD pfds[1]; 232 int ret; 233 234 qemu_set_fd_handler(o->vfu_poll_fd, NULL, NULL, NULL); 235 236 pfds[0].fd = o->vfu_poll_fd; 237 pfds[0].events = G_IO_IN | G_IO_HUP | G_IO_ERR; 238 239 retry_attach: 240 ret = vfu_attach_ctx(o->vfu_ctx); 241 if (ret < 0 && (errno == EAGAIN || errno == EWOULDBLOCK)) { 242 /** 243 * vfu_object_attach_ctx can block QEMU's main loop 244 * during attach - the monitor and other IO 245 * could be unresponsive during this time. 246 */ 247 (void)qemu_poll_ns(pfds, 1, 500 * (int64_t)SCALE_MS); 248 goto retry_attach; 249 } else if (ret < 0) { 250 VFU_OBJECT_ERROR(o, "vfu: Failed to attach device %s to context - %s", 251 o->device, strerror(errno)); 252 return; 253 } 254 255 o->vfu_poll_fd = vfu_get_poll_fd(o->vfu_ctx); 256 if (o->vfu_poll_fd < 0) { 257 VFU_OBJECT_ERROR(o, "vfu: Failed to get poll fd %s", o->device); 258 return; 259 } 260 261 qemu_set_fd_handler(o->vfu_poll_fd, vfu_object_ctx_run, NULL, o); 262 } 263 264 static ssize_t vfu_object_cfg_access(vfu_ctx_t *vfu_ctx, char * const buf, 265 size_t count, loff_t offset, 266 const bool is_write) 267 { 268 VfuObject *o = vfu_get_private(vfu_ctx); 269 uint32_t pci_access_width = sizeof(uint32_t); 270 size_t bytes = count; 271 uint32_t val = 0; 272 char *ptr = buf; 273 int len; 274 275 /* 276 * Writes to the BAR registers would trigger an update to the 277 * global Memory and IO AddressSpaces. But the remote device 278 * never uses the global AddressSpaces, therefore overlapping 279 * memory regions are not a problem 280 */ 281 while (bytes > 0) { 282 len = (bytes > pci_access_width) ? pci_access_width : bytes; 283 if (is_write) { 284 memcpy(&val, ptr, len); 285 pci_host_config_write_common(o->pci_dev, offset, 286 pci_config_size(o->pci_dev), 287 val, len); 288 trace_vfu_cfg_write(offset, val); 289 } else { 290 val = pci_host_config_read_common(o->pci_dev, offset, 291 pci_config_size(o->pci_dev), len); 292 memcpy(ptr, &val, len); 293 trace_vfu_cfg_read(offset, val); 294 } 295 offset += len; 296 ptr += len; 297 bytes -= len; 298 } 299 300 return count; 301 } 302 303 static void dma_register(vfu_ctx_t *vfu_ctx, vfu_dma_info_t *info) 304 { 305 VfuObject *o = vfu_get_private(vfu_ctx); 306 AddressSpace *dma_as = NULL; 307 MemoryRegion *subregion = NULL; 308 g_autofree char *name = NULL; 309 struct iovec *iov = &info->iova; 310 311 if (!info->vaddr) { 312 return; 313 } 314 315 name = g_strdup_printf("mem-%s-%"PRIx64"", o->device, 316 (uint64_t)info->vaddr); 317 318 subregion = g_new0(MemoryRegion, 1); 319 320 memory_region_init_ram_ptr(subregion, NULL, name, 321 iov->iov_len, info->vaddr); 322 323 dma_as = pci_device_iommu_address_space(o->pci_dev); 324 325 memory_region_add_subregion(dma_as->root, (hwaddr)iov->iov_base, subregion); 326 327 trace_vfu_dma_register((uint64_t)iov->iov_base, iov->iov_len); 328 } 329 330 static void dma_unregister(vfu_ctx_t *vfu_ctx, vfu_dma_info_t *info) 331 { 332 VfuObject *o = vfu_get_private(vfu_ctx); 333 AddressSpace *dma_as = NULL; 334 MemoryRegion *mr = NULL; 335 ram_addr_t offset; 336 337 mr = memory_region_from_host(info->vaddr, &offset); 338 if (!mr) { 339 return; 340 } 341 342 dma_as = pci_device_iommu_address_space(o->pci_dev); 343 344 memory_region_del_subregion(dma_as->root, mr); 345 346 object_unparent((OBJECT(mr))); 347 348 trace_vfu_dma_unregister((uint64_t)info->iova.iov_base); 349 } 350 351 static int vfu_object_mr_rw(MemoryRegion *mr, uint8_t *buf, hwaddr offset, 352 hwaddr size, const bool is_write) 353 { 354 uint8_t *ptr = buf; 355 bool release_lock = false; 356 uint8_t *ram_ptr = NULL; 357 MemTxResult result; 358 int access_size; 359 uint64_t val; 360 361 if (memory_access_is_direct(mr, is_write)) { 362 /** 363 * Some devices expose a PCI expansion ROM, which could be buffer 364 * based as compared to other regions which are primarily based on 365 * MemoryRegionOps. memory_region_find() would already check 366 * for buffer overflow, we don't need to repeat it here. 367 */ 368 ram_ptr = memory_region_get_ram_ptr(mr); 369 370 if (is_write) { 371 memcpy((ram_ptr + offset), buf, size); 372 } else { 373 memcpy(buf, (ram_ptr + offset), size); 374 } 375 376 return 0; 377 } 378 379 while (size) { 380 /** 381 * The read/write logic used below is similar to the ones in 382 * flatview_read/write_continue() 383 */ 384 release_lock = prepare_mmio_access(mr); 385 386 access_size = memory_access_size(mr, size, offset); 387 388 if (is_write) { 389 val = ldn_he_p(ptr, access_size); 390 391 result = memory_region_dispatch_write(mr, offset, val, 392 size_memop(access_size), 393 MEMTXATTRS_UNSPECIFIED); 394 } else { 395 result = memory_region_dispatch_read(mr, offset, &val, 396 size_memop(access_size), 397 MEMTXATTRS_UNSPECIFIED); 398 399 stn_he_p(ptr, access_size, val); 400 } 401 402 if (release_lock) { 403 bql_unlock(); 404 release_lock = false; 405 } 406 407 if (result != MEMTX_OK) { 408 return -1; 409 } 410 411 size -= access_size; 412 ptr += access_size; 413 offset += access_size; 414 } 415 416 return 0; 417 } 418 419 static size_t vfu_object_bar_rw(PCIDevice *pci_dev, int pci_bar, 420 hwaddr bar_offset, char * const buf, 421 hwaddr len, const bool is_write) 422 { 423 MemoryRegionSection section = { 0 }; 424 uint8_t *ptr = (uint8_t *)buf; 425 MemoryRegion *section_mr = NULL; 426 uint64_t section_size; 427 hwaddr section_offset; 428 hwaddr size = 0; 429 430 while (len) { 431 section = memory_region_find(pci_dev->io_regions[pci_bar].memory, 432 bar_offset, len); 433 434 if (!section.mr) { 435 warn_report("vfu: invalid address 0x%"PRIx64"", bar_offset); 436 return size; 437 } 438 439 section_mr = section.mr; 440 section_offset = section.offset_within_region; 441 section_size = int128_get64(section.size); 442 443 if (is_write && section_mr->readonly) { 444 warn_report("vfu: attempting to write to readonly region in " 445 "bar %d - [0x%"PRIx64" - 0x%"PRIx64"]", 446 pci_bar, bar_offset, 447 (bar_offset + section_size)); 448 memory_region_unref(section_mr); 449 return size; 450 } 451 452 if (vfu_object_mr_rw(section_mr, ptr, section_offset, 453 section_size, is_write)) { 454 warn_report("vfu: failed to %s " 455 "[0x%"PRIx64" - 0x%"PRIx64"] in bar %d", 456 is_write ? "write to" : "read from", bar_offset, 457 (bar_offset + section_size), pci_bar); 458 memory_region_unref(section_mr); 459 return size; 460 } 461 462 size += section_size; 463 bar_offset += section_size; 464 ptr += section_size; 465 len -= section_size; 466 467 memory_region_unref(section_mr); 468 } 469 470 return size; 471 } 472 473 /** 474 * VFU_OBJECT_BAR_HANDLER - macro for defining handlers for PCI BARs. 475 * 476 * To create handler for BAR number 2, VFU_OBJECT_BAR_HANDLER(2) would 477 * define vfu_object_bar2_handler 478 */ 479 #define VFU_OBJECT_BAR_HANDLER(BAR_NO) \ 480 static ssize_t vfu_object_bar##BAR_NO##_handler(vfu_ctx_t *vfu_ctx, \ 481 char * const buf, size_t count, \ 482 loff_t offset, const bool is_write) \ 483 { \ 484 VfuObject *o = vfu_get_private(vfu_ctx); \ 485 PCIDevice *pci_dev = o->pci_dev; \ 486 \ 487 return vfu_object_bar_rw(pci_dev, BAR_NO, offset, \ 488 buf, count, is_write); \ 489 } \ 490 491 VFU_OBJECT_BAR_HANDLER(0) 492 VFU_OBJECT_BAR_HANDLER(1) 493 VFU_OBJECT_BAR_HANDLER(2) 494 VFU_OBJECT_BAR_HANDLER(3) 495 VFU_OBJECT_BAR_HANDLER(4) 496 VFU_OBJECT_BAR_HANDLER(5) 497 VFU_OBJECT_BAR_HANDLER(6) 498 499 static vfu_region_access_cb_t *vfu_object_bar_handlers[PCI_NUM_REGIONS] = { 500 &vfu_object_bar0_handler, 501 &vfu_object_bar1_handler, 502 &vfu_object_bar2_handler, 503 &vfu_object_bar3_handler, 504 &vfu_object_bar4_handler, 505 &vfu_object_bar5_handler, 506 &vfu_object_bar6_handler, 507 }; 508 509 /** 510 * vfu_object_register_bars - Identify active BAR regions of pdev and setup 511 * callbacks to handle read/write accesses 512 */ 513 static void vfu_object_register_bars(vfu_ctx_t *vfu_ctx, PCIDevice *pdev) 514 { 515 int flags = VFU_REGION_FLAG_RW; 516 int i; 517 518 for (i = 0; i < PCI_NUM_REGIONS; i++) { 519 if (!pdev->io_regions[i].size) { 520 continue; 521 } 522 523 if ((i == VFU_PCI_DEV_ROM_REGION_IDX) || 524 pdev->io_regions[i].memory->readonly) { 525 flags &= ~VFU_REGION_FLAG_WRITE; 526 } 527 528 vfu_setup_region(vfu_ctx, VFU_PCI_DEV_BAR0_REGION_IDX + i, 529 (size_t)pdev->io_regions[i].size, 530 vfu_object_bar_handlers[i], 531 flags, NULL, 0, -1, 0); 532 533 trace_vfu_bar_register(i, pdev->io_regions[i].addr, 534 pdev->io_regions[i].size); 535 } 536 } 537 538 static int vfu_object_map_irq(PCIDevice *pci_dev, int intx) 539 { 540 int pci_bdf = PCI_BUILD_BDF(pci_bus_num(pci_get_bus(pci_dev)), 541 pci_dev->devfn); 542 543 return pci_bdf; 544 } 545 546 static void vfu_object_set_irq(void *opaque, int pirq, int level) 547 { 548 PCIBus *pci_bus = opaque; 549 PCIDevice *pci_dev = NULL; 550 vfu_ctx_t *vfu_ctx = NULL; 551 int pci_bus_num, devfn; 552 553 if (level) { 554 pci_bus_num = PCI_BUS_NUM(pirq); 555 devfn = PCI_BDF_TO_DEVFN(pirq); 556 557 /* 558 * pci_find_device() performs at O(1) if the device is attached 559 * to the root PCI bus. Whereas, if the device is attached to a 560 * secondary PCI bus (such as when a root port is involved), 561 * finding the parent PCI bus could take O(n) 562 */ 563 pci_dev = pci_find_device(pci_bus, pci_bus_num, devfn); 564 565 vfu_ctx = pci_dev->irq_opaque; 566 567 g_assert(vfu_ctx); 568 569 vfu_irq_trigger(vfu_ctx, 0); 570 } 571 } 572 573 static MSIMessage vfu_object_msi_prepare_msg(PCIDevice *pci_dev, 574 unsigned int vector) 575 { 576 MSIMessage msg; 577 578 msg.address = 0; 579 msg.data = vector; 580 581 return msg; 582 } 583 584 static void vfu_object_msi_trigger(PCIDevice *pci_dev, MSIMessage msg) 585 { 586 vfu_ctx_t *vfu_ctx = pci_dev->irq_opaque; 587 588 vfu_irq_trigger(vfu_ctx, msg.data); 589 } 590 591 static void vfu_object_setup_msi_cbs(VfuObject *o) 592 { 593 o->default_msi_trigger = o->pci_dev->msi_trigger; 594 o->default_msi_prepare_message = o->pci_dev->msi_prepare_message; 595 o->default_msix_prepare_message = o->pci_dev->msix_prepare_message; 596 597 o->pci_dev->msi_trigger = vfu_object_msi_trigger; 598 o->pci_dev->msi_prepare_message = vfu_object_msi_prepare_msg; 599 o->pci_dev->msix_prepare_message = vfu_object_msi_prepare_msg; 600 } 601 602 static void vfu_object_restore_msi_cbs(VfuObject *o) 603 { 604 o->pci_dev->msi_trigger = o->default_msi_trigger; 605 o->pci_dev->msi_prepare_message = o->default_msi_prepare_message; 606 o->pci_dev->msix_prepare_message = o->default_msix_prepare_message; 607 } 608 609 static void vfu_msix_irq_state(vfu_ctx_t *vfu_ctx, uint32_t start, 610 uint32_t count, bool mask) 611 { 612 VfuObject *o = vfu_get_private(vfu_ctx); 613 uint32_t vector; 614 615 for (vector = start; vector < count; vector++) { 616 msix_set_mask(o->pci_dev, vector, mask); 617 } 618 } 619 620 static void vfu_msi_irq_state(vfu_ctx_t *vfu_ctx, uint32_t start, 621 uint32_t count, bool mask) 622 { 623 VfuObject *o = vfu_get_private(vfu_ctx); 624 Error *err = NULL; 625 uint32_t vector; 626 627 for (vector = start; vector < count; vector++) { 628 msi_set_mask(o->pci_dev, vector, mask, &err); 629 if (err) { 630 VFU_OBJECT_ERROR(o, "vfu: %s: %s", o->device, 631 error_get_pretty(err)); 632 error_free(err); 633 err = NULL; 634 } 635 } 636 } 637 638 static int vfu_object_setup_irqs(VfuObject *o, PCIDevice *pci_dev) 639 { 640 vfu_ctx_t *vfu_ctx = o->vfu_ctx; 641 int ret; 642 643 ret = vfu_setup_device_nr_irqs(vfu_ctx, VFU_DEV_INTX_IRQ, 1); 644 if (ret < 0) { 645 return ret; 646 } 647 648 if (msix_nr_vectors_allocated(pci_dev)) { 649 ret = vfu_setup_device_nr_irqs(vfu_ctx, VFU_DEV_MSIX_IRQ, 650 msix_nr_vectors_allocated(pci_dev)); 651 vfu_setup_irq_state_callback(vfu_ctx, VFU_DEV_MSIX_IRQ, 652 &vfu_msix_irq_state); 653 } else if (msi_nr_vectors_allocated(pci_dev)) { 654 ret = vfu_setup_device_nr_irqs(vfu_ctx, VFU_DEV_MSI_IRQ, 655 msi_nr_vectors_allocated(pci_dev)); 656 vfu_setup_irq_state_callback(vfu_ctx, VFU_DEV_MSI_IRQ, 657 &vfu_msi_irq_state); 658 } 659 660 if (ret < 0) { 661 return ret; 662 } 663 664 vfu_object_setup_msi_cbs(o); 665 666 pci_dev->irq_opaque = vfu_ctx; 667 668 return 0; 669 } 670 671 void vfu_object_set_bus_irq(PCIBus *pci_bus) 672 { 673 int bus_num = pci_bus_num(pci_bus); 674 int max_bdf = PCI_BUILD_BDF(bus_num, PCI_DEVFN_MAX - 1); 675 676 pci_bus_irqs(pci_bus, vfu_object_set_irq, pci_bus, max_bdf); 677 pci_bus_map_irqs(pci_bus, vfu_object_map_irq); 678 } 679 680 static int vfu_object_device_reset(vfu_ctx_t *vfu_ctx, vfu_reset_type_t type) 681 { 682 VfuObject *o = vfu_get_private(vfu_ctx); 683 684 /* vfu_object_ctx_run() handles lost connection */ 685 if (type == VFU_RESET_LOST_CONN) { 686 return 0; 687 } 688 689 device_cold_reset(DEVICE(o->pci_dev)); 690 691 return 0; 692 } 693 694 /* 695 * TYPE_VFU_OBJECT depends on the availability of the 'socket' and 'device' 696 * properties. It also depends on devices instantiated in QEMU. These 697 * dependencies are not available during the instance_init phase of this 698 * object's life-cycle. As such, the server is initialized after the 699 * machine is setup. machine_init_done_notifier notifies TYPE_VFU_OBJECT 700 * when the machine is setup, and the dependencies are available. 701 */ 702 static void vfu_object_machine_done(Notifier *notifier, void *data) 703 { 704 VfuObject *o = container_of(notifier, VfuObject, machine_done); 705 Error *err = NULL; 706 707 vfu_object_init_ctx(o, &err); 708 709 if (err) { 710 error_propagate(&error_abort, err); 711 } 712 } 713 714 /** 715 * vfu_object_init_ctx: Create and initialize libvfio-user context. Add 716 * an unplug blocker for the associated PCI device. Setup a FD handler 717 * to process incoming messages in the context's socket. 718 * 719 * The socket and device properties are mandatory, and this function 720 * will not create the context without them - the setters for these 721 * properties should call this function when the property is set. The 722 * machine should also be ready when this function is invoked - it is 723 * because QEMU objects are initialized before devices, and the 724 * associated PCI device wouldn't be available at the object 725 * initialization time. Until these conditions are satisfied, this 726 * function would return early without performing any task. 727 */ 728 static void vfu_object_init_ctx(VfuObject *o, Error **errp) 729 { 730 DeviceState *dev = NULL; 731 vfu_pci_type_t pci_type = VFU_PCI_TYPE_CONVENTIONAL; 732 int ret; 733 734 if (o->vfu_ctx || !o->socket || !o->device || 735 !phase_check(PHASE_MACHINE_READY)) { 736 return; 737 } 738 739 if (o->err) { 740 error_propagate(errp, o->err); 741 o->err = NULL; 742 return; 743 } 744 745 o->vfu_ctx = vfu_create_ctx(VFU_TRANS_SOCK, o->socket->u.q_unix.path, 746 LIBVFIO_USER_FLAG_ATTACH_NB, 747 o, VFU_DEV_TYPE_PCI); 748 if (o->vfu_ctx == NULL) { 749 error_setg(errp, "vfu: Failed to create context - %s", strerror(errno)); 750 return; 751 } 752 753 dev = qdev_find_recursive(sysbus_get_default(), o->device); 754 if (dev == NULL) { 755 error_setg(errp, "vfu: Device %s not found", o->device); 756 goto fail; 757 } 758 759 if (!object_dynamic_cast(OBJECT(dev), TYPE_PCI_DEVICE)) { 760 error_setg(errp, "vfu: %s not a PCI device", o->device); 761 goto fail; 762 } 763 764 o->pci_dev = PCI_DEVICE(dev); 765 766 object_ref(OBJECT(o->pci_dev)); 767 768 if (pci_is_express(o->pci_dev)) { 769 pci_type = VFU_PCI_TYPE_EXPRESS; 770 } 771 772 ret = vfu_pci_init(o->vfu_ctx, pci_type, PCI_HEADER_TYPE_NORMAL, 0); 773 if (ret < 0) { 774 error_setg(errp, 775 "vfu: Failed to attach PCI device %s to context - %s", 776 o->device, strerror(errno)); 777 goto fail; 778 } 779 780 error_setg(&o->unplug_blocker, 781 "vfu: %s for %s must be deleted before unplugging", 782 TYPE_VFU_OBJECT, o->device); 783 qdev_add_unplug_blocker(DEVICE(o->pci_dev), o->unplug_blocker); 784 785 ret = vfu_setup_region(o->vfu_ctx, VFU_PCI_DEV_CFG_REGION_IDX, 786 pci_config_size(o->pci_dev), &vfu_object_cfg_access, 787 VFU_REGION_FLAG_RW | VFU_REGION_FLAG_ALWAYS_CB, 788 NULL, 0, -1, 0); 789 if (ret < 0) { 790 error_setg(errp, 791 "vfu: Failed to setup config space handlers for %s- %s", 792 o->device, strerror(errno)); 793 goto fail; 794 } 795 796 ret = vfu_setup_device_dma(o->vfu_ctx, &dma_register, &dma_unregister); 797 if (ret < 0) { 798 error_setg(errp, "vfu: Failed to setup DMA handlers for %s", 799 o->device); 800 goto fail; 801 } 802 803 vfu_object_register_bars(o->vfu_ctx, o->pci_dev); 804 805 ret = vfu_object_setup_irqs(o, o->pci_dev); 806 if (ret < 0) { 807 error_setg(errp, "vfu: Failed to setup interrupts for %s", 808 o->device); 809 goto fail; 810 } 811 812 ret = vfu_setup_device_reset_cb(o->vfu_ctx, &vfu_object_device_reset); 813 if (ret < 0) { 814 error_setg(errp, "vfu: Failed to setup reset callback"); 815 goto fail; 816 } 817 818 ret = vfu_realize_ctx(o->vfu_ctx); 819 if (ret < 0) { 820 error_setg(errp, "vfu: Failed to realize device %s- %s", 821 o->device, strerror(errno)); 822 goto fail; 823 } 824 825 o->vfu_poll_fd = vfu_get_poll_fd(o->vfu_ctx); 826 if (o->vfu_poll_fd < 0) { 827 error_setg(errp, "vfu: Failed to get poll fd %s", o->device); 828 goto fail; 829 } 830 831 qemu_set_fd_handler(o->vfu_poll_fd, vfu_object_attach_ctx, NULL, o); 832 833 return; 834 835 fail: 836 vfu_destroy_ctx(o->vfu_ctx); 837 if (o->unplug_blocker && o->pci_dev) { 838 qdev_del_unplug_blocker(DEVICE(o->pci_dev), o->unplug_blocker); 839 error_free(o->unplug_blocker); 840 o->unplug_blocker = NULL; 841 } 842 if (o->pci_dev) { 843 vfu_object_restore_msi_cbs(o); 844 o->pci_dev->irq_opaque = NULL; 845 object_unref(OBJECT(o->pci_dev)); 846 o->pci_dev = NULL; 847 } 848 o->vfu_ctx = NULL; 849 } 850 851 static void vfu_object_init(Object *obj) 852 { 853 VfuObjectClass *k = VFU_OBJECT_GET_CLASS(obj); 854 VfuObject *o = VFU_OBJECT(obj); 855 856 k->nr_devs++; 857 858 if (!object_dynamic_cast(OBJECT(current_machine), TYPE_REMOTE_MACHINE)) { 859 error_setg(&o->err, "vfu: %s only compatible with %s machine", 860 TYPE_VFU_OBJECT, TYPE_REMOTE_MACHINE); 861 return; 862 } 863 864 if (!phase_check(PHASE_MACHINE_READY)) { 865 o->machine_done.notify = vfu_object_machine_done; 866 qemu_add_machine_init_done_notifier(&o->machine_done); 867 } 868 869 o->vfu_poll_fd = -1; 870 } 871 872 static void vfu_object_finalize(Object *obj) 873 { 874 VfuObjectClass *k = VFU_OBJECT_GET_CLASS(obj); 875 VfuObject *o = VFU_OBJECT(obj); 876 877 k->nr_devs--; 878 879 qapi_free_SocketAddress(o->socket); 880 881 o->socket = NULL; 882 883 if (o->vfu_poll_fd != -1) { 884 qemu_set_fd_handler(o->vfu_poll_fd, NULL, NULL, NULL); 885 o->vfu_poll_fd = -1; 886 } 887 888 if (o->vfu_ctx) { 889 vfu_destroy_ctx(o->vfu_ctx); 890 o->vfu_ctx = NULL; 891 } 892 893 g_free(o->device); 894 895 o->device = NULL; 896 897 if (o->unplug_blocker && o->pci_dev) { 898 qdev_del_unplug_blocker(DEVICE(o->pci_dev), o->unplug_blocker); 899 error_free(o->unplug_blocker); 900 o->unplug_blocker = NULL; 901 } 902 903 if (o->pci_dev) { 904 vfu_object_restore_msi_cbs(o); 905 o->pci_dev->irq_opaque = NULL; 906 object_unref(OBJECT(o->pci_dev)); 907 o->pci_dev = NULL; 908 } 909 910 if (!k->nr_devs && vfu_object_auto_shutdown()) { 911 qemu_system_shutdown_request(SHUTDOWN_CAUSE_GUEST_SHUTDOWN); 912 } 913 914 if (o->machine_done.notify) { 915 qemu_remove_machine_init_done_notifier(&o->machine_done); 916 o->machine_done.notify = NULL; 917 } 918 } 919 920 static void vfu_object_class_init(ObjectClass *klass, void *data) 921 { 922 VfuObjectClass *k = VFU_OBJECT_CLASS(klass); 923 924 k->nr_devs = 0; 925 926 object_class_property_add(klass, "socket", "SocketAddress", NULL, 927 vfu_object_set_socket, NULL, NULL); 928 object_class_property_set_description(klass, "socket", 929 "SocketAddress " 930 "(ex: type=unix,path=/tmp/sock). " 931 "Only UNIX is presently supported"); 932 object_class_property_add_str(klass, "device", NULL, 933 vfu_object_set_device); 934 object_class_property_set_description(klass, "device", 935 "device ID - only PCI devices " 936 "are presently supported"); 937 } 938 939 static const TypeInfo vfu_object_info = { 940 .name = TYPE_VFU_OBJECT, 941 .parent = TYPE_OBJECT, 942 .instance_size = sizeof(VfuObject), 943 .instance_init = vfu_object_init, 944 .instance_finalize = vfu_object_finalize, 945 .class_size = sizeof(VfuObjectClass), 946 .class_init = vfu_object_class_init, 947 .interfaces = (InterfaceInfo[]) { 948 { TYPE_USER_CREATABLE }, 949 { } 950 } 951 }; 952 953 static void vfu_register_types(void) 954 { 955 type_register_static(&vfu_object_info); 956 } 957 958 type_init(vfu_register_types); 959