hmp-commands.hx

   1 HXCOMM Use DEFHEADING() to define headings in both help text and texi
   2 HXCOMM Text between STEXI and ETEXI are copied to texi version and
   3 HXCOMM discarded from C version
   4 HXCOMM DEF(command, args, callback, arg_string, help) is used to construct
   5 HXCOMM monitor commands
   6 HXCOMM HXCOMM can be used for comments, discarded from both texi and C
   7
   8 STEXI
   9 @table @option
  10 ETEXI
  11
  12     {
  13         .name       = "help|?",
  14         .args_type  = "name:s?",
  15         .params     = "[cmd]",
  16         .help       = "show the help",
  17         .mhandler.cmd = do_help_cmd,
  18     },
  19
  20 STEXI
  21 @item help or ? [@var{cmd}]
  22 @findex help
  23 Show the help for all commands or just for command @var{cmd}.
  24 ETEXI
  25
  26     {
  27         .name       = "commit",
  28         .args_type  = "device:B",
  29         .params     = "device|all",
  30         .help       = "commit changes to the disk images (if -snapshot is used) or backing files",
  31         .mhandler.cmd = do_commit,
  32     },
  33
  34 STEXI
  35 @item commit
  36 @findex commit
  37 Commit changes to the disk images (if -snapshot is used) or backing files.
  38 ETEXI
  39
  40     {
  41         .name       = "q|quit",
  42         .args_type  = "",
  43         .params     = "",
  44         .help       = "quit the emulator",
  45         .user_print = monitor_user_noop,
  46         .mhandler.cmd_new = do_quit,
  47     },
  48
  49 STEXI
  50 @item q or quit
  51 @findex quit
  52 Quit the emulator.
  53 ETEXI
  54
  55     {
  56         .name       = "eject",
  57         .args_type  = "force:-f,device:B",
  58         .params     = "[-f] device",
  59         .help       = "eject a removable medium (use -f to force it)",
  60         .user_print = monitor_user_noop,
  61         .mhandler.cmd_new = do_eject,
  62     },
  63
  64 STEXI
  65 @item eject [-f] @var{device}
  66 @findex eject
  67 Eject a removable medium (use -f to force it).
  68 ETEXI
  69
  70     {
  71         .name       = "drive_del",
  72         .args_type  = "id:s",
  73         .params     = "device",
  74         .help       = "remove host block device",
  75         .user_print = monitor_user_noop,
  76         .mhandler.cmd_new = do_drive_del,
  77     },
  78
  79 STEXI
  80 @item drive_del @var{device}
  81 @findex drive_del
  82 Remove host block device.  The result is that guest generated IO is no longer
  83 submitted against the host device underlying the disk.  Once a drive has
  84 been deleted, the QEMU Block layer returns -EIO which results in IO
  85 errors in the guest for applications that are reading/writing to the device.
  86 ETEXI
  87
  88     {
  89         .name       = "change",
  90         .args_type  = "device:B,target:F,arg:s?",
  91         .params     = "device filename [format]",
  92         .help       = "change a removable medium, optional format",
  93         .user_print = monitor_user_noop,
  94         .mhandler.cmd_new = do_change,
  95     },
  96
  97 STEXI
  98 @item change @var{device} @var{setting}
  99 @findex change
 100
 101 Change the configuration of a device.
 102
 103 @table @option
 104 @item change @var{diskdevice} @var{filename} [@var{format}]
 105 Change the medium for a removable disk device to point to @var{filename}. eg
 106
 107 @example
 108 (qemu) change ide1-cd0 /path/to/some.iso
 109 @end example
 110
 111 @var{format} is optional.
 112
 113 @item change vnc @var{display},@var{options}
 114 Change the configuration of the VNC server. The valid syntax for @var{display}
 115 and @var{options} are described at @ref{sec_invocation}. eg
 116
 117 @example
 118 (qemu) change vnc localhost:1
 119 @end example
 120
 121 @item change vnc password [@var{password}]
 122
 123 Change the password associated with the VNC server. If the new password is not
 124 supplied, the monitor will prompt for it to be entered. VNC passwords are only
 125 significant up to 8 letters. eg
 126
 127 @example
 128 (qemu) change vnc password
 129 Password: ********
 130 @end example
 131
 132 @end table
 133 ETEXI
 134
 135     {
 136         .name       = "screendump",
 137         .args_type  = "filename:F",
 138         .params     = "filename",
 139         .help       = "save screen into PPM image 'filename'",
 140         .user_print = monitor_user_noop,
 141         .mhandler.cmd_new = do_screen_dump,
 142     },
 143
 144 STEXI
 145 @item screendump @var{filename}
 146 @findex screendump
 147 Save screen into PPM image @var{filename}.
 148 ETEXI
 149
 150     {
 151         .name       = "logfile",
 152         .args_type  = "filename:F",
 153         .params     = "filename",
 154         .help       = "output logs to 'filename'",
 155         .mhandler.cmd = do_logfile,
 156     },
 157
 158 STEXI
 159 @item logfile @var{filename}
 160 @findex logfile
 161 Output logs to @var{filename}.
 162 ETEXI
 163
 164 #ifdef CONFIG_SIMPLE_TRACE
 165     {
 166         .name       = "trace-event",
 167         .args_type  = "name:s,option:b",
 168         .params     = "name on|off",
 169         .help       = "changes status of a specific trace event",
 170         .mhandler.cmd = do_change_trace_event_state,
 171     },
 172
 173 STEXI
 174 @item trace-event
 175 @findex trace-event
 176 changes status of a trace event
 177 ETEXI
 178
 179     {
 180         .name       = "trace-file",
 181         .args_type  = "op:s?,arg:F?",
 182         .params     = "on|off|flush|set [arg]",
 183         .help       = "open, close, or flush trace file, or set a new file name",
 184         .mhandler.cmd = do_trace_file,
 185     },
 186
 187 STEXI
 188 @item trace-file on|off|flush
 189 @findex trace-file
 190 Open, close, or flush the trace file.  If no argument is given, the status of the trace file is displayed.
 191 ETEXI
 192 #endif
 193
 194     {
 195         .name       = "log",
 196         .args_type  = "items:s",
 197         .params     = "item1[,...]",
 198         .help       = "activate logging of the specified items to '/tmp/qemu.log'",
 199         .mhandler.cmd = do_log,
 200     },
 201
 202 STEXI
 203 @item log @var{item1}[,...]
 204 @findex log
 205 Activate logging of the specified items to @file{/tmp/qemu.log}.
 206 ETEXI
 207
 208     {
 209         .name       = "savevm",
 210         .args_type  = "name:s?",
 211         .params     = "[tag|id]",
 212         .help       = "save a VM snapshot. If no tag or id are provided, a new snapshot is created",
 213         .mhandler.cmd = do_savevm,
 214     },
 215
 216 STEXI
 217 @item savevm [@var{tag}|@var{id}]
 218 @findex savevm
 219 Create a snapshot of the whole virtual machine. If @var{tag} is
 220 provided, it is used as human readable identifier. If there is already
 221 a snapshot with the same tag or ID, it is replaced. More info at
 222 @ref{vm_snapshots}.
 223 ETEXI
 224
 225     {
 226         .name       = "loadvm",
 227         .args_type  = "name:s",
 228         .params     = "tag|id",
 229         .help       = "restore a VM snapshot from its tag or id",
 230         .mhandler.cmd = do_loadvm,
 231     },
 232
 233 STEXI
 234 @item loadvm @var{tag}|@var{id}
 235 @findex loadvm
 236 Set the whole virtual machine to the snapshot identified by the tag
 237 @var{tag} or the unique snapshot ID @var{id}.
 238 ETEXI
 239
 240     {
 241         .name       = "delvm",
 242         .args_type  = "name:s",
 243         .params     = "tag|id",
 244         .help       = "delete a VM snapshot from its tag or id",
 245         .mhandler.cmd = do_delvm,
 246     },
 247
 248 STEXI
 249 @item delvm @var{tag}|@var{id}
 250 @findex delvm
 251 Delete the snapshot identified by @var{tag} or @var{id}.
 252 ETEXI
 253
 254     {
 255         .name       = "singlestep",
 256         .args_type  = "option:s?",
 257         .params     = "[on|off]",
 258         .help       = "run emulation in singlestep mode or switch to normal mode",
 259         .mhandler.cmd = do_singlestep,
 260     },
 261
 262 STEXI
 263 @item singlestep [off]
 264 @findex singlestep
 265 Run the emulation in single step mode.
 266 If called with option off, the emulation returns to normal mode.
 267 ETEXI
 268
 269     {
 270         .name       = "stop",
 271         .args_type  = "",
 272         .params     = "",
 273         .help       = "stop emulation",
 274         .user_print = monitor_user_noop,
 275         .mhandler.cmd_new = do_stop,
 276     },
 277
 278 STEXI
 279 @item stop
 280 @findex stop
 281 Stop emulation.
 282 ETEXI
 283
 284     {
 285         .name       = "c|cont",
 286         .args_type  = "",
 287         .params     = "",
 288         .help       = "resume emulation",
 289         .user_print = monitor_user_noop,
 290         .mhandler.cmd_new = do_cont,
 291     },
 292
 293 STEXI
 294 @item c or cont
 295 @findex cont
 296 Resume emulation.
 297 ETEXI
 298
 299     {
 300         .name       = "gdbserver",
 301         .args_type  = "device:s?",
 302         .params     = "[device]",
 303         .help       = "start gdbserver on given device (default 'tcp::1234'), stop with 'none'",
 304         .mhandler.cmd = do_gdbserver,
 305     },
 306
 307 STEXI
 308 @item gdbserver [@var{port}]
 309 @findex gdbserver
 310 Start gdbserver session (default @var{port}=1234)
 311 ETEXI
 312
 313     {
 314         .name       = "x",
 315         .args_type  = "fmt:/,addr:l",
 316         .params     = "/fmt addr",
 317         .help       = "virtual memory dump starting at 'addr'",
 318         .mhandler.cmd = do_memory_dump,
 319     },
 320
 321 STEXI
 322 @item x/fmt @var{addr}
 323 @findex x
 324 Virtual memory dump starting at @var{addr}.
 325 ETEXI
 326
 327     {
 328         .name       = "xp",
 329         .args_type  = "fmt:/,addr:l",
 330         .params     = "/fmt addr",
 331         .help       = "physical memory dump starting at 'addr'",
 332         .mhandler.cmd = do_physical_memory_dump,
 333     },
 334
 335 STEXI
 336 @item xp /@var{fmt} @var{addr}
 337 @findex xp
 338 Physical memory dump starting at @var{addr}.
 339
 340 @var{fmt} is a format which tells the command how to format the
 341 data. Its syntax is: @option{/@{count@}@{format@}@{size@}}
 342
 343 @table @var
 344 @item count
 345 is the number of items to be dumped.
 346
 347 @item format
 348 can be x (hex), d (signed decimal), u (unsigned decimal), o (octal),
 349 c (char) or i (asm instruction).
 350
 351 @item size
 352 can be b (8 bits), h (16 bits), w (32 bits) or g (64 bits). On x86,
 353 @code{h} or @code{w} can be specified with the @code{i} format to
 354 respectively select 16 or 32 bit code instruction size.
 355
 356 @end table
 357
 358 Examples:
 359 @itemize
 360 @item
 361 Dump 10 instructions at the current instruction pointer:
 362 @example
 363 (qemu) x/10i $eip
 364 0x90107063:  ret
 365 0x90107064:  sti
 366 0x90107065:  lea    0x0(%esi,1),%esi
 367 0x90107069:  lea    0x0(%edi,1),%edi
 368 0x90107070:  ret
 369 0x90107071:  jmp    0x90107080
 370 0x90107073:  nop
 371 0x90107074:  nop
 372 0x90107075:  nop
 373 0x90107076:  nop
 374 @end example
 375
 376 @item
 377 Dump 80 16 bit values at the start of the video memory.
 378 @smallexample
 379 (qemu) xp/80hx 0xb8000
 380 0x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42
 381 0x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41
 382 0x000b8020: 0x0b42 0x0b69 0x0b6f 0x0b73 0x0b20 0x0b63 0x0b75 0x0b72
 383 0x000b8030: 0x0b72 0x0b65 0x0b6e 0x0b74 0x0b2d 0x0b63 0x0b76 0x0b73
 384 0x000b8040: 0x0b20 0x0b30 0x0b35 0x0b20 0x0b4e 0x0b6f 0x0b76 0x0b20
 385 0x000b8050: 0x0b32 0x0b30 0x0b30 0x0b33 0x0720 0x0720 0x0720 0x0720
 386 0x000b8060: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
 387 0x000b8070: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
 388 0x000b8080: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
 389 0x000b8090: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
 390 @end smallexample
 391 @end itemize
 392 ETEXI
 393
 394     {
 395         .name       = "p|print",
 396         .args_type  = "fmt:/,val:l",
 397         .params     = "/fmt expr",
 398         .help       = "print expression value (use $reg for CPU register access)",
 399         .mhandler.cmd = do_print,
 400     },
 401
 402 STEXI
 403 @item p or print/@var{fmt} @var{expr}
 404 @findex print
 405
 406 Print expression value. Only the @var{format} part of @var{fmt} is
 407 used.
 408 ETEXI
 409
 410     {
 411         .name       = "i",
 412         .args_type  = "fmt:/,addr:i,index:i.",
 413         .params     = "/fmt addr",
 414         .help       = "I/O port read",
 415         .mhandler.cmd = do_ioport_read,
 416     },
 417
 418 STEXI
 419 Read I/O port.
 420 ETEXI
 421
 422     {
 423         .name       = "o",
 424         .args_type  = "fmt:/,addr:i,val:i",
 425         .params     = "/fmt addr value",
 426         .help       = "I/O port write",
 427         .mhandler.cmd = do_ioport_write,
 428     },
 429
 430 STEXI
 431 Write to I/O port.
 432 ETEXI
 433
 434     {
 435         .name       = "sendkey",
 436         .args_type  = "string:s,hold_time:i?",
 437         .params     = "keys [hold_ms]",
 438         .help       = "send keys to the VM (e.g. 'sendkey ctrl-alt-f1', default hold time=100 ms)",
 439         .mhandler.cmd = do_sendkey,
 440     },
 441
 442 STEXI
 443 @item sendkey @var{keys}
 444 @findex sendkey
 445
 446 Send @var{keys} to the emulator. @var{keys} could be the name of the
 447 key or @code{#} followed by the raw value in either decimal or hexadecimal
 448 format. Use @code{-} to press several keys simultaneously. Example:
 449 @example
 450 sendkey ctrl-alt-f1
 451 @end example
 452
 453 This command is useful to send keys that your graphical user interface
 454 intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
 455 ETEXI
 456
 457     {
 458         .name       = "system_reset",
 459         .args_type  = "",
 460         .params     = "",
 461         .help       = "reset the system",
 462         .user_print = monitor_user_noop,
 463         .mhandler.cmd_new = do_system_reset,
 464     },
 465
 466 STEXI
 467 @item system_reset
 468 @findex system_reset
 469
 470 Reset the system.
 471 ETEXI
 472
 473     {
 474         .name       = "system_powerdown",
 475         .args_type  = "",
 476         .params     = "",
 477         .help       = "send system power down event",
 478         .user_print = monitor_user_noop,
 479         .mhandler.cmd_new = do_system_powerdown,
 480     },
 481
 482 STEXI
 483 @item system_powerdown
 484 @findex system_powerdown
 485
 486 Power down the system (if supported).
 487 ETEXI
 488
 489     {
 490         .name       = "sum",
 491         .args_type  = "start:i,size:i",
 492         .params     = "addr size",
 493         .help       = "compute the checksum of a memory region",
 494         .mhandler.cmd = do_sum,
 495     },
 496
 497 STEXI
 498 @item sum @var{addr} @var{size}
 499 @findex sum
 500
 501 Compute the checksum of a memory region.
 502 ETEXI
 503
 504     {
 505         .name       = "usb_add",
 506         .args_type  = "devname:s",
 507         .params     = "device",
 508         .help       = "add USB device (e.g. 'host:bus.addr' or 'host:vendor_id:product_id')",
 509         .mhandler.cmd = do_usb_add,
 510     },
 511
 512 STEXI
 513 @item usb_add @var{devname}
 514 @findex usb_add
 515
 516 Add the USB device @var{devname}.  For details of available devices see
 517 @ref{usb_devices}
 518 ETEXI
 519
 520     {
 521         .name       = "usb_del",
 522         .args_type  = "devname:s",
 523         .params     = "device",
 524         .help       = "remove USB device 'bus.addr'",
 525         .mhandler.cmd = do_usb_del,
 526     },
 527
 528 STEXI
 529 @item usb_del @var{devname}
 530 @findex usb_del
 531
 532 Remove the USB device @var{devname} from the QEMU virtual USB
 533 hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor
 534 command @code{info usb} to see the devices you can remove.
 535 ETEXI
 536
 537     {
 538         .name       = "device_add",
 539         .args_type  = "device:O",
 540         .params     = "driver[,prop=value][,...]",
 541         .help       = "add device, like -device on the command line",
 542         .user_print = monitor_user_noop,
 543         .mhandler.cmd_new = do_device_add,
 544     },
 545
 546 STEXI
 547 @item device_add @var{config}
 548 @findex device_add
 549
 550 Add device.
 551 ETEXI
 552
 553     {
 554         .name       = "device_del",
 555         .args_type  = "id:s",
 556         .params     = "device",
 557         .help       = "remove device",
 558         .user_print = monitor_user_noop,
 559         .mhandler.cmd_new = do_device_del,
 560     },
 561
 562 STEXI
 563 @item device_del @var{id}
 564 @findex device_del
 565
 566 Remove device @var{id}.
 567 ETEXI
 568
 569     {
 570         .name       = "cpu",
 571         .args_type  = "index:i",
 572         .params     = "index",
 573         .help       = "set the default CPU",
 574         .user_print = monitor_user_noop,
 575         .mhandler.cmd_new = do_cpu_set,
 576     },
 577
 578 STEXI
 579 @item cpu @var{index}
 580 @findex cpu
 581 Set the default CPU.
 582 ETEXI
 583
 584     {
 585         .name       = "mouse_move",
 586         .args_type  = "dx_str:s,dy_str:s,dz_str:s?",
 587         .params     = "dx dy [dz]",
 588         .help       = "send mouse move events",
 589         .mhandler.cmd = do_mouse_move,
 590     },
 591
 592 STEXI
 593 @item mouse_move @var{dx} @var{dy} [@var{dz}]
 594 @findex mouse_move
 595 Move the active mouse to the specified coordinates @var{dx} @var{dy}
 596 with optional scroll axis @var{dz}.
 597 ETEXI
 598
 599     {
 600         .name       = "mouse_button",
 601         .args_type  = "button_state:i",
 602         .params     = "state",
 603         .help       = "change mouse button state (1=L, 2=M, 4=R)",
 604         .mhandler.cmd = do_mouse_button,
 605     },
 606
 607 STEXI
 608 @item mouse_button @var{val}
 609 @findex mouse_button
 610 Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
 611 ETEXI
 612
 613     {
 614         .name       = "mouse_set",
 615         .args_type  = "index:i",
 616         .params     = "index",
 617         .help       = "set which mouse device receives events",
 618         .mhandler.cmd = do_mouse_set,
 619     },
 620
 621 STEXI
 622 @item mouse_set @var{index}
 623 @findex mouse_set
 624 Set which mouse device receives events at given @var{index}, index
 625 can be obtained with
 626 @example
 627 info mice
 628 @end example
 629 ETEXI
 630
 631 #ifdef HAS_AUDIO
 632     {
 633         .name       = "wavcapture",
 634         .args_type  = "path:F,freq:i?,bits:i?,nchannels:i?",
 635         .params     = "path [frequency [bits [channels]]]",
 636         .help       = "capture audio to a wave file (default frequency=44100 bits=16 channels=2)",
 637         .mhandler.cmd = do_wav_capture,
 638     },
 639 #endif
 640 STEXI
 641 @item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]
 642 @findex wavcapture
 643 Capture audio into @var{filename}. Using sample rate @var{frequency}
 644 bits per sample @var{bits} and number of channels @var{channels}.
 645
 646 Defaults:
 647 @itemize @minus
 648 @item Sample rate = 44100 Hz - CD quality
 649 @item Bits = 16
 650 @item Number of channels = 2 - Stereo
 651 @end itemize
 652 ETEXI
 653
 654 #ifdef HAS_AUDIO
 655     {
 656         .name       = "stopcapture",
 657         .args_type  = "n:i",
 658         .params     = "capture index",
 659         .help       = "stop capture",
 660         .mhandler.cmd = do_stop_capture,
 661     },
 662 #endif
 663 STEXI
 664 @item stopcapture @var{index}
 665 @findex stopcapture
 666 Stop capture with a given @var{index}, index can be obtained with
 667 @example
 668 info capture
 669 @end example
 670 ETEXI
 671
 672     {
 673         .name       = "memsave",
 674         .args_type  = "val:l,size:i,filename:s",
 675         .params     = "addr size file",
 676         .help       = "save to disk virtual memory dump starting at 'addr' of size 'size'",
 677         .user_print = monitor_user_noop,
 678         .mhandler.cmd_new = do_memory_save,
 679     },
 680
 681 STEXI
 682 @item memsave @var{addr} @var{size} @var{file}
 683 @findex memsave
 684 save to disk virtual memory dump starting at @var{addr} of size @var{size}.
 685 ETEXI
 686
 687     {
 688         .name       = "pmemsave",
 689         .args_type  = "val:l,size:i,filename:s",
 690         .params     = "addr size file",
 691         .help       = "save to disk physical memory dump starting at 'addr' of size 'size'",
 692         .user_print = monitor_user_noop,
 693         .mhandler.cmd_new = do_physical_memory_save,
 694     },
 695
 696 STEXI
 697 @item pmemsave @var{addr} @var{size} @var{file}
 698 @findex pmemsave
 699 save to disk physical memory dump starting at @var{addr} of size @var{size}.
 700 ETEXI
 701
 702     {
 703         .name       = "boot_set",
 704         .args_type  = "bootdevice:s",
 705         .params     = "bootdevice",
 706         .help       = "define new values for the boot device list",
 707         .mhandler.cmd = do_boot_set,
 708     },
 709
 710 STEXI
 711 @item boot_set @var{bootdevicelist}
 712 @findex boot_set
 713
 714 Define new values for the boot device list. Those values will override
 715 the values specified on the command line through the @code{-boot} option.
 716
 717 The values that can be specified here depend on the machine type, but are
 718 the same that can be specified in the @code{-boot} command line option.
 719 ETEXI
 720
 721 #if defined(TARGET_I386)
 722     {
 723         .name       = "nmi",
 724         .args_type  = "cpu_index:i",
 725         .params     = "cpu",
 726         .help       = "inject an NMI on the given CPU",
 727         .mhandler.cmd = do_inject_nmi,
 728     },
 729 #endif
 730 STEXI
 731 @item nmi @var{cpu}
 732 @findex nmi
 733 Inject an NMI on the given CPU (x86 only).
 734 ETEXI
 735
 736     {
 737         .name       = "migrate",
 738         .args_type  = "detach:-d,blk:-b,inc:-i,uri:s",
 739         .params     = "[-d] [-b] [-i] uri",
 740         .help       = "migrate to URI (using -d to not wait for completion)"
 741                       "\n\t\t\t -b for migration without shared storage with"
 742                       " full copy of disk\n\t\t\t -i for migration without "
 743                       "shared storage with incremental copy of disk "
 744                       "(base image shared between src and destination)",
 745         .user_print = monitor_user_noop,
 746         .mhandler.cmd_new = do_migrate,
 747     },
 748
 749
 750 STEXI
 751 @item migrate [-d] [-b] [-i] @var{uri}
 752 @findex migrate
 753 Migrate to @var{uri} (using -d to not wait for completion).
 754         -b for migration with full copy of disk
 755         -i for migration with incremental copy of disk (base image is shared)
 756 ETEXI
 757
 758     {
 759         .name       = "migrate_cancel",
 760         .args_type  = "",
 761         .params     = "",
 762         .help       = "cancel the current VM migration",
 763         .user_print = monitor_user_noop,
 764         .mhandler.cmd_new = do_migrate_cancel,
 765     },
 766
 767 STEXI
 768 @item migrate_cancel
 769 @findex migrate_cancel
 770 Cancel the current VM migration.
 771 ETEXI
 772
 773     {
 774         .name       = "migrate_set_speed",
 775         .args_type  = "value:o",
 776         .params     = "value",
 777         .help       = "set maximum speed (in bytes) for migrations. "
 778         "Defaults to MB if no size suffix is specified, ie. B/K/M/G/T",
 779         .user_print = monitor_user_noop,
 780         .mhandler.cmd_new = do_migrate_set_speed,
 781     },
 782
 783 STEXI
 784 @item migrate_set_speed @var{value}
 785 @findex migrate_set_speed
 786 Set maximum speed to @var{value} (in bytes) for migrations.
 787 ETEXI
 788
 789     {
 790         .name       = "migrate_set_downtime",
 791         .args_type  = "value:T",
 792         .params     = "value",
 793         .help       = "set maximum tolerated downtime (in seconds) for migrations",
 794         .user_print = monitor_user_noop,
 795         .mhandler.cmd_new = do_migrate_set_downtime,
 796     },
 797
 798 STEXI
 799 @item migrate_set_downtime @var{second}
 800 @findex migrate_set_downtime
 801 Set maximum tolerated downtime (in seconds) for migration.
 802 ETEXI
 803
 804     {
 805         .name       = "snapshot_blkdev",
 806         .args_type  = "device:s,snapshot_file:s?,format:s?",
 807         .params     = "device [new-image-file] [format]",
 808         .help       = "initiates a live snapshot\n\t\t\t"
 809                       "of device. If a new image file is specified, the\n\t\t\t"
 810                       "new image file will become the new root image.\n\t\t\t"
 811                       "If format is specified, the snapshot file will\n\t\t\t"
 812                       "be created in that format. Otherwise the\n\t\t\t"
 813                       "snapshot will be internal! (currently unsupported)",
 814         .mhandler.cmd_new = do_snapshot_blkdev,
 815     },
 816
 817 STEXI
 818 @item snapshot_blkdev
 819 @findex snapshot_blkdev
 820 Snapshot device, using snapshot file as target if provided
 821 ETEXI
 822
 823 #if defined(TARGET_I386)
 824     {
 825         .name       = "drive_add",
 826         .args_type  = "pci_addr:s,opts:s",
 827         .params     = "[[<domain>:]<bus>:]<slot>\n"
 828                       "[file=file][,if=type][,bus=n]\n"
 829                       "[,unit=m][,media=d][index=i]\n"
 830                       "[,cyls=c,heads=h,secs=s[,trans=t]]\n"
 831                       "[snapshot=on|off][,cache=on|off]",
 832         .help       = "add drive to PCI storage controller",
 833         .mhandler.cmd = drive_hot_add,
 834     },
 835 #endif
 836
 837 STEXI
 838 @item drive_add
 839 @findex drive_add
 840 Add drive to PCI storage controller.
 841 ETEXI
 842
 843 #if defined(TARGET_I386)
 844     {
 845         .name       = "pci_add",
 846         .args_type  = "pci_addr:s,type:s,opts:s?",
 847         .params     = "auto|[[<domain>:]<bus>:]<slot> nic|storage [[vlan=n][,macaddr=addr][,model=type]] [file=file][,if=type][,bus=nr]...",
 848         .help       = "hot-add PCI device",
 849         .mhandler.cmd = pci_device_hot_add,
 850     },
 851 #endif
 852
 853 STEXI
 854 @item pci_add
 855 @findex pci_add
 856 Hot-add PCI device.
 857 ETEXI
 858
 859 #if defined(TARGET_I386)
 860     {
 861         .name       = "pci_del",
 862         .args_type  = "pci_addr:s",
 863         .params     = "[[<domain>:]<bus>:]<slot>",
 864         .help       = "hot remove PCI device",
 865         .mhandler.cmd = do_pci_device_hot_remove,
 866     },
 867 #endif
 868
 869 STEXI
 870 @item pci_del
 871 @findex pci_del
 872 Hot remove PCI device.
 873 ETEXI
 874
 875     {
 876         .name       = "host_net_add",
 877         .args_type  = "device:s,opts:s?",
 878         .params     = "tap|user|socket|vde|dump [options]",
 879         .help       = "add host VLAN client",
 880         .mhandler.cmd = net_host_device_add,
 881     },
 882
 883 STEXI
 884 @item host_net_add
 885 @findex host_net_add
 886 Add host VLAN client.
 887 ETEXI
 888
 889     {
 890         .name       = "host_net_remove",
 891         .args_type  = "vlan_id:i,device:s",
 892         .params     = "vlan_id name",
 893         .help       = "remove host VLAN client",
 894         .mhandler.cmd = net_host_device_remove,
 895     },
 896
 897 STEXI
 898 @item host_net_remove
 899 @findex host_net_remove
 900 Remove host VLAN client.
 901 ETEXI
 902
 903     {
 904         .name       = "netdev_add",
 905         .args_type  = "netdev:O",
 906         .params     = "[user|tap|socket],id=str[,prop=value][,...]",
 907         .help       = "add host network device",
 908         .user_print = monitor_user_noop,
 909         .mhandler.cmd_new = do_netdev_add,
 910     },
 911
 912 STEXI
 913 @item netdev_add
 914 @findex netdev_add
 915 Add host network device.
 916 ETEXI
 917
 918     {
 919         .name       = "netdev_del",
 920         .args_type  = "id:s",
 921         .params     = "id",
 922         .help       = "remove host network device",
 923         .user_print = monitor_user_noop,
 924         .mhandler.cmd_new = do_netdev_del,
 925     },
 926
 927 STEXI
 928 @item netdev_del
 929 @findex netdev_del
 930 Remove host network device.
 931 ETEXI
 932
 933 #ifdef CONFIG_SLIRP
 934     {
 935         .name       = "hostfwd_add",
 936         .args_type  = "arg1:s,arg2:s?,arg3:s?",
 937         .params     = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport",
 938         .help       = "redirect TCP or UDP connections from host to guest (requires -net user)",
 939         .mhandler.cmd = net_slirp_hostfwd_add,
 940     },
 941 #endif
 942 STEXI
 943 @item hostfwd_add
 944 @findex hostfwd_add
 945 Redirect TCP or UDP connections from host to guest (requires -net user).
 946 ETEXI
 947
 948 #ifdef CONFIG_SLIRP
 949     {
 950         .name       = "hostfwd_remove",
 951         .args_type  = "arg1:s,arg2:s?,arg3:s?",
 952         .params     = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport",
 953         .help       = "remove host-to-guest TCP or UDP redirection",
 954         .mhandler.cmd = net_slirp_hostfwd_remove,
 955     },
 956
 957 #endif
 958 STEXI
 959 @item hostfwd_remove
 960 @findex hostfwd_remove
 961 Remove host-to-guest TCP or UDP redirection.
 962 ETEXI
 963
 964     {
 965         .name       = "balloon",
 966         .args_type  = "value:M",
 967         .params     = "target",
 968         .help       = "request VM to change its memory allocation (in MB)",
 969         .user_print = monitor_user_noop,
 970         .mhandler.cmd_async = do_balloon,
 971         .flags      = MONITOR_CMD_ASYNC,
 972     },
 973
 974 STEXI
 975 @item balloon @var{value}
 976 @findex balloon
 977 Request VM to change its memory allocation to @var{value} (in MB).
 978 ETEXI
 979
 980     {
 981         .name       = "set_link",
 982         .args_type  = "name:s,up:b",
 983         .params     = "name on|off",
 984         .help       = "change the link status of a network adapter",
 985         .user_print = monitor_user_noop,
 986         .mhandler.cmd_new = do_set_link,
 987     },
 988
 989 STEXI
 990 @item set_link @var{name} [on|off]
 991 @findex set_link
 992 Switch link @var{name} on (i.e. up) or off (i.e. down).
 993 ETEXI
 994
 995     {
 996         .name       = "watchdog_action",
 997         .args_type  = "action:s",
 998         .params     = "[reset|shutdown|poweroff|pause|debug|none]",
 999         .help       = "change watchdog action",
1000         .mhandler.cmd = do_watchdog_action,
1001     },
1002
1003 STEXI
1004 @item watchdog_action
1005 @findex watchdog_action
1006 Change watchdog action.
1007 ETEXI
1008
1009     {
1010         .name       = "acl_show",
1011         .args_type  = "aclname:s",
1012         .params     = "aclname",
1013         .help       = "list rules in the access control list",
1014         .mhandler.cmd = do_acl_show,
1015     },
1016
1017 STEXI
1018 @item acl_show @var{aclname}
1019 @findex acl_show
1020 List all the matching rules in the access control list, and the default
1021 policy. There are currently two named access control lists,
1022 @var{vnc.x509dname} and @var{vnc.username} matching on the x509 client
1023 certificate distinguished name, and SASL username respectively.
1024 ETEXI
1025
1026     {
1027         .name       = "acl_policy",
1028         .args_type  = "aclname:s,policy:s",
1029         .params     = "aclname allow|deny",
1030         .help       = "set default access control list policy",
1031         .mhandler.cmd = do_acl_policy,
1032     },
1033
1034 STEXI
1035 @item acl_policy @var{aclname} @code{allow|deny}
1036 @findex acl_policy
1037 Set the default access control list policy, used in the event that
1038 none of the explicit rules match. The default policy at startup is
1039 always @code{deny}.
1040 ETEXI
1041
1042     {
1043         .name       = "acl_add",
1044         .args_type  = "aclname:s,match:s,policy:s,index:i?",
1045         .params     = "aclname match allow|deny [index]",
1046         .help       = "add a match rule to the access control list",
1047         .mhandler.cmd = do_acl_add,
1048     },
1049
1050 STEXI
1051 @item acl_add @var{aclname} @var{match} @code{allow|deny} [@var{index}]
1052 @findex acl_add
1053 Add a match rule to the access control list, allowing or denying access.
1054 The match will normally be an exact username or x509 distinguished name,
1055 but can optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to
1056 allow all users in the @code{EXAMPLE.COM} kerberos realm. The match will
1057 normally be appended to the end of the ACL, but can be inserted
1058 earlier in the list if the optional @var{index} parameter is supplied.
1059 ETEXI
1060
1061     {
1062         .name       = "acl_remove",
1063         .args_type  = "aclname:s,match:s",
1064         .params     = "aclname match",
1065         .help       = "remove a match rule from the access control list",
1066         .mhandler.cmd = do_acl_remove,
1067     },
1068
1069 STEXI
1070 @item acl_remove @var{aclname} @var{match}
1071 @findex acl_remove
1072 Remove the specified match rule from the access control list.
1073 ETEXI
1074
1075     {
1076         .name       = "acl_reset",
1077         .args_type  = "aclname:s",
1078         .params     = "aclname",
1079         .help       = "reset the access control list",
1080         .mhandler.cmd = do_acl_reset,
1081     },
1082
1083 STEXI
1084 @item acl_reset @var{aclname}
1085 @findex acl_reset
1086 Remove all matches from the access control list, and set the default
1087 policy back to @code{deny}.
1088 ETEXI
1089
1090 #if defined(TARGET_I386)
1091
1092     {
1093         .name       = "mce",
1094         .args_type  = "cpu_index:i,bank:i,status:l,mcg_status:l,addr:l,misc:l",
1095         .params     = "cpu bank status mcgstatus addr misc",
1096         .help       = "inject a MCE on the given CPU",
1097         .mhandler.cmd = do_inject_mce,
1098     },
1099
1100 #endif
1101 STEXI
1102 @item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc}
1103 @findex mce (x86)
1104 Inject an MCE on the given CPU (x86 only).
1105 ETEXI
1106
1107     {
1108         .name       = "getfd",
1109         .args_type  = "fdname:s",
1110         .params     = "getfd name",
1111         .help       = "receive a file descriptor via SCM rights and assign it a name",
1112         .user_print = monitor_user_noop,
1113         .mhandler.cmd_new = do_getfd,
1114     },
1115
1116 STEXI
1117 @item getfd @var{fdname}
1118 @findex getfd
1119 If a file descriptor is passed alongside this command using the SCM_RIGHTS
1120 mechanism on unix sockets, it is stored using the name @var{fdname} for
1121 later use by other monitor commands.
1122 ETEXI
1123
1124     {
1125         .name       = "closefd",
1126         .args_type  = "fdname:s",
1127         .params     = "closefd name",
1128         .help       = "close a file descriptor previously passed via SCM rights",
1129         .user_print = monitor_user_noop,
1130         .mhandler.cmd_new = do_closefd,
1131     },
1132
1133 STEXI
1134 @item closefd @var{fdname}
1135 @findex closefd
1136 Close the file descriptor previously assigned to @var{fdname} using the
1137 @code{getfd} command. This is only needed if the file descriptor was never
1138 used by another monitor command.
1139 ETEXI
1140
1141     {
1142         .name       = "block_passwd",
1143         .args_type  = "device:B,password:s",
1144         .params     = "block_passwd device password",
1145         .help       = "set the password of encrypted block devices",
1146         .user_print = monitor_user_noop,
1147         .mhandler.cmd_new = do_block_set_passwd,
1148     },
1149
1150 STEXI
1151 @item block_passwd @var{device} @var{password}
1152 @findex block_passwd
1153 Set the encrypted device @var{device} password to @var{password}
1154 ETEXI
1155
1156     {
1157         .name       = "set_password",
1158         .args_type  = "protocol:s,password:s,connected:s?",
1159         .params     = "protocol password action-if-connected",
1160         .help       = "set spice/vnc password",
1161         .user_print = monitor_user_noop,
1162         .mhandler.cmd_new = set_password,
1163     },
1164
1165 STEXI
1166 @item set_password [ vnc | spice ] password [ action-if-connected ]
1167 @findex set_password
1168
1169 Change spice/vnc password.  Use zero to make the password stay valid
1170 forever.  @var{action-if-connected} specifies what should happen in
1171 case a connection is established: @var{fail} makes the password change
1172 fail.  @var{disconnect} changes the password and disconnects the
1173 client.  @var{keep} changes the password and keeps the connection up.
1174 @var{keep} is the default.
1175 ETEXI
1176
1177     {
1178         .name       = "expire_password",
1179         .args_type  = "protocol:s,time:s",
1180         .params     = "protocol time",
1181         .help       = "set spice/vnc password expire-time",
1182         .user_print = monitor_user_noop,
1183         .mhandler.cmd_new = expire_password,
1184     },
1185
1186 STEXI
1187 @item expire_password [ vnc | spice ] expire-time
1188 @findex expire_password
1189
1190 Specify when a password for spice/vnc becomes
1191 invalid. @var{expire-time} accepts:
1192
1193 @table @var
1194 @item now
1195 Invalidate password instantly.
1196
1197 @item never
1198 Password stays valid forever.
1199
1200 @item +nsec
1201 Password stays valid for @var{nsec} seconds starting now.
1202
1203 @item nsec
1204 Password is invalidated at the given time.  @var{nsec} are the seconds
1205 passed since 1970, i.e. unix epoch.
1206
1207 @end table
1208 ETEXI
1209
1210     {
1211         .name       = "info",
1212         .args_type  = "item:s?",
1213         .params     = "[subcommand]",
1214         .help       = "show various information about the system state",
1215         .mhandler.cmd = do_info,
1216     },
1217
1218 STEXI
1219 @item info @var{subcommand}
1220 @findex info
1221 Show various information about the system state.
1222
1223 @table @option
1224 @item info version
1225 show the version of QEMU
1226 @item info network
1227 show the various VLANs and the associated devices
1228 @item info chardev
1229 show the character devices
1230 @item info block
1231 show the block devices
1232 @item info blockstats
1233 show block device statistics
1234 @item info registers
1235 show the cpu registers
1236 @item info cpus
1237 show infos for each CPU
1238 @item info history
1239 show the command line history
1240 @item info irq
1241 show the interrupts statistics (if available)
1242 @item info pic
1243 show i8259 (PIC) state
1244 @item info pci
1245 show emulated PCI device info
1246 @item info tlb
1247 show virtual to physical memory mappings (i386, SH4 and SPARC only)
1248 @item info mem
1249 show the active virtual memory mappings (i386 only)
1250 @item info jit
1251 show dynamic compiler info
1252 @item info kvm
1253 show KVM information
1254 @item info numa
1255 show NUMA information
1256 @item info kvm
1257 show KVM information
1258 @item info usb
1259 show USB devices plugged on the virtual USB hub
1260 @item info usbhost
1261 show all USB host devices
1262 @item info profile
1263 show profiling information
1264 @item info capture
1265 show information about active capturing
1266 @item info snapshots
1267 show list of VM snapshots
1268 @item info status
1269 show the current VM status (running|paused)
1270 @item info pcmcia
1271 show guest PCMCIA status
1272 @item info mice
1273 show which guest mouse is receiving events
1274 @item info vnc
1275 show the vnc server status
1276 @item info name
1277 show the current VM name
1278 @item info uuid
1279 show the current VM UUID
1280 @item info cpustats
1281 show CPU statistics
1282 @item info usernet
1283 show user network stack connection states
1284 @item info migrate
1285 show migration status
1286 @item info balloon
1287 show balloon information
1288 @item info qtree
1289 show device tree
1290 @item info qdm
1291 show qdev device model list
1292 @item info roms
1293 show roms
1294 @end table
1295 ETEXI
1296
1297 #ifdef CONFIG_SIMPLE_TRACE
1298 STEXI
1299 @item info trace
1300 show contents of trace buffer
1301 @item info trace-events
1302 show available trace events and their state
1303 ETEXI
1304 #endif
1305
1306 STEXI
1307 @end table
1308 ETEXI