xref: /openbmc/qemu/hw/core/qdev-properties.c (revision 0b2ff2ce)
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"
9 
10 void qdev_prop_set_after_realize(DeviceState *dev, const char *name,
11                                   Error **errp)
12 {
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)));
21     }
22 }
23 
24 void qdev_prop_allow_set_link_before_realize(Object *obj, const char *name,
25                                              Object *val, Error **errp)
26 {
27     DeviceState *dev = DEVICE(obj);
28 
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));
33     }
34 }
35 
36 void *qdev_get_prop_ptr(DeviceState *dev, Property *prop)
37 {
38     void *ptr = dev;
39     ptr += prop->offset;
40     return ptr;
41 }
42 
43 static void get_enum(Object *obj, Visitor *v, void *opaque,
44                      const char *name, Error **errp)
45 {
46     DeviceState *dev = DEVICE(obj);
47     Property *prop = opaque;
48     int *ptr = qdev_get_prop_ptr(dev, prop);
49 
50     visit_type_enum(v, ptr, prop->info->enum_table,
51                     prop->info->name, prop->name, errp);
52 }
53 
54 static void set_enum(Object *obj, Visitor *v, void *opaque,
55                      const char *name, Error **errp)
56 {
57     DeviceState *dev = DEVICE(obj);
58     Property *prop = opaque;
59     int *ptr = qdev_get_prop_ptr(dev, prop);
60 
61     if (dev->realized) {
62         qdev_prop_set_after_realize(dev, name, errp);
63         return;
64     }
65 
66     visit_type_enum(v, ptr, prop->info->enum_table,
67                     prop->info->name, prop->name, errp);
68 }
69 
70 /* Bit */
71 
72 static uint32_t qdev_get_prop_mask(Property *prop)
73 {
74     assert(prop->info == &qdev_prop_bit);
75     return 0x1 << prop->bitnr;
76 }
77 
78 static void bit_prop_set(DeviceState *dev, Property *props, bool val)
79 {
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;
86     }
87 }
88 
89 static void prop_get_bit(Object *obj, Visitor *v, void *opaque,
90                     const char *name, Error **errp)
91 {
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;
96 
97     visit_type_bool(v, &value, name, errp);
98 }
99 
100 static void prop_set_bit(Object *obj, Visitor *v, void *opaque,
101                     const char *name, Error **errp)
102 {
103     DeviceState *dev = DEVICE(obj);
104     Property *prop = opaque;
105     Error *local_err = NULL;
106     bool value;
107 
108     if (dev->realized) {
109         qdev_prop_set_after_realize(dev, name, errp);
110         return;
111     }
112 
113     visit_type_bool(v, &value, name, &local_err);
114     if (local_err) {
115         error_propagate(errp, local_err);
116         return;
117     }
118     bit_prop_set(dev, prop, value);
119 }
120 
121 PropertyInfo qdev_prop_bit = {
122     .name  = "bool",
123     .description = "on/off",
124     .get   = prop_get_bit,
125     .set   = prop_set_bit,
126 };
127 
128 /* Bit64 */
129 
130 static uint64_t qdev_get_prop_mask64(Property *prop)
131 {
132     assert(prop->info == &qdev_prop_bit);
133     return 0x1 << prop->bitnr;
134 }
135 
136 static void bit64_prop_set(DeviceState *dev, Property *props, bool val)
137 {
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;
144     }
145 }
146 
147 static void prop_get_bit64(Object *obj, Visitor *v, void *opaque,
148                            const char *name, Error **errp)
149 {
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;
154 
155     visit_type_bool(v, &value, name, errp);
156 }
157 
158 static void prop_set_bit64(Object *obj, Visitor *v, void *opaque,
159                            const char *name, Error **errp)
160 {
161     DeviceState *dev = DEVICE(obj);
162     Property *prop = opaque;
163     Error *local_err = NULL;
164     bool value;
165 
166     if (dev->realized) {
167         qdev_prop_set_after_realize(dev, name, errp);
168         return;
169     }
170 
171     visit_type_bool(v, &value, name, &local_err);
172     if (local_err) {
173         error_propagate(errp, local_err);
174         return;
175     }
176     bit64_prop_set(dev, prop, value);
177 }
178 
179 PropertyInfo qdev_prop_bit64 = {
180     .name  = "bool",
181     .description = "on/off",
182     .get   = prop_get_bit64,
183     .set   = prop_set_bit64,
184 };
185 
186 /* --- bool --- */
187 
188 static void get_bool(Object *obj, Visitor *v, void *opaque,
189                      const char *name, Error **errp)
190 {
191     DeviceState *dev = DEVICE(obj);
192     Property *prop = opaque;
193     bool *ptr = qdev_get_prop_ptr(dev, prop);
194 
195     visit_type_bool(v, ptr, name, errp);
196 }
197 
198 static void set_bool(Object *obj, Visitor *v, void *opaque,
199                      const char *name, Error **errp)
200 {
201     DeviceState *dev = DEVICE(obj);
202     Property *prop = opaque;
203     bool *ptr = qdev_get_prop_ptr(dev, prop);
204 
205     if (dev->realized) {
206         qdev_prop_set_after_realize(dev, name, errp);
207         return;
208     }
209 
210     visit_type_bool(v, ptr, name, errp);
211 }
212 
213 PropertyInfo qdev_prop_bool = {
214     .name  = "bool",
215     .get   = get_bool,
216     .set   = set_bool,
217 };
218 
219 /* --- 8bit integer --- */
220 
221 static void get_uint8(Object *obj, Visitor *v, void *opaque,
222                       const char *name, Error **errp)
223 {
224     DeviceState *dev = DEVICE(obj);
225     Property *prop = opaque;
226     uint8_t *ptr = qdev_get_prop_ptr(dev, prop);
227 
228     visit_type_uint8(v, ptr, name, errp);
229 }
230 
231 static void set_uint8(Object *obj, Visitor *v, void *opaque,
232                       const char *name, Error **errp)
233 {
234     DeviceState *dev = DEVICE(obj);
235     Property *prop = opaque;
236     uint8_t *ptr = qdev_get_prop_ptr(dev, prop);
237 
238     if (dev->realized) {
239         qdev_prop_set_after_realize(dev, name, errp);
240         return;
241     }
242 
243     visit_type_uint8(v, ptr, name, errp);
244 }
245 
246 PropertyInfo qdev_prop_uint8 = {
247     .name  = "uint8",
248     .get   = get_uint8,
249     .set   = set_uint8,
250 };
251 
252 /* --- 16bit integer --- */
253 
254 static void get_uint16(Object *obj, Visitor *v, void *opaque,
255                        const char *name, Error **errp)
256 {
257     DeviceState *dev = DEVICE(obj);
258     Property *prop = opaque;
259     uint16_t *ptr = qdev_get_prop_ptr(dev, prop);
260 
261     visit_type_uint16(v, ptr, name, errp);
262 }
263 
264 static void set_uint16(Object *obj, Visitor *v, void *opaque,
265                        const char *name, Error **errp)
266 {
267     DeviceState *dev = DEVICE(obj);
268     Property *prop = opaque;
269     uint16_t *ptr = qdev_get_prop_ptr(dev, prop);
270 
271     if (dev->realized) {
272         qdev_prop_set_after_realize(dev, name, errp);
273         return;
274     }
275 
276     visit_type_uint16(v, ptr, name, errp);
277 }
278 
279 PropertyInfo qdev_prop_uint16 = {
280     .name  = "uint16",
281     .get   = get_uint16,
282     .set   = set_uint16,
283 };
284 
285 /* --- 32bit integer --- */
286 
287 static void get_uint32(Object *obj, Visitor *v, void *opaque,
288                        const char *name, Error **errp)
289 {
290     DeviceState *dev = DEVICE(obj);
291     Property *prop = opaque;
292     uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
293 
294     visit_type_uint32(v, ptr, name, errp);
295 }
296 
297 static void set_uint32(Object *obj, Visitor *v, void *opaque,
298                        const char *name, Error **errp)
299 {
300     DeviceState *dev = DEVICE(obj);
301     Property *prop = opaque;
302     uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
303 
304     if (dev->realized) {
305         qdev_prop_set_after_realize(dev, name, errp);
306         return;
307     }
308 
309     visit_type_uint32(v, ptr, name, errp);
310 }
311 
312 static void get_int32(Object *obj, Visitor *v, void *opaque,
313                       const char *name, Error **errp)
314 {
315     DeviceState *dev = DEVICE(obj);
316     Property *prop = opaque;
317     int32_t *ptr = qdev_get_prop_ptr(dev, prop);
318 
319     visit_type_int32(v, ptr, name, errp);
320 }
321 
322 static void set_int32(Object *obj, Visitor *v, void *opaque,
323                       const char *name, Error **errp)
324 {
325     DeviceState *dev = DEVICE(obj);
326     Property *prop = opaque;
327     int32_t *ptr = qdev_get_prop_ptr(dev, prop);
328 
329     if (dev->realized) {
330         qdev_prop_set_after_realize(dev, name, errp);
331         return;
332     }
333 
334     visit_type_int32(v, ptr, name, errp);
335 }
336 
337 PropertyInfo qdev_prop_uint32 = {
338     .name  = "uint32",
339     .get   = get_uint32,
340     .set   = set_uint32,
341 };
342 
343 PropertyInfo qdev_prop_int32 = {
344     .name  = "int32",
345     .get   = get_int32,
346     .set   = set_int32,
347 };
348 
349 /* --- 64bit integer --- */
350 
351 static void get_uint64(Object *obj, Visitor *v, void *opaque,
352                        const char *name, Error **errp)
353 {
354     DeviceState *dev = DEVICE(obj);
355     Property *prop = opaque;
356     uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
357 
358     visit_type_uint64(v, ptr, name, errp);
359 }
360 
361 static void set_uint64(Object *obj, Visitor *v, void *opaque,
362                        const char *name, Error **errp)
363 {
364     DeviceState *dev = DEVICE(obj);
365     Property *prop = opaque;
366     uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
367 
368     if (dev->realized) {
369         qdev_prop_set_after_realize(dev, name, errp);
370         return;
371     }
372 
373     visit_type_uint64(v, ptr, name, errp);
374 }
375 
376 PropertyInfo qdev_prop_uint64 = {
377     .name  = "uint64",
378     .get   = get_uint64,
379     .set   = set_uint64,
380 };
381 
382 /* --- string --- */
383 
384 static void release_string(Object *obj, const char *name, void *opaque)
385 {
386     Property *prop = opaque;
387     g_free(*(char **)qdev_get_prop_ptr(DEVICE(obj), prop));
388 }
389 
390 static void get_string(Object *obj, Visitor *v, void *opaque,
391                        const char *name, Error **errp)
392 {
393     DeviceState *dev = DEVICE(obj);
394     Property *prop = opaque;
395     char **ptr = qdev_get_prop_ptr(dev, prop);
396 
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);
402     }
403 }
404 
405 static void set_string(Object *obj, Visitor *v, void *opaque,
406                        const char *name, Error **errp)
407 {
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;
413 
414     if (dev->realized) {
415         qdev_prop_set_after_realize(dev, name, errp);
416         return;
417     }
418 
419     visit_type_str(v, &str, name, &local_err);
420     if (local_err) {
421         error_propagate(errp, local_err);
422         return;
423     }
424     if (*ptr) {
425         g_free(*ptr);
426     }
427     *ptr = str;
428 }
429 
430 PropertyInfo qdev_prop_string = {
431     .name  = "str",
432     .release = release_string,
433     .get   = get_string,
434     .set   = set_string,
435 };
436 
437 /* --- pointer --- */
438 
439 /* Not a proper property, just for dirty hacks.  TODO Remove it!  */
440 PropertyInfo qdev_prop_ptr = {
441     .name  = "ptr",
442 };
443 
444 /* --- mac address --- */
445 
446 /*
447  * accepted syntax versions:
448  *   01:02:03:04:05:06
449  *   01-02-03-04-05-06
450  */
451 static void get_mac(Object *obj, Visitor *v, void *opaque,
452                     const char *name, Error **errp)
453 {
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;
459 
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]);
463 
464     visit_type_str(v, &p, name, errp);
465 }
466 
467 static void set_mac(Object *obj, Visitor *v, void *opaque,
468                     const char *name, Error **errp)
469 {
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;
476 
477     if (dev->realized) {
478         qdev_prop_set_after_realize(dev, name, errp);
479         return;
480     }
481 
482     visit_type_str(v, &str, name, &local_err);
483     if (local_err) {
484         error_propagate(errp, local_err);
485         return;
486     }
487 
488     for (i = 0, pos = 0; i < 6; i++, pos += 3) {
489         if (!qemu_isxdigit(str[pos])) {
490             goto inval;
491         }
492         if (!qemu_isxdigit(str[pos+1])) {
493             goto inval;
494         }
495         if (i == 5) {
496             if (str[pos+2] != '\0') {
497                 goto inval;
498             }
499         } else {
500             if (str[pos+2] != ':' && str[pos+2] != '-') {
501                 goto inval;
502             }
503         }
504         mac->a[i] = strtol(str+pos, &p, 16);
505     }
506     g_free(str);
507     return;
508 
509 inval:
510     error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
511     g_free(str);
512 }
513 
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,
519 };
520 
521 /* --- lost tick policy --- */
522 
523 QEMU_BUILD_BUG_ON(sizeof(LostTickPolicy) != sizeof(int));
524 
525 PropertyInfo qdev_prop_losttickpolicy = {
526     .name  = "LostTickPolicy",
527     .enum_table  = LostTickPolicy_lookup,
528     .get   = get_enum,
529     .set   = set_enum,
530 };
531 
532 /* --- BIOS CHS translation */
533 
534 QEMU_BUILD_BUG_ON(sizeof(BiosAtaTranslation) != sizeof(int));
535 
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,
543 };
544 
545 /* --- pci address --- */
546 
547 /*
548  * bus-local address, i.e. "$slot" or "$slot.$fn"
549  */
550 static void set_pci_devfn(Object *obj, Visitor *v, void *opaque,
551                           const char *name, Error **errp)
552 {
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;
559 
560     if (dev->realized) {
561         qdev_prop_set_after_realize(dev, name, errp);
562         return;
563     }
564 
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_set(errp, QERR_INVALID_PARAMETER_VALUE, name ? name : "null",
574                       "pci_devfn");
575         } else {
576             *ptr = value;
577         }
578         return;
579     }
580 
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;
585         }
586     }
587     if (str[n] != '\0' || fn > 7 || slot > 31) {
588         goto invalid;
589     }
590     *ptr = slot << 3 | fn;
591     g_free(str);
592     return;
593 
594 invalid:
595     error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
596     g_free(str);
597 }
598 
599 static int print_pci_devfn(DeviceState *dev, Property *prop, char *dest,
600                            size_t len)
601 {
602     int32_t *ptr = qdev_get_prop_ptr(dev, prop);
603 
604     if (*ptr == -1) {
605         return snprintf(dest, len, "<unset>");
606     } else {
607         return snprintf(dest, len, "%02x.%x", *ptr >> 3, *ptr & 7);
608     }
609 }
610 
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,
617 };
618 
619 /* --- blocksize --- */
620 
621 static void set_blocksize(Object *obj, Visitor *v, void *opaque,
622                           const char *name, Error **errp)
623 {
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;
630 
631     if (dev->realized) {
632         qdev_prop_set_after_realize(dev, name, errp);
633         return;
634     }
635 
636     visit_type_uint16(v, &value, name, &local_err);
637     if (local_err) {
638         error_propagate(errp, local_err);
639         return;
640     }
641     /* value of 0 means "unset" */
642     if (value && (value < min || value > max)) {
643         error_set(errp, QERR_PROPERTY_VALUE_OUT_OF_RANGE,
644                   dev->id?:"", name, (int64_t)value, min, max);
645         return;
646     }
647 
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;
654     }
655 
656     *ptr = value;
657 }
658 
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,
664 };
665 
666 /* --- pci host address --- */
667 
668 static void get_pci_host_devaddr(Object *obj, Visitor *v, void *opaque,
669                                  const char *name, Error **errp)
670 {
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;
677 
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);
681 
682     visit_type_str(v, &p, name, errp);
683 }
684 
685 /*
686  * Parse [<domain>:]<bus>:<slot>.<func>
687  *   if <domain> is not supplied, it's assumed to be 0.
688  */
689 static void set_pci_host_devaddr(Object *obj, Visitor *v, void *opaque,
690                                  const char *name, Error **errp)
691 {
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;
701 
702     if (dev->realized) {
703         qdev_prop_set_after_realize(dev, name, errp);
704         return;
705     }
706 
707     visit_type_str(v, &str, name, &local_err);
708     if (local_err) {
709         error_propagate(errp, local_err);
710         return;
711     }
712 
713     p = str;
714     val = strtoul(p, &e, 16);
715     if (e == p || *e != ':') {
716         goto inval;
717     }
718     bus = val;
719 
720     p = e + 1;
721     val = strtoul(p, &e, 16);
722     if (e == p) {
723         goto inval;
724     }
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;
732         }
733     }
734     slot = val;
735 
736     if (*e != '.') {
737         goto inval;
738     }
739     p = e + 1;
740     val = strtoul(p, &e, 10);
741     if (e == p) {
742         goto inval;
743     }
744     func = val;
745 
746     if (dom > 0xffff || bus > 0xff || slot > 0x1f || func > 7) {
747         goto inval;
748     }
749 
750     if (*e) {
751         goto inval;
752     }
753 
754     addr->domain = dom;
755     addr->bus = bus;
756     addr->slot = slot;
757     addr->function = func;
758 
759     g_free(str);
760     return;
761 
762 inval:
763     error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
764     g_free(str);
765 }
766 
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,
773 };
774 
775 /* --- support for array properties --- */
776 
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.
782  */
783 typedef struct {
784     struct Property prop;
785     char *propname;
786     ObjectPropertyRelease *release;
787 } ArrayElementProperty;
788 
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.
792  */
793 static void array_element_release(Object *obj, const char *name, void *opaque)
794 {
795     ArrayElementProperty *p = opaque;
796     if (p->release) {
797         p->release(obj, name, opaque);
798     }
799     g_free(p->propname);
800     g_free(p);
801 }
802 
803 static void set_prop_arraylen(Object *obj, Visitor *v, void *opaque,
804                               const char *name, Error **errp)
805 {
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.
810      */
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;
819 
820     if (dev->realized) {
821         qdev_prop_set_after_realize(dev, name, errp);
822         return;
823     }
824     if (*alenptr) {
825         error_setg(errp, "array size property %s may not be set more than once",
826                    name);
827         return;
828     }
829     visit_type_uint32(v, alenptr, name, &local_err);
830     if (local_err) {
831         error_propagate(errp, local_err);
832         return;
833     }
834     if (!*alenptr) {
835         return;
836     }
837 
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.
840      */
841     assert(strncmp(name, PROP_ARRAY_LEN_PREFIX,
842                    strlen(PROP_ARRAY_LEN_PREFIX)) == 0);
843     arrayname = name + strlen(PROP_ARRAY_LEN_PREFIX);
844 
845     /* Note that it is the responsibility of the individual device's deinit
846      * to free the array proper.
847      */
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.
860          */
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;
872         }
873     }
874 }
875 
876 PropertyInfo qdev_prop_arraylen = {
877     .name = "uint32",
878     .get = get_uint32,
879     .set = set_prop_arraylen,
880 };
881 
882 /* --- public helpers --- */
883 
884 static Property *qdev_prop_walk(Property *props, const char *name)
885 {
886     if (!props) {
887         return NULL;
888     }
889     while (props->name) {
890         if (strcmp(props->name, name) == 0) {
891             return props;
892         }
893         props++;
894     }
895     return NULL;
896 }
897 
898 static Property *qdev_prop_find(DeviceState *dev, const char *name)
899 {
900     ObjectClass *class;
901     Property *prop;
902 
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;
909         }
910         class = object_class_get_parent(class);
911     } while (class != object_class_by_name(TYPE_DEVICE));
912 
913     return NULL;
914 }
915 
916 void error_set_from_qdev_prop_error(Error **errp, int ret, DeviceState *dev,
917                                     Property *prop, const char *value)
918 {
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_set(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;
935     }
936 }
937 
938 void qdev_prop_set_bit(DeviceState *dev, const char *name, bool value)
939 {
940     object_property_set_bool(OBJECT(dev), value, name, &error_abort);
941 }
942 
943 void qdev_prop_set_uint8(DeviceState *dev, const char *name, uint8_t value)
944 {
945     object_property_set_int(OBJECT(dev), value, name, &error_abort);
946 }
947 
948 void qdev_prop_set_uint16(DeviceState *dev, const char *name, uint16_t value)
949 {
950     object_property_set_int(OBJECT(dev), value, name, &error_abort);
951 }
952 
953 void qdev_prop_set_uint32(DeviceState *dev, const char *name, uint32_t value)
954 {
955     object_property_set_int(OBJECT(dev), value, name, &error_abort);
956 }
957 
958 void qdev_prop_set_int32(DeviceState *dev, const char *name, int32_t value)
959 {
960     object_property_set_int(OBJECT(dev), value, name, &error_abort);
961 }
962 
963 void qdev_prop_set_uint64(DeviceState *dev, const char *name, uint64_t value)
964 {
965     object_property_set_int(OBJECT(dev), value, name, &error_abort);
966 }
967 
968 void qdev_prop_set_string(DeviceState *dev, const char *name, const char *value)
969 {
970     object_property_set_str(OBJECT(dev), value, name, &error_abort);
971 }
972 
973 void qdev_prop_set_macaddr(DeviceState *dev, const char *name, uint8_t *value)
974 {
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]);
978 
979     object_property_set_str(OBJECT(dev), str, name, &error_abort);
980 }
981 
982 void qdev_prop_set_enum(DeviceState *dev, const char *name, int value)
983 {
984     Property *prop;
985 
986     prop = qdev_prop_find(dev, name);
987     object_property_set_str(OBJECT(dev), prop->info->enum_table[value],
988                             name, &error_abort);
989 }
990 
991 void qdev_prop_set_ptr(DeviceState *dev, const char *name, void *value)
992 {
993     Property *prop;
994     void **ptr;
995 
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;
1000 }
1001 
1002 static QTAILQ_HEAD(, GlobalProperty) global_props =
1003         QTAILQ_HEAD_INITIALIZER(global_props);
1004 
1005 void qdev_prop_register_global(GlobalProperty *prop)
1006 {
1007     QTAILQ_INSERT_TAIL(&global_props, prop, next);
1008 }
1009 
1010 void qdev_prop_register_global_list(GlobalProperty *props)
1011 {
1012     int i;
1013 
1014     for (i = 0; props[i].driver != NULL; i++) {
1015         qdev_prop_register_global(props+i);
1016     }
1017 }
1018 
1019 int qdev_prop_check_globals(void)
1020 {
1021     GlobalProperty *prop;
1022     int ret = 0;
1023 
1024     QTAILQ_FOREACH(prop, &global_props, next) {
1025         ObjectClass *oc;
1026         DeviceClass *dc;
1027         if (prop->used) {
1028             continue;
1029         }
1030         if (!prop->user_provided) {
1031             continue;
1032         }
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;
1040         }
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;
1047         }
1048     }
1049     return ret;
1050 }
1051 
1052 static void qdev_prop_set_globals_for_type(DeviceState *dev,
1053                                 const char *typename)
1054 {
1055     GlobalProperty *prop;
1056 
1057     QTAILQ_FOREACH(prop, &global_props, next) {
1058         Error *err = NULL;
1059 
1060         if (strcmp(typename, prop->driver) != 0) {
1061             continue;
1062         }
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;
1072         }
1073     }
1074 }
1075 
1076 void qdev_prop_set_globals(DeviceState *dev)
1077 {
1078     ObjectClass *class = object_get_class(OBJECT(dev));
1079 
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);
1084 }
1085 
1086 /* --- 64bit unsigned int 'size' type --- */
1087 
1088 static void get_size(Object *obj, Visitor *v, void *opaque,
1089                      const char *name, Error **errp)
1090 {
1091     DeviceState *dev = DEVICE(obj);
1092     Property *prop = opaque;
1093     uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
1094 
1095     visit_type_size(v, ptr, name, errp);
1096 }
1097 
1098 static void set_size(Object *obj, Visitor *v, void *opaque,
1099                      const char *name, Error **errp)
1100 {
1101     DeviceState *dev = DEVICE(obj);
1102     Property *prop = opaque;
1103     uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
1104 
1105     visit_type_size(v, ptr, name, errp);
1106 }
1107 
1108 PropertyInfo qdev_prop_size = {
1109     .name  = "size",
1110     .get = get_size,
1111     .set = set_size,
1112 };
1113