qom/object.c

   1 /*
   2  * QEMU Object Model
   3  *
   4  * Copyright IBM, Corp. 2011
   5  *
   6  * Authors:
   7  *  Anthony Liguori   <aliguori@us.ibm.com>
   8  *
   9  * This work is licensed under the terms of the GNU GPL, version 2 or later.
  10  * See the COPYING file in the top-level directory.
  11  */
  12
  13 #include "qemu/object.h"
  14 #include "qemu-common.h"
  15 #include "qapi/qapi-visit-core.h"
  16 #include "hw/qdev.h"
  17 // FIXME remove above
  18
  19 #define MAX_INTERFACES 32
  20
  21 typedef struct InterfaceImpl InterfaceImpl;
  22 typedef struct TypeImpl TypeImpl;
  23
  24 struct InterfaceImpl
  25 {
  26     const char *parent;
  27     void (*interface_initfn)(ObjectClass *class, void *data);
  28     TypeImpl *type;
  29 };
  30
  31 struct TypeImpl
  32 {
  33     const char *name;
  34
  35     size_t class_size;
  36
  37     size_t instance_size;
  38
  39     void (*class_init)(ObjectClass *klass, void *data);
  40     void (*class_finalize)(ObjectClass *klass, void *data);
  41
  42     void *class_data;
  43
  44     void (*instance_init)(Object *obj);
  45     void (*instance_finalize)(Object *obj);
  46
  47     bool abstract;
  48
  49     const char *parent;
  50     TypeImpl *parent_type;
  51
  52     ObjectClass *class;
  53
  54     int num_interfaces;
  55     InterfaceImpl interfaces[MAX_INTERFACES];
  56 };
  57
  58 typedef struct Interface
  59 {
  60     Object parent;
  61     Object *obj;
  62 } Interface;
  63
  64 #define INTERFACE(obj) OBJECT_CHECK(Interface, obj, TYPE_INTERFACE)
  65
  66 static GHashTable *type_table_get(void)
  67 {
  68     static GHashTable *type_table;
  69
  70     if (type_table == NULL) {
  71         type_table = g_hash_table_new(g_str_hash, g_str_equal);
  72     }
  73
  74     return type_table;
  75 }
  76
  77 static void type_table_add(TypeImpl *ti)
  78 {
  79     g_hash_table_insert(type_table_get(), (void *)ti->name, ti);
  80 }
  81
  82 static TypeImpl *type_table_lookup(const char *name)
  83 {
  84     return g_hash_table_lookup(type_table_get(), name);
  85 }
  86
  87 TypeImpl *type_register(const TypeInfo *info)
  88 {
  89     TypeImpl *ti = g_malloc0(sizeof(*ti));
  90
  91     g_assert(info->name != NULL);
  92
  93     if (type_table_lookup(info->name) != NULL) {
  94         fprintf(stderr, "Registering `%s' which already exists\n", info->name);
  95         abort();
  96     }
  97
  98     ti->name = g_strdup(info->name);
  99     ti->parent = g_strdup(info->parent);
 100
 101     ti->class_size = info->class_size;
 102     ti->instance_size = info->instance_size;
 103
 104     ti->class_init = info->class_init;
 105     ti->class_finalize = info->class_finalize;
 106     ti->class_data = info->class_data;
 107
 108     ti->instance_init = info->instance_init;
 109     ti->instance_finalize = info->instance_finalize;
 110
 111     ti->abstract = info->abstract;
 112
 113     if (info->interfaces) {
 114         int i;
 115
 116         for (i = 0; info->interfaces[i].type; i++) {
 117             ti->interfaces[i].parent = info->interfaces[i].type;
 118             ti->interfaces[i].interface_initfn = info->interfaces[i].interface_initfn;
 119             ti->num_interfaces++;
 120         }
 121     }
 122
 123     type_table_add(ti);
 124
 125     return ti;
 126 }
 127
 128 TypeImpl *type_register_static(const TypeInfo *info)
 129 {
 130     return type_register(info);
 131 }
 132
 133 static TypeImpl *type_get_by_name(const char *name)
 134 {
 135     if (name == NULL) {
 136         return NULL;
 137     }
 138
 139     return type_table_lookup(name);
 140 }
 141
 142 static TypeImpl *type_get_parent(TypeImpl *type)
 143 {
 144     if (!type->parent_type && type->parent) {
 145         type->parent_type = type_get_by_name(type->parent);
 146         g_assert(type->parent_type != NULL);
 147     }
 148
 149     return type->parent_type;
 150 }
 151
 152 static bool type_has_parent(TypeImpl *type)
 153 {
 154     return (type->parent != NULL);
 155 }
 156
 157 static size_t type_class_get_size(TypeImpl *ti)
 158 {
 159     if (ti->class_size) {
 160         return ti->class_size;
 161     }
 162
 163     if (type_has_parent(ti)) {
 164         return type_class_get_size(type_get_parent(ti));
 165     }
 166
 167     return sizeof(ObjectClass);
 168 }
 169
 170 static void type_class_interface_init(TypeImpl *ti, InterfaceImpl *iface)
 171 {
 172     TypeInfo info = {
 173         .instance_size = sizeof(Interface),
 174         .parent = iface->parent,
 175         .class_size = sizeof(InterfaceClass),
 176         .class_init = iface->interface_initfn,
 177         .abstract = true,
 178     };
 179     char *name = g_strdup_printf("<%s::%s>", ti->name, iface->parent);
 180
 181     info.name = name;
 182     iface->type = type_register(&info);
 183     g_free(name);
 184 }
 185
 186 static void type_class_init(TypeImpl *ti)
 187 {
 188     size_t class_size = sizeof(ObjectClass);
 189     int i;
 190
 191     if (ti->class) {
 192         return;
 193     }
 194
 195     ti->class_size = type_class_get_size(ti);
 196
 197     ti->class = g_malloc0(ti->class_size);
 198     ti->class->type = ti;
 199
 200     if (type_has_parent(ti)) {
 201         TypeImpl *parent = type_get_parent(ti);
 202
 203         type_class_init(parent);
 204
 205         class_size = parent->class_size;
 206         g_assert(parent->class_size <= ti->class_size);
 207
 208         memcpy((void *)ti->class + sizeof(ObjectClass),
 209                (void *)parent->class + sizeof(ObjectClass),
 210                parent->class_size - sizeof(ObjectClass));
 211     }
 212
 213     memset((void *)ti->class + class_size, 0, ti->class_size - class_size);
 214
 215     for (i = 0; i < ti->num_interfaces; i++) {
 216         type_class_interface_init(ti, &ti->interfaces[i]);
 217     }
 218
 219     if (ti->class_init) {
 220         ti->class_init(ti->class, ti->class_data);
 221     }
 222 }
 223
 224 static void object_interface_init(Object *obj, InterfaceImpl *iface)
 225 {
 226     TypeImpl *ti = iface->type;
 227     Interface *iface_obj;
 228
 229     iface_obj = INTERFACE(object_new(ti->name));
 230     iface_obj->obj = obj;
 231
 232     obj->interfaces = g_slist_prepend(obj->interfaces, iface_obj);
 233 }
 234
 235 static void object_init_with_type(Object *obj, TypeImpl *ti)
 236 {
 237     int i;
 238
 239     if (type_has_parent(ti)) {
 240         object_init_with_type(obj, type_get_parent(ti));
 241     }
 242
 243     for (i = 0; i < ti->num_interfaces; i++) {
 244         object_interface_init(obj, &ti->interfaces[i]);
 245     }
 246
 247     if (ti->instance_init) {
 248         ti->instance_init(obj);
 249     }
 250 }
 251
 252 void object_initialize_with_type(void *data, TypeImpl *type)
 253 {
 254     Object *obj = data;
 255
 256     g_assert(type != NULL);
 257     g_assert(type->instance_size >= sizeof(ObjectClass));
 258
 259     type_class_init(type);
 260     g_assert(type->abstract == false);
 261
 262     memset(obj, 0, type->instance_size);
 263     obj->class = type->class;
 264     QTAILQ_INIT(&obj->properties);
 265     object_init_with_type(obj, type);
 266 }
 267
 268 void object_initialize(void *data, const char *typename)
 269 {
 270     TypeImpl *type = type_get_by_name(typename);
 271
 272     object_initialize_with_type(data, type);
 273 }
 274
 275 static void object_property_del_all(Object *obj)
 276 {
 277     while (!QTAILQ_EMPTY(&obj->properties)) {
 278         ObjectProperty *prop = QTAILQ_FIRST(&obj->properties);
 279
 280         QTAILQ_REMOVE(&obj->properties, prop, node);
 281
 282         if (prop->release) {
 283             prop->release(obj, prop->name, prop->opaque);
 284         }
 285
 286         g_free(prop->name);
 287         g_free(prop->type);
 288         g_free(prop);
 289     }
 290 }
 291
 292 static void object_property_del_child(Object *obj, Object *child, Error **errp)
 293 {
 294     ObjectProperty *prop;
 295
 296     QTAILQ_FOREACH(prop, &obj->properties, node) {
 297         if (!strstart(prop->type, "child<", NULL)) {
 298             continue;
 299         }
 300
 301         if (prop->opaque == child) {
 302             object_property_del(obj, prop->name, errp);
 303         }
 304     }
 305 }
 306
 307 void object_unparent(Object *obj)
 308 {
 309     if (obj->parent) {
 310         object_property_del_child(obj->parent, obj, NULL);
 311     }
 312 }
 313
 314 static void object_deinit(Object *obj, TypeImpl *type)
 315 {
 316     if (type->instance_finalize) {
 317         type->instance_finalize(obj);
 318     }
 319
 320     while (obj->interfaces) {
 321         Interface *iface_obj = obj->interfaces->data;
 322         obj->interfaces = g_slist_delete_link(obj->interfaces, obj->interfaces);
 323         object_delete(OBJECT(iface_obj));
 324     }
 325
 326     if (type_has_parent(type)) {
 327         object_deinit(obj, type_get_parent(type));
 328     }
 329
 330     object_unparent(obj);
 331 }
 332
 333 void object_finalize(void *data)
 334 {
 335     Object *obj = data;
 336     TypeImpl *ti = obj->class->type;
 337
 338     object_deinit(obj, ti);
 339     object_property_del_all(obj);
 340 }
 341
 342 Object *object_new_with_type(Type type)
 343 {
 344     Object *obj;
 345
 346     g_assert(type != NULL);
 347
 348     obj = g_malloc(type->instance_size);
 349     object_initialize_with_type(obj, type);
 350
 351     return obj;
 352 }
 353
 354 Object *object_new(const char *typename)
 355 {
 356     TypeImpl *ti = type_get_by_name(typename);
 357
 358     return object_new_with_type(ti);
 359 }
 360
 361 void object_delete(Object *obj)
 362 {
 363     object_finalize(obj);
 364     g_free(obj);
 365 }
 366
 367 static bool object_is_type(Object *obj, const char *typename)
 368 {
 369     TypeImpl *target_type = type_get_by_name(typename);
 370     TypeImpl *type = obj->class->type;
 371     GSList *i;
 372
 373     /* Check if typename is a direct ancestor of type */
 374     while (type) {
 375         if (type == target_type) {
 376             return true;
 377         }
 378
 379         type = type_get_parent(type);
 380     }
 381
 382     /* Check if obj has an interface of typename */
 383     for (i = obj->interfaces; i; i = i->next) {
 384         Interface *iface = i->data;
 385
 386         if (object_is_type(OBJECT(iface), typename)) {
 387             return true;
 388         }
 389     }
 390
 391     return false;
 392 }
 393
 394 Object *object_dynamic_cast(Object *obj, const char *typename)
 395 {
 396     GSList *i;
 397
 398     /* Check if typename is a direct ancestor */
 399     if (object_is_type(obj, typename)) {
 400         return obj;
 401     }
 402
 403     /* Check if obj has an interface of typename */
 404     for (i = obj->interfaces; i; i = i->next) {
 405         Interface *iface = i->data;
 406
 407         if (object_is_type(OBJECT(iface), typename)) {
 408             return OBJECT(iface);
 409         }
 410     }
 411
 412     /* Check if obj is an interface and its containing object is a direct
 413      * ancestor of typename */
 414     if (object_is_type(obj, TYPE_INTERFACE)) {
 415         Interface *iface = INTERFACE(obj);
 416
 417         if (object_is_type(iface->obj, typename)) {
 418             return iface->obj;
 419         }
 420     }
 421
 422     return NULL;
 423 }
 424
 425
 426 static void register_interface(void)
 427 {
 428     static TypeInfo interface_info = {
 429         .name = TYPE_INTERFACE,
 430         .instance_size = sizeof(Interface),
 431         .abstract = true,
 432     };
 433
 434     type_register_static(&interface_info);
 435 }
 436
 437 device_init(register_interface);
 438
 439 Object *object_dynamic_cast_assert(Object *obj, const char *typename)
 440 {
 441     Object *inst;
 442
 443     inst = object_dynamic_cast(obj, typename);
 444
 445     if (!inst) {
 446         fprintf(stderr, "Object %p is not an instance of type %s\n",
 447                 obj, typename);
 448         abort();
 449     }
 450
 451     return inst;
 452 }
 453
 454 ObjectClass *object_class_dynamic_cast(ObjectClass *class,
 455                                        const char *typename)
 456 {
 457     TypeImpl *target_type = type_get_by_name(typename);
 458     TypeImpl *type = class->type;
 459
 460     while (type) {
 461         if (type == target_type) {
 462             return class;
 463         }
 464
 465         type = type_get_parent(type);
 466     }
 467
 468     return NULL;
 469 }
 470
 471 ObjectClass *object_class_dynamic_cast_assert(ObjectClass *class,
 472                                               const char *typename)
 473 {
 474     ObjectClass *ret = object_class_dynamic_cast(class, typename);
 475
 476     if (!ret) {
 477         fprintf(stderr, "Object %p is not an instance of type %s\n",
 478                 class, typename);
 479         abort();
 480     }
 481
 482     return ret;
 483 }
 484
 485 const char *object_get_typename(Object *obj)
 486 {
 487     return obj->class->type->name;
 488 }
 489
 490 ObjectClass *object_get_class(Object *obj)
 491 {
 492     return obj->class;
 493 }
 494
 495 const char *object_class_get_name(ObjectClass *klass)
 496 {
 497     return klass->type->name;
 498 }
 499
 500 ObjectClass *object_class_by_name(const char *typename)
 501 {
 502     TypeImpl *type = type_get_by_name(typename);
 503
 504     if (!type) {
 505         return NULL;
 506     }
 507
 508     type_class_init(type);
 509
 510     return type->class;
 511 }
 512
 513 typedef struct OCFData
 514 {
 515     void (*fn)(ObjectClass *klass, void *opaque);
 516     const char *implements_type;
 517     bool include_abstract;
 518     void *opaque;
 519 } OCFData;
 520
 521 static void object_class_foreach_tramp(gpointer key, gpointer value,
 522                                        gpointer opaque)
 523 {
 524     OCFData *data = opaque;
 525     TypeImpl *type = value;
 526     ObjectClass *k;
 527
 528     type_class_init(type);
 529     k = type->class;
 530
 531     if (!data->include_abstract && type->abstract) {
 532         return;
 533     }
 534
 535     if (data->implements_type &&
 536         !object_class_dynamic_cast(k, data->implements_type)) {
 537         return;
 538     }
 539
 540     data->fn(k, data->opaque);
 541 }
 542
 543 void object_class_foreach(void (*fn)(ObjectClass *klass, void *opaque),
 544                           const char *implements_type, bool include_abstract,
 545                           void *opaque)
 546 {
 547     OCFData data = { fn, implements_type, include_abstract, opaque };
 548
 549     g_hash_table_foreach(type_table_get(), object_class_foreach_tramp, &data);
 550 }
 551
 552 void object_ref(Object *obj)
 553 {
 554     obj->ref++;
 555 }
 556
 557 void object_unref(Object *obj)
 558 {
 559     g_assert(obj->ref > 0);
 560     obj->ref--;
 561
 562     /* parent always holds a reference to its children */
 563     if (obj->ref == 0) {
 564         object_finalize(obj);
 565     }
 566 }
 567
 568 void object_property_add(Object *obj, const char *name, const char *type,
 569                          ObjectPropertyAccessor *get,
 570                          ObjectPropertyAccessor *set,
 571                          ObjectPropertyRelease *release,
 572                          void *opaque, Error **errp)
 573 {
 574     ObjectProperty *prop = g_malloc0(sizeof(*prop));
 575
 576     prop->name = g_strdup(name);
 577     prop->type = g_strdup(type);
 578
 579     prop->get = get;
 580     prop->set = set;
 581     prop->release = release;
 582     prop->opaque = opaque;
 583
 584     QTAILQ_INSERT_TAIL(&obj->properties, prop, node);
 585 }
 586
 587 static ObjectProperty *object_property_find(Object *obj, const char *name)
 588 {
 589     ObjectProperty *prop;
 590
 591     QTAILQ_FOREACH(prop, &obj->properties, node) {
 592         if (strcmp(prop->name, name) == 0) {
 593             return prop;
 594         }
 595     }
 596
 597     return NULL;
 598 }
 599
 600 void object_property_del(Object *obj, const char *name, Error **errp)
 601 {
 602     ObjectProperty *prop = object_property_find(obj, name);
 603
 604     QTAILQ_REMOVE(&obj->properties, prop, node);
 605
 606     prop->release(obj, prop->name, prop->opaque);
 607
 608     g_free(prop->name);
 609     g_free(prop->type);
 610     g_free(prop);
 611 }
 612
 613 void object_property_get(Object *obj, Visitor *v, const char *name,
 614                          Error **errp)
 615 {
 616     ObjectProperty *prop = object_property_find(obj, name);
 617
 618     if (prop == NULL) {
 619         error_set(errp, QERR_PROPERTY_NOT_FOUND, "", name);
 620         return;
 621     }
 622
 623     if (!prop->get) {
 624         error_set(errp, QERR_PERMISSION_DENIED);
 625     } else {
 626         prop->get(obj, v, prop->opaque, name, errp);
 627     }
 628 }
 629
 630 void object_property_set(Object *obj, Visitor *v, const char *name,
 631                          Error **errp)
 632 {
 633     ObjectProperty *prop = object_property_find(obj, name);
 634
 635     if (prop == NULL) {
 636         error_set(errp, QERR_PROPERTY_NOT_FOUND, "", name);
 637         return;
 638     }
 639
 640     if (!prop->set) {
 641         error_set(errp, QERR_PERMISSION_DENIED);
 642     } else {
 643         prop->set(obj, v, prop->opaque, name, errp);
 644     }
 645 }
 646
 647 const char *object_property_get_type(Object *obj, const char *name, Error **errp)
 648 {
 649     ObjectProperty *prop = object_property_find(obj, name);
 650
 651     if (prop == NULL) {
 652         error_set(errp, QERR_PROPERTY_NOT_FOUND, "", name);
 653         return NULL;
 654     }
 655
 656     return prop->type;
 657 }
 658
 659 Object *object_get_root(void)
 660 {
 661     static DeviceState *object_root;
 662
 663     if (!object_root) {
 664         object_root = qdev_create(NULL, "container");
 665         qdev_init_nofail(object_root);
 666     }
 667
 668     return OBJECT(object_root);
 669 }
 670
 671 static void object_get_child_property(Object *obj, Visitor *v, void *opaque,
 672                                       const char *name, Error **errp)
 673 {
 674     Object *child = opaque;
 675     gchar *path;
 676
 677     path = object_get_canonical_path(child);
 678     visit_type_str(v, &path, name, errp);
 679     g_free(path);
 680 }
 681
 682 void object_property_add_child(Object *obj, const char *name,
 683                                Object *child, Error **errp)
 684 {
 685     gchar *type;
 686
 687     type = g_strdup_printf("child<%s>", object_get_typename(OBJECT(child)));
 688
 689     object_property_add(obj, name, type, object_get_child_property,
 690                         NULL, NULL, child, errp);
 691
 692     object_ref(child);
 693     g_assert(child->parent == NULL);
 694     child->parent = obj;
 695
 696     g_free(type);
 697 }
 698
 699 static void object_get_link_property(Object *obj, Visitor *v, void *opaque,
 700                                      const char *name, Error **errp)
 701 {
 702     Object **child = opaque;
 703     gchar *path;
 704
 705     if (*child) {
 706         path = object_get_canonical_path(*child);
 707         visit_type_str(v, &path, name, errp);
 708         g_free(path);
 709     } else {
 710         path = (gchar *)"";
 711         visit_type_str(v, &path, name, errp);
 712     }
 713 }
 714
 715 static void object_set_link_property(Object *obj, Visitor *v, void *opaque,
 716                                      const char *name, Error **errp)
 717 {
 718     Object **child = opaque;
 719     bool ambiguous = false;
 720     const char *type;
 721     char *path;
 722
 723     type = object_property_get_type(obj, name, NULL);
 724
 725     visit_type_str(v, &path, name, errp);
 726
 727     if (*child) {
 728         object_unref(*child);
 729     }
 730
 731     if (strcmp(path, "") != 0) {
 732         Object *target;
 733
 734         target = object_resolve_path(path, &ambiguous);
 735         if (target) {
 736             gchar *target_type;
 737
 738             target_type = g_strdup(&type[5]);
 739             target_type[strlen(target_type) - 2] = 0;
 740
 741             if (object_dynamic_cast(target, target_type)) {
 742                 object_ref(target);
 743                 *child = target;
 744             } else {
 745                 error_set(errp, QERR_INVALID_PARAMETER_TYPE, name, type);
 746             }
 747
 748             g_free(target_type);
 749         } else {
 750             error_set(errp, QERR_DEVICE_NOT_FOUND, path);
 751         }
 752     } else {
 753         *child = NULL;
 754     }
 755
 756     g_free(path);
 757 }
 758
 759 void object_property_add_link(Object *obj, const char *name,
 760                               const char *type, Object **child,
 761                               Error **errp)
 762 {
 763     gchar *full_type;
 764
 765     full_type = g_strdup_printf("link<%s>", type);
 766
 767     object_property_add(obj, name, full_type,
 768                         object_get_link_property,
 769                         object_set_link_property,
 770                         NULL, child, errp);
 771
 772     g_free(full_type);
 773 }
 774
 775 gchar *object_get_canonical_path(Object *obj)
 776 {
 777     Object *root = object_get_root();
 778     char *newpath = NULL, *path = NULL;
 779
 780     while (obj != root) {
 781         ObjectProperty *prop = NULL;
 782
 783         g_assert(obj->parent != NULL);
 784
 785         QTAILQ_FOREACH(prop, &obj->parent->properties, node) {
 786             if (!strstart(prop->type, "child<", NULL)) {
 787                 continue;
 788             }
 789
 790             if (prop->opaque == obj) {
 791                 if (path) {
 792                     newpath = g_strdup_printf("%s/%s", prop->name, path);
 793                     g_free(path);
 794                     path = newpath;
 795                 } else {
 796                     path = g_strdup(prop->name);
 797                 }
 798                 break;
 799             }
 800         }
 801
 802         g_assert(prop != NULL);
 803
 804         obj = obj->parent;
 805     }
 806
 807     newpath = g_strdup_printf("/%s", path);
 808     g_free(path);
 809
 810     return newpath;
 811 }
 812
 813 static Object *object_resolve_abs_path(Object *parent,
 814                                           gchar **parts,
 815                                           int index)
 816 {
 817     ObjectProperty *prop;
 818     Object *child;
 819
 820     if (parts[index] == NULL) {
 821         return parent;
 822     }
 823
 824     if (strcmp(parts[index], "") == 0) {
 825         return object_resolve_abs_path(parent, parts, index + 1);
 826     }
 827
 828     prop = object_property_find(parent, parts[index]);
 829     if (prop == NULL) {
 830         return NULL;
 831     }
 832
 833     child = NULL;
 834     if (strstart(prop->type, "link<", NULL)) {
 835         Object **pchild = prop->opaque;
 836         if (*pchild) {
 837             child = *pchild;
 838         }
 839     } else if (strstart(prop->type, "child<", NULL)) {
 840         child = prop->opaque;
 841     }
 842
 843     if (!child) {
 844         return NULL;
 845     }
 846
 847     return object_resolve_abs_path(child, parts, index + 1);
 848 }
 849
 850 static Object *object_resolve_partial_path(Object *parent,
 851                                               gchar **parts,
 852                                               bool *ambiguous)
 853 {
 854     Object *obj;
 855     ObjectProperty *prop;
 856
 857     obj = object_resolve_abs_path(parent, parts, 0);
 858
 859     QTAILQ_FOREACH(prop, &parent->properties, node) {
 860         Object *found;
 861
 862         if (!strstart(prop->type, "child<", NULL)) {
 863             continue;
 864         }
 865
 866         found = object_resolve_partial_path(prop->opaque, parts, ambiguous);
 867         if (found) {
 868             if (obj) {
 869                 if (ambiguous) {
 870                     *ambiguous = true;
 871                 }
 872                 return NULL;
 873             }
 874             obj = found;
 875         }
 876
 877         if (ambiguous && *ambiguous) {
 878             return NULL;
 879         }
 880     }
 881
 882     return obj;
 883 }
 884
 885 Object *object_resolve_path(const char *path, bool *ambiguous)
 886 {
 887     bool partial_path = true;
 888     Object *obj;
 889     gchar **parts;
 890
 891     parts = g_strsplit(path, "/", 0);
 892     if (parts == NULL || parts[0] == NULL) {
 893         g_strfreev(parts);
 894         return object_get_root();
 895     }
 896
 897     if (strcmp(parts[0], "") == 0) {
 898         partial_path = false;
 899     }
 900
 901     if (partial_path) {
 902         if (ambiguous) {
 903             *ambiguous = false;
 904         }
 905         obj = object_resolve_partial_path(object_get_root(), parts, ambiguous);
 906     } else {
 907         obj = object_resolve_abs_path(object_get_root(), parts, 1);
 908     }
 909
 910     g_strfreev(parts);
 911
 912     return obj;
 913 }
 914
 915 typedef struct StringProperty
 916 {
 917     char *(*get)(Object *, Error **);
 918     void (*set)(Object *, const char *, Error **);
 919 } StringProperty;
 920
 921 static void object_property_get_str(Object *obj, Visitor *v, void *opaque,
 922                                     const char *name, Error **errp)
 923 {
 924     StringProperty *prop = opaque;
 925     char *value;
 926
 927     value = prop->get(obj, errp);
 928     if (value) {
 929         visit_type_str(v, &value, name, errp);
 930         g_free(value);
 931     }
 932 }
 933
 934 static void object_property_set_str(Object *obj, Visitor *v, void *opaque,
 935                                   const char *name, Error **errp)
 936 {
 937     StringProperty *prop = opaque;
 938     char *value;
 939     Error *local_err = NULL;
 940
 941     visit_type_str(v, &value, name, &local_err);
 942     if (local_err) {
 943         error_propagate(errp, local_err);
 944         return;
 945     }
 946
 947     prop->set(obj, value, errp);
 948     g_free(value);
 949 }
 950
 951 static void object_property_release_str(Object *obj, const char *name,
 952                                       void *opaque)
 953 {
 954     StringProperty *prop = opaque;
 955     g_free(prop);
 956 }
 957
 958 void object_property_add_str(Object *obj, const char *name,
 959                            char *(*get)(Object *, Error **),
 960                            void (*set)(Object *, const char *, Error **),
 961                            Error **errp)
 962 {
 963     StringProperty *prop = g_malloc0(sizeof(*prop));
 964
 965     prop->get = get;
 966     prop->set = set;
 967
 968     object_property_add(obj, name, "string",
 969                         get ? object_property_get_str : NULL,
 970                         set ? object_property_set_str : NULL,
 971                         object_property_release_str,
 972                         prop, errp);
 973 }