object.c 62.7 KB
Newer Older
1 2 3 4 5 6 7 8 9 10 11 12
/*
 * QEMU Object Model
 *
 * Copyright IBM, Corp. 2011
 *
 * Authors:
 *  Anthony Liguori   <aliguori@us.ibm.com>
 *
 * This work is licensed under the terms of the GNU GPL, version 2 or later.
 * See the COPYING file in the top-level directory.
 */

P
Peter Maydell 已提交
13
#include "qemu/osdep.h"
14
#include "qapi/error.h"
15
#include "qom/object.h"
16
#include "qom/object_interfaces.h"
17
#include "qemu/cutils.h"
18
#include "qapi/visitor.h"
19 20
#include "qapi/string-input-visitor.h"
#include "qapi/string-output-visitor.h"
21
#include "qapi/qapi-builtin-visit.h"
22
#include "qapi/qmp/qerror.h"
P
Paolo Bonzini 已提交
23
#include "trace.h"
24

25 26
/* TODO: replace QObject with a simpler visitor to avoid a dependency
 * of the QOM core on QObject?  */
27
#include "qom/qom-qobject.h"
28
#include "qapi/qmp/qbool.h"
29
#include "qapi/qmp/qnum.h"
30
#include "qapi/qmp/qstring.h"
31

32 33 34 35 36 37 38
#define MAX_INTERFACES 32

typedef struct InterfaceImpl InterfaceImpl;
typedef struct TypeImpl TypeImpl;

struct InterfaceImpl
{
A
Anthony Liguori 已提交
39
    const char *typename;
40 41 42 43 44 45 46 47 48 49 50
};

struct TypeImpl
{
    const char *name;

    size_t class_size;

    size_t instance_size;

    void (*class_init)(ObjectClass *klass, void *data);
P
Paolo Bonzini 已提交
51
    void (*class_base_init)(ObjectClass *klass, void *data);
52 53 54 55 56
    void (*class_finalize)(ObjectClass *klass, void *data);

    void *class_data;

    void (*instance_init)(Object *obj);
57
    void (*instance_post_init)(Object *obj);
58 59 60 61 62 63 64 65 66 67 68 69 70
    void (*instance_finalize)(Object *obj);

    bool abstract;

    const char *parent;
    TypeImpl *parent_type;

    ObjectClass *class;

    int num_interfaces;
    InterfaceImpl interfaces[MAX_INTERFACES];
};

71 72
static Type type_interface;

73 74 75 76 77 78 79 80 81 82 83
static GHashTable *type_table_get(void)
{
    static GHashTable *type_table;

    if (type_table == NULL) {
        type_table = g_hash_table_new(g_str_hash, g_str_equal);
    }

    return type_table;
}

84 85
static bool enumerating_types;

86 87
static void type_table_add(TypeImpl *ti)
{
88
    assert(!enumerating_types);
89 90 91 92 93 94 95 96
    g_hash_table_insert(type_table_get(), (void *)ti->name, ti);
}

static TypeImpl *type_table_lookup(const char *name)
{
    return g_hash_table_lookup(type_table_get(), name);
}

97
static TypeImpl *type_new(const TypeInfo *info)
98 99
{
    TypeImpl *ti = g_malloc0(sizeof(*ti));
A
Anthony Liguori 已提交
100
    int i;
101 102 103

    g_assert(info->name != NULL);

104 105 106 107 108
    if (type_table_lookup(info->name) != NULL) {
        fprintf(stderr, "Registering `%s' which already exists\n", info->name);
        abort();
    }

109 110 111 112 113 114 115
    ti->name = g_strdup(info->name);
    ti->parent = g_strdup(info->parent);

    ti->class_size = info->class_size;
    ti->instance_size = info->instance_size;

    ti->class_init = info->class_init;
P
Paolo Bonzini 已提交
116
    ti->class_base_init = info->class_base_init;
117 118 119 120
    ti->class_finalize = info->class_finalize;
    ti->class_data = info->class_data;

    ti->instance_init = info->instance_init;
121
    ti->instance_post_init = info->instance_post_init;
122 123 124 125
    ti->instance_finalize = info->instance_finalize;

    ti->abstract = info->abstract;

A
Anthony Liguori 已提交
126 127
    for (i = 0; info->interfaces && info->interfaces[i].type; i++) {
        ti->interfaces[i].typename = g_strdup(info->interfaces[i].type);
128
    }
A
Anthony Liguori 已提交
129
    ti->num_interfaces = i;
130

131 132
    return ti;
}
133

134 135 136 137 138 139
static TypeImpl *type_register_internal(const TypeInfo *info)
{
    TypeImpl *ti;
    ti = type_new(info);

    type_table_add(ti);
140 141 142
    return ti;
}

143 144 145 146 147 148
TypeImpl *type_register(const TypeInfo *info)
{
    assert(info->parent);
    return type_register_internal(info);
}

149 150 151 152 153
TypeImpl *type_register_static(const TypeInfo *info)
{
    return type_register(info);
}

154 155 156 157 158 159 160 161 162
void type_register_static_array(const TypeInfo *infos, int nr_infos)
{
    int i;

    for (i = 0; i < nr_infos; i++) {
        type_register_static(&infos[i]);
    }
}

163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199
static TypeImpl *type_get_by_name(const char *name)
{
    if (name == NULL) {
        return NULL;
    }

    return type_table_lookup(name);
}

static TypeImpl *type_get_parent(TypeImpl *type)
{
    if (!type->parent_type && type->parent) {
        type->parent_type = type_get_by_name(type->parent);
        g_assert(type->parent_type != NULL);
    }

    return type->parent_type;
}

static bool type_has_parent(TypeImpl *type)
{
    return (type->parent != NULL);
}

static size_t type_class_get_size(TypeImpl *ti)
{
    if (ti->class_size) {
        return ti->class_size;
    }

    if (type_has_parent(ti)) {
        return type_class_get_size(type_get_parent(ti));
    }

    return sizeof(ObjectClass);
}

200 201 202 203 204 205 206 207 208 209 210 211 212
static size_t type_object_get_size(TypeImpl *ti)
{
    if (ti->instance_size) {
        return ti->instance_size;
    }

    if (type_has_parent(ti)) {
        return type_object_get_size(type_get_parent(ti));
    }

    return 0;
}

213 214 215 216 217 218 219 220
size_t object_type_get_instance_size(const char *typename)
{
    TypeImpl *type = type_get_by_name(typename);

    g_assert(type != NULL);
    return type_object_get_size(type);
}

A
Anthony Liguori 已提交
221
static bool type_is_ancestor(TypeImpl *type, TypeImpl *target_type)
222
{
A
Anthony Liguori 已提交
223 224
    assert(target_type);

C
Cao jin 已提交
225
    /* Check if target_type is a direct ancestor of type */
A
Anthony Liguori 已提交
226 227 228 229
    while (type) {
        if (type == target_type) {
            return true;
        }
230

A
Anthony Liguori 已提交
231 232 233 234 235 236 237 238
        type = type_get_parent(type);
    }

    return false;
}

static void type_initialize(TypeImpl *ti);

239 240
static void type_initialize_interface(TypeImpl *ti, TypeImpl *interface_type,
                                      TypeImpl *parent_type)
A
Anthony Liguori 已提交
241 242 243 244 245
{
    InterfaceClass *new_iface;
    TypeInfo info = { };
    TypeImpl *iface_impl;

246 247
    info.parent = parent_type->name;
    info.name = g_strdup_printf("%s::%s", ti->name, interface_type->name);
A
Anthony Liguori 已提交
248 249
    info.abstract = true;

250 251
    iface_impl = type_new(&info);
    iface_impl->parent_type = parent_type;
A
Anthony Liguori 已提交
252 253 254 255 256
    type_initialize(iface_impl);
    g_free((char *)info.name);

    new_iface = (InterfaceClass *)iface_impl->class;
    new_iface->concrete_class = ti->class;
257
    new_iface->interface_type = interface_type;
A
Anthony Liguori 已提交
258 259 260

    ti->class->interfaces = g_slist_append(ti->class->interfaces,
                                           iface_impl->class);
261 262
}

263 264 265 266 267 268 269 270 271 272
static void object_property_free(gpointer data)
{
    ObjectProperty *prop = data;

    g_free(prop->name);
    g_free(prop->type);
    g_free(prop->description);
    g_free(prop);
}

