xref: /qemu/include/monitor/qdev.h (revision 4a1d937796de0fecd8b22d7dbebf87f38e8282fd)
1121d0712SMarkus Armbruster #ifndef MONITOR_QDEV_H
2121d0712SMarkus Armbruster #define MONITOR_QDEV_H
3074a86fcSAnthony Liguori 
4074a86fcSAnthony Liguori /*** monitor commands ***/
5074a86fcSAnthony Liguori 
61ce6be24SMarkus Armbruster void hmp_info_qtree(Monitor *mon, const QDict *qdict);
71ce6be24SMarkus Armbruster void hmp_info_qdm(Monitor *mon, const QDict *qdict);
8485febc6SMarkus Armbruster void qmp_device_add(QDict *qdict, QObject **ret_data, Error **errp);
9485febc6SMarkus Armbruster 
10074a86fcSAnthony Liguori int qdev_device_help(QemuOpts *opts);
11f006cf7fSMarkus Armbruster DeviceState *qdev_device_add(QemuOpts *opts, Error **errp);
12*4a1d9377SDamien Hedde 
13*4a1d9377SDamien Hedde /**
14*4a1d9377SDamien Hedde  * qdev_set_id: parent the device and set its id if provided.
15*4a1d9377SDamien Hedde  * @dev: device to handle
16*4a1d9377SDamien Hedde  * @id: id to be given to the device, or NULL.
17*4a1d9377SDamien Hedde  *
18*4a1d9377SDamien Hedde  * Returns: the id of the device in case of success; otherwise NULL.
19*4a1d9377SDamien Hedde  *
20*4a1d9377SDamien Hedde  * @dev must be unrealized, unparented and must not have an id.
21*4a1d9377SDamien Hedde  *
22*4a1d9377SDamien Hedde  * If @id is non-NULL, this function tries to setup @dev qom path as
23*4a1d9377SDamien Hedde  * "/peripheral/id". If @id is already taken, it fails. If it succeeds,
24*4a1d9377SDamien Hedde  * the id field of @dev is set to @id (@dev now owns the given @id
25*4a1d9377SDamien Hedde  * parameter).
26*4a1d9377SDamien Hedde  *
27*4a1d9377SDamien Hedde  * If @id is NULL, this function generates a unique name and setups @dev
28*4a1d9377SDamien Hedde  * qom path as "/peripheral-anon/name". This name is not set as the id
29*4a1d9377SDamien Hedde  * of @dev.
30*4a1d9377SDamien Hedde  *
31*4a1d9377SDamien Hedde  * Upon success, it returns the id/name (generated or provided). The
32*4a1d9377SDamien Hedde  * returned string is owned by the corresponding child property and must
33*4a1d9377SDamien Hedde  * not be freed by the caller.
34*4a1d9377SDamien Hedde  */
35*4a1d9377SDamien Hedde const char *qdev_set_id(DeviceState *dev, char *id, Error **errp);
36074a86fcSAnthony Liguori 
37074a86fcSAnthony Liguori #endif
38