1 /* 2 * Dynamic device configuration and creation. 3 * 4 * Copyright (c) 2009 CodeSourcery 5 * 6 * This library is free software; you can redistribute it and/or 7 * modify it under the terms of the GNU Lesser General Public 8 * License as published by the Free Software Foundation; either 9 * version 2.1 of the License, or (at your option) any later version. 10 * 11 * This library is distributed in the hope that it will be useful, 12 * but WITHOUT ANY WARRANTY; without even the implied warranty of 13 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 14 * Lesser General Public License for more details. 15 * 16 * You should have received a copy of the GNU Lesser General Public 17 * License along with this library; if not, see <http://www.gnu.org/licenses/>. 18 */ 19 20 /* The theory here is that it should be possible to create a machine without 21 knowledge of specific devices. Historically board init routines have 22 passed a bunch of arguments to each device, requiring the board know 23 exactly which device it is dealing with. This file provides an abstract 24 API for device configuration and initialization. Devices will generally 25 inherit from a particular bus (e.g. PCI or I2C) rather than 26 this API directly. */ 27 28 #include "qemu/osdep.h" 29 #include "qapi/error.h" 30 #include "qapi/qapi-events-qdev.h" 31 #include "qapi/qmp/qdict.h" 32 #include "qapi/visitor.h" 33 #include "qemu/error-report.h" 34 #include "qemu/option.h" 35 #include "hw/irq.h" 36 #include "hw/qdev-properties.h" 37 #include "hw/boards.h" 38 #include "hw/sysbus.h" 39 #include "hw/qdev-clock.h" 40 #include "migration/vmstate.h" 41 #include "trace.h" 42 43 static bool qdev_hot_added = false; 44 bool qdev_hot_removed = false; 45 46 const VMStateDescription *qdev_get_vmsd(DeviceState *dev) 47 { 48 DeviceClass *dc = DEVICE_GET_CLASS(dev); 49 return dc->vmsd; 50 } 51 52 static void bus_free_bus_child(BusChild *kid) 53 { 54 object_unref(OBJECT(kid->child)); 55 g_free(kid); 56 } 57 58 static void bus_remove_child(BusState *bus, DeviceState *child) 59 { 60 BusChild *kid; 61 62 QTAILQ_FOREACH(kid, &bus->children, sibling) { 63 if (kid->child == child) { 64 char name[32]; 65 66 snprintf(name, sizeof(name), "child[%d]", kid->index); 67 QTAILQ_REMOVE_RCU(&bus->children, kid, sibling); 68 69 bus->num_children--; 70 71 /* This gives back ownership of kid->child back to us. */ 72 object_property_del(OBJECT(bus), name); 73 74 /* free the bus kid, when it is safe to do so*/ 75 call_rcu(kid, bus_free_bus_child, rcu); 76 break; 77 } 78 } 79 } 80 81 static void bus_add_child(BusState *bus, DeviceState *child) 82 { 83 char name[32]; 84 BusChild *kid = g_malloc0(sizeof(*kid)); 85 86 bus->num_children++; 87 kid->index = bus->max_index++; 88 kid->child = child; 89 object_ref(OBJECT(kid->child)); 90 91 QTAILQ_INSERT_HEAD_RCU(&bus->children, kid, sibling); 92 93 /* This transfers ownership of kid->child to the property. */ 94 snprintf(name, sizeof(name), "child[%d]", kid->index); 95 object_property_add_link(OBJECT(bus), name, 96 object_get_typename(OBJECT(child)), 97 (Object **)&kid->child, 98 NULL, /* read-only property */ 99 0); 100 } 101 102 static bool bus_check_address(BusState *bus, DeviceState *child, Error **errp) 103 { 104 BusClass *bc = BUS_GET_CLASS(bus); 105 return !bc->check_address || bc->check_address(bus, child, errp); 106 } 107 108 bool qdev_set_parent_bus(DeviceState *dev, BusState *bus, Error **errp) 109 { 110 BusState *old_parent_bus = dev->parent_bus; 111 DeviceClass *dc = DEVICE_GET_CLASS(dev); 112 113 assert(dc->bus_type && object_dynamic_cast(OBJECT(bus), dc->bus_type)); 114 115 if (!bus_check_address(bus, dev, errp)) { 116 return false; 117 } 118 119 if (old_parent_bus) { 120 trace_qdev_update_parent_bus(dev, object_get_typename(OBJECT(dev)), 121 old_parent_bus, object_get_typename(OBJECT(old_parent_bus)), 122 OBJECT(bus), object_get_typename(OBJECT(bus))); 123 /* 124 * Keep a reference to the device while it's not plugged into 125 * any bus, to avoid it potentially evaporating when it is 126 * dereffed in bus_remove_child(). 127 * Also keep the ref of the parent bus until the end, so that 128 * we can safely call resettable_change_parent() below. 129 */ 130 object_ref(OBJECT(dev)); 131 bus_remove_child(dev->parent_bus, dev); 132 } 133 dev->parent_bus = bus; 134 object_ref(OBJECT(bus)); 135 bus_add_child(bus, dev); 136 if (dev->realized) { 137 resettable_change_parent(OBJECT(dev), OBJECT(bus), 138 OBJECT(old_parent_bus)); 139 } 140 if (old_parent_bus) { 141 object_unref(OBJECT(old_parent_bus)); 142 object_unref(OBJECT(dev)); 143 } 144 return true; 145 } 146 147 DeviceState *qdev_new(const char *name) 148 { 149 ObjectClass *oc = object_class_by_name(name); 150 #ifdef CONFIG_MODULES 151 if (!oc) { 152 int rv = module_load_qom(name, &error_fatal); 153 if (rv > 0) { 154 oc = object_class_by_name(name); 155 } else { 156 error_report("could not find a module for type '%s'", name); 157 exit(1); 158 } 159 } 160 #endif 161 if (!oc) { 162 error_report("unknown type '%s'", name); 163 abort(); 164 } 165 return DEVICE(object_new(name)); 166 } 167 168 DeviceState *qdev_try_new(const char *name) 169 { 170 if (!module_object_class_by_name(name)) { 171 return NULL; 172 } 173 return DEVICE(object_new(name)); 174 } 175 176 static QTAILQ_HEAD(, DeviceListener) device_listeners 177 = QTAILQ_HEAD_INITIALIZER(device_listeners); 178 179 enum ListenerDirection { Forward, Reverse }; 180 181 #define DEVICE_LISTENER_CALL(_callback, _direction, _args...) \ 182 do { \ 183 DeviceListener *_listener; \ 184 \ 185 switch (_direction) { \ 186 case Forward: \ 187 QTAILQ_FOREACH(_listener, &device_listeners, link) { \ 188 if (_listener->_callback) { \ 189 _listener->_callback(_listener, ##_args); \ 190 } \ 191 } \ 192 break; \ 193 case Reverse: \ 194 QTAILQ_FOREACH_REVERSE(_listener, &device_listeners, \ 195 link) { \ 196 if (_listener->_callback) { \ 197 _listener->_callback(_listener, ##_args); \ 198 } \ 199 } \ 200 break; \ 201 default: \ 202 abort(); \ 203 } \ 204 } while (0) 205 206 static int device_listener_add(DeviceState *dev, void *opaque) 207 { 208 DEVICE_LISTENER_CALL(realize, Forward, dev); 209 210 return 0; 211 } 212 213 void device_listener_register(DeviceListener *listener) 214 { 215 QTAILQ_INSERT_TAIL(&device_listeners, listener, link); 216 217 qbus_walk_children(sysbus_get_default(), NULL, NULL, device_listener_add, 218 NULL, NULL); 219 } 220 221 void device_listener_unregister(DeviceListener *listener) 222 { 223 QTAILQ_REMOVE(&device_listeners, listener, link); 224 } 225 226 bool qdev_should_hide_device(const QDict *opts, bool from_json, Error **errp) 227 { 228 ERRP_GUARD(); 229 DeviceListener *listener; 230 231 QTAILQ_FOREACH(listener, &device_listeners, link) { 232 if (listener->hide_device) { 233 if (listener->hide_device(listener, opts, from_json, errp)) { 234 return true; 235 } else if (*errp) { 236 return false; 237 } 238 } 239 } 240 241 return false; 242 } 243 244 void qdev_set_legacy_instance_id(DeviceState *dev, int alias_id, 245 int required_for_version) 246 { 247 assert(!dev->realized); 248 dev->instance_id_alias = alias_id; 249 dev->alias_required_for_version = required_for_version; 250 } 251 252 void device_cold_reset(DeviceState *dev) 253 { 254 resettable_reset(OBJECT(dev), RESET_TYPE_COLD); 255 } 256 257 bool device_is_in_reset(DeviceState *dev) 258 { 259 return resettable_is_in_reset(OBJECT(dev)); 260 } 261 262 static ResettableState *device_get_reset_state(Object *obj) 263 { 264 DeviceState *dev = DEVICE(obj); 265 return &dev->reset; 266 } 267 268 static void device_reset_child_foreach(Object *obj, ResettableChildCallback cb, 269 void *opaque, ResetType type) 270 { 271 DeviceState *dev = DEVICE(obj); 272 BusState *bus; 273 274 QLIST_FOREACH(bus, &dev->child_bus, sibling) { 275 cb(OBJECT(bus), opaque, type); 276 } 277 } 278 279 bool qdev_realize(DeviceState *dev, BusState *bus, Error **errp) 280 { 281 assert(!dev->realized && !dev->parent_bus); 282 283 if (bus) { 284 if (!qdev_set_parent_bus(dev, bus, errp)) { 285 return false; 286 } 287 } else { 288 assert(!DEVICE_GET_CLASS(dev)->bus_type); 289 } 290 291 return object_property_set_bool(OBJECT(dev), "realized", true, errp); 292 } 293 294 bool qdev_realize_and_unref(DeviceState *dev, BusState *bus, Error **errp) 295 { 296 bool ret; 297 298 ret = qdev_realize(dev, bus, errp); 299 object_unref(OBJECT(dev)); 300 return ret; 301 } 302 303 void qdev_unrealize(DeviceState *dev) 304 { 305 object_property_set_bool(OBJECT(dev), "realized", false, &error_abort); 306 } 307 308 static int qdev_assert_realized_properly_cb(Object *obj, void *opaque) 309 { 310 DeviceState *dev = DEVICE(object_dynamic_cast(obj, TYPE_DEVICE)); 311 DeviceClass *dc; 312 313 if (dev) { 314 dc = DEVICE_GET_CLASS(dev); 315 assert(dev->realized); 316 assert(dev->parent_bus || !dc->bus_type); 317 } 318 return 0; 319 } 320 321 void qdev_assert_realized_properly(void) 322 { 323 object_child_foreach_recursive(object_get_root(), 324 qdev_assert_realized_properly_cb, NULL); 325 } 326 327 bool qdev_machine_modified(void) 328 { 329 return qdev_hot_added || qdev_hot_removed; 330 } 331 332 BusState *qdev_get_parent_bus(const DeviceState *dev) 333 { 334 return dev->parent_bus; 335 } 336 337 BusState *qdev_get_child_bus(DeviceState *dev, const char *name) 338 { 339 BusState *bus; 340 Object *child = object_resolve_path_component(OBJECT(dev), name); 341 342 bus = (BusState *)object_dynamic_cast(child, TYPE_BUS); 343 if (bus) { 344 return bus; 345 } 346 347 QLIST_FOREACH(bus, &dev->child_bus, sibling) { 348 if (strcmp(name, bus->name) == 0) { 349 return bus; 350 } 351 } 352 return NULL; 353 } 354 355 int qdev_walk_children(DeviceState *dev, 356 qdev_walkerfn *pre_devfn, qbus_walkerfn *pre_busfn, 357 qdev_walkerfn *post_devfn, qbus_walkerfn *post_busfn, 358 void *opaque) 359 { 360 BusState *bus; 361 int err; 362 363 if (pre_devfn) { 364 err = pre_devfn(dev, opaque); 365 if (err) { 366 return err; 367 } 368 } 369 370 QLIST_FOREACH(bus, &dev->child_bus, sibling) { 371 err = qbus_walk_children(bus, pre_devfn, pre_busfn, 372 post_devfn, post_busfn, opaque); 373 if (err < 0) { 374 return err; 375 } 376 } 377 378 if (post_devfn) { 379 err = post_devfn(dev, opaque); 380 if (err) { 381 return err; 382 } 383 } 384 385 return 0; 386 } 387 388 DeviceState *qdev_find_recursive(BusState *bus, const char *id) 389 { 390 BusChild *kid; 391 DeviceState *ret; 392 BusState *child; 393 394 WITH_RCU_READ_LOCK_GUARD() { 395 QTAILQ_FOREACH_RCU(kid, &bus->children, sibling) { 396 DeviceState *dev = kid->child; 397 398 if (dev->id && strcmp(dev->id, id) == 0) { 399 return dev; 400 } 401 402 QLIST_FOREACH(child, &dev->child_bus, sibling) { 403 ret = qdev_find_recursive(child, id); 404 if (ret) { 405 return ret; 406 } 407 } 408 } 409 } 410 return NULL; 411 } 412 413 char *qdev_get_dev_path(DeviceState *dev) 414 { 415 BusClass *bc; 416 417 if (!dev || !dev->parent_bus) { 418 return NULL; 419 } 420 421 bc = BUS_GET_CLASS(dev->parent_bus); 422 if (bc->get_dev_path) { 423 return bc->get_dev_path(dev); 424 } 425 426 return NULL; 427 } 428 429 void qdev_add_unplug_blocker(DeviceState *dev, Error *reason) 430 { 431 dev->unplug_blockers = g_slist_prepend(dev->unplug_blockers, reason); 432 } 433 434 void qdev_del_unplug_blocker(DeviceState *dev, Error *reason) 435 { 436 dev->unplug_blockers = g_slist_remove(dev->unplug_blockers, reason); 437 } 438 439 bool qdev_unplug_blocked(DeviceState *dev, Error **errp) 440 { 441 if (dev->unplug_blockers) { 442 error_propagate(errp, error_copy(dev->unplug_blockers->data)); 443 return true; 444 } 445 446 return false; 447 } 448 449 static bool device_get_realized(Object *obj, Error **errp) 450 { 451 DeviceState *dev = DEVICE(obj); 452 return dev->realized; 453 } 454 455 static bool check_only_migratable(Object *obj, Error **errp) 456 { 457 DeviceClass *dc = DEVICE_GET_CLASS(obj); 458 459 if (!vmstate_check_only_migratable(dc->vmsd)) { 460 error_setg(errp, "Device %s is not migratable, but " 461 "--only-migratable was specified", 462 object_get_typename(obj)); 463 return false; 464 } 465 466 return true; 467 } 468 469 static void device_set_realized(Object *obj, bool value, Error **errp) 470 { 471 DeviceState *dev = DEVICE(obj); 472 DeviceClass *dc = DEVICE_GET_CLASS(dev); 473 HotplugHandler *hotplug_ctrl; 474 BusState *bus; 475 NamedClockList *ncl; 476 Error *local_err = NULL; 477 bool unattached_parent = false; 478 static int unattached_count; 479 480 if (dev->hotplugged && !dc->hotpluggable) { 481 error_setg(errp, "Device '%s' does not support hotplugging", 482 object_get_typename(obj)); 483 return; 484 } 485 486 if (value && !dev->realized) { 487 if (!check_only_migratable(obj, errp)) { 488 goto fail; 489 } 490 491 if (!obj->parent) { 492 gchar *name = g_strdup_printf("device[%d]", unattached_count++); 493 494 object_property_add_child(container_get(qdev_get_machine(), 495 "/unattached"), 496 name, obj); 497 unattached_parent = true; 498 g_free(name); 499 } 500 501 hotplug_ctrl = qdev_get_hotplug_handler(dev); 502 if (hotplug_ctrl) { 503 hotplug_handler_pre_plug(hotplug_ctrl, dev, &local_err); 504 if (local_err != NULL) { 505 goto fail; 506 } 507 } 508 509 if (dc->realize) { 510 dc->realize(dev, &local_err); 511 if (local_err != NULL) { 512 goto fail; 513 } 514 } 515 516 DEVICE_LISTENER_CALL(realize, Forward, dev); 517 518 /* 519 * always free/re-initialize here since the value cannot be cleaned up 520 * in device_unrealize due to its usage later on in the unplug path 521 */ 522 g_free(dev->canonical_path); 523 dev->canonical_path = object_get_canonical_path(OBJECT(dev)); 524 QLIST_FOREACH(ncl, &dev->clocks, node) { 525 if (ncl->alias) { 526 continue; 527 } else { 528 clock_setup_canonical_path(ncl->clock); 529 } 530 } 531 532 if (qdev_get_vmsd(dev)) { 533 if (vmstate_register_with_alias_id(VMSTATE_IF(dev), 534 VMSTATE_INSTANCE_ID_ANY, 535 qdev_get_vmsd(dev), dev, 536 dev->instance_id_alias, 537 dev->alias_required_for_version, 538 &local_err) < 0) { 539 goto post_realize_fail; 540 } 541 } 542 543 /* 544 * Clear the reset state, in case the object was previously unrealized 545 * with a dirty state. 546 */ 547 resettable_state_clear(&dev->reset); 548 549 QLIST_FOREACH(bus, &dev->child_bus, sibling) { 550 if (!qbus_realize(bus, errp)) { 551 goto child_realize_fail; 552 } 553 } 554 if (dev->hotplugged) { 555 /* 556 * Reset the device, as well as its subtree which, at this point, 557 * should be realized too. 558 */ 559 resettable_assert_reset(OBJECT(dev), RESET_TYPE_COLD); 560 resettable_change_parent(OBJECT(dev), OBJECT(dev->parent_bus), 561 NULL); 562 resettable_release_reset(OBJECT(dev), RESET_TYPE_COLD); 563 } 564 dev->pending_deleted_event = false; 565 566 if (hotplug_ctrl) { 567 hotplug_handler_plug(hotplug_ctrl, dev, &local_err); 568 if (local_err != NULL) { 569 goto child_realize_fail; 570 } 571 } 572 573 qatomic_store_release(&dev->realized, value); 574 575 } else if (!value && dev->realized) { 576 577 /* 578 * Change the value so that any concurrent users are aware 579 * that the device is going to be unrealized 580 * 581 * TODO: change .realized property to enum that states 582 * each phase of the device realization/unrealization 583 */ 584 585 qatomic_set(&dev->realized, value); 586 /* 587 * Ensure that concurrent users see this update prior to 588 * any other changes done by unrealize. 589 */ 590 smp_wmb(); 591 592 QLIST_FOREACH(bus, &dev->child_bus, sibling) { 593 qbus_unrealize(bus); 594 } 595 if (qdev_get_vmsd(dev)) { 596 vmstate_unregister(VMSTATE_IF(dev), qdev_get_vmsd(dev), dev); 597 } 598 if (dc->unrealize) { 599 dc->unrealize(dev); 600 } 601 dev->pending_deleted_event = true; 602 DEVICE_LISTENER_CALL(unrealize, Reverse, dev); 603 } 604 605 assert(local_err == NULL); 606 return; 607 608 child_realize_fail: 609 QLIST_FOREACH(bus, &dev->child_bus, sibling) { 610 qbus_unrealize(bus); 611 } 612 613 if (qdev_get_vmsd(dev)) { 614 vmstate_unregister(VMSTATE_IF(dev), qdev_get_vmsd(dev), dev); 615 } 616 617 post_realize_fail: 618 g_free(dev->canonical_path); 619 dev->canonical_path = NULL; 620 if (dc->unrealize) { 621 dc->unrealize(dev); 622 } 623 624 fail: 625 error_propagate(errp, local_err); 626 if (unattached_parent) { 627 /* 628 * Beware, this doesn't just revert 629 * object_property_add_child(), it also runs bus_remove()! 630 */ 631 object_unparent(OBJECT(dev)); 632 unattached_count--; 633 } 634 } 635 636 static bool device_get_hotpluggable(Object *obj, Error **errp) 637 { 638 DeviceClass *dc = DEVICE_GET_CLASS(obj); 639 DeviceState *dev = DEVICE(obj); 640 641 return dc->hotpluggable && (dev->parent_bus == NULL || 642 qbus_is_hotpluggable(dev->parent_bus)); 643 } 644 645 static bool device_get_hotplugged(Object *obj, Error **errp) 646 { 647 DeviceState *dev = DEVICE(obj); 648 649 return dev->hotplugged; 650 } 651 652 static void device_initfn(Object *obj) 653 { 654 DeviceState *dev = DEVICE(obj); 655 656 if (phase_check(PHASE_MACHINE_READY)) { 657 dev->hotplugged = 1; 658 qdev_hot_added = true; 659 } 660 661 dev->instance_id_alias = -1; 662 dev->realized = false; 663 dev->allow_unplug_during_migration = false; 664 665 QLIST_INIT(&dev->gpios); 666 QLIST_INIT(&dev->clocks); 667 } 668 669 static void device_post_init(Object *obj) 670 { 671 /* 672 * Note: ordered so that the user's global properties take 673 * precedence. 674 */ 675 object_apply_compat_props(obj); 676 qdev_prop_set_globals(DEVICE(obj)); 677 } 678 679 /* Unlink device from bus and free the structure. */ 680 static void device_finalize(Object *obj) 681 { 682 NamedGPIOList *ngl, *next; 683 684 DeviceState *dev = DEVICE(obj); 685 686 g_assert(!dev->unplug_blockers); 687 688 QLIST_FOREACH_SAFE(ngl, &dev->gpios, node, next) { 689 QLIST_REMOVE(ngl, node); 690 qemu_free_irqs(ngl->in, ngl->num_in); 691 g_free(ngl->name); 692 g_free(ngl); 693 /* ngl->out irqs are owned by the other end and should not be freed 694 * here 695 */ 696 } 697 698 qdev_finalize_clocklist(dev); 699 700 /* Only send event if the device had been completely realized */ 701 if (dev->pending_deleted_event) { 702 g_assert(dev->canonical_path); 703 704 qapi_event_send_device_deleted(dev->id, dev->canonical_path); 705 g_free(dev->canonical_path); 706 dev->canonical_path = NULL; 707 } 708 709 qobject_unref(dev->opts); 710 g_free(dev->id); 711 } 712 713 static void device_class_base_init(ObjectClass *class, void *data) 714 { 715 DeviceClass *klass = DEVICE_CLASS(class); 716 717 /* We explicitly look up properties in the superclasses, 718 * so do not propagate them to the subclasses. 719 */ 720 klass->props_ = NULL; 721 } 722 723 static void device_unparent(Object *obj) 724 { 725 DeviceState *dev = DEVICE(obj); 726 BusState *bus; 727 728 if (dev->realized) { 729 qdev_unrealize(dev); 730 } 731 while (dev->num_child_bus) { 732 bus = QLIST_FIRST(&dev->child_bus); 733 object_unparent(OBJECT(bus)); 734 } 735 if (dev->parent_bus) { 736 bus_remove_child(dev->parent_bus, dev); 737 object_unref(OBJECT(dev->parent_bus)); 738 dev->parent_bus = NULL; 739 } 740 } 741 742 static char * 743 device_vmstate_if_get_id(VMStateIf *obj) 744 { 745 DeviceState *dev = DEVICE(obj); 746 747 return qdev_get_dev_path(dev); 748 } 749 750 static void device_class_init(ObjectClass *class, void *data) 751 { 752 DeviceClass *dc = DEVICE_CLASS(class); 753 VMStateIfClass *vc = VMSTATE_IF_CLASS(class); 754 ResettableClass *rc = RESETTABLE_CLASS(class); 755 756 class->unparent = device_unparent; 757 758 /* by default all devices were considered as hotpluggable, 759 * so with intent to check it in generic qdev_unplug() / 760 * device_set_realized() functions make every device 761 * hotpluggable. Devices that shouldn't be hotpluggable, 762 * should override it in their class_init() 763 */ 764 dc->hotpluggable = true; 765 dc->user_creatable = true; 766 vc->get_id = device_vmstate_if_get_id; 767 rc->get_state = device_get_reset_state; 768 rc->child_foreach = device_reset_child_foreach; 769 770 /* 771 * A NULL legacy_reset implies a three-phase reset device. Devices can 772 * only be reset using three-phase aware mechanisms, but we still support 773 * for transitional purposes leaf classes which set the old legacy_reset 774 * method via device_class_set_legacy_reset(). 775 */ 776 dc->legacy_reset = NULL; 777 778 object_class_property_add_bool(class, "realized", 779 device_get_realized, device_set_realized); 780 object_class_property_add_bool(class, "hotpluggable", 781 device_get_hotpluggable, NULL); 782 object_class_property_add_bool(class, "hotplugged", 783 device_get_hotplugged, NULL); 784 object_class_property_add_link(class, "parent_bus", TYPE_BUS, 785 offsetof(DeviceState, parent_bus), NULL, 0); 786 } 787 788 static void do_legacy_reset(Object *obj, ResetType type) 789 { 790 DeviceClass *dc = DEVICE_GET_CLASS(obj); 791 792 dc->legacy_reset(DEVICE(obj)); 793 } 794 795 void device_class_set_legacy_reset(DeviceClass *dc, DeviceReset dev_reset) 796 { 797 /* 798 * A legacy DeviceClass::reset has identical semantics to the 799 * three-phase "hold" method, with no "enter" or "exit" 800 * behaviour. Classes that use this legacy function must be leaf 801 * classes that do not chain up to their parent class reset. 802 * There is no mechanism for resetting a device that does not 803 * use the three-phase APIs, so the only place which calls 804 * the legacy_reset hook is do_legacy_reset(). 805 */ 806 ResettableClass *rc = RESETTABLE_CLASS(dc); 807 808 rc->phases.enter = NULL; 809 rc->phases.hold = do_legacy_reset; 810 rc->phases.exit = NULL; 811 dc->legacy_reset = dev_reset; 812 } 813 814 void device_class_set_parent_realize(DeviceClass *dc, 815 DeviceRealize dev_realize, 816 DeviceRealize *parent_realize) 817 { 818 *parent_realize = dc->realize; 819 dc->realize = dev_realize; 820 } 821 822 void device_class_set_parent_unrealize(DeviceClass *dc, 823 DeviceUnrealize dev_unrealize, 824 DeviceUnrealize *parent_unrealize) 825 { 826 *parent_unrealize = dc->unrealize; 827 dc->unrealize = dev_unrealize; 828 } 829 830 Object *qdev_get_machine(void) 831 { 832 static Object *dev; 833 834 if (dev == NULL) { 835 dev = container_get(object_get_root(), "/machine"); 836 } 837 838 return dev; 839 } 840 841 char *qdev_get_human_name(DeviceState *dev) 842 { 843 g_assert(dev != NULL); 844 845 return dev->id ? 846 g_strdup(dev->id) : object_get_canonical_path(OBJECT(dev)); 847 } 848 849 static MachineInitPhase machine_phase; 850 851 bool phase_check(MachineInitPhase phase) 852 { 853 return machine_phase >= phase; 854 } 855 856 void phase_advance(MachineInitPhase phase) 857 { 858 assert(machine_phase == phase - 1); 859 machine_phase = phase; 860 } 861 862 static const TypeInfo device_type_info = { 863 .name = TYPE_DEVICE, 864 .parent = TYPE_OBJECT, 865 .instance_size = sizeof(DeviceState), 866 .instance_init = device_initfn, 867 .instance_post_init = device_post_init, 868 .instance_finalize = device_finalize, 869 .class_base_init = device_class_base_init, 870 .class_init = device_class_init, 871 .abstract = true, 872 .class_size = sizeof(DeviceClass), 873 .interfaces = (InterfaceInfo[]) { 874 { TYPE_VMSTATE_IF }, 875 { TYPE_RESETTABLE_INTERFACE }, 876 { } 877 } 878 }; 879 880 static void qdev_register_types(void) 881 { 882 type_register_static(&device_type_info); 883 } 884 885 type_init(qdev_register_types) 886