273
static void type_initialize(TypeImpl *ti)
274
{
P
Paolo Bonzini 已提交
275
    TypeImpl *parent;
276 277 278 279 280 281

    if (ti->class) {
        return;
    }

    ti->class_size = type_class_get_size(ti);
282
    ti->instance_size = type_object_get_size(ti);
283 284 285 286 287 288
    /* Any type with zero instance_size is implicitly abstract.
     * This means interface types are all abstract.
     */
    if (ti->instance_size == 0) {
        ti->abstract = true;
    }
289 290 291

    ti->class = g_malloc0(ti->class_size);

P
Paolo Bonzini 已提交
292 293
    parent = type_get_parent(ti);
    if (parent) {
294
        type_initialize(parent);
A
Anthony Liguori 已提交
295 296
        GSList *e;
        int i;
297

298
        g_assert(parent->class_size <= ti->class_size);
P
Paolo Bonzini 已提交
299
        memcpy(ti->class, parent->class, parent->class_size);
300
        ti->class->interfaces = NULL;
301 302
        ti->class->properties = g_hash_table_new_full(
            g_str_hash, g_str_equal, g_free, object_property_free);
A
Anthony Liguori 已提交
303 304

        for (e = parent->class->interfaces; e; e = e->next) {
305 306 307 308
            InterfaceClass *iface = e->data;
            ObjectClass *klass = OBJECT_CLASS(iface);

            type_initialize_interface(ti, iface->interface_type, klass->type);
A
Anthony Liguori 已提交
309 310 311 312 313 314 315 316 317 318 319 320 321 322 323 324
        }

        for (i = 0; i < ti->num_interfaces; i++) {
            TypeImpl *t = type_get_by_name(ti->interfaces[i].typename);
            for (e = ti->class->interfaces; e; e = e->next) {
                TypeImpl *target_type = OBJECT_CLASS(e->data)->type;

                if (type_is_ancestor(target_type, t)) {
                    break;
                }
            }

            if (e) {
                continue;
            }

325
            type_initialize_interface(ti, t, t);
A
Anthony Liguori 已提交
326
        }
327 328 329
    } else {
        ti->class->properties = g_hash_table_new_full(
            g_str_hash, g_str_equal, g_free, object_property_free);
P
Paolo Bonzini 已提交
330
    }
331

P
Paolo Bonzini 已提交
332
    ti->class->type = ti;
P
Paolo Bonzini 已提交
333

P
Paolo Bonzini 已提交
334 335 336
    while (parent) {
        if (parent->class_base_init) {
            parent->class_base_init(ti->class, ti->class_data);
P
Paolo Bonzini 已提交
337
        }
P
Paolo Bonzini 已提交
338
        parent = type_get_parent(parent);
339 340 341 342 343 344 345 346 347 348 349 350 351 352 353 354 355 356
    }

    if (ti->class_init) {
        ti->class_init(ti->class, ti->class_data);
    }
}

static void object_init_with_type(Object *obj, TypeImpl *ti)
{
    if (type_has_parent(ti)) {
        object_init_with_type(obj, type_get_parent(ti));
    }

    if (ti->instance_init) {
        ti->instance_init(obj);
    }
}

357 358 359 360 361 362 363 364 365 366 367
static void object_post_init_with_type(Object *obj, TypeImpl *ti)
{
    if (ti->instance_post_init) {
        ti->instance_post_init(obj);
    }

    if (type_has_parent(ti)) {
        object_post_init_with_type(obj, type_get_parent(ti));
    }
}

368
static void object_initialize_with_type(void *data, size_t size, TypeImpl *type)
369 370 371 372
{
    Object *obj = data;

    g_assert(type != NULL);
373
    type_initialize(type);
374

375
    g_assert(type->instance_size >= sizeof(Object));
376
    g_assert(type->abstract == false);
377
    g_assert(size >= type->instance_size);
378 379 380

    memset(obj, 0, type->instance_size);
    obj->class = type->class;
381
    object_ref(obj);
382 383
    obj->properties = g_hash_table_new_full(g_str_hash, g_str_equal,
                                            NULL, object_property_free);
384
    object_init_with_type(obj, type);
385
    object_post_init_with_type(obj, type);
386 387
}

388
void object_initialize(void *data, size_t size, const char *typename)
389 390 391
{
    TypeImpl *type = type_get_by_name(typename);

392
    object_initialize_with_type(data, size, type);
393 394
}

395 396 397 398 399 400 401 402 403 404 405 406 407 408 409 410 411 412 413 414 415 416 417 418 419 420 421 422 423 424 425 426 427 428 429 430 431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448
void object_initialize_child(Object *parentobj, const char *propname,
                             void *childobj, size_t size, const char *type,
                             Error **errp, ...)
{
    va_list vargs;

    va_start(vargs, errp);
    object_initialize_childv(parentobj, propname, childobj, size, type, errp,
                             vargs);
    va_end(vargs);
}

void object_initialize_childv(Object *parentobj, const char *propname,
                              void *childobj, size_t size, const char *type,
                              Error **errp, va_list vargs)
{
    Error *local_err = NULL;
    Object *obj;

    object_initialize(childobj, size, type);
    obj = OBJECT(childobj);

    object_set_propv(obj, &local_err, vargs);
    if (local_err) {
        goto out;
    }

    object_property_add_child(parentobj, propname, obj, &local_err);
    if (local_err) {
        goto out;
    }

    if (object_dynamic_cast(obj, TYPE_USER_CREATABLE)) {
        user_creatable_complete(obj, &local_err);
        if (local_err) {
            object_unparent(obj);
            goto out;
        }
    }

    /*
     * Since object_property_add_child added a reference to the child object,
     * we can drop the reference added by object_initialize(), so the child
     * property will own the only reference to the object.
     */
    object_unref(obj);

out:
    if (local_err) {
        error_propagate(errp, local_err);
        object_unref(obj);
    }
}

449 450 451 452 453
static inline bool object_property_is_child(ObjectProperty *prop)
{
    return strstart(prop->type, "child<", NULL);
}

454 455
static void object_property_del_all(Object *obj)
{
456 457 458 459 460 461 462 463 464 465 466 467 468 469 470 471 472
    ObjectProperty *prop;
    GHashTableIter iter;
    gpointer key, value;
    bool released;

    do {
        released = false;
        g_hash_table_iter_init(&iter, obj->properties);
        while (g_hash_table_iter_next(&iter, &key, &value)) {
            prop = value;
            if (prop->release) {
                prop->release(obj, prop->name, prop->opaque);
                prop->release = NULL;
                released = true;
                break;
            }
            g_hash_table_iter_remove(&iter);
473
        }
474
    } while (released);
475

476
    g_hash_table_unref(obj->properties);
477 478 479 480 481
}

static void object_property_del_child(Object *obj, Object *child, Error **errp)
{
    ObjectProperty *prop;
482 483
    GHashTableIter iter;
    gpointer key, value;
484

485 486 487 488 489 490 491 492 493 494 495 496 497 498
    g_hash_table_iter_init(&iter, obj->properties);
    while (g_hash_table_iter_next(&iter, &key, &value)) {
        prop = value;
        if (object_property_is_child(prop) && prop->opaque == child) {
            if (prop->release) {
                prop->release(obj, prop->name, prop->opaque);
                prop->release = NULL;
            }
            break;
        }
    }
    g_hash_table_iter_init(&iter, obj->properties);
    while (g_hash_table_iter_next(&iter, &key, &value)) {
        prop = value;
499
        if (object_property_is_child(prop) && prop->opaque == child) {
500
            g_hash_table_iter_remove(&iter);
P
Paolo Bonzini 已提交
501
            break;
502 503 504 505 506 507
        }
    }
}

void object_unparent(Object *obj)
{
508 509 510
    if (obj->parent) {
        object_property_del_child(obj->parent, obj, NULL);
    }
511 512
}

513 514 515 516 517 518 519 520 521 522 523
static void object_deinit(Object *obj, TypeImpl *type)
{
    if (type->instance_finalize) {
        type->instance_finalize(obj);
    }

    if (type_has_parent(type)) {
        object_deinit(obj, type_get_parent(type));
    }
}

P
Paolo Bonzini 已提交
524
static void object_finalize(void *data)
525 526 527 528
{
    Object *obj = data;
    TypeImpl *ti = obj->class->type;

529
    object_property_del_all(obj);
530
    object_deinit(obj, ti);
531

532
    g_assert(obj->ref == 0);
533 534 535
    if (obj->free) {
        obj->free(obj);
    }
536 537
}

538
static Object *object_new_with_type(Type type)
539 540 541 542
{
    Object *obj;

    g_assert(type != NULL);
543
    type_initialize(type);
544 545

    obj = g_malloc(type->instance_size);
546
    object_initialize_with_type(obj, type->instance_size, type);
547
    obj->free = g_free;
548 549 550 551 552 553 554 555 556 557 558

    return obj;
}

Object *object_new(const char *typename)
{
    TypeImpl *ti = type_get_by_name(typename);

    return object_new_with_type(ti);
}

559 560 561 562 563 564 565 566 567 568 569 570 571 572 573 574 575 576 577 578 579 580 581 582 583 584 585 586 587 588 589 590 591 592 593 594 595 596 597 598 599 600 601 602 603 604 605 606 607 608 609 610 611 612 613 614 615 616 617 618 619

Object *object_new_with_props(const char *typename,
                              Object *parent,
                              const char *id,
                              Error **errp,
                              ...)
{
    va_list vargs;
    Object *obj;

    va_start(vargs, errp);
    obj = object_new_with_propv(typename, parent, id, errp, vargs);
    va_end(vargs);

    return obj;
}


Object *object_new_with_propv(const char *typename,
                              Object *parent,
                              const char *id,
                              Error **errp,
                              va_list vargs)
{
    Object *obj;
    ObjectClass *klass;
    Error *local_err = NULL;

    klass = object_class_by_name(typename);
    if (!klass) {
        error_setg(errp, "invalid object type: %s", typename);
        return NULL;
    }

    if (object_class_is_abstract(klass)) {
        error_setg(errp, "object type '%s' is abstract", typename);
        return NULL;
    }
    obj = object_new(typename);

    if (object_set_propv(obj, &local_err, vargs) < 0) {
        goto error;
    }

    object_property_add_child(parent, id, obj, &local_err);
    if (local_err) {
        goto error;
    }

    if (object_dynamic_cast(obj, TYPE_USER_CREATABLE)) {
        user_creatable_complete(obj, &local_err);
        if (local_err) {
            object_unparent(obj);
            goto error;
        }
    }

    object_unref(OBJECT(obj));
    return obj;

 error:
620
    error_propagate(errp, local_err);
621 622 623 624 625 626 627 628 629 630 631 632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650 651 652 653 654 655 656 657 658 659 660 661 662 663 664
    object_unref(obj);
    return NULL;
}


