#include "qemu/osdep.h" #include "hw/qdev-properties.h" #include "qapi/error.h" #include "qapi/qapi-types-misc.h" #include "qapi/qmp/qerror.h" #include "qemu/ctype.h" #include "qemu/error-report.h" #include "qapi/visitor.h" #include "qemu/uuid.h" #include "qemu/units.h" #include "qemu/cutils.h" #include "qdev-prop-internal.h" void qdev_prop_set_after_realize(DeviceState *dev, const char *name, Error **errp) { if (dev->id) { error_setg(errp, "Attempt to set property '%s' on device '%s' " "(type '%s') after it was realized", name, dev->id, object_get_typename(OBJECT(dev))); } else { error_setg(errp, "Attempt to set property '%s' on anonymous device " "(type '%s') after it was realized", name, object_get_typename(OBJECT(dev))); } } void qdev_prop_allow_set_link_before_realize(const Object *obj, const char *name, Object *val, Error **errp) { DeviceState *dev = DEVICE(obj); if (dev->realized) { error_setg(errp, "Attempt to set link property '%s' on device '%s' " "(type '%s') after it was realized", name, dev->id, object_get_typename(obj)); } } void *qdev_get_prop_ptr(DeviceState *dev, Property *prop) { void *ptr = dev; ptr += prop->offset; return ptr; } void qdev_propinfo_get_enum(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; int *ptr = qdev_get_prop_ptr(dev, prop); visit_type_enum(v, prop->name, ptr, prop->info->enum_table, errp); } void qdev_propinfo_set_enum(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; int *ptr = qdev_get_prop_ptr(dev, prop); if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } visit_type_enum(v, prop->name, ptr, prop->info->enum_table, errp); } void qdev_propinfo_set_default_value_enum(ObjectProperty *op, const Property *prop) { object_property_set_default_str(op, qapi_enum_lookup(prop->info->enum_table, prop->defval.i)); } const PropertyInfo qdev_prop_enum = { .name = "enum", .get = qdev_propinfo_get_enum, .set = qdev_propinfo_set_enum, .set_default_value = qdev_propinfo_set_default_value_enum, }; /* Bit */ static uint32_t qdev_get_prop_mask(Property *prop) { assert(prop->info == &qdev_prop_bit); return 0x1 << prop->bitnr; } static void bit_prop_set(DeviceState *dev, Property *props, bool val) { uint32_t *p = qdev_get_prop_ptr(dev, props); uint32_t mask = qdev_get_prop_mask(props); if (val) { *p |= mask; } else { *p &= ~mask; } } static void prop_get_bit(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint32_t *p = qdev_get_prop_ptr(dev, prop); bool value = (*p & qdev_get_prop_mask(prop)) != 0; visit_type_bool(v, name, &value, errp); } static void prop_set_bit(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; bool value; if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } if (!visit_type_bool(v, name, &value, errp)) { return; } bit_prop_set(dev, prop, value); } static void set_default_value_bool(ObjectProperty *op, const Property *prop) { object_property_set_default_bool(op, prop->defval.u); } const PropertyInfo qdev_prop_bit = { .name = "bool", .description = "on/off", .get = prop_get_bit, .set = prop_set_bit, .set_default_value = set_default_value_bool, }; /* Bit64 */ static uint64_t qdev_get_prop_mask64(Property *prop) { assert(prop->info == &qdev_prop_bit64); return 0x1ull << prop->bitnr; } static void bit64_prop_set(DeviceState *dev, Property *props, bool val) { uint64_t *p = qdev_get_prop_ptr(dev, props); uint64_t mask = qdev_get_prop_mask64(props); if (val) { *p |= mask; } else { *p &= ~mask; } } static void prop_get_bit64(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint64_t *p = qdev_get_prop_ptr(dev, prop); bool value = (*p & qdev_get_prop_mask64(prop)) != 0; visit_type_bool(v, name, &value, errp); } static void prop_set_bit64(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; bool value; if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } if (!visit_type_bool(v, name, &value, errp)) { return; } bit64_prop_set(dev, prop, value); } const PropertyInfo qdev_prop_bit64 = { .name = "bool", .description = "on/off", .get = prop_get_bit64, .set = prop_set_bit64, .set_default_value = set_default_value_bool, }; /* --- bool --- */ static void get_bool(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; bool *ptr = qdev_get_prop_ptr(dev, prop); visit_type_bool(v, name, ptr, errp); } static void set_bool(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; bool *ptr = qdev_get_prop_ptr(dev, prop); if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } visit_type_bool(v, name, ptr, errp); } const PropertyInfo qdev_prop_bool = { .name = "bool", .get = get_bool, .set = set_bool, .set_default_value = set_default_value_bool, }; /* --- 8bit integer --- */ static void get_uint8(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint8_t *ptr = qdev_get_prop_ptr(dev, prop); visit_type_uint8(v, name, ptr, errp); } static void set_uint8(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint8_t *ptr = qdev_get_prop_ptr(dev, prop); if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } visit_type_uint8(v, name, ptr, errp); } void qdev_propinfo_set_default_value_int(ObjectProperty *op, const Property *prop) { object_property_set_default_int(op, prop->defval.i); } void qdev_propinfo_set_default_value_uint(ObjectProperty *op, const Property *prop) { object_property_set_default_uint(op, prop->defval.u); } const PropertyInfo qdev_prop_uint8 = { .name = "uint8", .get = get_uint8, .set = set_uint8, .set_default_value = qdev_propinfo_set_default_value_uint, }; /* --- 16bit integer --- */ void qdev_propinfo_get_uint16(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint16_t *ptr = qdev_get_prop_ptr(dev, prop); visit_type_uint16(v, name, ptr, errp); } static void set_uint16(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint16_t *ptr = qdev_get_prop_ptr(dev, prop); if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } visit_type_uint16(v, name, ptr, errp); } const PropertyInfo qdev_prop_uint16 = { .name = "uint16", .get = qdev_propinfo_get_uint16, .set = set_uint16, .set_default_value = qdev_propinfo_set_default_value_uint, }; /* --- 32bit integer --- */ static void get_uint32(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint32_t *ptr = qdev_get_prop_ptr(dev, prop); visit_type_uint32(v, name, ptr, errp); } static void set_uint32(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint32_t *ptr = qdev_get_prop_ptr(dev, prop); if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } visit_type_uint32(v, name, ptr, errp); } void qdev_propinfo_get_int32(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; int32_t *ptr = qdev_get_prop_ptr(dev, prop); visit_type_int32(v, name, ptr, errp); } static void set_int32(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; int32_t *ptr = qdev_get_prop_ptr(dev, prop); if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } visit_type_int32(v, name, ptr, errp); } const PropertyInfo qdev_prop_uint32 = { .name = "uint32", .get = get_uint32, .set = set_uint32, .set_default_value = qdev_propinfo_set_default_value_uint, }; const PropertyInfo qdev_prop_int32 = { .name = "int32", .get = qdev_propinfo_get_int32, .set = set_int32, .set_default_value = qdev_propinfo_set_default_value_int, }; /* --- 64bit integer --- */ static void get_uint64(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint64_t *ptr = qdev_get_prop_ptr(dev, prop); visit_type_uint64(v, name, ptr, errp); } static void set_uint64(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint64_t *ptr = qdev_get_prop_ptr(dev, prop); if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } visit_type_uint64(v, name, ptr, errp); } static void get_int64(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; int64_t *ptr = qdev_get_prop_ptr(dev, prop); visit_type_int64(v, name, ptr, errp); } static void set_int64(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; int64_t *ptr = qdev_get_prop_ptr(dev, prop); if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } visit_type_int64(v, name, ptr, errp); } const PropertyInfo qdev_prop_uint64 = { .name = "uint64", .get = get_uint64, .set = set_uint64, .set_default_value = qdev_propinfo_set_default_value_uint, }; const PropertyInfo qdev_prop_int64 = { .name = "int64", .get = get_int64, .set = set_int64, .set_default_value = qdev_propinfo_set_default_value_int, }; /* --- string --- */ static void release_string(Object *obj, const char *name, void *opaque) { Property *prop = opaque; g_free(*(char **)qdev_get_prop_ptr(DEVICE(obj), prop)); } static void get_string(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; char **ptr = qdev_get_prop_ptr(dev, prop); if (!*ptr) { char *str = (char *)""; visit_type_str(v, name, &str, errp); } else { visit_type_str(v, name, ptr, errp); } } static void set_string(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; char **ptr = qdev_get_prop_ptr(dev, prop); char *str; if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } if (!visit_type_str(v, name, &str, errp)) { return; } g_free(*ptr); *ptr = str; } const PropertyInfo qdev_prop_string = { .name = "str", .release = release_string, .get = get_string, .set = set_string, }; /* --- on/off/auto --- */ const PropertyInfo qdev_prop_on_off_auto = { .name = "OnOffAuto", .description = "on/off/auto", .enum_table = &OnOffAuto_lookup, .get = qdev_propinfo_get_enum, .set = qdev_propinfo_set_enum, .set_default_value = qdev_propinfo_set_default_value_enum, }; /* --- 32bit unsigned int 'size' type --- */ void qdev_propinfo_get_size32(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint32_t *ptr = qdev_get_prop_ptr(dev, prop); uint64_t value = *ptr; visit_type_size(v, name, &value, errp); } static void set_size32(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint32_t *ptr = qdev_get_prop_ptr(dev, prop); uint64_t value; if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } if (!visit_type_size(v, name, &value, errp)) { return; } if (value > UINT32_MAX) { error_setg(errp, "Property %s.%s doesn't take value %" PRIu64 " (maximum: %u)", dev->id ? : "", name, value, UINT32_MAX); return; } *ptr = value; } const PropertyInfo qdev_prop_size32 = { .name = "size", .get = qdev_propinfo_get_size32, .set = set_size32, .set_default_value = qdev_propinfo_set_default_value_uint, }; /* --- UUID --- */ static void get_uuid(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; QemuUUID *uuid = qdev_get_prop_ptr(dev, prop); char buffer[UUID_FMT_LEN + 1]; char *p = buffer; qemu_uuid_unparse(uuid, buffer); visit_type_str(v, name, &p, errp); } #define UUID_VALUE_AUTO "auto" static void set_uuid(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; QemuUUID *uuid = qdev_get_prop_ptr(dev, prop); char *str; if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } if (!visit_type_str(v, name, &str, errp)) { return; } if (!strcmp(str, UUID_VALUE_AUTO)) { qemu_uuid_generate(uuid); } else if (qemu_uuid_parse(str, uuid) < 0) { error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str); } g_free(str); } static void set_default_uuid_auto(ObjectProperty *op, const Property *prop) { object_property_set_default_str(op, UUID_VALUE_AUTO); } const PropertyInfo qdev_prop_uuid = { .name = "str", .description = "UUID (aka GUID) or \"" UUID_VALUE_AUTO "\" for random value (default)", .get = get_uuid, .set = set_uuid, .set_default_value = set_default_uuid_auto, }; /* --- support for array properties --- */ /* Used as an opaque for the object properties we add for each * array element. Note that the struct Property must be first * in the struct so that a pointer to this works as the opaque * for the underlying element's property hooks as well as for * our own release callback. */ typedef struct { struct Property prop; char *propname; ObjectPropertyRelease *release; } ArrayElementProperty; /* object property release callback for array element properties: * we call the underlying element's property release hook, and * then free the memory we allocated when we added the property. */ static void array_element_release(Object *obj, const char *name, void *opaque) { ArrayElementProperty *p = opaque; if (p->release) { p->release(obj, name, opaque); } g_free(p->propname); g_free(p); } static void set_prop_arraylen(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { /* Setter for the property which defines the length of a * variable-sized property array. As well as actually setting the * array-length field in the device struct, we have to create the * array itself and dynamically add the corresponding properties. */ DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint32_t *alenptr = qdev_get_prop_ptr(dev, prop); void **arrayptr = (void *)dev + prop->arrayoffset; void *eltptr; const char *arrayname; int i; if (dev->realized) { qdev_prop_set_after_realize(dev, name, errp); return; } if (*alenptr) { error_setg(errp, "array size property %s may not be set more than once", name); return; } if (!visit_type_uint32(v, name, alenptr, errp)) { return; } if (!*alenptr) { return; } /* DEFINE_PROP_ARRAY guarantees that name should start with this prefix; * strip it off so we can get the name of the array itself. */ assert(strncmp(name, PROP_ARRAY_LEN_PREFIX, strlen(PROP_ARRAY_LEN_PREFIX)) == 0); arrayname = name + strlen(PROP_ARRAY_LEN_PREFIX); /* Note that it is the responsibility of the individual device's deinit * to free the array proper. */ *arrayptr = eltptr = g_malloc0(*alenptr * prop->arrayfieldsize); for (i = 0; i < *alenptr; i++, eltptr += prop->arrayfieldsize) { char *propname = g_strdup_printf("%s[%d]", arrayname, i); ArrayElementProperty *arrayprop = g_new0(ArrayElementProperty, 1); arrayprop->release = prop->arrayinfo->release; arrayprop->propname = propname; arrayprop->prop.info = prop->arrayinfo; arrayprop->prop.name = propname; /* This ugly piece of pointer arithmetic sets up the offset so * that when the underlying get/set hooks call qdev_get_prop_ptr * they get the right answer despite the array element not actually * being inside the device struct. */ arrayprop->prop.offset = eltptr - (void *)dev; assert(qdev_get_prop_ptr(dev, &arrayprop->prop) == eltptr); object_property_add(obj, propname, arrayprop->prop.info->name, arrayprop->prop.info->get, arrayprop->prop.info->set, array_element_release, arrayprop); } } const PropertyInfo qdev_prop_arraylen = { .name = "uint32", .get = get_uint32, .set = set_prop_arraylen, .set_default_value = qdev_propinfo_set_default_value_uint, }; /* --- public helpers --- */ static Property *qdev_prop_walk(Property *props, const char *name) { if (!props) { return NULL; } while (props->name) { if (strcmp(props->name, name) == 0) { return props; } props++; } return NULL; } static Property *qdev_prop_find(DeviceState *dev, const char *name) { ObjectClass *class; Property *prop; /* device properties */ class = object_get_class(OBJECT(dev)); do { prop = qdev_prop_walk(DEVICE_CLASS(class)->props_, name); if (prop) { return prop; } class = object_class_get_parent(class); } while (class != object_class_by_name(TYPE_DEVICE)); return NULL; } void error_set_from_qdev_prop_error(Error **errp, int ret, DeviceState *dev, Property *prop, const char *value) { switch (ret) { case -EEXIST: error_setg(errp, "Property '%s.%s' can't take value '%s', it's in use", object_get_typename(OBJECT(dev)), prop->name, value); break; default: case -EINVAL: error_setg(errp, QERR_PROPERTY_VALUE_BAD, object_get_typename(OBJECT(dev)), prop->name, value); break; case -ENOENT: error_setg(errp, "Property '%s.%s' can't find value '%s'", object_get_typename(OBJECT(dev)), prop->name, value); break; case 0: break; } } void qdev_prop_set_bit(DeviceState *dev, const char *name, bool value) { object_property_set_bool(OBJECT(dev), name, value, &error_abort); } void qdev_prop_set_uint8(DeviceState *dev, const char *name, uint8_t value) { object_property_set_int(OBJECT(dev), name, value, &error_abort); } void qdev_prop_set_uint16(DeviceState *dev, const char *name, uint16_t value) { object_property_set_int(OBJECT(dev), name, value, &error_abort); } void qdev_prop_set_uint32(DeviceState *dev, const char *name, uint32_t value) { object_property_set_int(OBJECT(dev), name, value, &error_abort); } void qdev_prop_set_int32(DeviceState *dev, const char *name, int32_t value) { object_property_set_int(OBJECT(dev), name, value, &error_abort); } void qdev_prop_set_uint64(DeviceState *dev, const char *name, uint64_t value) { object_property_set_int(OBJECT(dev), name, value, &error_abort); } void qdev_prop_set_string(DeviceState *dev, const char *name, const char *value) { object_property_set_str(OBJECT(dev), name, value, &error_abort); } void qdev_prop_set_enum(DeviceState *dev, const char *name, int value) { Property *prop; prop = qdev_prop_find(dev, name); object_property_set_str(OBJECT(dev), name, qapi_enum_lookup(prop->info->enum_table, value), &error_abort); } static GPtrArray *global_props(void) { static GPtrArray *gp; if (!gp) { gp = g_ptr_array_new(); } return gp; } void qdev_prop_register_global(GlobalProperty *prop) { g_ptr_array_add(global_props(), prop); } const GlobalProperty *qdev_find_global_prop(DeviceState *dev, const char *name) { GPtrArray *props = global_props(); const GlobalProperty *p; int i; for (i = 0; i < props->len; i++) { p = g_ptr_array_index(props, i); if (object_dynamic_cast(OBJECT(dev), p->driver) && !strcmp(p->property, name)) { return p; } } return NULL; } int qdev_prop_check_globals(void) { int i, ret = 0; for (i = 0; i < global_props()->len; i++) { GlobalProperty *prop; ObjectClass *oc; DeviceClass *dc; prop = g_ptr_array_index(global_props(), i); if (prop->used) { continue; } oc = object_class_by_name(prop->driver); oc = object_class_dynamic_cast(oc, TYPE_DEVICE); if (!oc) { warn_report("global %s.%s has invalid class name", prop->driver, prop->property); ret = 1; continue; } dc = DEVICE_CLASS(oc); if (!dc->hotpluggable && !prop->used) { warn_report("global %s.%s=%s not used", prop->driver, prop->property, prop->value); ret = 1; continue; } } return ret; } void qdev_prop_set_globals(DeviceState *dev) { object_apply_global_props(OBJECT(dev), global_props(), dev->hotplugged ? NULL : &error_fatal); } /* --- 64bit unsigned int 'size' type --- */ static void get_size(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint64_t *ptr = qdev_get_prop_ptr(dev, prop); visit_type_size(v, name, ptr, errp); } static void set_size(Object *obj, Visitor *v, const char *name, void *opaque, Error **errp) { DeviceState *dev = DEVICE(obj); Property *prop = opaque; uint64_t *ptr = qdev_get_prop_ptr(dev, prop); visit_type_size(v, name, ptr, errp); } const PropertyInfo qdev_prop_size = { .name = "size", .get = get_size, .set = set_size, .set_default_value = qdev_propinfo_set_default_value_uint, }; /* --- object link property --- */ static void create_link_property(ObjectClass *oc, Property *prop) { object_class_property_add_link(oc, prop->name, prop->link_type, prop->offset, qdev_prop_allow_set_link_before_realize, OBJ_PROP_LINK_STRONG); } const PropertyInfo qdev_prop_link = { .name = "link", .create = create_link_property, };