2 * QEMU Management Protocol
4 * Copyright IBM, Corp. 2011
7 * Anthony Liguori <aliguori@us.ibm.com>
9 * This work is licensed under the terms of the GNU GPL, version 2. See
10 * the COPYING file in the top-level directory.
12 * Contributions after 2012-01-13 are licensed under the terms of the
13 * GNU GPL, version 2 or (at your option) any later version.
16 #include "qemu/osdep.h"
17 #include "qemu/cutils.h"
18 #include "monitor/monitor.h"
19 #include "sysemu/sysemu.h"
20 #include "qmp-commands.h"
21 #include "sysemu/char.h"
22 #include "ui/qemu-spice.h"
24 #include "sysemu/kvm.h"
25 #include "sysemu/arch_init.h"
27 #include "sysemu/blockdev.h"
28 #include "sysemu/block-backend.h"
29 #include "qom/qom-qobject.h"
30 #include "qapi/qmp/qerror.h"
31 #include "qapi/qmp/qobject.h"
32 #include "qapi/qmp-input-visitor.h"
33 #include "hw/boards.h"
34 #include "qom/object_interfaces.h"
35 #include "hw/mem/pc-dimm.h"
36 #include "hw/acpi/acpi_dev_interface.h"
38 NameInfo
*qmp_query_name(Error
**errp
)
40 NameInfo
*info
= g_malloc0(sizeof(*info
));
43 info
->has_name
= true;
44 info
->name
= g_strdup(qemu_name
);
50 VersionInfo
*qmp_query_version(Error
**errp
)
52 VersionInfo
*info
= g_new0(VersionInfo
, 1);
53 const char *version
= QEMU_VERSION
;
57 info
->qemu
= g_new0(VersionTriple
, 1);
58 err
= qemu_strtoll(version
, &tmp
, 10, &info
->qemu
->major
);
62 err
= qemu_strtoll(tmp
, &tmp
, 10, &info
->qemu
->minor
);
66 err
= qemu_strtoll(tmp
, &tmp
, 10, &info
->qemu
->micro
);
68 info
->package
= g_strdup(QEMU_PKGVERSION
);
73 KvmInfo
*qmp_query_kvm(Error
**errp
)
75 KvmInfo
*info
= g_malloc0(sizeof(*info
));
77 info
->enabled
= kvm_enabled();
78 info
->present
= kvm_available();
83 UuidInfo
*qmp_query_uuid(Error
**errp
)
85 UuidInfo
*info
= g_malloc0(sizeof(*info
));
88 snprintf(uuid
, sizeof(uuid
), UUID_FMT
, qemu_uuid
[0], qemu_uuid
[1],
89 qemu_uuid
[2], qemu_uuid
[3], qemu_uuid
[4], qemu_uuid
[5],
90 qemu_uuid
[6], qemu_uuid
[7], qemu_uuid
[8], qemu_uuid
[9],
91 qemu_uuid
[10], qemu_uuid
[11], qemu_uuid
[12], qemu_uuid
[13],
92 qemu_uuid
[14], qemu_uuid
[15]);
94 info
->UUID
= g_strdup(uuid
);
98 void qmp_quit(Error
**errp
)
101 qemu_system_shutdown_request();
104 void qmp_stop(Error
**errp
)
106 /* if there is a dump in background, we should wait until the dump
108 if (dump_in_progress()) {
109 error_setg(errp
, "There is a dump in process, please wait.");
113 if (runstate_check(RUN_STATE_INMIGRATE
)) {
116 vm_stop(RUN_STATE_PAUSED
);
120 void qmp_system_reset(Error
**errp
)
122 qemu_system_reset_request();
125 void qmp_system_powerdown(Error
**erp
)
127 qemu_system_powerdown_request();
130 void qmp_cpu(int64_t index
, Error
**errp
)
132 /* Just do nothing */
135 void qmp_cpu_add(int64_t id
, Error
**errp
)
139 mc
= MACHINE_GET_CLASS(current_machine
);
140 if (mc
->hot_add_cpu
) {
141 mc
->hot_add_cpu(id
, errp
);
143 error_setg(errp
, "Not supported");
148 /* If VNC support is enabled, the "true" query-vnc command is
149 defined in the VNC subsystem */
150 VncInfo
*qmp_query_vnc(Error
**errp
)
152 error_setg(errp
, QERR_FEATURE_DISABLED
, "vnc");
156 VncInfo2List
*qmp_query_vnc_servers(Error
**errp
)
158 error_setg(errp
, QERR_FEATURE_DISABLED
, "vnc");
165 * qmp-commands.hx ensures that QMP command query-spice exists only
166 * #ifdef CONFIG_SPICE. Necessary for an accurate query-commands
167 * result. However, the QAPI schema is blissfully unaware of that,
168 * and the QAPI code generator happily generates a dead
169 * qmp_marshal_query_spice() that calls qmp_query_spice(). Provide it
170 * one, or else linking fails. FIXME Educate the QAPI schema on
173 SpiceInfo
*qmp_query_spice(Error
**errp
)
179 void qmp_cont(Error
**errp
)
181 Error
*local_err
= NULL
;
183 BlockDriverState
*bs
;
184 BdrvNextIterator
*it
;
186 /* if there is a dump in background, we should wait until the dump
188 if (dump_in_progress()) {
189 error_setg(errp
, "There is a dump in process, please wait.");
193 if (runstate_needs_reset()) {
194 error_setg(errp
, "Resetting the Virtual Machine is required");
196 } else if (runstate_check(RUN_STATE_SUSPENDED
)) {
200 for (blk
= blk_next(NULL
); blk
; blk
= blk_next(blk
)) {
201 blk_iostatus_reset(blk
);
205 while ((it
= bdrv_next(it
, &bs
))) {
206 bdrv_add_key(bs
, NULL
, &local_err
);
208 error_propagate(errp
, local_err
);
213 /* Continuing after completed migration. Images have been inactivated to
214 * allow the destination to take control. Need to get control back now. */
215 if (runstate_check(RUN_STATE_FINISH_MIGRATE
) ||
216 runstate_check(RUN_STATE_POSTMIGRATE
))
218 bdrv_invalidate_cache_all(&local_err
);
220 error_propagate(errp
, local_err
);
225 if (runstate_check(RUN_STATE_INMIGRATE
)) {
232 void qmp_system_wakeup(Error
**errp
)
234 qemu_system_wakeup_request(QEMU_WAKEUP_REASON_OTHER
);
237 ObjectPropertyInfoList
*qmp_qom_list(const char *path
, Error
**errp
)
240 bool ambiguous
= false;
241 ObjectPropertyInfoList
*props
= NULL
;
242 ObjectProperty
*prop
;
243 ObjectPropertyIterator iter
;
245 obj
= object_resolve_path(path
, &ambiguous
);
248 error_setg(errp
, "Path '%s' is ambiguous", path
);
250 error_set(errp
, ERROR_CLASS_DEVICE_NOT_FOUND
,
251 "Device '%s' not found", path
);
256 object_property_iter_init(&iter
, obj
);
257 while ((prop
= object_property_iter_next(&iter
))) {
258 ObjectPropertyInfoList
*entry
= g_malloc0(sizeof(*entry
));
260 entry
->value
= g_malloc0(sizeof(ObjectPropertyInfo
));
264 entry
->value
->name
= g_strdup(prop
->name
);
265 entry
->value
->type
= g_strdup(prop
->type
);
271 void qmp_qom_set(const char *path
, const char *property
, QObject
*value
,
276 obj
= object_resolve_path(path
, NULL
);
278 error_set(errp
, ERROR_CLASS_DEVICE_NOT_FOUND
,
279 "Device '%s' not found", path
);
283 object_property_set_qobject(obj
, value
, property
, errp
);
286 QObject
*qmp_qom_get(const char *path
, const char *property
, Error
**errp
)
290 obj
= object_resolve_path(path
, NULL
);
292 error_set(errp
, ERROR_CLASS_DEVICE_NOT_FOUND
,
293 "Device '%s' not found", path
);
297 return object_property_get_qobject(obj
, property
, errp
);
300 void qmp_set_password(const char *protocol
, const char *password
,
301 bool has_connected
, const char *connected
, Error
**errp
)
303 int disconnect_if_connected
= 0;
304 int fail_if_connected
= 0;
308 if (strcmp(connected
, "fail") == 0) {
309 fail_if_connected
= 1;
310 } else if (strcmp(connected
, "disconnect") == 0) {
311 disconnect_if_connected
= 1;
312 } else if (strcmp(connected
, "keep") == 0) {
315 error_setg(errp
, QERR_INVALID_PARAMETER
, "connected");
320 if (strcmp(protocol
, "spice") == 0) {
321 if (!qemu_using_spice(errp
)) {
324 rc
= qemu_spice_set_passwd(password
, fail_if_connected
,
325 disconnect_if_connected
);
327 error_setg(errp
, QERR_SET_PASSWD_FAILED
);
332 if (strcmp(protocol
, "vnc") == 0) {
333 if (fail_if_connected
|| disconnect_if_connected
) {
334 /* vnc supports "connected=keep" only */
335 error_setg(errp
, QERR_INVALID_PARAMETER
, "connected");
338 /* Note that setting an empty password will not disable login through
340 rc
= vnc_display_password(NULL
, password
);
342 error_setg(errp
, QERR_SET_PASSWD_FAILED
);
347 error_setg(errp
, QERR_INVALID_PARAMETER
, "protocol");
350 void qmp_expire_password(const char *protocol
, const char *whenstr
,
356 if (strcmp(whenstr
, "now") == 0) {
358 } else if (strcmp(whenstr
, "never") == 0) {
360 } else if (whenstr
[0] == '+') {
361 when
= time(NULL
) + strtoull(whenstr
+1, NULL
, 10);
363 when
= strtoull(whenstr
, NULL
, 10);
366 if (strcmp(protocol
, "spice") == 0) {
367 if (!qemu_using_spice(errp
)) {
370 rc
= qemu_spice_set_pw_expire(when
);
372 error_setg(errp
, QERR_SET_PASSWD_FAILED
);
377 if (strcmp(protocol
, "vnc") == 0) {
378 rc
= vnc_display_pw_expire(NULL
, when
);
380 error_setg(errp
, QERR_SET_PASSWD_FAILED
);
385 error_setg(errp
, QERR_INVALID_PARAMETER
, "protocol");
389 void qmp_change_vnc_password(const char *password
, Error
**errp
)
391 if (vnc_display_password(NULL
, password
) < 0) {
392 error_setg(errp
, QERR_SET_PASSWD_FAILED
);
396 static void qmp_change_vnc_listen(const char *target
, Error
**errp
)
398 QemuOptsList
*olist
= qemu_find_opts("vnc");
401 if (strstr(target
, "id=")) {
402 error_setg(errp
, "id not supported");
406 opts
= qemu_opts_find(olist
, "default");
410 opts
= vnc_parse(target
, errp
);
415 vnc_display_open("default", errp
);
418 static void qmp_change_vnc(const char *target
, bool has_arg
, const char *arg
,
421 if (strcmp(target
, "passwd") == 0 || strcmp(target
, "password") == 0) {
423 error_setg(errp
, QERR_MISSING_PARAMETER
, "password");
425 qmp_change_vnc_password(arg
, errp
);
428 qmp_change_vnc_listen(target
, errp
);
432 void qmp_change_vnc_password(const char *password
, Error
**errp
)
434 error_setg(errp
, QERR_FEATURE_DISABLED
, "vnc");
436 static void qmp_change_vnc(const char *target
, bool has_arg
, const char *arg
,
439 error_setg(errp
, QERR_FEATURE_DISABLED
, "vnc");
441 #endif /* !CONFIG_VNC */
443 void qmp_change(const char *device
, const char *target
,
444 bool has_arg
, const char *arg
, Error
**errp
)
446 if (strcmp(device
, "vnc") == 0) {
447 qmp_change_vnc(target
, has_arg
, arg
, errp
);
449 qmp_blockdev_change_medium(device
, target
, has_arg
, arg
, false, 0,
454 static void qom_list_types_tramp(ObjectClass
*klass
, void *data
)
456 ObjectTypeInfoList
*e
, **pret
= data
;
457 ObjectTypeInfo
*info
;
459 info
= g_malloc0(sizeof(*info
));
460 info
->name
= g_strdup(object_class_get_name(klass
));
462 e
= g_malloc0(sizeof(*e
));
468 ObjectTypeInfoList
*qmp_qom_list_types(bool has_implements
,
469 const char *implements
,
474 ObjectTypeInfoList
*ret
= NULL
;
476 object_class_foreach(qom_list_types_tramp
, implements
, abstract
, &ret
);
481 /* Return a DevicePropertyInfo for a qdev property.
483 * If a qdev property with the given name does not exist, use the given default
484 * type. If the qdev property info should not be shown, return NULL.
486 * The caller must free the return value.
488 static DevicePropertyInfo
*make_device_property_info(ObjectClass
*klass
,
490 const char *default_type
,
491 const char *description
)
493 DevicePropertyInfo
*info
;
497 for (prop
= DEVICE_CLASS(klass
)->props
; prop
&& prop
->name
; prop
++) {
498 if (strcmp(name
, prop
->name
) != 0) {
503 * TODO Properties without a parser are just for dirty hacks.
504 * qdev_prop_ptr is the only such PropertyInfo. It's marked
505 * for removal. This conditional should be removed along with
508 if (!prop
->info
->set
) {
509 return NULL
; /* no way to set it, don't show */
512 info
= g_malloc0(sizeof(*info
));
513 info
->name
= g_strdup(prop
->name
);
514 info
->type
= g_strdup(prop
->info
->name
);
515 info
->has_description
= !!prop
->info
->description
;
516 info
->description
= g_strdup(prop
->info
->description
);
519 klass
= object_class_get_parent(klass
);
520 } while (klass
!= object_class_by_name(TYPE_DEVICE
));
522 /* Not a qdev property, use the default type */
523 info
= g_malloc0(sizeof(*info
));
524 info
->name
= g_strdup(name
);
525 info
->type
= g_strdup(default_type
);
526 info
->has_description
= !!description
;
527 info
->description
= g_strdup(description
);
532 DevicePropertyInfoList
*qmp_device_list_properties(const char *typename
,
537 ObjectProperty
*prop
;
538 ObjectPropertyIterator iter
;
539 DevicePropertyInfoList
*prop_list
= NULL
;
541 klass
= object_class_by_name(typename
);
543 error_set(errp
, ERROR_CLASS_DEVICE_NOT_FOUND
,
544 "Device '%s' not found", typename
);
548 klass
= object_class_dynamic_cast(klass
, TYPE_DEVICE
);
550 error_setg(errp
, QERR_INVALID_PARAMETER_VALUE
, "name", TYPE_DEVICE
);
554 if (object_class_is_abstract(klass
)) {
555 error_setg(errp
, QERR_INVALID_PARAMETER_VALUE
, "name",
556 "non-abstract device type");
560 if (DEVICE_CLASS(klass
)->cannot_destroy_with_object_finalize_yet
) {
561 error_setg(errp
, "Can't list properties of device '%s'", typename
);
565 obj
= object_new(typename
);
567 object_property_iter_init(&iter
, obj
);
568 while ((prop
= object_property_iter_next(&iter
))) {
569 DevicePropertyInfo
*info
;
570 DevicePropertyInfoList
*entry
;
572 /* Skip Object and DeviceState properties */
573 if (strcmp(prop
->name
, "type") == 0 ||
574 strcmp(prop
->name
, "realized") == 0 ||
575 strcmp(prop
->name
, "hotpluggable") == 0 ||
576 strcmp(prop
->name
, "hotplugged") == 0 ||
577 strcmp(prop
->name
, "parent_bus") == 0) {
581 /* Skip legacy properties since they are just string versions of
582 * properties that we already list.
584 if (strstart(prop
->name
, "legacy-", NULL
)) {
588 info
= make_device_property_info(klass
, prop
->name
, prop
->type
,
594 entry
= g_malloc0(sizeof(*entry
));
596 entry
->next
= prop_list
;
605 CpuDefinitionInfoList
*qmp_query_cpu_definitions(Error
**errp
)
607 return arch_query_cpu_definitions(errp
);
610 void qmp_add_client(const char *protocol
, const char *fdname
,
611 bool has_skipauth
, bool skipauth
, bool has_tls
, bool tls
,
617 fd
= monitor_get_fd(cur_mon
, fdname
, errp
);
622 if (strcmp(protocol
, "spice") == 0) {
623 if (!qemu_using_spice(errp
)) {
627 skipauth
= has_skipauth
? skipauth
: false;
628 tls
= has_tls
? tls
: false;
629 if (qemu_spice_display_add_client(fd
, skipauth
, tls
) < 0) {
630 error_setg(errp
, "spice failed to add client");
635 } else if (strcmp(protocol
, "vnc") == 0) {
636 skipauth
= has_skipauth
? skipauth
: false;
637 vnc_display_add_client(NULL
, fd
, skipauth
);
640 } else if ((s
= qemu_chr_find(protocol
)) != NULL
) {
641 if (qemu_chr_add_client(s
, fd
) < 0) {
642 error_setg(errp
, "failed to add client");
649 error_setg(errp
, "protocol '%s' is invalid", protocol
);
654 void qmp_object_add(const char *type
, const char *id
,
655 bool has_props
, QObject
*props
, Error
**errp
)
657 const QDict
*pdict
= NULL
;
658 QmpInputVisitor
*qiv
;
662 pdict
= qobject_to_qdict(props
);
664 error_setg(errp
, QERR_INVALID_PARAMETER_TYPE
, "props", "dict");
669 qiv
= qmp_input_visitor_new(props
, true);
670 obj
= user_creatable_add_type(type
, id
, pdict
,
671 qmp_input_get_visitor(qiv
), errp
);
672 qmp_input_visitor_cleanup(qiv
);
678 void qmp_object_del(const char *id
, Error
**errp
)
680 user_creatable_del(id
, errp
);
683 MemoryDeviceInfoList
*qmp_query_memory_devices(Error
**errp
)
685 MemoryDeviceInfoList
*head
= NULL
;
686 MemoryDeviceInfoList
**prev
= &head
;
688 qmp_pc_dimm_device_list(qdev_get_machine(), &prev
);
693 ACPIOSTInfoList
*qmp_query_acpi_ospm_status(Error
**errp
)
696 ACPIOSTInfoList
*head
= NULL
;
697 ACPIOSTInfoList
**prev
= &head
;
698 Object
*obj
= object_resolve_path_type("", TYPE_ACPI_DEVICE_IF
, &ambig
);
701 AcpiDeviceIfClass
*adevc
= ACPI_DEVICE_IF_GET_CLASS(obj
);
702 AcpiDeviceIf
*adev
= ACPI_DEVICE_IF(obj
);
704 adevc
->ospm_status(adev
, &prev
);
706 error_setg(errp
, "command is not supported, missing ACPI device");