4 * Copyright IBM, Corp. 2011
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.
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"
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"
28 #define MAX_INTERFACES 32
30 typedef struct InterfaceImpl InterfaceImpl;
31 typedef struct TypeImpl TypeImpl;
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);
52 void (*instance_init)(Object *obj);
53 void (*instance_finalize)(Object *obj);
58 TypeImpl *parent_type;
63 InterfaceImpl interfaces[MAX_INTERFACES];
66 static Type type_interface;
68 static GHashTable *type_table_get(void)
70 static GHashTable *type_table;
72 if (type_table == NULL) {
73 type_table = g_hash_table_new(g_str_hash, g_str_equal);
79 static void type_table_add(TypeImpl *ti)
81 g_hash_table_insert(type_table_get(), (void *)ti->name, ti);
84 static TypeImpl *type_table_lookup(const char *name)
86 return g_hash_table_lookup(type_table_get(), name);
89 static TypeImpl *type_register_internal(const TypeInfo *info)
91 TypeImpl *ti = g_malloc0(sizeof(*ti));
94 g_assert(info->name != NULL);
96 if (type_table_lookup(info->name) != NULL) {
97 fprintf(stderr, "Registering `%s' which already exists\n", info->name);
101 ti->name = g_strdup(info->name);
102 ti->parent = g_strdup(info->parent);
104 ti->class_size = info->class_size;
105 ti->instance_size = info->instance_size;
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;
112 ti->instance_init = info->instance_init;
113 ti->instance_finalize = info->instance_finalize;
115 ti->abstract = info->abstract;
117 for (i = 0; info->interfaces && info->interfaces[i].type; i++) {
118 ti->interfaces[i].typename = g_strdup(info->interfaces[i].type);
120 ti->num_interfaces = i;
127 TypeImpl *type_register(const TypeInfo *info)
129 assert(info->parent);
130 return type_register_internal(info);
133 TypeImpl *type_register_static(const TypeInfo *info)
135 return type_register(info);
138 static TypeImpl *type_get_by_name(const char *name)
144 return type_table_lookup(name);
147 static TypeImpl *type_get_parent(TypeImpl *type)
149 if (!type->parent_type && type->parent) {
150 type->parent_type = type_get_by_name(type->parent);
151 g_assert(type->parent_type != NULL);
154 return type->parent_type;
157 static bool type_has_parent(TypeImpl *type)
159 return (type->parent != NULL);
162 static size_t type_class_get_size(TypeImpl *ti)
164 if (ti->class_size) {
165 return ti->class_size;
168 if (type_has_parent(ti)) {
169 return type_class_get_size(type_get_parent(ti));
172 return sizeof(ObjectClass);
175 static size_t type_object_get_size(TypeImpl *ti)
177 if (ti->instance_size) {
178 return ti->instance_size;
181 if (type_has_parent(ti)) {
182 return type_object_get_size(type_get_parent(ti));
188 static bool type_is_ancestor(TypeImpl *type, TypeImpl *target_type)
192 /* Check if typename is a direct ancestor of type */
194 if (type == target_type) {
198 type = type_get_parent(type);
204 static void type_initialize(TypeImpl *ti);
206 static void type_initialize_interface(TypeImpl *ti, const char *parent)
208 InterfaceClass *new_iface;
210 TypeImpl *iface_impl;
212 info.parent = parent;
213 info.name = g_strdup_printf("%s::%s", ti->name, info.parent);
214 info.abstract = true;
216 iface_impl = type_register(&info);
217 type_initialize(iface_impl);
218 g_free((char *)info.name);
220 new_iface = (InterfaceClass *)iface_impl->class;
221 new_iface->concrete_class = ti->class;
223 ti->class->interfaces = g_slist_append(ti->class->interfaces,
227 static void type_initialize(TypeImpl *ti)
235 ti->class_size = type_class_get_size(ti);
236 ti->instance_size = type_object_get_size(ti);
238 ti->class = g_malloc0(ti->class_size);
240 parent = type_get_parent(ti);
242 type_initialize(parent);
246 g_assert(parent->class_size <= ti->class_size);
247 memcpy(ti->class, parent->class, parent->class_size);
248 ti->class->interfaces = NULL;
250 for (e = parent->class->interfaces; e; e = e->next) {
251 ObjectClass *iface = e->data;
252 type_initialize_interface(ti, object_class_get_name(iface));
255 for (i = 0; i < ti->num_interfaces; i++) {
256 TypeImpl *t = type_get_by_name(ti->interfaces[i].typename);
257 for (e = ti->class->interfaces; e; e = e->next) {
258 TypeImpl *target_type = OBJECT_CLASS(e->data)->type;
260 if (type_is_ancestor(target_type, t)) {
269 type_initialize_interface(ti, ti->interfaces[i].typename);
273 ti->class->type = ti;
276 if (parent->class_base_init) {
277 parent->class_base_init(ti->class, ti->class_data);
279 parent = type_get_parent(parent);
282 if (ti->class_init) {
283 ti->class_init(ti->class, ti->class_data);
289 static void object_init_with_type(Object *obj, TypeImpl *ti)
291 if (type_has_parent(ti)) {
292 object_init_with_type(obj, type_get_parent(ti));
295 if (ti->instance_init) {
296 ti->instance_init(obj);
300 void object_initialize_with_type(void *data, TypeImpl *type)
304 g_assert(type != NULL);
305 type_initialize(type);
307 g_assert(type->instance_size >= sizeof(Object));
308 g_assert(type->abstract == false);
310 memset(obj, 0, type->instance_size);
311 obj->class = type->class;
313 QTAILQ_INIT(&obj->properties);
314 object_init_with_type(obj, type);
317 void object_initialize(void *data, const char *typename)
319 TypeImpl *type = type_get_by_name(typename);
321 object_initialize_with_type(data, type);
324 static inline bool object_property_is_child(ObjectProperty *prop)
326 return strstart(prop->type, "child<", NULL);
329 static inline bool object_property_is_link(ObjectProperty *prop)
331 return strstart(prop->type, "link<", NULL);
334 static void object_property_del_all(Object *obj)
336 while (!QTAILQ_EMPTY(&obj->properties)) {
337 ObjectProperty *prop = QTAILQ_FIRST(&obj->properties);
339 QTAILQ_REMOVE(&obj->properties, prop, node);
342 prop->release(obj, prop->name, prop->opaque);
351 static void object_property_del_child(Object *obj, Object *child, Error **errp)
353 ObjectProperty *prop;
355 QTAILQ_FOREACH(prop, &obj->properties, node) {
356 if (object_property_is_child(prop) && prop->opaque == child) {
357 object_property_del(obj, prop->name, errp);
363 void object_unparent(Object *obj)
367 object_property_del_child(obj->parent, obj, NULL);
369 if (obj->class->unparent) {
370 (obj->class->unparent)(obj);
375 static void object_deinit(Object *obj, TypeImpl *type)
377 if (type->instance_finalize) {
378 type->instance_finalize(obj);
381 if (type_has_parent(type)) {
382 object_deinit(obj, type_get_parent(type));
386 static void object_finalize(void *data)
389 TypeImpl *ti = obj->class->type;
391 object_deinit(obj, ti);
392 object_property_del_all(obj);
394 g_assert(obj->ref == 0);
400 Object *object_new_with_type(Type type)
404 g_assert(type != NULL);
405 type_initialize(type);
407 obj = g_malloc(type->instance_size);
408 object_initialize_with_type(obj, type);
414 Object *object_new(const char *typename)
416 TypeImpl *ti = type_get_by_name(typename);
418 return object_new_with_type(ti);
421 Object *object_dynamic_cast(Object *obj, const char *typename)
423 if (obj && object_class_dynamic_cast(object_get_class(obj), typename)) {
430 Object *object_dynamic_cast_assert(Object *obj, const char *typename)
434 inst = object_dynamic_cast(obj, typename);
437 fprintf(stderr, "Object %p is not an instance of type %s\n",
445 ObjectClass *object_class_dynamic_cast(ObjectClass *class,
446 const char *typename)
448 TypeImpl *target_type = type_get_by_name(typename);
449 TypeImpl *type = class->type;
450 ObjectClass *ret = NULL;
452 if (type->class->interfaces &&
453 type_is_ancestor(target_type, type_interface)) {
457 for (i = class->interfaces; i; i = i->next) {
458 ObjectClass *target_class = i->data;
460 if (type_is_ancestor(target_class->type, target_type)) {
466 /* The match was ambiguous, don't allow a cast */
470 } else if (type_is_ancestor(type, target_type)) {
477 ObjectClass *object_class_dynamic_cast_assert(ObjectClass *class,
478 const char *typename)
480 ObjectClass *ret = object_class_dynamic_cast(class, typename);
483 fprintf(stderr, "Object %p is not an instance of type %s\n",
491 const char *object_get_typename(Object *obj)
493 return obj->class->type->name;
496 ObjectClass *object_get_class(Object *obj)
501 bool object_class_is_abstract(ObjectClass *klass)
503 return klass->type->abstract;
506 const char *object_class_get_name(ObjectClass *klass)
508 return klass->type->name;
511 ObjectClass *object_class_by_name(const char *typename)
513 TypeImpl *type = type_get_by_name(typename);
519 type_initialize(type);
524 ObjectClass *object_class_get_parent(ObjectClass *class)
526 TypeImpl *type = type_get_parent(class->type);
532 type_initialize(type);
537 typedef struct OCFData
539 void (*fn)(ObjectClass *klass, void *opaque);
540 const char *implements_type;
541 bool include_abstract;
545 static void object_class_foreach_tramp(gpointer key, gpointer value,
548 OCFData *data = opaque;
549 TypeImpl *type = value;
552 type_initialize(type);
555 if (!data->include_abstract && type->abstract) {
559 if (data->implements_type &&
560 !object_class_dynamic_cast(k, data->implements_type)) {
564 data->fn(k, data->opaque);
567 void object_class_foreach(void (*fn)(ObjectClass *klass, void *opaque),
568 const char *implements_type, bool include_abstract,
571 OCFData data = { fn, implements_type, include_abstract, opaque };
573 g_hash_table_foreach(type_table_get(), object_class_foreach_tramp, &data);
576 int object_child_foreach(Object *obj, int (*fn)(Object *child, void *opaque),
579 ObjectProperty *prop;
582 QTAILQ_FOREACH(prop, &obj->properties, node) {
583 if (object_property_is_child(prop)) {
584 ret = fn(prop->opaque, opaque);
593 static void object_class_get_list_tramp(ObjectClass *klass, void *opaque)
595 GSList **list = opaque;
597 *list = g_slist_prepend(*list, klass);
600 GSList *object_class_get_list(const char *implements_type,
601 bool include_abstract)
605 object_class_foreach(object_class_get_list_tramp,
606 implements_type, include_abstract, &list);
610 void object_ref(Object *obj)
615 void object_unref(Object *obj)
617 g_assert(obj->ref > 0);
620 /* parent always holds a reference to its children */
622 object_finalize(obj);
626 void object_property_add(Object *obj, const char *name, const char *type,
627 ObjectPropertyAccessor *get,
628 ObjectPropertyAccessor *set,
629 ObjectPropertyRelease *release,
630 void *opaque, Error **errp)
632 ObjectProperty *prop;
634 QTAILQ_FOREACH(prop, &obj->properties, node) {
635 if (strcmp(prop->name, name) == 0) {
636 error_setg(errp, "attempt to add duplicate property '%s'"
637 " to object (type '%s')", name,
638 object_get_typename(obj));
643 prop = g_malloc0(sizeof(*prop));
645 prop->name = g_strdup(name);
646 prop->type = g_strdup(type);
650 prop->release = release;
651 prop->opaque = opaque;
653 QTAILQ_INSERT_TAIL(&obj->properties, prop, node);
656 ObjectProperty *object_property_find(Object *obj, const char *name,
659 ObjectProperty *prop;
661 QTAILQ_FOREACH(prop, &obj->properties, node) {
662 if (strcmp(prop->name, name) == 0) {
667 error_set(errp, QERR_PROPERTY_NOT_FOUND, "", name);
671 void object_property_del(Object *obj, const char *name, Error **errp)
673 ObjectProperty *prop = object_property_find(obj, name, errp);
679 prop->release(obj, name, prop->opaque);
682 QTAILQ_REMOVE(&obj->properties, prop, node);
689 void object_property_get(Object *obj, Visitor *v, const char *name,
692 ObjectProperty *prop = object_property_find(obj, name, errp);
698 error_set(errp, QERR_PERMISSION_DENIED);
700 prop->get(obj, v, prop->opaque, name, errp);
704 void object_property_set(Object *obj, Visitor *v, const char *name,
707 ObjectProperty *prop = object_property_find(obj, name, errp);
713 error_set(errp, QERR_PERMISSION_DENIED);
715 prop->set(obj, v, prop->opaque, name, errp);
719 void object_property_set_str(Object *obj, const char *value,
720 const char *name, Error **errp)
722 QString *qstr = qstring_from_str(value);
723 object_property_set_qobject(obj, QOBJECT(qstr), name, errp);
728 char *object_property_get_str(Object *obj, const char *name,
731 QObject *ret = object_property_get_qobject(obj, name, errp);
738 qstring = qobject_to_qstring(ret);
740 error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, "string");
743 retval = g_strdup(qstring_get_str(qstring));
750 void object_property_set_link(Object *obj, Object *value,
751 const char *name, Error **errp)
753 object_property_set_str(obj, object_get_canonical_path(value),
757 Object *object_property_get_link(Object *obj, const char *name,
760 char *str = object_property_get_str(obj, name, errp);
761 Object *target = NULL;
764 target = object_resolve_path(str, NULL);
766 error_set(errp, QERR_DEVICE_NOT_FOUND, str);
774 void object_property_set_bool(Object *obj, bool value,
775 const char *name, Error **errp)
777 QBool *qbool = qbool_from_int(value);
778 object_property_set_qobject(obj, QOBJECT(qbool), name, errp);
783 bool object_property_get_bool(Object *obj, const char *name,
786 QObject *ret = object_property_get_qobject(obj, name, errp);
793 qbool = qobject_to_qbool(ret);
795 error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, "boolean");
798 retval = qbool_get_int(qbool);
805 void object_property_set_int(Object *obj, int64_t value,
806 const char *name, Error **errp)
808 QInt *qint = qint_from_int(value);
809 object_property_set_qobject(obj, QOBJECT(qint), name, errp);
814 int64_t object_property_get_int(Object *obj, const char *name,
817 QObject *ret = object_property_get_qobject(obj, name, errp);
824 qint = qobject_to_qint(ret);
826 error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, "int");
829 retval = qint_get_int(qint);
836 void object_property_parse(Object *obj, const char *string,
837 const char *name, Error **errp)
839 StringInputVisitor *mi;
840 mi = string_input_visitor_new(string);
841 object_property_set(obj, string_input_get_visitor(mi), name, errp);
843 string_input_visitor_cleanup(mi);
846 char *object_property_print(Object *obj, const char *name,
849 StringOutputVisitor *mo;
852 mo = string_output_visitor_new();
853 object_property_get(obj, string_output_get_visitor(mo), name, errp);
854 string = string_output_get_string(mo);
855 string_output_visitor_cleanup(mo);
859 const char *object_property_get_type(Object *obj, const char *name, Error **errp)
861 ObjectProperty *prop = object_property_find(obj, name, errp);
869 Object *object_get_root(void)
874 root = object_new("container");
880 static void object_get_child_property(Object *obj, Visitor *v, void *opaque,
881 const char *name, Error **errp)
883 Object *child = opaque;
886 path = object_get_canonical_path(child);
887 visit_type_str(v, &path, name, errp);
891 static void object_finalize_child_property(Object *obj, const char *name,
894 Object *child = opaque;
899 void object_property_add_child(Object *obj, const char *name,
900 Object *child, Error **errp)
904 type = g_strdup_printf("child<%s>", object_get_typename(OBJECT(child)));
906 object_property_add(obj, name, type, object_get_child_property,
907 NULL, object_finalize_child_property, child, errp);
910 g_assert(child->parent == NULL);
916 static void object_get_link_property(Object *obj, Visitor *v, void *opaque,
917 const char *name, Error **errp)
919 Object **child = opaque;
923 path = object_get_canonical_path(*child);
924 visit_type_str(v, &path, name, errp);
928 visit_type_str(v, &path, name, errp);
932 static void object_set_link_property(Object *obj, Visitor *v, void *opaque,
933 const char *name, Error **errp)
935 Object **child = opaque;
937 bool ambiguous = false;
942 type = object_property_get_type(obj, name, NULL);
944 visit_type_str(v, &path, name, errp);
949 if (strcmp(path, "") != 0) {
952 /* Go from link<FOO> to FOO. */
953 target_type = g_strndup(&type[5], strlen(type) - 6);
954 target = object_resolve_path_type(path, target_type, &ambiguous);
957 error_set(errp, QERR_AMBIGUOUS_PATH, path);
962 target = object_resolve_path(path, &ambiguous);
963 if (target || ambiguous) {
964 error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, target_type);
966 error_set(errp, QERR_DEVICE_NOT_FOUND, path);
974 if (old_target != NULL) {
975 object_unref(old_target);
979 void object_property_add_link(Object *obj, const char *name,
980 const char *type, Object **child,
985 full_type = g_strdup_printf("link<%s>", type);
987 object_property_add(obj, name, full_type,
988 object_get_link_property,
989 object_set_link_property,
995 gchar *object_get_canonical_path(Object *obj)
997 Object *root = object_get_root();
998 char *newpath = NULL, *path = NULL;
1000 while (obj != root) {
1001 ObjectProperty *prop = NULL;
1003 g_assert(obj->parent != NULL);
1005 QTAILQ_FOREACH(prop, &obj->parent->properties, node) {
1006 if (!object_property_is_child(prop)) {
1010 if (prop->opaque == obj) {
1012 newpath = g_strdup_printf("%s/%s", prop->name, path);
1016 path = g_strdup(prop->name);
1022 g_assert(prop != NULL);
1027 newpath = g_strdup_printf("/%s", path);
1033 Object *object_resolve_path_component(Object *parent, const gchar *part)
1035 ObjectProperty *prop = object_property_find(parent, part, NULL);
1040 if (object_property_is_link(prop)) {
1041 return *(Object **)prop->opaque;
1042 } else if (object_property_is_child(prop)) {
1043 return prop->opaque;
1049 static Object *object_resolve_abs_path(Object *parent,
1051 const char *typename,
1056 if (parts[index] == NULL) {
1057 return object_dynamic_cast(parent, typename);
1060 if (strcmp(parts[index], "") == 0) {
1061 return object_resolve_abs_path(parent, parts, typename, index + 1);
1064 child = object_resolve_path_component(parent, parts[index]);
1069 return object_resolve_abs_path(child, parts, typename, index + 1);
1072 static Object *object_resolve_partial_path(Object *parent,
1074 const char *typename,
1078 ObjectProperty *prop;
1080 obj = object_resolve_abs_path(parent, parts, typename, 0);
1082 QTAILQ_FOREACH(prop, &parent->properties, node) {
1085 if (!object_property_is_child(prop)) {
1089 found = object_resolve_partial_path(prop->opaque, parts,
1090 typename, ambiguous);
1101 if (ambiguous && *ambiguous) {
1109 Object *object_resolve_path_type(const char *path, const char *typename,
1112 bool partial_path = true;
1116 parts = g_strsplit(path, "/", 0);
1117 if (parts == NULL || parts[0] == NULL) {
1119 return object_get_root();
1122 if (strcmp(parts[0], "") == 0) {
1123 partial_path = false;
1130 obj = object_resolve_partial_path(object_get_root(), parts,
1131 typename, ambiguous);
1133 obj = object_resolve_abs_path(object_get_root(), parts, typename, 1);
1141 Object *object_resolve_path(const char *path, bool *ambiguous)
1143 return object_resolve_path_type(path, TYPE_OBJECT, ambiguous);
1146 typedef struct StringProperty
1148 char *(*get)(Object *, Error **);
1149 void (*set)(Object *, const char *, Error **);
1152 static void property_get_str(Object *obj, Visitor *v, void *opaque,
1153 const char *name, Error **errp)
1155 StringProperty *prop = opaque;
1158 value = prop->get(obj, errp);
1160 visit_type_str(v, &value, name, errp);
1165 static void property_set_str(Object *obj, Visitor *v, void *opaque,
1166 const char *name, Error **errp)
1168 StringProperty *prop = opaque;
1170 Error *local_err = NULL;
1172 visit_type_str(v, &value, name, &local_err);
1174 error_propagate(errp, local_err);
1178 prop->set(obj, value, errp);
1182 static void property_release_str(Object *obj, const char *name,
1185 StringProperty *prop = opaque;
1189 void object_property_add_str(Object *obj, const char *name,
1190 char *(*get)(Object *, Error **),
1191 void (*set)(Object *, const char *, Error **),
1194 StringProperty *prop = g_malloc0(sizeof(*prop));
1199 object_property_add(obj, name, "string",
1200 get ? property_get_str : NULL,
1201 set ? property_set_str : NULL,
1202 property_release_str,
1206 typedef struct BoolProperty
1208 bool (*get)(Object *, Error **);
1209 void (*set)(Object *, bool, Error **);
1212 static void property_get_bool(Object *obj, Visitor *v, void *opaque,
1213 const char *name, Error **errp)
1215 BoolProperty *prop = opaque;
1218 value = prop->get(obj, errp);
1219 visit_type_bool(v, &value, name, errp);
1222 static void property_set_bool(Object *obj, Visitor *v, void *opaque,
1223 const char *name, Error **errp)
1225 BoolProperty *prop = opaque;
1227 Error *local_err = NULL;
1229 visit_type_bool(v, &value, name, &local_err);
1231 error_propagate(errp, local_err);
1235 prop->set(obj, value, errp);
1238 static void property_release_bool(Object *obj, const char *name,
1241 BoolProperty *prop = opaque;
1245 void object_property_add_bool(Object *obj, const char *name,
1246 bool (*get)(Object *, Error **),
1247 void (*set)(Object *, bool, Error **),
1250 BoolProperty *prop = g_malloc0(sizeof(*prop));
1255 object_property_add(obj, name, "bool",
1256 get ? property_get_bool : NULL,
1257 set ? property_set_bool : NULL,
1258 property_release_bool,
1262 static char *qdev_get_type(Object *obj, Error **errp)
1264 return g_strdup(object_get_typename(obj));
1267 static void object_instance_init(Object *obj)
1269 object_property_add_str(obj, "type", qdev_get_type, NULL, NULL);
1272 static void register_types(void)
1274 static TypeInfo interface_info = {
1275 .name = TYPE_INTERFACE,
1276 .class_size = sizeof(InterfaceClass),
1280 static TypeInfo object_info = {
1281 .name = TYPE_OBJECT,
1282 .instance_size = sizeof(Object),
1283 .instance_init = object_instance_init,
1287 type_interface = type_register_internal(&interface_info);
1288 type_register_internal(&object_info);
1291 type_init(register_types)