[qemu.git] / docs / system / monitor.rst

.. _QEMU monitor:

QEMU Monitor
------------

The QEMU monitor is used to give complex commands to the QEMU emulator.
You can use it to:

-  Remove or insert removable media images (such as CD-ROM or
   floppies).

-  Freeze/unfreeze the Virtual Machine (VM) and save or restore its
   state from a disk file.

-  Inspect the VM state without an external debugger.

Commands
~~~~~~~~

The following commands are available:

.. hxtool-doc:: hmp-commands.hx

.. hxtool-doc:: hmp-commands-info.hx

Integer expressions
~~~~~~~~~~~~~~~~~~~

The monitor understands integers expressions for every integer argument.
You can use register names to get the value of specifics CPU registers
by prefixing them with *$*.
Commit	Line	Data
923e9311	1	.. _QEMU monitor:
324b2298 PB	2
	3	QEMU Monitor
	4	------------
	5
	6	The QEMU monitor is used to give complex commands to the QEMU emulator.
	7	You can use it to:
	8
	9	- Remove or insert removable media images (such as CD-ROM or
	10	floppies).
	11
	12	- Freeze/unfreeze the Virtual Machine (VM) and save or restore its
	13	state from a disk file.
	14
	15	- Inspect the VM state without an external debugger.
	16
a6b30bca PM	17	Commands
	18	~~~~~~~~
	19
	20	The following commands are available:
	21
	22	.. hxtool-doc:: hmp-commands.hx
	23
a12e74cc	24	.. hxtool-doc:: hmp-commands-info.hx
324b2298 PB	25
	26	Integer expressions
	27	~~~~~~~~~~~~~~~~~~~
	28
	29	The monitor understands integers expressions for every integer argument.
	30	You can use register names to get the value of specifics CPU registers
	31	by prefixing them with $.