qerror: Clean up QERR_ macros to expand into a single string
[qemu.git] / hw / core / qdev-properties.c
blobbb8345cb76553c06003ab97cde009fdf769e293c
1 #include "net/net.h"
2 #include "hw/qdev.h"
3 #include "qapi/qmp/qerror.h"
4 #include "sysemu/block-backend.h"
5 #include "hw/block/block.h"
6 #include "net/hub.h"
7 #include "qapi/visitor.h"
8 #include "sysemu/char.h"
10 void qdev_prop_set_after_realize(DeviceState *dev, const char *name,
11 Error **errp)
13 if (dev->id) {
14 error_setg(errp, "Attempt to set property '%s' on device '%s' "
15 "(type '%s') after it was realized", name, dev->id,
16 object_get_typename(OBJECT(dev)));
17 } else {
18 error_setg(errp, "Attempt to set property '%s' on anonymous device "
19 "(type '%s') after it was realized", name,
20 object_get_typename(OBJECT(dev)));
24 void qdev_prop_allow_set_link_before_realize(Object *obj, const char *name,
25 Object *val, Error **errp)
27 DeviceState *dev = DEVICE(obj);
29 if (dev->realized) {
30 error_setg(errp, "Attempt to set link property '%s' on device '%s' "
31 "(type '%s') after it was realized",
32 name, dev->id, object_get_typename(obj));
36 void *qdev_get_prop_ptr(DeviceState *dev, Property *prop)
38 void *ptr = dev;
39 ptr += prop->offset;
40 return ptr;
43 static void get_enum(Object *obj, Visitor *v, void *opaque,
44 const char *name, Error **errp)
46 DeviceState *dev = DEVICE(obj);
47 Property *prop = opaque;
48 int *ptr = qdev_get_prop_ptr(dev, prop);
50 visit_type_enum(v, ptr, prop->info->enum_table,
51 prop->info->name, prop->name, errp);
54 static void set_enum(Object *obj, Visitor *v, void *opaque,
55 const char *name, Error **errp)
57 DeviceState *dev = DEVICE(obj);
58 Property *prop = opaque;
59 int *ptr = qdev_get_prop_ptr(dev, prop);
61 if (dev->realized) {
62 qdev_prop_set_after_realize(dev, name, errp);
63 return;
66 visit_type_enum(v, ptr, prop->info->enum_table,
67 prop->info->name, prop->name, errp);
70 /* Bit */
72 static uint32_t qdev_get_prop_mask(Property *prop)
74 assert(prop->info == &qdev_prop_bit);
75 return 0x1 << prop->bitnr;
78 static void bit_prop_set(DeviceState *dev, Property *props, bool val)
80 uint32_t *p = qdev_get_prop_ptr(dev, props);
81 uint32_t mask = qdev_get_prop_mask(props);
82 if (val) {
83 *p |= mask;
84 } else {
85 *p &= ~mask;
89 static void prop_get_bit(Object *obj, Visitor *v, void *opaque,
90 const char *name, Error **errp)
92 DeviceState *dev = DEVICE(obj);
93 Property *prop = opaque;
94 uint32_t *p = qdev_get_prop_ptr(dev, prop);
95 bool value = (*p & qdev_get_prop_mask(prop)) != 0;
97 visit_type_bool(v, &value, name, errp);
100 static void prop_set_bit(Object *obj, Visitor *v, void *opaque,
101 const char *name, Error **errp)
103 DeviceState *dev = DEVICE(obj);
104 Property *prop = opaque;
105 Error *local_err = NULL;
106 bool value;
108 if (dev->realized) {
109 qdev_prop_set_after_realize(dev, name, errp);
110 return;
113 visit_type_bool(v, &value, name, &local_err);
114 if (local_err) {
115 error_propagate(errp, local_err);
116 return;
118 bit_prop_set(dev, prop, value);
121 PropertyInfo qdev_prop_bit = {
122 .name = "bool",
123 .description = "on/off",
124 .get = prop_get_bit,
125 .set = prop_set_bit,
128 /* Bit64 */
130 static uint64_t qdev_get_prop_mask64(Property *prop)
132 assert(prop->info == &qdev_prop_bit);
133 return 0x1 << prop->bitnr;
136 static void bit64_prop_set(DeviceState *dev, Property *props, bool val)
138 uint64_t *p = qdev_get_prop_ptr(dev, props);
139 uint64_t mask = qdev_get_prop_mask64(props);
140 if (val) {
141 *p |= mask;
142 } else {
143 *p &= ~mask;
147 static void prop_get_bit64(Object *obj, Visitor *v, void *opaque,
148 const char *name, Error **errp)
150 DeviceState *dev = DEVICE(obj);
151 Property *prop = opaque;
152 uint64_t *p = qdev_get_prop_ptr(dev, prop);
153 bool value = (*p & qdev_get_prop_mask64(prop)) != 0;
155 visit_type_bool(v, &value, name, errp);
158 static void prop_set_bit64(Object *obj, Visitor *v, void *opaque,
159 const char *name, Error **errp)
161 DeviceState *dev = DEVICE(obj);
162 Property *prop = opaque;
163 Error *local_err = NULL;
164 bool value;
166 if (dev->realized) {
167 qdev_prop_set_after_realize(dev, name, errp);
168 return;
171 visit_type_bool(v, &value, name, &local_err);
172 if (local_err) {
173 error_propagate(errp, local_err);
174 return;
176 bit64_prop_set(dev, prop, value);
179 PropertyInfo qdev_prop_bit64 = {
180 .name = "bool",
181 .description = "on/off",
182 .get = prop_get_bit64,
183 .set = prop_set_bit64,
186 /* --- bool --- */
188 static void get_bool(Object *obj, Visitor *v, void *opaque,
189 const char *name, Error **errp)
191 DeviceState *dev = DEVICE(obj);
192 Property *prop = opaque;
193 bool *ptr = qdev_get_prop_ptr(dev, prop);
195 visit_type_bool(v, ptr, name, errp);
198 static void set_bool(Object *obj, Visitor *v, void *opaque,
199 const char *name, Error **errp)
201 DeviceState *dev = DEVICE(obj);
202 Property *prop = opaque;
203 bool *ptr = qdev_get_prop_ptr(dev, prop);
205 if (dev->realized) {
206 qdev_prop_set_after_realize(dev, name, errp);
207 return;
210 visit_type_bool(v, ptr, name, errp);
213 PropertyInfo qdev_prop_bool = {
214 .name = "bool",
215 .get = get_bool,
216 .set = set_bool,
219 /* --- 8bit integer --- */
221 static void get_uint8(Object *obj, Visitor *v, void *opaque,
222 const char *name, Error **errp)
224 DeviceState *dev = DEVICE(obj);
225 Property *prop = opaque;
226 uint8_t *ptr = qdev_get_prop_ptr(dev, prop);
228 visit_type_uint8(v, ptr, name, errp);
231 static void set_uint8(Object *obj, Visitor *v, void *opaque,
232 const char *name, Error **errp)
234 DeviceState *dev = DEVICE(obj);
235 Property *prop = opaque;
236 uint8_t *ptr = qdev_get_prop_ptr(dev, prop);
238 if (dev->realized) {
239 qdev_prop_set_after_realize(dev, name, errp);
240 return;
243 visit_type_uint8(v, ptr, name, errp);
246 PropertyInfo qdev_prop_uint8 = {
247 .name = "uint8",
248 .get = get_uint8,
249 .set = set_uint8,
252 /* --- 16bit integer --- */
254 static void get_uint16(Object *obj, Visitor *v, void *opaque,
255 const char *name, Error **errp)
257 DeviceState *dev = DEVICE(obj);
258 Property *prop = opaque;
259 uint16_t *ptr = qdev_get_prop_ptr(dev, prop);
261 visit_type_uint16(v, ptr, name, errp);
264 static void set_uint16(Object *obj, Visitor *v, void *opaque,
265 const char *name, Error **errp)
267 DeviceState *dev = DEVICE(obj);
268 Property *prop = opaque;
269 uint16_t *ptr = qdev_get_prop_ptr(dev, prop);
271 if (dev->realized) {
272 qdev_prop_set_after_realize(dev, name, errp);
273 return;
276 visit_type_uint16(v, ptr, name, errp);
279 PropertyInfo qdev_prop_uint16 = {
280 .name = "uint16",
281 .get = get_uint16,
282 .set = set_uint16,
285 /* --- 32bit integer --- */
287 static void get_uint32(Object *obj, Visitor *v, void *opaque,
288 const char *name, Error **errp)
290 DeviceState *dev = DEVICE(obj);
291 Property *prop = opaque;
292 uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
294 visit_type_uint32(v, ptr, name, errp);
297 static void set_uint32(Object *obj, Visitor *v, void *opaque,
298 const char *name, Error **errp)
300 DeviceState *dev = DEVICE(obj);
301 Property *prop = opaque;
302 uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
304 if (dev->realized) {
305 qdev_prop_set_after_realize(dev, name, errp);
306 return;
309 visit_type_uint32(v, ptr, name, errp);
312 static void get_int32(Object *obj, Visitor *v, void *opaque,
313 const char *name, Error **errp)
315 DeviceState *dev = DEVICE(obj);
316 Property *prop = opaque;
317 int32_t *ptr = qdev_get_prop_ptr(dev, prop);
319 visit_type_int32(v, ptr, name, errp);
322 static void set_int32(Object *obj, Visitor *v, void *opaque,
323 const char *name, Error **errp)
325 DeviceState *dev = DEVICE(obj);
326 Property *prop = opaque;
327 int32_t *ptr = qdev_get_prop_ptr(dev, prop);
329 if (dev->realized) {
330 qdev_prop_set_after_realize(dev, name, errp);
331 return;
334 visit_type_int32(v, ptr, name, errp);
337 PropertyInfo qdev_prop_uint32 = {
338 .name = "uint32",
339 .get = get_uint32,
340 .set = set_uint32,
343 PropertyInfo qdev_prop_int32 = {
344 .name = "int32",
345 .get = get_int32,
346 .set = set_int32,
349 /* --- 64bit integer --- */
351 static void get_uint64(Object *obj, Visitor *v, void *opaque,
352 const char *name, Error **errp)
354 DeviceState *dev = DEVICE(obj);
355 Property *prop = opaque;
356 uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
358 visit_type_uint64(v, ptr, name, errp);
361 static void set_uint64(Object *obj, Visitor *v, void *opaque,
362 const char *name, Error **errp)
364 DeviceState *dev = DEVICE(obj);
365 Property *prop = opaque;
366 uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
368 if (dev->realized) {
369 qdev_prop_set_after_realize(dev, name, errp);
370 return;
373 visit_type_uint64(v, ptr, name, errp);
376 PropertyInfo qdev_prop_uint64 = {
377 .name = "uint64",
378 .get = get_uint64,
379 .set = set_uint64,
382 /* --- string --- */
384 static void release_string(Object *obj, const char *name, void *opaque)
386 Property *prop = opaque;
387 g_free(*(char **)qdev_get_prop_ptr(DEVICE(obj), prop));
390 static void get_string(Object *obj, Visitor *v, void *opaque,
391 const char *name, Error **errp)
393 DeviceState *dev = DEVICE(obj);
394 Property *prop = opaque;
395 char **ptr = qdev_get_prop_ptr(dev, prop);
397 if (!*ptr) {
398 char *str = (char *)"";
399 visit_type_str(v, &str, name, errp);
400 } else {
401 visit_type_str(v, ptr, name, errp);
405 static void set_string(Object *obj, Visitor *v, void *opaque,
406 const char *name, Error **errp)
408 DeviceState *dev = DEVICE(obj);
409 Property *prop = opaque;
410 char **ptr = qdev_get_prop_ptr(dev, prop);
411 Error *local_err = NULL;
412 char *str;
414 if (dev->realized) {
415 qdev_prop_set_after_realize(dev, name, errp);
416 return;
419 visit_type_str(v, &str, name, &local_err);
420 if (local_err) {
421 error_propagate(errp, local_err);
422 return;
424 if (*ptr) {
425 g_free(*ptr);
427 *ptr = str;
430 PropertyInfo qdev_prop_string = {
431 .name = "str",
432 .release = release_string,
433 .get = get_string,
434 .set = set_string,
437 /* --- pointer --- */
439 /* Not a proper property, just for dirty hacks. TODO Remove it! */
440 PropertyInfo qdev_prop_ptr = {
441 .name = "ptr",
444 /* --- mac address --- */
447 * accepted syntax versions:
448 * 01:02:03:04:05:06
449 * 01-02-03-04-05-06
451 static void get_mac(Object *obj, Visitor *v, void *opaque,
452 const char *name, Error **errp)
454 DeviceState *dev = DEVICE(obj);
455 Property *prop = opaque;
456 MACAddr *mac = qdev_get_prop_ptr(dev, prop);
457 char buffer[2 * 6 + 5 + 1];
458 char *p = buffer;
460 snprintf(buffer, sizeof(buffer), "%02x:%02x:%02x:%02x:%02x:%02x",
461 mac->a[0], mac->a[1], mac->a[2],
462 mac->a[3], mac->a[4], mac->a[5]);
464 visit_type_str(v, &p, name, errp);
467 static void set_mac(Object *obj, Visitor *v, void *opaque,
468 const char *name, Error **errp)
470 DeviceState *dev = DEVICE(obj);
471 Property *prop = opaque;
472 MACAddr *mac = qdev_get_prop_ptr(dev, prop);
473 Error *local_err = NULL;
474 int i, pos;
475 char *str, *p;
477 if (dev->realized) {
478 qdev_prop_set_after_realize(dev, name, errp);
479 return;
482 visit_type_str(v, &str, name, &local_err);
483 if (local_err) {
484 error_propagate(errp, local_err);
485 return;
488 for (i = 0, pos = 0; i < 6; i++, pos += 3) {
489 if (!qemu_isxdigit(str[pos])) {
490 goto inval;
492 if (!qemu_isxdigit(str[pos+1])) {
493 goto inval;
495 if (i == 5) {
496 if (str[pos+2] != '\0') {
497 goto inval;
499 } else {
500 if (str[pos+2] != ':' && str[pos+2] != '-') {
501 goto inval;
504 mac->a[i] = strtol(str+pos, &p, 16);
506 g_free(str);
507 return;
509 inval:
510 error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
511 g_free(str);
514 PropertyInfo qdev_prop_macaddr = {
515 .name = "str",
516 .description = "Ethernet 6-byte MAC Address, example: 52:54:00:12:34:56",
517 .get = get_mac,
518 .set = set_mac,
521 /* --- lost tick policy --- */
523 QEMU_BUILD_BUG_ON(sizeof(LostTickPolicy) != sizeof(int));
525 PropertyInfo qdev_prop_losttickpolicy = {
526 .name = "LostTickPolicy",
527 .enum_table = LostTickPolicy_lookup,
528 .get = get_enum,
529 .set = set_enum,
532 /* --- BIOS CHS translation */
534 QEMU_BUILD_BUG_ON(sizeof(BiosAtaTranslation) != sizeof(int));
536 PropertyInfo qdev_prop_bios_chs_trans = {
537 .name = "BiosAtaTranslation",
538 .description = "Logical CHS translation algorithm, "
539 "auto/none/lba/large/rechs",
540 .enum_table = BiosAtaTranslation_lookup,
541 .get = get_enum,
542 .set = set_enum,
545 /* --- pci address --- */
548 * bus-local address, i.e. "$slot" or "$slot.$fn"
550 static void set_pci_devfn(Object *obj, Visitor *v, void *opaque,
551 const char *name, Error **errp)
553 DeviceState *dev = DEVICE(obj);
554 Property *prop = opaque;
555 int32_t value, *ptr = qdev_get_prop_ptr(dev, prop);
556 unsigned int slot, fn, n;
557 Error *local_err = NULL;
558 char *str;
560 if (dev->realized) {
561 qdev_prop_set_after_realize(dev, name, errp);
562 return;
565 visit_type_str(v, &str, name, &local_err);
566 if (local_err) {
567 error_free(local_err);
568 local_err = NULL;
569 visit_type_int32(v, &value, name, &local_err);
570 if (local_err) {
571 error_propagate(errp, local_err);
572 } else if (value < -1 || value > 255) {
573 error_setg(errp, QERR_INVALID_PARAMETER_VALUE,
574 name ? name : "null", "pci_devfn");
575 } else {
576 *ptr = value;
578 return;
581 if (sscanf(str, "%x.%x%n", &slot, &fn, &n) != 2) {
582 fn = 0;
583 if (sscanf(str, "%x%n", &slot, &n) != 1) {
584 goto invalid;
587 if (str[n] != '\0' || fn > 7 || slot > 31) {
588 goto invalid;
590 *ptr = slot << 3 | fn;
591 g_free(str);
592 return;
594 invalid:
595 error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
596 g_free(str);
599 static int print_pci_devfn(DeviceState *dev, Property *prop, char *dest,
600 size_t len)
602 int32_t *ptr = qdev_get_prop_ptr(dev, prop);
604 if (*ptr == -1) {
605 return snprintf(dest, len, "<unset>");
606 } else {
607 return snprintf(dest, len, "%02x.%x", *ptr >> 3, *ptr & 7);
611 PropertyInfo qdev_prop_pci_devfn = {
612 .name = "int32",
613 .description = "Slot and optional function number, example: 06.0 or 06",
614 .print = print_pci_devfn,
615 .get = get_int32,
616 .set = set_pci_devfn,
619 /* --- blocksize --- */
621 static void set_blocksize(Object *obj, Visitor *v, void *opaque,
622 const char *name, Error **errp)
624 DeviceState *dev = DEVICE(obj);
625 Property *prop = opaque;
626 uint16_t value, *ptr = qdev_get_prop_ptr(dev, prop);
627 Error *local_err = NULL;
628 const int64_t min = 512;
629 const int64_t max = 32768;
631 if (dev->realized) {
632 qdev_prop_set_after_realize(dev, name, errp);
633 return;
636 visit_type_uint16(v, &value, name, &local_err);
637 if (local_err) {
638 error_propagate(errp, local_err);
639 return;
641 /* value of 0 means "unset" */
642 if (value && (value < min || value > max)) {
643 error_setg(errp, QERR_PROPERTY_VALUE_OUT_OF_RANGE,
644 dev->id ? : "", name, (int64_t)value, min, max);
645 return;
648 /* We rely on power-of-2 blocksizes for bitmasks */
649 if ((value & (value - 1)) != 0) {
650 error_setg(errp,
651 "Property %s.%s doesn't take value '%" PRId64 "', it's not a power of 2",
652 dev->id ?: "", name, (int64_t)value);
653 return;
656 *ptr = value;
659 PropertyInfo qdev_prop_blocksize = {
660 .name = "uint16",
661 .description = "A power of two between 512 and 32768",
662 .get = get_uint16,
663 .set = set_blocksize,
666 /* --- pci host address --- */
668 static void get_pci_host_devaddr(Object *obj, Visitor *v, void *opaque,
669 const char *name, Error **errp)
671 DeviceState *dev = DEVICE(obj);
672 Property *prop = opaque;
673 PCIHostDeviceAddress *addr = qdev_get_prop_ptr(dev, prop);
674 char buffer[] = "xxxx:xx:xx.x";
675 char *p = buffer;
676 int rc = 0;
678 rc = snprintf(buffer, sizeof(buffer), "%04x:%02x:%02x.%d",
679 addr->domain, addr->bus, addr->slot, addr->function);
680 assert(rc == sizeof(buffer) - 1);
682 visit_type_str(v, &p, name, errp);
686 * Parse [<domain>:]<bus>:<slot>.<func>
687 * if <domain> is not supplied, it's assumed to be 0.
689 static void set_pci_host_devaddr(Object *obj, Visitor *v, void *opaque,
690 const char *name, Error **errp)
692 DeviceState *dev = DEVICE(obj);
693 Property *prop = opaque;
694 PCIHostDeviceAddress *addr = qdev_get_prop_ptr(dev, prop);
695 Error *local_err = NULL;
696 char *str, *p;
697 char *e;
698 unsigned long val;
699 unsigned long dom = 0, bus = 0;
700 unsigned int slot = 0, func = 0;
702 if (dev->realized) {
703 qdev_prop_set_after_realize(dev, name, errp);
704 return;
707 visit_type_str(v, &str, name, &local_err);
708 if (local_err) {
709 error_propagate(errp, local_err);
710 return;
713 p = str;
714 val = strtoul(p, &e, 16);
715 if (e == p || *e != ':') {
716 goto inval;
718 bus = val;
720 p = e + 1;
721 val = strtoul(p, &e, 16);
722 if (e == p) {
723 goto inval;
725 if (*e == ':') {
726 dom = bus;
727 bus = val;
728 p = e + 1;
729 val = strtoul(p, &e, 16);
730 if (e == p) {
731 goto inval;
734 slot = val;
736 if (*e != '.') {
737 goto inval;
739 p = e + 1;
740 val = strtoul(p, &e, 10);
741 if (e == p) {
742 goto inval;
744 func = val;
746 if (dom > 0xffff || bus > 0xff || slot > 0x1f || func > 7) {
747 goto inval;
750 if (*e) {
751 goto inval;
754 addr->domain = dom;
755 addr->bus = bus;
756 addr->slot = slot;
757 addr->function = func;
759 g_free(str);
760 return;
762 inval:
763 error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
764 g_free(str);
767 PropertyInfo qdev_prop_pci_host_devaddr = {
768 .name = "str",
769 .description = "Address (bus/device/function) of "
770 "the host device, example: 04:10.0",
771 .get = get_pci_host_devaddr,
772 .set = set_pci_host_devaddr,
775 /* --- support for array properties --- */
777 /* Used as an opaque for the object properties we add for each
778 * array element. Note that the struct Property must be first
779 * in the struct so that a pointer to this works as the opaque
780 * for the underlying element's property hooks as well as for
781 * our own release callback.
783 typedef struct {
784 struct Property prop;
785 char *propname;
786 ObjectPropertyRelease *release;
787 } ArrayElementProperty;
789 /* object property release callback for array element properties:
790 * we call the underlying element's property release hook, and
791 * then free the memory we allocated when we added the property.
793 static void array_element_release(Object *obj, const char *name, void *opaque)
795 ArrayElementProperty *p = opaque;
796 if (p->release) {
797 p->release(obj, name, opaque);
799 g_free(p->propname);
800 g_free(p);
803 static void set_prop_arraylen(Object *obj, Visitor *v, void *opaque,
804 const char *name, Error **errp)
806 /* Setter for the property which defines the length of a
807 * variable-sized property array. As well as actually setting the
808 * array-length field in the device struct, we have to create the
809 * array itself and dynamically add the corresponding properties.
811 DeviceState *dev = DEVICE(obj);
812 Property *prop = opaque;
813 uint32_t *alenptr = qdev_get_prop_ptr(dev, prop);
814 void **arrayptr = (void *)dev + prop->arrayoffset;
815 Error *local_err = NULL;
816 void *eltptr;
817 const char *arrayname;
818 int i;
820 if (dev->realized) {
821 qdev_prop_set_after_realize(dev, name, errp);
822 return;
824 if (*alenptr) {
825 error_setg(errp, "array size property %s may not be set more than once",
826 name);
827 return;
829 visit_type_uint32(v, alenptr, name, &local_err);
830 if (local_err) {
831 error_propagate(errp, local_err);
832 return;
834 if (!*alenptr) {
835 return;
838 /* DEFINE_PROP_ARRAY guarantees that name should start with this prefix;
839 * strip it off so we can get the name of the array itself.
841 assert(strncmp(name, PROP_ARRAY_LEN_PREFIX,
842 strlen(PROP_ARRAY_LEN_PREFIX)) == 0);
843 arrayname = name + strlen(PROP_ARRAY_LEN_PREFIX);
845 /* Note that it is the responsibility of the individual device's deinit
846 * to free the array proper.
848 *arrayptr = eltptr = g_malloc0(*alenptr * prop->arrayfieldsize);
849 for (i = 0; i < *alenptr; i++, eltptr += prop->arrayfieldsize) {
850 char *propname = g_strdup_printf("%s[%d]", arrayname, i);
851 ArrayElementProperty *arrayprop = g_new0(ArrayElementProperty, 1);
852 arrayprop->release = prop->arrayinfo->release;
853 arrayprop->propname = propname;
854 arrayprop->prop.info = prop->arrayinfo;
855 arrayprop->prop.name = propname;
856 /* This ugly piece of pointer arithmetic sets up the offset so
857 * that when the underlying get/set hooks call qdev_get_prop_ptr
858 * they get the right answer despite the array element not actually
859 * being inside the device struct.
861 arrayprop->prop.offset = eltptr - (void *)dev;
862 assert(qdev_get_prop_ptr(dev, &arrayprop->prop) == eltptr);
863 object_property_add(obj, propname,
864 arrayprop->prop.info->name,
865 arrayprop->prop.info->get,
866 arrayprop->prop.info->set,
867 array_element_release,
868 arrayprop, &local_err);
869 if (local_err) {
870 error_propagate(errp, local_err);
871 return;
876 PropertyInfo qdev_prop_arraylen = {
877 .name = "uint32",
878 .get = get_uint32,
879 .set = set_prop_arraylen,
882 /* --- public helpers --- */
884 static Property *qdev_prop_walk(Property *props, const char *name)
886 if (!props) {
887 return NULL;
889 while (props->name) {
890 if (strcmp(props->name, name) == 0) {
891 return props;
893 props++;
895 return NULL;
898 static Property *qdev_prop_find(DeviceState *dev, const char *name)
900 ObjectClass *class;
901 Property *prop;
903 /* device properties */
904 class = object_get_class(OBJECT(dev));
905 do {
906 prop = qdev_prop_walk(DEVICE_CLASS(class)->props, name);
907 if (prop) {
908 return prop;
910 class = object_class_get_parent(class);
911 } while (class != object_class_by_name(TYPE_DEVICE));
913 return NULL;
916 void error_set_from_qdev_prop_error(Error **errp, int ret, DeviceState *dev,
917 Property *prop, const char *value)
919 switch (ret) {
920 case -EEXIST:
921 error_setg(errp, "Property '%s.%s' can't take value '%s', it's in use",
922 object_get_typename(OBJECT(dev)), prop->name, value);
923 break;
924 default:
925 case -EINVAL:
926 error_setg(errp, QERR_PROPERTY_VALUE_BAD,
927 object_get_typename(OBJECT(dev)), prop->name, value);
928 break;
929 case -ENOENT:
930 error_setg(errp, "Property '%s.%s' can't find value '%s'",
931 object_get_typename(OBJECT(dev)), prop->name, value);
932 break;
933 case 0:
934 break;
938 void qdev_prop_set_bit(DeviceState *dev, const char *name, bool value)
940 object_property_set_bool(OBJECT(dev), value, name, &error_abort);
943 void qdev_prop_set_uint8(DeviceState *dev, const char *name, uint8_t value)
945 object_property_set_int(OBJECT(dev), value, name, &error_abort);
948 void qdev_prop_set_uint16(DeviceState *dev, const char *name, uint16_t value)
950 object_property_set_int(OBJECT(dev), value, name, &error_abort);
953 void qdev_prop_set_uint32(DeviceState *dev, const char *name, uint32_t value)
955 object_property_set_int(OBJECT(dev), value, name, &error_abort);
958 void qdev_prop_set_int32(DeviceState *dev, const char *name, int32_t value)
960 object_property_set_int(OBJECT(dev), value, name, &error_abort);
963 void qdev_prop_set_uint64(DeviceState *dev, const char *name, uint64_t value)
965 object_property_set_int(OBJECT(dev), value, name, &error_abort);
968 void qdev_prop_set_string(DeviceState *dev, const char *name, const char *value)
970 object_property_set_str(OBJECT(dev), value, name, &error_abort);
973 void qdev_prop_set_macaddr(DeviceState *dev, const char *name, uint8_t *value)
975 char str[2 * 6 + 5 + 1];
976 snprintf(str, sizeof(str), "%02x:%02x:%02x:%02x:%02x:%02x",
977 value[0], value[1], value[2], value[3], value[4], value[5]);
979 object_property_set_str(OBJECT(dev), str, name, &error_abort);
982 void qdev_prop_set_enum(DeviceState *dev, const char *name, int value)
984 Property *prop;
986 prop = qdev_prop_find(dev, name);
987 object_property_set_str(OBJECT(dev), prop->info->enum_table[value],
988 name, &error_abort);
991 void qdev_prop_set_ptr(DeviceState *dev, const char *name, void *value)
993 Property *prop;
994 void **ptr;
996 prop = qdev_prop_find(dev, name);
997 assert(prop && prop->info == &qdev_prop_ptr);
998 ptr = qdev_get_prop_ptr(dev, prop);
999 *ptr = value;
1002 static QTAILQ_HEAD(, GlobalProperty) global_props =
1003 QTAILQ_HEAD_INITIALIZER(global_props);
1005 void qdev_prop_register_global(GlobalProperty *prop)
1007 QTAILQ_INSERT_TAIL(&global_props, prop, next);
1010 void qdev_prop_register_global_list(GlobalProperty *props)
1012 int i;
1014 for (i = 0; props[i].driver != NULL; i++) {
1015 qdev_prop_register_global(props+i);
1019 int qdev_prop_check_globals(void)
1021 GlobalProperty *prop;
1022 int ret = 0;
1024 QTAILQ_FOREACH(prop, &global_props, next) {
1025 ObjectClass *oc;
1026 DeviceClass *dc;
1027 if (prop->used) {
1028 continue;
1030 if (!prop->user_provided) {
1031 continue;
1033 oc = object_class_by_name(prop->driver);
1034 oc = object_class_dynamic_cast(oc, TYPE_DEVICE);
1035 if (!oc) {
1036 error_report("Warning: global %s.%s has invalid class name",
1037 prop->driver, prop->property);
1038 ret = 1;
1039 continue;
1041 dc = DEVICE_CLASS(oc);
1042 if (!dc->hotpluggable && !prop->used) {
1043 error_report("Warning: global %s.%s=%s not used",
1044 prop->driver, prop->property, prop->value);
1045 ret = 1;
1046 continue;
1049 return ret;
1052 static void qdev_prop_set_globals_for_type(DeviceState *dev,
1053 const char *typename)
1055 GlobalProperty *prop;
1057 QTAILQ_FOREACH(prop, &global_props, next) {
1058 Error *err = NULL;
1060 if (strcmp(typename, prop->driver) != 0) {
1061 continue;
1063 prop->used = true;
1064 object_property_parse(OBJECT(dev), prop->value, prop->property, &err);
1065 if (err != NULL) {
1066 assert(prop->user_provided);
1067 error_report("Warning: global %s.%s=%s ignored (%s)",
1068 prop->driver, prop->property, prop->value,
1069 error_get_pretty(err));
1070 error_free(err);
1071 return;
1076 void qdev_prop_set_globals(DeviceState *dev)
1078 ObjectClass *class = object_get_class(OBJECT(dev));
1080 do {
1081 qdev_prop_set_globals_for_type(dev, object_class_get_name(class));
1082 class = object_class_get_parent(class);
1083 } while (class);
1086 /* --- 64bit unsigned int 'size' type --- */
1088 static void get_size(Object *obj, Visitor *v, void *opaque,
1089 const char *name, Error **errp)
1091 DeviceState *dev = DEVICE(obj);
1092 Property *prop = opaque;
1093 uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
1095 visit_type_size(v, ptr, name, errp);
1098 static void set_size(Object *obj, Visitor *v, void *opaque,
1099 const char *name, Error **errp)
1101 DeviceState *dev = DEVICE(obj);
1102 Property *prop = opaque;
1103 uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
1105 visit_type_size(v, ptr, name, errp);
1108 PropertyInfo qdev_prop_size = {
1109 .name = "size",
1110 .get = get_size,
1111 .set = set_size,