qdev-properties.c 25 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699700701702703704705706707708709710711712713714715716717718719720721722723724725726727728729730731732733734735736737738739740741742743744745746747748749750751752753754755756757758759760761762763764765766767768769770771772773774775776777778779780781782783784785786787788789790791792793794795796797798799800801802803804805806807808809810811812813814815816817818819820821822823824825826827828829830831832833834835836837838839840841842843844845846847848849850851852853854855856857858859860861862863864865866867868869870871872873874875876877878879880881882883884885886887888889890891892893894895896897898899900901902903904905906907908909910911912913914915916917918919920921922923924925926927928929930931
  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/uuid.h"
  10. #include "qemu/units.h"
  11. #include "qemu/cutils.h"
  12. #include "qdev-prop-internal.h"
  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. void qdev_prop_allow_set_link_before_realize(const Object *obj,
  27. const char *name,
  28. Object *val, Error **errp)
  29. {
  30. DeviceState *dev = DEVICE(obj);
  31. if (dev->realized) {
  32. error_setg(errp, "Attempt to set link property '%s' on device '%s' "
  33. "(type '%s') after it was realized",
  34. name, dev->id, object_get_typename(obj));
  35. }
  36. }
  37. void *qdev_get_prop_ptr(DeviceState *dev, Property *prop)
  38. {
  39. void *ptr = dev;
  40. ptr += prop->offset;
  41. return ptr;
  42. }
  43. void qdev_propinfo_get_enum(Object *obj, Visitor *v, const char *name,
  44. void *opaque, Error **errp)
  45. {
  46. DeviceState *dev = DEVICE(obj);
  47. Property *prop = opaque;
  48. int *ptr = qdev_get_prop_ptr(dev, prop);
  49. visit_type_enum(v, prop->name, ptr, prop->info->enum_table, errp);
  50. }
  51. void qdev_propinfo_set_enum(Object *obj, Visitor *v, const char *name,
  52. void *opaque, Error **errp)
  53. {
  54. DeviceState *dev = DEVICE(obj);
  55. Property *prop = opaque;
  56. int *ptr = qdev_get_prop_ptr(dev, prop);
  57. if (dev->realized) {
  58. qdev_prop_set_after_realize(dev, name, errp);
  59. return;
  60. }
  61. visit_type_enum(v, prop->name, ptr, prop->info->enum_table, errp);
  62. }
  63. void qdev_propinfo_set_default_value_enum(ObjectProperty *op,
  64. const Property *prop)
  65. {
  66. object_property_set_default_str(op,
  67. qapi_enum_lookup(prop->info->enum_table, prop->defval.i));
  68. }
  69. const PropertyInfo qdev_prop_enum = {
  70. .name = "enum",
  71. .get = qdev_propinfo_get_enum,
  72. .set = qdev_propinfo_set_enum,
  73. .set_default_value = qdev_propinfo_set_default_value_enum,
  74. };
  75. /* Bit */
  76. static uint32_t qdev_get_prop_mask(Property *prop)
  77. {
  78. assert(prop->info == &qdev_prop_bit);
  79. return 0x1 << prop->bitnr;
  80. }
  81. static void bit_prop_set(DeviceState *dev, Property *props, bool val)
  82. {
  83. uint32_t *p = qdev_get_prop_ptr(dev, props);
  84. uint32_t mask = qdev_get_prop_mask(props);
  85. if (val) {
  86. *p |= mask;
  87. } else {
  88. *p &= ~mask;
  89. }
  90. }
  91. static void prop_get_bit(Object *obj, Visitor *v, const char *name,
  92. void *opaque, Error **errp)
  93. {
  94. DeviceState *dev = DEVICE(obj);
  95. Property *prop = opaque;
  96. uint32_t *p = qdev_get_prop_ptr(dev, prop);
  97. bool value = (*p & qdev_get_prop_mask(prop)) != 0;
  98. visit_type_bool(v, name, &value, errp);
  99. }
  100. static void prop_set_bit(Object *obj, Visitor *v, const char *name,
  101. void *opaque, Error **errp)
  102. {
  103. DeviceState *dev = DEVICE(obj);
  104. Property *prop = opaque;
  105. bool value;
  106. if (dev->realized) {
  107. qdev_prop_set_after_realize(dev, name, errp);
  108. return;
  109. }
  110. if (!visit_type_bool(v, name, &value, errp)) {
  111. return;
  112. }
  113. bit_prop_set(dev, prop, value);
  114. }
  115. static void set_default_value_bool(ObjectProperty *op, const Property *prop)
  116. {
  117. object_property_set_default_bool(op, prop->defval.u);
  118. }
  119. const PropertyInfo qdev_prop_bit = {
  120. .name = "bool",
  121. .description = "on/off",
  122. .get = prop_get_bit,
  123. .set = prop_set_bit,
  124. .set_default_value = set_default_value_bool,
  125. };
  126. /* Bit64 */
  127. static uint64_t qdev_get_prop_mask64(Property *prop)
  128. {
  129. assert(prop->info == &qdev_prop_bit64);
  130. return 0x1ull << prop->bitnr;
  131. }
  132. static void bit64_prop_set(DeviceState *dev, Property *props, bool val)
  133. {
  134. uint64_t *p = qdev_get_prop_ptr(dev, props);
  135. uint64_t mask = qdev_get_prop_mask64(props);
  136. if (val) {
  137. *p |= mask;
  138. } else {
  139. *p &= ~mask;
  140. }
  141. }
  142. static void prop_get_bit64(Object *obj, Visitor *v, const char *name,
  143. void *opaque, Error **errp)
  144. {
  145. DeviceState *dev = DEVICE(obj);
  146. Property *prop = opaque;
  147. uint64_t *p = qdev_get_prop_ptr(dev, prop);
  148. bool value = (*p & qdev_get_prop_mask64(prop)) != 0;
  149. visit_type_bool(v, name, &value, errp);
  150. }
  151. static void prop_set_bit64(Object *obj, Visitor *v, const char *name,
  152. void *opaque, Error **errp)
  153. {
  154. DeviceState *dev = DEVICE(obj);
  155. Property *prop = opaque;
  156. bool value;
  157. if (dev->realized) {
  158. qdev_prop_set_after_realize(dev, name, errp);
  159. return;
  160. }
  161. if (!visit_type_bool(v, name, &value, errp)) {
  162. return;
  163. }
  164. bit64_prop_set(dev, prop, value);
  165. }
  166. const PropertyInfo qdev_prop_bit64 = {
  167. .name = "bool",
  168. .description = "on/off",
  169. .get = prop_get_bit64,
  170. .set = prop_set_bit64,
  171. .set_default_value = set_default_value_bool,
  172. };
  173. /* --- bool --- */
  174. static void get_bool(Object *obj, Visitor *v, const char *name, void *opaque,
  175. Error **errp)
  176. {
  177. DeviceState *dev = DEVICE(obj);
  178. Property *prop = opaque;
  179. bool *ptr = qdev_get_prop_ptr(dev, prop);
  180. visit_type_bool(v, name, ptr, errp);
  181. }
  182. static void set_bool(Object *obj, Visitor *v, const char *name, void *opaque,
  183. Error **errp)
  184. {
  185. DeviceState *dev = DEVICE(obj);
  186. Property *prop = opaque;
  187. bool *ptr = qdev_get_prop_ptr(dev, prop);
  188. if (dev->realized) {
  189. qdev_prop_set_after_realize(dev, name, errp);
  190. return;
  191. }
  192. visit_type_bool(v, name, ptr, errp);
  193. }
  194. const PropertyInfo qdev_prop_bool = {
  195. .name = "bool",
  196. .get = get_bool,
  197. .set = set_bool,
  198. .set_default_value = set_default_value_bool,
  199. };
  200. /* --- 8bit integer --- */
  201. static void get_uint8(Object *obj, Visitor *v, const char *name, void *opaque,
  202. Error **errp)
  203. {
  204. DeviceState *dev = DEVICE(obj);
  205. Property *prop = opaque;
  206. uint8_t *ptr = qdev_get_prop_ptr(dev, prop);
  207. visit_type_uint8(v, name, ptr, errp);
  208. }
  209. static void set_uint8(Object *obj, Visitor *v, const char *name, void *opaque,
  210. Error **errp)
  211. {
  212. DeviceState *dev = DEVICE(obj);
  213. Property *prop = opaque;
  214. uint8_t *ptr = qdev_get_prop_ptr(dev, prop);
  215. if (dev->realized) {
  216. qdev_prop_set_after_realize(dev, name, errp);
  217. return;
  218. }
  219. visit_type_uint8(v, name, ptr, errp);
  220. }
  221. void qdev_propinfo_set_default_value_int(ObjectProperty *op,
  222. const Property *prop)
  223. {
  224. object_property_set_default_int(op, prop->defval.i);
  225. }
  226. void qdev_propinfo_set_default_value_uint(ObjectProperty *op,
  227. const Property *prop)
  228. {
  229. object_property_set_default_uint(op, prop->defval.u);
  230. }
  231. const PropertyInfo qdev_prop_uint8 = {
  232. .name = "uint8",
  233. .get = get_uint8,
  234. .set = set_uint8,
  235. .set_default_value = qdev_propinfo_set_default_value_uint,
  236. };
  237. /* --- 16bit integer --- */
  238. void qdev_propinfo_get_uint16(Object *obj, Visitor *v, const char *name,
  239. void *opaque, Error **errp)
  240. {
  241. DeviceState *dev = DEVICE(obj);
  242. Property *prop = opaque;
  243. uint16_t *ptr = qdev_get_prop_ptr(dev, prop);
  244. visit_type_uint16(v, name, ptr, errp);
  245. }
  246. static void set_uint16(Object *obj, Visitor *v, const char *name,
  247. void *opaque, Error **errp)
  248. {
  249. DeviceState *dev = DEVICE(obj);
  250. Property *prop = opaque;
  251. uint16_t *ptr = qdev_get_prop_ptr(dev, prop);
  252. if (dev->realized) {
  253. qdev_prop_set_after_realize(dev, name, errp);
  254. return;
  255. }
  256. visit_type_uint16(v, name, ptr, errp);
  257. }
  258. const PropertyInfo qdev_prop_uint16 = {
  259. .name = "uint16",
  260. .get = qdev_propinfo_get_uint16,
  261. .set = set_uint16,
  262. .set_default_value = qdev_propinfo_set_default_value_uint,
  263. };
  264. /* --- 32bit integer --- */
  265. static void get_uint32(Object *obj, Visitor *v, const char *name,
  266. void *opaque, Error **errp)
  267. {
  268. DeviceState *dev = DEVICE(obj);
  269. Property *prop = opaque;
  270. uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
  271. visit_type_uint32(v, name, ptr, errp);
  272. }
  273. static void set_uint32(Object *obj, Visitor *v, const char *name,
  274. void *opaque, Error **errp)
  275. {
  276. DeviceState *dev = DEVICE(obj);
  277. Property *prop = opaque;
  278. uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
  279. if (dev->realized) {
  280. qdev_prop_set_after_realize(dev, name, errp);
  281. return;
  282. }
  283. visit_type_uint32(v, name, ptr, errp);
  284. }
  285. void qdev_propinfo_get_int32(Object *obj, Visitor *v, const char *name,
  286. void *opaque, Error **errp)
  287. {
  288. DeviceState *dev = DEVICE(obj);
  289. Property *prop = opaque;
  290. int32_t *ptr = qdev_get_prop_ptr(dev, prop);
  291. visit_type_int32(v, name, ptr, errp);
  292. }
  293. static void set_int32(Object *obj, Visitor *v, const char *name, void *opaque,
  294. Error **errp)
  295. {
  296. DeviceState *dev = DEVICE(obj);
  297. Property *prop = opaque;
  298. int32_t *ptr = qdev_get_prop_ptr(dev, prop);
  299. if (dev->realized) {
  300. qdev_prop_set_after_realize(dev, name, errp);
  301. return;
  302. }
  303. visit_type_int32(v, name, ptr, errp);
  304. }
  305. const PropertyInfo qdev_prop_uint32 = {
  306. .name = "uint32",
  307. .get = get_uint32,
  308. .set = set_uint32,
  309. .set_default_value = qdev_propinfo_set_default_value_uint,
  310. };
  311. const PropertyInfo qdev_prop_int32 = {
  312. .name = "int32",
  313. .get = qdev_propinfo_get_int32,
  314. .set = set_int32,
  315. .set_default_value = qdev_propinfo_set_default_value_int,
  316. };
  317. /* --- 64bit integer --- */
  318. static void get_uint64(Object *obj, Visitor *v, const char *name,
  319. void *opaque, Error **errp)
  320. {
  321. DeviceState *dev = DEVICE(obj);
  322. Property *prop = opaque;
  323. uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
  324. visit_type_uint64(v, name, ptr, errp);
  325. }
  326. static void set_uint64(Object *obj, Visitor *v, const char *name,
  327. void *opaque, Error **errp)
  328. {
  329. DeviceState *dev = DEVICE(obj);
  330. Property *prop = opaque;
  331. uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
  332. if (dev->realized) {
  333. qdev_prop_set_after_realize(dev, name, errp);
  334. return;
  335. }
  336. visit_type_uint64(v, name, ptr, errp);
  337. }
  338. static void get_int64(Object *obj, Visitor *v, const char *name,
  339. void *opaque, Error **errp)
  340. {
  341. DeviceState *dev = DEVICE(obj);
  342. Property *prop = opaque;
  343. int64_t *ptr = qdev_get_prop_ptr(dev, prop);
  344. visit_type_int64(v, name, ptr, errp);
  345. }
  346. static void set_int64(Object *obj, Visitor *v, const char *name,
  347. void *opaque, Error **errp)
  348. {
  349. DeviceState *dev = DEVICE(obj);
  350. Property *prop = opaque;
  351. int64_t *ptr = qdev_get_prop_ptr(dev, prop);
  352. if (dev->realized) {
  353. qdev_prop_set_after_realize(dev, name, errp);
  354. return;
  355. }
  356. visit_type_int64(v, name, ptr, errp);
  357. }
  358. const PropertyInfo qdev_prop_uint64 = {
  359. .name = "uint64",
  360. .get = get_uint64,
  361. .set = set_uint64,
  362. .set_default_value = qdev_propinfo_set_default_value_uint,
  363. };
  364. const PropertyInfo qdev_prop_int64 = {
  365. .name = "int64",
  366. .get = get_int64,
  367. .set = set_int64,
  368. .set_default_value = qdev_propinfo_set_default_value_int,
  369. };
  370. /* --- string --- */
  371. static void release_string(Object *obj, const char *name, void *opaque)
  372. {
  373. Property *prop = opaque;
  374. g_free(*(char **)qdev_get_prop_ptr(DEVICE(obj), prop));
  375. }
  376. static void get_string(Object *obj, Visitor *v, const char *name,
  377. void *opaque, Error **errp)
  378. {
  379. DeviceState *dev = DEVICE(obj);
  380. Property *prop = opaque;
  381. char **ptr = qdev_get_prop_ptr(dev, prop);
  382. if (!*ptr) {
  383. char *str = (char *)"";
  384. visit_type_str(v, name, &str, errp);
  385. } else {
  386. visit_type_str(v, name, ptr, errp);
  387. }
  388. }
  389. static void set_string(Object *obj, Visitor *v, const char *name,
  390. void *opaque, Error **errp)
  391. {
  392. DeviceState *dev = DEVICE(obj);
  393. Property *prop = opaque;
  394. char **ptr = qdev_get_prop_ptr(dev, prop);
  395. char *str;
  396. if (dev->realized) {
  397. qdev_prop_set_after_realize(dev, name, errp);
  398. return;
  399. }
  400. if (!visit_type_str(v, name, &str, errp)) {
  401. return;
  402. }
  403. g_free(*ptr);
  404. *ptr = str;
  405. }
  406. const PropertyInfo qdev_prop_string = {
  407. .name = "str",
  408. .release = release_string,
  409. .get = get_string,
  410. .set = set_string,
  411. };
  412. /* --- on/off/auto --- */
  413. const PropertyInfo qdev_prop_on_off_auto = {
  414. .name = "OnOffAuto",
  415. .description = "on/off/auto",
  416. .enum_table = &OnOffAuto_lookup,
  417. .get = qdev_propinfo_get_enum,
  418. .set = qdev_propinfo_set_enum,
  419. .set_default_value = qdev_propinfo_set_default_value_enum,
  420. };
  421. /* --- 32bit unsigned int 'size' type --- */
  422. void qdev_propinfo_get_size32(Object *obj, Visitor *v, const char *name,
  423. void *opaque, Error **errp)
  424. {
  425. DeviceState *dev = DEVICE(obj);
  426. Property *prop = opaque;
  427. uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
  428. uint64_t value = *ptr;
  429. visit_type_size(v, name, &value, errp);
  430. }
  431. static void set_size32(Object *obj, Visitor *v, const char *name, void *opaque,
  432. Error **errp)
  433. {
  434. DeviceState *dev = DEVICE(obj);
  435. Property *prop = opaque;
  436. uint32_t *ptr = qdev_get_prop_ptr(dev, prop);
  437. uint64_t value;
  438. if (dev->realized) {
  439. qdev_prop_set_after_realize(dev, name, errp);
  440. return;
  441. }
  442. if (!visit_type_size(v, name, &value, errp)) {
  443. return;
  444. }
  445. if (value > UINT32_MAX) {
  446. error_setg(errp,
  447. "Property %s.%s doesn't take value %" PRIu64
  448. " (maximum: %u)",
  449. dev->id ? : "", name, value, UINT32_MAX);
  450. return;
  451. }
  452. *ptr = value;
  453. }
  454. const PropertyInfo qdev_prop_size32 = {
  455. .name = "size",
  456. .get = qdev_propinfo_get_size32,
  457. .set = set_size32,
  458. .set_default_value = qdev_propinfo_set_default_value_uint,
  459. };
  460. /* --- UUID --- */
  461. static void get_uuid(Object *obj, Visitor *v, const char *name, void *opaque,
  462. Error **errp)
  463. {
  464. DeviceState *dev = DEVICE(obj);
  465. Property *prop = opaque;
  466. QemuUUID *uuid = qdev_get_prop_ptr(dev, prop);
  467. char buffer[UUID_FMT_LEN + 1];
  468. char *p = buffer;
  469. qemu_uuid_unparse(uuid, buffer);
  470. visit_type_str(v, name, &p, errp);
  471. }
  472. #define UUID_VALUE_AUTO "auto"
  473. static void set_uuid(Object *obj, Visitor *v, const char *name, void *opaque,
  474. Error **errp)
  475. {
  476. DeviceState *dev = DEVICE(obj);
  477. Property *prop = opaque;
  478. QemuUUID *uuid = qdev_get_prop_ptr(dev, prop);
  479. char *str;
  480. if (dev->realized) {
  481. qdev_prop_set_after_realize(dev, name, errp);
  482. return;
  483. }
  484. if (!visit_type_str(v, name, &str, errp)) {
  485. return;
  486. }
  487. if (!strcmp(str, UUID_VALUE_AUTO)) {
  488. qemu_uuid_generate(uuid);
  489. } else if (qemu_uuid_parse(str, uuid) < 0) {
  490. error_set_from_qdev_prop_error(errp, EINVAL, dev, prop, str);
  491. }
  492. g_free(str);
  493. }
  494. static void set_default_uuid_auto(ObjectProperty *op, const Property *prop)
  495. {
  496. object_property_set_default_str(op, UUID_VALUE_AUTO);
  497. }
  498. const PropertyInfo qdev_prop_uuid = {
  499. .name = "str",
  500. .description = "UUID (aka GUID) or \"" UUID_VALUE_AUTO
  501. "\" for random value (default)",
  502. .get = get_uuid,
  503. .set = set_uuid,
  504. .set_default_value = set_default_uuid_auto,
  505. };
  506. /* --- support for array properties --- */
  507. /* Used as an opaque for the object properties we add for each
  508. * array element. Note that the struct Property must be first
  509. * in the struct so that a pointer to this works as the opaque
  510. * for the underlying element's property hooks as well as for
  511. * our own release callback.
  512. */
  513. typedef struct {
  514. struct Property prop;
  515. char *propname;
  516. ObjectPropertyRelease *release;
  517. } ArrayElementProperty;
  518. /* object property release callback for array element properties:
  519. * we call the underlying element's property release hook, and
  520. * then free the memory we allocated when we added the property.
  521. */
  522. static void array_element_release(Object *obj, const char *name, void *opaque)
  523. {
  524. ArrayElementProperty *p = opaque;
  525. if (p->release) {
  526. p->release(obj, name, opaque);
  527. }
  528. g_free(p->propname);
  529. g_free(p);
  530. }
  531. static void set_prop_arraylen(Object *obj, Visitor *v, const char *name,
  532. void *opaque, Error **errp)
  533. {
  534. /* Setter for the property which defines the length of a
  535. * variable-sized property array. As well as actually setting the
  536. * array-length field in the device struct, we have to create the
  537. * array itself and dynamically add the corresponding properties.
  538. */
  539. DeviceState *dev = DEVICE(obj);
  540. Property *prop = opaque;
  541. uint32_t *alenptr = qdev_get_prop_ptr(dev, prop);
  542. void **arrayptr = (void *)dev + prop->arrayoffset;
  543. void *eltptr;
  544. const char *arrayname;
  545. int i;
  546. if (dev->realized) {
  547. qdev_prop_set_after_realize(dev, name, errp);
  548. return;
  549. }
  550. if (*alenptr) {
  551. error_setg(errp, "array size property %s may not be set more than once",
  552. name);
  553. return;
  554. }
  555. if (!visit_type_uint32(v, name, alenptr, errp)) {
  556. return;
  557. }
  558. if (!*alenptr) {
  559. return;
  560. }
  561. /* DEFINE_PROP_ARRAY guarantees that name should start with this prefix;
  562. * strip it off so we can get the name of the array itself.
  563. */
  564. assert(strncmp(name, PROP_ARRAY_LEN_PREFIX,
  565. strlen(PROP_ARRAY_LEN_PREFIX)) == 0);
  566. arrayname = name + strlen(PROP_ARRAY_LEN_PREFIX);
  567. /* Note that it is the responsibility of the individual device's deinit
  568. * to free the array proper.
  569. */
  570. *arrayptr = eltptr = g_malloc0(*alenptr * prop->arrayfieldsize);
  571. for (i = 0; i < *alenptr; i++, eltptr += prop->arrayfieldsize) {
  572. char *propname = g_strdup_printf("%s[%d]", arrayname, i);
  573. ArrayElementProperty *arrayprop = g_new0(ArrayElementProperty, 1);
  574. arrayprop->release = prop->arrayinfo->release;
  575. arrayprop->propname = propname;
  576. arrayprop->prop.info = prop->arrayinfo;
  577. arrayprop->prop.name = propname;
  578. /* This ugly piece of pointer arithmetic sets up the offset so
  579. * that when the underlying get/set hooks call qdev_get_prop_ptr
  580. * they get the right answer despite the array element not actually
  581. * being inside the device struct.
  582. */
  583. arrayprop->prop.offset = eltptr - (void *)dev;
  584. assert(qdev_get_prop_ptr(dev, &arrayprop->prop) == eltptr);
  585. object_property_add(obj, propname,
  586. arrayprop->prop.info->name,
  587. arrayprop->prop.info->get,
  588. arrayprop->prop.info->set,
  589. array_element_release,
  590. arrayprop);
  591. }
  592. }
  593. const PropertyInfo qdev_prop_arraylen = {
  594. .name = "uint32",
  595. .get = get_uint32,
  596. .set = set_prop_arraylen,
  597. .set_default_value = qdev_propinfo_set_default_value_uint,
  598. };
  599. /* --- public helpers --- */
  600. static Property *qdev_prop_walk(Property *props, const char *name)
  601. {
  602. if (!props) {
  603. return NULL;
  604. }
  605. while (props->name) {
  606. if (strcmp(props->name, name) == 0) {
  607. return props;
  608. }
  609. props++;
  610. }
  611. return NULL;
  612. }
  613. static Property *qdev_prop_find(DeviceState *dev, const char *name)
  614. {
  615. ObjectClass *class;
  616. Property *prop;
  617. /* device properties */
  618. class = object_get_class(OBJECT(dev));
  619. do {
  620. prop = qdev_prop_walk(DEVICE_CLASS(class)->props_, name);
  621. if (prop) {
  622. return prop;
  623. }
  624. class = object_class_get_parent(class);
  625. } while (class != object_class_by_name(TYPE_DEVICE));
  626. return NULL;
  627. }
  628. void error_set_from_qdev_prop_error(Error **errp, int ret, DeviceState *dev,
  629. Property *prop, const char *value)
  630. {
  631. switch (ret) {
  632. case -EEXIST:
  633. error_setg(errp, "Property '%s.%s' can't take value '%s', it's in use",
  634. object_get_typename(OBJECT(dev)), prop->name, value);
  635. break;
  636. default:
  637. case -EINVAL:
  638. error_setg(errp, QERR_PROPERTY_VALUE_BAD,
  639. object_get_typename(OBJECT(dev)), prop->name, value);
  640. break;
  641. case -ENOENT:
  642. error_setg(errp, "Property '%s.%s' can't find value '%s'",
  643. object_get_typename(OBJECT(dev)), prop->name, value);
  644. break;
  645. case 0:
  646. break;
  647. }
  648. }
  649. void qdev_prop_set_bit(DeviceState *dev, const char *name, bool value)
  650. {
  651. object_property_set_bool(OBJECT(dev), name, value, &error_abort);
  652. }
  653. void qdev_prop_set_uint8(DeviceState *dev, const char *name, uint8_t value)
  654. {
  655. object_property_set_int(OBJECT(dev), name, value, &error_abort);
  656. }
  657. void qdev_prop_set_uint16(DeviceState *dev, const char *name, uint16_t value)
  658. {
  659. object_property_set_int(OBJECT(dev), name, value, &error_abort);
  660. }
  661. void qdev_prop_set_uint32(DeviceState *dev, const char *name, uint32_t value)
  662. {
  663. object_property_set_int(OBJECT(dev), name, value, &error_abort);
  664. }
  665. void qdev_prop_set_int32(DeviceState *dev, const char *name, int32_t value)
  666. {
  667. object_property_set_int(OBJECT(dev), name, value, &error_abort);
  668. }
  669. void qdev_prop_set_uint64(DeviceState *dev, const char *name, uint64_t value)
  670. {
  671. object_property_set_int(OBJECT(dev), name, value, &error_abort);
  672. }
  673. void qdev_prop_set_string(DeviceState *dev, const char *name, const char *value)
  674. {
  675. object_property_set_str(OBJECT(dev), name, value, &error_abort);
  676. }
  677. void qdev_prop_set_enum(DeviceState *dev, const char *name, int value)
  678. {
  679. Property *prop;
  680. prop = qdev_prop_find(dev, name);
  681. object_property_set_str(OBJECT(dev), name,
  682. qapi_enum_lookup(prop->info->enum_table, value),
  683. &error_abort);
  684. }
  685. static GPtrArray *global_props(void)
  686. {
  687. static GPtrArray *gp;
  688. if (!gp) {
  689. gp = g_ptr_array_new();
  690. }
  691. return gp;
  692. }
  693. void qdev_prop_register_global(GlobalProperty *prop)
  694. {
  695. g_ptr_array_add(global_props(), prop);
  696. }
  697. const GlobalProperty *qdev_find_global_prop(DeviceState *dev,
  698. const char *name)
  699. {
  700. GPtrArray *props = global_props();
  701. const GlobalProperty *p;
  702. int i;
  703. for (i = 0; i < props->len; i++) {
  704. p = g_ptr_array_index(props, i);
  705. if (object_dynamic_cast(OBJECT(dev), p->driver)
  706. && !strcmp(p->property, name)) {
  707. return p;
  708. }
  709. }
  710. return NULL;
  711. }
  712. int qdev_prop_check_globals(void)
  713. {
  714. int i, ret = 0;
  715. for (i = 0; i < global_props()->len; i++) {
  716. GlobalProperty *prop;
  717. ObjectClass *oc;
  718. DeviceClass *dc;
  719. prop = g_ptr_array_index(global_props(), i);
  720. if (prop->used) {
  721. continue;
  722. }
  723. oc = object_class_by_name(prop->driver);
  724. oc = object_class_dynamic_cast(oc, TYPE_DEVICE);
  725. if (!oc) {
  726. warn_report("global %s.%s has invalid class name",
  727. prop->driver, prop->property);
  728. ret = 1;
  729. continue;
  730. }
  731. dc = DEVICE_CLASS(oc);
  732. if (!dc->hotpluggable && !prop->used) {
  733. warn_report("global %s.%s=%s not used",
  734. prop->driver, prop->property, prop->value);
  735. ret = 1;
  736. continue;
  737. }
  738. }
  739. return ret;
  740. }
  741. void qdev_prop_set_globals(DeviceState *dev)
  742. {
  743. object_apply_global_props(OBJECT(dev), global_props(),
  744. dev->hotplugged ? NULL : &error_fatal);
  745. }
  746. /* --- 64bit unsigned int 'size' type --- */
  747. static void get_size(Object *obj, Visitor *v, const char *name, void *opaque,
  748. Error **errp)
  749. {
  750. DeviceState *dev = DEVICE(obj);
  751. Property *prop = opaque;
  752. uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
  753. visit_type_size(v, name, ptr, errp);
  754. }
  755. static void set_size(Object *obj, Visitor *v, const char *name, void *opaque,
  756. Error **errp)
  757. {
  758. DeviceState *dev = DEVICE(obj);
  759. Property *prop = opaque;
  760. uint64_t *ptr = qdev_get_prop_ptr(dev, prop);
  761. visit_type_size(v, name, ptr, errp);
  762. }
  763. const PropertyInfo qdev_prop_size = {
  764. .name = "size",
  765. .get = get_size,
  766. .set = set_size,
  767. .set_default_value = qdev_propinfo_set_default_value_uint,
  768. };
  769. /* --- object link property --- */
  770. static void create_link_property(ObjectClass *oc, Property *prop)
  771. {
  772. object_class_property_add_link(oc, prop->name, prop->link_type,
  773. prop->offset,
  774. qdev_prop_allow_set_link_before_realize,
  775. OBJ_PROP_LINK_STRONG);
  776. }
  777. const PropertyInfo qdev_prop_link = {
  778. .name = "link",
  779. .create = create_link_property,
  780. };