Revision 0268d97c qmp-commands.hx
b/qmp-commands.hx | ||
---|---|---|
761 | 761 |
|
762 | 762 |
Note: This command must be issued before issuing any other command. |
763 | 763 |
|
764 |
EQMP |
|
765 |
|
|
766 |
{ |
|
767 |
.name = "human-monitor-command", |
|
768 |
.args_type = "command-line:s,cpu-index:i?", |
|
769 |
.params = "", |
|
770 |
.help = "", |
|
771 |
.user_print = monitor_user_noop, |
|
772 |
.mhandler.cmd_new = do_hmp_passthrough, |
|
773 |
}, |
|
774 |
|
|
775 |
SQMP |
|
776 |
human-monitor-command |
|
777 |
--------------------- |
|
778 |
|
|
779 |
Execute a Human Monitor command. |
|
780 |
|
|
781 |
Arguments: |
|
782 |
|
|
783 |
- command-line: the command name and its arguments, just like the |
|
784 |
Human Monitor's shell (json-string) |
|
785 |
- cpu-index: select the CPU number to be used by commands which access CPU |
|
786 |
data, like 'info registers'. The Monitor selects CPU 0 if this |
|
787 |
argument is not provided (json-int, optional) |
|
788 |
|
|
789 |
Example: |
|
790 |
|
|
791 |
-> { "execute": "human-monitor-command", "arguments": { "command-line": "info kvm" } } |
|
792 |
<- { "return": "kvm support: enabled\r\n" } |
|
793 |
|
|
794 |
Notes: |
|
795 |
|
|
796 |
(1) The Human Monitor is NOT an stable interface, this means that command |
|
797 |
names, arguments and responses can change or be removed at ANY time. |
|
798 |
Applications that rely on long term stability guarantees should NOT |
|
799 |
use this command |
|
800 |
|
|
801 |
(2) Limitations: |
|
802 |
|
|
803 |
o This command is stateless, this means that commands that depend |
|
804 |
on state information (such as getfd) might not work |
|
805 |
|
|
806 |
o Commands that prompt the user for data (eg. 'cont' when the block |
|
807 |
device is encrypted) don't currently work |
|
808 |
|
|
764 | 809 |
3. Query Commands |
765 | 810 |
================= |
766 | 811 |
|
Also available in: Unified diff