1 #include "qemu/osdep.h"
2 #include "qemu/cutils.h"
4 #include "hw/qdev-properties.h"
5 #include "qapi/error.h"
6 #include "hw/pci/pci.h"
7 #include "qapi/qapi-types-block.h"
8 #include "qapi/qapi-types-machine.h"
9 #include "qapi/qapi-types-misc.h"
10 #include "qapi/qmp/qerror.h"
11 #include "qemu/ctype.h"
12 #include "qemu/error-report.h"
13 #include "qapi/qapi-types-migration.h"
14 #include "hw/block/block.h"
16 #include "qapi/visitor.h"
17 #include "chardev/char.h"
18 #include "qemu/uuid.h"
19 #include "qemu/units.h"
20 #include "qemu/cutils.h"
22 void qdev_prop_set_after_realize(DeviceState
*dev
, const char *name
,
26 error_setg(errp
, "Attempt to set property '%s' on device '%s' "
27 "(type '%s') after it was realized", name
, dev
->id
,
28 object_get_typename(OBJECT(dev
)));
30 error_setg(errp
, "Attempt to set property '%s' on anonymous device "
31 "(type '%s') after it was realized", name
,
32 object_get_typename(OBJECT(dev
)));
36 void qdev_prop_allow_set_link_before_realize(const Object
*obj
,
38 Object
*val
, Error
**errp
)
40 DeviceState
*dev
= DEVICE(obj
);
43 error_setg(errp
, "Attempt to set link property '%s' on device '%s' "
44 "(type '%s') after it was realized",
45 name
, dev
->id
, object_get_typename(obj
));
49 void *qdev_get_prop_ptr(DeviceState
*dev
, Property
*prop
)
56 static void get_enum(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
59 DeviceState
*dev
= DEVICE(obj
);
60 Property
*prop
= opaque
;
61 int *ptr
= qdev_get_prop_ptr(dev
, prop
);
63 visit_type_enum(v
, prop
->name
, ptr
, prop
->info
->enum_table
, errp
);
66 static void set_enum(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
69 DeviceState
*dev
= DEVICE(obj
);
70 Property
*prop
= opaque
;
71 int *ptr
= qdev_get_prop_ptr(dev
, prop
);
74 qdev_prop_set_after_realize(dev
, name
, errp
);
78 visit_type_enum(v
, prop
->name
, ptr
, prop
->info
->enum_table
, errp
);
81 static void set_default_value_enum(ObjectProperty
*op
, const Property
*prop
)
83 object_property_set_default_str(op
,
84 qapi_enum_lookup(prop
->info
->enum_table
, prop
->defval
.i
));
89 static uint32_t qdev_get_prop_mask(Property
*prop
)
91 assert(prop
->info
== &qdev_prop_bit
);
92 return 0x1 << prop
->bitnr
;
95 static void bit_prop_set(DeviceState
*dev
, Property
*props
, bool val
)
97 uint32_t *p
= qdev_get_prop_ptr(dev
, props
);
98 uint32_t mask
= qdev_get_prop_mask(props
);
106 static void prop_get_bit(Object
*obj
, Visitor
*v
, const char *name
,
107 void *opaque
, Error
**errp
)
109 DeviceState
*dev
= DEVICE(obj
);
110 Property
*prop
= opaque
;
111 uint32_t *p
= qdev_get_prop_ptr(dev
, prop
);
112 bool value
= (*p
& qdev_get_prop_mask(prop
)) != 0;
114 visit_type_bool(v
, name
, &value
, errp
);
117 static void prop_set_bit(Object
*obj
, Visitor
*v
, const char *name
,
118 void *opaque
, Error
**errp
)
120 DeviceState
*dev
= DEVICE(obj
);
121 Property
*prop
= opaque
;
125 qdev_prop_set_after_realize(dev
, name
, errp
);
129 if (!visit_type_bool(v
, name
, &value
, errp
)) {
132 bit_prop_set(dev
, prop
, value
);
135 static void set_default_value_bool(ObjectProperty
*op
, const Property
*prop
)
137 object_property_set_default_bool(op
, prop
->defval
.u
);
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
;
186 qdev_prop_set_after_realize(dev
, name
, errp
);
190 if (!visit_type_bool(v
, name
, &value
, errp
)) {
193 bit64_prop_set(dev
, prop
, value
);
196 const PropertyInfo qdev_prop_bit64
= {
198 .description
= "on/off",
199 .get
= prop_get_bit64
,
200 .set
= prop_set_bit64
,
201 .set_default_value
= set_default_value_bool
,
206 static void get_bool(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
209 DeviceState
*dev
= DEVICE(obj
);
210 Property
*prop
= opaque
;
211 bool *ptr
= qdev_get_prop_ptr(dev
, prop
);
213 visit_type_bool(v
, name
, ptr
, errp
);
216 static void set_bool(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
219 DeviceState
*dev
= DEVICE(obj
);
220 Property
*prop
= opaque
;
221 bool *ptr
= qdev_get_prop_ptr(dev
, prop
);
224 qdev_prop_set_after_realize(dev
, name
, errp
);
228 visit_type_bool(v
, name
, ptr
, errp
);
231 const PropertyInfo qdev_prop_bool
= {
235 .set_default_value
= set_default_value_bool
,
238 /* --- 8bit integer --- */
240 static void get_uint8(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
243 DeviceState
*dev
= DEVICE(obj
);
244 Property
*prop
= opaque
;
245 uint8_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
247 visit_type_uint8(v
, name
, ptr
, errp
);
250 static void set_uint8(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
253 DeviceState
*dev
= DEVICE(obj
);
254 Property
*prop
= opaque
;
255 uint8_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
258 qdev_prop_set_after_realize(dev
, name
, errp
);
262 visit_type_uint8(v
, name
, ptr
, errp
);
265 static void set_default_value_int(ObjectProperty
*op
, const Property
*prop
)
267 object_property_set_default_int(op
, prop
->defval
.i
);
270 static void set_default_value_uint(ObjectProperty
*op
, const Property
*prop
)
272 object_property_set_default_uint(op
, prop
->defval
.u
);
275 const PropertyInfo qdev_prop_uint8
= {
279 .set_default_value
= set_default_value_uint
,
282 /* --- 16bit integer --- */
284 static void get_uint16(Object
*obj
, Visitor
*v
, const char *name
,
285 void *opaque
, Error
**errp
)
287 DeviceState
*dev
= DEVICE(obj
);
288 Property
*prop
= opaque
;
289 uint16_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
291 visit_type_uint16(v
, name
, ptr
, errp
);
294 static void set_uint16(Object
*obj
, Visitor
*v
, const char *name
,
295 void *opaque
, Error
**errp
)
297 DeviceState
*dev
= DEVICE(obj
);
298 Property
*prop
= opaque
;
299 uint16_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
302 qdev_prop_set_after_realize(dev
, name
, errp
);
306 visit_type_uint16(v
, name
, ptr
, errp
);
309 const PropertyInfo qdev_prop_uint16
= {
313 .set_default_value
= set_default_value_uint
,
316 /* --- 32bit integer --- */
318 static void get_uint32(Object
*obj
, Visitor
*v
, const char *name
,
319 void *opaque
, Error
**errp
)
321 DeviceState
*dev
= DEVICE(obj
);
322 Property
*prop
= opaque
;
323 uint32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
325 visit_type_uint32(v
, name
, ptr
, errp
);
328 static void set_uint32(Object
*obj
, Visitor
*v
, const char *name
,
329 void *opaque
, Error
**errp
)
331 DeviceState
*dev
= DEVICE(obj
);
332 Property
*prop
= opaque
;
333 uint32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
336 qdev_prop_set_after_realize(dev
, name
, errp
);
340 visit_type_uint32(v
, name
, ptr
, errp
);
343 static void get_int32(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
346 DeviceState
*dev
= DEVICE(obj
);
347 Property
*prop
= opaque
;
348 int32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
350 visit_type_int32(v
, name
, ptr
, errp
);
353 static void set_int32(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
356 DeviceState
*dev
= DEVICE(obj
);
357 Property
*prop
= opaque
;
358 int32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
361 qdev_prop_set_after_realize(dev
, name
, errp
);
365 visit_type_int32(v
, name
, ptr
, errp
);
368 const PropertyInfo qdev_prop_uint32
= {
372 .set_default_value
= set_default_value_uint
,
375 const PropertyInfo qdev_prop_int32
= {
379 .set_default_value
= set_default_value_int
,
382 /* --- 64bit integer --- */
384 static void get_uint64(Object
*obj
, Visitor
*v
, const char *name
,
385 void *opaque
, Error
**errp
)
387 DeviceState
*dev
= DEVICE(obj
);
388 Property
*prop
= opaque
;
389 uint64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
391 visit_type_uint64(v
, name
, ptr
, errp
);
394 static void set_uint64(Object
*obj
, Visitor
*v
, const char *name
,
395 void *opaque
, Error
**errp
)
397 DeviceState
*dev
= DEVICE(obj
);
398 Property
*prop
= opaque
;
399 uint64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
402 qdev_prop_set_after_realize(dev
, name
, errp
);
406 visit_type_uint64(v
, name
, ptr
, errp
);
409 static void get_int64(Object
*obj
, Visitor
*v
, const char *name
,
410 void *opaque
, Error
**errp
)
412 DeviceState
*dev
= DEVICE(obj
);
413 Property
*prop
= opaque
;
414 int64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
416 visit_type_int64(v
, name
, ptr
, errp
);
419 static void set_int64(Object
*obj
, Visitor
*v
, const char *name
,
420 void *opaque
, Error
**errp
)
422 DeviceState
*dev
= DEVICE(obj
);
423 Property
*prop
= opaque
;
424 int64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
427 qdev_prop_set_after_realize(dev
, name
, errp
);
431 visit_type_int64(v
, name
, ptr
, errp
);
434 const PropertyInfo qdev_prop_uint64
= {
438 .set_default_value
= set_default_value_uint
,
441 const PropertyInfo qdev_prop_int64
= {
445 .set_default_value
= set_default_value_int
,
450 static void release_string(Object
*obj
, const char *name
, void *opaque
)
452 Property
*prop
= opaque
;
453 g_free(*(char **)qdev_get_prop_ptr(DEVICE(obj
), prop
));
456 static void get_string(Object
*obj
, Visitor
*v
, const char *name
,
457 void *opaque
, Error
**errp
)
459 DeviceState
*dev
= DEVICE(obj
);
460 Property
*prop
= opaque
;
461 char **ptr
= qdev_get_prop_ptr(dev
, prop
);
464 char *str
= (char *)"";
465 visit_type_str(v
, name
, &str
, errp
);
467 visit_type_str(v
, name
, ptr
, errp
);
471 static void set_string(Object
*obj
, Visitor
*v
, const char *name
,
472 void *opaque
, Error
**errp
)
474 DeviceState
*dev
= DEVICE(obj
);
475 Property
*prop
= opaque
;
476 char **ptr
= qdev_get_prop_ptr(dev
, prop
);
480 qdev_prop_set_after_realize(dev
, name
, errp
);
484 if (!visit_type_str(v
, name
, &str
, errp
)) {
491 const PropertyInfo qdev_prop_string
= {
493 .release
= release_string
,
498 /* --- mac address --- */
501 * accepted syntax versions:
505 static void get_mac(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
508 DeviceState
*dev
= DEVICE(obj
);
509 Property
*prop
= opaque
;
510 MACAddr
*mac
= qdev_get_prop_ptr(dev
, prop
);
511 char buffer
[2 * 6 + 5 + 1];
514 snprintf(buffer
, sizeof(buffer
), "%02x:%02x:%02x:%02x:%02x:%02x",
515 mac
->a
[0], mac
->a
[1], mac
->a
[2],
516 mac
->a
[3], mac
->a
[4], mac
->a
[5]);
518 visit_type_str(v
, name
, &p
, errp
);
521 static void set_mac(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
524 DeviceState
*dev
= DEVICE(obj
);
525 Property
*prop
= opaque
;
526 MACAddr
*mac
= qdev_get_prop_ptr(dev
, prop
);
532 qdev_prop_set_after_realize(dev
, name
, errp
);
536 if (!visit_type_str(v
, name
, &str
, errp
)) {
540 for (i
= 0, pos
= 0; i
< 6; i
++, pos
+= 3) {
543 if (!qemu_isxdigit(str
[pos
])) {
546 if (!qemu_isxdigit(str
[pos
+ 1])) {
550 if (str
[pos
+ 2] != '\0') {
554 if (str
[pos
+ 2] != ':' && str
[pos
+ 2] != '-') {
558 if (qemu_strtol(str
+ pos
, &p
, 16, &val
) < 0 || val
> 0xff) {
567 error_set_from_qdev_prop_error(errp
, EINVAL
, dev
, prop
, str
);
571 const PropertyInfo qdev_prop_macaddr
= {
573 .description
= "Ethernet 6-byte MAC Address, example: 52:54:00:12:34:56",
578 /* --- Reserved Region --- */
582 * <low address>:<high address>:<type>
583 * where low/high addresses are uint64_t in hexadecimal
584 * and type is a non-negative decimal integer
586 static void get_reserved_region(Object
*obj
, Visitor
*v
, const char *name
,
587 void *opaque
, Error
**errp
)
589 DeviceState
*dev
= DEVICE(obj
);
590 Property
*prop
= opaque
;
591 ReservedRegion
*rr
= qdev_get_prop_ptr(dev
, prop
);
596 rc
= snprintf(buffer
, sizeof(buffer
), "0x%"PRIx64
":0x%"PRIx64
":%u",
597 rr
->low
, rr
->high
, rr
->type
);
598 assert(rc
< sizeof(buffer
));
600 visit_type_str(v
, name
, &p
, errp
);
603 static void set_reserved_region(Object
*obj
, Visitor
*v
, const char *name
,
604 void *opaque
, Error
**errp
)
606 DeviceState
*dev
= DEVICE(obj
);
607 Property
*prop
= opaque
;
608 ReservedRegion
*rr
= qdev_get_prop_ptr(dev
, prop
);
609 Error
*local_err
= NULL
;
615 qdev_prop_set_after_realize(dev
, name
, errp
);
619 visit_type_str(v
, name
, &str
, &local_err
);
621 error_propagate(errp
, local_err
);
625 ret
= qemu_strtou64(str
, &endptr
, 16, &rr
->low
);
627 error_setg(errp
, "start address of '%s'"
628 " must be a hexadecimal integer", name
);
631 if (*endptr
!= ':') {
632 goto separator_error
;
635 ret
= qemu_strtou64(endptr
+ 1, &endptr
, 16, &rr
->high
);
637 error_setg(errp
, "end address of '%s'"
638 " must be a hexadecimal integer", name
);
641 if (*endptr
!= ':') {
642 goto separator_error
;
645 ret
= qemu_strtoui(endptr
+ 1, &endptr
, 10, &rr
->type
);
647 error_setg(errp
, "type of '%s'"
648 " must be a non-negative decimal integer", name
);
653 error_setg(errp
, "reserved region fields must be separated with ':'");
659 const PropertyInfo qdev_prop_reserved_region
= {
660 .name
= "reserved_region",
661 .description
= "Reserved Region, example: 0xFEE00000:0xFEEFFFFF:0",
662 .get
= get_reserved_region
,
663 .set
= set_reserved_region
,
666 /* --- on/off/auto --- */
668 const PropertyInfo qdev_prop_on_off_auto
= {
670 .description
= "on/off/auto",
671 .enum_table
= &OnOffAuto_lookup
,
674 .set_default_value
= set_default_value_enum
,
677 /* --- lost tick policy --- */
679 QEMU_BUILD_BUG_ON(sizeof(LostTickPolicy
) != sizeof(int));
681 const PropertyInfo qdev_prop_losttickpolicy
= {
682 .name
= "LostTickPolicy",
683 .enum_table
= &LostTickPolicy_lookup
,
686 .set_default_value
= set_default_value_enum
,
689 /* --- Block device error handling policy --- */
691 QEMU_BUILD_BUG_ON(sizeof(BlockdevOnError
) != sizeof(int));
693 const PropertyInfo qdev_prop_blockdev_on_error
= {
694 .name
= "BlockdevOnError",
695 .description
= "Error handling policy, "
696 "report/ignore/enospc/stop/auto",
697 .enum_table
= &BlockdevOnError_lookup
,
700 .set_default_value
= set_default_value_enum
,
703 /* --- BIOS CHS translation */
705 QEMU_BUILD_BUG_ON(sizeof(BiosAtaTranslation
) != sizeof(int));
707 const PropertyInfo qdev_prop_bios_chs_trans
= {
708 .name
= "BiosAtaTranslation",
709 .description
= "Logical CHS translation algorithm, "
710 "auto/none/lba/large/rechs",
711 .enum_table
= &BiosAtaTranslation_lookup
,
714 .set_default_value
= set_default_value_enum
,
717 /* --- FDC default drive types */
719 const PropertyInfo qdev_prop_fdc_drive_type
= {
720 .name
= "FdcDriveType",
721 .description
= "FDC drive type, "
722 "144/288/120/none/auto",
723 .enum_table
= &FloppyDriveType_lookup
,
726 .set_default_value
= set_default_value_enum
,
729 /* --- MultiFDCompression --- */
731 const PropertyInfo qdev_prop_multifd_compression
= {
732 .name
= "MultiFDCompression",
733 .description
= "multifd_compression values, "
735 .enum_table
= &MultiFDCompression_lookup
,
738 .set_default_value
= set_default_value_enum
,
741 /* --- pci address --- */
744 * bus-local address, i.e. "$slot" or "$slot.$fn"
746 static void set_pci_devfn(Object
*obj
, Visitor
*v
, const char *name
,
747 void *opaque
, Error
**errp
)
749 DeviceState
*dev
= DEVICE(obj
);
750 Property
*prop
= opaque
;
751 int32_t value
, *ptr
= qdev_get_prop_ptr(dev
, prop
);
752 unsigned int slot
, fn
, n
;
756 qdev_prop_set_after_realize(dev
, name
, errp
);
760 if (!visit_type_str(v
, name
, &str
, NULL
)) {
761 if (!visit_type_int32(v
, name
, &value
, errp
)) {
764 if (value
< -1 || value
> 255) {
765 error_setg(errp
, QERR_INVALID_PARAMETER_VALUE
,
766 name
? name
: "null", "pci_devfn");
773 if (sscanf(str
, "%x.%x%n", &slot
, &fn
, &n
) != 2) {
775 if (sscanf(str
, "%x%n", &slot
, &n
) != 1) {
779 if (str
[n
] != '\0' || fn
> 7 || slot
> 31) {
782 *ptr
= slot
<< 3 | fn
;
787 error_set_from_qdev_prop_error(errp
, EINVAL
, dev
, prop
, str
);
791 static int print_pci_devfn(DeviceState
*dev
, Property
*prop
, char *dest
,
794 int32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
797 return snprintf(dest
, len
, "<unset>");
799 return snprintf(dest
, len
, "%02x.%x", *ptr
>> 3, *ptr
& 7);
803 const PropertyInfo qdev_prop_pci_devfn
= {
805 .description
= "Slot and optional function number, example: 06.0 or 06",
806 .print
= print_pci_devfn
,
808 .set
= set_pci_devfn
,
809 .set_default_value
= set_default_value_int
,
812 /* --- 32bit unsigned int 'size' type --- */
814 static void get_size32(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
817 DeviceState
*dev
= DEVICE(obj
);
818 Property
*prop
= opaque
;
819 uint32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
820 uint64_t value
= *ptr
;
822 visit_type_size(v
, name
, &value
, errp
);
825 static void set_size32(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
828 DeviceState
*dev
= DEVICE(obj
);
829 Property
*prop
= opaque
;
830 uint32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
834 qdev_prop_set_after_realize(dev
, name
, errp
);
838 if (!visit_type_size(v
, name
, &value
, errp
)) {
842 if (value
> UINT32_MAX
) {
844 "Property %s.%s doesn't take value %" PRIu64
846 dev
->id
? : "", name
, value
, UINT32_MAX
);
853 const PropertyInfo qdev_prop_size32
= {
857 .set_default_value
= set_default_value_uint
,
860 /* --- blocksize --- */
862 /* lower limit is sector size */
863 #define MIN_BLOCK_SIZE 512
864 #define MIN_BLOCK_SIZE_STR "512 B"
866 * upper limit is arbitrary, 2 MiB looks sufficient for all sensible uses, and
867 * matches qcow2 cluster size limit
869 #define MAX_BLOCK_SIZE (2 * MiB)
870 #define MAX_BLOCK_SIZE_STR "2 MiB"
872 static void set_blocksize(Object
*obj
, Visitor
*v
, const char *name
,
873 void *opaque
, Error
**errp
)
875 DeviceState
*dev
= DEVICE(obj
);
876 Property
*prop
= opaque
;
877 uint32_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
881 qdev_prop_set_after_realize(dev
, name
, errp
);
885 if (!visit_type_size(v
, name
, &value
, errp
)) {
888 /* value of 0 means "unset" */
889 if (value
&& (value
< MIN_BLOCK_SIZE
|| value
> MAX_BLOCK_SIZE
)) {
891 "Property %s.%s doesn't take value %" PRIu64
892 " (minimum: " MIN_BLOCK_SIZE_STR
893 ", maximum: " MAX_BLOCK_SIZE_STR
")",
894 dev
->id
? : "", name
, value
);
898 /* We rely on power-of-2 blocksizes for bitmasks */
899 if ((value
& (value
- 1)) != 0) {
901 "Property %s.%s doesn't take value '%" PRId64
"', "
902 "it's not a power of 2", dev
->id
?: "", name
, (int64_t)value
);
909 const PropertyInfo qdev_prop_blocksize
= {
911 .description
= "A power of two between " MIN_BLOCK_SIZE_STR
912 " and " MAX_BLOCK_SIZE_STR
,
914 .set
= set_blocksize
,
915 .set_default_value
= set_default_value_uint
,
918 /* --- pci host address --- */
920 static void get_pci_host_devaddr(Object
*obj
, Visitor
*v
, const char *name
,
921 void *opaque
, Error
**errp
)
923 DeviceState
*dev
= DEVICE(obj
);
924 Property
*prop
= opaque
;
925 PCIHostDeviceAddress
*addr
= qdev_get_prop_ptr(dev
, prop
);
926 char buffer
[] = "ffff:ff:ff.f";
931 * Catch "invalid" device reference from vfio-pci and allow the
932 * default buffer representing the non-existent device to be used.
934 if (~addr
->domain
|| ~addr
->bus
|| ~addr
->slot
|| ~addr
->function
) {
935 rc
= snprintf(buffer
, sizeof(buffer
), "%04x:%02x:%02x.%0d",
936 addr
->domain
, addr
->bus
, addr
->slot
, addr
->function
);
937 assert(rc
== sizeof(buffer
) - 1);
940 visit_type_str(v
, name
, &p
, errp
);
944 * Parse [<domain>:]<bus>:<slot>.<func>
945 * if <domain> is not supplied, it's assumed to be 0.
947 static void set_pci_host_devaddr(Object
*obj
, Visitor
*v
, const char *name
,
948 void *opaque
, Error
**errp
)
950 DeviceState
*dev
= DEVICE(obj
);
951 Property
*prop
= opaque
;
952 PCIHostDeviceAddress
*addr
= qdev_get_prop_ptr(dev
, prop
);
956 unsigned long dom
= 0, bus
= 0;
957 unsigned int slot
= 0, func
= 0;
960 qdev_prop_set_after_realize(dev
, name
, errp
);
964 if (!visit_type_str(v
, name
, &str
, errp
)) {
969 if (qemu_strtoul(p
, &e
, 16, &val
) < 0 || val
> 0xffff || e
== p
) {
978 if (qemu_strtoul(p
, &e
, 16, &val
) < 0 || val
> 0x1f || e
== p
) {
985 if (qemu_strtoul(p
, &e
, 16, &val
) < 0 || val
> 0x1f || e
== p
) {
995 if (qemu_strtoul(p
, &e
, 10, &val
) < 0 || val
> 7 || e
== p
) {
1011 addr
->function
= func
;
1017 error_set_from_qdev_prop_error(errp
, EINVAL
, dev
, prop
, str
);
1021 const PropertyInfo qdev_prop_pci_host_devaddr
= {
1023 .description
= "Address (bus/device/function) of "
1024 "the host device, example: 04:10.0",
1025 .get
= get_pci_host_devaddr
,
1026 .set
= set_pci_host_devaddr
,
1031 static void get_uuid(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
1034 DeviceState
*dev
= DEVICE(obj
);
1035 Property
*prop
= opaque
;
1036 QemuUUID
*uuid
= qdev_get_prop_ptr(dev
, prop
);
1037 char buffer
[UUID_FMT_LEN
+ 1];
1040 qemu_uuid_unparse(uuid
, buffer
);
1042 visit_type_str(v
, name
, &p
, errp
);
1045 #define UUID_VALUE_AUTO "auto"
1047 static void set_uuid(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
1050 DeviceState
*dev
= DEVICE(obj
);
1051 Property
*prop
= opaque
;
1052 QemuUUID
*uuid
= qdev_get_prop_ptr(dev
, prop
);
1055 if (dev
->realized
) {
1056 qdev_prop_set_after_realize(dev
, name
, errp
);
1060 if (!visit_type_str(v
, name
, &str
, errp
)) {
1064 if (!strcmp(str
, UUID_VALUE_AUTO
)) {
1065 qemu_uuid_generate(uuid
);
1066 } else if (qemu_uuid_parse(str
, uuid
) < 0) {
1067 error_set_from_qdev_prop_error(errp
, EINVAL
, dev
, prop
, str
);
1072 static void set_default_uuid_auto(ObjectProperty
*op
, const Property
*prop
)
1074 object_property_set_default_str(op
, UUID_VALUE_AUTO
);
1077 const PropertyInfo qdev_prop_uuid
= {
1079 .description
= "UUID (aka GUID) or \"" UUID_VALUE_AUTO
1080 "\" for random value (default)",
1083 .set_default_value
= set_default_uuid_auto
,
1086 /* --- support for array properties --- */
1088 /* Used as an opaque for the object properties we add for each
1089 * array element. Note that the struct Property must be first
1090 * in the struct so that a pointer to this works as the opaque
1091 * for the underlying element's property hooks as well as for
1092 * our own release callback.
1095 struct Property prop
;
1097 ObjectPropertyRelease
*release
;
1098 } ArrayElementProperty
;
1100 /* object property release callback for array element properties:
1101 * we call the underlying element's property release hook, and
1102 * then free the memory we allocated when we added the property.
1104 static void array_element_release(Object
*obj
, const char *name
, void *opaque
)
1106 ArrayElementProperty
*p
= opaque
;
1108 p
->release(obj
, name
, opaque
);
1110 g_free(p
->propname
);
1114 static void set_prop_arraylen(Object
*obj
, Visitor
*v
, const char *name
,
1115 void *opaque
, Error
**errp
)
1117 /* Setter for the property which defines the length of a
1118 * variable-sized property array. As well as actually setting the
1119 * array-length field in the device struct, we have to create the
1120 * array itself and dynamically add the corresponding properties.
1122 DeviceState
*dev
= DEVICE(obj
);
1123 Property
*prop
= opaque
;
1124 uint32_t *alenptr
= qdev_get_prop_ptr(dev
, prop
);
1125 void **arrayptr
= (void *)dev
+ prop
->arrayoffset
;
1127 const char *arrayname
;
1130 if (dev
->realized
) {
1131 qdev_prop_set_after_realize(dev
, name
, errp
);
1135 error_setg(errp
, "array size property %s may not be set more than once",
1139 if (!visit_type_uint32(v
, name
, alenptr
, errp
)) {
1146 /* DEFINE_PROP_ARRAY guarantees that name should start with this prefix;
1147 * strip it off so we can get the name of the array itself.
1149 assert(strncmp(name
, PROP_ARRAY_LEN_PREFIX
,
1150 strlen(PROP_ARRAY_LEN_PREFIX
)) == 0);
1151 arrayname
= name
+ strlen(PROP_ARRAY_LEN_PREFIX
);
1153 /* Note that it is the responsibility of the individual device's deinit
1154 * to free the array proper.
1156 *arrayptr
= eltptr
= g_malloc0(*alenptr
* prop
->arrayfieldsize
);
1157 for (i
= 0; i
< *alenptr
; i
++, eltptr
+= prop
->arrayfieldsize
) {
1158 char *propname
= g_strdup_printf("%s[%d]", arrayname
, i
);
1159 ArrayElementProperty
*arrayprop
= g_new0(ArrayElementProperty
, 1);
1160 arrayprop
->release
= prop
->arrayinfo
->release
;
1161 arrayprop
->propname
= propname
;
1162 arrayprop
->prop
.info
= prop
->arrayinfo
;
1163 arrayprop
->prop
.name
= propname
;
1164 /* This ugly piece of pointer arithmetic sets up the offset so
1165 * that when the underlying get/set hooks call qdev_get_prop_ptr
1166 * they get the right answer despite the array element not actually
1167 * being inside the device struct.
1169 arrayprop
->prop
.offset
= eltptr
- (void *)dev
;
1170 assert(qdev_get_prop_ptr(dev
, &arrayprop
->prop
) == eltptr
);
1171 object_property_add(obj
, propname
,
1172 arrayprop
->prop
.info
->name
,
1173 arrayprop
->prop
.info
->get
,
1174 arrayprop
->prop
.info
->set
,
1175 array_element_release
,
1180 const PropertyInfo qdev_prop_arraylen
= {
1183 .set
= set_prop_arraylen
,
1184 .set_default_value
= set_default_value_uint
,
1187 /* --- public helpers --- */
1189 static Property
*qdev_prop_walk(Property
*props
, const char *name
)
1194 while (props
->name
) {
1195 if (strcmp(props
->name
, name
) == 0) {
1203 static Property
*qdev_prop_find(DeviceState
*dev
, const char *name
)
1208 /* device properties */
1209 class = object_get_class(OBJECT(dev
));
1211 prop
= qdev_prop_walk(DEVICE_CLASS(class)->props_
, name
);
1215 class = object_class_get_parent(class);
1216 } while (class != object_class_by_name(TYPE_DEVICE
));
1221 void error_set_from_qdev_prop_error(Error
**errp
, int ret
, DeviceState
*dev
,
1222 Property
*prop
, const char *value
)
1226 error_setg(errp
, "Property '%s.%s' can't take value '%s', it's in use",
1227 object_get_typename(OBJECT(dev
)), prop
->name
, value
);
1231 error_setg(errp
, QERR_PROPERTY_VALUE_BAD
,
1232 object_get_typename(OBJECT(dev
)), prop
->name
, value
);
1235 error_setg(errp
, "Property '%s.%s' can't find value '%s'",
1236 object_get_typename(OBJECT(dev
)), prop
->name
, value
);
1243 void qdev_prop_set_bit(DeviceState
*dev
, const char *name
, bool value
)
1245 object_property_set_bool(OBJECT(dev
), name
, value
, &error_abort
);
1248 void qdev_prop_set_uint8(DeviceState
*dev
, const char *name
, uint8_t value
)
1250 object_property_set_int(OBJECT(dev
), name
, value
, &error_abort
);
1253 void qdev_prop_set_uint16(DeviceState
*dev
, const char *name
, uint16_t value
)
1255 object_property_set_int(OBJECT(dev
), name
, value
, &error_abort
);
1258 void qdev_prop_set_uint32(DeviceState
*dev
, const char *name
, uint32_t value
)
1260 object_property_set_int(OBJECT(dev
), name
, value
, &error_abort
);
1263 void qdev_prop_set_int32(DeviceState
*dev
, const char *name
, int32_t value
)
1265 object_property_set_int(OBJECT(dev
), name
, value
, &error_abort
);
1268 void qdev_prop_set_uint64(DeviceState
*dev
, const char *name
, uint64_t value
)
1270 object_property_set_int(OBJECT(dev
), name
, value
, &error_abort
);
1273 void qdev_prop_set_string(DeviceState
*dev
, const char *name
, const char *value
)
1275 object_property_set_str(OBJECT(dev
), name
, value
, &error_abort
);
1278 void qdev_prop_set_macaddr(DeviceState
*dev
, const char *name
,
1279 const uint8_t *value
)
1281 char str
[2 * 6 + 5 + 1];
1282 snprintf(str
, sizeof(str
), "%02x:%02x:%02x:%02x:%02x:%02x",
1283 value
[0], value
[1], value
[2], value
[3], value
[4], value
[5]);
1285 object_property_set_str(OBJECT(dev
), name
, str
, &error_abort
);
1288 void qdev_prop_set_enum(DeviceState
*dev
, const char *name
, int value
)
1292 prop
= qdev_prop_find(dev
, name
);
1293 object_property_set_str(OBJECT(dev
), name
,
1294 qapi_enum_lookup(prop
->info
->enum_table
, value
),
1298 static GPtrArray
*global_props(void)
1300 static GPtrArray
*gp
;
1303 gp
= g_ptr_array_new();
1309 void qdev_prop_register_global(GlobalProperty
*prop
)
1311 g_ptr_array_add(global_props(), prop
);
1314 const GlobalProperty
*qdev_find_global_prop(DeviceState
*dev
,
1317 GPtrArray
*props
= global_props();
1318 const GlobalProperty
*p
;
1321 for (i
= 0; i
< props
->len
; i
++) {
1322 p
= g_ptr_array_index(props
, i
);
1323 if (object_dynamic_cast(OBJECT(dev
), p
->driver
)
1324 && !strcmp(p
->property
, name
)) {
1331 int qdev_prop_check_globals(void)
1335 for (i
= 0; i
< global_props()->len
; i
++) {
1336 GlobalProperty
*prop
;
1340 prop
= g_ptr_array_index(global_props(), i
);
1344 oc
= object_class_by_name(prop
->driver
);
1345 oc
= object_class_dynamic_cast(oc
, TYPE_DEVICE
);
1347 warn_report("global %s.%s has invalid class name",
1348 prop
->driver
, prop
->property
);
1352 dc
= DEVICE_CLASS(oc
);
1353 if (!dc
->hotpluggable
&& !prop
->used
) {
1354 warn_report("global %s.%s=%s not used",
1355 prop
->driver
, prop
->property
, prop
->value
);
1363 void qdev_prop_set_globals(DeviceState
*dev
)
1365 object_apply_global_props(OBJECT(dev
), global_props(),
1366 dev
->hotplugged
? NULL
: &error_fatal
);
1369 /* --- 64bit unsigned int 'size' type --- */
1371 static void get_size(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
1374 DeviceState
*dev
= DEVICE(obj
);
1375 Property
*prop
= opaque
;
1376 uint64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
1378 visit_type_size(v
, name
, ptr
, errp
);
1381 static void set_size(Object
*obj
, Visitor
*v
, const char *name
, void *opaque
,
1384 DeviceState
*dev
= DEVICE(obj
);
1385 Property
*prop
= opaque
;
1386 uint64_t *ptr
= qdev_get_prop_ptr(dev
, prop
);
1388 visit_type_size(v
, name
, ptr
, errp
);
1391 const PropertyInfo qdev_prop_size
= {
1395 .set_default_value
= set_default_value_uint
,
1398 /* --- object link property --- */
1400 static void create_link_property(ObjectClass
*oc
, Property
*prop
)
1402 object_class_property_add_link(oc
, prop
->name
, prop
->link_type
,
1404 qdev_prop_allow_set_link_before_realize
,
1405 OBJ_PROP_LINK_STRONG
);
1408 const PropertyInfo qdev_prop_link
= {
1410 .create
= create_link_property
,
1413 /* --- OffAutoPCIBAR off/auto/bar0/bar1/bar2/bar3/bar4/bar5 --- */
1415 const PropertyInfo qdev_prop_off_auto_pcibar
= {
1416 .name
= "OffAutoPCIBAR",
1417 .description
= "off/auto/bar0/bar1/bar2/bar3/bar4/bar5",
1418 .enum_table
= &OffAutoPCIBAR_lookup
,
1421 .set_default_value
= set_default_value_enum
,
1424 /* --- PCIELinkSpeed 2_5/5/8/16 -- */
1426 static void get_prop_pcielinkspeed(Object
*obj
, Visitor
*v
, const char *name
,
1427 void *opaque
, Error
**errp
)
1429 DeviceState
*dev
= DEVICE(obj
);
1430 Property
*prop
= opaque
;
1431 PCIExpLinkSpeed
*p
= qdev_get_prop_ptr(dev
, prop
);
1435 case QEMU_PCI_EXP_LNK_2_5GT
:
1436 speed
= PCIE_LINK_SPEED_2_5
;
1438 case QEMU_PCI_EXP_LNK_5GT
:
1439 speed
= PCIE_LINK_SPEED_5
;
1441 case QEMU_PCI_EXP_LNK_8GT
:
1442 speed
= PCIE_LINK_SPEED_8
;
1444 case QEMU_PCI_EXP_LNK_16GT
:
1445 speed
= PCIE_LINK_SPEED_16
;
1452 visit_type_enum(v
, prop
->name
, &speed
, prop
->info
->enum_table
, errp
);
1455 static void set_prop_pcielinkspeed(Object
*obj
, Visitor
*v
, const char *name
,
1456 void *opaque
, Error
**errp
)
1458 DeviceState
*dev
= DEVICE(obj
);
1459 Property
*prop
= opaque
;
1460 PCIExpLinkSpeed
*p
= qdev_get_prop_ptr(dev
, prop
);
1463 if (dev
->realized
) {
1464 qdev_prop_set_after_realize(dev
, name
, errp
);
1468 if (!visit_type_enum(v
, prop
->name
, &speed
, prop
->info
->enum_table
,
1474 case PCIE_LINK_SPEED_2_5
:
1475 *p
= QEMU_PCI_EXP_LNK_2_5GT
;
1477 case PCIE_LINK_SPEED_5
:
1478 *p
= QEMU_PCI_EXP_LNK_5GT
;
1480 case PCIE_LINK_SPEED_8
:
1481 *p
= QEMU_PCI_EXP_LNK_8GT
;
1483 case PCIE_LINK_SPEED_16
:
1484 *p
= QEMU_PCI_EXP_LNK_16GT
;
1492 const PropertyInfo qdev_prop_pcie_link_speed
= {
1493 .name
= "PCIELinkSpeed",
1494 .description
= "2_5/5/8/16",
1495 .enum_table
= &PCIELinkSpeed_lookup
,
1496 .get
= get_prop_pcielinkspeed
,
1497 .set
= set_prop_pcielinkspeed
,
1498 .set_default_value
= set_default_value_enum
,
1501 /* --- PCIELinkWidth 1/2/4/8/12/16/32 -- */
1503 static void get_prop_pcielinkwidth(Object
*obj
, Visitor
*v
, const char *name
,
1504 void *opaque
, Error
**errp
)
1506 DeviceState
*dev
= DEVICE(obj
);
1507 Property
*prop
= opaque
;
1508 PCIExpLinkWidth
*p
= qdev_get_prop_ptr(dev
, prop
);
1512 case QEMU_PCI_EXP_LNK_X1
:
1513 width
= PCIE_LINK_WIDTH_1
;
1515 case QEMU_PCI_EXP_LNK_X2
:
1516 width
= PCIE_LINK_WIDTH_2
;
1518 case QEMU_PCI_EXP_LNK_X4
:
1519 width
= PCIE_LINK_WIDTH_4
;
1521 case QEMU_PCI_EXP_LNK_X8
:
1522 width
= PCIE_LINK_WIDTH_8
;
1524 case QEMU_PCI_EXP_LNK_X12
:
1525 width
= PCIE_LINK_WIDTH_12
;
1527 case QEMU_PCI_EXP_LNK_X16
:
1528 width
= PCIE_LINK_WIDTH_16
;
1530 case QEMU_PCI_EXP_LNK_X32
:
1531 width
= PCIE_LINK_WIDTH_32
;
1538 visit_type_enum(v
, prop
->name
, &width
, prop
->info
->enum_table
, errp
);
1541 static void set_prop_pcielinkwidth(Object
*obj
, Visitor
*v
, const char *name
,
1542 void *opaque
, Error
**errp
)
1544 DeviceState
*dev
= DEVICE(obj
);
1545 Property
*prop
= opaque
;
1546 PCIExpLinkWidth
*p
= qdev_get_prop_ptr(dev
, prop
);
1549 if (dev
->realized
) {
1550 qdev_prop_set_after_realize(dev
, name
, errp
);
1554 if (!visit_type_enum(v
, prop
->name
, &width
, prop
->info
->enum_table
,
1560 case PCIE_LINK_WIDTH_1
:
1561 *p
= QEMU_PCI_EXP_LNK_X1
;
1563 case PCIE_LINK_WIDTH_2
:
1564 *p
= QEMU_PCI_EXP_LNK_X2
;
1566 case PCIE_LINK_WIDTH_4
:
1567 *p
= QEMU_PCI_EXP_LNK_X4
;
1569 case PCIE_LINK_WIDTH_8
:
1570 *p
= QEMU_PCI_EXP_LNK_X8
;
1572 case PCIE_LINK_WIDTH_12
:
1573 *p
= QEMU_PCI_EXP_LNK_X12
;
1575 case PCIE_LINK_WIDTH_16
:
1576 *p
= QEMU_PCI_EXP_LNK_X16
;
1578 case PCIE_LINK_WIDTH_32
:
1579 *p
= QEMU_PCI_EXP_LNK_X32
;
1587 const PropertyInfo qdev_prop_pcie_link_width
= {
1588 .name
= "PCIELinkWidth",
1589 .description
= "1/2/4/8/12/16/32",
1590 .enum_table
= &PCIELinkWidth_lookup
,
1591 .get
= get_prop_pcielinkwidth
,
1592 .set
= set_prop_pcielinkwidth
,
1593 .set_default_value
= set_default_value_enum
,