virt-qemu-qmp-proxy(1)

1VIRT-QEMU-QMP-PROXY(1)      Virtualization Support      VIRT-QEMU-QMP-PROXY(1)
2
3
4

NAME

6       virt-qemu-qmp-proxy  -  Expose  a  QMP  proxy server for a libvirt QEMU
7       guest
8

SYNOPSIS

10       virt-qemu-qmp-proxy [OPTION]... DOMAIN QMP-SOCKET-PATH
11

DESCRIPTION

13       This tool provides a way to expose a QMP proxy server that communicates
14       with  a QEMU guest managed by libvirt. This enables standard QMP client
15       tools to interact with libvirt managed guests.
16
17       NOTE: use of this tool will result in  the  running  QEMU  guest  being
18       marked  as  tainted.  It is strongly recommended that this tool only be
19       used to send commands which query information about the running  guest.
20       If  this  tool  is used to make changes to the state of the guest, this
21       may have negative interactions with the QEMU driver,  resulting  in  an
22       inability  to  manage  the guest operation thereafter, and in the worst
23       case potentially lead to data loss or corruption.
24
25       The virt-qemu-qmp-proxy program will listen on a UNIX socket for incom‐
26       ing  client  connections, and run the QMP protocol over the connection.
27       Any commands received will be sent to the running  libvirt  guest,  and
28       replies sent back.
29
30       The  virt-qemu-qmp-proxy program may be interrupted (eg Ctrl-C) when it
31       is no longer required. The libvirt QEMU guest will continue running.
32

OPTIONS

34       DOMAIN
35
36       The ID or UUID or Name of the libvirt QEMU guest.
37
38       QMP-SOCKET-PATH
39
40       The filesystem path at which to run the QMP server, listening  for  in‐
41       coming connections.
42
43       -c CONNECTION-URI --connect=CONNECTION-URI
44
45       The  URI  for  the connection to the libvirt QEMU driver. If omitted, a
46       URI will be auto-detected.
47
48       -v, --verbose
49
50       Run in verbose mode, printing all QMP commands  and  replies  that  are
51       handled.
52
53       -h, --help
54
55       Display the command line help.
56

EXIT STATUS

58       Upon successful shutdown, an exit status of 0 will be set. Upon failure
59       a non-zero status will be set.
60

AUTHOR

62       Daniel P. Berrangé
63

BUGS

65       Please report all bugs you discover.  This should be done via either:
66
67       1. the mailing list
68
69          https://libvirt.org/contact.html
70
71       2. the bug tracker
72
73          https://libvirt.org/bugs.html
74
75       Alternatively, you may report bugs to your software distributor /  ven‐
76       dor.
77

COPYRIGHT

79       Copyright (C) 2022 by Red Hat, Inc.
80

LICENSE

82       virt-qemu-qmp-proxy is distributed under the terms of the GNU LGPL v2+.
83       This is free software; see the source for copying conditions. There  is
84       NO  warranty;  not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
85       PURPOSE
86