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