xref: /openbmc/qemu/docs/system/monitor.rst (revision 7761e07c3ffd8daad6fd933ad0bb03493080e193)
1*923e9311SThomas Huth.. _QEMU monitor:
2324b2298SPaolo Bonzini
3324b2298SPaolo BonziniQEMU Monitor
4324b2298SPaolo Bonzini------------
5324b2298SPaolo Bonzini
6324b2298SPaolo BonziniThe QEMU monitor is used to give complex commands to the QEMU emulator.
7324b2298SPaolo BonziniYou can use it to:
8324b2298SPaolo Bonzini
9324b2298SPaolo Bonzini-  Remove or insert removable media images (such as CD-ROM or
10324b2298SPaolo Bonzini   floppies).
11324b2298SPaolo Bonzini
12324b2298SPaolo Bonzini-  Freeze/unfreeze the Virtual Machine (VM) and save or restore its
13324b2298SPaolo Bonzini   state from a disk file.
14324b2298SPaolo Bonzini
15324b2298SPaolo Bonzini-  Inspect the VM state without an external debugger.
16324b2298SPaolo Bonzini
17a6b30bcaSPeter MaydellCommands
18a6b30bcaSPeter Maydell~~~~~~~~
19a6b30bcaSPeter Maydell
20a6b30bcaSPeter MaydellThe following commands are available:
21a6b30bcaSPeter Maydell
22a6b30bcaSPeter Maydell.. hxtool-doc:: hmp-commands.hx
23a6b30bcaSPeter Maydell
24a12e74ccSPeter Maydell.. hxtool-doc:: hmp-commands-info.hx
25324b2298SPaolo Bonzini
26324b2298SPaolo BonziniInteger expressions
27324b2298SPaolo Bonzini~~~~~~~~~~~~~~~~~~~
28324b2298SPaolo Bonzini
29324b2298SPaolo BonziniThe monitor understands integers expressions for every integer argument.
30324b2298SPaolo BonziniYou can use register names to get the value of specifics CPU registers
31324b2298SPaolo Bonziniby prefixing them with *$*.
32