From: Peter Krempa Date: Fri, 7 Feb 2020 06:53:36 +0000 (+0100) Subject: docs: virsh: Modernize docs for qemu-monitor-command X-Git-Tag: v6.1.0-rc1~194 X-Git-Url: http://git.ipfire.org/cgi-bin/gitweb.cgi?a=commitdiff_plain;h=9860d00004aa783dd978e64d31ab5408960de0a4;p=thirdparty%2Flibvirt.git docs: virsh: Modernize docs for qemu-monitor-command Mention that we actually by default use QMP and clarify the rest of the documentation. Signed-off-by: Peter Krempa Reviewed-by: Eric Blake --- diff --git a/docs/manpages/virsh.rst b/docs/manpages/virsh.rst index 105b0d8f03..e10e5463a3 100644 --- a/docs/manpages/virsh.rst +++ b/docs/manpages/virsh.rst @@ -7485,13 +7485,18 @@ qemu-monitor-command qemu-monitor-command domain { [--hmp] | [--pretty] } command... Send an arbitrary monitor command *command* to domain *domain* through the -QEMU monitor. The results of the command will be printed on stdout. If -*--hmp* is passed, the command is considered to be a human monitor command -and libvirt will automatically convert it into QMP if needed. In that case -the result will also be converted back from QMP. If *--pretty* is given, -and the monitor uses QMP, then the output will be pretty-printed. If more -than one argument is provided for *command*, they are concatenated with a -space in between before passing the single command to the monitor. +QEMU monitor. The results of the command will be printed on stdout. + +If more than one argument is provided for *command*, they are concatenated with +a space in between before passing the single command to the monitor. + +Note that libvirt uses the QMP to talk to qemu so *command* must be valid JSON +in QMP format to work properly. + +If *--pretty* is given the QMP reply is pretty-printed. + +If *--hmp* is passed, the command is considered to be a human monitor command +and libvirt will automatically convert it into QMP and convert the result back. qemu-agent-command