int object_set_props(Object *obj,
                     Error **errp,
                     ...)
{
    va_list vargs;
    int ret;

    va_start(vargs, errp);
    ret = object_set_propv(obj, errp, vargs);
    va_end(vargs);

    return ret;
}


int object_set_propv(Object *obj,
                     Error **errp,
                     va_list vargs)
{
    const char *propname;
    Error *local_err = NULL;

    propname = va_arg(vargs, char *);
    while (propname != NULL) {
        const char *value = va_arg(vargs, char *);

        g_assert(value != NULL);
        object_property_parse(obj, value, propname, &local_err);
        if (local_err) {
            error_propagate(errp, local_err);
            return -1;
        }
        propname = va_arg(vargs, char *);
    }

    return 0;
}


665 666
Object *object_dynamic_cast(Object *obj, const char *typename)
{
667
    if (obj && object_class_dynamic_cast(object_get_class(obj), typename)) {
668 669 670
        return obj;
    }

671 672 673
    return NULL;
}

674 675
Object *object_dynamic_cast_assert(Object *obj, const char *typename,
                                   const char *file, int line, const char *func)
676
{
P
Paolo Bonzini 已提交
677 678 679
    trace_object_dynamic_cast_assert(obj ? obj->class->type->name : "(null)",
                                     typename, file, line, func);

680
#ifdef CONFIG_QOM_CAST_DEBUG
681 682 683
    int i;
    Object *inst;

684
    for (i = 0; obj && i < OBJECT_CLASS_CAST_CACHE; i++) {
685
        if (atomic_read(&obj->class->object_cast_cache[i]) == typename) {
686 687 688 689 690
            goto out;
        }
    }

    inst = object_dynamic_cast(obj, typename);
691

692
    if (!inst && obj) {
693 694
        fprintf(stderr, "%s:%d:%s: Object %p is not an instance of type %s\n",
                file, line, func, obj, typename);
695 696 697
        abort();
    }

698
    assert(obj == inst);
699

700
    if (obj && obj == inst) {
701
        for (i = 1; i < OBJECT_CLASS_CAST_CACHE; i++) {
702 703
            atomic_set(&obj->class->object_cast_cache[i - 1],
                       atomic_read(&obj->class->object_cast_cache[i]));
704
        }
705
        atomic_set(&obj->class->object_cast_cache[i - 1], typename);
706 707 708
    }

out:
709 710
#endif
    return obj;
711 712 713 714 715
}

ObjectClass *object_class_dynamic_cast(ObjectClass *class,
                                       const char *typename)
{
A
Anthony Liguori 已提交
716
    ObjectClass *ret = NULL;
717 718
    TypeImpl *target_type;
    TypeImpl *type;
719

720 721 722 723
    if (!class) {
        return NULL;
    }

724
    /* A simple fast path that can trigger a lot for leaf classes.  */
725
    type = class->type;
726 727 728 729
    if (type->name == typename) {
        return class;
    }

730
    target_type = type_get_by_name(typename);
731 732 733 734 735
    if (!target_type) {
        /* target class type unknown, so fail the cast */
        return NULL;
    }

736 737
    if (type->class->interfaces &&
            type_is_ancestor(target_type, type_interface)) {
A
Anthony Liguori 已提交
738 739
        int found = 0;
        GSList *i;
740

A
Anthony Liguori 已提交
741 742 743 744 745 746 747 748 749 750 751 752 753 754 755
        for (i = class->interfaces; i; i = i->next) {
            ObjectClass *target_class = i->data;

            if (type_is_ancestor(target_class->type, target_type)) {
                ret = target_class;
                found++;
            }
         }

        /* The match was ambiguous, don't allow a cast */
        if (found > 1) {
            ret = NULL;
        }
    } else if (type_is_ancestor(type, target_type)) {
        ret = class;
756 757
    }

A
Anthony Liguori 已提交
758
    return ret;
759 760 761
}

ObjectClass *object_class_dynamic_cast_assert(ObjectClass *class,
762 763 764
                                              const char *typename,
                                              const char *file, int line,
                                              const char *func)
765
{
P
Paolo Bonzini 已提交
766 767 768 769
    ObjectClass *ret;

    trace_object_class_dynamic_cast_assert(class ? class->type->name : "(null)",
                                           typename, file, line, func);
770

771 772 773
#ifdef CONFIG_QOM_CAST_DEBUG
    int i;

774
    for (i = 0; class && i < OBJECT_CLASS_CAST_CACHE; i++) {
775
        if (atomic_read(&class->class_cast_cache[i]) == typename) {
776 777 778 779 780
            ret = class;
            goto out;
        }
    }
#else
781
    if (!class || !class->interfaces) {
782 783 784 785
        return class;
    }
#endif

P
Paolo Bonzini 已提交
786
    ret = object_class_dynamic_cast(class, typename);
787
    if (!ret && class) {
788 789
        fprintf(stderr, "%s:%d:%s: Object %p is not an instance of type %s\n",
                file, line, func, class, typename);
790 791 792
        abort();
    }

793
#ifdef CONFIG_QOM_CAST_DEBUG
794
    if (class && ret == class) {
795
        for (i = 1; i < OBJECT_CLASS_CAST_CACHE; i++) {
796 797
            atomic_set(&class->class_cast_cache[i - 1],
                       atomic_read(&class->class_cast_cache[i]));
798
        }
799
        atomic_set(&class->class_cast_cache[i - 1], typename);
800 801 802
    }
out:
#endif
803 804 805
    return ret;
}

806
const char *object_get_typename(const Object *obj)
807 808 809 810 811 812 813 814 815
{
    return obj->class->type->name;
}

ObjectClass *object_get_class(Object *obj)
{
    return obj->class;
}

816 817 818 819 820
bool object_class_is_abstract(ObjectClass *klass)
{
    return klass->type->abstract;
}

821 822 823 824 825 826 827 828 829 830 831 832 833
const char *object_class_get_name(ObjectClass *klass)
{
    return klass->type->name;
}

ObjectClass *object_class_by_name(const char *typename)
{
    TypeImpl *type = type_get_by_name(typename);

    if (!type) {
        return NULL;
    }

834
    type_initialize(type);
835 836 837 838

    return type->class;
}

839 840 841 842 843 844 845 846 847 848 849 850 851
ObjectClass *object_class_get_parent(ObjectClass *class)
{
    TypeImpl *type = type_get_parent(class->type);

    if (!type) {
        return NULL;
    }

    type_initialize(type);

    return type->class;
}

852 853 854
typedef struct OCFData
{
    void (*fn)(ObjectClass *klass, void *opaque);
855 856
    const char *implements_type;
    bool include_abstract;
857 858 859 860 861 862 863 864
    void *opaque;
} OCFData;

static void object_class_foreach_tramp(gpointer key, gpointer value,
                                       gpointer opaque)
{
    OCFData *data = opaque;
    TypeImpl *type = value;
865
    ObjectClass *k;
866

867
    type_initialize(type);
868
    k = type->class;
869

870 871 872 873 874 875 876 877 878 879
    if (!data->include_abstract && type->abstract) {
        return;
    }

    if (data->implements_type && 
        !object_class_dynamic_cast(k, data->implements_type)) {
        return;
    }

    data->fn(k, data->opaque);
880 881 882
}

void object_class_foreach(void (*fn)(ObjectClass *klass, void *opaque),
883
                          const char *implements_type, bool include_abstract,
884 885
                          void *opaque)
{
886
    OCFData data = { fn, implements_type, include_abstract, opaque };
887

888
    enumerating_types = true;
889
    g_hash_table_foreach(type_table_get(), object_class_foreach_tramp, &data);
890
    enumerating_types = false;
891
}
892

893 894 895
static int do_object_child_foreach(Object *obj,
                                   int (*fn)(Object *child, void *opaque),
                                   void *opaque, bool recurse)
P
Paolo Bonzini 已提交
896
{
897 898
    GHashTableIter iter;
    ObjectProperty *prop;
P
Paolo Bonzini 已提交
899 900
    int ret = 0;

901 902
    g_hash_table_iter_init(&iter, obj->properties);
    while (g_hash_table_iter_next(&iter, NULL, (gpointer *)&prop)) {
P
Paolo Bonzini 已提交
903
        if (object_property_is_child(prop)) {
904 905 906
            Object *child = prop->opaque;

            ret = fn(child, opaque);
P
Paolo Bonzini 已提交
907 908 909
            if (ret != 0) {
                break;
            }
910 911 912
            if (recurse) {
                do_object_child_foreach(child, fn, opaque, true);
            }
P
Paolo Bonzini 已提交
913 914 915 916 917
        }
    }
    return ret;
}

918 919 920 921 922 923 924 925 926 927 928 929 930
int object_child_foreach(Object *obj, int (*fn)(Object *child, void *opaque),
                         void *opaque)
{
    return do_object_child_foreach(obj, fn, opaque, false);
}

int object_child_foreach_recursive(Object *obj,
                                   int (*fn)(Object *child, void *opaque),
                                   void *opaque)
{
    return do_object_child_foreach(obj, fn, opaque, true);
}

931 932 933 934 935 936 937 938 939 940 941 942 943 944 945 946 947
static void object_class_get_list_tramp(ObjectClass *klass, void *opaque)
{
    GSList **list = opaque;

    *list = g_slist_prepend(*list, klass);
}

GSList *object_class_get_list(const char *implements_type,
                              bool include_abstract)
{
    GSList *list = NULL;

    object_class_foreach(object_class_get_list_tramp,
                         implements_type, include_abstract, &list);
    return list;
}

948 949 950 951 952 953 954 955 956 957 958 959 960
static gint object_class_cmp(gconstpointer a, gconstpointer b)
{
    return strcasecmp(object_class_get_name((ObjectClass *)a),
                      object_class_get_name((ObjectClass *)b));
}

