1 #include "qemu/osdep.h"
2 #include "hw/qdev-properties.h"
3 #include "qapi/error.h"
4 #include "qapi/qapi-types-misc.h"
5 #include "qapi/qmp/qerror.h"
6 #include "qemu/ctype.h"
7 #include "qemu/error-report.h"
8 #include "qapi/visitor.h"
9 #include "qemu/units.h"
10 #include "qemu/cutils.h"
11 #include "qdev-prop-internal.h"
12
qdev_prop_set_after_realize(DeviceState * dev,const char * name,Error ** errp)13 void qdev_prop_set_after_realize(DeviceState *dev, const char *name,
14 Error **errp)
15 {
16 if (dev->id) {
17 error_setg(errp, "Attempt to set property '%s' on device '%s' "
18 "(type '%s') after it was realized", name, dev->id,
19 object_get_typename(OBJECT(dev)));
20 } else {
21 error_setg(errp, "Attempt to set property '%s' on anonymous device "
22 "(type '%s') after it was realized", name,
23 object_get_typename(OBJECT(dev)));
24 }
25 }
26
27 /* returns: true if property is allowed to be set, false otherwise */
qdev_prop_allow_set(Object * obj,const char * name,const PropertyInfo * info,Error ** errp)28 static bool qdev_prop_allow_set(Object *obj, const char *name,
29 const PropertyInfo *info, Error **errp)
30 {
31 DeviceState *dev = DEVICE(obj);
32
33 if (dev->realized && !info->realized_set_allowed) {
34 qdev_prop_set_after_realize(dev, name, errp);
35 return false;
36 }
37 return true;
38 }
39
qdev_prop_allow_set_link_before_realize(const Object * obj,const char * name,Object * val,Error ** errp)40 void qdev_prop_allow_set_link_before_realize(const Object *obj,
41 const char *name,
42 Object *val, Error **errp)
43 {
44 DeviceState *dev = DEVICE(obj);
45
46 if (dev->realized) {
47 error_setg(errp, "Attempt to set link property '%s' on device '%s' "
48 "(type '%s') after it was realized",
49 name, dev->id, object_get_typename(obj));
50 }
51 }
52
object_field_prop_ptr(Object * obj,Property * prop)53 void *object_field_prop_ptr(Object *obj, Property *prop)
54 {
55 void *ptr = obj;
56 ptr += prop->offset;
57 return ptr;
58 }
59
field_prop_get(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)60 static void field_prop_get(Object *obj, Visitor *v, const char *name,
61 void *opaque, Error **errp)
62 {
63 Property *prop = opaque;
64 return prop->info->get(obj, v, name, opaque, errp);
65 }
66
67 /**
68 * field_prop_getter: Return getter function to be used for property
69 *
70 * Return value can be NULL if @info has no getter function.
71 */
field_prop_getter(const PropertyInfo * info)72 static ObjectPropertyAccessor *field_prop_getter(const PropertyInfo *info)
73 {
74 return info->get ? field_prop_get : NULL;
75 }
76
field_prop_set(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)77 static void field_prop_set(Object *obj, Visitor *v, const char *name,
78 void *opaque, Error **errp)
79 {
80 Property *prop = opaque;
81
82 if (!qdev_prop_allow_set(obj, name, prop->info, errp)) {
83 return;
84 }
85
86 return prop->info->set(obj, v, name, opaque, errp);
87 }
88
89 /**
90 * field_prop_setter: Return setter function to be used for property
91 *
92 * Return value can be NULL if @info has not setter function.
93 */
field_prop_setter(const PropertyInfo * info)94 static ObjectPropertyAccessor *field_prop_setter(const PropertyInfo *info)
95 {
96 return info->set ? field_prop_set : NULL;
97 }
98
qdev_propinfo_get_enum(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)99 void qdev_propinfo_get_enum(Object *obj, Visitor *v, const char *name,
100 void *opaque, Error **errp)
101 {
102 Property *prop = opaque;
103 int *ptr = object_field_prop_ptr(obj, prop);
104
105 visit_type_enum(v, name, ptr, prop->info->enum_table, errp);
106 }
107
qdev_propinfo_set_enum(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)108 void qdev_propinfo_set_enum(Object *obj, Visitor *v, const char *name,
109 void *opaque, Error **errp)
110 {
111 Property *prop = opaque;
112 int *ptr = object_field_prop_ptr(obj, prop);
113
114 visit_type_enum(v, name, ptr, prop->info->enum_table, errp);
115 }
116
qdev_propinfo_set_default_value_enum(ObjectProperty * op,const Property * prop)117 void qdev_propinfo_set_default_value_enum(ObjectProperty *op,
118 const Property *prop)
119 {
120 object_property_set_default_str(op,
121 qapi_enum_lookup(prop->info->enum_table, prop->defval.i));
122 }
123
124 const PropertyInfo qdev_prop_enum = {
125 .name = "enum",
126 .get = qdev_propinfo_get_enum,
127 .set = qdev_propinfo_set_enum,
128 .set_default_value = qdev_propinfo_set_default_value_enum,
129 };
130
131 /* Bit */
132
qdev_get_prop_mask(Property * prop)133 static uint32_t qdev_get_prop_mask(Property *prop)
134 {
135 assert(prop->info == &qdev_prop_bit);
136 return 0x1 << prop->bitnr;
137 }
138
bit_prop_set(Object * obj,Property * props,bool val)139 static void bit_prop_set(Object *obj, Property *props, bool val)
140 {
141 uint32_t *p = object_field_prop_ptr(obj, props);
142 uint32_t mask = qdev_get_prop_mask(props);
143 if (val) {
144 *p |= mask;
145 } else {
146 *p &= ~mask;
147 }
148 }
149
prop_get_bit(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)150 static void prop_get_bit(Object *obj, Visitor *v, const char *name,
151 void *opaque, Error **errp)
152 {
153 Property *prop = opaque;
154 uint32_t *p = object_field_prop_ptr(obj, prop);
155 bool value = (*p & qdev_get_prop_mask(prop)) != 0;
156
157 visit_type_bool(v, name, &value, errp);
158 }
159
prop_set_bit(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)160 static void prop_set_bit(Object *obj, Visitor *v, const char *name,
161 void *opaque, Error **errp)
162 {
163 Property *prop = opaque;
164 bool value;
165
166 if (!visit_type_bool(v, name, &value, errp)) {
167 return;
168 }
169 bit_prop_set(obj, prop, value);
170 }
171
set_default_value_bool(ObjectProperty * op,const Property * prop)172 static void set_default_value_bool(ObjectProperty *op, const Property *prop)
173 {
174 object_property_set_default_bool(op, prop->defval.u);
175 }
176
177 const PropertyInfo qdev_prop_bit = {
178 .name = "bool",
179 .description = "on/off",
180 .get = prop_get_bit,
181 .set = prop_set_bit,
182 .set_default_value = set_default_value_bool,
183 };
184
185 /* Bit64 */
186
qdev_get_prop_mask64(Property * prop)187 static uint64_t qdev_get_prop_mask64(Property *prop)
188 {
189 assert(prop->info == &qdev_prop_bit64);
190 return 0x1ull << prop->bitnr;
191 }
192
bit64_prop_set(Object * obj,Property * props,bool val)193 static void bit64_prop_set(Object *obj, Property *props, bool val)
194 {
195 uint64_t *p = object_field_prop_ptr(obj, props);
196 uint64_t mask = qdev_get_prop_mask64(props);
197 if (val) {
198 *p |= mask;
199 } else {
200 *p &= ~mask;
201 }
202 }
203
prop_get_bit64(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)204 static void prop_get_bit64(Object *obj, Visitor *v, const char *name,
205 void *opaque, Error **errp)
206 {
207 Property *prop = opaque;
208 uint64_t *p = object_field_prop_ptr(obj, prop);
209 bool value = (*p & qdev_get_prop_mask64(prop)) != 0;
210
211 visit_type_bool(v, name, &value, errp);
212 }
213
prop_set_bit64(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)214 static void prop_set_bit64(Object *obj, Visitor *v, const char *name,
215 void *opaque, Error **errp)
216 {
217 Property *prop = opaque;
218 bool value;
219
220 if (!visit_type_bool(v, name, &value, errp)) {
221 return;
222 }
223 bit64_prop_set(obj, prop, value);
224 }
225
226 const PropertyInfo qdev_prop_bit64 = {
227 .name = "bool",
228 .description = "on/off",
229 .get = prop_get_bit64,
230 .set = prop_set_bit64,
231 .set_default_value = set_default_value_bool,
232 };
233
234 /* --- bool --- */
235
get_bool(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)236 static void get_bool(Object *obj, Visitor *v, const char *name, void *opaque,
237 Error **errp)
238 {
239 Property *prop = opaque;
240 bool *ptr = object_field_prop_ptr(obj, prop);
241
242 visit_type_bool(v, name, ptr, errp);
243 }
244
set_bool(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)245 static void set_bool(Object *obj, Visitor *v, const char *name, void *opaque,
246 Error **errp)
247 {
248 Property *prop = opaque;
249 bool *ptr = object_field_prop_ptr(obj, prop);
250
251 visit_type_bool(v, name, ptr, errp);
252 }
253
254 const PropertyInfo qdev_prop_bool = {
255 .name = "bool",
256 .get = get_bool,
257 .set = set_bool,
258 .set_default_value = set_default_value_bool,
259 };
260
261 /* --- 8bit integer --- */
262
get_uint8(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)263 static void get_uint8(Object *obj, Visitor *v, const char *name, void *opaque,
264 Error **errp)
265 {
266 Property *prop = opaque;
267 uint8_t *ptr = object_field_prop_ptr(obj, prop);
268
269 visit_type_uint8(v, name, ptr, errp);
270 }
271
set_uint8(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)272 static void set_uint8(Object *obj, Visitor *v, const char *name, void *opaque,
273 Error **errp)
274 {
275 Property *prop = opaque;
276 uint8_t *ptr = object_field_prop_ptr(obj, prop);
277
278 visit_type_uint8(v, name, ptr, errp);
279 }
280
qdev_propinfo_set_default_value_int(ObjectProperty * op,const Property * prop)281 void qdev_propinfo_set_default_value_int(ObjectProperty *op,
282 const Property *prop)
283 {
284 object_property_set_default_int(op, prop->defval.i);
285 }
286
qdev_propinfo_set_default_value_uint(ObjectProperty * op,const Property * prop)287 void qdev_propinfo_set_default_value_uint(ObjectProperty *op,
288 const Property *prop)
289 {
290 object_property_set_default_uint(op, prop->defval.u);
291 }
292
293 const PropertyInfo qdev_prop_uint8 = {
294 .name = "uint8",
295 .get = get_uint8,
296 .set = set_uint8,
297 .set_default_value = qdev_propinfo_set_default_value_uint,
298 };
299
300 /* --- 16bit integer --- */
301
get_uint16(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)302 static void get_uint16(Object *obj, Visitor *v, const char *name,
303 void *opaque, Error **errp)
304 {
305 Property *prop = opaque;
306 uint16_t *ptr = object_field_prop_ptr(obj, prop);
307
308 visit_type_uint16(v, name, ptr, errp);
309 }
310
set_uint16(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)311 static void set_uint16(Object *obj, Visitor *v, const char *name,
312 void *opaque, Error **errp)
313 {
314 Property *prop = opaque;
315 uint16_t *ptr = object_field_prop_ptr(obj, prop);
316
317 visit_type_uint16(v, name, ptr, errp);
318 }
319
320 const PropertyInfo qdev_prop_uint16 = {
321 .name = "uint16",
322 .get = get_uint16,
323 .set = set_uint16,
324 .set_default_value = qdev_propinfo_set_default_value_uint,
325 };
326
327 /* --- 32bit integer --- */
328
get_uint32(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)329 static void get_uint32(Object *obj, Visitor *v, const char *name,
330 void *opaque, Error **errp)
331 {
332 Property *prop = opaque;
333 uint32_t *ptr = object_field_prop_ptr(obj, prop);
334
335 visit_type_uint32(v, name, ptr, errp);
336 }
337
set_uint32(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)338 static void set_uint32(Object *obj, Visitor *v, const char *name,
339 void *opaque, Error **errp)
340 {
341 Property *prop = opaque;
342 uint32_t *ptr = object_field_prop_ptr(obj, prop);
343
344 visit_type_uint32(v, name, ptr, errp);
345 }
346
qdev_propinfo_get_int32(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)347 void qdev_propinfo_get_int32(Object *obj, Visitor *v, const char *name,
348 void *opaque, Error **errp)
349 {
350 Property *prop = opaque;
351 int32_t *ptr = object_field_prop_ptr(obj, prop);
352
353 visit_type_int32(v, name, ptr, errp);
354 }
355
set_int32(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)356 static void set_int32(Object *obj, Visitor *v, const char *name, void *opaque,
357 Error **errp)
358 {
359 Property *prop = opaque;
360 int32_t *ptr = object_field_prop_ptr(obj, prop);
361
362 visit_type_int32(v, name, ptr, errp);
363 }
364
365 const PropertyInfo qdev_prop_uint32 = {
366 .name = "uint32",
367 .get = get_uint32,
368 .set = set_uint32,
369 .set_default_value = qdev_propinfo_set_default_value_uint,
370 };
371
372 const PropertyInfo qdev_prop_int32 = {
373 .name = "int32",
374 .get = qdev_propinfo_get_int32,
375 .set = set_int32,
376 .set_default_value = qdev_propinfo_set_default_value_int,
377 };
378
379 /* --- 64bit integer --- */
380
get_uint64(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)381 static void get_uint64(Object *obj, Visitor *v, const char *name,
382 void *opaque, Error **errp)
383 {
384 Property *prop = opaque;
385 uint64_t *ptr = object_field_prop_ptr(obj, prop);
386
387 visit_type_uint64(v, name, ptr, errp);
388 }
389
set_uint64(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)390 static void set_uint64(Object *obj, Visitor *v, const char *name,
391 void *opaque, Error **errp)
392 {
393 Property *prop = opaque;
394 uint64_t *ptr = object_field_prop_ptr(obj, prop);
395
396 visit_type_uint64(v, name, ptr, errp);
397 }
398
get_int64(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)399 static void get_int64(Object *obj, Visitor *v, const char *name,
400 void *opaque, Error **errp)
401 {
402 Property *prop = opaque;
403 int64_t *ptr = object_field_prop_ptr(obj, prop);
404
405 visit_type_int64(v, name, ptr, errp);
406 }
407
set_int64(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)408 static void set_int64(Object *obj, Visitor *v, const char *name,
409 void *opaque, Error **errp)
410 {
411 Property *prop = opaque;
412 int64_t *ptr = object_field_prop_ptr(obj, prop);
413
414 visit_type_int64(v, name, ptr, errp);
415 }
416
417 const PropertyInfo qdev_prop_uint64 = {
418 .name = "uint64",
419 .get = get_uint64,
420 .set = set_uint64,
421 .set_default_value = qdev_propinfo_set_default_value_uint,
422 };
423
424 const PropertyInfo qdev_prop_int64 = {
425 .name = "int64",
426 .get = get_int64,
427 .set = set_int64,
428 .set_default_value = qdev_propinfo_set_default_value_int,
429 };
430
431 /* --- string --- */
432
release_string(Object * obj,const char * name,void * opaque)433 static void release_string(Object *obj, const char *name, void *opaque)
434 {
435 Property *prop = opaque;
436 g_free(*(char **)object_field_prop_ptr(obj, prop));
437 }
438
get_string(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)439 static void get_string(Object *obj, Visitor *v, const char *name,
440 void *opaque, Error **errp)
441 {
442 Property *prop = opaque;
443 char **ptr = object_field_prop_ptr(obj, prop);
444
445 if (!*ptr) {
446 char *str = (char *)"";
447 visit_type_str(v, name, &str, errp);
448 } else {
449 visit_type_str(v, name, ptr, errp);
450 }
451 }
452
set_string(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)453 static void set_string(Object *obj, Visitor *v, const char *name,
454 void *opaque, Error **errp)
455 {
456 Property *prop = opaque;
457 char **ptr = object_field_prop_ptr(obj, prop);
458 char *str;
459
460 if (!visit_type_str(v, name, &str, errp)) {
461 return;
462 }
463 g_free(*ptr);
464 *ptr = str;
465 }
466
467 const PropertyInfo qdev_prop_string = {
468 .name = "str",
469 .release = release_string,
470 .get = get_string,
471 .set = set_string,
472 };
473
474 /* --- on/off/auto --- */
475
476 const PropertyInfo qdev_prop_on_off_auto = {
477 .name = "OnOffAuto",
478 .description = "on/off/auto",
479 .enum_table = &OnOffAuto_lookup,
480 .get = qdev_propinfo_get_enum,
481 .set = qdev_propinfo_set_enum,
482 .set_default_value = qdev_propinfo_set_default_value_enum,
483 };
484
485 /* --- 32bit unsigned int 'size' type --- */
486
qdev_propinfo_get_size32(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)487 void qdev_propinfo_get_size32(Object *obj, Visitor *v, const char *name,
488 void *opaque, Error **errp)
489 {
490 Property *prop = opaque;
491 uint32_t *ptr = object_field_prop_ptr(obj, prop);
492 uint64_t value = *ptr;
493
494 visit_type_size(v, name, &value, errp);
495 }
496
set_size32(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)497 static void set_size32(Object *obj, Visitor *v, const char *name, void *opaque,
498 Error **errp)
499 {
500 Property *prop = opaque;
501 uint32_t *ptr = object_field_prop_ptr(obj, prop);
502 uint64_t value;
503
504 if (!visit_type_size(v, name, &value, errp)) {
505 return;
506 }
507
508 if (value > UINT32_MAX) {
509 error_setg(errp,
510 "Property %s.%s doesn't take value %" PRIu64
511 " (maximum: %u)",
512 object_get_typename(obj), name, value, UINT32_MAX);
513 return;
514 }
515
516 *ptr = value;
517 }
518
519 const PropertyInfo qdev_prop_size32 = {
520 .name = "size",
521 .get = qdev_propinfo_get_size32,
522 .set = set_size32,
523 .set_default_value = qdev_propinfo_set_default_value_uint,
524 };
525
526 /* --- support for array properties --- */
527
528 /* Used as an opaque for the object properties we add for each
529 * array element. Note that the struct Property must be first
530 * in the struct so that a pointer to this works as the opaque
531 * for the underlying element's property hooks as well as for
532 * our own release callback.
533 */
534 typedef struct {
535 struct Property prop;
536 char *propname;
537 ObjectPropertyRelease *release;
538 } ArrayElementProperty;
539
540 /* object property release callback for array element properties:
541 * we call the underlying element's property release hook, and
542 * then free the memory we allocated when we added the property.
543 */
array_element_release(Object * obj,const char * name,void * opaque)544 static void array_element_release(Object *obj, const char *name, void *opaque)
545 {
546 ArrayElementProperty *p = opaque;
547 if (p->release) {
548 p->release(obj, name, opaque);
549 }
550 g_free(p->propname);
551 g_free(p);
552 }
553
set_prop_arraylen(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)554 static void set_prop_arraylen(Object *obj, Visitor *v, const char *name,
555 void *opaque, Error **errp)
556 {
557 /* Setter for the property which defines the length of a
558 * variable-sized property array. As well as actually setting the
559 * array-length field in the device struct, we have to create the
560 * array itself and dynamically add the corresponding properties.
561 */
562 Property *prop = opaque;
563 uint32_t *alenptr = object_field_prop_ptr(obj, prop);
564 void **arrayptr = (void *)obj + prop->arrayoffset;
565 void *eltptr;
566 const char *arrayname;
567 int i;
568
569 if (*alenptr) {
570 error_setg(errp, "array size property %s may not be set more than once",
571 name);
572 return;
573 }
574 if (!visit_type_uint32(v, name, alenptr, errp)) {
575 return;
576 }
577 if (!*alenptr) {
578 return;
579 }
580
581 /* DEFINE_PROP_ARRAY guarantees that name should start with this prefix;
582 * strip it off so we can get the name of the array itself.
583 */
584 assert(strncmp(name, PROP_ARRAY_LEN_PREFIX,
585 strlen(PROP_ARRAY_LEN_PREFIX)) == 0);
586 arrayname = name + strlen(PROP_ARRAY_LEN_PREFIX);
587
588 /* Note that it is the responsibility of the individual device's deinit
589 * to free the array proper.
590 */
591 *arrayptr = eltptr = g_malloc0(*alenptr * prop->arrayfieldsize);
592 for (i = 0; i < *alenptr; i++, eltptr += prop->arrayfieldsize) {
593 char *propname = g_strdup_printf("%s[%d]", arrayname, i);
594 ArrayElementProperty *arrayprop = g_new0(ArrayElementProperty, 1);
595 arrayprop->release = prop->arrayinfo->release;
596 arrayprop->propname = propname;
597 arrayprop->prop.info = prop->arrayinfo;
598 arrayprop->prop.name = propname;
599 /* This ugly piece of pointer arithmetic sets up the offset so
600 * that when the underlying get/set hooks call qdev_get_prop_ptr
601 * they get the right answer despite the array element not actually
602 * being inside the device struct.
603 */
604 arrayprop->prop.offset = eltptr - (void *)obj;
605 assert(object_field_prop_ptr(obj, &arrayprop->prop) == eltptr);
606 object_property_add(obj, propname,
607 arrayprop->prop.info->name,
608 field_prop_getter(arrayprop->prop.info),
609 field_prop_setter(arrayprop->prop.info),
610 array_element_release,
611 arrayprop);
612 }
613 }
614
615 const PropertyInfo qdev_prop_arraylen = {
616 .name = "uint32",
617 .get = get_uint32,
618 .set = set_prop_arraylen,
619 .set_default_value = qdev_propinfo_set_default_value_uint,
620 };
621
622 /* --- public helpers --- */
623
qdev_prop_walk(Property * props,const char * name)624 static Property *qdev_prop_walk(Property *props, const char *name)
625 {
626 if (!props) {
627 return NULL;
628 }
629 while (props->name) {
630 if (strcmp(props->name, name) == 0) {
631 return props;
632 }
633 props++;
634 }
635 return NULL;
636 }
637
qdev_prop_find(DeviceState * dev,const char * name)638 static Property *qdev_prop_find(DeviceState *dev, const char *name)
639 {
640 ObjectClass *class;
641 Property *prop;
642
643 /* device properties */
644 class = object_get_class(OBJECT(dev));
645 do {
646 prop = qdev_prop_walk(DEVICE_CLASS(class)->props_, name);
647 if (prop) {
648 return prop;
649 }
650 class = object_class_get_parent(class);
651 } while (class != object_class_by_name(TYPE_DEVICE));
652
653 return NULL;
654 }
655
error_set_from_qdev_prop_error(Error ** errp,int ret,Object * obj,const char * name,const char * value)656 void error_set_from_qdev_prop_error(Error **errp, int ret, Object *obj,
657 const char *name, const char *value)
658 {
659 switch (ret) {
660 case -EEXIST:
661 error_setg(errp, "Property '%s.%s' can't take value '%s', it's in use",
662 object_get_typename(obj), name, value);
663 break;
664 default:
665 case -EINVAL:
666 error_setg(errp, QERR_PROPERTY_VALUE_BAD,
667 object_get_typename(obj), name, value);
668 break;
669 case -ENOENT:
670 error_setg(errp, "Property '%s.%s' can't find value '%s'",
671 object_get_typename(obj), name, value);
672 break;
673 case 0:
674 break;
675 }
676 }
677
qdev_prop_set_bit(DeviceState * dev,const char * name,bool value)678 void qdev_prop_set_bit(DeviceState *dev, const char *name, bool value)
679 {
680 object_property_set_bool(OBJECT(dev), name, value, &error_abort);
681 }
682
qdev_prop_set_uint8(DeviceState * dev,const char * name,uint8_t value)683 void qdev_prop_set_uint8(DeviceState *dev, const char *name, uint8_t value)
684 {
685 object_property_set_int(OBJECT(dev), name, value, &error_abort);
686 }
687
qdev_prop_set_uint16(DeviceState * dev,const char * name,uint16_t value)688 void qdev_prop_set_uint16(DeviceState *dev, const char *name, uint16_t value)
689 {
690 object_property_set_int(OBJECT(dev), name, value, &error_abort);
691 }
692
qdev_prop_set_uint32(DeviceState * dev,const char * name,uint32_t value)693 void qdev_prop_set_uint32(DeviceState *dev, const char *name, uint32_t value)
694 {
695 object_property_set_int(OBJECT(dev), name, value, &error_abort);
696 }
697
qdev_prop_set_int32(DeviceState * dev,const char * name,int32_t value)698 void qdev_prop_set_int32(DeviceState *dev, const char *name, int32_t value)
699 {
700 object_property_set_int(OBJECT(dev), name, value, &error_abort);
701 }
702
qdev_prop_set_uint64(DeviceState * dev,const char * name,uint64_t value)703 void qdev_prop_set_uint64(DeviceState *dev, const char *name, uint64_t value)
704 {
705 object_property_set_int(OBJECT(dev), name, value, &error_abort);
706 }
707
qdev_prop_set_string(DeviceState * dev,const char * name,const char * value)708 void qdev_prop_set_string(DeviceState *dev, const char *name, const char *value)
709 {
710 object_property_set_str(OBJECT(dev), name, value, &error_abort);
711 }
712
qdev_prop_set_enum(DeviceState * dev,const char * name,int value)713 void qdev_prop_set_enum(DeviceState *dev, const char *name, int value)
714 {
715 Property *prop;
716
717 prop = qdev_prop_find(dev, name);
718 object_property_set_str(OBJECT(dev), name,
719 qapi_enum_lookup(prop->info->enum_table, value),
720 &error_abort);
721 }
722
global_props(void)723 static GPtrArray *global_props(void)
724 {
725 static GPtrArray *gp;
726
727 if (!gp) {
728 gp = g_ptr_array_new();
729 }
730
731 return gp;
732 }
733
qdev_prop_register_global(GlobalProperty * prop)734 void qdev_prop_register_global(GlobalProperty *prop)
735 {
736 g_ptr_array_add(global_props(), prop);
737 }
738
qdev_find_global_prop(Object * obj,const char * name)739 const GlobalProperty *qdev_find_global_prop(Object *obj,
740 const char *name)
741 {
742 GPtrArray *props = global_props();
743 const GlobalProperty *p;
744 int i;
745
746 for (i = 0; i < props->len; i++) {
747 p = g_ptr_array_index(props, i);
748 if (object_dynamic_cast(obj, p->driver)
749 && !strcmp(p->property, name)) {
750 return p;
751 }
752 }
753 return NULL;
754 }
755
qdev_prop_check_globals(void)756 int qdev_prop_check_globals(void)
757 {
758 int i, ret = 0;
759
760 for (i = 0; i < global_props()->len; i++) {
761 GlobalProperty *prop;
762 ObjectClass *oc;
763 DeviceClass *dc;
764
765 prop = g_ptr_array_index(global_props(), i);
766 if (prop->used) {
767 continue;
768 }
769 oc = object_class_by_name(prop->driver);
770 oc = object_class_dynamic_cast(oc, TYPE_DEVICE);
771 if (!oc) {
772 warn_report("global %s.%s has invalid class name",
773 prop->driver, prop->property);
774 ret = 1;
775 continue;
776 }
777 dc = DEVICE_CLASS(oc);
778 if (!dc->hotpluggable && !prop->used) {
779 warn_report("global %s.%s=%s not used",
780 prop->driver, prop->property, prop->value);
781 ret = 1;
782 continue;
783 }
784 }
785 return ret;
786 }
787
qdev_prop_set_globals(DeviceState * dev)788 void qdev_prop_set_globals(DeviceState *dev)
789 {
790 object_apply_global_props(OBJECT(dev), global_props(),
791 dev->hotplugged ? NULL : &error_fatal);
792 }
793
794 /* --- 64bit unsigned int 'size' type --- */
795
get_size(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)796 static void get_size(Object *obj, Visitor *v, const char *name, void *opaque,
797 Error **errp)
798 {
799 Property *prop = opaque;
800 uint64_t *ptr = object_field_prop_ptr(obj, prop);
801
802 visit_type_size(v, name, ptr, errp);
803 }
804
set_size(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)805 static void set_size(Object *obj, Visitor *v, const char *name, void *opaque,
806 Error **errp)
807 {
808 Property *prop = opaque;
809 uint64_t *ptr = object_field_prop_ptr(obj, prop);
810
811 visit_type_size(v, name, ptr, errp);
812 }
813
814 const PropertyInfo qdev_prop_size = {
815 .name = "size",
816 .get = get_size,
817 .set = set_size,
818 .set_default_value = qdev_propinfo_set_default_value_uint,
819 };
820
821 /* --- object link property --- */
822
create_link_property(ObjectClass * oc,const char * name,Property * prop)823 static ObjectProperty *create_link_property(ObjectClass *oc, const char *name,
824 Property *prop)
825 {
826 return object_class_property_add_link(oc, name, prop->link_type,
827 prop->offset,
828 qdev_prop_allow_set_link_before_realize,
829 OBJ_PROP_LINK_STRONG);
830 }
831
832 const PropertyInfo qdev_prop_link = {
833 .name = "link",
834 .create = create_link_property,
835 };
836
qdev_property_add_static(DeviceState * dev,Property * prop)837 void qdev_property_add_static(DeviceState *dev, Property *prop)
838 {
839 Object *obj = OBJECT(dev);
840 ObjectProperty *op;
841
842 assert(!prop->info->create);
843
844 op = object_property_add(obj, prop->name, prop->info->name,
845 field_prop_getter(prop->info),
846 field_prop_setter(prop->info),
847 prop->info->release,
848 prop);
849
850 object_property_set_description(obj, prop->name,
851 prop->info->description);
852
853 if (prop->set_default) {
854 prop->info->set_default_value(op, prop);
855 if (op->init) {
856 op->init(obj, op);
857 }
858 }
859 }
860
qdev_class_add_property(DeviceClass * klass,const char * name,Property * prop)861 static void qdev_class_add_property(DeviceClass *klass, const char *name,
862 Property *prop)
863 {
864 ObjectClass *oc = OBJECT_CLASS(klass);
865 ObjectProperty *op;
866
867 if (prop->info->create) {
868 op = prop->info->create(oc, name, prop);
869 } else {
870 op = object_class_property_add(oc,
871 name, prop->info->name,
872 field_prop_getter(prop->info),
873 field_prop_setter(prop->info),
874 prop->info->release,
875 prop);
876 }
877 if (prop->set_default) {
878 prop->info->set_default_value(op, prop);
879 }
880 object_class_property_set_description(oc, name, prop->info->description);
881 }
882
883 /**
884 * Legacy property handling
885 */
886
qdev_get_legacy_property(Object * obj,Visitor * v,const char * name,void * opaque,Error ** errp)887 static void qdev_get_legacy_property(Object *obj, Visitor *v,
888 const char *name, void *opaque,
889 Error **errp)
890 {
891 Property *prop = opaque;
892
893 char buffer[1024];
894 char *ptr = buffer;
895
896 prop->info->print(obj, prop, buffer, sizeof(buffer));
897 visit_type_str(v, name, &ptr, errp);
898 }
899
900 /**
901 * qdev_class_add_legacy_property:
902 * @dev: Device to add the property to.
903 * @prop: The qdev property definition.
904 *
905 * Add a legacy QOM property to @dev for qdev property @prop.
906 *
907 * Legacy properties are string versions of QOM properties. The format of
908 * the string depends on the property type. Legacy properties are only
909 * needed for "info qtree".
910 *
911 * Do not use this in new code! QOM Properties added through this interface
912 * will be given names in the "legacy" namespace.
913 */
qdev_class_add_legacy_property(DeviceClass * dc,Property * prop)914 static void qdev_class_add_legacy_property(DeviceClass *dc, Property *prop)
915 {
916 g_autofree char *name = NULL;
917
918 /* Register pointer properties as legacy properties */
919 if (!prop->info->print && prop->info->get) {
920 return;
921 }
922
923 name = g_strdup_printf("legacy-%s", prop->name);
924 object_class_property_add(OBJECT_CLASS(dc), name, "str",
925 prop->info->print ? qdev_get_legacy_property : prop->info->get,
926 NULL, NULL, prop);
927 }
928
device_class_set_props(DeviceClass * dc,Property * props)929 void device_class_set_props(DeviceClass *dc, Property *props)
930 {
931 Property *prop;
932
933 dc->props_ = props;
934 for (prop = props; prop && prop->name; prop++) {
935 qdev_class_add_legacy_property(dc, prop);
936 qdev_class_add_property(dc, prop->name, prop);
937 }
938 }
939
qdev_alias_all_properties(DeviceState * target,Object * source)940 void qdev_alias_all_properties(DeviceState *target, Object *source)
941 {
942 ObjectClass *class;
943 Property *prop;
944
945 class = object_get_class(OBJECT(target));
946 do {
947 DeviceClass *dc = DEVICE_CLASS(class);
948
949 for (prop = dc->props_; prop && prop->name; prop++) {
950 object_property_add_alias(source, prop->name,
951 OBJECT(target), prop->name);
952 }
953 class = object_class_get_parent(class);
954 } while (class != object_class_by_name(TYPE_DEVICE));
955 }
956