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     /*
 575      * Since object_property_add_child added a reference to the child object,
 576      * we can drop the reference added by object_initialize(), so the child
 577      * property will own the only reference to the object.
 578      */
 579     object_unref(obj);
 580
 581 out:
 582     if (local_err) {
 583         error_propagate(errp, local_err);
 584         object_unref(obj);
 585     }
 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, Error **errp)
 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, NULL);
 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         gchar *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     Error *err = NULL;
1525     Visitor *v;
1526     char *str;
1527     int ret;
1528     ObjectProperty *prop = object_property_find(obj, name, errp);
1529     EnumProperty *enumprop;
1530
1531     if (prop == NULL) {
1532         return 0;
1533     }
1534
1535     if (!g_str_equal(prop->type, typename)) {
1536         error_setg(errp, "Property %s on %s is not '%s' enum type",
1537                    name, object_class_get_name(
1538                        object_get_class(obj)), typename);
1539         return 0;
1540     }
1541
1542     enumprop = prop->opaque;
1543
1544     v = string_output_visitor_new(false, &str);
1545     object_property_get(obj, v, name, &err);
1546     if (err) {
1547         error_propagate(errp, err);
1548         visit_free(v);
1549         return 0;
1550     }
1551     visit_complete(v, &str);
1552     visit_free(v);
1553     v = string_input_visitor_new(str);
1554     visit_type_enum(v, name, &ret, enumprop->lookup, errp);
1555
1556     g_free(str);
1557     visit_free(v);
1558
1559     return ret;
1560 }
1561
1562 void object_property_get_uint16List(Object *obj, const char *name,
1563                                     uint16List **list, Error **errp)
1564 {
1565     Error *err = NULL;
1566     Visitor *v;
1567     char *str;
1568
1569     v = string_output_visitor_new(false, &str);
1570     object_property_get(obj, v, name, &err);
1571     if (err) {
1572         error_propagate(errp, err);
1573         goto out;
1574     }
1575     visit_complete(v, &str);
1576     visit_free(v);
1577     v = string_input_visitor_new(str);
1578     visit_type_uint16List(v, NULL, list, errp);
1579
1580     g_free(str);
1581 out:
1582     visit_free(v);
1583 }
1584
1585 void object_property_parse(Object *obj, const char *string,
1586                            const char *name, Error **errp)
1587 {
1588     Visitor *v = string_input_visitor_new(string);
1589     object_property_set(obj, v, name, errp);
1590     visit_free(v);
1591 }
1592
1593 char *object_property_print(Object *obj, const char *name, bool human,
1594                             Error **errp)
1595 {
1596     Visitor *v;
1597     char *string = NULL;
1598     Error *local_err = NULL;
1599
1600     v = string_output_visitor_new(human, &string);
1601     object_property_get(obj, v, name, &local_err);
1602     if (local_err) {
1603         error_propagate(errp, local_err);
1604         goto out;
1605     }
1606
1607     visit_complete(v, &string);
1608
1609 out:
1610     visit_free(v);
1611     return string;
1612 }
1613
1614 const char *object_property_get_type(Object *obj, const char *name, Error **errp)
1615 {
1616     ObjectProperty *prop = object_property_find(obj, name, errp);
1617     if (prop == NULL) {
1618         return NULL;
1619     }
1620
1621     return prop->type;
1622 }
1623
1624 Object *object_get_root(void)
1625 {
1626     static Object *root;
1627
1628     if (!root) {
1629         root = object_new("container");
1630     }
1631
1632     return root;
1633 }
1634
1635 Object *object_get_objects_root(void)
1636 {
1637     return container_get(object_get_root(), "/objects");
1638 }
1639
1640 Object *object_get_internal_root(void)
1641 {
1642     static Object *internal_root;
1643
1644     if (!internal_root) {
1645         internal_root = object_new("container");
1646     }
1647
1648     return internal_root;
1649 }
1650
1651 static void object_get_child_property(Object *obj, Visitor *v,
1652                                       const char *name, void *opaque,
1653                                       Error **errp)
1654 {
1655     Object *child = opaque;
1656     gchar *path;
1657
1658     path = object_get_canonical_path(child);
1659     visit_type_str(v, name, &path, errp);
1660     g_free(path);
1661 }
1662
1663 static Object *object_resolve_child_property(Object *parent, void *opaque, const gchar *part)
1664 {
1665     return opaque;
1666 }
1667
1668 static void object_finalize_child_property(Object *obj, const char *name,
1669                                            void *opaque)
1670 {
1671     Object *child = opaque;
1672
1673     if (child->class->unparent) {
1674         (child->class->unparent)(child);
1675     }
1676     child->parent = NULL;
1677     object_unref(child);
1678 }
1679
1680 void object_property_add_child(Object *obj, const char *name,
1681                                Object *child, Error **errp)
1682 {
1683     Error *local_err = NULL;
1684     gchar *type;
1685     ObjectProperty *op;
1686
1687     if (child->parent != NULL) {
1688         error_setg(errp, "child object is already parented");
1689         return;
1690     }
1691
1692     type = g_strdup_printf("child<%s>", object_get_typename(OBJECT(child)));
1693
1694     op = object_property_add(obj, name, type, object_get_child_property, NULL,
1695                              object_finalize_child_property, child, &local_err);
1696     if (local_err) {
1697         error_propagate(errp, local_err);
1698         goto out;
1699     }
1700
1701     op->resolve = object_resolve_child_property;
1702     object_ref(child);
1703     child->parent = obj;
1704
1705 out:
1706     g_free(type);
1707 }
1708
1709 void object_property_allow_set_link(const Object *obj, const char *name,
1710                                     Object *val, Error **errp)
1711 {
1712     /* Allow the link to be set, always */
1713 }
1714
1715 typedef struct {
1716     union {
1717         Object **targetp;
1718         Object *target; /* if OBJ_PROP_LINK_DIRECT, when holding the pointer  */
1719         ptrdiff_t offset; /* if OBJ_PROP_LINK_CLASS */
1720     };
1721     void (*check)(const Object *, const char *, Object *, Error **);
1722     ObjectPropertyLinkFlags flags;
1723 } LinkProperty;
1724
1725 static Object **
1726 object_link_get_targetp(Object *obj, LinkProperty *lprop)
1727 {
1728     if (lprop->flags & OBJ_PROP_LINK_DIRECT) {
1729         return &lprop->target;
1730     } else if (lprop->flags & OBJ_PROP_LINK_CLASS) {
1731         return (void *)obj + lprop->offset;
1732     } else {
1733         return lprop->targetp;
1734     }
1735 }
1736
1737 static void object_get_link_property(Object *obj, Visitor *v,
1738                                      const char *name, void *opaque,
1739                                      Error **errp)
1740 {
1741     LinkProperty *lprop = opaque;
1742     Object **targetp = object_link_get_targetp(obj, lprop);
1743     gchar *path;
1744
1745     if (*targetp) {
1746         path = object_get_canonical_path(*targetp);
1747         visit_type_str(v, name, &path, errp);
1748         g_free(path);
1749     } else {
1750         path = (gchar *)"";
1751         visit_type_str(v, name, &path, errp);
1752     }
1753 }
1754
1755 /*
1756  * object_resolve_link:
1757  *
1758  * Lookup an object and ensure its type matches the link property type.  This
1759  * is similar to object_resolve_path() except type verification against the
1760  * link property is performed.
1761  *
1762  * Returns: The matched object or NULL on path lookup failures.
1763  */
1764 static Object *object_resolve_link(Object *obj, const char *name,
1765                                    const char *path, Error **errp)
1766 {
1767     const char *type;
1768     gchar *target_type;
1769     bool ambiguous = false;
1770     Object *target;
1771
1772     /* Go from link<FOO> to FOO.  */
1773     type = object_property_get_type(obj, name, NULL);
1774     target_type = g_strndup(&type[5], strlen(type) - 6);
1775     target = object_resolve_path_type(path, target_type, &ambiguous);
1776
1777     if (ambiguous) {
1778         error_setg(errp, "Path '%s' does not uniquely identify an object",
1779                    path);
1780     } else if (!target) {
1781         target = object_resolve_path(path, &ambiguous);
1782         if (target || ambiguous) {
1783             error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, target_type);
1784         } else {
1785             error_set(errp, ERROR_CLASS_DEVICE_NOT_FOUND,
1786                       "Device '%s' not found", path);
1787         }
1788         target = NULL;
1789     }
1790     g_free(target_type);
1791
1792     return target;
1793 }
1794
1795 static void object_set_link_property(Object *obj, Visitor *v,
1796                                      const char *name, void *opaque,
1797                                      Error **errp)
1798 {
1799     Error *local_err = NULL;
1800     LinkProperty *prop = opaque;
1801     Object **targetp = object_link_get_targetp(obj, prop);
1802     Object *old_target = *targetp;
1803     Object *new_target = NULL;
1804     char *path = NULL;
1805
1806     visit_type_str(v, name, &path, &local_err);
1807
1808     if (!local_err && strcmp(path, "") != 0) {
1809         new_target = object_resolve_link(obj, name, path, &local_err);
1810     }
1811
1812     g_free(path);
1813     if (local_err) {
1814         error_propagate(errp, local_err);
1815         return;
1816     }
1817
1818     prop->check(obj, name, new_target, &local_err);
1819     if (local_err) {
1820         error_propagate(errp, local_err);
1821         return;
1822     }
1823
1824     *targetp = new_target;
1825     if (prop->flags & OBJ_PROP_LINK_STRONG) {
1826         object_ref(new_target);
1827         object_unref(old_target);
1828     }
1829 }
1830
1831 static Object *object_resolve_link_property(Object *parent, void *opaque, const gchar *part)
1832 {
1833     LinkProperty *lprop = opaque;
1834
1835     return *object_link_get_targetp(parent, lprop);
1836 }
1837
1838 static void object_release_link_property(Object *obj, const char *name,
1839                                          void *opaque)
1840 {
1841     LinkProperty *prop = opaque;
1842     Object **targetp = object_link_get_targetp(obj, prop);
1843
1844     if ((prop->flags & OBJ_PROP_LINK_STRONG) && *targetp) {
1845         object_unref(*targetp);
1846     }
1847     if (!(prop->flags & OBJ_PROP_LINK_CLASS)) {
1848         g_free(prop);
1849     }
1850 }
1851
1852 static void object_add_link_prop(Object *obj, const char *name,
1853                                  const char *type, void *ptr,
1854                                  void (*check)(const Object *, const char *,
1855                                                Object *, Error **),
1856                                  ObjectPropertyLinkFlags flags,
1857                                  Error **errp)
1858 {
1859     Error *local_err = NULL;
1860     LinkProperty *prop = g_malloc(sizeof(*prop));
1861     gchar *full_type;
1862     ObjectProperty *op;
1863
1864     if (flags & OBJ_PROP_LINK_DIRECT) {
1865         prop->target = ptr;
1866     } else {
1867         prop->targetp = ptr;
1868     }
1869     prop->check = check;
1870     prop->flags = flags;
1871
1872     full_type = g_strdup_printf("link<%s>", type);
1873
1874     op = object_property_add(obj, name, full_type,
1875                              object_get_link_property,
1876                              check ? object_set_link_property : NULL,
1877                              object_release_link_property,
1878                              prop,
1879                              &local_err);
1880     if (local_err) {
1881         error_propagate(errp, local_err);
1882         g_free(prop);
1883         goto out;
1884     }
1885
1886     op->resolve = object_resolve_link_property;
1887
1888 out:
1889     g_free(full_type);
1890 }
1891
1892 void object_property_add_link(Object *obj, const char *name,
1893                               const char *type, Object **targetp,
1894                               void (*check)(const Object *, const char *,
1895                                             Object *, Error **),
1896                               ObjectPropertyLinkFlags flags,
1897                               Error **errp)
1898 {
1899     object_add_link_prop(obj, name, type, targetp, check, flags, errp);
1900 }
1901
1902 ObjectProperty *
1903 object_class_property_add_link(ObjectClass *oc,
1904     const char *name,
1905     const char *type, ptrdiff_t offset,
1906     void (*check)(const Object *obj, const char *name,
1907                   Object *val, Error **errp),
1908     ObjectPropertyLinkFlags flags,
1909     Error **errp)
1910 {
1911     Error *local_err = NULL;
1912     LinkProperty *prop = g_new0(LinkProperty, 1);
1913     gchar *full_type;
1914     ObjectProperty *op;
1915
1916     prop->offset = offset;
1917     prop->check = check;
1918     prop->flags = flags | OBJ_PROP_LINK_CLASS;
1919
1920     full_type = g_strdup_printf("link<%s>", type);
1921
1922     op = object_class_property_add(oc, name, full_type,
1923                                    object_get_link_property,
1924                                    check ? object_set_link_property : NULL,
1925                                    object_release_link_property,
1926                                    prop,
1927                                    &local_err);
1928     if (local_err) {
1929         error_propagate(errp, local_err);
1930         g_free(prop);
1931         goto out;
1932     }
1933
1934     op->resolve = object_resolve_link_property;
1935
1936 out:
1937     g_free(full_type);
1938     return op;
1939 }
1940
1941 void object_property_add_const_link(Object *obj, const char *name,
1942                                     Object *target, Error **errp)
1943 {
1944     object_add_link_prop(obj, name, object_get_typename(target), target,
1945                          NULL, OBJ_PROP_LINK_DIRECT, errp);
1946 }
1947
1948 gchar *object_get_canonical_path_component(Object *obj)
1949 {
1950     ObjectProperty *prop = NULL;
1951     GHashTableIter iter;
1952
1953     if (obj->parent == NULL) {
1954         return NULL;
1955     }
1956
1957     g_hash_table_iter_init(&iter, obj->parent->properties);
1958     while (g_hash_table_iter_next(&iter, NULL, (gpointer *)&prop)) {
1959         if (!object_property_is_child(prop)) {
1960             continue;
1961         }
1962
1963         if (prop->opaque == obj) {
1964             return g_strdup(prop->name);
1965         }
1966     }
1967
1968     /* obj had a parent but was not a child, should never happen */
1969     g_assert_not_reached();
1970     return NULL;
1971 }
1972
1973 gchar *object_get_canonical_path(Object *obj)
1974 {
1975     Object *root = object_get_root();
1976     char *newpath, *path = NULL;
1977
1978     if (obj == root) {
1979         return g_strdup("/");
1980     }
1981
1982     do {
1983         char *component = object_get_canonical_path_component(obj);
1984
1985         if (!component) {
1986             /* A canonical path must be complete, so discard what was
1987              * collected so far.
1988              */
1989             g_free(path);
1990             return NULL;
1991         }
1992
1993         newpath = g_strdup_printf("/%s%s", component, path ? path : "");
1994         g_free(path);
1995         g_free(component);
1996         path = newpath;
1997         obj = obj->parent;
1998     } while (obj != root);
1999
2000     return path;
2001 }
2002
2003 Object *object_resolve_path_component(Object *parent, const gchar *part)
2004 {
2005     ObjectProperty *prop = object_property_find(parent, part, NULL);
2006     if (prop == NULL) {
2007         return NULL;
2008     }
2009
2010     if (prop->resolve) {
2011         return prop->resolve(parent, prop->opaque, part);
2012     } else {
2013         return NULL;
2014     }
2015 }
2016
2017 static Object *object_resolve_abs_path(Object *parent,
2018                                           gchar **parts,
2019                                           const char *typename,
2020                                           int index)
2021 {
2022     Object *child;
2023
2024     if (parts[index] == NULL) {
2025         return object_dynamic_cast(parent, typename);
2026     }
2027
2028     if (strcmp(parts[index], "") == 0) {
2029         return object_resolve_abs_path(parent, parts, typename, index + 1);
2030     }
2031
2032     child = object_resolve_path_component(parent, parts[index]);
2033     if (!child) {
2034         return NULL;
2035     }
2036
2037     return object_resolve_abs_path(child, parts, typename, index + 1);
2038 }
2039
2040 static Object *object_resolve_partial_path(Object *parent,
2041                                               gchar **parts,
2042                                               const char *typename,
2043                                               bool *ambiguous)
2044 {
2045     Object *obj;
2046     GHashTableIter iter;
2047     ObjectProperty *prop;
2048
2049     obj = object_resolve_abs_path(parent, parts, typename, 0);
2050
2051     g_hash_table_iter_init(&iter, parent->properties);
2052     while (g_hash_table_iter_next(&iter, NULL, (gpointer *)&prop)) {
2053         Object *found;
2054
2055         if (!object_property_is_child(prop)) {
2056             continue;
2057         }
2058
2059         found = object_resolve_partial_path(prop->opaque, parts,
2060                                             typename, ambiguous);
2061         if (found) {
2062             if (obj) {
2063                 *ambiguous = true;
2064                 return NULL;
2065             }
2066             obj = found;
2067         }
2068
2069         if (*ambiguous) {
2070             return NULL;
2071         }
2072     }
2073
2074     return obj;
2075 }
2076
2077 Object *object_resolve_path_type(const char *path, const char *typename,
2078                                  bool *ambiguousp)
2079 {
2080     Object *obj;
2081     gchar **parts;
2082
2083     parts = g_strsplit(path, "/", 0);
2084     assert(parts);
2085
2086     if (parts[0] == NULL || strcmp(parts[0], "") != 0) {
2087         bool ambiguous = false;
2088         obj = object_resolve_partial_path(object_get_root(), parts,
2089                                           typename, &ambiguous);
2090         if (ambiguousp) {
2091             *ambiguousp = ambiguous;
2092         }
2093     } else {
2094         obj = object_resolve_abs_path(object_get_root(), parts, typename, 1);
2095     }
2096
2097     g_strfreev(parts);
2098
2099     return obj;
2100 }
2101
2102 Object *object_resolve_path(const char *path, bool *ambiguous)
2103 {
2104     return object_resolve_path_type(path, TYPE_OBJECT, ambiguous);
2105 }
2106
2107 typedef struct StringProperty
2108 {
2109     char *(*get)(Object *, Error **);
2110     void (*set)(Object *, const char *, Error **);
2111 } StringProperty;
2112
2113 static void property_get_str(Object *obj, Visitor *v, const char *name,
2114                              void *opaque, Error **errp)
2115 {
2116     StringProperty *prop = opaque;
2117     char *value;
2118     Error *err = NULL;
2119
2120     value = prop->get(obj, &err);
2121     if (err) {
2122         error_propagate(errp, err);
2123         return;
2124     }
2125
2126     visit_type_str(v, name, &value, errp);
2127     g_free(value);
2128 }
2129
2130 static void property_set_str(Object *obj, Visitor *v, const char *name,
2131                              void *opaque, Error **errp)
2132 {
2133     StringProperty *prop = opaque;
2134     char *value;
2135     Error *local_err = NULL;
2136
2137     visit_type_str(v, name, &value, &local_err);
2138     if (local_err) {
2139         error_propagate(errp, local_err);
2140         return;
2141     }
2142
2143     prop->set(obj, value, errp);
2144     g_free(value);
2145 }
2146
2147 static void property_release_str(Object *obj, const char *name,
2148                                  void *opaque)
2149 {
2150     StringProperty *prop = opaque;
2151     g_free(prop);
2152 }
2153
2154 void object_property_add_str(Object *obj, const char *name,
2155                            char *(*get)(Object *, Error **),
2156                            void (*set)(Object *, const char *, Error **),
2157                            Error **errp)
2158 {
2159     Error *local_err = NULL;
2160     StringProperty *prop = g_malloc0(sizeof(*prop));
2161
2162     prop->get = get;
2163     prop->set = set;
2164
2165     object_property_add(obj, name, "string",
2166                         get ? property_get_str : NULL,
2167                         set ? property_set_str : NULL,
2168                         property_release_str,
2169                         prop, &local_err);
2170     if (local_err) {
2171         error_propagate(errp, local_err);
2172         g_free(prop);
2173     }
2174 }
2175
2176 ObjectProperty *
2177 object_class_property_add_str(ObjectClass *klass, const char *name,
2178                                    char *(*get)(Object *, Error **),
2179                                    void (*set)(Object *, const char *,
2180                                                Error **),
2181                                    Error **errp)
2182 {
2183     Error *local_err = NULL;
2184     StringProperty *prop = g_malloc0(sizeof(*prop));
2185     ObjectProperty *rv;
2186
2187     prop->get = get;
2188     prop->set = set;
2189
2190     rv = object_class_property_add(klass, name, "string",
2191                               get ? property_get_str : NULL,
2192                               set ? property_set_str : NULL,
2193                               NULL,
2194                               prop, &local_err);
2195     if (local_err) {
2196         error_propagate(errp, local_err);
2197         g_free(prop);
2198     }
2199
2200     return rv;
2201 }
2202
2203 typedef struct BoolProperty
2204 {
2205     bool (*get)(Object *, Error **);
2206     void (*set)(Object *, bool, Error **);
2207 } BoolProperty;
2208
2209 static void property_get_bool(Object *obj, Visitor *v, const char *name,
2210                               void *opaque, Error **errp)
2211 {
2212     BoolProperty *prop = opaque;
2213     bool value;
2214     Error *err = NULL;
2215
2216     value = prop->get(obj, &err);
2217     if (err) {
2218         error_propagate(errp, err);
2219         return;
2220     }
2221
2222     visit_type_bool(v, name, &value, errp);
2223 }
2224
2225 static void property_set_bool(Object *obj, Visitor *v, const char *name,
2226                               void *opaque, Error **errp)
2227 {
2228     BoolProperty *prop = opaque;
2229     bool value;
2230     Error *local_err = NULL;
2231
2232     visit_type_bool(v, name, &value, &local_err);
2233     if (local_err) {
2234         error_propagate(errp, local_err);
2235         return;
2236     }
2237
2238     prop->set(obj, value, errp);
2239 }
2240
2241 static void property_release_bool(Object *obj, const char *name,
2242                                   void *opaque)
2243 {
2244     BoolProperty *prop = opaque;
2245     g_free(prop);
2246 }
2247
2248 void object_property_add_bool(Object *obj, const char *name,
2249                               bool (*get)(Object *, Error **),
2250                               void (*set)(Object *, bool, Error **),
2251                               Error **errp)
2252 {
2253     Error *local_err = NULL;
2254     BoolProperty *prop = g_malloc0(sizeof(*prop));
2255
2256     prop->get = get;
2257     prop->set = set;
2258
2259     object_property_add(obj, name, "bool",
2260                         get ? property_get_bool : NULL,
2261                         set ? property_set_bool : NULL,
2262                         property_release_bool,
2263                         prop, &local_err);
2264     if (local_err) {
2265         error_propagate(errp, local_err);
2266         g_free(prop);
2267     }
2268 }
2269
2270 ObjectProperty *
2271 object_class_property_add_bool(ObjectClass *klass, const char *name,
2272                                     bool (*get)(Object *, Error **),
2273                                     void (*set)(Object *, bool, Error **),
2274                                     Error **errp)
2275 {
2276     Error *local_err = NULL;
2277     BoolProperty *prop = g_malloc0(sizeof(*prop));
2278     ObjectProperty *rv;
2279
2280     prop->get = get;
2281     prop->set = set;
2282
2283     rv = object_class_property_add(klass, name, "bool",
2284                               get ? property_get_bool : NULL,
2285                               set ? property_set_bool : NULL,
2286                               NULL,
2287                               prop, &local_err);
2288     if (local_err) {
2289         error_propagate(errp, local_err);
2290         g_free(prop);
2291     }
2292
2293     return rv;
2294 }
2295
2296 static void property_get_enum(Object *obj, Visitor *v, const char *name,
2297                               void *opaque, Error **errp)
2298 {
2299     EnumProperty *prop = opaque;
2300     int value;
2301     Error *err = NULL;
2302
2303     value = prop->get(obj, &err);
2304     if (err) {
2305         error_propagate(errp, err);
2306         return;
2307     }
2308
2309     visit_type_enum(v, name, &value, prop->lookup, errp);
2310 }
2311
2312 static void property_set_enum(Object *obj, Visitor *v, const char *name,
2313                               void *opaque, Error **errp)
2314 {
2315     EnumProperty *prop = opaque;
2316     int value;
2317     Error *err = NULL;
2318
2319     visit_type_enum(v, name, &value, prop->lookup, &err);
2320     if (err) {
2321         error_propagate(errp, err);
2322         return;
2323     }
2324     prop->set(obj, value, errp);
2325 }
2326
2327 static void property_release_enum(Object *obj, const char *name,
2328                                   void *opaque)
2329 {
2330     EnumProperty *prop = opaque;
2331     g_free(prop);
2332 }
2333
2334 void object_property_add_enum(Object *obj, const char *name,
2335                               const char *typename,
2336                               const QEnumLookup *lookup,
2337                               int (*get)(Object *, Error **),
2338                               void (*set)(Object *, int, Error **),
2339                               Error **errp)
2340 {
2341     Error *local_err = NULL;
2342     EnumProperty *prop = g_malloc(sizeof(*prop));
2343
2344     prop->lookup = lookup;
2345     prop->get = get;
2346     prop->set = set;
2347
2348     object_property_add(obj, name, typename,
2349                         get ? property_get_enum : NULL,
2350                         set ? property_set_enum : NULL,
2351                         property_release_enum,
2352                         prop, &local_err);
2353     if (local_err) {
2354         error_propagate(errp, local_err);
2355         g_free(prop);
2356     }
2357 }
2358
2359 ObjectProperty *
2360 object_class_property_add_enum(ObjectClass *klass, const char *name,
2361                                     const char *typename,
2362                                     const QEnumLookup *lookup,
2363                                     int (*get)(Object *, Error **),
2364                                     void (*set)(Object *, int, Error **),
2365                                     Error **errp)
2366 {
2367     Error *local_err = NULL;
2368     EnumProperty *prop = g_malloc(sizeof(*prop));
2369     ObjectProperty *rv;
2370
2371     prop->lookup = lookup;
2372     prop->get = get;
2373     prop->set = set;
2374
2375     rv = object_class_property_add(klass, name, typename,
2376                               get ? property_get_enum : NULL,
2377                               set ? property_set_enum : NULL,
2378                               NULL,
2379                               prop, &local_err);
2380     if (local_err) {
2381         error_propagate(errp, local_err);
2382         g_free(prop);
2383     }
2384
2385     return rv;
2386 }
2387
2388 typedef struct TMProperty {
2389     void (*get)(Object *, struct tm *, Error **);
2390 } TMProperty;
2391
2392 static void property_get_tm(Object *obj, Visitor *v, const char *name,
2393                             void *opaque, Error **errp)
2394 {
2395     TMProperty *prop = opaque;
2396     Error *err = NULL;
2397     struct tm value;
2398
2399     prop->get(obj, &value, &err);
2400     if (err) {
2401         goto out;
2402     }
2403
2404     visit_start_struct(v, name, NULL, 0, &err);
2405     if (err) {
2406         goto out;
2407     }
2408     visit_type_int32(v, "tm_year", &value.tm_year, &err);
2409     if (err) {
2410         goto out_end;
2411     }
2412     visit_type_int32(v, "tm_mon", &value.tm_mon, &err);
2413     if (err) {
2414         goto out_end;
2415     }
2416     visit_type_int32(v, "tm_mday", &value.tm_mday, &err);
2417     if (err) {
2418         goto out_end;
2419     }
2420     visit_type_int32(v, "tm_hour", &value.tm_hour, &err);
2421     if (err) {
2422         goto out_end;
2423     }
2424     visit_type_int32(v, "tm_min", &value.tm_min, &err);
2425     if (err) {
2426         goto out_end;
2427     }
2428     visit_type_int32(v, "tm_sec", &value.tm_sec, &err);
2429     if (err) {
2430         goto out_end;
2431     }
2432     visit_check_struct(v, &err);
2433 out_end:
2434     visit_end_struct(v, NULL);
2435 out:
2436     error_propagate(errp, err);
2437
2438 }
2439
2440 static void property_release_tm(Object *obj, const char *name,
2441                                 void *opaque)
2442 {
2443     TMProperty *prop = opaque;
2444     g_free(prop);
2445 }
2446
2447 void object_property_add_tm(Object *obj, const char *name,
2448                             void (*get)(Object *, struct tm *, Error **),
2449                             Error **errp)
2450 {
2451     Error *local_err = NULL;
2452     TMProperty *prop = g_malloc0(sizeof(*prop));
2453
2454     prop->get = get;
2455
2456     object_property_add(obj, name, "struct tm",
2457                         get ? property_get_tm : NULL, NULL,
2458                         property_release_tm,
2459                         prop, &local_err);
2460     if (local_err) {
2461         error_propagate(errp, local_err);
2462         g_free(prop);
2463     }
2464 }
2465
2466 ObjectProperty *
2467 object_class_property_add_tm(ObjectClass *klass, const char *name,
2468                                   void (*get)(Object *, struct tm *, Error **),
2469                                   Error **errp)
2470 {
2471     Error *local_err = NULL;
2472     TMProperty *prop = g_malloc0(sizeof(*prop));
2473     ObjectProperty *rv;
2474
2475     prop->get = get;
2476
2477     rv = object_class_property_add(klass, name, "struct tm",
2478                               get ? property_get_tm : NULL, NULL,
2479                               NULL,
2480                               prop, &local_err);
2481     if (local_err) {
2482         error_propagate(errp, local_err);
2483         g_free(prop);
2484     }
2485
2486     return rv;
2487 }
2488
2489 static char *qdev_get_type(Object *obj, Error **errp)
2490 {
2491     return g_strdup(object_get_typename(obj));
2492 }
2493
2494 static void property_get_uint8_ptr(Object *obj, Visitor *v, const char *name,
2495                                    void *opaque, Error **errp)
2496 {
2497     uint8_t value = *(uint8_t *)opaque;
2498     visit_type_uint8(v, name, &value, errp);
2499 }
2500
2501 static void property_get_uint16_ptr(Object *obj, Visitor *v, const char *name,
2502                                     void *opaque, Error **errp)
2503 {
2504     uint16_t value = *(uint16_t *)opaque;
2505     visit_type_uint16(v, name, &value, errp);
2506 }
2507
2508 static void property_get_uint32_ptr(Object *obj, Visitor *v, const char *name,
2509                                     void *opaque, Error **errp)
2510 {
2511     uint32_t value = *(uint32_t *)opaque;
2512     visit_type_uint32(v, name, &value, errp);
2513 }
2514
2515 static void property_get_uint64_ptr(Object *obj, Visitor *v, const char *name,
2516                                     void *opaque, Error **errp)
2517 {
2518     uint64_t value = *(uint64_t *)opaque;
2519     visit_type_uint64(v, name, &value, errp);
2520 }
2521
2522 void object_property_add_uint8_ptr(Object *obj, const char *name,
2523                                    const uint8_t *v, Error **errp)
2524 {
2525     object_property_add(obj, name, "uint8", property_get_uint8_ptr,
2526                         NULL, NULL, (void *)v, errp);
2527 }
2528
2529 ObjectProperty *
2530 object_class_property_add_uint8_ptr(ObjectClass *klass, const char *name,
2531                                          const uint8_t *v, Error **errp)
2532 {
2533     return object_class_property_add(klass, name, "uint8",
2534                                      property_get_uint8_ptr,
2535                                      NULL, NULL, (void *)v, errp);
2536 }
2537
2538 void object_property_add_uint16_ptr(Object *obj, const char *name,
2539                                     const uint16_t *v, Error **errp)
2540 {
2541     object_property_add(obj, name, "uint16", property_get_uint16_ptr,
2542                         NULL, NULL, (void *)v, errp);
2543 }
2544
2545 ObjectProperty *
2546 object_class_property_add_uint16_ptr(ObjectClass *klass, const char *name,
2547                                           const uint16_t *v, Error **errp)
2548 {
2549     return object_class_property_add(klass, name, "uint16",
2550                                      property_get_uint16_ptr,
2551                                      NULL, NULL, (void *)v, errp);
2552 }
2553
2554 void object_property_add_uint32_ptr(Object *obj, const char *name,
2555                                     const uint32_t *v, Error **errp)
2556 {
2557     object_property_add(obj, name, "uint32", property_get_uint32_ptr,
2558                         NULL, NULL, (void *)v, errp);
2559 }
2560
2561 ObjectProperty *
2562 object_class_property_add_uint32_ptr(ObjectClass *klass, const char *name,
2563                                           const uint32_t *v, Error **errp)
2564 {
2565     return object_class_property_add(klass, name, "uint32",
2566                                      property_get_uint32_ptr,
2567                                      NULL, NULL, (void *)v, errp);
2568 }
2569
2570 void object_property_add_uint64_ptr(Object *obj, const char *name,
2571                                     const uint64_t *v, Error **errp)
2572 {
2573     object_property_add(obj, name, "uint64", property_get_uint64_ptr,
2574                         NULL, NULL, (void *)v, errp);
2575 }
2576
2577 ObjectProperty *
2578 object_class_property_add_uint64_ptr(ObjectClass *klass, const char *name,
2579                                           const uint64_t *v, Error **errp)
2580 {
2581     return object_class_property_add(klass, name, "uint64",
2582                                      property_get_uint64_ptr,
2583                                      NULL, NULL, (void *)v, errp);
2584 }
2585
2586 typedef struct {
2587     Object *target_obj;
2588     char *target_name;
2589 } AliasProperty;
2590
2591 static void property_get_alias(Object *obj, Visitor *v, const char *name,
2592                                void *opaque, Error **errp)
2593 {
2594     AliasProperty *prop = opaque;
2595
2596     object_property_get(prop->target_obj, v, prop->target_name, errp);
2597 }
2598
2599 static void property_set_alias(Object *obj, Visitor *v, const char *name,
2600                                void *opaque, Error **errp)
2601 {
2602     AliasProperty *prop = opaque;
2603
2604     object_property_set(prop->target_obj, v, prop->target_name, errp);
2605 }
2606
2607 static Object *property_resolve_alias(Object *obj, void *opaque,
2608                                       const gchar *part)
2609 {
2610     AliasProperty *prop = opaque;
2611
2612     return object_resolve_path_component(prop->target_obj, prop->target_name);
2613 }
2614
2615 static void property_release_alias(Object *obj, const char *name, void *opaque)
2616 {
2617     AliasProperty *prop = opaque;
2618
2619     g_free(prop->target_name);
2620     g_free(prop);
2621 }
2622
2623 void object_property_add_alias(Object *obj, const char *name,
2624                                Object *target_obj, const char *target_name,
2625                                Error **errp)
2626 {
2627     AliasProperty *prop;
2628     ObjectProperty *op;
2629     ObjectProperty *target_prop;
2630     gchar *prop_type;
2631     Error *local_err = NULL;
2632
2633     target_prop = object_property_find(target_obj, target_name, errp);
2634     if (!target_prop) {
2635         return;
2636     }
2637
2638     if (object_property_is_child(target_prop)) {
2639         prop_type = g_strdup_printf("link%s",
2640                                     target_prop->type + strlen("child"));
2641     } else {
2642         prop_type = g_strdup(target_prop->type);
2643     }
2644
2645     prop = g_malloc(sizeof(*prop));
2646     prop->target_obj = target_obj;
2647     prop->target_name = g_strdup(target_name);
2648
2649     op = object_property_add(obj, name, prop_type,
2650                              property_get_alias,
2651                              property_set_alias,
2652                              property_release_alias,
2653                              prop, &local_err);
2654     if (local_err) {
2655         error_propagate(errp, local_err);
2656         g_free(prop);
2657         goto out;
2658     }
2659     op->resolve = property_resolve_alias;
2660     if (target_prop->defval) {
2661         op->defval = qobject_ref(target_prop->defval);
2662     }
2663
2664     object_property_set_description(obj, op->name,
2665                                     target_prop->description,
2666                                     &error_abort);
2667
2668 out:
2669     g_free(prop_type);
2670 }
2671
2672 void object_property_set_description(Object *obj, const char *name,
2673                                      const char *description, Error **errp)
2674 {
2675     ObjectProperty *op;
2676
2677     op = object_property_find(obj, name, errp);
2678     if (!op) {
2679         return;
2680     }
2681
2682     g_free(op->description);
2683     op->description = g_strdup(description);
2684 }
2685
2686 void object_class_property_set_description(ObjectClass *klass,
2687                                            const char *name,
2688                                            const char *description,
2689                                            Error **errp)
2690 {
2691     ObjectProperty *op;
2692
2693     op = g_hash_table_lookup(klass->properties, name);
2694     if (!op) {
2695         error_setg(errp, "Property '.%s' not found", name);
2696         return;
2697     }
2698
2699     g_free(op->description);
2700     op->description = g_strdup(description);
2701 }
2702
2703 static void object_class_init(ObjectClass *klass, void *data)
2704 {
2705     object_class_property_add_str(klass, "type", qdev_get_type,
2706                                   NULL, &error_abort);
2707 }
2708
2709 static void register_types(void)
2710 {
2711     static TypeInfo interface_info = {
2712         .name = TYPE_INTERFACE,
2713         .class_size = sizeof(InterfaceClass),
2714         .abstract = true,
2715     };
2716
2717     static TypeInfo object_info = {
2718         .name = TYPE_OBJECT,
2719         .instance_size = sizeof(Object),
2720         .class_init = object_class_init,
2721         .abstract = true,
2722     };
2723
2724     type_interface = type_register_internal(&interface_info);
2725     type_register_internal(&object_info);
2726 }
2727
2728 type_init(register_types)