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