qmp-shell-wrap - Man Page

QEMU + qmp-shell launcher utility


qmp-shell-wrap [-h] [-H] [-v] [-p] [-l LOGFILE] ...


Launch QEMU and connect to it with qmp-shell in a single command. CLI arguments will be forwarded to qemu, with additional arguments added to allow qmp-shell to then connect to the recently launched QEMU instance.

positional arguments:

command               QEMU command line to invoke

optional arguments:
-h, --help

show this help message and exit

-H, --hmp

Use HMP interface

-v, --verbose

Verbose (echo commands sent and received)

-p, --pretty

Pretty-print JSON


Save log of all QMP messages to PATH


Prepend "qmp-shell-wrap" to your usual QEMU command line:

> qmp-shell-wrap qemu-system-x86_64 -M q35 -m 4096 -display none
Welcome to the QMP low-level shell!

See Also

Refer to qmp-shell(1) for information on syntax and operation of the qmp-shell utility itself.


The QEMU Project authors


Jan 26, 2024 0.0.3 QEMU Monitor Protocol Library