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