xref: /qemu/hw/core/qdev-properties.c (revision 164c374b)
1 #include "qemu/osdep.h"
2 #include "net/net.h"
3 #include "hw/qdev-properties.h"
4 #include "qapi/error.h"
5 #include "hw/pci/pci.h"
6 #include "qapi/qapi-types-block.h"
7 #include "qapi/qapi-types-misc.h"
8 #include "qapi/qmp/qerror.h"
9 #include "qemu/ctype.h"
10 #include "qemu/error-report.h"
11 #include "hw/block/block.h"
12 #include "net/hub.h"
13 #include "qapi/visitor.h"
14 #include "chardev/char.h"
15 #include "qemu/uuid.h"
16 
17 void qdev_prop_set_after_realize(DeviceState *dev, const char *name,
18                                   Error **errp)
19 {
20     if (dev->id) {
21         error_setg(errp, "Attempt to set property '%s' on device '%s' "
22                    "(type '%s') after it was realized", name, dev->id,
23                    object_get_typename(OBJECT(dev)));
24     } else {
25         error_setg(errp, "Attempt to set property '%s' on anonymous device "
26                    "(type '%s') after it was realized", name,
27                    object_get_typename(OBJECT(dev)));
28     }
29 }
30 
31 void qdev_prop_allow_set_link_before_realize(const Object *obj,
32                                              const char *name,
33                                              Object *val, Error **errp)
34 {
35     DeviceState *dev = DEVICE(obj);
36 
37     if (dev->realized) {
38         error_setg(errp, "Attempt to set link property '%s' on device '%s' "
39                    "(type '%s') after it was realized",
40                    name, dev->id, object_get_typename(obj));
41     }
42 }
43 
44 void *qdev_get_prop_ptr(DeviceState *dev, Property *prop)
45 {
46     void *ptr = dev;
47     ptr += prop->offset;
48     return ptr;
49 }
50 
51 static void get_enum(Object *obj, Visitor *v, const char *name, void *opaque,
52                      Error **errp)
53 {
54     DeviceState *dev = DEVICE(obj);
55     Property *prop = opaque;
56     int *ptr = qdev_get_prop_ptr(dev, prop);
57 
58     visit_type_enum(v, prop->name, ptr, prop->info->enum_table, errp);
59 }
60 
61 static void set_enum(Object *obj, Visitor *v, const char *name, void *opaque,
62                      Error **errp)
63 {
64     DeviceState *dev = DEVICE(obj);
65     Property *prop = opaque;
66     int *ptr = qdev_get_prop_ptr(dev, prop);
67 
68     if (dev->realized) {
69         qdev_prop_set_after_realize(dev, name, errp);
70         return;
71     }
72 
73     visit_type_enum(v, prop->name, ptr, prop->info->enum_table, errp);
74 }
75 
76 static void set_default_value_enum(Object *obj, const Property *prop)
77 {
78     object_property_set_str(obj,
79                             qapi_enum_lookup(prop->info->enum_table,
80                                              prop->defval.i),
81                             prop->name, &error_abort);
82 }
83 
84 /* Bit */
85 
86 static uint32_t qdev_get_prop_mask(Property *prop)
87 {
88     assert(prop->info == &qdev_prop_bit);
89     return 0x1 << prop->bitnr;
90 }
91 
92 static void bit_prop_set(DeviceState *dev, Property *props, bool val)
93 {
94     uint32_t *p = qdev_get_prop_ptr(dev, props);
95     uint32_t mask = qdev_get_prop_mask(props);
96     if (val) {
97         *p |= mask;
98     } else {
99         *p &= ~mask;
100     }
101 }
102 
103 static void prop_get_bit(Object *obj, Visitor *v, const char *name,
104                          void *opaque, Error **errp)
105 {
106     DeviceState *dev = DEVICE(obj);
107     Property *prop = opaque;
108     uint32_t *p = qdev_get_prop_ptr(dev, prop);
109     bool value = (*p & qdev_get_prop_mask(prop)) != 0;
110 
111     visit_type_bool(v, name, &value, errp);
112 }
113 
114 static void prop_set_bit(Object *obj, Visitor *v, const char *name,
115                          void *opaque, Error **errp)
116 {
117     DeviceState *dev = DEVICE(obj);
118     Property *prop = opaque;
119     Error *local_err = NULL;
120     bool value;
121 
122     if (dev->realized) {
123         qdev_prop_set_after_realize(dev, name, errp);
124         return;
125     }
126 
127     visit_type_bool(v, name, &value, &local_err);
128     if (local_err) {
129         error_propagate(errp, local_err);
130         return;
131     }
132     bit_prop_set(dev, prop, value);
133 }
134 
135 static void set_default_value_bool(Object *obj, const Property *prop)
136 {
137     object_property_set_bool(obj, prop->defval.u, prop->name, &error_abort);
138 }
139 
140 const PropertyInfo qdev_prop_bit = {
141     .name  = "bool",
142     .description = "on/off",
143     .get   = prop_get_bit,
144     .set   = prop_set_bit,
145     .set_default_value = set_default_value_bool,
146 };
147 
148 /* Bit64 */
149 
150 static uint64_t qdev_get_prop_mask64(Property *prop)
151 {
152     assert(prop->info == &qdev_prop_bit64);
153     return 0x1ull << prop->bitnr;
154 }
155 
156 static void bit64_prop_set(DeviceState *dev, Property *props, bool val)
157 {
158     uint64_t *p = qdev_get_prop_ptr(dev, props);
159     uint64_t mask = qdev_get_prop_mask64(props);
160     if (val) {
161         *p |= mask;
162     } else {
163         *p &= ~mask;
164     }
165 }
166 
167 static void prop_get_bit64(Object *obj, Visitor *v, const char *name,
168                            void *opaque, Error **errp)
169 {
170     DeviceState *dev = DEVICE(obj);
171     Property *prop = opaque;
172     uint64_t *p = qdev_get_prop_ptr(dev, prop);
173     bool value = (*p & qdev_get_prop_mask64(prop)) != 0;
174 
175     visit_type_bool(v, name, &value, errp);
176 }
177 
178 static void prop_set_bit64(Object *obj, Visitor *v, const char *name,
179                            void *opaque, Error **errp)
180 {
181     DeviceState *dev = DEVICE(obj);
182     Property *prop = opaque;
183     Error *local_err = NULL;
184     bool value;
185 
186     if (dev->realized) {
187         qdev_prop_set_after_realize(dev, name, errp);
188         return;
189     }
190 
191     visit_type_bool(v, name, &value, &local_err);
192     if (local_err) {
193         error_propagate(errp, local_err);
194         return;
195     }
196     bit64_prop_set(dev, prop, value);
197 }
198 
199 const PropertyInfo qdev_prop_bit64 = {
200     .name  = "bool",
201     .description = "on/off",
202     .get   = prop_get_bit64,
203     .set   = prop_set_bit64,
204     .set_default_value = set_default_value_bool,
205 };
206 
207 /* --- bool --- */
208 
209 static void get_bool(Object *obj, Visitor *v, const char *name, void *opaque,
210                      Error **errp)
211 {
212     DeviceState *dev = DEVICE(obj);
213     Property *prop = opaque;
214     bool *ptr = qdev_get_prop_ptr(dev, prop);
215 
216     visit_type_bool(v, name, ptr, errp);
217 }
218 
219 static void set_bool(Object *obj, Visitor *v, const char *name, void *opaque,
220                      Error **errp)
221 {
222     DeviceState *dev = DEVICE(obj);
223     Property *prop = opaque;
224     bool *ptr = qdev_get_prop_ptr(dev, prop);
225 
226     if (dev->realized) {
227         qdev_prop_set_after_realize(dev, name, errp);
228         return;
229     }
230 
231     visit_type_bool(v, name, ptr, errp);
232 }
233 
234 const PropertyInfo qdev_prop_bool = {
235     .name  = "bool",
236     .get   = get_bool,
237     .set   = set_bool,
238     .set_default_value = set_default_value_bool,
239 };
240 
241 /* --- 8bit integer --- */
242 
243 static void get_uint8(Object *obj, Visitor *v, const char *name, void *opaque,
244                       Error **errp)
245 {
246     DeviceState *dev = DEVICE(obj);
247     Property *prop = opaque;
248     uint8_t *ptr = qdev_get_prop_ptr(dev, prop);
249 
250     visit_type_uint8(v, name, ptr, errp);
251 }
252 
253 static void set_uint8(Object *obj, Visitor *v, const char *name, void *opaque,
254                       Error **errp)
255 {
256     DeviceState *dev = DEVICE(obj);
257     Property *prop = opaque;
258     uint8_t *ptr = qdev_get_prop_ptr(dev, prop);
259 
260     if (dev->realized) {
261         qdev_prop_set_after_realize(dev, name, errp);
262         return;
263     }
264 
265     visit_type_uint8(v, name, ptr, errp);
266 }
267 
268 static void set_default_value_int(Object *obj, const Property *prop)
269 {
270     object_property_set_int(obj, prop->defval.i, prop->name, &error_abort);
271 }
272 
273 static void set_default_value_uint(Object *obj, const Property *prop)
274 {
275     object_property_set_uint(obj, prop->defval.u, prop->name, &error_abort);
276 }
277 
278 const PropertyInfo qdev_prop_uint8 = {
279     .name  = "uint8",
280     .get   = get_uint8,
281     .set   = set_uint8,
282     .set_default_value = set_default_value_uint,
283 };
284 
285 /* --- 16bit integer --- */
286 
287 static void get_uint16(Object *obj, Visitor *v, const char *name,
288                        void *opaque, Error **errp)
289 {
290     DeviceState *dev = DEVICE(obj);
291     Property *prop = opaque;
292     uint16_t *ptr = qdev_get_prop_ptr(dev, prop);
293 
294     visit_type_uint16(v, name, ptr, errp);
295 }
296 
297 static void set_uint16(Object *obj, Visitor *v, const char *name,
298                        void *opaque, Error **errp)
299 {
300     DeviceState *dev = DEVICE(obj);
301     Property *prop = opaque;
302     uint16_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_uint16(v, name, ptr, errp);
310 }
311 
312 const PropertyInfo qdev_prop_uint16 = {
313     .name  = "uint16",
314     .get   = get_uint16,
315     .set   = set_uint16,
316     .set_default_value = set_default_value_uint,
317 };
318 
319 /* --- 32bit integer --- */
320 
321 static void get_uint32(Object *obj, Visitor *v, const char *name,
322                        void *opaque, Error **errp)
323 {
324     DeviceState *dev = DEVICE(obj);
325     Property *prop = opaque;
326     uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
327 
328     visit_type_uint32(v, name, ptr, errp);
329 }
330 
331 static void set_uint32(Object *obj, Visitor *v, const char *name,
332                        void *opaque, Error **errp)
333 {
334     DeviceState *dev = DEVICE(obj);
335     Property *prop = opaque;
336     uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
337 
338     if (dev->realized) {
339         qdev_prop_set_after_realize(dev, name, errp);
340         return;
341     }
342 
343     visit_type_uint32(v, name, ptr, errp);
344 }
345 
346 static void get_int32(Object *obj, Visitor *v, const char *name, void *opaque,
347                       Error **errp)
348 {
349     DeviceState *dev = DEVICE(obj);
350     Property *prop = opaque;
351     int32_t *ptr = qdev_get_prop_ptr(dev, prop);
352 
353     visit_type_int32(v, name, ptr, errp);
354 }
355 
356 static void set_int32(Object *obj, Visitor *v, const char *name, void *opaque,
357                       Error **errp)
358 {
359     DeviceState *dev = DEVICE(obj);
360     Property *prop = opaque;
361     int32_t *ptr = qdev_get_prop_ptr(dev, prop);
362 
363     if (dev->realized) {
364         qdev_prop_set_after_realize(dev, name, errp);
365         return;
366     }
367 
368     visit_type_int32(v, name, ptr, errp);
369 }
370 
371 const PropertyInfo qdev_prop_uint32 = {
372     .name  = "uint32",
373     .get   = get_uint32,
374     .set   = set_uint32,
375     .set_default_value = set_default_value_uint,
376 };
377 
378 const PropertyInfo qdev_prop_int32 = {
379     .name  = "int32",
380     .get   = get_int32,
381     .set   = set_int32,
382     .set_default_value = set_default_value_int,
383 };
384 
385 /* --- 64bit integer --- */
386 
387 static void get_uint64(Object *obj, Visitor *v, const char *name,
388                        void *opaque, Error **errp)
389 {
390     DeviceState *dev = DEVICE(obj);
391     Property *prop = opaque;
392     uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
393 
394     visit_type_uint64(v, name, ptr, errp);
395 }
396 
397 static void set_uint64(Object *obj, Visitor *v, const char *name,
398                        void *opaque, Error **errp)
399 {
400     DeviceState *dev = DEVICE(obj);
401     Property *prop = opaque;
402     uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
403 
404     if (dev->realized) {
405         qdev_prop_set_after_realize(dev, name, errp);
406         return;
407     }
408 
409     visit_type_uint64(v, name, ptr, errp);
410 }
411 
412 static void get_int64(Object *obj, Visitor *v, const char *name,
413                       void *opaque, Error **errp)
414 {
415     DeviceState *dev = DEVICE(obj);
416     Property *prop = opaque;
417     int64_t *ptr = qdev_get_prop_ptr(dev, prop);
418 
419     visit_type_int64(v, name, ptr, errp);
420 }
421 
422 static void set_int64(Object *obj, Visitor *v, const char *name,
423                       void *opaque, Error **errp)
424 {
425     DeviceState *dev = DEVICE(obj);
426     Property *prop = opaque;
427     int64_t *ptr = qdev_get_prop_ptr(dev, prop);
428 
429     if (dev->realized) {
430         qdev_prop_set_after_realize(dev, name, errp);
431         return;
432     }
433 
434     visit_type_int64(v, name, ptr, errp);
435 }
436 
437 const PropertyInfo qdev_prop_uint64 = {
438     .name  = "uint64",
439     .get   = get_uint64,
440     .set   = set_uint64,
441     .set_default_value = set_default_value_uint,
442 };
443 
444 const PropertyInfo qdev_prop_int64 = {
445     .name  = "int64",
446     .get   = get_int64,
447     .set   = set_int64,
448     .set_default_value = set_default_value_int,
449 };
450 
451 /* --- string --- */
452 
453 static void release_string(Object *obj, const char *name, void *opaque)
454 {
455     Property *prop = opaque;
456     g_free(*(char **)qdev_get_prop_ptr(DEVICE(obj), prop));
457 }
458 
459 static void get_string(Object *obj, Visitor *v, const char *name,
460                        void *opaque, Error **errp)
461 {
462     DeviceState *dev = DEVICE(obj);
463     Property *prop = opaque;
464     char **ptr = qdev_get_prop_ptr(dev, prop);
465 
466     if (!*ptr) {
467         char *str = (char *)"";
468         visit_type_str(v, name, &str, errp);
469     } else {
470         visit_type_str(v, name, ptr, errp);
471     }
472 }
473 
474 static void set_string(Object *obj, Visitor *v, const char *name,
475                        void *opaque, Error **errp)
476 {
477     DeviceState *dev = DEVICE(obj);
478     Property *prop = opaque;
479     char **ptr = qdev_get_prop_ptr(dev, prop);
480     Error *local_err = NULL;
481     char *str;
482 
483     if (dev->realized) {
484         qdev_prop_set_after_realize(dev, name, errp);
485         return;
486     }
487 
488     visit_type_str(v, name, &str, &local_err);
489     if (local_err) {
490         error_propagate(errp, local_err);
491         return;
492     }
493     g_free(*ptr);
494     *ptr = str;
495 }
496 
497 const PropertyInfo qdev_prop_string = {
498     .name  = "str",
499     .release = release_string,
500     .get   = get_string,
501     .set   = set_string,
502 };
503 
504 /* --- mac address --- */
505 
506 /*
507  * accepted syntax versions:
508  *   01:02:03:04:05:06
509  *   01-02-03-04-05-06
510  */
511 static void get_mac(Object *obj, Visitor *v, const char *name, void *opaque,
512                     Error **errp)
513 {
514     DeviceState *dev = DEVICE(obj);
515     Property *prop = opaque;
516     MACAddr *mac = qdev_get_prop_ptr(dev, prop);
517     char buffer[2 * 6 + 5 + 1];
518     char *p = buffer;
519 
520     snprintf(buffer, sizeof(buffer), "%02x:%02x:%02x:%02x:%02x:%02x",
521              mac->a[0], mac->a[1], mac->a[2],
522              mac->a[3], mac->a[4], mac->a[5]);
523 
524     visit_type_str(v, name, &p, errp);
525 }
526 
527 static void set_mac(Object *obj, Visitor *v, const char *name, void *opaque,
528                     Error **errp)
529 {
530     DeviceState *dev = DEVICE(obj);
531     Property *prop = opaque;
532     MACAddr *mac = qdev_get_prop_ptr(dev, prop);
533     Error *local_err = NULL;
534     int i, pos;
535     char *str, *p;
536 
537     if (dev->realized) {
538         qdev_prop_set_after_realize(dev, name, errp);
539         return;
540     }
541 
542     visit_type_str(v, name, &str, &local_err);
543     if (local_err) {
544         error_propagate(errp, local_err);
545         return;
546     }
547 
548     for (i = 0, pos = 0; i < 6; i++, pos += 3) {
549         if (!qemu_isxdigit(str[pos])) {
550             goto inval;
551         }
552         if (!qemu_isxdigit(str[pos+1])) {
553             goto inval;
554         }
555         if (i == 5) {
556             if (str[pos+2] != '\0') {
557                 goto inval;
558             }
559         } else {
560             if (str[pos+2] != ':' && str[pos+2] != '-') {
561                 goto inval;
562             }
563         }
564         mac->a[i] = strtol(str+pos, &p, 16);
565     }
566     g_free(str);
567     return;
568 
569 inval:
570     error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
571     g_free(str);
572 }
573 
574 const PropertyInfo qdev_prop_macaddr = {
575     .name  = "str",
576     .description = "Ethernet 6-byte MAC Address, example: 52:54:00:12:34:56",
577     .get   = get_mac,
578     .set   = set_mac,
579 };
580 
581 /* --- on/off/auto --- */
582 
583 const PropertyInfo qdev_prop_on_off_auto = {
584     .name = "OnOffAuto",
585     .description = "on/off/auto",
586     .enum_table = &OnOffAuto_lookup,
587     .get = get_enum,
588     .set = set_enum,
589     .set_default_value = set_default_value_enum,
590 };
591 
592 /* --- lost tick policy --- */
593 
594 QEMU_BUILD_BUG_ON(sizeof(LostTickPolicy) != sizeof(int));
595 
596 const PropertyInfo qdev_prop_losttickpolicy = {
597     .name  = "LostTickPolicy",
598     .enum_table  = &LostTickPolicy_lookup,
599     .get   = get_enum,
600     .set   = set_enum,
601     .set_default_value = set_default_value_enum,
602 };
603 
604 /* --- Block device error handling policy --- */
605 
606 QEMU_BUILD_BUG_ON(sizeof(BlockdevOnError) != sizeof(int));
607 
608 const PropertyInfo qdev_prop_blockdev_on_error = {
609     .name = "BlockdevOnError",
610     .description = "Error handling policy, "
611                    "report/ignore/enospc/stop/auto",
612     .enum_table = &BlockdevOnError_lookup,
613     .get = get_enum,
614     .set = set_enum,
615     .set_default_value = set_default_value_enum,
616 };
617 
618 /* --- BIOS CHS translation */
619 
620 QEMU_BUILD_BUG_ON(sizeof(BiosAtaTranslation) != sizeof(int));
621 
622 const PropertyInfo qdev_prop_bios_chs_trans = {
623     .name = "BiosAtaTranslation",
624     .description = "Logical CHS translation algorithm, "
625                    "auto/none/lba/large/rechs",
626     .enum_table = &BiosAtaTranslation_lookup,
627     .get = get_enum,
628     .set = set_enum,
629     .set_default_value = set_default_value_enum,
630 };
631 
632 /* --- FDC default drive types */
633 
634 const PropertyInfo qdev_prop_fdc_drive_type = {
635     .name = "FdcDriveType",
636     .description = "FDC drive type, "
637                    "144/288/120/none/auto",
638     .enum_table = &FloppyDriveType_lookup,
639     .get = get_enum,
640     .set = set_enum,
641     .set_default_value = set_default_value_enum,
642 };
643 
644 /* --- pci address --- */
645 
646 /*
647  * bus-local address, i.e. "$slot" or "$slot.$fn"
648  */
649 static void set_pci_devfn(Object *obj, Visitor *v, const char *name,
650                           void *opaque, Error **errp)
651 {
652     DeviceState *dev = DEVICE(obj);
653     Property *prop = opaque;
654     int32_t value, *ptr = qdev_get_prop_ptr(dev, prop);
655     unsigned int slot, fn, n;
656     Error *local_err = NULL;
657     char *str;
658 
659     if (dev->realized) {
660         qdev_prop_set_after_realize(dev, name, errp);
661         return;
662     }
663 
664     visit_type_str(v, name, &str, &local_err);
665     if (local_err) {
666         error_free(local_err);
667         local_err = NULL;
668         visit_type_int32(v, name, &value, &local_err);
669         if (local_err) {
670             error_propagate(errp, local_err);
671         } else if (value < -1 || value > 255) {
672             error_setg(errp, QERR_INVALID_PARAMETER_VALUE,
673                        name ? name : "null", "pci_devfn");
674         } else {
675             *ptr = value;
676         }
677         return;
678     }
679 
680     if (sscanf(str, "%x.%x%n", &slot, &fn, &n) != 2) {
681         fn = 0;
682         if (sscanf(str, "%x%n", &slot, &n) != 1) {
683             goto invalid;
684         }
685     }
686     if (str[n] != '\0' || fn > 7 || slot > 31) {
687         goto invalid;
688     }
689     *ptr = slot << 3 | fn;
690     g_free(str);
691     return;
692 
693 invalid:
694     error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
695     g_free(str);
696 }
697 
698 static int print_pci_devfn(DeviceState *dev, Property *prop, char *dest,
699                            size_t len)
700 {
701     int32_t *ptr = qdev_get_prop_ptr(dev, prop);
702 
703     if (*ptr == -1) {
704         return snprintf(dest, len, "<unset>");
705     } else {
706         return snprintf(dest, len, "%02x.%x", *ptr >> 3, *ptr & 7);
707     }
708 }
709 
710 const PropertyInfo qdev_prop_pci_devfn = {
711     .name  = "int32",
712     .description = "Slot and optional function number, example: 06.0 or 06",
713     .print = print_pci_devfn,
714     .get   = get_int32,
715     .set   = set_pci_devfn,
716     .set_default_value = set_default_value_int,
717 };
718 
719 /* --- blocksize --- */
720 
721 static void set_blocksize(Object *obj, Visitor *v, const char *name,
722                           void *opaque, Error **errp)
723 {
724     DeviceState *dev = DEVICE(obj);
725     Property *prop = opaque;
726     uint16_t value, *ptr = qdev_get_prop_ptr(dev, prop);
727     Error *local_err = NULL;
728     const int64_t min = 512;
729     const int64_t max = 32768;
730 
731     if (dev->realized) {
732         qdev_prop_set_after_realize(dev, name, errp);
733         return;
734     }
735 
736     visit_type_uint16(v, name, &value, &local_err);
737     if (local_err) {
738         error_propagate(errp, local_err);
739         return;
740     }
741     /* value of 0 means "unset" */
742     if (value && (value < min || value > max)) {
743         error_setg(errp, QERR_PROPERTY_VALUE_OUT_OF_RANGE,
744                    dev->id ? : "", name, (int64_t)value, min, max);
745         return;
746     }
747 
748     /* We rely on power-of-2 blocksizes for bitmasks */
749     if ((value & (value - 1)) != 0) {
750         error_setg(errp,
751                   "Property %s.%s doesn't take value '%" PRId64 "', it's not a power of 2",
752                   dev->id ?: "", name, (int64_t)value);
753         return;
754     }
755 
756     *ptr = value;
757 }
758 
759 const PropertyInfo qdev_prop_blocksize = {
760     .name  = "uint16",
761     .description = "A power of two between 512 and 32768",
762     .get   = get_uint16,
763     .set   = set_blocksize,
764     .set_default_value = set_default_value_uint,
765 };
766 
767 /* --- pci host address --- */
768 
769 static void get_pci_host_devaddr(Object *obj, Visitor *v, const char *name,
770                                  void *opaque, Error **errp)
771 {
772     DeviceState *dev = DEVICE(obj);
773     Property *prop = opaque;
774     PCIHostDeviceAddress *addr = qdev_get_prop_ptr(dev, prop);
775     char buffer[] = "ffff:ff:ff.f";
776     char *p = buffer;
777     int rc = 0;
778 
779     /*
780      * Catch "invalid" device reference from vfio-pci and allow the
781      * default buffer representing the non-existent device to be used.
782      */
783     if (~addr->domain || ~addr->bus || ~addr->slot || ~addr->function) {
784         rc = snprintf(buffer, sizeof(buffer), "%04x:%02x:%02x.%0d",
785                       addr->domain, addr->bus, addr->slot, addr->function);
786         assert(rc == sizeof(buffer) - 1);
787     }
788 
789     visit_type_str(v, name, &p, errp);
790 }
791 
792 /*
793  * Parse [<domain>:]<bus>:<slot>.<func>
794  *   if <domain> is not supplied, it's assumed to be 0.
795  */
796 static void set_pci_host_devaddr(Object *obj, Visitor *v, const char *name,
797                                  void *opaque, Error **errp)
798 {
799     DeviceState *dev = DEVICE(obj);
800     Property *prop = opaque;
801     PCIHostDeviceAddress *addr = qdev_get_prop_ptr(dev, prop);
802     Error *local_err = NULL;
803     char *str, *p;
804     char *e;
805     unsigned long val;
806     unsigned long dom = 0, bus = 0;
807     unsigned int slot = 0, func = 0;
808 
809     if (dev->realized) {
810         qdev_prop_set_after_realize(dev, name, errp);
811         return;
812     }
813 
814     visit_type_str(v, name, &str, &local_err);
815     if (local_err) {
816         error_propagate(errp, local_err);
817         return;
818     }
819 
820     p = str;
821     val = strtoul(p, &e, 16);
822     if (e == p || *e != ':') {
823         goto inval;
824     }
825     bus = val;
826 
827     p = e + 1;
828     val = strtoul(p, &e, 16);
829     if (e == p) {
830         goto inval;
831     }
832     if (*e == ':') {
833         dom = bus;
834         bus = val;
835         p = e + 1;
836         val = strtoul(p, &e, 16);
837         if (e == p) {
838             goto inval;
839         }
840     }
841     slot = val;
842 
843     if (*e != '.') {
844         goto inval;
845     }
846     p = e + 1;
847     val = strtoul(p, &e, 10);
848     if (e == p) {
849         goto inval;
850     }
851     func = val;
852 
853     if (dom > 0xffff || bus > 0xff || slot > 0x1f || func > 7) {
854         goto inval;
855     }
856 
857     if (*e) {
858         goto inval;
859     }
860 
861     addr->domain = dom;
862     addr->bus = bus;
863     addr->slot = slot;
864     addr->function = func;
865 
866     g_free(str);
867     return;
868 
869 inval:
870     error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
871     g_free(str);
872 }
873 
874 const PropertyInfo qdev_prop_pci_host_devaddr = {
875     .name = "str",
876     .description = "Address (bus/device/function) of "
877                    "the host device, example: 04:10.0",
878     .get = get_pci_host_devaddr,
879     .set = set_pci_host_devaddr,
880 };
881 
882 /* --- UUID --- */
883 
884 static void get_uuid(Object *obj, Visitor *v, const char *name, void *opaque,
885                      Error **errp)
886 {
887     DeviceState *dev = DEVICE(obj);
888     Property *prop = opaque;
889     QemuUUID *uuid = qdev_get_prop_ptr(dev, prop);
890     char buffer[UUID_FMT_LEN + 1];
891     char *p = buffer;
892 
893     qemu_uuid_unparse(uuid, buffer);
894 
895     visit_type_str(v, name, &p, errp);
896 }
897 
898 #define UUID_VALUE_AUTO        "auto"
899 
900 static void set_uuid(Object *obj, Visitor *v, const char *name, void *opaque,
901                     Error **errp)
902 {
903     DeviceState *dev = DEVICE(obj);
904     Property *prop = opaque;
905     QemuUUID *uuid = qdev_get_prop_ptr(dev, prop);
906     Error *local_err = NULL;
907     char *str;
908 
909     if (dev->realized) {
910         qdev_prop_set_after_realize(dev, name, errp);
911         return;
912     }
913 
914     visit_type_str(v, name, &str, &local_err);
915     if (local_err) {
916         error_propagate(errp, local_err);
917         return;
918     }
919 
920     if (!strcmp(str, UUID_VALUE_AUTO)) {
921         qemu_uuid_generate(uuid);
922     } else if (qemu_uuid_parse(str, uuid) < 0) {
923         error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
924     }
925     g_free(str);
926 }
927 
928 static void set_default_uuid_auto(Object *obj, const Property *prop)
929 {
930     object_property_set_str(obj, UUID_VALUE_AUTO, prop->name, &error_abort);
931 }
932 
933 const PropertyInfo qdev_prop_uuid = {
934     .name  = "str",
935     .description = "UUID (aka GUID) or \"" UUID_VALUE_AUTO
936         "\" for random value (default)",
937     .get   = get_uuid,
938     .set   = set_uuid,
939     .set_default_value = set_default_uuid_auto,
940 };
941 
942 /* --- support for array properties --- */
943 
944 /* Used as an opaque for the object properties we add for each
945  * array element. Note that the struct Property must be first
946  * in the struct so that a pointer to this works as the opaque
947  * for the underlying element's property hooks as well as for
948  * our own release callback.
949  */
950 typedef struct {
951     struct Property prop;
952     char *propname;
953     ObjectPropertyRelease *release;
954 } ArrayElementProperty;
955 
956 /* object property release callback for array element properties:
957  * we call the underlying element's property release hook, and
958  * then free the memory we allocated when we added the property.
959  */
960 static void array_element_release(Object *obj, const char *name, void *opaque)
961 {
962     ArrayElementProperty *p = opaque;
963     if (p->release) {
964         p->release(obj, name, opaque);
965     }
966     g_free(p->propname);
967     g_free(p);
968 }
969 
970 static void set_prop_arraylen(Object *obj, Visitor *v, const char *name,
971                               void *opaque, Error **errp)
972 {
973     /* Setter for the property which defines the length of a
974      * variable-sized property array. As well as actually setting the
975      * array-length field in the device struct, we have to create the
976      * array itself and dynamically add the corresponding properties.
977      */
978     DeviceState *dev = DEVICE(obj);
979     Property *prop = opaque;
980     uint32_t *alenptr = qdev_get_prop_ptr(dev, prop);
981     void **arrayptr = (void *)dev + prop->arrayoffset;
982     Error *local_err = NULL;
983     void *eltptr;
984     const char *arrayname;
985     int i;
986 
987     if (dev->realized) {
988         qdev_prop_set_after_realize(dev, name, errp);
989         return;
990     }
991     if (*alenptr) {
992         error_setg(errp, "array size property %s may not be set more than once",
993                    name);
994         return;
995     }
996     visit_type_uint32(v, name, alenptr, &local_err);
997     if (local_err) {
998         error_propagate(errp, local_err);
999         return;
1000     }
1001     if (!*alenptr) {
1002         return;
1003     }
1004 
1005     /* DEFINE_PROP_ARRAY guarantees that name should start with this prefix;
1006      * strip it off so we can get the name of the array itself.
1007      */
1008     assert(strncmp(name, PROP_ARRAY_LEN_PREFIX,
1009                    strlen(PROP_ARRAY_LEN_PREFIX)) == 0);
1010     arrayname = name + strlen(PROP_ARRAY_LEN_PREFIX);
1011 
1012     /* Note that it is the responsibility of the individual device's deinit
1013      * to free the array proper.
1014      */
1015     *arrayptr = eltptr = g_malloc0(*alenptr * prop->arrayfieldsize);
1016     for (i = 0; i < *alenptr; i++, eltptr += prop->arrayfieldsize) {
1017         char *propname = g_strdup_printf("%s[%d]", arrayname, i);
1018         ArrayElementProperty *arrayprop = g_new0(ArrayElementProperty, 1);
1019         arrayprop->release = prop->arrayinfo->release;
1020         arrayprop->propname = propname;
1021         arrayprop->prop.info = prop->arrayinfo;
1022         arrayprop->prop.name = propname;
1023         /* This ugly piece of pointer arithmetic sets up the offset so
1024          * that when the underlying get/set hooks call qdev_get_prop_ptr
1025          * they get the right answer despite the array element not actually
1026          * being inside the device struct.
1027          */
1028         arrayprop->prop.offset = eltptr - (void *)dev;
1029         assert(qdev_get_prop_ptr(dev, &arrayprop->prop) == eltptr);
1030         object_property_add(obj, propname,
1031                             arrayprop->prop.info->name,
1032                             arrayprop->prop.info->get,
1033                             arrayprop->prop.info->set,
1034                             array_element_release,
1035                             arrayprop, &local_err);
1036         if (local_err) {
1037             error_propagate(errp, local_err);
1038             return;
1039         }
1040     }
1041 }
1042 
1043 const PropertyInfo qdev_prop_arraylen = {
1044     .name = "uint32",
1045     .get = get_uint32,
1046     .set = set_prop_arraylen,
1047     .set_default_value = set_default_value_uint,
1048 };
1049 
1050 /* --- public helpers --- */
1051 
1052 static Property *qdev_prop_walk(Property *props, const char *name)
1053 {
1054     if (!props) {
1055         return NULL;
1056     }
1057     while (props->name) {
1058         if (strcmp(props->name, name) == 0) {
1059             return props;
1060         }
1061         props++;
1062     }
1063     return NULL;
1064 }
1065 
1066 static Property *qdev_prop_find(DeviceState *dev, const char *name)
1067 {
1068     ObjectClass *class;
1069     Property *prop;
1070 
1071     /* device properties */
1072     class = object_get_class(OBJECT(dev));
1073     do {
1074         prop = qdev_prop_walk(DEVICE_CLASS(class)->props, name);
1075         if (prop) {
1076             return prop;
1077         }
1078         class = object_class_get_parent(class);
1079     } while (class != object_class_by_name(TYPE_DEVICE));
1080 
1081     return NULL;
1082 }
1083 
1084 void error_set_from_qdev_prop_error(Error **errp, int ret, DeviceState *dev,
1085                                     Property *prop, const char *value)
1086 {
1087     switch (ret) {
1088     case -EEXIST:
1089         error_setg(errp, "Property '%s.%s' can't take value '%s', it's in use",
1090                   object_get_typename(OBJECT(dev)), prop->name, value);
1091         break;
1092     default:
1093     case -EINVAL:
1094         error_setg(errp, QERR_PROPERTY_VALUE_BAD,
1095                    object_get_typename(OBJECT(dev)), prop->name, value);
1096         break;
1097     case -ENOENT:
1098         error_setg(errp, "Property '%s.%s' can't find value '%s'",
1099                   object_get_typename(OBJECT(dev)), prop->name, value);
1100         break;
1101     case 0:
1102         break;
1103     }
1104 }
1105 
1106 void qdev_prop_set_bit(DeviceState *dev, const char *name, bool value)
1107 {
1108     object_property_set_bool(OBJECT(dev), value, name, &error_abort);
1109 }
1110 
1111 void qdev_prop_set_uint8(DeviceState *dev, const char *name, uint8_t value)
1112 {
1113     object_property_set_int(OBJECT(dev), value, name, &error_abort);
1114 }
1115 
1116 void qdev_prop_set_uint16(DeviceState *dev, const char *name, uint16_t value)
1117 {
1118     object_property_set_int(OBJECT(dev), value, name, &error_abort);
1119 }
1120 
1121 void qdev_prop_set_uint32(DeviceState *dev, const char *name, uint32_t value)
1122 {
1123     object_property_set_int(OBJECT(dev), value, name, &error_abort);
1124 }
1125 
1126 void qdev_prop_set_int32(DeviceState *dev, const char *name, int32_t value)
1127 {
1128     object_property_set_int(OBJECT(dev), value, name, &error_abort);
1129 }
1130 
1131 void qdev_prop_set_uint64(DeviceState *dev, const char *name, uint64_t value)
1132 {
1133     object_property_set_int(OBJECT(dev), value, name, &error_abort);
1134 }
1135 
1136 void qdev_prop_set_string(DeviceState *dev, const char *name, const char *value)
1137 {
1138     object_property_set_str(OBJECT(dev), value, name, &error_abort);
1139 }
1140 
1141 void qdev_prop_set_macaddr(DeviceState *dev, const char *name,
1142                            const uint8_t *value)
1143 {
1144     char str[2 * 6 + 5 + 1];
1145     snprintf(str, sizeof(str), "%02x:%02x:%02x:%02x:%02x:%02x",
1146              value[0], value[1], value[2], value[3], value[4], value[5]);
1147 
1148     object_property_set_str(OBJECT(dev), str, name, &error_abort);
1149 }
1150 
1151 void qdev_prop_set_enum(DeviceState *dev, const char *name, int value)
1152 {
1153     Property *prop;
1154 
1155     prop = qdev_prop_find(dev, name);
1156     object_property_set_str(OBJECT(dev),
1157                             qapi_enum_lookup(prop->info->enum_table, value),
1158                             name, &error_abort);
1159 }
1160 
1161 static GPtrArray *global_props(void)
1162 {
1163     static GPtrArray *gp;
1164 
1165     if (!gp) {
1166         gp = g_ptr_array_new();
1167     }
1168 
1169     return gp;
1170 }
1171 
1172 void qdev_prop_register_global(GlobalProperty *prop)
1173 {
1174     g_ptr_array_add(global_props(), prop);
1175 }
1176 
1177 int qdev_prop_check_globals(void)
1178 {
1179     int i, ret = 0;
1180 
1181     for (i = 0; i < global_props()->len; i++) {
1182         GlobalProperty *prop;
1183         ObjectClass *oc;
1184         DeviceClass *dc;
1185 
1186         prop = g_ptr_array_index(global_props(), i);
1187         if (prop->used) {
1188             continue;
1189         }
1190         oc = object_class_by_name(prop->driver);
1191         oc = object_class_dynamic_cast(oc, TYPE_DEVICE);
1192         if (!oc) {
1193             warn_report("global %s.%s has invalid class name",
1194                         prop->driver, prop->property);
1195             ret = 1;
1196             continue;
1197         }
1198         dc = DEVICE_CLASS(oc);
1199         if (!dc->hotpluggable && !prop->used) {
1200             warn_report("global %s.%s=%s not used",
1201                         prop->driver, prop->property, prop->value);
1202             ret = 1;
1203             continue;
1204         }
1205     }
1206     return ret;
1207 }
1208 
1209 void qdev_prop_set_globals(DeviceState *dev)
1210 {
1211     object_apply_global_props(OBJECT(dev), global_props(),
1212                               dev->hotplugged ? NULL : &error_fatal);
1213 }
1214 
1215 /* --- 64bit unsigned int 'size' type --- */
1216 
1217 static void get_size(Object *obj, Visitor *v, const char *name, void *opaque,
1218                      Error **errp)
1219 {
1220     DeviceState *dev = DEVICE(obj);
1221     Property *prop = opaque;
1222     uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
1223 
1224     visit_type_size(v, name, ptr, errp);
1225 }
1226 
1227 static void set_size(Object *obj, Visitor *v, const char *name, void *opaque,
1228                      Error **errp)
1229 {
1230     DeviceState *dev = DEVICE(obj);
1231     Property *prop = opaque;
1232     uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
1233 
1234     visit_type_size(v, name, ptr, errp);
1235 }
1236 
1237 const PropertyInfo qdev_prop_size = {
1238     .name  = "size",
1239     .get = get_size,
1240     .set = set_size,
1241     .set_default_value = set_default_value_uint,
1242 };
1243 
1244 /* --- object link property --- */
1245 
1246 static void create_link_property(Object *obj, Property *prop, Error **errp)
1247 {
1248     Object **child = qdev_get_prop_ptr(DEVICE(obj), prop);
1249 
1250     object_property_add_link(obj, prop->name, prop->link_type,
1251                              child,
1252                              qdev_prop_allow_set_link_before_realize,
1253                              OBJ_PROP_LINK_STRONG,
1254                              errp);
1255 }
1256 
1257 const PropertyInfo qdev_prop_link = {
1258     .name = "link",
1259     .create = create_link_property,
1260 };
1261 
1262 /* --- OffAutoPCIBAR off/auto/bar0/bar1/bar2/bar3/bar4/bar5 --- */
1263 
1264 const PropertyInfo qdev_prop_off_auto_pcibar = {
1265     .name = "OffAutoPCIBAR",
1266     .description = "off/auto/bar0/bar1/bar2/bar3/bar4/bar5",
1267     .enum_table = &OffAutoPCIBAR_lookup,
1268     .get = get_enum,
1269     .set = set_enum,
1270     .set_default_value = set_default_value_enum,
1271 };
1272 
1273 /* --- PCIELinkSpeed 2_5/5/8/16 -- */
1274 
1275 static void get_prop_pcielinkspeed(Object *obj, Visitor *v, const char *name,
1276                                    void *opaque, Error **errp)
1277 {
1278     DeviceState *dev = DEVICE(obj);
1279     Property *prop = opaque;
1280     PCIExpLinkSpeed *p = qdev_get_prop_ptr(dev, prop);
1281     int speed;
1282 
1283     switch (*p) {
1284     case QEMU_PCI_EXP_LNK_2_5GT:
1285         speed = PCIE_LINK_SPEED_2_5;
1286         break;
1287     case QEMU_PCI_EXP_LNK_5GT:
1288         speed = PCIE_LINK_SPEED_5;
1289         break;
1290     case QEMU_PCI_EXP_LNK_8GT:
1291         speed = PCIE_LINK_SPEED_8;
1292         break;
1293     case QEMU_PCI_EXP_LNK_16GT:
1294         speed = PCIE_LINK_SPEED_16;
1295         break;
1296     default:
1297         /* Unreachable */
1298         abort();
1299     }
1300 
1301     visit_type_enum(v, prop->name, &speed, prop->info->enum_table, errp);
1302 }
1303 
1304 static void set_prop_pcielinkspeed(Object *obj, Visitor *v, const char *name,
1305                                    void *opaque, Error **errp)
1306 {
1307     DeviceState *dev = DEVICE(obj);
1308     Property *prop = opaque;
1309     PCIExpLinkSpeed *p = qdev_get_prop_ptr(dev, prop);
1310     int speed;
1311     Error *local_err = NULL;
1312 
1313     if (dev->realized) {
1314         qdev_prop_set_after_realize(dev, name, errp);
1315         return;
1316     }
1317 
1318     visit_type_enum(v, prop->name, &speed, prop->info->enum_table, &local_err);
1319     if (local_err) {
1320         error_propagate(errp, local_err);
1321         return;
1322     }
1323 
1324     switch (speed) {
1325     case PCIE_LINK_SPEED_2_5:
1326         *p = QEMU_PCI_EXP_LNK_2_5GT;
1327         break;
1328     case PCIE_LINK_SPEED_5:
1329         *p = QEMU_PCI_EXP_LNK_5GT;
1330         break;
1331     case PCIE_LINK_SPEED_8:
1332         *p = QEMU_PCI_EXP_LNK_8GT;
1333         break;
1334     case PCIE_LINK_SPEED_16:
1335         *p = QEMU_PCI_EXP_LNK_16GT;
1336         break;
1337     default:
1338         /* Unreachable */
1339         abort();
1340     }
1341 }
1342 
1343 const PropertyInfo qdev_prop_pcie_link_speed = {
1344     .name = "PCIELinkSpeed",
1345     .description = "2_5/5/8/16",
1346     .enum_table = &PCIELinkSpeed_lookup,
1347     .get = get_prop_pcielinkspeed,
1348     .set = set_prop_pcielinkspeed,
1349     .set_default_value = set_default_value_enum,
1350 };
1351 
1352 /* --- PCIELinkWidth 1/2/4/8/12/16/32 -- */
1353 
1354 static void get_prop_pcielinkwidth(Object *obj, Visitor *v, const char *name,
1355                                    void *opaque, Error **errp)
1356 {
1357     DeviceState *dev = DEVICE(obj);
1358     Property *prop = opaque;
1359     PCIExpLinkWidth *p = qdev_get_prop_ptr(dev, prop);
1360     int width;
1361 
1362     switch (*p) {
1363     case QEMU_PCI_EXP_LNK_X1:
1364         width = PCIE_LINK_WIDTH_1;
1365         break;
1366     case QEMU_PCI_EXP_LNK_X2:
1367         width = PCIE_LINK_WIDTH_2;
1368         break;
1369     case QEMU_PCI_EXP_LNK_X4:
1370         width = PCIE_LINK_WIDTH_4;
1371         break;
1372     case QEMU_PCI_EXP_LNK_X8:
1373         width = PCIE_LINK_WIDTH_8;
1374         break;
1375     case QEMU_PCI_EXP_LNK_X12:
1376         width = PCIE_LINK_WIDTH_12;
1377         break;
1378     case QEMU_PCI_EXP_LNK_X16:
1379         width = PCIE_LINK_WIDTH_16;
1380         break;
1381     case QEMU_PCI_EXP_LNK_X32:
1382         width = PCIE_LINK_WIDTH_32;
1383         break;
1384     default:
1385         /* Unreachable */
1386         abort();
1387     }
1388 
1389     visit_type_enum(v, prop->name, &width, prop->info->enum_table, errp);
1390 }
1391 
1392 static void set_prop_pcielinkwidth(Object *obj, Visitor *v, const char *name,
1393                                    void *opaque, Error **errp)
1394 {
1395     DeviceState *dev = DEVICE(obj);
1396     Property *prop = opaque;
1397     PCIExpLinkWidth *p = qdev_get_prop_ptr(dev, prop);
1398     int width;
1399     Error *local_err = NULL;
1400 
1401     if (dev->realized) {
1402         qdev_prop_set_after_realize(dev, name, errp);
1403         return;
1404     }
1405 
1406     visit_type_enum(v, prop->name, &width, prop->info->enum_table, &local_err);
1407     if (local_err) {
1408         error_propagate(errp, local_err);
1409         return;
1410     }
1411 
1412     switch (width) {
1413     case PCIE_LINK_WIDTH_1:
1414         *p = QEMU_PCI_EXP_LNK_X1;
1415         break;
1416     case PCIE_LINK_WIDTH_2:
1417         *p = QEMU_PCI_EXP_LNK_X2;
1418         break;
1419     case PCIE_LINK_WIDTH_4:
1420         *p = QEMU_PCI_EXP_LNK_X4;
1421         break;
1422     case PCIE_LINK_WIDTH_8:
1423         *p = QEMU_PCI_EXP_LNK_X8;
1424         break;
1425     case PCIE_LINK_WIDTH_12:
1426         *p = QEMU_PCI_EXP_LNK_X12;
1427         break;
1428     case PCIE_LINK_WIDTH_16:
1429         *p = QEMU_PCI_EXP_LNK_X16;
1430         break;
1431     case PCIE_LINK_WIDTH_32:
1432         *p = QEMU_PCI_EXP_LNK_X32;
1433         break;
1434     default:
1435         /* Unreachable */
1436         abort();
1437     }
1438 }
1439 
1440 const PropertyInfo qdev_prop_pcie_link_width = {
1441     .name = "PCIELinkWidth",
1442     .description = "1/2/4/8/12/16/32",
1443     .enum_table = &PCIELinkWidth_lookup,
1444     .get = get_prop_pcielinkwidth,
1445     .set = set_prop_pcielinkwidth,
1446     .set_default_value = set_default_value_enum,
1447 };
1448