1 #include "qemu/osdep.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"
13 #include "qapi/visitor.h"
14 #include "chardev/char.h"
15 #include "qemu/uuid.h"
17 void qdev_prop_set_after_realize(DeviceState
*dev
, const char *name
,
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
)));
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
)));
31 void qdev_prop_allow_set_link_before_realize(const Object
*obj
,
33 Object
*val
, Error
**errp
)
35 DeviceState
*dev
= DEVICE(obj
);
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
));
44 void *qdev_get_prop_ptr(DeviceState
*dev
, Property
*prop
)
51 static void get_enum(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
54 DeviceState
*dev
= DEVICE(obj
);
55 Property
*prop
= opaque
;
56 int *ptr
= qdev_get_prop_ptr(dev
, prop
);
58 visit_type_enum(v
, prop
->name
, ptr
, prop
->info
->enum_table
, errp
);
61 static void set_enum(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
64 DeviceState
*dev
= DEVICE(obj
);
65 Property
*prop
= opaque
;
66 int *ptr
= qdev_get_prop_ptr(dev
, prop
);
69 qdev_prop_set_after_realize(dev
, name
, errp
);
73 visit_type_enum(v
, prop
->name
, ptr
, prop
->info
->enum_table
, errp
);
76 static void set_default_value_enum(Object
*obj
, const Property
*prop
)
78 object_property_set_str(obj
,
79 qapi_enum_lookup(prop
->info
->enum_table
,
81 prop
->name
, &error_abort
);
86 static uint32_t qdev_get_prop_mask(Property
*prop
)
88 assert(prop
->info
== &qdev_prop_bit
);
89 return 0x1 << prop
->bitnr
;
92 static void bit_prop_set(DeviceState
*dev
, Property
*props
, bool val
)
94 uint32_t *p
= qdev_get_prop_ptr(dev
, props
);
95 uint32_t mask
= qdev_get_prop_mask(props
);
103 static void prop_get_bit(Object
*obj
, Visitor
*v
, const char *name
,
104 void *opaque
, Error
**errp
)
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;
111 visit_type_bool(v
, name
, &value
, errp
);
114 static void prop_set_bit(Object
*obj
, Visitor
*v
, const char *name
,
115 void *opaque
, Error
**errp
)
117 DeviceState
*dev
= DEVICE(obj
);
118 Property
*prop
= opaque
;
119 Error
*local_err
= NULL
;
123 qdev_prop_set_after_realize(dev
, name
, errp
);
127 visit_type_bool(v
, name
, &value
, &local_err
);
129 error_propagate(errp
, local_err
);
132 bit_prop_set(dev
, prop
, value
);
135 static void set_default_value_bool(Object
*obj
, const Property
*prop
)
137 object_property_set_bool(obj
, prop
->defval
.u
, prop
->name
, &error_abort
);
140 const PropertyInfo qdev_prop_bit
= {
142 .description
= "on/off",
145 .set_default_value
= set_default_value_bool
,
150 static uint64_t qdev_get_prop_mask64(Property
*prop
)
152 assert(prop
->info
== &qdev_prop_bit64
);
153 return 0x1ull
<< prop
->bitnr
;
156 static void bit64_prop_set(DeviceState
*dev
, Property
*props
, bool val
)
158 uint64_t *p
= qdev_get_prop_ptr(dev
, props
);
159 uint64_t mask
= qdev_get_prop_mask64(props
);
167 static void prop_get_bit64(Object
*obj
, Visitor
*v
, const char *name
,
168 void *opaque
, Error
**errp
)
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;
175 visit_type_bool(v
, name
, &value
, errp
);
178 static void prop_set_bit64(Object
*obj
, Visitor
*v
, const char *name
,
179 void *opaque
, Error
**errp
)
181 DeviceState
*dev
= DEVICE(obj
);
182 Property
*prop
= opaque
;
183 Error
*local_err
= NULL
;
187 qdev_prop_set_after_realize(dev
, name
, errp
);
191 visit_type_bool(v
, name
, &value
, &local_err
);
193 error_propagate(errp
, local_err
);
196 bit64_prop_set(dev
, prop
, value
);
199 const PropertyInfo qdev_prop_bit64
= {
201 .description
= "on/off",
202 .get
= prop_get_bit64
,
203 .set
= prop_set_bit64
,
204 .set_default_value
= set_default_value_bool
,
209 static void get_bool(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
212 DeviceState
*dev
= DEVICE(obj
);
213 Property
*prop
= opaque
;
214 bool *ptr
= qdev_get_prop_ptr(dev
, prop
);
216 visit_type_bool(v
, name
, ptr
, errp
);
219 static void set_bool(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
222 DeviceState
*dev
= DEVICE(obj
);
223 Property
*prop
= opaque
;
224 bool *ptr
= qdev_get_prop_ptr(dev
, prop
);
227 qdev_prop_set_after_realize(dev
, name
, errp
);
231 visit_type_bool(v
, name
, ptr
, errp
);
234 const PropertyInfo qdev_prop_bool
= {
238 .set_default_value
= set_default_value_bool
,
241 /* --- 8bit integer --- */
243 static void get_uint8(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
246 DeviceState
*dev
= DEVICE(obj
);
247 Property
*prop
= opaque
;
248 uint8_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
250 visit_type_uint8(v
, name
, ptr
, errp
);
253 static void set_uint8(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
256 DeviceState
*dev
= DEVICE(obj
);
257 Property
*prop
= opaque
;
258 uint8_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
261 qdev_prop_set_after_realize(dev
, name
, errp
);
265 visit_type_uint8(v
, name
, ptr
, errp
);
268 static void set_default_value_int(Object
*obj
, const Property
*prop
)
270 object_property_set_int(obj
, prop
->defval
.i
, prop
->name
, &error_abort
);
273 static void set_default_value_uint(Object
*obj
, const Property
*prop
)
275 object_property_set_uint(obj
, prop
->defval
.u
, prop
->name
, &error_abort
);
278 const PropertyInfo qdev_prop_uint8
= {
282 .set_default_value
= set_default_value_uint
,
285 /* --- 16bit integer --- */
287 static void get_uint16(Object
*obj
, Visitor
*v
, const char *name
,
288 void *opaque
, Error
**errp
)
290 DeviceState
*dev
= DEVICE(obj
);
291 Property
*prop
= opaque
;
292 uint16_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
294 visit_type_uint16(v
, name
, ptr
, errp
);
297 static void set_uint16(Object
*obj
, Visitor
*v
, const char *name
,
298 void *opaque
, Error
**errp
)
300 DeviceState
*dev
= DEVICE(obj
);
301 Property
*prop
= opaque
;
302 uint16_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
305 qdev_prop_set_after_realize(dev
, name
, errp
);
309 visit_type_uint16(v
, name
, ptr
, errp
);
312 const PropertyInfo qdev_prop_uint16
= {
316 .set_default_value
= set_default_value_uint
,
319 /* --- 32bit integer --- */
321 static void get_uint32(Object
*obj
, Visitor
*v
, const char *name
,
322 void *opaque
, Error
**errp
)
324 DeviceState
*dev
= DEVICE(obj
);
325 Property
*prop
= opaque
;
326 uint32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
328 visit_type_uint32(v
, name
, ptr
, errp
);
331 static void set_uint32(Object
*obj
, Visitor
*v
, const char *name
,
332 void *opaque
, Error
**errp
)
334 DeviceState
*dev
= DEVICE(obj
);
335 Property
*prop
= opaque
;
336 uint32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
339 qdev_prop_set_after_realize(dev
, name
, errp
);
343 visit_type_uint32(v
, name
, ptr
, errp
);
346 static void get_int32(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
349 DeviceState
*dev
= DEVICE(obj
);
350 Property
*prop
= opaque
;
351 int32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
353 visit_type_int32(v
, name
, ptr
, errp
);
356 static void set_int32(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
359 DeviceState
*dev
= DEVICE(obj
);
360 Property
*prop
= opaque
;
361 int32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
364 qdev_prop_set_after_realize(dev
, name
, errp
);
368 visit_type_int32(v
, name
, ptr
, errp
);
371 const PropertyInfo qdev_prop_uint32
= {
375 .set_default_value
= set_default_value_uint
,
378 const PropertyInfo qdev_prop_int32
= {
382 .set_default_value
= set_default_value_int
,
385 /* --- 64bit integer --- */
387 static void get_uint64(Object
*obj
, Visitor
*v
, const char *name
,
388 void *opaque
, Error
**errp
)
390 DeviceState
*dev
= DEVICE(obj
);
391 Property
*prop
= opaque
;
392 uint64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
394 visit_type_uint64(v
, name
, ptr
, errp
);
397 static void set_uint64(Object
*obj
, Visitor
*v
, const char *name
,
398 void *opaque
, Error
**errp
)
400 DeviceState
*dev
= DEVICE(obj
);
401 Property
*prop
= opaque
;
402 uint64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
405 qdev_prop_set_after_realize(dev
, name
, errp
);
409 visit_type_uint64(v
, name
, ptr
, errp
);
412 static void get_int64(Object
*obj
, Visitor
*v
, const char *name
,
413 void *opaque
, Error
**errp
)
415 DeviceState
*dev
= DEVICE(obj
);
416 Property
*prop
= opaque
;
417 int64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
419 visit_type_int64(v
, name
, ptr
, errp
);
422 static void set_int64(Object
*obj
, Visitor
*v
, const char *name
,
423 void *opaque
, Error
**errp
)
425 DeviceState
*dev
= DEVICE(obj
);
426 Property
*prop
= opaque
;
427 int64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
430 qdev_prop_set_after_realize(dev
, name
, errp
);
434 visit_type_int64(v
, name
, ptr
, errp
);
437 const PropertyInfo qdev_prop_uint64
= {
441 .set_default_value
= set_default_value_uint
,
444 const PropertyInfo qdev_prop_int64
= {
448 .set_default_value
= set_default_value_int
,
453 static void release_string(Object
*obj
, const char *name
, void *opaque
)
455 Property
*prop
= opaque
;
456 g_free(*(char **)qdev_get_prop_ptr(DEVICE(obj
), prop
));
459 static void get_string(Object
*obj
, Visitor
*v
, const char *name
,
460 void *opaque
, Error
**errp
)
462 DeviceState
*dev
= DEVICE(obj
);
463 Property
*prop
= opaque
;
464 char **ptr
= qdev_get_prop_ptr(dev
, prop
);
467 char *str
= (char *)"";
468 visit_type_str(v
, name
, &str
, errp
);
470 visit_type_str(v
, name
, ptr
, errp
);
474 static void set_string(Object
*obj
, Visitor
*v
, const char *name
,
475 void *opaque
, Error
**errp
)
477 DeviceState
*dev
= DEVICE(obj
);
478 Property
*prop
= opaque
;
479 char **ptr
= qdev_get_prop_ptr(dev
, prop
);
480 Error
*local_err
= NULL
;
484 qdev_prop_set_after_realize(dev
, name
, errp
);
488 visit_type_str(v
, name
, &str
, &local_err
);
490 error_propagate(errp
, local_err
);
497 const PropertyInfo qdev_prop_string
= {
499 .release
= release_string
,
504 /* --- mac address --- */
507 * accepted syntax versions:
511 static void get_mac(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
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];
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]);
524 visit_type_str(v
, name
, &p
, errp
);
527 static void set_mac(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
530 DeviceState
*dev
= DEVICE(obj
);
531 Property
*prop
= opaque
;
532 MACAddr
*mac
= qdev_get_prop_ptr(dev
, prop
);
533 Error
*local_err
= NULL
;
538 qdev_prop_set_after_realize(dev
, name
, errp
);
542 visit_type_str(v
, name
, &str
, &local_err
);
544 error_propagate(errp
, local_err
);
548 for (i
= 0, pos
= 0; i
< 6; i
++, pos
+= 3) {
549 if (!qemu_isxdigit(str
[pos
])) {
552 if (!qemu_isxdigit(str
[pos
+1])) {
556 if (str
[pos
+2] != '\0') {
560 if (str
[pos
+2] != ':' && str
[pos
+2] != '-') {
564 mac
->a
[i
] = strtol(str
+pos
, &p
, 16);
570 error_set_from_qdev_prop_error(errp
, EINVAL
, dev
, prop
, str
);
574 const PropertyInfo qdev_prop_macaddr
= {
576 .description
= "Ethernet 6-byte MAC Address, example: 52:54:00:12:34:56",
581 /* --- on/off/auto --- */
583 const PropertyInfo qdev_prop_on_off_auto
= {
585 .description
= "on/off/auto",
586 .enum_table
= &OnOffAuto_lookup
,
589 .set_default_value
= set_default_value_enum
,
592 /* --- lost tick policy --- */
594 QEMU_BUILD_BUG_ON(sizeof(LostTickPolicy
) != sizeof(int));
596 const PropertyInfo qdev_prop_losttickpolicy
= {
597 .name
= "LostTickPolicy",
598 .enum_table
= &LostTickPolicy_lookup
,
601 .set_default_value
= set_default_value_enum
,
604 /* --- Block device error handling policy --- */
606 QEMU_BUILD_BUG_ON(sizeof(BlockdevOnError
) != sizeof(int));
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
,
615 .set_default_value
= set_default_value_enum
,
618 /* --- BIOS CHS translation */
620 QEMU_BUILD_BUG_ON(sizeof(BiosAtaTranslation
) != sizeof(int));
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
,
629 .set_default_value
= set_default_value_enum
,
632 /* --- FDC default drive types */
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
,
641 .set_default_value
= set_default_value_enum
,
644 /* --- pci address --- */
647 * bus-local address, i.e. "$slot" or "$slot.$fn"
649 static void set_pci_devfn(Object
*obj
, Visitor
*v
, const char *name
,
650 void *opaque
, Error
**errp
)
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
;
660 qdev_prop_set_after_realize(dev
, name
, errp
);
664 visit_type_str(v
, name
, &str
, &local_err
);
666 error_free(local_err
);
668 visit_type_int32(v
, name
, &value
, &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");
680 if (sscanf(str
, "%x.%x%n", &slot
, &fn
, &n
) != 2) {
682 if (sscanf(str
, "%x%n", &slot
, &n
) != 1) {
686 if (str
[n
] != '\0' || fn
> 7 || slot
> 31) {
689 *ptr
= slot
<< 3 | fn
;
694 error_set_from_qdev_prop_error(errp
, EINVAL
, dev
, prop
, str
);
698 static int print_pci_devfn(DeviceState
*dev
, Property
*prop
, char *dest
,
701 int32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
704 return snprintf(dest
, len
, "<unset>");
706 return snprintf(dest
, len
, "%02x.%x", *ptr
>> 3, *ptr
& 7);
710 const PropertyInfo qdev_prop_pci_devfn
= {
712 .description
= "Slot and optional function number, example: 06.0 or 06",
713 .print
= print_pci_devfn
,
715 .set
= set_pci_devfn
,
716 .set_default_value
= set_default_value_int
,
719 /* --- blocksize --- */
721 static void set_blocksize(Object
*obj
, Visitor
*v
, const char *name
,
722 void *opaque
, Error
**errp
)
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;
732 qdev_prop_set_after_realize(dev
, name
, errp
);
736 visit_type_uint16(v
, name
, &value
, &local_err
);
738 error_propagate(errp
, local_err
);
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
);
748 /* We rely on power-of-2 blocksizes for bitmasks */
749 if ((value
& (value
- 1)) != 0) {
751 "Property %s.%s doesn't take value '%" PRId64
"', it's not a power of 2",
752 dev
->id
?: "", name
, (int64_t)value
);
759 const PropertyInfo qdev_prop_blocksize
= {
761 .description
= "A power of two between 512 and 32768",
763 .set
= set_blocksize
,
764 .set_default_value
= set_default_value_uint
,
767 /* --- pci host address --- */
769 static void get_pci_host_devaddr(Object
*obj
, Visitor
*v
, const char *name
,
770 void *opaque
, Error
**errp
)
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";
780 * Catch "invalid" device reference from vfio-pci and allow the
781 * default buffer representing the non-existent device to be used.
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);
789 visit_type_str(v
, name
, &p
, errp
);
793 * Parse [<domain>:]<bus>:<slot>.<func>
794 * if <domain> is not supplied, it's assumed to be 0.
796 static void set_pci_host_devaddr(Object
*obj
, Visitor
*v
, const char *name
,
797 void *opaque
, Error
**errp
)
799 DeviceState
*dev
= DEVICE(obj
);
800 Property
*prop
= opaque
;
801 PCIHostDeviceAddress
*addr
= qdev_get_prop_ptr(dev
, prop
);
802 Error
*local_err
= NULL
;
806 unsigned long dom
= 0, bus
= 0;
807 unsigned int slot
= 0, func
= 0;
810 qdev_prop_set_after_realize(dev
, name
, errp
);
814 visit_type_str(v
, name
, &str
, &local_err
);
816 error_propagate(errp
, local_err
);
821 val
= strtoul(p
, &e
, 16);
822 if (e
== p
|| *e
!= ':') {
828 val
= strtoul(p
, &e
, 16);
836 val
= strtoul(p
, &e
, 16);
847 val
= strtoul(p
, &e
, 10);
853 if (dom
> 0xffff || bus
> 0xff || slot
> 0x1f || func
> 7) {
864 addr
->function
= func
;
870 error_set_from_qdev_prop_error(errp
, EINVAL
, dev
, prop
, str
);
874 const PropertyInfo qdev_prop_pci_host_devaddr
= {
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
,
884 static void get_uuid(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
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];
893 qemu_uuid_unparse(uuid
, buffer
);
895 visit_type_str(v
, name
, &p
, errp
);
898 #define UUID_VALUE_AUTO "auto"
900 static void set_uuid(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
903 DeviceState
*dev
= DEVICE(obj
);
904 Property
*prop
= opaque
;
905 QemuUUID
*uuid
= qdev_get_prop_ptr(dev
, prop
);
906 Error
*local_err
= NULL
;
910 qdev_prop_set_after_realize(dev
, name
, errp
);
914 visit_type_str(v
, name
, &str
, &local_err
);
916 error_propagate(errp
, local_err
);
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
);
928 static void set_default_uuid_auto(Object
*obj
, const Property
*prop
)
930 object_property_set_str(obj
, UUID_VALUE_AUTO
, prop
->name
, &error_abort
);
933 const PropertyInfo qdev_prop_uuid
= {
935 .description
= "UUID (aka GUID) or \"" UUID_VALUE_AUTO
936 "\" for random value (default)",
939 .set_default_value
= set_default_uuid_auto
,
942 /* --- support for array properties --- */
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.
951 struct Property prop
;
953 ObjectPropertyRelease
*release
;
954 } ArrayElementProperty
;
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.
960 static void array_element_release(Object
*obj
, const char *name
, void *opaque
)
962 ArrayElementProperty
*p
= opaque
;
964 p
->release(obj
, name
, opaque
);
970 static void set_prop_arraylen(Object
*obj
, Visitor
*v
, const char *name
,
971 void *opaque
, Error
**errp
)
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.
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
;
984 const char *arrayname
;
988 qdev_prop_set_after_realize(dev
, name
, errp
);
992 error_setg(errp
, "array size property %s may not be set more than once",
996 visit_type_uint32(v
, name
, alenptr
, &local_err
);
998 error_propagate(errp
, local_err
);
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.
1008 assert(strncmp(name
, PROP_ARRAY_LEN_PREFIX
,
1009 strlen(PROP_ARRAY_LEN_PREFIX
)) == 0);
1010 arrayname
= name
+ strlen(PROP_ARRAY_LEN_PREFIX
);
1012 /* Note that it is the responsibility of the individual device's deinit
1013 * to free the array proper.
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.
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
);
1037 error_propagate(errp
, local_err
);
1043 const PropertyInfo qdev_prop_arraylen
= {
1046 .set
= set_prop_arraylen
,
1047 .set_default_value
= set_default_value_uint
,
1050 /* --- public helpers --- */
1052 static Property
*qdev_prop_walk(Property
*props
, const char *name
)
1057 while (props
->name
) {
1058 if (strcmp(props
->name
, name
) == 0) {
1066 static Property
*qdev_prop_find(DeviceState
*dev
, const char *name
)
1071 /* device properties */
1072 class = object_get_class(OBJECT(dev
));
1074 prop
= qdev_prop_walk(DEVICE_CLASS(class)->props
, name
);
1078 class = object_class_get_parent(class);
1079 } while (class != object_class_by_name(TYPE_DEVICE
));
1084 void error_set_from_qdev_prop_error(Error
**errp
, int ret
, DeviceState
*dev
,
1085 Property
*prop
, const char *value
)
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
);
1094 error_setg(errp
, QERR_PROPERTY_VALUE_BAD
,
1095 object_get_typename(OBJECT(dev
)), prop
->name
, value
);
1098 error_setg(errp
, "Property '%s.%s' can't find value '%s'",
1099 object_get_typename(OBJECT(dev
)), prop
->name
, value
);
1106 void qdev_prop_set_bit(DeviceState
*dev
, const char *name
, bool value
)
1108 object_property_set_bool(OBJECT(dev
), value
, name
, &error_abort
);
1111 void qdev_prop_set_uint8(DeviceState
*dev
, const char *name
, uint8_t value
)
1113 object_property_set_int(OBJECT(dev
), value
, name
, &error_abort
);
1116 void qdev_prop_set_uint16(DeviceState
*dev
, const char *name
, uint16_t value
)
1118 object_property_set_int(OBJECT(dev
), value
, name
, &error_abort
);
1121 void qdev_prop_set_uint32(DeviceState
*dev
, const char *name
, uint32_t value
)
1123 object_property_set_int(OBJECT(dev
), value
, name
, &error_abort
);
1126 void qdev_prop_set_int32(DeviceState
*dev
, const char *name
, int32_t value
)
1128 object_property_set_int(OBJECT(dev
), value
, name
, &error_abort
);
1131 void qdev_prop_set_uint64(DeviceState
*dev
, const char *name
, uint64_t value
)
1133 object_property_set_int(OBJECT(dev
), value
, name
, &error_abort
);
1136 void qdev_prop_set_string(DeviceState
*dev
, const char *name
, const char *value
)
1138 object_property_set_str(OBJECT(dev
), value
, name
, &error_abort
);
1141 void qdev_prop_set_macaddr(DeviceState
*dev
, const char *name
,
1142 const uint8_t *value
)
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]);
1148 object_property_set_str(OBJECT(dev
), str
, name
, &error_abort
);
1151 void qdev_prop_set_enum(DeviceState
*dev
, const char *name
, int value
)
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
);
1161 static GPtrArray
*global_props(void)
1163 static GPtrArray
*gp
;
1166 gp
= g_ptr_array_new();
1172 void qdev_prop_register_global(GlobalProperty
*prop
)
1174 g_ptr_array_add(global_props(), prop
);
1177 int qdev_prop_check_globals(void)
1181 for (i
= 0; i
< global_props()->len
; i
++) {
1182 GlobalProperty
*prop
;
1186 prop
= g_ptr_array_index(global_props(), i
);
1190 oc
= object_class_by_name(prop
->driver
);
1191 oc
= object_class_dynamic_cast(oc
, TYPE_DEVICE
);
1193 warn_report("global %s.%s has invalid class name",
1194 prop
->driver
, prop
->property
);
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
);
1209 void qdev_prop_set_globals(DeviceState
*dev
)
1211 object_apply_global_props(OBJECT(dev
), global_props(),
1212 dev
->hotplugged
? NULL
: &error_fatal
);
1215 /* --- 64bit unsigned int 'size' type --- */
1217 static void get_size(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
1220 DeviceState
*dev
= DEVICE(obj
);
1221 Property
*prop
= opaque
;
1222 uint64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
1224 visit_type_size(v
, name
, ptr
, errp
);
1227 static void set_size(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
1230 DeviceState
*dev
= DEVICE(obj
);
1231 Property
*prop
= opaque
;
1232 uint64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
1234 visit_type_size(v
, name
, ptr
, errp
);
1237 const PropertyInfo qdev_prop_size
= {
1241 .set_default_value
= set_default_value_uint
,
1244 /* --- object link property --- */
1246 static void create_link_property(Object
*obj
, Property
*prop
, Error
**errp
)
1248 Object
**child
= qdev_get_prop_ptr(DEVICE(obj
), prop
);
1250 object_property_add_link(obj
, prop
->name
, prop
->link_type
,
1252 qdev_prop_allow_set_link_before_realize
,
1253 OBJ_PROP_LINK_STRONG
,
1257 const PropertyInfo qdev_prop_link
= {
1259 .create
= create_link_property
,
1262 /* --- OffAutoPCIBAR off/auto/bar0/bar1/bar2/bar3/bar4/bar5 --- */
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
,
1270 .set_default_value
= set_default_value_enum
,
1273 /* --- PCIELinkSpeed 2_5/5/8/16 -- */
1275 static void get_prop_pcielinkspeed(Object
*obj
, Visitor
*v
, const char *name
,
1276 void *opaque
, Error
**errp
)
1278 DeviceState
*dev
= DEVICE(obj
);
1279 Property
*prop
= opaque
;
1280 PCIExpLinkSpeed
*p
= qdev_get_prop_ptr(dev
, prop
);
1284 case QEMU_PCI_EXP_LNK_2_5GT
:
1285 speed
= PCIE_LINK_SPEED_2_5
;
1287 case QEMU_PCI_EXP_LNK_5GT
:
1288 speed
= PCIE_LINK_SPEED_5
;
1290 case QEMU_PCI_EXP_LNK_8GT
:
1291 speed
= PCIE_LINK_SPEED_8
;
1293 case QEMU_PCI_EXP_LNK_16GT
:
1294 speed
= PCIE_LINK_SPEED_16
;
1301 visit_type_enum(v
, prop
->name
, &speed
, prop
->info
->enum_table
, errp
);
1304 static void set_prop_pcielinkspeed(Object
*obj
, Visitor
*v
, const char *name
,
1305 void *opaque
, Error
**errp
)
1307 DeviceState
*dev
= DEVICE(obj
);
1308 Property
*prop
= opaque
;
1309 PCIExpLinkSpeed
*p
= qdev_get_prop_ptr(dev
, prop
);
1311 Error
*local_err
= NULL
;
1313 if (dev
->realized
) {
1314 qdev_prop_set_after_realize(dev
, name
, errp
);
1318 visit_type_enum(v
, prop
->name
, &speed
, prop
->info
->enum_table
, &local_err
);
1320 error_propagate(errp
, local_err
);
1325 case PCIE_LINK_SPEED_2_5
:
1326 *p
= QEMU_PCI_EXP_LNK_2_5GT
;
1328 case PCIE_LINK_SPEED_5
:
1329 *p
= QEMU_PCI_EXP_LNK_5GT
;
1331 case PCIE_LINK_SPEED_8
:
1332 *p
= QEMU_PCI_EXP_LNK_8GT
;
1334 case PCIE_LINK_SPEED_16
:
1335 *p
= QEMU_PCI_EXP_LNK_16GT
;
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
,
1352 /* --- PCIELinkWidth 1/2/4/8/12/16/32 -- */
1354 static void get_prop_pcielinkwidth(Object
*obj
, Visitor
*v
, const char *name
,
1355 void *opaque
, Error
**errp
)
1357 DeviceState
*dev
= DEVICE(obj
);
1358 Property
*prop
= opaque
;
1359 PCIExpLinkWidth
*p
= qdev_get_prop_ptr(dev
, prop
);
1363 case QEMU_PCI_EXP_LNK_X1
:
1364 width
= PCIE_LINK_WIDTH_1
;
1366 case QEMU_PCI_EXP_LNK_X2
:
1367 width
= PCIE_LINK_WIDTH_2
;
1369 case QEMU_PCI_EXP_LNK_X4
:
1370 width
= PCIE_LINK_WIDTH_4
;
1372 case QEMU_PCI_EXP_LNK_X8
:
1373 width
= PCIE_LINK_WIDTH_8
;
1375 case QEMU_PCI_EXP_LNK_X12
:
1376 width
= PCIE_LINK_WIDTH_12
;
1378 case QEMU_PCI_EXP_LNK_X16
:
1379 width
= PCIE_LINK_WIDTH_16
;
1381 case QEMU_PCI_EXP_LNK_X32
:
1382 width
= PCIE_LINK_WIDTH_32
;
1389 visit_type_enum(v
, prop
->name
, &width
, prop
->info
->enum_table
, errp
);
1392 static void set_prop_pcielinkwidth(Object
*obj
, Visitor
*v
, const char *name
,
1393 void *opaque
, Error
**errp
)
1395 DeviceState
*dev
= DEVICE(obj
);
1396 Property
*prop
= opaque
;
1397 PCIExpLinkWidth
*p
= qdev_get_prop_ptr(dev
, prop
);
1399 Error
*local_err
= NULL
;
1401 if (dev
->realized
) {
1402 qdev_prop_set_after_realize(dev
, name
, errp
);
1406 visit_type_enum(v
, prop
->name
, &width
, prop
->info
->enum_table
, &local_err
);
1408 error_propagate(errp
, local_err
);
1413 case PCIE_LINK_WIDTH_1
:
1414 *p
= QEMU_PCI_EXP_LNK_X1
;
1416 case PCIE_LINK_WIDTH_2
:
1417 *p
= QEMU_PCI_EXP_LNK_X2
;
1419 case PCIE_LINK_WIDTH_4
:
1420 *p
= QEMU_PCI_EXP_LNK_X4
;
1422 case PCIE_LINK_WIDTH_8
:
1423 *p
= QEMU_PCI_EXP_LNK_X8
;
1425 case PCIE_LINK_WIDTH_12
:
1426 *p
= QEMU_PCI_EXP_LNK_X12
;
1428 case PCIE_LINK_WIDTH_16
:
1429 *p
= QEMU_PCI_EXP_LNK_X16
;
1431 case PCIE_LINK_WIDTH_32
:
1432 *p
= QEMU_PCI_EXP_LNK_X32
;
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
,