GSList *object_class_get_list_sorted(const char *implements_type,
                                     bool include_abstract)
{
    return g_slist_sort(object_class_get_list(implements_type, include_abstract),
                        object_class_cmp);
}

961 962
void object_ref(Object *obj)
{
963 964 965
    if (!obj) {
        return;
    }
966
    atomic_inc(&obj->ref);
967 968 969 970
}

void object_unref(Object *obj)
{
971 972 973
    if (!obj) {
        return;
    }
974
    g_assert(obj->ref > 0);
975 976

    /* parent always holds a reference to its children */
977
    if (atomic_fetch_dec(&obj->ref) == 1) {
978 979 980 981
        object_finalize(obj);
    }
}

982 983 984 985 986 987
ObjectProperty *
object_property_add(Object *obj, const char *name, const char *type,
                    ObjectPropertyAccessor *get,
                    ObjectPropertyAccessor *set,
                    ObjectPropertyRelease *release,
                    void *opaque, Error **errp)
988
{
989
    ObjectProperty *prop;
990 991 992 993 994 995 996 997 998 999 1000 1001 1002 1003 1004 1005 1006 1007 1008 1009 1010
    size_t name_len = strlen(name);

    if (name_len >= 3 && !memcmp(name + name_len - 3, "[*]", 4)) {
        int i;
        ObjectProperty *ret;
        char *name_no_array = g_strdup(name);

        name_no_array[name_len - 3] = '\0';
        for (i = 0; ; ++i) {
            char *full_name = g_strdup_printf("%s[%d]", name_no_array, i);

            ret = object_property_add(obj, full_name, type, get, set,
                                      release, opaque, NULL);
            g_free(full_name);
            if (ret) {
                break;
            }
        }
        g_free(name_no_array);
        return ret;
    }
1011

1012
    if (object_property_find(obj, name, NULL) != NULL) {
1013
        error_setg(errp, "attempt to add duplicate property '%s'"
1014 1015
                   " to object (type '%s')", name,
                   object_get_typename(obj));
1016
        return NULL;
1017 1018 1019
    }

    prop = g_malloc0(sizeof(*prop));
1020 1021 1022 1023 1024 1025 1026 1027 1028

    prop->name = g_strdup(name);
    prop->type = g_strdup(type);

    prop->get = get;
    prop->set = set;
    prop->release = release;
    prop->opaque = opaque;

1029
    g_hash_table_insert(obj->properties, prop->name, prop);
1030
    return prop;
1031 1032
}

1033 1034 1035 1036 1037 1038 1039 1040 1041 1042 1043 1044 1045 1046 1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062 1063 1064 1065 1066
ObjectProperty *
object_class_property_add(ObjectClass *klass,
                          const char *name,
                          const char *type,
                          ObjectPropertyAccessor *get,
                          ObjectPropertyAccessor *set,
                          ObjectPropertyRelease *release,
                          void *opaque,
                          Error **errp)
{
    ObjectProperty *prop;

    if (object_class_property_find(klass, name, NULL) != NULL) {
        error_setg(errp, "attempt to add duplicate property '%s'"
                   " to object (type '%s')", name,
                   object_class_get_name(klass));
        return NULL;
    }

    prop = g_malloc0(sizeof(*prop));

    prop->name = g_strdup(name);
    prop->type = g_strdup(type);

    prop->get = get;
    prop->set = set;
    prop->release = release;
    prop->opaque = opaque;

    g_hash_table_insert(klass->properties, g_strdup(name), prop);

    return prop;
}

1067 1068
ObjectProperty *object_property_find(Object *obj, const char *name,
                                     Error **errp)
1069 1070
{
    ObjectProperty *prop;
1071 1072 1073 1074 1075 1076
    ObjectClass *klass = object_get_class(obj);

    prop = object_class_property_find(klass, name, NULL);
    if (prop) {
        return prop;
    }
1077

1078 1079 1080
    prop = g_hash_table_lookup(obj->properties, name);
    if (prop) {
        return prop;
1081 1082
    }

1083
    error_setg(errp, "Property '.%s' not found", name);
1084 1085 1086
    return NULL;
}

1087 1088
void object_property_iter_init(ObjectPropertyIterator *iter,
                               Object *obj)
1089
{
1090 1091
    g_hash_table_iter_init(&iter->iter, obj->properties);
    iter->nextclass = object_get_class(obj);
1092 1093 1094 1095
}

ObjectProperty *object_property_iter_next(ObjectPropertyIterator *iter)
{
1096
    gpointer key, val;
1097 1098 1099 1100 1101 1102
    while (!g_hash_table_iter_next(&iter->iter, &key, &val)) {
        if (!iter->nextclass) {
            return NULL;
        }
        g_hash_table_iter_init(&iter->iter, iter->nextclass->properties);
        iter->nextclass = object_class_get_parent(iter->nextclass);
1103
    }
1104
    return val;
1105 1106
}

1107 1108 1109 1110 1111 1112 1113
void object_class_property_iter_init(ObjectPropertyIterator *iter,
                                     ObjectClass *klass)
{
    g_hash_table_iter_init(&iter->iter, klass->properties);
    iter->nextclass = klass;
}

1114 1115 1116 1117 1118 1119 1120 1121 1122 1123 1124 1125 1126 1127 1128 1129 1130 1131 1132 1133 1134
ObjectProperty *object_class_property_find(ObjectClass *klass, const char *name,
                                           Error **errp)
{
    ObjectProperty *prop;
    ObjectClass *parent_klass;

    parent_klass = object_class_get_parent(klass);
    if (parent_klass) {
        prop = object_class_property_find(parent_klass, name, NULL);
        if (prop) {
            return prop;
        }
    }

    prop = g_hash_table_lookup(klass->properties, name);
    if (!prop) {
        error_setg(errp, "Property '.%s' not found", name);
    }
    return prop;
}

1135 1136
void object_property_del(Object *obj, const char *name, Error **errp)
{
1137 1138 1139 1140
    ObjectProperty *prop = g_hash_table_lookup(obj->properties, name);

    if (!prop) {
        error_setg(errp, "Property '.%s' not found", name);
A
Anthony Liguori 已提交
1141 1142
        return;
    }
1143

A
Anthony Liguori 已提交
1144 1145 1146
    if (prop->release) {
        prop->release(obj, name, prop->opaque);
    }
1147
    g_hash_table_remove(obj->properties, name);
1148 1149 1150 1151 1152
}

void object_property_get(Object *obj, Visitor *v, const char *name,
                         Error **errp)
{
1153
    ObjectProperty *prop = object_property_find(obj, name, errp);
1154 1155 1156 1157 1158
    if (prop == NULL) {
        return;
    }

    if (!prop->get) {
1159
        error_setg(errp, QERR_PERMISSION_DENIED);
1160
    } else {
1161
        prop->get(obj, v, name, prop->opaque, errp);
1162 1163 1164 1165 1166 1167
    }
}

void object_property_set(Object *obj, Visitor *v, const char *name,
                         Error **errp)
{
1168
    ObjectProperty *prop = object_property_find(obj, name, errp);
1169 1170 1171 1172 1173
    if (prop == NULL) {
        return;
    }

    if (!prop->set) {
1174
        error_setg(errp, QERR_PERMISSION_DENIED);
1175
    } else {
1176
        prop->set(obj, v, name, prop->opaque, errp);
1177 1178 1179
    }
}

1180 1181 1182 1183 1184 1185
void object_property_set_str(Object *obj, const char *value,
                             const char *name, Error **errp)
{
    QString *qstr = qstring_from_str(value);
    object_property_set_qobject(obj, QOBJECT(qstr), name, errp);

1186
    qobject_unref(qstr);
1187 1188 1189 1190 1191 1192 1193 1194 1195 1196 1197
}

char *object_property_get_str(Object *obj, const char *name,
                              Error **errp)
{
    QObject *ret = object_property_get_qobject(obj, name, errp);
    char *retval;

    if (!ret) {
        return NULL;
    }
1198 1199 1200

    retval = g_strdup(qobject_get_try_str(ret));
    if (!retval) {
1201
        error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, "string");
1202 1203
    }

1204
    qobject_unref(ret);
1205 1206 1207
    return retval;
}

1208 1209 1210
void object_property_set_link(Object *obj, Object *value,
                              const char *name, Error **errp)
{
1211 1212 1213 1214 1215 1216 1217
    if (value) {
        gchar *path = object_get_canonical_path(value);
        object_property_set_str(obj, path, name, errp);
        g_free(path);
    } else {
        object_property_set_str(obj, "", name, errp);
    }
1218 1219 1220 1221 1222 1223 1224 1225 1226 1227 1228
}

Object *object_property_get_link(Object *obj, const char *name,
                                 Error **errp)
{
    char *str = object_property_get_str(obj, name, errp);
    Object *target = NULL;

    if (str && *str) {
        target = object_resolve_path(str, NULL);
        if (!target) {
1229 1230
            error_set(errp, ERROR_CLASS_DEVICE_NOT_FOUND,
                      "Device '%s' not found", str);
1231 1232 1233 1234 1235 1236 1237
        }
    }

    g_free(str);
    return target;
}

1238 1239 1240
void object_property_set_bool(Object *obj, bool value,
                              const char *name, Error **errp)
{
E
Eric Blake 已提交
1241
    QBool *qbool = qbool_from_bool(value);
1242 1243
    object_property_set_qobject(obj, QOBJECT(qbool), name, errp);

1244
    qobject_unref(qbool);
1245 1246 1247 1248 1249 1250 1251 1252 1253 1254 1255 1256
}

