xref: /openbmc/qemu/hw/core/qdev.c (revision 0ea0538f)
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