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