bool object_property_get_bool(Object *obj, const char *name,
                              Error **errp)
{
    QObject *ret = object_property_get_qobject(obj, name, errp);
    QBool *qbool;
    bool retval;

    if (!ret) {
        return false;
    }
1257
    qbool = qobject_to(QBool, ret);
1258
    if (!qbool) {
1259
        error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, "boolean");
1260 1261
        retval = false;
    } else {
E
Eric Blake 已提交
1262
        retval = qbool_get_bool(qbool);
1263 1264
    }

1265
    qobject_unref(ret);
1266 1267 1268 1269 1270 1271
    return retval;
}

void object_property_set_int(Object *obj, int64_t value,
                             const char *name, Error **errp)
{
1272 1273
    QNum *qnum = qnum_from_int(value);
    object_property_set_qobject(obj, QOBJECT(qnum), name, errp);
1274

1275
    qobject_unref(qnum);
1276 1277 1278 1279 1280 1281
}

int64_t object_property_get_int(Object *obj, const char *name,
                                Error **errp)
{
    QObject *ret = object_property_get_qobject(obj, name, errp);
1282
    QNum *qnum;
1283 1284 1285 1286 1287
    int64_t retval;

    if (!ret) {
        return -1;
    }
1288

1289
    qnum = qobject_to(QNum, ret);
1290
    if (!qnum || !qnum_get_try_int(qnum, &retval)) {
1291
        error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, "int");
1292 1293 1294
        retval = -1;
    }

1295
    qobject_unref(ret);
1296
    return retval;
1297 1298
}

1299 1300 1301 1302 1303 1304
void object_property_set_uint(Object *obj, uint64_t value,
                              const char *name, Error **errp)
{
    QNum *qnum = qnum_from_uint(value);

    object_property_set_qobject(obj, QOBJECT(qnum), name, errp);
1305
    qobject_unref(qnum);
1306 1307 1308 1309 1310 1311 1312 1313 1314 1315 1316 1317
}

uint64_t object_property_get_uint(Object *obj, const char *name,
                                  Error **errp)
{
    QObject *ret = object_property_get_qobject(obj, name, errp);
    QNum *qnum;
    uint64_t retval;

    if (!ret) {
        return 0;
    }
1318
    qnum = qobject_to(QNum, ret);
1319 1320 1321 1322 1323
    if (!qnum || !qnum_get_try_uint(qnum, &retval)) {
        error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, "uint");
        retval = 0;
    }

1324
    qobject_unref(ret);
1325 1326 1327
    return retval;
}

1328
typedef struct EnumProperty {
1329
    const QEnumLookup *lookup;
1330 1331 1332 1333
    int (*get)(Object *, Error **);
    void (*set)(Object *, int, Error **);
} EnumProperty;

1334
int object_property_get_enum(Object *obj, const char *name,
1335
                             const char *typename, Error **errp)
1336
{
1337
    Error *err = NULL;
1338
    Visitor *v;
1339
    char *str;
1340
    int ret;
1341 1342 1343 1344 1345 1346 1347 1348 1349 1350 1351 1352 1353 1354 1355
    ObjectProperty *prop = object_property_find(obj, name, errp);
    EnumProperty *enumprop;

    if (prop == NULL) {
        return 0;
    }

    if (!g_str_equal(prop->type, typename)) {
        error_setg(errp, "Property %s on %s is not '%s' enum type",
                   name, object_class_get_name(
                       object_get_class(obj)), typename);
        return 0;
    }

    enumprop = prop->opaque;
1356

1357
    v = string_output_visitor_new(false, &str);
1358
    object_property_get(obj, v, name, &err);
1359 1360
    if (err) {
        error_propagate(errp, err);
1361
        visit_free(v);
1362 1363
        return 0;
    }
1364
    visit_complete(v, &str);
1365
    visit_free(v);
1366
    v = string_input_visitor_new(str);
1367
    visit_type_enum(v, name, &ret, enumprop->lookup, errp);
1368 1369

    g_free(str);
1370
    visit_free(v);
1371 1372 1373 1374 1375 1376 1377

    return ret;
}

void object_property_get_uint16List(Object *obj, const char *name,
                                    uint16List **list, Error **errp)
{
1378
    Error *err = NULL;
1379
    Visitor *v;
1380
    char *str;
1381

1382 1383
    v = string_output_visitor_new(false, &str);
    object_property_get(obj, v, name, &err);
1384 1385 1386 1387
    if (err) {
        error_propagate(errp, err);
        goto out;
    }
1388 1389
    visit_complete(v, &str);
    visit_free(v);
1390 1391
    v = string_input_visitor_new(str);
    visit_type_uint16List(v, NULL, list, errp);
1392 1393

    g_free(str);
1394
out:
1395
    visit_free(v);
1396 1397
}

1398 1399 1400
void object_property_parse(Object *obj, const char *string,
                           const char *name, Error **errp)
{
1401 1402 1403
    Visitor *v = string_input_visitor_new(string);
    object_property_set(obj, v, name, errp);
    visit_free(v);
1404 1405
}

1406
char *object_property_print(Object *obj, const char *name, bool human,
1407 1408
                            Error **errp)
{
1409
    Visitor *v;
1410 1411
    char *string = NULL;
    Error *local_err = NULL;
1412

1413 1414
    v = string_output_visitor_new(human, &string);
    object_property_get(obj, v, name, &local_err);
1415 1416 1417 1418 1419
    if (local_err) {
        error_propagate(errp, local_err);
        goto out;
    }

1420
    visit_complete(v, &string);
1421 1422

out:
1423
    visit_free(v);
1424
    return string;
1425 1426
}

1427 1428
const char *object_property_get_type(Object *obj, const char *name, Error **errp)
{
1429
    ObjectProperty *prop = object_property_find(obj, name, errp);
1430 1431 1432 1433 1434 1435 1436 1437 1438
    if (prop == NULL) {
        return NULL;
    }

    return prop->type;
}

Object *object_get_root(void)
{
1439
    static Object *root;
1440

1441 1442
    if (!root) {
        root = object_new("container");
1443 1444
    }

1445
    return root;
1446 1447
}

1448 1449 1450 1451 1452
Object *object_get_objects_root(void)
{
    return container_get(object_get_root(), "/objects");
}

1453 1454 1455 1456 1457 1458 1459 1460 1461 1462 1463
Object *object_get_internal_root(void)
{
    static Object *internal_root;

    if (!internal_root) {
        internal_root = object_new("container");
    }

    return internal_root;
}

1464 1465 1466
static void object_get_child_property(Object *obj, Visitor *v,
                                      const char *name, void *opaque,
                                      Error **errp)
1467 1468 1469 1470 1471
{
    Object *child = opaque;
    gchar *path;

    path = object_get_canonical_path(child);
1472
    visit_type_str(v, name, &path, errp);
1473 1474 1475
    g_free(path);
}

1476 1477 1478 1479 1480
static Object *object_resolve_child_property(Object *parent, void *opaque, const gchar *part)
{
    return opaque;
}

1481 1482 1483 1484 1485
static void object_finalize_child_property(Object *obj, const char *name,
                                           void *opaque)
{
    Object *child = opaque;

1486 1487 1488 1489
    if (child->class->unparent) {
        (child->class->unparent)(child);
    }
    child->parent = NULL;
1490 1491 1492
    object_unref(child);
}

1493 1494 1495
void object_property_add_child(Object *obj, const char *name,
                               Object *child, Error **errp)
{
1496
    Error *local_err = NULL;
1497
    gchar *type;
1498
    ObjectProperty *op;
1499

1500 1501 1502 1503 1504
    if (child->parent != NULL) {
        error_setg(errp, "child object is already parented");
        return;
    }

1505 1506
    type = g_strdup_printf("child<%s>", object_get_typename(OBJECT(child)));

1507 1508
    op = object_property_add(obj, name, type, object_get_child_property, NULL,
                             object_finalize_child_property, child, &local_err);
1509 1510 1511 1512
    if (local_err) {
        error_propagate(errp, local_err);
        goto out;
    }
1513 1514

    op->resolve = object_resolve_child_property;
1515 1516 1517
    object_ref(child);
    child->parent = obj;

1518
out:
1519 1520 1521
    g_free(type);
}

1522
void object_property_allow_set_link(const Object *obj, const char *name,
1523 1524 1525 1526 1527
                                    Object *val, Error **errp)
{
    /* Allow the link to be set, always */
}

1528 1529
typedef struct {
    Object **child;
1530
    void (*check)(const Object *, const char *, Object *, Error **);
1531 1532 1533
    ObjectPropertyLinkFlags flags;
} LinkProperty;

1534 1535 1536
static void object_get_link_property(Object *obj, Visitor *v,
                                     const char *name, void *opaque,
                                     Error **errp)
1537
{
1538 1539
    LinkProperty *lprop = opaque;
    Object **child = lprop->child;
1540 1541 1542 1543
    gchar *path;

    if (*child) {
        path = object_get_canonical_path(*child);
1544
        visit_type_str(v, name, &path, errp);
1545 1546 1547
        g_free(path);
    } else {
        path = (gchar *)"";
1548
        visit_type_str(v, name, &path, errp);
1549 1550 1551
    }
}

1552 1553 1554 1555 1556 1557 1558 1559 1560 1561 1562 1563 1564 1565 1566 1567 1568 1569 1570 1571 1572 1573 1574
/*
 * object_resolve_link:
 *
 * Lookup an object and ensure its type matches the link property type.  This
 * is similar to object_resolve_path() except type verification against the
 * link property is performed.
 *
 * Returns: The matched object or NULL on path lookup failures.
 */
