2016-06-29 10:12:57 +02:00
|
|
|
#ifndef MONITOR_QDEV_H
|
|
|
|
|
#define MONITOR_QDEV_H
|
2012-08-10 19:00:43 +02:00
|
|
|
|
|
|
|
|
/*** monitor commands ***/
|
|
|
|
|
|
2015-02-06 14:18:24 +01:00
|
|
|
void hmp_info_qtree(Monitor *mon, const QDict *qdict);
|
|
|
|
|
void hmp_info_qdm(Monitor *mon, const QDict *qdict);
|
qmp: Wean off qerror_report()
The traditional QMP command handler interface
int qmp_FOO(Monitor *mon, const QDict *params, QObject **ret_data);
doesn't provide for returning an Error object. Instead, the handler
is expected to stash it in the monitor with qerror_report().
When we rebased QMP on top of QAPI, we didn't change this interface.
Instead, commit 776574d introduced "middle mode" as a temporary aid
for converting existing QMP commands to QAPI one by one. More than
three years later, we're still using it.
Middle mode has two effects:
* Instead of the native input marshallers
static void qmp_marshal_input_FOO(QDict *, QObject **, Error **)
it generates input marshallers conforming to the traditional QMP
command handler interface.
* It suppresses generation of code to register them with
qmp_register_command()
This permits giving them internal linkage.
As long as we need qmp-commands.hx, we can't use the registry behind
qmp_register_command(), so the latter has to stay for now.
The former has to go to get rid of qerror_report(). Changing all QMP
commands to fit the QAPI mold in one go was impractical back when we
started, but by now there are just a few stragglers left:
do_qmp_capabilities(), qmp_qom_set(), qmp_qom_get(), qmp_object_add(),
qmp_netdev_add(), do_device_add().
Switch middle mode to generate native input marshallers, and adapt the
stragglers. Simplifies both the monitor code and the stragglers.
Rename do_qmp_capabilities() to qmp_capabilities(), and
do_device_add() to qmp_device_add, because that's how QMP command
handlers are named today.
Signed-off-by: Markus Armbruster <armbru@redhat.com>
Reviewed-by: Stefan Hajnoczi <stefanha@redhat.com>
Reviewed-by: Eric Blake <eblake@redhat.com>
Reviewed-by: Luiz Capitulino <lcapitulino@redhat.com>
2015-03-13 17:25:50 +01:00
|
|
|
void qmp_device_add(QDict *qdict, QObject **ret_data, Error **errp);
|
|
|
|
|
|
2012-08-10 19:00:43 +02:00
|
|
|
int qdev_device_help(QemuOpts *opts);
|
2015-03-12 14:00:41 +01:00
|
|
|
DeviceState *qdev_device_add(QemuOpts *opts, Error **errp);
|
2021-10-08 15:34:41 +02:00
|
|
|
DeviceState *qdev_device_add_from_qdict(const QDict *opts,
|
|
|
|
|
bool from_json, Error **errp);
|
2021-10-08 15:34:36 +02:00
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* qdev_set_id: parent the device and set its id if provided.
|
|
|
|
|
* @dev: device to handle
|
|
|
|
|
* @id: id to be given to the device, or NULL.
|
|
|
|
|
*
|
|
|
|
|
* Returns: the id of the device in case of success; otherwise NULL.
|
|
|
|
|
*
|
|
|
|
|
* @dev must be unrealized, unparented and must not have an id.
|
|
|
|
|
*
|
|
|
|
|
* If @id is non-NULL, this function tries to setup @dev qom path as
|
|
|
|
|
* "/peripheral/id". If @id is already taken, it fails. If it succeeds,
|
|
|
|
|
* the id field of @dev is set to @id (@dev now owns the given @id
|
|
|
|
|
* parameter).
|
|
|
|
|
*
|
|
|
|
|
* If @id is NULL, this function generates a unique name and setups @dev
|
|
|
|
|
* qom path as "/peripheral-anon/name". This name is not set as the id
|
|
|
|
|
* of @dev.
|
|
|
|
|
*
|
|
|
|
|
* Upon success, it returns the id/name (generated or provided). The
|
|
|
|
|
* returned string is owned by the corresponding child property and must
|
|
|
|
|
* not be freed by the caller.
|
|
|
|
|
*/
|
|
|
|
|
const char *qdev_set_id(DeviceState *dev, char *id, Error **errp);
|
2012-08-10 19:00:43 +02:00
|
|
|
|
|
|
|
|
#endif
|
