xref: /openbmc/qemu/qom/object.c (revision 8917c3bd)
1 /*
2  * QEMU Object Model
3  *
4  * Copyright IBM, Corp. 2011
5  *
6  * Authors:
7  *  Anthony Liguori   <aliguori@us.ibm.com>
8  *
9  * This work is licensed under the terms of the GNU GPL, version 2 or later.
10  * See the COPYING file in the top-level directory.
11  */
12 
13 #include "qom/object.h"
14 #include "qemu-common.h"
15 #include "qapi/visitor.h"
16 #include "qapi/string-input-visitor.h"
17 #include "qapi/string-output-visitor.h"
18 #include "qapi/qmp/qerror.h"
19 
20 /* TODO: replace QObject with a simpler visitor to avoid a dependency
21  * of the QOM core on QObject?  */
22 #include "qom/qom-qobject.h"
23 #include "qapi/qmp/qobject.h"
24 #include "qapi/qmp/qbool.h"
25 #include "qapi/qmp/qint.h"
26 #include "qapi/qmp/qstring.h"
27 
28 #define MAX_INTERFACES 32
29 
30 typedef struct InterfaceImpl InterfaceImpl;
31 typedef struct TypeImpl TypeImpl;
32 
33 struct InterfaceImpl
34 {
35     const char *typename;
36 };
37 
38 struct TypeImpl
39 {
40     const char *name;
41 
42     size_t class_size;
43 
44     size_t instance_size;
45 
46     void (*class_init)(ObjectClass *klass, void *data);
47     void (*class_base_init)(ObjectClass *klass, void *data);
48     void (*class_finalize)(ObjectClass *klass, void *data);
49 
50     void *class_data;
51 
52     void (*instance_init)(Object *obj);
53     void (*instance_finalize)(Object *obj);
54 
55     bool abstract;
56 
57     const char *parent;
58     TypeImpl *parent_type;
59 
60     ObjectClass *class;
61 
62     int num_interfaces;
63     InterfaceImpl interfaces[MAX_INTERFACES];
64 };
65 
66 static Type type_interface;
67 
68 static GHashTable *type_table_get(void)
69 {
70     static GHashTable *type_table;
71 
72     if (type_table == NULL) {
73         type_table = g_hash_table_new(g_str_hash, g_str_equal);
74     }
75 
76     return type_table;
77 }
78 
79 static void type_table_add(TypeImpl *ti)
80 {
81     g_hash_table_insert(type_table_get(), (void *)ti->name, ti);
82 }
83 
84 static TypeImpl *type_table_lookup(const char *name)
85 {
86     return g_hash_table_lookup(type_table_get(), name);
87 }
88 
89 static TypeImpl *type_register_internal(const TypeInfo *info)
90 {
91     TypeImpl *ti = g_malloc0(sizeof(*ti));
92     int i;
93 
94     g_assert(info->name != NULL);
95 
96     if (type_table_lookup(info->name) != NULL) {
97         fprintf(stderr, "Registering `%s' which already exists\n", info->name);
98         abort();
99     }
100 
101     ti->name = g_strdup(info->name);
102     ti->parent = g_strdup(info->parent);
103 
104     ti->class_size = info->class_size;
105     ti->instance_size = info->instance_size;
106 
107     ti->class_init = info->class_init;
108     ti->class_base_init = info->class_base_init;
109     ti->class_finalize = info->class_finalize;
110     ti->class_data = info->class_data;
111 
112     ti->instance_init = info->instance_init;
113     ti->instance_finalize = info->instance_finalize;
114 
115     ti->abstract = info->abstract;
116 
117     for (i = 0; info->interfaces && info->interfaces[i].type; i++) {
118         ti->interfaces[i].typename = g_strdup(info->interfaces[i].type);
119     }
120     ti->num_interfaces = i;
121 
122     type_table_add(ti);
123 
124     return ti;
125 }
126 
127 TypeImpl *type_register(const TypeInfo *info)
128 {
129     assert(info->parent);
130     return type_register_internal(info);
131 }
132 
133 TypeImpl *type_register_static(const TypeInfo *info)
134 {
135     return type_register(info);
136 }
137 
138 static TypeImpl *type_get_by_name(const char *name)
139 {
140     if (name == NULL) {
141         return NULL;
142     }
143 
144     return type_table_lookup(name);
145 }
146 
147 static TypeImpl *type_get_parent(TypeImpl *type)
148 {
149     if (!type->parent_type && type->parent) {
150         type->parent_type = type_get_by_name(type->parent);
151         g_assert(type->parent_type != NULL);
152     }
153 
154     return type->parent_type;
155 }
156 
157 static bool type_has_parent(TypeImpl *type)
158 {
159     return (type->parent != NULL);
160 }
161 
162 static size_t type_class_get_size(TypeImpl *ti)
163 {
164     if (ti->class_size) {
165         return ti->class_size;
166     }
167 
168     if (type_has_parent(ti)) {
169         return type_class_get_size(type_get_parent(ti));
170     }
171 
172     return sizeof(ObjectClass);
173 }
174 
175 static size_t type_object_get_size(TypeImpl *ti)
176 {
177     if (ti->instance_size) {
178         return ti->instance_size;
179     }
180 
181     if (type_has_parent(ti)) {
182         return type_object_get_size(type_get_parent(ti));
183     }
184 
185     return 0;
186 }
187 
188 static bool type_is_ancestor(TypeImpl *type, TypeImpl *target_type)
189 {
190     assert(target_type);
191 
192     /* Check if typename is a direct ancestor of type */
193     while (type) {
194         if (type == target_type) {
195             return true;
196         }
197 
198         type = type_get_parent(type);
199     }
200 
201     return false;
202 }
203 
204 static void type_initialize(TypeImpl *ti);
205 
206 static void type_initialize_interface(TypeImpl *ti, const char *parent)
207 {
208     InterfaceClass *new_iface;
209     TypeInfo info = { };
210     TypeImpl *iface_impl;
211 
212     info.parent = parent;
213     info.name = g_strdup_printf("%s::%s", ti->name, info.parent);
214     info.abstract = true;
215 
216     iface_impl = type_register(&info);
217     type_initialize(iface_impl);
218     g_free((char *)info.name);
219 
220     new_iface = (InterfaceClass *)iface_impl->class;
221     new_iface->concrete_class = ti->class;
222 
223     ti->class->interfaces = g_slist_append(ti->class->interfaces,
224                                            iface_impl->class);
225 }
226 
227 static void type_initialize(TypeImpl *ti)
228 {
229     TypeImpl *parent;
230 
231     if (ti->class) {
232         return;
233     }
234 
235     ti->class_size = type_class_get_size(ti);
236     ti->instance_size = type_object_get_size(ti);
237 
238     ti->class = g_malloc0(ti->class_size);
239 
240     parent = type_get_parent(ti);
241     if (parent) {
242         type_initialize(parent);
243         GSList *e;
244         int i;
245 
246         g_assert(parent->class_size <= ti->class_size);
247         memcpy(ti->class, parent->class, parent->class_size);
248 
249         for (e = parent->class->interfaces; e; e = e->next) {
250             ObjectClass *iface = e->data;
251             type_initialize_interface(ti, object_class_get_name(iface));
252         }
253 
254         for (i = 0; i < ti->num_interfaces; i++) {
255             TypeImpl *t = type_get_by_name(ti->interfaces[i].typename);
256             for (e = ti->class->interfaces; e; e = e->next) {
257                 TypeImpl *target_type = OBJECT_CLASS(e->data)->type;
258 
259                 if (type_is_ancestor(target_type, t)) {
260                     break;
261                 }
262             }
263 
264             if (e) {
265                 continue;
266             }
267 
268             type_initialize_interface(ti, ti->interfaces[i].typename);
269         }
270     }
271 
272     ti->class->type = ti;
273 
274     while (parent) {
275         if (parent->class_base_init) {
276             parent->class_base_init(ti->class, ti->class_data);
277         }
278         parent = type_get_parent(parent);
279     }
280 
281     if (ti->class_init) {
282         ti->class_init(ti->class, ti->class_data);
283     }
284 
285 
286 }
287 
288 static void object_init_with_type(Object *obj, TypeImpl *ti)
289 {
290     if (type_has_parent(ti)) {
291         object_init_with_type(obj, type_get_parent(ti));
292     }
293 
294     if (ti->instance_init) {
295         ti->instance_init(obj);
296     }
297 }
298 
299 void object_initialize_with_type(void *data, TypeImpl *type)
300 {
301     Object *obj = data;
302 
303     g_assert(type != NULL);
304     type_initialize(type);
305 
306     g_assert(type->instance_size >= sizeof(Object));
307     g_assert(type->abstract == false);
308 
309     memset(obj, 0, type->instance_size);
310     obj->class = type->class;
311     object_ref(obj);
312     QTAILQ_INIT(&obj->properties);
313     object_init_with_type(obj, type);
314 }
315 
316 void object_initialize(void *data, const char *typename)
317 {
318     TypeImpl *type = type_get_by_name(typename);
319 
320     object_initialize_with_type(data, type);
321 }
322 
323 static inline bool object_property_is_child(ObjectProperty *prop)
324 {
325     return strstart(prop->type, "child<", NULL);
326 }
327 
328 static inline bool object_property_is_link(ObjectProperty *prop)
329 {
330     return strstart(prop->type, "link<", NULL);
331 }
332 
333 static void object_property_del_all(Object *obj)
334 {
335     while (!QTAILQ_EMPTY(&obj->properties)) {
336         ObjectProperty *prop = QTAILQ_FIRST(&obj->properties);
337 
338         QTAILQ_REMOVE(&obj->properties, prop, node);
339 
340         if (prop->release) {
341             prop->release(obj, prop->name, prop->opaque);
342         }
343 
344         g_free(prop->name);
345         g_free(prop->type);
346         g_free(prop);
347     }
348 }
349 
350 static void object_property_del_child(Object *obj, Object *child, Error **errp)
351 {
352     ObjectProperty *prop;
353 
354     QTAILQ_FOREACH(prop, &obj->properties, node) {
355         if (object_property_is_child(prop) && prop->opaque == child) {
356             object_property_del(obj, prop->name, errp);
357             break;
358         }
359     }
360 }
361 
362 void object_unparent(Object *obj)
363 {
364     object_ref(obj);
365     if (obj->parent) {
366         object_property_del_child(obj->parent, obj, NULL);
367     }
368     if (obj->class->unparent) {
369         (obj->class->unparent)(obj);
370     }
371     object_unref(obj);
372 }
373 
374 static void object_deinit(Object *obj, TypeImpl *type)
375 {
376     if (type->instance_finalize) {
377         type->instance_finalize(obj);
378     }
379 
380     if (type_has_parent(type)) {
381         object_deinit(obj, type_get_parent(type));
382     }
383 }
384 
385 static void object_finalize(void *data)
386 {
387     Object *obj = data;
388     TypeImpl *ti = obj->class->type;
389 
390     object_deinit(obj, ti);
391     object_property_del_all(obj);
392 
393     g_assert(obj->ref == 0);
394     if (obj->free) {
395         obj->free(obj);
396     }
397 }
398 
399 Object *object_new_with_type(Type type)
400 {
401     Object *obj;
402 
403     g_assert(type != NULL);
404     type_initialize(type);
405 
406     obj = g_malloc(type->instance_size);
407     object_initialize_with_type(obj, type);
408     obj->free = g_free;
409 
410     return obj;
411 }
412 
413 Object *object_new(const char *typename)
414 {
415     TypeImpl *ti = type_get_by_name(typename);
416 
417     return object_new_with_type(ti);
418 }
419 
420 Object *object_dynamic_cast(Object *obj, const char *typename)
421 {
422     if (obj && object_class_dynamic_cast(object_get_class(obj), typename)) {
423         return obj;
424     }
425 
426     return NULL;
427 }
428 
429 Object *object_dynamic_cast_assert(Object *obj, const char *typename)
430 {
431     Object *inst;
432 
433     inst = object_dynamic_cast(obj, typename);
434 
435     if (!inst && obj) {
436         fprintf(stderr, "Object %p is not an instance of type %s\n",
437                 obj, typename);
438         abort();
439     }
440 
441     return inst;
442 }
443 
444 ObjectClass *object_class_dynamic_cast(ObjectClass *class,
445                                        const char *typename)
446 {
447     TypeImpl *target_type = type_get_by_name(typename);
448     TypeImpl *type = class->type;
449     ObjectClass *ret = NULL;
450 
451     if (type->num_interfaces && type_is_ancestor(target_type, type_interface)) {
452         int found = 0;
453         GSList *i;
454 
455         for (i = class->interfaces; i; i = i->next) {
456             ObjectClass *target_class = i->data;
457 
458             if (type_is_ancestor(target_class->type, target_type)) {
459                 ret = target_class;
460                 found++;
461             }
462          }
463 
464         /* The match was ambiguous, don't allow a cast */
465         if (found > 1) {
466             ret = NULL;
467         }
468     } else if (type_is_ancestor(type, target_type)) {
469         ret = class;
470     }
471 
472     return ret;
473 }
474 
475 ObjectClass *object_class_dynamic_cast_assert(ObjectClass *class,
476                                               const char *typename)
477 {
478     ObjectClass *ret = object_class_dynamic_cast(class, typename);
479 
480     if (!ret) {
481         fprintf(stderr, "Object %p is not an instance of type %s\n",
482                 class, typename);
483         abort();
484     }
485 
486     return ret;
487 }
488 
489 const char *object_get_typename(Object *obj)
490 {
491     return obj->class->type->name;
492 }
493 
494 ObjectClass *object_get_class(Object *obj)
495 {
496     return obj->class;
497 }
498 
499 bool object_class_is_abstract(ObjectClass *klass)
500 {
501     return klass->type->abstract;
502 }
503 
504 const char *object_class_get_name(ObjectClass *klass)
505 {
506     return klass->type->name;
507 }
508 
509 ObjectClass *object_class_by_name(const char *typename)
510 {
511     TypeImpl *type = type_get_by_name(typename);
512 
513     if (!type) {
514         return NULL;
515     }
516 
517     type_initialize(type);
518 
519     return type->class;
520 }
521 
522 ObjectClass *object_class_get_parent(ObjectClass *class)
523 {
524     TypeImpl *type = type_get_parent(class->type);
525 
526     if (!type) {
527         return NULL;
528     }
529 
530     type_initialize(type);
531 
532     return type->class;
533 }
534 
535 typedef struct OCFData
536 {
537     void (*fn)(ObjectClass *klass, void *opaque);
538     const char *implements_type;
539     bool include_abstract;
540     void *opaque;
541 } OCFData;
542 
543 static void object_class_foreach_tramp(gpointer key, gpointer value,
544                                        gpointer opaque)
545 {
546     OCFData *data = opaque;
547     TypeImpl *type = value;
548     ObjectClass *k;
549 
550     type_initialize(type);
551     k = type->class;
552 
553     if (!data->include_abstract && type->abstract) {
554         return;
555     }
556 
557     if (data->implements_type &&
558         !object_class_dynamic_cast(k, data->implements_type)) {
559         return;
560     }
561 
562     data->fn(k, data->opaque);
563 }
564 
565 void object_class_foreach(void (*fn)(ObjectClass *klass, void *opaque),
566                           const char *implements_type, bool include_abstract,
567                           void *opaque)
568 {
569     OCFData data = { fn, implements_type, include_abstract, opaque };
570 
571     g_hash_table_foreach(type_table_get(), object_class_foreach_tramp, &data);
572 }
573 
574 int object_child_foreach(Object *obj, int (*fn)(Object *child, void *opaque),
575                          void *opaque)
576 {
577     ObjectProperty *prop;
578     int ret = 0;
579 
580     QTAILQ_FOREACH(prop, &obj->properties, node) {
581         if (object_property_is_child(prop)) {
582             ret = fn(prop->opaque, opaque);
583             if (ret != 0) {
584                 break;
585             }
586         }
587     }
588     return ret;
589 }
590 
591 static void object_class_get_list_tramp(ObjectClass *klass, void *opaque)
592 {
593     GSList **list = opaque;
594 
595     *list = g_slist_prepend(*list, klass);
596 }
597 
598 GSList *object_class_get_list(const char *implements_type,
599                               bool include_abstract)
600 {
601     GSList *list = NULL;
602 
603     object_class_foreach(object_class_get_list_tramp,
604                          implements_type, include_abstract, &list);
605     return list;
606 }
607 
608 void object_ref(Object *obj)
609 {
610     obj->ref++;
611 }
612 
613 void object_unref(Object *obj)
614 {
615     g_assert(obj->ref > 0);
616     obj->ref--;
617 
618     /* parent always holds a reference to its children */
619     if (obj->ref == 0) {
620         object_finalize(obj);
621     }
622 }
623 
624 void object_property_add(Object *obj, const char *name, const char *type,
625                          ObjectPropertyAccessor *get,
626                          ObjectPropertyAccessor *set,
627                          ObjectPropertyRelease *release,
628                          void *opaque, Error **errp)
629 {
630     ObjectProperty *prop = g_malloc0(sizeof(*prop));
631 
632     prop->name = g_strdup(name);
633     prop->type = g_strdup(type);
634 
635     prop->get = get;
636     prop->set = set;
637     prop->release = release;
638     prop->opaque = opaque;
639 
640     QTAILQ_INSERT_TAIL(&obj->properties, prop, node);
641 }
642 
643 ObjectProperty *object_property_find(Object *obj, const char *name,
644                                      Error **errp)
645 {
646     ObjectProperty *prop;
647 
648     QTAILQ_FOREACH(prop, &obj->properties, node) {
649         if (strcmp(prop->name, name) == 0) {
650             return prop;
651         }
652     }
653 
654     error_set(errp, QERR_PROPERTY_NOT_FOUND, "", name);
655     return NULL;
656 }
657 
658 void object_property_del(Object *obj, const char *name, Error **errp)
659 {
660     ObjectProperty *prop = object_property_find(obj, name, errp);
661     if (prop == NULL) {
662         return;
663     }
664 
665     if (prop->release) {
666         prop->release(obj, name, prop->opaque);
667     }
668 
669     QTAILQ_REMOVE(&obj->properties, prop, node);
670 
671     g_free(prop->name);
672     g_free(prop->type);
673     g_free(prop);
674 }
675 
676 void object_property_get(Object *obj, Visitor *v, const char *name,
677                          Error **errp)
678 {
679     ObjectProperty *prop = object_property_find(obj, name, errp);
680     if (prop == NULL) {
681         return;
682     }
683 
684     if (!prop->get) {
685         error_set(errp, QERR_PERMISSION_DENIED);
686     } else {
687         prop->get(obj, v, prop->opaque, name, errp);
688     }
689 }
690 
691 void object_property_set(Object *obj, Visitor *v, const char *name,
692                          Error **errp)
693 {
694     ObjectProperty *prop = object_property_find(obj, name, errp);
695     if (prop == NULL) {
696         return;
697     }
698 
699     if (!prop->set) {
700         error_set(errp, QERR_PERMISSION_DENIED);
701     } else {
702         prop->set(obj, v, prop->opaque, name, errp);
703     }
704 }
705 
706 void object_property_set_str(Object *obj, const char *value,
707                              const char *name, Error **errp)
708 {
709     QString *qstr = qstring_from_str(value);
710     object_property_set_qobject(obj, QOBJECT(qstr), name, errp);
711 
712     QDECREF(qstr);
713 }
714 
715 char *object_property_get_str(Object *obj, const char *name,
716                               Error **errp)
717 {
718     QObject *ret = object_property_get_qobject(obj, name, errp);
719     QString *qstring;
720     char *retval;
721 
722     if (!ret) {
723         return NULL;
724     }
725     qstring = qobject_to_qstring(ret);
726     if (!qstring) {
727         error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, "string");
728         retval = NULL;
729     } else {
730         retval = g_strdup(qstring_get_str(qstring));
731     }
732 
733     QDECREF(qstring);
734     return retval;
735 }
736 
737 void object_property_set_link(Object *obj, Object *value,
738                               const char *name, Error **errp)
739 {
740     object_property_set_str(obj, object_get_canonical_path(value),
741                             name, errp);
742 }
743 
744 Object *object_property_get_link(Object *obj, const char *name,
745                                  Error **errp)
746 {
747     char *str = object_property_get_str(obj, name, errp);
748     Object *target = NULL;
749 
750     if (str && *str) {
751         target = object_resolve_path(str, NULL);
752         if (!target) {
753             error_set(errp, QERR_DEVICE_NOT_FOUND, str);
754         }
755     }
756 
757     g_free(str);
758     return target;
759 }
760 
761 void object_property_set_bool(Object *obj, bool value,
762                               const char *name, Error **errp)
763 {
764     QBool *qbool = qbool_from_int(value);
765     object_property_set_qobject(obj, QOBJECT(qbool), name, errp);
766 
767     QDECREF(qbool);
768 }
769 
770 bool object_property_get_bool(Object *obj, const char *name,
771                               Error **errp)
772 {
773     QObject *ret = object_property_get_qobject(obj, name, errp);
774     QBool *qbool;
775     bool retval;
776 
777     if (!ret) {
778         return false;
779     }
780     qbool = qobject_to_qbool(ret);
781     if (!qbool) {
782         error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, "boolean");
783         retval = false;
784     } else {
785         retval = qbool_get_int(qbool);
786     }
787 
788     QDECREF(qbool);
789     return retval;
790 }
791 
792 void object_property_set_int(Object *obj, int64_t value,
793                              const char *name, Error **errp)
794 {
795     QInt *qint = qint_from_int(value);
796     object_property_set_qobject(obj, QOBJECT(qint), name, errp);
797 
798     QDECREF(qint);
799 }
800 
801 int64_t object_property_get_int(Object *obj, const char *name,
802                                 Error **errp)
803 {
804     QObject *ret = object_property_get_qobject(obj, name, errp);
805     QInt *qint;
806     int64_t retval;
807 
808     if (!ret) {
809         return -1;
810     }
811     qint = qobject_to_qint(ret);
812     if (!qint) {
813         error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, "int");
814         retval = -1;
815     } else {
816         retval = qint_get_int(qint);
817     }
818 
819     QDECREF(qint);
820     return retval;
821 }
822 
823 void object_property_parse(Object *obj, const char *string,
824                            const char *name, Error **errp)
825 {
826     StringInputVisitor *mi;
827     mi = string_input_visitor_new(string);
828     object_property_set(obj, string_input_get_visitor(mi), name, errp);
829 
830     string_input_visitor_cleanup(mi);
831 }
832 
833 char *object_property_print(Object *obj, const char *name,
834                             Error **errp)
835 {
836     StringOutputVisitor *mo;
837     char *string;
838 
839     mo = string_output_visitor_new();
840     object_property_get(obj, string_output_get_visitor(mo), name, errp);
841     string = string_output_get_string(mo);
842     string_output_visitor_cleanup(mo);
843     return string;
844 }
845 
846 const char *object_property_get_type(Object *obj, const char *name, Error **errp)
847 {
848     ObjectProperty *prop = object_property_find(obj, name, errp);
849     if (prop == NULL) {
850         return NULL;
851     }
852 
853     return prop->type;
854 }
855 
856 Object *object_get_root(void)
857 {
858     static Object *root;
859 
860     if (!root) {
861         root = object_new("container");
862     }
863 
864     return root;
865 }
866 
867 static void object_get_child_property(Object *obj, Visitor *v, void *opaque,
868                                       const char *name, Error **errp)
869 {
870     Object *child = opaque;
871     gchar *path;
872 
873     path = object_get_canonical_path(child);
874     visit_type_str(v, &path, name, errp);
875     g_free(path);
876 }
877 
878 static void object_finalize_child_property(Object *obj, const char *name,
879                                            void *opaque)
880 {
881     Object *child = opaque;
882 
883     object_unref(child);
884 }
885 
886 void object_property_add_child(Object *obj, const char *name,
887                                Object *child, Error **errp)
888 {
889     gchar *type;
890 
891     type = g_strdup_printf("child<%s>", object_get_typename(OBJECT(child)));
892 
893     object_property_add(obj, name, type, object_get_child_property,
894                         NULL, object_finalize_child_property, child, errp);
895 
896     object_ref(child);
897     g_assert(child->parent == NULL);
898     child->parent = obj;
899 
900     g_free(type);
901 }
902 
903 static void object_get_link_property(Object *obj, Visitor *v, void *opaque,
904                                      const char *name, Error **errp)
905 {
906     Object **child = opaque;
907     gchar *path;
908 
909     if (*child) {
910         path = object_get_canonical_path(*child);
911         visit_type_str(v, &path, name, errp);
912         g_free(path);
913     } else {
914         path = (gchar *)"";
915         visit_type_str(v, &path, name, errp);
916     }
917 }
918 
919 static void object_set_link_property(Object *obj, Visitor *v, void *opaque,
920                                      const char *name, Error **errp)
921 {
922     Object **child = opaque;
923     Object *old_target;
924     bool ambiguous = false;
925     const char *type;
926     char *path;
927     gchar *target_type;
928 
929     type = object_property_get_type(obj, name, NULL);
930 
931     visit_type_str(v, &path, name, errp);
932 
933     old_target = *child;
934     *child = NULL;
935 
936     if (strcmp(path, "") != 0) {
937         Object *target;
938 
939         /* Go from link<FOO> to FOO.  */
940         target_type = g_strndup(&type[5], strlen(type) - 6);
941         target = object_resolve_path_type(path, target_type, &ambiguous);
942 
943         if (ambiguous) {
944             error_set(errp, QERR_AMBIGUOUS_PATH, path);
945         } else if (target) {
946             object_ref(target);
947             *child = target;
948         } else {
949             target = object_resolve_path(path, &ambiguous);
950             if (target || ambiguous) {
951                 error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, target_type);
952             } else {
953                 error_set(errp, QERR_DEVICE_NOT_FOUND, path);
954             }
955         }
956         g_free(target_type);
957     }
958 
959     g_free(path);
960 
961     if (old_target != NULL) {
962         object_unref(old_target);
963     }
964 }
965 
966 void object_property_add_link(Object *obj, const char *name,
967                               const char *type, Object **child,
968                               Error **errp)
969 {
970     gchar *full_type;
971 
972     full_type = g_strdup_printf("link<%s>", type);
973 
974     object_property_add(obj, name, full_type,
975                         object_get_link_property,
976                         object_set_link_property,
977                         NULL, child, errp);
978 
979     g_free(full_type);
980 }
981 
982 gchar *object_get_canonical_path(Object *obj)
983 {
984     Object *root = object_get_root();
985     char *newpath = NULL, *path = NULL;
986 
987     while (obj != root) {
988         ObjectProperty *prop = NULL;
989 
990         g_assert(obj->parent != NULL);
991 
992         QTAILQ_FOREACH(prop, &obj->parent->properties, node) {
993             if (!object_property_is_child(prop)) {
994                 continue;
995             }
996 
997             if (prop->opaque == obj) {
998                 if (path) {
999                     newpath = g_strdup_printf("%s/%s", prop->name, path);
1000                     g_free(path);
1001                     path = newpath;
1002                 } else {
1003                     path = g_strdup(prop->name);
1004                 }
1005                 break;
1006             }
1007         }
1008 
1009         g_assert(prop != NULL);
1010 
1011         obj = obj->parent;
1012     }
1013 
1014     newpath = g_strdup_printf("/%s", path);
1015     g_free(path);
1016 
1017     return newpath;
1018 }
1019 
1020 Object *object_resolve_path_component(Object *parent, const gchar *part)
1021 {
1022     ObjectProperty *prop = object_property_find(parent, part, NULL);
1023     if (prop == NULL) {
1024         return NULL;
1025     }
1026 
1027     if (object_property_is_link(prop)) {
1028         return *(Object **)prop->opaque;
1029     } else if (object_property_is_child(prop)) {
1030         return prop->opaque;
1031     } else {
1032         return NULL;
1033     }
1034 }
1035 
1036 static Object *object_resolve_abs_path(Object *parent,
1037                                           gchar **parts,
1038                                           const char *typename,
1039                                           int index)
1040 {
1041     Object *child;
1042 
1043     if (parts[index] == NULL) {
1044         return object_dynamic_cast(parent, typename);
1045     }
1046 
1047     if (strcmp(parts[index], "") == 0) {
1048         return object_resolve_abs_path(parent, parts, typename, index + 1);
1049     }
1050 
1051     child = object_resolve_path_component(parent, parts[index]);
1052     if (!child) {
1053         return NULL;
1054     }
1055 
1056     return object_resolve_abs_path(child, parts, typename, index + 1);
1057 }
1058 
1059 static Object *object_resolve_partial_path(Object *parent,
1060                                               gchar **parts,
1061                                               const char *typename,
1062                                               bool *ambiguous)
1063 {
1064     Object *obj;
1065     ObjectProperty *prop;
1066 
1067     obj = object_resolve_abs_path(parent, parts, typename, 0);
1068 
1069     QTAILQ_FOREACH(prop, &parent->properties, node) {
1070         Object *found;
1071 
1072         if (!object_property_is_child(prop)) {
1073             continue;
1074         }
1075 
1076         found = object_resolve_partial_path(prop->opaque, parts,
1077                                             typename, ambiguous);
1078         if (found) {
1079             if (obj) {
1080                 if (ambiguous) {
1081                     *ambiguous = true;
1082                 }
1083                 return NULL;
1084             }
1085             obj = found;
1086         }
1087 
1088         if (ambiguous && *ambiguous) {
1089             return NULL;
1090         }
1091     }
1092 
1093     return obj;
1094 }
1095 
1096 Object *object_resolve_path_type(const char *path, const char *typename,
1097                                  bool *ambiguous)
1098 {
1099     bool partial_path = true;
1100     Object *obj;
1101     gchar **parts;
1102 
1103     parts = g_strsplit(path, "/", 0);
1104     if (parts == NULL || parts[0] == NULL) {
1105         g_strfreev(parts);
1106         return object_get_root();
1107     }
1108 
1109     if (strcmp(parts[0], "") == 0) {
1110         partial_path = false;
1111     }
1112 
1113     if (partial_path) {
1114         if (ambiguous) {
1115             *ambiguous = false;
1116         }
1117         obj = object_resolve_partial_path(object_get_root(), parts,
1118                                           typename, ambiguous);
1119     } else {
1120         obj = object_resolve_abs_path(object_get_root(), parts, typename, 1);
1121     }
1122 
1123     g_strfreev(parts);
1124 
1125     return obj;
1126 }
1127 
1128 Object *object_resolve_path(const char *path, bool *ambiguous)
1129 {
1130     return object_resolve_path_type(path, TYPE_OBJECT, ambiguous);
1131 }
1132 
1133 typedef struct StringProperty
1134 {
1135     char *(*get)(Object *, Error **);
1136     void (*set)(Object *, const char *, Error **);
1137 } StringProperty;
1138 
1139 static void property_get_str(Object *obj, Visitor *v, void *opaque,
1140                              const char *name, Error **errp)
1141 {
1142     StringProperty *prop = opaque;
1143     char *value;
1144 
1145     value = prop->get(obj, errp);
1146     if (value) {
1147         visit_type_str(v, &value, name, errp);
1148         g_free(value);
1149     }
1150 }
1151 
1152 static void property_set_str(Object *obj, Visitor *v, void *opaque,
1153                              const char *name, Error **errp)
1154 {
1155     StringProperty *prop = opaque;
1156     char *value;
1157     Error *local_err = NULL;
1158 
1159     visit_type_str(v, &value, name, &local_err);
1160     if (local_err) {
1161         error_propagate(errp, local_err);
1162         return;
1163     }
1164 
1165     prop->set(obj, value, errp);
1166     g_free(value);
1167 }
1168 
1169 static void property_release_str(Object *obj, const char *name,
1170                                  void *opaque)
1171 {
1172     StringProperty *prop = opaque;
1173     g_free(prop);
1174 }
1175 
1176 void object_property_add_str(Object *obj, const char *name,
1177                            char *(*get)(Object *, Error **),
1178                            void (*set)(Object *, const char *, Error **),
1179                            Error **errp)
1180 {
1181     StringProperty *prop = g_malloc0(sizeof(*prop));
1182 
1183     prop->get = get;
1184     prop->set = set;
1185 
1186     object_property_add(obj, name, "string",
1187                         get ? property_get_str : NULL,
1188                         set ? property_set_str : NULL,
1189                         property_release_str,
1190                         prop, errp);
1191 }
1192 
1193 typedef struct BoolProperty
1194 {
1195     bool (*get)(Object *, Error **);
1196     void (*set)(Object *, bool, Error **);
1197 } BoolProperty;
1198 
1199 static void property_get_bool(Object *obj, Visitor *v, void *opaque,
1200                               const char *name, Error **errp)
1201 {
1202     BoolProperty *prop = opaque;
1203     bool value;
1204 
1205     value = prop->get(obj, errp);
1206     visit_type_bool(v, &value, name, errp);
1207 }
1208 
1209 static void property_set_bool(Object *obj, Visitor *v, void *opaque,
1210                               const char *name, Error **errp)
1211 {
1212     BoolProperty *prop = opaque;
1213     bool value;
1214     Error *local_err = NULL;
1215 
1216     visit_type_bool(v, &value, name, &local_err);
1217     if (local_err) {
1218         error_propagate(errp, local_err);
1219         return;
1220     }
1221 
1222     prop->set(obj, value, errp);
1223 }
1224 
1225 static void property_release_bool(Object *obj, const char *name,
1226                                   void *opaque)
1227 {
1228     BoolProperty *prop = opaque;
1229     g_free(prop);
1230 }
1231 
1232 void object_property_add_bool(Object *obj, const char *name,
1233                               bool (*get)(Object *, Error **),
1234                               void (*set)(Object *, bool, Error **),
1235                               Error **errp)
1236 {
1237     BoolProperty *prop = g_malloc0(sizeof(*prop));
1238 
1239     prop->get = get;
1240     prop->set = set;
1241 
1242     object_property_add(obj, name, "bool",
1243                         get ? property_get_bool : NULL,
1244                         set ? property_set_bool : NULL,
1245                         property_release_bool,
1246                         prop, errp);
1247 }
1248 
1249 static char *qdev_get_type(Object *obj, Error **errp)
1250 {
1251     return g_strdup(object_get_typename(obj));
1252 }
1253 
1254 static void object_instance_init(Object *obj)
1255 {
1256     object_property_add_str(obj, "type", qdev_get_type, NULL, NULL);
1257 }
1258 
1259 static void register_types(void)
1260 {
1261     static TypeInfo interface_info = {
1262         .name = TYPE_INTERFACE,
1263         .class_size = sizeof(InterfaceClass),
1264         .abstract = true,
1265     };
1266 
1267     static TypeInfo object_info = {
1268         .name = TYPE_OBJECT,
1269         .instance_size = sizeof(Object),
1270         .instance_init = object_instance_init,
1271         .abstract = true,
1272     };
1273 
1274     type_interface = type_register_internal(&interface_info);
1275     type_register_internal(&object_info);
1276 }
1277 
1278 type_init(register_types)
1279