static Object *object_resolve_link(Object *obj, const char *name,
                                   const char *path, Error **errp)
{
    const char *type;
    gchar *target_type;
    bool ambiguous = false;
    Object *target;

    /* Go from link<FOO> to FOO.  */
    type = object_property_get_type(obj, name, NULL);
    target_type = g_strndup(&type[5], strlen(type) - 6);
    target = object_resolve_path_type(path, target_type, &ambiguous);

    if (ambiguous) {
E
Eric Blake 已提交
1575 1576
        error_setg(errp, "Path '%s' does not uniquely identify an object",
                   path);
1577 1578 1579
    } else if (!target) {
        target = object_resolve_path(path, &ambiguous);
        if (target || ambiguous) {
1580
            error_setg(errp, QERR_INVALID_PARAMETER_TYPE, name, target_type);
1581
        } else {
1582 1583
            error_set(errp, ERROR_CLASS_DEVICE_NOT_FOUND,
                      "Device '%s' not found", path);
1584 1585 1586 1587 1588 1589 1590 1591
        }
        target = NULL;
    }
    g_free(target_type);

    return target;
}

1592 1593 1594
static void object_set_link_property(Object *obj, Visitor *v,
                                     const char *name, void *opaque,
                                     Error **errp)
1595
{
1596
    Error *local_err = NULL;
1597 1598
    LinkProperty *prop = opaque;
    Object **child = prop->child;
1599 1600 1601
    Object *old_target = *child;
    Object *new_target = NULL;
    char *path = NULL;
1602

1603
    visit_type_str(v, name, &path, &local_err);
1604

1605 1606
    if (!local_err && strcmp(path, "") != 0) {
        new_target = object_resolve_link(obj, name, path, &local_err);
1607 1608 1609
    }

    g_free(path);
1610 1611 1612 1613
    if (local_err) {
        error_propagate(errp, local_err);
        return;
    }
1614

1615 1616 1617 1618 1619 1620
    prop->check(obj, name, new_target, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        return;
    }

1621
    *child = new_target;
1622 1623 1624 1625
    if (prop->flags == OBJ_PROP_LINK_STRONG) {
        object_ref(new_target);
        object_unref(old_target);
    }
1626 1627
}

1628 1629 1630 1631 1632 1633 1634
static Object *object_resolve_link_property(Object *parent, void *opaque, const gchar *part)
{
    LinkProperty *lprop = opaque;

    return *lprop->child;
}

1635 1636 1637 1638 1639
static void object_release_link_property(Object *obj, const char *name,
                                         void *opaque)
{
    LinkProperty *prop = opaque;

1640
    if ((prop->flags & OBJ_PROP_LINK_STRONG) && *prop->child) {
1641 1642 1643 1644 1645
        object_unref(*prop->child);
    }
    g_free(prop);
}

1646 1647
void object_property_add_link(Object *obj, const char *name,
                              const char *type, Object **child,
1648
                              void (*check)(const Object *, const char *,
1649
                                            Object *, Error **),
1650
                              ObjectPropertyLinkFlags flags,
1651 1652
                              Error **errp)
{
1653 1654
    Error *local_err = NULL;
    LinkProperty *prop = g_malloc(sizeof(*prop));
1655
    gchar *full_type;
1656
    ObjectProperty *op;
1657

1658
    prop->child = child;
1659
    prop->check = check;
1660 1661
    prop->flags = flags;

1662 1663
    full_type = g_strdup_printf("link<%s>", type);

1664 1665 1666 1667 1668 1669
    op = object_property_add(obj, name, full_type,
                             object_get_link_property,
                             check ? object_set_link_property : NULL,
                             object_release_link_property,
                             prop,
                             &local_err);
1670 1671 1672
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
1673
        goto out;
1674
    }
1675

1676 1677 1678
    op->resolve = object_resolve_link_property;

out:
1679 1680 1681
    g_free(full_type);
}

1682 1683 1684 1685 1686 1687 1688 1689 1690 1691 1692 1693 1694 1695 1696 1697
void object_property_add_const_link(Object *obj, const char *name,
                                    Object *target, Error **errp)
{
    char *link_type;
    ObjectProperty *op;

    link_type = g_strdup_printf("link<%s>", object_get_typename(target));
    op = object_property_add(obj, name, link_type,
                             object_get_child_property, NULL,
                             NULL, target, errp);
    if (op != NULL) {
        op->resolve = object_resolve_child_property;
    }
    g_free(link_type);
}

1698 1699 1700
gchar *object_get_canonical_path_component(Object *obj)
{
    ObjectProperty *prop = NULL;
1701
    GHashTableIter iter;
1702

1703 1704 1705
    if (obj->parent == NULL) {
        return NULL;
    }
1706

1707 1708
    g_hash_table_iter_init(&iter, obj->parent->properties);
    while (g_hash_table_iter_next(&iter, NULL, (gpointer *)&prop)) {
1709 1710 1711 1712 1713 1714 1715 1716 1717 1718 1719 1720 1721 1722
        if (!object_property_is_child(prop)) {
            continue;
        }

        if (prop->opaque == obj) {
            return g_strdup(prop->name);
        }
    }

    /* obj had a parent but was not a child, should never happen */
    g_assert_not_reached();
    return NULL;
}

1723 1724 1725
gchar *object_get_canonical_path(Object *obj)
{
    Object *root = object_get_root();
1726
    char *newpath, *path = NULL;
1727

1728 1729 1730 1731 1732
    if (obj == root) {
        return g_strdup("/");
    }

    do {
1733
        char *component = object_get_canonical_path_component(obj);
1734

1735 1736 1737 1738
        if (!component) {
            /* A canonical path must be complete, so discard what was
             * collected so far.
             */
1739
            g_free(path);
1740
            return NULL;
1741 1742
        }

1743 1744 1745 1746
        newpath = g_strdup_printf("/%s%s", component, path ? path : "");
        g_free(path);
        g_free(component);
        path = newpath;
1747
        obj = obj->parent;
1748
    } while (obj != root);
1749

1750
    return path;
1751 1752
}

1753
Object *object_resolve_path_component(Object *parent, const gchar *part)
P
Paolo Bonzini 已提交
1754
{
1755
    ObjectProperty *prop = object_property_find(parent, part, NULL);
P
Paolo Bonzini 已提交
1756 1757 1758 1759
    if (prop == NULL) {
        return NULL;
    }

1760 1761
    if (prop->resolve) {
        return prop->resolve(parent, prop->opaque, part);
P
Paolo Bonzini 已提交
1762 1763 1764 1765 1766
    } else {
        return NULL;
    }
}

1767 1768
static Object *object_resolve_abs_path(Object *parent,
                                          gchar **parts,
1769
                                          const char *typename,
1770 1771 1772 1773 1774
                                          int index)
{
    Object *child;

    if (parts[index] == NULL) {
1775
        return object_dynamic_cast(parent, typename);
1776 1777 1778
    }

    if (strcmp(parts[index], "") == 0) {
1779
        return object_resolve_abs_path(parent, parts, typename, index + 1);
1780 1781
    }

P
Paolo Bonzini 已提交
1782
    child = object_resolve_path_component(parent, parts[index]);
1783 1784 1785 1786
    if (!child) {
        return NULL;
    }

1787
    return object_resolve_abs_path(child, parts, typename, index + 1);
1788 1789 1790 1791
}

static Object *object_resolve_partial_path(Object *parent,
                                              gchar **parts,
1792
                                              const char *typename,
1793 1794 1795
                                              bool *ambiguous)
{
    Object *obj;
1796
    GHashTableIter iter;
1797 1798
    ObjectProperty *prop;

1799
    obj = object_resolve_abs_path(parent, parts, typename, 0);
1800

1801 1802
    g_hash_table_iter_init(&iter, parent->properties);
    while (g_hash_table_iter_next(&iter, NULL, (gpointer *)&prop)) {
1803 1804
        Object *found;

1805
        if (!object_property_is_child(prop)) {
1806 1807 1808
            continue;
        }

1809 1810
        found = object_resolve_partial_path(prop->opaque, parts,
                                            typename, ambiguous);
1811 1812
        if (found) {
            if (obj) {
1813
                *ambiguous = true;
1814 1815 1816 1817 1818
                return NULL;
            }
            obj = found;
        }

1819
        if (*ambiguous) {
1820 1821 1822 1823 1824 1825 1826
            return NULL;
        }
    }

    return obj;
}

1827
Object *object_resolve_path_type(const char *path, const char *typename,
1828
                                 bool *ambiguousp)
1829 1830 1831 1832 1833
{
    Object *obj;
    gchar **parts;

    parts = g_strsplit(path, "/", 0);
1834
    assert(parts);
1835

1836
    if (parts[0] == NULL || strcmp(parts[0], "") != 0) {
1837
        bool ambiguous = false;
1838
        obj = object_resolve_partial_path(object_get_root(), parts,
1839 1840 1841 1842
                                          typename, &ambiguous);
        if (ambiguousp) {
            *ambiguousp = ambiguous;
        }
1843
    } else {
1844
        obj = object_resolve_abs_path(object_get_root(), parts, typename, 1);
1845 1846 1847 1848 1849 1850 1851
    }

    g_strfreev(parts);

    return obj;
}

1852 1853 1854 1855 1856
Object *object_resolve_path(const char *path, bool *ambiguous)
{
    return object_resolve_path_type(path, TYPE_OBJECT, ambiguous);
}

1857 1858 1859 1860 1861 1862
typedef struct StringProperty
{
    char *(*get)(Object *, Error **);
    void (*set)(Object *, const char *, Error **);
} StringProperty;

1863 1864
static void property_get_str(Object *obj, Visitor *v, const char *name,
                             void *opaque, Error **errp)
