]> git.proxmox.com Git - mirror_qemu.git/blob - qom/object.c
object: make object_class_property_add* return property
[mirror_qemu.git] / qom / object.c
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 "qemu/osdep.h"
14 #include "hw/qdev-core.h"
15 #include "qapi/error.h"
16 #include "qom/object.h"
17 #include "qom/object_interfaces.h"
18 #include "qemu/cutils.h"
19 #include "qapi/visitor.h"
20 #include "qapi/string-input-visitor.h"
21 #include "qapi/string-output-visitor.h"
22 #include "qapi/qapi-builtin-visit.h"
23 #include "qapi/qmp/qerror.h"
24 #include "trace.h"
25
26 /* TODO: replace QObject with a simpler visitor to avoid a dependency
27 * of the QOM core on QObject? */
28 #include "qom/qom-qobject.h"
29 #include "qapi/qmp/qbool.h"
30 #include "qapi/qmp/qnum.h"
31 #include "qapi/qmp/qstring.h"
32 #include "qemu/error-report.h"
33
34 #define MAX_INTERFACES 32
35
36 typedef struct InterfaceImpl InterfaceImpl;
37 typedef struct TypeImpl TypeImpl;
38
39 struct InterfaceImpl
40 {
41 const char *typename;
42 };
43
44 struct TypeImpl
45 {
46 const char *name;
47
48 size_t class_size;
49
50 size_t instance_size;
51
52 void (*class_init)(ObjectClass *klass, void *data);
53 void (*class_base_init)(ObjectClass *klass, void *data);
54
55 void *class_data;
56
57 void (*instance_init)(Object *obj);
58 void (*instance_post_init)(Object *obj);
59 void (*instance_finalize)(Object *obj);
60
61 bool abstract;
62
63 const char *parent;
64 TypeImpl *parent_type;
65
66 ObjectClass *class;
67
68 int num_interfaces;
69 InterfaceImpl interfaces[MAX_INTERFACES];
70 };
71
72 static Type type_interface;
73
74 static GHashTable *type_table_get(void)
75 {
76 static GHashTable *type_table;
77
78 if (type_table == NULL) {
79 type_table = g_hash_table_new(g_str_hash, g_str_equal);
80 }
81
82 return type_table;
83 }
84
85 static bool enumerating_types;
86
87 static void type_table_add(TypeImpl *ti)
88 {
89 assert(!enumerating_types);
90 g_hash_table_insert(type_table_get(), (void *)ti->name, ti);
91 }
92
93 static TypeImpl *type_table_lookup(const char *name)
94 {
95 return g_hash_table_lookup(type_table_get(), name);
96 }
97
98 static TypeImpl *type_new(const TypeInfo *info)
99 {
100 TypeImpl *ti = g_malloc0(sizeof(*ti));
101 int i;
102
103 g_assert(info->name != NULL);
104
105 if (type_table_lookup(info->name) != NULL) {
106 fprintf(stderr, "Registering `%s' which already exists\n", info->name);
107 abort();
108 }
109
110 ti->name = g_strdup(info->name);
111 ti->parent = g_strdup(info->parent);
112
113 ti->class_size = info->class_size;
114 ti->instance_size = info->instance_size;
115
116 ti->class_init = info->class_init;
117 ti->class_base_init = info->class_base_init;
118 ti->class_data = info->class_data;
119
120 ti->instance_init = info->instance_init;
121 ti->instance_post_init = info->instance_post_init;
122 ti->instance_finalize = info->instance_finalize;
123
124 ti->abstract = info->abstract;
125
126 for (i = 0; info->interfaces && info->interfaces[i].type; i++) {
127 ti->interfaces[i].typename = g_strdup(info->interfaces[i].type);
128 }
129 ti->num_interfaces = i;
130
131 return ti;
132 }
133
134 static TypeImpl *type_register_internal(const TypeInfo *info)
135 {
136 TypeImpl *ti;
137 ti = type_new(info);
138
139 type_table_add(ti);
140 return ti;
141 }
142
143 TypeImpl *type_register(const TypeInfo *info)
144 {
145 assert(info->parent);
146 return type_register_internal(info);
147 }
148
149 TypeImpl *type_register_static(const TypeInfo *info)
150 {
151 return type_register(info);
152 }
153
154 void type_register_static_array(const TypeInfo *infos, int nr_infos)
155 {
156 int i;
157
158 for (i = 0; i < nr_infos; i++) {
159 type_register_static(&infos[i]);
160 }
161 }
162
163 static TypeImpl *type_get_by_name(const char *name)
164 {
165 if (name == NULL) {
166 return NULL;
167 }
168
169 return type_table_lookup(name);
170 }
171
172 static TypeImpl *type_get_parent(TypeImpl *type)
173 {
174 if (!type->parent_type && type->parent) {
175 type->parent_type = type_get_by_name(type->parent);
176 if (!type->parent_type) {
177 fprintf(stderr, "Type '%s' is missing its parent '%s'\n",
178 type->name, type->parent);
179 abort();
180 }
181 }
182
183 return type->parent_type;
184 }
185
186 static bool type_has_parent(TypeImpl *type)
187 {
188 return (type->parent != NULL);
189 }
190
191 static size_t type_class_get_size(TypeImpl *ti)
192 {
193 if (ti->class_size) {
194 return ti->class_size;
195 }
196
197 if (type_has_parent(ti)) {
198 return type_class_get_size(type_get_parent(ti));
199 }
200
201 return sizeof(ObjectClass);
202 }
203
204 static size_t type_object_get_size(TypeImpl *ti)
205 {
206 if (ti->instance_size) {
207 return ti->instance_size;
208 }
209
210 if (type_has_parent(ti)) {
211 return type_object_get_size(type_get_parent(ti));
212 }
213
214 return 0;
215 }
216
217 size_t object_type_get_instance_size(const char *typename)
218 {
219 TypeImpl *type = type_get_by_name(typename);
220
221 g_assert(type != NULL);
222 return type_object_get_size(type);
223 }
224
225 static bool type_is_ancestor(TypeImpl *type, TypeImpl *target_type)
226 {
227 assert(target_type);
228
229 /* Check if target_type is a direct ancestor of type */
230 while (type) {
231 if (type == target_type) {
232 return true;
233 }
234
235 type = type_get_parent(type);
236 }
237
238 return false;
239 }
240
241 static void type_initialize(TypeImpl *ti);
242
243 static void type_initialize_interface(TypeImpl *ti, TypeImpl *interface_type,
244 TypeImpl *parent_type)
245 {
246 InterfaceClass *new_iface;
247 TypeInfo info = { };
248 TypeImpl *iface_impl;
249
250 info.parent = parent_type->name;
251 info.name = g_strdup_printf("%s::%s", ti->name, interface_type->name);
252 info.abstract = true;
253
254 iface_impl = type_new(&info);
255 iface_impl->parent_type = parent_type;
256 type_initialize(iface_impl);
257 g_free((char *)info.name);
258
259 new_iface = (InterfaceClass *)iface_impl->class;
260 new_iface->concrete_class = ti->class;
261 new_iface->interface_type = interface_type;
262
263 ti->class->interfaces = g_slist_append(ti->class->interfaces,
264 iface_impl->class);
265 }
266
267 static void object_property_free(gpointer data)
268 {
269 ObjectProperty *prop = data;
270
271 g_free(prop->name);
272 g_free(prop->type);
273 g_free(prop->description);
274 g_free(prop);
275 }
276
277 static void type_initialize(TypeImpl *ti)
278 {
279 TypeImpl *parent;
280
281 if (ti->class) {
282 return;
283 }
284
285 ti->class_size = type_class_get_size(ti);
286 ti->instance_size = type_object_get_size(ti);
287 /* Any type with zero instance_size is implicitly abstract.
288 * This means interface types are all abstract.
289 */
290 if (ti->instance_size == 0) {
291 ti->abstract = true;
292 }
293 if (type_is_ancestor(ti, type_interface)) {
294 assert(ti->instance_size == 0);
295 assert(ti->abstract);
296 assert(!ti->instance_init);
297 assert(!ti->instance_post_init);
298 assert(!ti->instance_finalize);
299 assert(!ti->num_interfaces);
300 }
301 ti->class = g_malloc0(ti->class_size);
302
303 parent = type_get_parent(ti);
304 if (parent) {
305 type_initialize(parent);
306 GSList *e;
307 int i;
308
309 g_assert(parent->class_size <= ti->class_size);
310 g_assert(parent->instance_size <= ti->instance_size);
311 memcpy(ti->class, parent->class, parent->class_size);
312 ti->class->interfaces = NULL;
313 ti->class->properties = g_hash_table_new_full(
314 g_str_hash, g_str_equal, NULL, object_property_free);
315
316 for (e = parent->class->interfaces; e; e = e->next) {
317 InterfaceClass *iface = e->data;
318 ObjectClass *klass = OBJECT_CLASS(iface);
319
320 type_initialize_interface(ti, iface->interface_type, klass->type);
321 }
322
323 for (i = 0; i < ti->num_interfaces; i++) {
324 TypeImpl *t = type_get_by_name(ti->interfaces[i].typename);
325 if (!t) {
326 error_report("missing interface '%s' for object '%s'",
327 ti->interfaces[i].typename, parent->name);
328 abort();
329 }
330 for (e = ti->class->interfaces; e; e = e->next) {
331 TypeImpl *target_type = OBJECT_CLASS(e->data)->type;
332
333 if (type_is_ancestor(target_type, t)) {
334 break;
335 }
336 }
337
338 if (e) {
339 continue;
340 }
341
342 type_initialize_interface(ti, t, t);
343 }
344 } else {
345 ti->class->properties = g_hash_table_new_full(
346 g_str_hash, g_str_equal, NULL, object_property_free);
347 }
348
349 ti->class->type = ti;
350
351 while (parent) {
352 if (parent->class_base_init) {
353 parent->class_base_init(ti->class, ti->class_data);
354 }
355 parent = type_get_parent(parent);
356 }
357
358 if (ti->class_init) {
359 ti->class_init(ti->class, ti->class_data);
360 }
361 }
362
363 static void object_init_with_type(Object *obj, TypeImpl *ti)
364 {
365 if (type_has_parent(ti)) {
366 object_init_with_type(obj, type_get_parent(ti));
367 }
368
369 if (ti->instance_init) {
370 ti->instance_init(obj);
371 }
372 }
373
374 static void object_post_init_with_type(Object *obj, TypeImpl *ti)
375 {
376 if (ti->instance_post_init) {
377 ti->instance_post_init(obj);
378 }
379
380 if (type_has_parent(ti)) {
381 object_post_init_with_type(obj, type_get_parent(ti));
382 }
383 }
384
385 void object_apply_global_props(Object *obj, const GPtrArray *props, Error **errp)
386 {
387 int i;
388
389 if (!props) {
390 return;
391 }
392
393 for (i = 0; i < props->len; i++) {
394 GlobalProperty *p = g_ptr_array_index(props, i);
395 Error *err = NULL;
396
397 if (object_dynamic_cast(obj, p->driver) == NULL) {
398 continue;
399 }
400 if (p->optional && !object_property_find(obj, p->property, NULL)) {
401 continue;
402 }
403 p->used = true;
404 object_property_parse(obj, p->value, p->property, &err);
405 if (err != NULL) {
406 error_prepend(&err, "can't apply global %s.%s=%s: ",
407 p->driver, p->property, p->value);
408 /*
409 * If errp != NULL, propagate error and return.
410 * If errp == NULL, report a warning, but keep going
411 * with the remaining globals.
412 */
413 if (errp) {
414 error_propagate(errp, err);
415 return;
416 } else {
417 warn_report_err(err);
418 }
419 }
420 }
421 }
422
423 /*
424 * Global property defaults
425 * Slot 0: accelerator's global property defaults
426 * Slot 1: machine's global property defaults
427 * Slot 2: global properties from legacy command line option
428 * Each is a GPtrArray of of GlobalProperty.
429 * Applied in order, later entries override earlier ones.
430 */
431 static GPtrArray *object_compat_props[3];
432
433 /*
434 * Retrieve @GPtrArray for global property defined with options
435 * other than "-global". These are generally used for syntactic
436 * sugar and legacy command line options.
437 */
438 void object_register_sugar_prop(const char *driver, const char *prop, const char *value)
439 {
440 GlobalProperty *g;
441 if (!object_compat_props[2]) {
442 object_compat_props[2] = g_ptr_array_new();
443 }
444 g = g_new0(GlobalProperty, 1);
445 g->driver = g_strdup(driver);
446 g->property = g_strdup(prop);
447 g->value = g_strdup(value);
448 g_ptr_array_add(object_compat_props[2], g);
449 }
450
451 /*
452 * Set machine's global property defaults to @compat_props.
453 * May be called at most once.
454 */
455 void object_set_machine_compat_props(GPtrArray *compat_props)
456 {
457 assert(!object_compat_props[1]);
458 object_compat_props[1] = compat_props;
459 }
460
461 /*
462 * Set accelerator's global property defaults to @compat_props.
463 * May be called at most once.
464 */
465 void object_set_accelerator_compat_props(GPtrArray *compat_props)
466 {
467 assert(!object_compat_props[0]);
468 object_compat_props[0] = compat_props;
469 }
470
471 void object_apply_compat_props(Object *obj)
472 {
473 int i;
474
475 for (i = 0; i < ARRAY_SIZE(object_compat_props); i++) {
476 object_apply_global_props(obj, object_compat_props[i],
477 i == 2 ? &error_fatal : &error_abort);
478 }
479 }
480
481 static void object_class_property_init_all(Object *obj)
482 {
483 ObjectPropertyIterator iter;
484 ObjectProperty *prop;
485
486 object_class_property_iter_init(&iter, object_get_class(obj));
487 while ((prop = object_property_iter_next(&iter))) {
488 if (prop->init) {
489 prop->init(obj, prop);
490 }
491 }
492 }
493
494 static void object_initialize_with_type(void *data, size_t size, TypeImpl *type)
495 {
496 Object *obj = data;
497
498 type_initialize(type);
499
500 g_assert(type->instance_size >= sizeof(Object));
501 g_assert(type->abstract == false);
502 g_assert(size >= type->instance_size);
503
504 memset(obj, 0, type->instance_size);
505 obj->class = type->class;
506 object_ref(obj);
507 object_class_property_init_all(obj);
508 obj->properties = g_hash_table_new_full(g_str_hash, g_str_equal,
509 NULL, object_property_free);
510 object_init_with_type(obj, type);
511 object_post_init_with_type(obj, type);
512 }
513
514 void object_initialize(void *data, size_t size, const char *typename)
515 {
516 TypeImpl *type = type_get_by_name(typename);
517
518 if (!type) {
519 error_report("missing object type '%s'", typename);
520 abort();
521 }
522
523 object_initialize_with_type(data, size, type);
524 }
525
526 void object_initialize_child(Object *parentobj, const char *propname,
527 void *childobj, size_t size, const char *type,
528 Error **errp, ...)
529 {
530 va_list vargs;
531
532 va_start(vargs, errp);
533 object_initialize_childv(parentobj, propname, childobj, size, type, errp,
534 vargs);
535 va_end(vargs);
536 }
537
538 void object_initialize_childv(Object *parentobj, const char *propname,
539 void *childobj, size_t size, const char *type,
540 Error **errp, va_list vargs)
541 {
542 Error *local_err = NULL;
543 Object *obj;
544 UserCreatable *uc;
545
546 object_initialize(childobj, size, type);
547 obj = OBJECT(childobj);
548
549 object_set_propv(obj, &local_err, vargs);
550 if (local_err) {
551 goto out;
552 }
553
554 object_property_add_child(parentobj, propname, obj, &local_err);
555 if (local_err) {
556 goto out;
557 }
558
559 uc = (UserCreatable *)object_dynamic_cast(obj, TYPE_USER_CREATABLE);
560 if (uc) {
561 user_creatable_complete(uc, &local_err);
562 if (local_err) {
563 object_unparent(obj);
564 goto out;
565 }
566 }
567
568 /*
569 * Since object_property_add_child added a reference to the child object,
570 * we can drop the reference added by object_initialize(), so the child
571 * property will own the only reference to the object.
572 */
573 object_unref(obj);
574
575 out:
576 if (local_err) {
577 error_propagate(errp, local_err);
578 object_unref(obj);
579 }
580 }
581
582 static inline bool object_property_is_child(ObjectProperty *prop)
583 {
584 return strstart(prop->type, "child<", NULL);
585 }
586
587 static void object_property_del_all(Object *obj)
588 {
589 ObjectProperty *prop;
590 GHashTableIter iter;
591 gpointer key, value;
592 bool released;
593
594 do {
595 released = false;
596 g_hash_table_iter_init(&iter, obj->properties);
597 while (g_hash_table_iter_next(&iter, &key, &value)) {
598 prop = value;
599 if (prop->release) {
600 prop->release(obj, prop->name, prop->opaque);
601 prop->release = NULL;
602 released = true;
603 break;
604 }
605 g_hash_table_iter_remove(&iter);
606 }
607 } while (released);
608
609 g_hash_table_unref(obj->properties);
610 }
611
612 static void object_property_del_child(Object *obj, Object *child, Error **errp)
613 {
614 ObjectProperty *prop;
615 GHashTableIter iter;
616 gpointer key, value;
617
618 g_hash_table_iter_init(&iter, obj->properties);
619 while (g_hash_table_iter_next(&iter, &key, &value)) {
620 prop = value;
621 if (object_property_is_child(prop) && prop->opaque == child) {
622 if (prop->release) {
623 prop->release(obj, prop->name, prop->opaque);
624 prop->release = NULL;
625 }
626 break;
627 }
628 }
629 g_hash_table_iter_init(&iter, obj->properties);
630 while (g_hash_table_iter_next(&iter, &key, &value)) {
631 prop = value;
632 if (object_property_is_child(prop) && prop->opaque == child) {
633 g_hash_table_iter_remove(&iter);
634 break;
635 }
636 }
637 }
638
639 void object_unparent(Object *obj)
640 {
641 if (obj->parent) {
642 object_property_del_child(obj->parent, obj, NULL);
643 }
644 }
645
646 static void object_deinit(Object *obj, TypeImpl *type)
647 {
648 if (type->instance_finalize) {
649 type->instance_finalize(obj);
650 }
651
652 if (type_has_parent(type)) {
653 object_deinit(obj, type_get_parent(type));
654 }
655 }
656
657 static void object_finalize(void *data)
658 {
659 Object *obj = data;
660 TypeImpl *ti = obj->class->type;
661
662 object_property_del_all(obj);
663 object_deinit(obj, ti);
664
665 g_assert(obj->ref == 0);
666 if (obj->free) {
667 obj->free(obj);
668 }
669 }
670
671 static Object *object_new_with_type(Type type)
672 {
673 Object *obj;
674
675 g_assert(type != NULL);
676 type_initialize(type);
677
678 obj = g_malloc(type->instance_size);
679 object_initialize_with_type(obj, type->instance_size, type);
680 obj->free = g_free;
681
682 return obj;
683 }
684
685 Object *object_new_with_class(ObjectClass *klass)
686 {
687 return object_new_with_type(klass->type);
688 }
689
690 Object *object_new(const char *typename)
691 {
692 TypeImpl *ti = type_get_by_name(typename);
693
694 return object_new_with_type(ti);
695 }
696
697
698 Object *object_new_with_props(const char *typename,
699 Object *parent,
700 const char *id,
701 Error **errp,
702 ...)
703 {
704 va_list vargs;
705 Object *obj;
706
707 va_start(vargs, errp);
708 obj = object_new_with_propv(typename, parent, id, errp, vargs);
709 va_end(vargs);
710
711 return obj;
712 }
713
714
715 Object *object_new_with_propv(const char *typename,
716 Object *parent,
717 const char *id,
718 Error **errp,
719 va_list vargs)
720 {
721 Object *obj;
722 ObjectClass *klass;
723 Error *local_err = NULL;
724 UserCreatable *uc;
725
726 klass = object_class_by_name(typename);
727 if (!klass) {
728 error_setg(errp, "invalid object type: %s", typename);
729 return NULL;
730 }
731
732 if (object_class_is_abstract(klass)) {
733 error_setg(errp, "object type '%s' is abstract", typename);
734 return NULL;
735 }
736 obj = object_new_with_type(klass->type);
737
738 if (object_set_propv(obj, &local_err, vargs) < 0) {
739 goto error;
740 }
741
742 if (id != NULL) {
743 object_property_add_child(parent, id, obj, &local_err);
744 if (local_err) {
745 goto error;
746 }
747 }
748
749 uc = (UserCreatable *)object_dynamic_cast(obj, TYPE_USER_CREATABLE);
750 if (uc) {
751 user_creatable_complete(uc, &local_err);
752 if (local_err) {
753 if (id != NULL) {
754 object_unparent(obj);
755 }
756 goto error;
757 }
758 }
759
760 object_unref(OBJECT(obj));
761 return obj;
762
763 error:
764 error_propagate(errp, local_err);
765 object_unref(obj);
766 return NULL;
767 }
768
769
770 int object_set_props(Object *obj,
771 Error **errp,
772 ...)
773 {
774 va_list vargs;
775 int ret;
776
777 va_start(vargs, errp);
778 ret = object_set_propv(obj, errp, vargs);
779 va_end(vargs);
780
781 return ret;
782 }
783
784
785 int object_set_propv(Object *obj,
786 Error **errp,
787 va_list vargs)
788 {
789 const char *propname;
790 Error *local_err = NULL;
791
792 propname = va_arg(vargs, char *);
793 while (propname != NULL) {
794 const char *value = va_arg(vargs, char *);
795
796 g_assert(value != NULL);
797 object_property_parse(obj, value, propname, &local_err);
798 if (local_err) {
799 error_propagate(errp, local_err);
800 return -1;
801 }
802 propname = va_arg(vargs, char *);
803 }
804
805 return 0;
806 }
807
808
809 Object *object_dynamic_cast(Object *obj, const char *typename)
810 {
811 if (obj && object_class_dynamic_cast(object_get_class(obj), typename)) {
812 return obj;
813 }
814
815 return NULL;
816 }
817
818 Object *object_dynamic_cast_assert(Object *obj, const char *typename,
819 const char *file, int line, const char *func)
820 {
821 trace_object_dynamic_cast_assert(obj ? obj->class->type->name : "(null)",
822 typename, file, line, func);
823
824 #ifdef CONFIG_QOM_CAST_DEBUG
825 int i;
826 Object *inst;
827
828 for (i = 0; obj && i < OBJECT_CLASS_CAST_CACHE; i++) {
829 if (atomic_read(&obj->class->object_cast_cache[i]) == typename) {
830 goto out;
831 }
832 }
833
834 inst = object_dynamic_cast(obj, typename);
835
836 if (!inst && obj) {
837 fprintf(stderr, "%s:%d:%s: Object %p is not an instance of type %s\n",
838 file, line, func, obj, typename);
839 abort();
840 }
841
842 assert(obj == inst);
843
844 if (obj && obj == inst) {
845 for (i = 1; i < OBJECT_CLASS_CAST_CACHE; i++) {
846 atomic_set(&obj->class->object_cast_cache[i - 1],
847 atomic_read(&obj->class->object_cast_cache[i]));
848 }
849 atomic_set(&obj->class->object_cast_cache[i - 1], typename);
850 }
851
852 out:
853 #endif
854 return obj;
855 }
856
857 ObjectClass *object_class_dynamic_cast(ObjectClass *class,
858 const char *typename)
859 {
860 ObjectClass *ret = NULL;
861 TypeImpl *target_type;
862 TypeImpl *type;
863
864 if (!class) {
865 return NULL;
866 }
867
868 /* A simple fast path that can trigger a lot for leaf classes. */
869 type = class->type;
870 if (type->name == typename) {
871 return class;
872 }
873
874 target_type = type_get_by_name(typename);
875 if (!target_type) {
876 /* target class type unknown, so fail the cast */
877 return NULL;
878 }
879
880 if (type->class->interfaces &&
881 type_is_ancestor(target_type, type_interface)) {
882 int found = 0;
883 GSList *i;
884
885 for (i = class->interfaces; i; i = i->next) {
886 ObjectClass *target_class = i->data;
887
888 if (type_is_ancestor(target_class->type, target_type)) {
889 ret = target_class;
890 found++;
891 }
892 }
893
894 /* The match was ambiguous, don't allow a cast */
895 if (found > 1) {
896 ret = NULL;
897 }
898 } else if (type_is_ancestor(type, target_type)) {
899 ret = class;
900 }
901
902 return ret;
903 }
904
905 ObjectClass *object_class_dynamic_cast_assert(ObjectClass *class,
906 const char *typename,
907 const char *file, int line,
908 const char *func)
909 {
910 ObjectClass *ret;
911
912 trace_object_class_dynamic_cast_assert(class ? class->type->name : "(null)",
913 typename, file, line, func);
914
915 #ifdef CONFIG_QOM_CAST_DEBUG
916 int i;
917
918 for (i = 0; class && i < OBJECT_CLASS_CAST_CACHE; i++) {
919 if (atomic_read(&class->class_cast_cache[i]) == typename) {
920 ret = class;
921 goto out;
922 }
923 }
924 #else
925 if (!class || !class->interfaces) {
926 return class;
927 }
928 #endif
929
930 ret = object_class_dynamic_cast(class, typename);
931 if (!ret && class) {
932 fprintf(stderr, "%s:%d:%s: Object %p is not an instance of type %s\n",
933 file, line, func, class, typename);
934 abort();
935 }
936
937 #ifdef CONFIG_QOM_CAST_DEBUG
938 if (class && ret == class) {
939 for (i = 1; i < OBJECT_CLASS_CAST_CACHE; i++) {
940 atomic_set(&class->class_cast_cache[i - 1],
941 atomic_read(&class->class_cast_cache[i]));
942 }
943 atomic_set(&class->class_cast_cache[i - 1], typename);
944 }
945 out:
946 #endif
947 return ret;
948 }
949
950 const char *object_get_typename(const Object *obj)
951 {
952 return obj->class->type->name;
953 }
954
955 ObjectClass *object_get_class(Object *obj)
956 {
957 return obj->class;
958 }
959
960 bool object_class_is_abstract(ObjectClass *klass)
961 {
962 return klass->type->abstract;
963 }
964
965 const char *object_class_get_name(ObjectClass *klass)
966 {
967 return klass->type->name;
968 }
969
970 ObjectClass *object_class_by_name(const char *typename)
971 {
972 TypeImpl *type = type_get_by_name(typename);
973
974 if (!type) {
975 return NULL;
976 }
977
978 type_initialize(type);
979
980 return type->class;
981 }
982
983 ObjectClass *object_class_get_parent(ObjectClass *class)
984 {
985 TypeImpl *type = type_get_parent(class->type);
986
987 if (!type) {
988 return NULL;
989 }
990
991 type_initialize(type);
992
993 return type->class;
994 }
995
996 typedef struct OCFData
997 {
998 void (*fn)(ObjectClass *klass, void *opaque);
999 const char *implements_type;
1000 bool include_abstract;
1001 void *opaque;
1002 } OCFData;
1003
1004 static void object_class_foreach_tramp(gpointer key, gpointer value,
1005 gpointer opaque)
1006 {
1007 OCFData *data = opaque;
1008 TypeImpl *type = value;
1009 ObjectClass *k;
1010
1011 type_initialize(type);
1012 k = type->class;
1013
1014 if (!data->include_abstract && type->abstract) {
1015 return;
1016 }
1017
1018 if (data->implements_type &&
1019 !object_class_dynamic_cast(k, data->implements_type)) {
1020 return;
1021 }
1022
1023 data->fn(k, data->opaque);
1024 }
1025
1026 void object_class_foreach(void (*fn)(ObjectClass *klass, void *opaque),
1027 const char *implements_type, bool include_abstract,
1028 void *opaque)
1029 {
1030 OCFData data = { fn, implements_type, include_abstract, opaque };
1031
1032 enumerating_types = true;
1033 g_hash_table_foreach(type_table_get(), object_class_foreach_tramp, &data);
1034 enumerating_types = false;
1035 }
1036
1037 static int do_object_child_foreach(Object *obj,
1038 int (*fn)(Object *child, void *opaque),
1039 void *opaque, bool recurse)
1040 {
1041 GHashTableIter iter;
1042 ObjectProperty *prop;
1043 int ret = 0;
1044
1045 g_hash_table_iter_init(&iter, obj->properties);
1046 while (g_hash_table_iter_next(&iter, NULL, (gpointer *)&prop)) {
1047 if (object_property_is_child(prop)) {
1048 Object *child = prop->opaque;
1049
1050 ret = fn(child, opaque);
1051 if (ret != 0) {
1052 break;
1053 }
1054 if (recurse) {
1055 do_object_child_foreach(child, fn, opaque, true);
1056 }
1057 }
1058 }
1059 return ret;
1060 }
1061
1062 int object_child_foreach(Object *obj, int (*fn)(Object *child, void *opaque),
1063 void *opaque)
1064 {
1065 return do_object_child_foreach(obj, fn, opaque, false);
1066 }
1067
1068 int object_child_foreach_recursive(Object *obj,
1069 int (*fn)(Object *child, void *opaque),
1070 void *opaque)
1071 {
1072 return do_object_child_foreach(obj, fn, opaque, true);
1073 }
1074
1075 static void object_class_get_list_tramp(ObjectClass *klass, void *opaque)
1076 {
1077 GSList **list = opaque;
1078
1079 *list = g_slist_prepend(*list, klass);
1080 }
1081
1082 GSList *object_class_get_list(const char *implements_type,
1083 bool include_abstract)
1084 {
1085 GSList *list = NULL;
1086
1087 object_class_foreach(object_class_get_list_tramp,
1088 implements_type, include_abstract, &list);
1089 return list;
1090 }
1091
1092 static gint object_class_cmp(gconstpointer a, gconstpointer b)
1093 {
1094 return strcasecmp(object_class_get_name((ObjectClass *)a),
1095 object_class_get_name((ObjectClass *)b));
1096 }
1097
1098 GSList *object_class_get_list_sorted(const char *implements_type,
1099 bool include_abstract)
1100 {
1101 return g_slist_sort(object_class_get_list(implements_type, include_abstract),
1102 object_class_cmp);
1103 }
1104
1105 void object_ref(Object *obj)
1106 {
1107 if (!obj) {
1108 return;
1109 }
1110 atomic_inc(&obj->ref);
1111 }
1112
1113 void object_unref(Object *obj)
1114 {
1115 if (!obj) {
1116 return;
1117 }
1118 g_assert(obj->ref > 0);
1119
1120 /* parent always holds a reference to its children */
1121 if (atomic_fetch_dec(&obj->ref) == 1) {
1122 object_finalize(obj);
1123 }
1124 }
1125
1126 ObjectProperty *
1127 object_property_add(Object *obj, const char *name, const char *type,
1128 ObjectPropertyAccessor *get,
1129 ObjectPropertyAccessor *set,
1130 ObjectPropertyRelease *release,
1131 void *opaque, Error **errp)
1132 {
1133 ObjectProperty *prop;
1134 size_t name_len = strlen(name);
1135
1136 if (name_len >= 3 && !memcmp(name + name_len - 3, "[*]", 4)) {
1137 int i;
1138 ObjectProperty *ret;
1139 char *name_no_array = g_strdup(name);
1140
1141 name_no_array[name_len - 3] = '\0';
1142 for (i = 0; ; ++i) {
1143 char *full_name = g_strdup_printf("%s[%d]", name_no_array, i);
1144
1145 ret = object_property_add(obj, full_name, type, get, set,
1146 release, opaque, NULL);
1147 g_free(full_name);
1148 if (ret) {
1149 break;
1150 }
1151 }
1152 g_free(name_no_array);
1153 return ret;
1154 }
1155
1156 if (object_property_find(obj, name, NULL) != NULL) {
1157 error_setg(errp, "attempt to add duplicate property '%s' to object (type '%s')",
1158 name, object_get_typename(obj));
1159 return NULL;
1160 }
1161
1162 prop = g_malloc0(sizeof(*prop));
1163
1164 prop->name = g_strdup(name);
1165 prop->type = g_strdup(type);
1166
1167 prop->get = get;
1168 prop->set = set;
1169 prop->release = release;
1170 prop->opaque = opaque;
1171
1172 g_hash_table_insert(obj->properties, prop->name, prop);
1173 return prop;
1174 }
1175
1176 ObjectProperty *
1177 object_class_property_add(ObjectClass *klass,
1178 const char *name,
1179 const char *type,
1180 ObjectPropertyAccessor *get,
1181 ObjectPropertyAccessor *set,
1182 ObjectPropertyRelease *release,
1183 void *opaque,
1184 Error **errp)
1185 {
1186 ObjectProperty *prop;
1187
1188 if (object_class_property_find(klass, name, NULL) != NULL) {
1189 error_setg(errp, "attempt to add duplicate property '%s' to class (type '%s')",
1190 name, object_class_get_name(klass));
1191 return NULL;
1192 }
1193
1194 prop = g_malloc0(sizeof(*prop));
1195
1196 prop->name = g_strdup(name);
1197 prop->type = g_strdup(type);
1198
1199 prop->get = get;
1200 prop->set = set;
1201 prop->release = release;
1202 prop->opaque = opaque;
1203
1204 g_hash_table_insert(klass->properties, prop->name, prop);
1205
1206 return prop;
1207 }
1208
1209 ObjectProperty *object_property_find(Object *obj, const char *name,
1210 Error **errp)
1211 {
1212 ObjectProperty *prop;
1213 ObjectClass *klass = object_get_class(obj);
1214
1215 prop = object_class_property_find(klass, name, NULL);
1216 if (prop) {
1217 return prop;
1218 }
1219
1220 prop = g_hash_table_lookup(obj->properties, name);
1221 if (prop) {
1222 return prop;
1223 }
1224
1225 error_setg(errp, "Property '.%s' not found", name);
1226 return NULL;
1227 }
1228
1229 void object_property_iter_init(ObjectPropertyIterator *iter,
1230 Object *obj)
1231 {
1232 g_hash_table_iter_init(&iter->iter, obj->properties);
1233 iter->nextclass = object_get_class(obj);
1234 }
1235
1236 ObjectProperty *object_property_iter_next(ObjectPropertyIterator *iter)
1237 {
1238 gpointer key, val;
1239 while (!g_hash_table_iter_next(&iter->iter, &key, &val)) {
1240 if (!iter->nextclass) {
1241 return NULL;
1242 }
1243 g_hash_table_iter_init(&iter->iter, iter->nextclass->properties);
1244 iter->nextclass = object_class_get_parent(iter->nextclass);
1245 }
1246 return val;
1247 }
1248
1249 void object_class_property_iter_init(ObjectPropertyIterator *iter,
1250 ObjectClass *klass)
1251 {
1252 g_hash_table_iter_init(&iter->iter, klass->properties);
1253 iter->nextclass = object_class_get_parent(klass);
1254 }
1255
1256 ObjectProperty *object_class_property_find(ObjectClass *klass, const char *name,
1257 Error **errp)
1258 {
1259 ObjectProperty *prop;
1260 ObjectClass *parent_klass;
1261
1262 parent_klass = object_class_get_parent(klass);
1263 if (parent_klass) {
1264 prop = object_class_property_find(parent_klass, name, NULL);
1265 if (prop) {
1266 return prop;
1267 }
1268 }
1269
1270 prop = g_hash_table_lookup(klass->properties, name);
1271 if (!prop) {
1272 error_setg(errp, "Property '.%s' not found", name);
1273 }
1274 return prop;
1275 }
1276
1277 void object_property_del(Object *obj, const char *name, Error **errp)
1278 {
1279 ObjectProperty *prop = g_hash_table_lookup(obj->properties, name);
1280
1281 if (!prop) {
1282 error_setg(errp, "Property '.%s' not found", name);
1283 return;
1284 }
1285
1286 if (prop->release) {
1287 prop->release(obj, name, prop->opaque);
1288 }
1289 g_hash_table_remove(obj->properties, name);
1290 }
1291
1292 void object_property_get(Object *obj, Visitor *v, const char *name,
1293 Error **errp)
1294 {
1295 ObjectProperty *prop = object_property_find(obj, name, errp);
1296 if (prop == NULL) {
1297 return;
1298 }
1299
1300 if (!prop->get) {
1301 error_setg(errp, QERR_PERMISSION_DENIED);
1302 } else {
1303 prop->get(obj, v, name, prop->opaque, errp);
1304 }
1305 }
1306
1307 void object_property_set(Object *obj, Visitor *v, const char *name,
1308 Error **errp)
1309 {
1310 ObjectProperty *prop = object_property_find(obj, name, errp);
1311 if (prop == NULL) {
1312 return;
1313 }
1314
1315 if (!prop->set) {
1316 error_setg(errp, QERR_PERMISSION_DENIED);
1317 } else {
1318 prop->set(obj, v, name, prop->opaque, errp);
1319 }
1320 }
1321
1322 void object_property_set_str(Object *obj, const char *value,
1323 const char *name, Error **errp)
1324 {
1325 QString *qstr = qstring_from_str(value);
1326 object_property_set_qobject(obj, QOBJECT(qstr), name, errp);
1327
1328 qobject_unref(qstr);
1329 }
1330
1331 char *object_property_get_str(Object *obj, const char *name,
1332 Error **errp)
1333 {
1334 QObject *ret = object_property_get_qobject(obj, name, errp);
1335 char *retval;
1336
1337 if (!ret) {
1338 return NULL;
1339 }
1340
1341 retval = g_strdup(qobject_get_try_str(ret));
1342 if (!retval) {
1343 error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, "string");
1344 }
1345
1346 qobject_unref(ret);
1347 return retval;
1348 }
1349
1350 void object_property_set_link(Object *obj, Object *value,
1351 const char *name, Error **errp)
1352 {
1353 if (value) {
1354 gchar *path = object_get_canonical_path(value);
1355 object_property_set_str(obj, path, name, errp);
1356 g_free(path);
1357 } else {
1358 object_property_set_str(obj, "", name, errp);
1359 }
1360 }
1361
1362 Object *object_property_get_link(Object *obj, const char *name,
1363 Error **errp)
1364 {
1365 char *str = object_property_get_str(obj, name, errp);
1366 Object *target = NULL;
1367
1368 if (str && *str) {
1369 target = object_resolve_path(str, NULL);
1370 if (!target) {
1371 error_set(errp, ERROR_CLASS_DEVICE_NOT_FOUND,
1372 "Device '%s' not found", str);
1373 }
1374 }
1375
1376 g_free(str);
1377 return target;
1378 }
1379
1380 void object_property_set_bool(Object *obj, bool value,
1381 const char *name, Error **errp)
1382 {
1383 QBool *qbool = qbool_from_bool(value);
1384 object_property_set_qobject(obj, QOBJECT(qbool), name, errp);
1385
1386 qobject_unref(qbool);
1387 }
1388
1389 bool object_property_get_bool(Object *obj, const char *name,
1390 Error **errp)
1391 {
1392 QObject *ret = object_property_get_qobject(obj, name, errp);
1393 QBool *qbool;
1394 bool retval;
1395
1396 if (!ret) {
1397 return false;
1398 }
1399 qbool = qobject_to(QBool, ret);
1400 if (!qbool) {
1401 error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, "boolean");
1402 retval = false;
1403 } else {
1404 retval = qbool_get_bool(qbool);
1405 }
1406
1407 qobject_unref(ret);
1408 return retval;
1409 }
1410
1411 void object_property_set_int(Object *obj, int64_t value,
1412 const char *name, Error **errp)
1413 {
1414 QNum *qnum = qnum_from_int(value);
1415 object_property_set_qobject(obj, QOBJECT(qnum), name, errp);
1416
1417 qobject_unref(qnum);
1418 }
1419
1420 int64_t object_property_get_int(Object *obj, const char *name,
1421 Error **errp)
1422 {
1423 QObject *ret = object_property_get_qobject(obj, name, errp);
1424 QNum *qnum;
1425 int64_t retval;
1426
1427 if (!ret) {
1428 return -1;
1429 }
1430
1431 qnum = qobject_to(QNum, ret);
1432 if (!qnum || !qnum_get_try_int(qnum, &retval)) {
1433 error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, "int");
1434 retval = -1;
1435 }
1436
1437 qobject_unref(ret);
1438 return retval;
1439 }
1440
1441 void object_property_set_uint(Object *obj, uint64_t value,
1442 const char *name, Error **errp)
1443 {
1444 QNum *qnum = qnum_from_uint(value);
1445
1446 object_property_set_qobject(obj, QOBJECT(qnum), name, errp);
1447 qobject_unref(qnum);
1448 }
1449
1450 uint64_t object_property_get_uint(Object *obj, const char *name,
1451 Error **errp)
1452 {
1453 QObject *ret = object_property_get_qobject(obj, name, errp);
1454 QNum *qnum;
1455 uint64_t retval;
1456
1457 if (!ret) {
1458 return 0;
1459 }
1460 qnum = qobject_to(QNum, ret);
1461 if (!qnum || !qnum_get_try_uint(qnum, &retval)) {
1462 error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, "uint");
1463 retval = 0;
1464 }
1465
1466 qobject_unref(ret);
1467 return retval;
1468 }
1469
1470 typedef struct EnumProperty {
1471 const QEnumLookup *lookup;
1472 int (*get)(Object *, Error **);
1473 void (*set)(Object *, int, Error **);
1474 } EnumProperty;
1475
1476 int object_property_get_enum(Object *obj, const char *name,
1477 const char *typename, Error **errp)
1478 {
1479 Error *err = NULL;
1480 Visitor *v;
1481 char *str;
1482 int ret;
1483 ObjectProperty *prop = object_property_find(obj, name, errp);
1484 EnumProperty *enumprop;
1485
1486 if (prop == NULL) {
1487 return 0;
1488 }
1489
1490 if (!g_str_equal(prop->type, typename)) {
1491 error_setg(errp, "Property %s on %s is not '%s' enum type",
1492 name, object_class_get_name(
1493 object_get_class(obj)), typename);
1494 return 0;
1495 }
1496
1497 enumprop = prop->opaque;
1498
1499 v = string_output_visitor_new(false, &str);
1500 object_property_get(obj, v, name, &err);
1501 if (err) {
1502 error_propagate(errp, err);
1503 visit_free(v);
1504 return 0;
1505 }
1506 visit_complete(v, &str);
1507 visit_free(v);
1508 v = string_input_visitor_new(str);
1509 visit_type_enum(v, name, &ret, enumprop->lookup, errp);
1510
1511 g_free(str);
1512 visit_free(v);
1513
1514 return ret;
1515 }
1516
1517 void object_property_get_uint16List(Object *obj, const char *name,
1518 uint16List **list, Error **errp)
1519 {
1520 Error *err = NULL;
1521 Visitor *v;
1522 char *str;
1523
1524 v = string_output_visitor_new(false, &str);
1525 object_property_get(obj, v, name, &err);
1526 if (err) {
1527 error_propagate(errp, err);
1528 goto out;
1529 }
1530 visit_complete(v, &str);
1531 visit_free(v);
1532 v = string_input_visitor_new(str);
1533 visit_type_uint16List(v, NULL, list, errp);
1534
1535 g_free(str);
1536 out:
1537 visit_free(v);
1538 }
1539
1540 void object_property_parse(Object *obj, const char *string,
1541 const char *name, Error **errp)
1542 {
1543 Visitor *v = string_input_visitor_new(string);
1544 object_property_set(obj, v, name, errp);
1545 visit_free(v);
1546 }
1547
1548 char *object_property_print(Object *obj, const char *name, bool human,
1549 Error **errp)
1550 {
1551 Visitor *v;
1552 char *string = NULL;
1553 Error *local_err = NULL;
1554
1555 v = string_output_visitor_new(human, &string);
1556 object_property_get(obj, v, name, &local_err);
1557 if (local_err) {
1558 error_propagate(errp, local_err);
1559 goto out;
1560 }
1561
1562 visit_complete(v, &string);
1563
1564 out:
1565 visit_free(v);
1566 return string;
1567 }
1568
1569 const char *object_property_get_type(Object *obj, const char *name, Error **errp)
1570 {
1571 ObjectProperty *prop = object_property_find(obj, name, errp);
1572 if (prop == NULL) {
1573 return NULL;
1574 }
1575
1576 return prop->type;
1577 }
1578
1579 Object *object_get_root(void)
1580 {
1581 static Object *root;
1582
1583 if (!root) {
1584 root = object_new("container");
1585 }
1586
1587 return root;
1588 }
1589
1590 Object *object_get_objects_root(void)
1591 {
1592 return container_get(object_get_root(), "/objects");
1593 }
1594
1595 Object *object_get_internal_root(void)
1596 {
1597 static Object *internal_root;
1598
1599 if (!internal_root) {
1600 internal_root = object_new("container");
1601 }
1602
1603 return internal_root;
1604 }
1605
1606 static void object_get_child_property(Object *obj, Visitor *v,
1607 const char *name, void *opaque,
1608 Error **errp)
1609 {
1610 Object *child = opaque;
1611 gchar *path;
1612
1613 path = object_get_canonical_path(child);
1614 visit_type_str(v, name, &path, errp);
1615 g_free(path);
1616 }
1617
1618 static Object *object_resolve_child_property(Object *parent, void *opaque, const gchar *part)
1619 {
1620 return opaque;
1621 }
1622
1623 static void object_finalize_child_property(Object *obj, const char *name,
1624 void *opaque)
1625 {
1626 Object *child = opaque;
1627
1628 if (child->class->unparent) {
1629 (child->class->unparent)(child);
1630 }
1631 child->parent = NULL;
1632 object_unref(child);
1633 }
1634
1635 void object_property_add_child(Object *obj, const char *name,
1636 Object *child, Error **errp)
1637 {
1638 Error *local_err = NULL;
1639 gchar *type;
1640 ObjectProperty *op;
1641
1642 if (child->parent != NULL) {
1643 error_setg(errp, "child object is already parented");
1644 return;
1645 }
1646
1647 type = g_strdup_printf("child<%s>", object_get_typename(OBJECT(child)));
1648
1649 op = object_property_add(obj, name, type, object_get_child_property, NULL,
1650 object_finalize_child_property, child, &local_err);
1651 if (local_err) {
1652 error_propagate(errp, local_err);
1653 goto out;
1654 }
1655
1656 op->resolve = object_resolve_child_property;
1657 object_ref(child);
1658 child->parent = obj;
1659
1660 out:
1661 g_free(type);
1662 }
1663
1664 void object_property_allow_set_link(const Object *obj, const char *name,
1665 Object *val, Error **errp)
1666 {
1667 /* Allow the link to be set, always */
1668 }
1669
1670 typedef struct {
1671 Object **child;
1672 void (*check)(const Object *, const char *, Object *, Error **);
1673 ObjectPropertyLinkFlags flags;
1674 } LinkProperty;
1675
1676 static void object_get_link_property(Object *obj, Visitor *v,
1677 const char *name, void *opaque,
1678 Error **errp)
1679 {
1680 LinkProperty *lprop = opaque;
1681 Object **child = lprop->child;
1682 gchar *path;
1683
1684 if (*child) {
1685 path = object_get_canonical_path(*child);
1686 visit_type_str(v, name, &path, errp);
1687 g_free(path);
1688 } else {
1689 path = (gchar *)"";
1690 visit_type_str(v, name, &path, errp);
1691 }
1692 }
1693
1694 /*
1695 * object_resolve_link:
1696 *
1697 * Lookup an object and ensure its type matches the link property type. This
1698 * is similar to object_resolve_path() except type verification against the
1699 * link property is performed.
1700 *
1701 * Returns: The matched object or NULL on path lookup failures.
1702 */
1703 static Object *object_resolve_link(Object *obj, const char *name,
1704 const char *path, Error **errp)
1705 {
1706 const char *type;
1707 gchar *target_type;
1708 bool ambiguous = false;
1709 Object *target;
1710
1711 /* Go from link<FOO> to FOO. */
1712 type = object_property_get_type(obj, name, NULL);
1713 target_type = g_strndup(&type[5], strlen(type) - 6);
1714 target = object_resolve_path_type(path, target_type, &ambiguous);
1715
1716 if (ambiguous) {
1717 error_setg(errp, "Path '%s' does not uniquely identify an object",
1718 path);
1719 } else if (!target) {
1720 target = object_resolve_path(path, &ambiguous);
1721 if (target || ambiguous) {
1722 error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, target_type);
1723 } else {
1724 error_set(errp, ERROR_CLASS_DEVICE_NOT_FOUND,
1725 "Device '%s' not found", path);
1726 }
1727 target = NULL;
1728 }
1729 g_free(target_type);
1730
1731 return target;
1732 }
1733
1734 static void object_set_link_property(Object *obj, Visitor *v,
1735 const char *name, void *opaque,
1736 Error **errp)
1737 {
1738 Error *local_err = NULL;
1739 LinkProperty *prop = opaque;
1740 Object **child = prop->child;
1741 Object *old_target = *child;
1742 Object *new_target = NULL;
1743 char *path = NULL;
1744
1745 visit_type_str(v, name, &path, &local_err);
1746
1747 if (!local_err && strcmp(path, "") != 0) {
1748 new_target = object_resolve_link(obj, name, path, &local_err);
1749 }
1750
1751 g_free(path);
1752 if (local_err) {
1753 error_propagate(errp, local_err);
1754 return;
1755 }
1756
1757 prop->check(obj, name, new_target, &local_err);
1758 if (local_err) {
1759 error_propagate(errp, local_err);
1760 return;
1761 }
1762
1763 *child = new_target;
1764 if (prop->flags == OBJ_PROP_LINK_STRONG) {
1765 object_ref(new_target);
1766 object_unref(old_target);
1767 }
1768 }
1769
1770 static Object *object_resolve_link_property(Object *parent, void *opaque, const gchar *part)
1771 {
1772 LinkProperty *lprop = opaque;
1773
1774 return *lprop->child;
1775 }
1776
1777 static void object_release_link_property(Object *obj, const char *name,
1778 void *opaque)
1779 {
1780 LinkProperty *prop = opaque;
1781
1782 if ((prop->flags & OBJ_PROP_LINK_STRONG) && *prop->child) {
1783 object_unref(*prop->child);
1784 }
1785 g_free(prop);
1786 }
1787
1788 void object_property_add_link(Object *obj, const char *name,
1789 const char *type, Object **child,
1790 void (*check)(const Object *, const char *,
1791 Object *, Error **),
1792 ObjectPropertyLinkFlags flags,
1793 Error **errp)
1794 {
1795 Error *local_err = NULL;
1796 LinkProperty *prop = g_malloc(sizeof(*prop));
1797 gchar *full_type;
1798 ObjectProperty *op;
1799
1800 prop->child = child;
1801 prop->check = check;
1802 prop->flags = flags;
1803
1804 full_type = g_strdup_printf("link<%s>", type);
1805
1806 op = object_property_add(obj, name, full_type,
1807 object_get_link_property,
1808 check ? object_set_link_property : NULL,
1809 object_release_link_property,
1810 prop,
1811 &local_err);
1812 if (local_err) {
1813 error_propagate(errp, local_err);
1814 g_free(prop);
1815 goto out;
1816 }
1817
1818 op->resolve = object_resolve_link_property;
1819
1820 out:
1821 g_free(full_type);
1822 }
1823
1824 void object_property_add_const_link(Object *obj, const char *name,
1825 Object *target, Error **errp)
1826 {
1827 char *link_type;
1828 ObjectProperty *op;
1829
1830 link_type = g_strdup_printf("link<%s>", object_get_typename(target));
1831 op = object_property_add(obj, name, link_type,
1832 object_get_child_property, NULL,
1833 NULL, target, errp);
1834 if (op != NULL) {
1835 op->resolve = object_resolve_child_property;
1836 }
1837 g_free(link_type);
1838 }
1839
1840 gchar *object_get_canonical_path_component(Object *obj)
1841 {
1842 ObjectProperty *prop = NULL;
1843 GHashTableIter iter;
1844
1845 if (obj->parent == NULL) {
1846 return NULL;
1847 }
1848
1849 g_hash_table_iter_init(&iter, obj->parent->properties);
1850 while (g_hash_table_iter_next(&iter, NULL, (gpointer *)&prop)) {
1851 if (!object_property_is_child(prop)) {
1852 continue;
1853 }
1854
1855 if (prop->opaque == obj) {
1856 return g_strdup(prop->name);
1857 }
1858 }
1859
1860 /* obj had a parent but was not a child, should never happen */
1861 g_assert_not_reached();
1862 return NULL;
1863 }
1864
1865 gchar *object_get_canonical_path(Object *obj)
1866 {
1867 Object *root = object_get_root();
1868 char *newpath, *path = NULL;
1869
1870 if (obj == root) {
1871 return g_strdup("/");
1872 }
1873
1874 do {
1875 char *component = object_get_canonical_path_component(obj);
1876
1877 if (!component) {
1878 /* A canonical path must be complete, so discard what was
1879 * collected so far.
1880 */
1881 g_free(path);
1882 return NULL;
1883 }
1884
1885 newpath = g_strdup_printf("/%s%s", component, path ? path : "");
1886 g_free(path);
1887 g_free(component);
1888 path = newpath;
1889 obj = obj->parent;
1890 } while (obj != root);
1891
1892 return path;
1893 }
1894
1895 Object *object_resolve_path_component(Object *parent, const gchar *part)
1896 {
1897 ObjectProperty *prop = object_property_find(parent, part, NULL);
1898 if (prop == NULL) {
1899 return NULL;
1900 }
1901
1902 if (prop->resolve) {
1903 return prop->resolve(parent, prop->opaque, part);
1904 } else {
1905 return NULL;
1906 }
1907 }
1908
1909 static Object *object_resolve_abs_path(Object *parent,
1910 gchar **parts,
1911 const char *typename,
1912 int index)
1913 {
1914 Object *child;
1915
1916 if (parts[index] == NULL) {
1917 return object_dynamic_cast(parent, typename);
1918 }
1919
1920 if (strcmp(parts[index], "") == 0) {
1921 return object_resolve_abs_path(parent, parts, typename, index + 1);
1922 }
1923
1924 child = object_resolve_path_component(parent, parts[index]);
1925 if (!child) {
1926 return NULL;
1927 }
1928
1929 return object_resolve_abs_path(child, parts, typename, index + 1);
1930 }
1931
1932 static Object *object_resolve_partial_path(Object *parent,
1933 gchar **parts,
1934 const char *typename,
1935 bool *ambiguous)
1936 {
1937 Object *obj;
1938 GHashTableIter iter;
1939 ObjectProperty *prop;
1940
1941 obj = object_resolve_abs_path(parent, parts, typename, 0);
1942
1943 g_hash_table_iter_init(&iter, parent->properties);
1944 while (g_hash_table_iter_next(&iter, NULL, (gpointer *)&prop)) {
1945 Object *found;
1946
1947 if (!object_property_is_child(prop)) {
1948 continue;
1949 }
1950
1951 found = object_resolve_partial_path(prop->opaque, parts,
1952 typename, ambiguous);
1953 if (found) {
1954 if (obj) {
1955 *ambiguous = true;
1956 return NULL;
1957 }
1958 obj = found;
1959 }
1960
1961 if (*ambiguous) {
1962 return NULL;
1963 }
1964 }
1965
1966 return obj;
1967 }
1968
1969 Object *object_resolve_path_type(const char *path, const char *typename,
1970 bool *ambiguousp)
1971 {
1972 Object *obj;
1973 gchar **parts;
1974
1975 parts = g_strsplit(path, "/", 0);
1976 assert(parts);
1977
1978 if (parts[0] == NULL || strcmp(parts[0], "") != 0) {
1979 bool ambiguous = false;
1980 obj = object_resolve_partial_path(object_get_root(), parts,
1981 typename, &ambiguous);
1982 if (ambiguousp) {
1983 *ambiguousp = ambiguous;
1984 }
1985 } else {
1986 obj = object_resolve_abs_path(object_get_root(), parts, typename, 1);
1987 }
1988
1989 g_strfreev(parts);
1990
1991 return obj;
1992 }
1993
1994 Object *object_resolve_path(const char *path, bool *ambiguous)
1995 {
1996 return object_resolve_path_type(path, TYPE_OBJECT, ambiguous);
1997 }
1998
1999 typedef struct StringProperty
2000 {
2001 char *(*get)(Object *, Error **);
2002 void (*set)(Object *, const char *, Error **);
2003 } StringProperty;
2004
2005 static void property_get_str(Object *obj, Visitor *v, const char *name,
2006 void *opaque, Error **errp)
2007 {
2008 StringProperty *prop = opaque;
2009 char *value;
2010 Error *err = NULL;
2011
2012 value = prop->get(obj, &err);
2013 if (err) {
2014 error_propagate(errp, err);
2015 return;
2016 }
2017
2018 visit_type_str(v, name, &value, errp);
2019 g_free(value);
2020 }
2021
2022 static void property_set_str(Object *obj, Visitor *v, const char *name,
2023 void *opaque, Error **errp)
2024 {
2025 StringProperty *prop = opaque;
2026 char *value;
2027 Error *local_err = NULL;
2028
2029 visit_type_str(v, name, &value, &local_err);
2030 if (local_err) {
2031 error_propagate(errp, local_err);
2032 return;
2033 }
2034
2035 prop->set(obj, value, errp);
2036 g_free(value);
2037 }
2038
2039 static void property_release_str(Object *obj, const char *name,
2040 void *opaque)
2041 {
2042 StringProperty *prop = opaque;
2043 g_free(prop);
2044 }
2045
2046 void object_property_add_str(Object *obj, const char *name,
2047 char *(*get)(Object *, Error **),
2048 void (*set)(Object *, const char *, Error **),
2049 Error **errp)
2050 {
2051 Error *local_err = NULL;
2052 StringProperty *prop = g_malloc0(sizeof(*prop));
2053
2054 prop->get = get;
2055 prop->set = set;
2056
2057 object_property_add(obj, name, "string",
2058 get ? property_get_str : NULL,
2059 set ? property_set_str : NULL,
2060 property_release_str,
2061 prop, &local_err);
2062 if (local_err) {
2063 error_propagate(errp, local_err);
2064 g_free(prop);
2065 }
2066 }
2067
2068 ObjectProperty *
2069 object_class_property_add_str(ObjectClass *klass, const char *name,
2070 char *(*get)(Object *, Error **),
2071 void (*set)(Object *, const char *,
2072 Error **),
2073 Error **errp)
2074 {
2075 Error *local_err = NULL;
2076 StringProperty *prop = g_malloc0(sizeof(*prop));
2077 ObjectProperty *rv;
2078
2079 prop->get = get;
2080 prop->set = set;
2081
2082 rv = object_class_property_add(klass, name, "string",
2083 get ? property_get_str : NULL,
2084 set ? property_set_str : NULL,
2085 property_release_str,
2086 prop, &local_err);
2087 if (local_err) {
2088 error_propagate(errp, local_err);
2089 g_free(prop);
2090 }
2091
2092 return rv;
2093 }
2094
2095 typedef struct BoolProperty
2096 {
2097 bool (*get)(Object *, Error **);
2098 void (*set)(Object *, bool, Error **);
2099 } BoolProperty;
2100
2101 static void property_get_bool(Object *obj, Visitor *v, const char *name,
2102 void *opaque, Error **errp)
2103 {
2104 BoolProperty *prop = opaque;
2105 bool value;
2106 Error *err = NULL;
2107
2108 value = prop->get(obj, &err);
2109 if (err) {
2110 error_propagate(errp, err);
2111 return;
2112 }
2113
2114 visit_type_bool(v, name, &value, errp);
2115 }
2116
2117 static void property_set_bool(Object *obj, Visitor *v, const char *name,
2118 void *opaque, Error **errp)
2119 {
2120 BoolProperty *prop = opaque;
2121 bool value;
2122 Error *local_err = NULL;
2123
2124 visit_type_bool(v, name, &value, &local_err);
2125 if (local_err) {
2126 error_propagate(errp, local_err);
2127 return;
2128 }
2129
2130 prop->set(obj, value, errp);
2131 }
2132
2133 static void property_release_bool(Object *obj, const char *name,
2134 void *opaque)
2135 {
2136 BoolProperty *prop = opaque;
2137 g_free(prop);
2138 }
2139
2140 void object_property_add_bool(Object *obj, const char *name,
2141 bool (*get)(Object *, Error **),
2142 void (*set)(Object *, bool, Error **),
2143 Error **errp)
2144 {
2145 Error *local_err = NULL;
2146 BoolProperty *prop = g_malloc0(sizeof(*prop));
2147
2148 prop->get = get;
2149 prop->set = set;
2150
2151 object_property_add(obj, name, "bool",
2152 get ? property_get_bool : NULL,
2153 set ? property_set_bool : NULL,
2154 property_release_bool,
2155 prop, &local_err);
2156 if (local_err) {
2157 error_propagate(errp, local_err);
2158 g_free(prop);
2159 }
2160 }
2161
2162 ObjectProperty *
2163 object_class_property_add_bool(ObjectClass *klass, const char *name,
2164 bool (*get)(Object *, Error **),
2165 void (*set)(Object *, bool, Error **),
2166 Error **errp)
2167 {
2168 Error *local_err = NULL;
2169 BoolProperty *prop = g_malloc0(sizeof(*prop));
2170 ObjectProperty *rv;
2171
2172 prop->get = get;
2173 prop->set = set;
2174
2175 rv = object_class_property_add(klass, name, "bool",
2176 get ? property_get_bool : NULL,
2177 set ? property_set_bool : NULL,
2178 property_release_bool,
2179 prop, &local_err);
2180 if (local_err) {
2181 error_propagate(errp, local_err);
2182 g_free(prop);
2183 }
2184
2185 return rv;
2186 }
2187
2188 static void property_get_enum(Object *obj, Visitor *v, const char *name,
2189 void *opaque, Error **errp)
2190 {
2191 EnumProperty *prop = opaque;
2192 int value;
2193 Error *err = NULL;
2194
2195 value = prop->get(obj, &err);
2196 if (err) {
2197 error_propagate(errp, err);
2198 return;
2199 }
2200
2201 visit_type_enum(v, name, &value, prop->lookup, errp);
2202 }
2203
2204 static void property_set_enum(Object *obj, Visitor *v, const char *name,
2205 void *opaque, Error **errp)
2206 {
2207 EnumProperty *prop = opaque;
2208 int value;
2209 Error *err = NULL;
2210
2211 visit_type_enum(v, name, &value, prop->lookup, &err);
2212 if (err) {
2213 error_propagate(errp, err);
2214 return;
2215 }
2216 prop->set(obj, value, errp);
2217 }
2218
2219 static void property_release_enum(Object *obj, const char *name,
2220 void *opaque)
2221 {
2222 EnumProperty *prop = opaque;
2223 g_free(prop);
2224 }
2225
2226 void object_property_add_enum(Object *obj, const char *name,
2227 const char *typename,
2228 const QEnumLookup *lookup,
2229 int (*get)(Object *, Error **),
2230 void (*set)(Object *, int, Error **),
2231 Error **errp)
2232 {
2233 Error *local_err = NULL;
2234 EnumProperty *prop = g_malloc(sizeof(*prop));
2235
2236 prop->lookup = lookup;
2237 prop->get = get;
2238 prop->set = set;
2239
2240 object_property_add(obj, name, typename,
2241 get ? property_get_enum : NULL,
2242 set ? property_set_enum : NULL,
2243 property_release_enum,
2244 prop, &local_err);
2245 if (local_err) {
2246 error_propagate(errp, local_err);
2247 g_free(prop);
2248 }
2249 }
2250
2251 ObjectProperty *
2252 object_class_property_add_enum(ObjectClass *klass, const char *name,
2253 const char *typename,
2254 const QEnumLookup *lookup,
2255 int (*get)(Object *, Error **),
2256 void (*set)(Object *, int, Error **),
2257 Error **errp)
2258 {
2259 Error *local_err = NULL;
2260 EnumProperty *prop = g_malloc(sizeof(*prop));
2261 ObjectProperty *rv;
2262
2263 prop->lookup = lookup;
2264 prop->get = get;
2265 prop->set = set;
2266
2267 rv = object_class_property_add(klass, name, typename,
2268 get ? property_get_enum : NULL,
2269 set ? property_set_enum : NULL,
2270 property_release_enum,
2271 prop, &local_err);
2272 if (local_err) {
2273 error_propagate(errp, local_err);
2274 g_free(prop);
2275 }
2276
2277 return rv;
2278 }
2279
2280 typedef struct TMProperty {
2281 void (*get)(Object *, struct tm *, Error **);
2282 } TMProperty;
2283
2284 static void property_get_tm(Object *obj, Visitor *v, const char *name,
2285 void *opaque, Error **errp)
2286 {
2287 TMProperty *prop = opaque;
2288 Error *err = NULL;
2289 struct tm value;
2290
2291 prop->get(obj, &value, &err);
2292 if (err) {
2293 goto out;
2294 }
2295
2296 visit_start_struct(v, name, NULL, 0, &err);
2297 if (err) {
2298 goto out;
2299 }
2300 visit_type_int32(v, "tm_year", &value.tm_year, &err);
2301 if (err) {
2302 goto out_end;
2303 }
2304 visit_type_int32(v, "tm_mon", &value.tm_mon, &err);
2305 if (err) {
2306 goto out_end;
2307 }
2308 visit_type_int32(v, "tm_mday", &value.tm_mday, &err);
2309 if (err) {
2310 goto out_end;
2311 }
2312 visit_type_int32(v, "tm_hour", &value.tm_hour, &err);
2313 if (err) {
2314 goto out_end;
2315 }
2316 visit_type_int32(v, "tm_min", &value.tm_min, &err);
2317 if (err) {
2318 goto out_end;
2319 }
2320 visit_type_int32(v, "tm_sec", &value.tm_sec, &err);
2321 if (err) {
2322 goto out_end;
2323 }
2324 visit_check_struct(v, &err);
2325 out_end:
2326 visit_end_struct(v, NULL);
2327 out:
2328 error_propagate(errp, err);
2329
2330 }
2331
2332 static void property_release_tm(Object *obj, const char *name,
2333 void *opaque)
2334 {
2335 TMProperty *prop = opaque;
2336 g_free(prop);
2337 }
2338
2339 void object_property_add_tm(Object *obj, const char *name,
2340 void (*get)(Object *, struct tm *, Error **),
2341 Error **errp)
2342 {
2343 Error *local_err = NULL;
2344 TMProperty *prop = g_malloc0(sizeof(*prop));
2345
2346 prop->get = get;
2347
2348 object_property_add(obj, name, "struct tm",
2349 get ? property_get_tm : NULL, NULL,
2350 property_release_tm,
2351 prop, &local_err);
2352 if (local_err) {
2353 error_propagate(errp, local_err);
2354 g_free(prop);
2355 }
2356 }
2357
2358 ObjectProperty *
2359 object_class_property_add_tm(ObjectClass *klass, const char *name,
2360 void (*get)(Object *, struct tm *, Error **),
2361 Error **errp)
2362 {
2363 Error *local_err = NULL;
2364 TMProperty *prop = g_malloc0(sizeof(*prop));
2365 ObjectProperty *rv;
2366
2367 prop->get = get;
2368
2369 rv = object_class_property_add(klass, name, "struct tm",
2370 get ? property_get_tm : NULL, NULL,
2371 property_release_tm,
2372 prop, &local_err);
2373 if (local_err) {
2374 error_propagate(errp, local_err);
2375 g_free(prop);
2376 }
2377
2378 return rv;
2379 }
2380
2381 static char *qdev_get_type(Object *obj, Error **errp)
2382 {
2383 return g_strdup(object_get_typename(obj));
2384 }
2385
2386 static void property_get_uint8_ptr(Object *obj, Visitor *v, const char *name,
2387 void *opaque, Error **errp)
2388 {
2389 uint8_t value = *(uint8_t *)opaque;
2390 visit_type_uint8(v, name, &value, errp);
2391 }
2392
2393 static void property_get_uint16_ptr(Object *obj, Visitor *v, const char *name,
2394 void *opaque, Error **errp)
2395 {
2396 uint16_t value = *(uint16_t *)opaque;
2397 visit_type_uint16(v, name, &value, errp);
2398 }
2399
2400 static void property_get_uint32_ptr(Object *obj, Visitor *v, const char *name,
2401 void *opaque, Error **errp)
2402 {
2403 uint32_t value = *(uint32_t *)opaque;
2404 visit_type_uint32(v, name, &value, errp);
2405 }
2406
2407 static void property_get_uint64_ptr(Object *obj, Visitor *v, const char *name,
2408 void *opaque, Error **errp)
2409 {
2410 uint64_t value = *(uint64_t *)opaque;
2411 visit_type_uint64(v, name, &value, errp);
2412 }
2413
2414 void object_property_add_uint8_ptr(Object *obj, const char *name,
2415 const uint8_t *v, Error **errp)
2416 {
2417 object_property_add(obj, name, "uint8", property_get_uint8_ptr,
2418 NULL, NULL, (void *)v, errp);
2419 }
2420
2421 ObjectProperty *
2422 object_class_property_add_uint8_ptr(ObjectClass *klass, const char *name,
2423 const uint8_t *v, Error **errp)
2424 {
2425 return object_class_property_add(klass, name, "uint8",
2426 property_get_uint8_ptr,
2427 NULL, NULL, (void *)v, errp);
2428 }
2429
2430 void object_property_add_uint16_ptr(Object *obj, const char *name,
2431 const uint16_t *v, Error **errp)
2432 {
2433 object_property_add(obj, name, "uint16", property_get_uint16_ptr,
2434 NULL, NULL, (void *)v, errp);
2435 }
2436
2437 ObjectProperty *
2438 object_class_property_add_uint16_ptr(ObjectClass *klass, const char *name,
2439 const uint16_t *v, Error **errp)
2440 {
2441 return object_class_property_add(klass, name, "uint16",
2442 property_get_uint16_ptr,
2443 NULL, NULL, (void *)v, errp);
2444 }
2445
2446 void object_property_add_uint32_ptr(Object *obj, const char *name,
2447 const uint32_t *v, Error **errp)
2448 {
2449 object_property_add(obj, name, "uint32", property_get_uint32_ptr,
2450 NULL, NULL, (void *)v, errp);
2451 }
2452
2453 ObjectProperty *
2454 object_class_property_add_uint32_ptr(ObjectClass *klass, const char *name,
2455 const uint32_t *v, Error **errp)
2456 {
2457 return object_class_property_add(klass, name, "uint32",
2458 property_get_uint32_ptr,
2459 NULL, NULL, (void *)v, errp);
2460 }
2461
2462 void object_property_add_uint64_ptr(Object *obj, const char *name,
2463 const uint64_t *v, Error **errp)
2464 {
2465 object_property_add(obj, name, "uint64", property_get_uint64_ptr,
2466 NULL, NULL, (void *)v, errp);
2467 }
2468
2469 ObjectProperty *
2470 object_class_property_add_uint64_ptr(ObjectClass *klass, const char *name,
2471 const uint64_t *v, Error **errp)
2472 {
2473 return object_class_property_add(klass, name, "uint64",
2474 property_get_uint64_ptr,
2475 NULL, NULL, (void *)v, errp);
2476 }
2477
2478 typedef struct {
2479 Object *target_obj;
2480 char *target_name;
2481 } AliasProperty;
2482
2483 static void property_get_alias(Object *obj, Visitor *v, const char *name,
2484 void *opaque, Error **errp)
2485 {
2486 AliasProperty *prop = opaque;
2487
2488 object_property_get(prop->target_obj, v, prop->target_name, errp);
2489 }
2490
2491 static void property_set_alias(Object *obj, Visitor *v, const char *name,
2492 void *opaque, Error **errp)
2493 {
2494 AliasProperty *prop = opaque;
2495
2496 object_property_set(prop->target_obj, v, prop->target_name, errp);
2497 }
2498
2499 static Object *property_resolve_alias(Object *obj, void *opaque,
2500 const gchar *part)
2501 {
2502 AliasProperty *prop = opaque;
2503
2504 return object_resolve_path_component(prop->target_obj, prop->target_name);
2505 }
2506
2507 static void property_release_alias(Object *obj, const char *name, void *opaque)
2508 {
2509 AliasProperty *prop = opaque;
2510
2511 g_free(prop->target_name);
2512 g_free(prop);
2513 }
2514
2515 void object_property_add_alias(Object *obj, const char *name,
2516 Object *target_obj, const char *target_name,
2517 Error **errp)
2518 {
2519 AliasProperty *prop;
2520 ObjectProperty *op;
2521 ObjectProperty *target_prop;
2522 gchar *prop_type;
2523 Error *local_err = NULL;
2524
2525 target_prop = object_property_find(target_obj, target_name, errp);
2526 if (!target_prop) {
2527 return;
2528 }
2529
2530 if (object_property_is_child(target_prop)) {
2531 prop_type = g_strdup_printf("link%s",
2532 target_prop->type + strlen("child"));
2533 } else {
2534 prop_type = g_strdup(target_prop->type);
2535 }
2536
2537 prop = g_malloc(sizeof(*prop));
2538 prop->target_obj = target_obj;
2539 prop->target_name = g_strdup(target_name);
2540
2541 op = object_property_add(obj, name, prop_type,
2542 property_get_alias,
2543 property_set_alias,
2544 property_release_alias,
2545 prop, &local_err);
2546 if (local_err) {
2547 error_propagate(errp, local_err);
2548 g_free(prop);
2549 goto out;
2550 }
2551 op->resolve = property_resolve_alias;
2552
2553 object_property_set_description(obj, op->name,
2554 target_prop->description,
2555 &error_abort);
2556
2557 out:
2558 g_free(prop_type);
2559 }
2560
2561 void object_property_set_description(Object *obj, const char *name,
2562 const char *description, Error **errp)
2563 {
2564 ObjectProperty *op;
2565
2566 op = object_property_find(obj, name, errp);
2567 if (!op) {
2568 return;
2569 }
2570
2571 g_free(op->description);
2572 op->description = g_strdup(description);
2573 }
2574
2575 void object_class_property_set_description(ObjectClass *klass,
2576 const char *name,
2577 const char *description,
2578 Error **errp)
2579 {
2580 ObjectProperty *op;
2581
2582 op = g_hash_table_lookup(klass->properties, name);
2583 if (!op) {
2584 error_setg(errp, "Property '.%s' not found", name);
2585 return;
2586 }
2587
2588 g_free(op->description);
2589 op->description = g_strdup(description);
2590 }
2591
2592 static void object_class_init(ObjectClass *klass, void *data)
2593 {
2594 object_class_property_add_str(klass, "type", qdev_get_type,
2595 NULL, &error_abort);
2596 }
2597
2598 static void register_types(void)
2599 {
2600 static TypeInfo interface_info = {
2601 .name = TYPE_INTERFACE,
2602 .class_size = sizeof(InterfaceClass),
2603 .abstract = true,
2604 };
2605
2606 static TypeInfo object_info = {
2607 .name = TYPE_OBJECT,
2608 .instance_size = sizeof(Object),
2609 .class_init = object_class_init,
2610 .abstract = true,
2611 };
2612
2613 type_interface = type_register_internal(&interface_info);
2614 type_register_internal(&object_info);
2615 }
2616
2617 type_init(register_types)