1865 1866 1867
{
    StringProperty *prop = opaque;
    char *value;
1868
    Error *err = NULL;
1869

1870 1871 1872 1873
    value = prop->get(obj, &err);
    if (err) {
        error_propagate(errp, err);
        return;
1874
    }
1875

1876
    visit_type_str(v, name, &value, errp);
1877
    g_free(value);
1878 1879
}

1880 1881
static void property_set_str(Object *obj, Visitor *v, const char *name,
                             void *opaque, Error **errp)
1882 1883 1884 1885 1886
{
    StringProperty *prop = opaque;
    char *value;
    Error *local_err = NULL;

1887
    visit_type_str(v, name, &value, &local_err);
1888 1889 1890 1891 1892 1893 1894 1895 1896
    if (local_err) {
        error_propagate(errp, local_err);
        return;
    }

    prop->set(obj, value, errp);
    g_free(value);
}

1897 1898
static void property_release_str(Object *obj, const char *name,
                                 void *opaque)
1899 1900 1901 1902 1903 1904 1905 1906 1907 1908
{
    StringProperty *prop = opaque;
    g_free(prop);
}

void object_property_add_str(Object *obj, const char *name,
                           char *(*get)(Object *, Error **),
                           void (*set)(Object *, const char *, Error **),
                           Error **errp)
{
1909
    Error *local_err = NULL;
1910 1911 1912 1913 1914 1915
    StringProperty *prop = g_malloc0(sizeof(*prop));

    prop->get = get;
    prop->set = set;

    object_property_add(obj, name, "string",
1916 1917 1918
                        get ? property_get_str : NULL,
                        set ? property_set_str : NULL,
                        property_release_str,
1919 1920 1921 1922 1923
                        prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
    }
1924
}
P
Paolo Bonzini 已提交
1925

1926 1927 1928 1929 1930 1931 1932 1933 1934 1935 1936 1937 1938 1939 1940 1941 1942 1943 1944 1945 1946 1947 1948
void object_class_property_add_str(ObjectClass *klass, const char *name,
                                   char *(*get)(Object *, Error **),
                                   void (*set)(Object *, const char *,
                                               Error **),
                                   Error **errp)
{
    Error *local_err = NULL;
    StringProperty *prop = g_malloc0(sizeof(*prop));

    prop->get = get;
    prop->set = set;

    object_class_property_add(klass, name, "string",
                              get ? property_get_str : NULL,
                              set ? property_set_str : NULL,
                              property_release_str,
                              prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
    }
}

1949 1950 1951 1952 1953 1954
typedef struct BoolProperty
{
    bool (*get)(Object *, Error **);
    void (*set)(Object *, bool, Error **);
} BoolProperty;

1955 1956
static void property_get_bool(Object *obj, Visitor *v, const char *name,
                              void *opaque, Error **errp)
1957 1958 1959
{
    BoolProperty *prop = opaque;
    bool value;
1960 1961 1962 1963 1964 1965 1966
    Error *err = NULL;

    value = prop->get(obj, &err);
    if (err) {
        error_propagate(errp, err);
        return;
    }
1967

1968
    visit_type_bool(v, name, &value, errp);
1969 1970
}

1971 1972
static void property_set_bool(Object *obj, Visitor *v, const char *name,
                              void *opaque, Error **errp)
1973 1974 1975 1976 1977
{
    BoolProperty *prop = opaque;
    bool value;
    Error *local_err = NULL;

1978
    visit_type_bool(v, name, &value, &local_err);
1979 1980 1981 1982 1983 1984 1985 1986 1987 1988 1989 1990 1991 1992 1993 1994 1995 1996 1997 1998
    if (local_err) {
        error_propagate(errp, local_err);
        return;
    }

    prop->set(obj, value, errp);
}

static void property_release_bool(Object *obj, const char *name,
                                  void *opaque)
{
    BoolProperty *prop = opaque;
    g_free(prop);
}

void object_property_add_bool(Object *obj, const char *name,
                              bool (*get)(Object *, Error **),
                              void (*set)(Object *, bool, Error **),
                              Error **errp)
{
1999
    Error *local_err = NULL;
2000 2001 2002 2003 2004 2005 2006 2007 2008
    BoolProperty *prop = g_malloc0(sizeof(*prop));

    prop->get = get;
    prop->set = set;

    object_property_add(obj, name, "bool",
                        get ? property_get_bool : NULL,
                        set ? property_set_bool : NULL,
                        property_release_bool,
2009 2010 2011 2012 2013
                        prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
    }
2014 2015
}

2016 2017 2018 2019 2020 2021 2022 2023 2024 2025 2026 2027 2028 2029 2030 2031 2032 2033 2034 2035 2036 2037
void object_class_property_add_bool(ObjectClass *klass, const char *name,
                                    bool (*get)(Object *, Error **),
                                    void (*set)(Object *, bool, Error **),
                                    Error **errp)
{
    Error *local_err = NULL;
    BoolProperty *prop = g_malloc0(sizeof(*prop));

    prop->get = get;
    prop->set = set;

    object_class_property_add(klass, name, "bool",
                              get ? property_get_bool : NULL,
                              set ? property_set_bool : NULL,
                              property_release_bool,
                              prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
    }
}

2038 2039
static void property_get_enum(Object *obj, Visitor *v, const char *name,
                              void *opaque, Error **errp)
2040 2041 2042
{
    EnumProperty *prop = opaque;
    int value;
2043 2044 2045 2046 2047 2048 2049
    Error *err = NULL;

    value = prop->get(obj, &err);
    if (err) {
        error_propagate(errp, err);
        return;
    }
2050

2051
    visit_type_enum(v, name, &value, prop->lookup, errp);
2052 2053
}

2054 2055
static void property_set_enum(Object *obj, Visitor *v, const char *name,
                              void *opaque, Error **errp)
2056 2057 2058
{
    EnumProperty *prop = opaque;
    int value;
2059
    Error *err = NULL;
2060

2061
    visit_type_enum(v, name, &value, prop->lookup, &err);
2062 2063 2064 2065
    if (err) {
        error_propagate(errp, err);
        return;
    }
2066 2067 2068 2069 2070 2071 2072 2073 2074 2075 2076 2077
    prop->set(obj, value, errp);
}

static void property_release_enum(Object *obj, const char *name,
                                  void *opaque)
{
    EnumProperty *prop = opaque;
    g_free(prop);
}

void object_property_add_enum(Object *obj, const char *name,
                              const char *typename,
2078
                              const QEnumLookup *lookup,
2079 2080 2081 2082 2083 2084 2085
                              int (*get)(Object *, Error **),
                              void (*set)(Object *, int, Error **),
                              Error **errp)
{
    Error *local_err = NULL;
    EnumProperty *prop = g_malloc(sizeof(*prop));

2086
    prop->lookup = lookup;
2087 2088 2089 2090 2091 2092 2093 2094 2095 2096 2097 2098 2099 2100
    prop->get = get;
    prop->set = set;

    object_property_add(obj, name, typename,
                        get ? property_get_enum : NULL,
                        set ? property_set_enum : NULL,
                        property_release_enum,
                        prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
    }
}

2101 2102
void object_class_property_add_enum(ObjectClass *klass, const char *name,
                                    const char *typename,
2103
                                    const QEnumLookup *lookup,
2104 2105 2106 2107 2108 2109 2110
                                    int (*get)(Object *, Error **),
                                    void (*set)(Object *, int, Error **),
                                    Error **errp)
{
    Error *local_err = NULL;
    EnumProperty *prop = g_malloc(sizeof(*prop));

2111
    prop->lookup = lookup;
2112 2113 2114 2115 2116 2117 2118 2119 2120 2121 2122 2123 2124 2125
    prop->get = get;
    prop->set = set;

    object_class_property_add(klass, name, typename,
                              get ? property_get_enum : NULL,
                              set ? property_set_enum : NULL,
                              property_release_enum,
                              prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
    }
}

2126 2127 2128 2129
typedef struct TMProperty {
    void (*get)(Object *, struct tm *, Error **);
} TMProperty;

2130 2131
static void property_get_tm(Object *obj, Visitor *v, const char *name,
                            void *opaque, Error **errp)
2132 2133 2134 2135 2136 2137 2138 2139 2140 2141
{
    TMProperty *prop = opaque;
    Error *err = NULL;
    struct tm value;

    prop->get(obj, &value, &err);
    if (err) {
        goto out;
    }

2142
    visit_start_struct(v, name, NULL, 0, &err);
2143 2144 2145
    if (err) {
        goto out;
    }
2146
    visit_type_int32(v, "tm_year", &value.tm_year, &err);
2147 2148 2149
    if (err) {
        goto out_end;
    }
2150
    visit_type_int32(v, "tm_mon", &value.tm_mon, &err);
2151 2152 2153
    if (err) {
        goto out_end;
    }
2154
    visit_type_int32(v, "tm_mday", &value.tm_mday, &err);
2155 2156 2157
    if (err) {
        goto out_end;
    }
2158
    visit_type_int32(v, "tm_hour", &value.tm_hour, &err);
2159 2160 2161
    if (err) {
        goto out_end;
    }
2162
    visit_type_int32(v, "tm_min", &value.tm_min, &err);
2163 2164 2165
    if (err) {
        goto out_end;
    }
2166
    visit_type_int32(v, "tm_sec", &value.tm_sec, &err);
2167 2168 2169
    if (err) {
        goto out_end;
    }
2170
    visit_check_struct(v, &err);
2171
out_end:
E
Eric Blake 已提交
2172
    visit_end_struct(v, NULL);
2173 2174 2175 2176 2177 2178 2179 2180 2181 2182 2183 2184 2185 2186 2187 2188 2189 2190 2191 2192 2193 2194 2195 2196 2197 2198 2199 2200 2201 2202 2203
out:
    error_propagate(errp, err);

}

static void property_release_tm(Object *obj, const char *name,
                                void *opaque)
{
    TMProperty *prop = opaque;
    g_free(prop);
}

void object_property_add_tm(Object *obj, const char *name,
                            void (*get)(Object *, struct tm *, Error **),
                            Error **errp)
{
    Error *local_err = NULL;
    TMProperty *prop = g_malloc0(sizeof(*prop));

    prop->get = get;

    object_property_add(obj, name, "struct tm",
                        get ? property_get_tm : NULL, NULL,
                        property_release_tm,
                        prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
    }
}

2204 2205 2206 2207 2208 2209 2210 2211 2212 2213 2214 2215 2216 2217 2218 2219 2220 2221 2222
void object_class_property_add_tm(ObjectClass *klass, const char *name,
                                  void (*get)(Object *, struct tm *, Error **),
                                  Error **errp)
{
    Error *local_err = NULL;
    TMProperty *prop = g_malloc0(sizeof(*prop));

    prop->get = get;

    object_class_property_add(klass, name, "struct tm",
                              get ? property_get_tm : NULL, NULL,
                              property_release_tm,
                              prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
    }
}

2223 2224 2225 2226 2227
static char *qdev_get_type(Object *obj, Error **errp)
{
    return g_strdup(object_get_typename(obj));
}

2228 2229
static void property_get_uint8_ptr(Object *obj, Visitor *v, const char *name,
                                   void *opaque, Error **errp)
2230 2231
{
    uint8_t value = *(uint8_t *)opaque;
2232
    visit_type_uint8(v, name, &value, errp);
2233 2234
}

2235 2236
static void property_get_uint16_ptr(Object *obj, Visitor *v, const char *name,
                                    void *opaque, Error **errp)
2237 2238
{
    uint16_t value = *(uint16_t *)opaque;
2239
    visit_type_uint16(v, name, &value, errp);
2240 2241
}

2242 2243
static void property_get_uint32_ptr(Object *obj, Visitor *v, const char *name,
                                    void *opaque, Error **errp)
2244 2245
{
    uint32_t value = *(uint32_t *)opaque;
2246
    visit_type_uint32(v, name, &value, errp);
2247 2248
}

2249 2250
static void property_get_uint64_ptr(Object *obj, Visitor *v, const char *name,
                                    void *opaque, Error **errp)
2251 2252
{
    uint64_t value = *(uint64_t *)opaque;
2253
    visit_type_uint64(v, name, &value, errp);
2254 2255 2256 2257 2258 2259 2260 2261 2262
}

void object_property_add_uint8_ptr(Object *obj, const char *name,
                                   const uint8_t *v, Error **errp)
{
    object_property_add(obj, name, "uint8", property_get_uint8_ptr,
                        NULL, NULL, (void *)v, errp);
}

2263 2264 2265 2266 2267 2268 2269
void object_class_property_add_uint8_ptr(ObjectClass *klass, const char *name,
                                         const uint8_t *v, Error **errp)
{
    object_class_property_add(klass, name, "uint8", property_get_uint8_ptr,
                              NULL, NULL, (void *)v, errp);
}

2270 2271 2272 2273 2274 2275 2276
void object_property_add_uint16_ptr(Object *obj, const char *name,
                                    const uint16_t *v, Error **errp)
{
    object_property_add(obj, name, "uint16", property_get_uint16_ptr,
                        NULL, NULL, (void *)v, errp);
}

2277 2278 2279 2280 2281 2282 2283
void object_class_property_add_uint16_ptr(ObjectClass *klass, const char *name,
                                          const uint16_t *v, Error **errp)
{
    object_class_property_add(klass, name, "uint16", property_get_uint16_ptr,
                              NULL, NULL, (void *)v, errp);
}

2284 2285 2286 2287 2288 2289 2290
void object_property_add_uint32_ptr(Object *obj, const char *name,
                                    const uint32_t *v, Error **errp)
{
    object_property_add(obj, name, "uint32", property_get_uint32_ptr,
                        NULL, NULL, (void *)v, errp);
}

2291 2292 2293 2294 2295 2296 2297
void object_class_property_add_uint32_ptr(ObjectClass *klass, const char *name,
                                          const uint32_t *v, Error **errp)
{
    object_class_property_add(klass, name, "uint32", property_get_uint32_ptr,
                              NULL, NULL, (void *)v, errp);
}

2298 2299 2300 2301 2302 2303 2304
void object_property_add_uint64_ptr(Object *obj, const char *name,
                                    const uint64_t *v, Error **errp)
{
    object_property_add(obj, name, "uint64", property_get_uint64_ptr,
                        NULL, NULL, (void *)v, errp);
}

2305 2306 2307 2308 2309 2310 2311
void object_class_property_add_uint64_ptr(ObjectClass *klass, const char *name,
                                          const uint64_t *v, Error **errp)
{
    object_class_property_add(klass, name, "uint64", property_get_uint64_ptr,
                              NULL, NULL, (void *)v, errp);
}

2312 2313
typedef struct {
    Object *target_obj;
2314
    char *target_name;
2315 2316
} AliasProperty;

2317 2318
static void property_get_alias(Object *obj, Visitor *v, const char *name,
                               void *opaque, Error **errp)
2319 2320 2321 2322 2323 2324
{
    AliasProperty *prop = opaque;

    object_property_get(prop->target_obj, v, prop->target_name, errp);
}

2325 2326
static void property_set_alias(Object *obj, Visitor *v, const char *name,
                               void *opaque, Error **errp)
2327 2328 2329 2330 2331 2332
{
    AliasProperty *prop = opaque;

    object_property_set(prop->target_obj, v, prop->target_name, errp);
}

2333 2334 2335 2336 2337 2338 2339 2340
static Object *property_resolve_alias(Object *obj, void *opaque,
                                      const gchar *part)
{
    AliasProperty *prop = opaque;

    return object_resolve_path_component(prop->target_obj, prop->target_name);
}

2341 2342 2343 2344
static void property_release_alias(Object *obj, const char *name, void *opaque)
{
    AliasProperty *prop = opaque;

2345
    g_free(prop->target_name);
2346 2347 2348 2349 2350 2351 2352 2353
    g_free(prop);
}

void object_property_add_alias(Object *obj, const char *name,
                               Object *target_obj, const char *target_name,
                               Error **errp)
{
    AliasProperty *prop;
2354
    ObjectProperty *op;
2355
    ObjectProperty *target_prop;
2356
    gchar *prop_type;
2357
    Error *local_err = NULL;
2358 2359 2360 2361 2362 2363

    target_prop = object_property_find(target_obj, target_name, errp);
    if (!target_prop) {
        return;
    }

2364 2365 2366 2367 2368 2369 2370
    if (object_property_is_child(target_prop)) {
        prop_type = g_strdup_printf("link%s",
                                    target_prop->type + strlen("child"));
    } else {
        prop_type = g_strdup(target_prop->type);
    }

2371 2372
    prop = g_malloc(sizeof(*prop));
    prop->target_obj = target_obj;
2373
    prop->target_name = g_strdup(target_name);
2374

2375
    op = object_property_add(obj, name, prop_type,
2376 2377 2378
                             property_get_alias,
                             property_set_alias,
                             property_release_alias,
2379 2380 2381 2382 2383 2384
                             prop, &local_err);
    if (local_err) {
        error_propagate(errp, local_err);
        g_free(prop);
        goto out;
    }
2385
    op->resolve = property_resolve_alias;
2386

2387
    object_property_set_description(obj, op->name,
2388 2389 2390
                                    target_prop->description,
                                    &error_abort);

2391
out:
2392
    g_free(prop_type);
2393 2394
}

2395 2396 2397 2398 2399 2400 2401 2402 2403 2404 2405 2406 2407 2408
void object_property_set_description(Object *obj, const char *name,
                                     const char *description, Error **errp)
{
    ObjectProperty *op;

    op = object_property_find(obj, name, errp);
    if (!op) {
        return;
    }

    g_free(op->description);
    op->description = g_strdup(description);
}

2409 2410 2411 2412 2413 2414 2415 2416 2417 2418 2419 2420 2421 2422 2423 2424 2425
void object_class_property_set_description(ObjectClass *klass,
                                           const char *name,
                                           const char *description,
                                           Error **errp)
{
    ObjectProperty *op;

    op = g_hash_table_lookup(klass->properties, name);
    if (!op) {
        error_setg(errp, "Property '.%s' not found", name);
        return;
    }

    g_free(op->description);
    op->description = g_strdup(description);
}

2426 2427 2428 2429 2430
static void object_instance_init(Object *obj)
{
    object_property_add_str(obj, "type", qdev_get_type, NULL, NULL);
}

P
Paolo Bonzini 已提交
2431 2432 2433 2434
static void register_types(void)
{
    static TypeInfo interface_info = {
        .name = TYPE_INTERFACE,
A
Anthony Liguori 已提交
2435
        .class_size = sizeof(InterfaceClass),
P
Paolo Bonzini 已提交
2436 2437 2438 2439 2440 2441
        .abstract = true,
    };

    static TypeInfo object_info = {
        .name = TYPE_OBJECT,
        .instance_size = sizeof(Object),
2442
        .instance_init = object_instance_init,
P
Paolo Bonzini 已提交
2443 2444 2445
        .abstract = true,
    };

2446 2447
    type_interface = type_register_internal(&interface_info);
    type_register_internal(&object_info);
P
Paolo Bonzini 已提交
2448 2449 2450
}

type_init(register_types)