ARM: exynos4210: MCT support.
[qemu/agraf.git] / hmp-commands.hx
blob573b8233473c99b35ad8d6460626f467c0311d0c
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
8 STEXI
9 @table @option
10 ETEXI
13 .name = "help|?",
14 .args_type = "name:s?",
15 .params = "[cmd]",
16 .help = "show the help",
17 .mhandler.cmd = do_help_cmd,
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
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,
34 STEXI
35 @item commit
36 @findex commit
37 Commit changes to the disk images (if -snapshot is used) or backing files.
38 ETEXI
41 .name = "q|quit",
42 .args_type = "",
43 .params = "",
44 .help = "quit the emulator",
45 .user_print = monitor_user_noop,
46 .mhandler.cmd = hmp_quit,
49 STEXI
50 @item q or quit
51 @findex quit
52 Quit the emulator.
53 ETEXI
56 .name = "block_resize",
57 .args_type = "device:B,size:o",
58 .params = "device size",
59 .help = "resize a block image",
60 .mhandler.cmd = hmp_block_resize,
63 STEXI
64 @item block_resize
65 @findex block_resize
66 Resize a block image while a guest is running. Usually requires guest
67 action to see the updated size. Resize to a lower size is supported,
68 but should be used with extreme caution. Note that this command only
69 resizes image files, it can not resize block devices like LVM volumes.
70 ETEXI
73 .name = "block_stream",
74 .args_type = "device:B,base:s?",
75 .params = "device [base]",
76 .help = "copy data from a backing file into a block device",
77 .mhandler.cmd = hmp_block_stream,
80 STEXI
81 @item block_stream
82 @findex block_stream
83 Copy data from a backing file into a block device.
84 ETEXI
87 .name = "block_job_set_speed",
88 .args_type = "device:B,value:o",
89 .params = "device value",
90 .help = "set maximum speed for a background block operation",
91 .mhandler.cmd = hmp_block_job_set_speed,
94 STEXI
95 @item block_job_set_stream
96 @findex block_job_set_stream
97 Set maximum speed for a background block operation.
98 ETEXI
101 .name = "block_job_cancel",
102 .args_type = "device:B",
103 .params = "device",
104 .help = "stop an active block streaming operation",
105 .mhandler.cmd = hmp_block_job_cancel,
108 STEXI
109 @item block_job_cancel
110 @findex block_job_cancel
111 Stop an active block streaming operation.
112 ETEXI
115 .name = "eject",
116 .args_type = "force:-f,device:B",
117 .params = "[-f] device",
118 .help = "eject a removable medium (use -f to force it)",
119 .mhandler.cmd = hmp_eject,
122 STEXI
123 @item eject [-f] @var{device}
124 @findex eject
125 Eject a removable medium (use -f to force it).
126 ETEXI
129 .name = "drive_del",
130 .args_type = "id:s",
131 .params = "device",
132 .help = "remove host block device",
133 .user_print = monitor_user_noop,
134 .mhandler.cmd_new = do_drive_del,
137 STEXI
138 @item drive_del @var{device}
139 @findex drive_del
140 Remove host block device. The result is that guest generated IO is no longer
141 submitted against the host device underlying the disk. Once a drive has
142 been deleted, the QEMU Block layer returns -EIO which results in IO
143 errors in the guest for applications that are reading/writing to the device.
144 ETEXI
147 .name = "change",
148 .args_type = "device:B,target:F,arg:s?",
149 .params = "device filename [format]",
150 .help = "change a removable medium, optional format",
151 .mhandler.cmd = hmp_change,
154 STEXI
155 @item change @var{device} @var{setting}
156 @findex change
158 Change the configuration of a device.
160 @table @option
161 @item change @var{diskdevice} @var{filename} [@var{format}]
162 Change the medium for a removable disk device to point to @var{filename}. eg
164 @example
165 (qemu) change ide1-cd0 /path/to/some.iso
166 @end example
168 @var{format} is optional.
170 @item change vnc @var{display},@var{options}
171 Change the configuration of the VNC server. The valid syntax for @var{display}
172 and @var{options} are described at @ref{sec_invocation}. eg
174 @example
175 (qemu) change vnc localhost:1
176 @end example
178 @item change vnc password [@var{password}]
180 Change the password associated with the VNC server. If the new password is not
181 supplied, the monitor will prompt for it to be entered. VNC passwords are only
182 significant up to 8 letters. eg
184 @example
185 (qemu) change vnc password
186 Password: ********
187 @end example
189 @end table
190 ETEXI
193 .name = "screendump",
194 .args_type = "filename:F",
195 .params = "filename",
196 .help = "save screen into PPM image 'filename'",
197 .user_print = monitor_user_noop,
198 .mhandler.cmd_new = do_screen_dump,
201 STEXI
202 @item screendump @var{filename}
203 @findex screendump
204 Save screen into PPM image @var{filename}.
205 ETEXI
208 .name = "logfile",
209 .args_type = "filename:F",
210 .params = "filename",
211 .help = "output logs to 'filename'",
212 .mhandler.cmd = do_logfile,
215 STEXI
216 @item logfile @var{filename}
217 @findex logfile
218 Output logs to @var{filename}.
219 ETEXI
222 .name = "trace-event",
223 .args_type = "name:s,option:b",
224 .params = "name on|off",
225 .help = "changes status of a specific trace event",
226 .mhandler.cmd = do_trace_event_set_state,
229 STEXI
230 @item trace-event
231 @findex trace-event
232 changes status of a trace event
233 ETEXI
235 #if defined(CONFIG_TRACE_SIMPLE)
237 .name = "trace-file",
238 .args_type = "op:s?,arg:F?",
239 .params = "on|off|flush|set [arg]",
240 .help = "open, close, or flush trace file, or set a new file name",
241 .mhandler.cmd = do_trace_file,
244 STEXI
245 @item trace-file on|off|flush
246 @findex trace-file
247 Open, close, or flush the trace file. If no argument is given, the status of the trace file is displayed.
248 ETEXI
249 #endif
252 .name = "log",
253 .args_type = "items:s",
254 .params = "item1[,...]",
255 .help = "activate logging of the specified items to '/tmp/qemu.log'",
256 .mhandler.cmd = do_log,
259 STEXI
260 @item log @var{item1}[,...]
261 @findex log
262 Activate logging of the specified items to @file{/tmp/qemu.log}.
263 ETEXI
266 .name = "savevm",
267 .args_type = "name:s?",
268 .params = "[tag|id]",
269 .help = "save a VM snapshot. If no tag or id are provided, a new snapshot is created",
270 .mhandler.cmd = do_savevm,
273 STEXI
274 @item savevm [@var{tag}|@var{id}]
275 @findex savevm
276 Create a snapshot of the whole virtual machine. If @var{tag} is
277 provided, it is used as human readable identifier. If there is already
278 a snapshot with the same tag or ID, it is replaced. More info at
279 @ref{vm_snapshots}.
280 ETEXI
283 .name = "loadvm",
284 .args_type = "name:s",
285 .params = "tag|id",
286 .help = "restore a VM snapshot from its tag or id",
287 .mhandler.cmd = do_loadvm,
290 STEXI
291 @item loadvm @var{tag}|@var{id}
292 @findex loadvm
293 Set the whole virtual machine to the snapshot identified by the tag
294 @var{tag} or the unique snapshot ID @var{id}.
295 ETEXI
298 .name = "delvm",
299 .args_type = "name:s",
300 .params = "tag|id",
301 .help = "delete a VM snapshot from its tag or id",
302 .mhandler.cmd = do_delvm,
305 STEXI
306 @item delvm @var{tag}|@var{id}
307 @findex delvm
308 Delete the snapshot identified by @var{tag} or @var{id}.
309 ETEXI
312 .name = "singlestep",
313 .args_type = "option:s?",
314 .params = "[on|off]",
315 .help = "run emulation in singlestep mode or switch to normal mode",
316 .mhandler.cmd = do_singlestep,
319 STEXI
320 @item singlestep [off]
321 @findex singlestep
322 Run the emulation in single step mode.
323 If called with option off, the emulation returns to normal mode.
324 ETEXI
327 .name = "stop",
328 .args_type = "",
329 .params = "",
330 .help = "stop emulation",
331 .mhandler.cmd = hmp_stop,
334 STEXI
335 @item stop
336 @findex stop
337 Stop emulation.
338 ETEXI
341 .name = "c|cont",
342 .args_type = "",
343 .params = "",
344 .help = "resume emulation",
345 .mhandler.cmd = hmp_cont,
348 STEXI
349 @item c or cont
350 @findex cont
351 Resume emulation.
352 ETEXI
355 .name = "gdbserver",
356 .args_type = "device:s?",
357 .params = "[device]",
358 .help = "start gdbserver on given device (default 'tcp::1234'), stop with 'none'",
359 .mhandler.cmd = do_gdbserver,
362 STEXI
363 @item gdbserver [@var{port}]
364 @findex gdbserver
365 Start gdbserver session (default @var{port}=1234)
366 ETEXI
369 .name = "x",
370 .args_type = "fmt:/,addr:l",
371 .params = "/fmt addr",
372 .help = "virtual memory dump starting at 'addr'",
373 .mhandler.cmd = do_memory_dump,
376 STEXI
377 @item x/fmt @var{addr}
378 @findex x
379 Virtual memory dump starting at @var{addr}.
380 ETEXI
383 .name = "xp",
384 .args_type = "fmt:/,addr:l",
385 .params = "/fmt addr",
386 .help = "physical memory dump starting at 'addr'",
387 .mhandler.cmd = do_physical_memory_dump,
390 STEXI
391 @item xp /@var{fmt} @var{addr}
392 @findex xp
393 Physical memory dump starting at @var{addr}.
395 @var{fmt} is a format which tells the command how to format the
396 data. Its syntax is: @option{/@{count@}@{format@}@{size@}}
398 @table @var
399 @item count
400 is the number of items to be dumped.
402 @item format
403 can be x (hex), d (signed decimal), u (unsigned decimal), o (octal),
404 c (char) or i (asm instruction).
406 @item size
407 can be b (8 bits), h (16 bits), w (32 bits) or g (64 bits). On x86,
408 @code{h} or @code{w} can be specified with the @code{i} format to
409 respectively select 16 or 32 bit code instruction size.
411 @end table
413 Examples:
414 @itemize
415 @item
416 Dump 10 instructions at the current instruction pointer:
417 @example
418 (qemu) x/10i $eip
419 0x90107063: ret
420 0x90107064: sti
421 0x90107065: lea 0x0(%esi,1),%esi
422 0x90107069: lea 0x0(%edi,1),%edi
423 0x90107070: ret
424 0x90107071: jmp 0x90107080
425 0x90107073: nop
426 0x90107074: nop
427 0x90107075: nop
428 0x90107076: nop
429 @end example
431 @item
432 Dump 80 16 bit values at the start of the video memory.
433 @smallexample
434 (qemu) xp/80hx 0xb8000
435 0x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42
436 0x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41
437 0x000b8020: 0x0b42 0x0b69 0x0b6f 0x0b73 0x0b20 0x0b63 0x0b75 0x0b72
438 0x000b8030: 0x0b72 0x0b65 0x0b6e 0x0b74 0x0b2d 0x0b63 0x0b76 0x0b73
439 0x000b8040: 0x0b20 0x0b30 0x0b35 0x0b20 0x0b4e 0x0b6f 0x0b76 0x0b20
440 0x000b8050: 0x0b32 0x0b30 0x0b30 0x0b33 0x0720 0x0720 0x0720 0x0720
441 0x000b8060: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
442 0x000b8070: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
443 0x000b8080: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
444 0x000b8090: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
445 @end smallexample
446 @end itemize
447 ETEXI
450 .name = "p|print",
451 .args_type = "fmt:/,val:l",
452 .params = "/fmt expr",
453 .help = "print expression value (use $reg for CPU register access)",
454 .mhandler.cmd = do_print,
457 STEXI
458 @item p or print/@var{fmt} @var{expr}
459 @findex print
461 Print expression value. Only the @var{format} part of @var{fmt} is
462 used.
463 ETEXI
466 .name = "i",
467 .args_type = "fmt:/,addr:i,index:i.",
468 .params = "/fmt addr",
469 .help = "I/O port read",
470 .mhandler.cmd = do_ioport_read,
473 STEXI
474 Read I/O port.
475 ETEXI
478 .name = "o",
479 .args_type = "fmt:/,addr:i,val:i",
480 .params = "/fmt addr value",
481 .help = "I/O port write",
482 .mhandler.cmd = do_ioport_write,
485 STEXI
486 Write to I/O port.
487 ETEXI
490 .name = "sendkey",
491 .args_type = "string:s,hold_time:i?",
492 .params = "keys [hold_ms]",
493 .help = "send keys to the VM (e.g. 'sendkey ctrl-alt-f1', default hold time=100 ms)",
494 .mhandler.cmd = do_sendkey,
497 STEXI
498 @item sendkey @var{keys}
499 @findex sendkey
501 Send @var{keys} to the emulator. @var{keys} could be the name of the
502 key or @code{#} followed by the raw value in either decimal or hexadecimal
503 format. Use @code{-} to press several keys simultaneously. Example:
504 @example
505 sendkey ctrl-alt-f1
506 @end example
508 This command is useful to send keys that your graphical user interface
509 intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
510 ETEXI
513 .name = "system_reset",
514 .args_type = "",
515 .params = "",
516 .help = "reset the system",
517 .mhandler.cmd = hmp_system_reset,
520 STEXI
521 @item system_reset
522 @findex system_reset
524 Reset the system.
525 ETEXI
528 .name = "system_powerdown",
529 .args_type = "",
530 .params = "",
531 .help = "send system power down event",
532 .mhandler.cmd = hmp_system_powerdown,
535 STEXI
536 @item system_powerdown
537 @findex system_powerdown
539 Power down the system (if supported).
540 ETEXI
543 .name = "sum",
544 .args_type = "start:i,size:i",
545 .params = "addr size",
546 .help = "compute the checksum of a memory region",
547 .mhandler.cmd = do_sum,
550 STEXI
551 @item sum @var{addr} @var{size}
552 @findex sum
554 Compute the checksum of a memory region.
555 ETEXI
558 .name = "usb_add",
559 .args_type = "devname:s",
560 .params = "device",
561 .help = "add USB device (e.g. 'host:bus.addr' or 'host:vendor_id:product_id')",
562 .mhandler.cmd = do_usb_add,
565 STEXI
566 @item usb_add @var{devname}
567 @findex usb_add
569 Add the USB device @var{devname}. For details of available devices see
570 @ref{usb_devices}
571 ETEXI
574 .name = "usb_del",
575 .args_type = "devname:s",
576 .params = "device",
577 .help = "remove USB device 'bus.addr'",
578 .mhandler.cmd = do_usb_del,
581 STEXI
582 @item usb_del @var{devname}
583 @findex usb_del
585 Remove the USB device @var{devname} from the QEMU virtual USB
586 hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor
587 command @code{info usb} to see the devices you can remove.
588 ETEXI
591 .name = "device_add",
592 .args_type = "device:O",
593 .params = "driver[,prop=value][,...]",
594 .help = "add device, like -device on the command line",
595 .user_print = monitor_user_noop,
596 .mhandler.cmd_new = do_device_add,
599 STEXI
600 @item device_add @var{config}
601 @findex device_add
603 Add device.
604 ETEXI
607 .name = "device_del",
608 .args_type = "id:s",
609 .params = "device",
610 .help = "remove device",
611 .user_print = monitor_user_noop,
612 .mhandler.cmd_new = do_device_del,
615 STEXI
616 @item device_del @var{id}
617 @findex device_del
619 Remove device @var{id}.
620 ETEXI
623 .name = "cpu",
624 .args_type = "index:i",
625 .params = "index",
626 .help = "set the default CPU",
627 .mhandler.cmd = hmp_cpu,
630 STEXI
631 @item cpu @var{index}
632 @findex cpu
633 Set the default CPU.
634 ETEXI
637 .name = "mouse_move",
638 .args_type = "dx_str:s,dy_str:s,dz_str:s?",
639 .params = "dx dy [dz]",
640 .help = "send mouse move events",
641 .mhandler.cmd = do_mouse_move,
644 STEXI
645 @item mouse_move @var{dx} @var{dy} [@var{dz}]
646 @findex mouse_move
647 Move the active mouse to the specified coordinates @var{dx} @var{dy}
648 with optional scroll axis @var{dz}.
649 ETEXI
652 .name = "mouse_button",
653 .args_type = "button_state:i",
654 .params = "state",
655 .help = "change mouse button state (1=L, 2=M, 4=R)",
656 .mhandler.cmd = do_mouse_button,
659 STEXI
660 @item mouse_button @var{val}
661 @findex mouse_button
662 Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
663 ETEXI
666 .name = "mouse_set",
667 .args_type = "index:i",
668 .params = "index",
669 .help = "set which mouse device receives events",
670 .mhandler.cmd = do_mouse_set,
673 STEXI
674 @item mouse_set @var{index}
675 @findex mouse_set
676 Set which mouse device receives events at given @var{index}, index
677 can be obtained with
678 @example
679 info mice
680 @end example
681 ETEXI
683 #ifdef HAS_AUDIO
685 .name = "wavcapture",
686 .args_type = "path:F,freq:i?,bits:i?,nchannels:i?",
687 .params = "path [frequency [bits [channels]]]",
688 .help = "capture audio to a wave file (default frequency=44100 bits=16 channels=2)",
689 .mhandler.cmd = do_wav_capture,
691 #endif
692 STEXI
693 @item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]
694 @findex wavcapture
695 Capture audio into @var{filename}. Using sample rate @var{frequency}
696 bits per sample @var{bits} and number of channels @var{channels}.
698 Defaults:
699 @itemize @minus
700 @item Sample rate = 44100 Hz - CD quality
701 @item Bits = 16
702 @item Number of channels = 2 - Stereo
703 @end itemize
704 ETEXI
706 #ifdef HAS_AUDIO
708 .name = "stopcapture",
709 .args_type = "n:i",
710 .params = "capture index",
711 .help = "stop capture",
712 .mhandler.cmd = do_stop_capture,
714 #endif
715 STEXI
716 @item stopcapture @var{index}
717 @findex stopcapture
718 Stop capture with a given @var{index}, index can be obtained with
719 @example
720 info capture
721 @end example
722 ETEXI
725 .name = "memsave",
726 .args_type = "val:l,size:i,filename:s",
727 .params = "addr size file",
728 .help = "save to disk virtual memory dump starting at 'addr' of size 'size'",
729 .mhandler.cmd = hmp_memsave,
732 STEXI
733 @item memsave @var{addr} @var{size} @var{file}
734 @findex memsave
735 save to disk virtual memory dump starting at @var{addr} of size @var{size}.
736 ETEXI
739 .name = "pmemsave",
740 .args_type = "val:l,size:i,filename:s",
741 .params = "addr size file",
742 .help = "save to disk physical memory dump starting at 'addr' of size 'size'",
743 .mhandler.cmd = hmp_pmemsave,
746 STEXI
747 @item pmemsave @var{addr} @var{size} @var{file}
748 @findex pmemsave
749 save to disk physical memory dump starting at @var{addr} of size @var{size}.
750 ETEXI
753 .name = "boot_set",
754 .args_type = "bootdevice:s",
755 .params = "bootdevice",
756 .help = "define new values for the boot device list",
757 .mhandler.cmd = do_boot_set,
760 STEXI
761 @item boot_set @var{bootdevicelist}
762 @findex boot_set
764 Define new values for the boot device list. Those values will override
765 the values specified on the command line through the @code{-boot} option.
767 The values that can be specified here depend on the machine type, but are
768 the same that can be specified in the @code{-boot} command line option.
769 ETEXI
771 #if defined(TARGET_I386)
773 .name = "nmi",
774 .args_type = "",
775 .params = "",
776 .help = "inject an NMI on all guest's CPUs",
777 .mhandler.cmd = hmp_inject_nmi,
779 #endif
780 STEXI
781 @item nmi @var{cpu}
782 @findex nmi
783 Inject an NMI on the given CPU (x86 only).
784 ETEXI
787 .name = "migrate",
788 .args_type = "detach:-d,blk:-b,inc:-i,uri:s",
789 .params = "[-d] [-b] [-i] uri",
790 .help = "migrate to URI (using -d to not wait for completion)"
791 "\n\t\t\t -b for migration without shared storage with"
792 " full copy of disk\n\t\t\t -i for migration without "
793 "shared storage with incremental copy of disk "
794 "(base image shared between src and destination)",
795 .user_print = monitor_user_noop,
796 .mhandler.cmd_new = do_migrate,
800 STEXI
801 @item migrate [-d] [-b] [-i] @var{uri}
802 @findex migrate
803 Migrate to @var{uri} (using -d to not wait for completion).
804 -b for migration with full copy of disk
805 -i for migration with incremental copy of disk (base image is shared)
806 ETEXI
809 .name = "migrate_cancel",
810 .args_type = "",
811 .params = "",
812 .help = "cancel the current VM migration",
813 .mhandler.cmd = hmp_migrate_cancel,
816 STEXI
817 @item migrate_cancel
818 @findex migrate_cancel
819 Cancel the current VM migration.
820 ETEXI
823 .name = "migrate_set_speed",
824 .args_type = "value:o",
825 .params = "value",
826 .help = "set maximum speed (in bytes) for migrations. "
827 "Defaults to MB if no size suffix is specified, ie. B/K/M/G/T",
828 .mhandler.cmd = hmp_migrate_set_speed,
831 STEXI
832 @item migrate_set_speed @var{value}
833 @findex migrate_set_speed
834 Set maximum speed to @var{value} (in bytes) for migrations.
835 ETEXI
838 .name = "migrate_set_downtime",
839 .args_type = "value:T",
840 .params = "value",
841 .help = "set maximum tolerated downtime (in seconds) for migrations",
842 .mhandler.cmd = hmp_migrate_set_downtime,
845 STEXI
846 @item migrate_set_downtime @var{second}
847 @findex migrate_set_downtime
848 Set maximum tolerated downtime (in seconds) for migration.
849 ETEXI
852 .name = "client_migrate_info",
853 .args_type = "protocol:s,hostname:s,port:i?,tls-port:i?,cert-subject:s?",
854 .params = "protocol hostname port tls-port cert-subject",
855 .help = "send migration info to spice/vnc client",
856 .user_print = monitor_user_noop,
857 .mhandler.cmd_async = client_migrate_info,
858 .flags = MONITOR_CMD_ASYNC,
861 STEXI
862 @item client_migrate_info @var{protocol} @var{hostname} @var{port} @var{tls-port} @var{cert-subject}
863 @findex client_migrate_info
864 Set the spice/vnc connection info for the migration target. The spice/vnc
865 server will ask the spice/vnc client to automatically reconnect using the
866 new parameters (if specified) once the vm migration finished successfully.
867 ETEXI
870 .name = "snapshot_blkdev",
871 .args_type = "device:B,snapshot-file:s?,format:s?",
872 .params = "device [new-image-file] [format]",
873 .help = "initiates a live snapshot\n\t\t\t"
874 "of device. If a new image file is specified, the\n\t\t\t"
875 "new image file will become the new root image.\n\t\t\t"
876 "If format is specified, the snapshot file will\n\t\t\t"
877 "be created in that format. Otherwise the\n\t\t\t"
878 "snapshot will be internal! (currently unsupported)",
879 .mhandler.cmd = hmp_snapshot_blkdev,
882 STEXI
883 @item snapshot_blkdev
884 @findex snapshot_blkdev
885 Snapshot device, using snapshot file as target if provided
886 ETEXI
889 .name = "drive_add",
890 .args_type = "pci_addr:s,opts:s",
891 .params = "[[<domain>:]<bus>:]<slot>\n"
892 "[file=file][,if=type][,bus=n]\n"
893 "[,unit=m][,media=d][,index=i]\n"
894 "[,cyls=c,heads=h,secs=s[,trans=t]]\n"
895 "[,snapshot=on|off][,cache=on|off]\n"
896 "[,readonly=on|off][,copy-on-read=on|off]",
897 .help = "add drive to PCI storage controller",
898 .mhandler.cmd = drive_hot_add,
901 STEXI
902 @item drive_add
903 @findex drive_add
904 Add drive to PCI storage controller.
905 ETEXI
907 #if defined(TARGET_I386)
909 .name = "pci_add",
910 .args_type = "pci_addr:s,type:s,opts:s?",
911 .params = "auto|[[<domain>:]<bus>:]<slot> nic|storage [[vlan=n][,macaddr=addr][,model=type]] [file=file][,if=type][,bus=nr]...",
912 .help = "hot-add PCI device",
913 .mhandler.cmd = pci_device_hot_add,
915 #endif
917 STEXI
918 @item pci_add
919 @findex pci_add
920 Hot-add PCI device.
921 ETEXI
923 #if defined(TARGET_I386)
925 .name = "pci_del",
926 .args_type = "pci_addr:s",
927 .params = "[[<domain>:]<bus>:]<slot>",
928 .help = "hot remove PCI device",
929 .mhandler.cmd = do_pci_device_hot_remove,
931 #endif
933 STEXI
934 @item pci_del
935 @findex pci_del
936 Hot remove PCI device.
937 ETEXI
940 .name = "pcie_aer_inject_error",
941 .args_type = "advisory_non_fatal:-a,correctable:-c,"
942 "id:s,error_status:s,"
943 "header0:i?,header1:i?,header2:i?,header3:i?,"
944 "prefix0:i?,prefix1:i?,prefix2:i?,prefix3:i?",
945 .params = "[-a] [-c] id "
946 "<error_status> [<tlp header> [<tlp header prefix>]]",
947 .help = "inject pcie aer error\n\t\t\t"
948 " -a for advisory non fatal error\n\t\t\t"
949 " -c for correctable error\n\t\t\t"
950 "<id> = qdev device id\n\t\t\t"
951 "<error_status> = error string or 32bit\n\t\t\t"
952 "<tlb header> = 32bit x 4\n\t\t\t"
953 "<tlb header prefix> = 32bit x 4",
954 .user_print = pcie_aer_inject_error_print,
955 .mhandler.cmd_new = do_pcie_aer_inject_error,
958 STEXI
959 @item pcie_aer_inject_error
960 @findex pcie_aer_inject_error
961 Inject PCIe AER error
962 ETEXI
965 .name = "host_net_add",
966 .args_type = "device:s,opts:s?",
967 .params = "tap|user|socket|vde|dump [options]",
968 .help = "add host VLAN client",
969 .mhandler.cmd = net_host_device_add,
972 STEXI
973 @item host_net_add
974 @findex host_net_add
975 Add host VLAN client.
976 ETEXI
979 .name = "host_net_remove",
980 .args_type = "vlan_id:i,device:s",
981 .params = "vlan_id name",
982 .help = "remove host VLAN client",
983 .mhandler.cmd = net_host_device_remove,
986 STEXI
987 @item host_net_remove
988 @findex host_net_remove
989 Remove host VLAN client.
990 ETEXI
993 .name = "netdev_add",
994 .args_type = "netdev:O",
995 .params = "[user|tap|socket],id=str[,prop=value][,...]",
996 .help = "add host network device",
997 .user_print = monitor_user_noop,
998 .mhandler.cmd_new = do_netdev_add,
1001 STEXI
1002 @item netdev_add
1003 @findex netdev_add
1004 Add host network device.
1005 ETEXI
1008 .name = "netdev_del",
1009 .args_type = "id:s",
1010 .params = "id",
1011 .help = "remove host network device",
1012 .user_print = monitor_user_noop,
1013 .mhandler.cmd_new = do_netdev_del,
1016 STEXI
1017 @item netdev_del
1018 @findex netdev_del
1019 Remove host network device.
1020 ETEXI
1022 #ifdef CONFIG_SLIRP
1024 .name = "hostfwd_add",
1025 .args_type = "arg1:s,arg2:s?,arg3:s?",
1026 .params = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport",
1027 .help = "redirect TCP or UDP connections from host to guest (requires -net user)",
1028 .mhandler.cmd = net_slirp_hostfwd_add,
1030 #endif
1031 STEXI
1032 @item hostfwd_add
1033 @findex hostfwd_add
1034 Redirect TCP or UDP connections from host to guest (requires -net user).
1035 ETEXI
1037 #ifdef CONFIG_SLIRP
1039 .name = "hostfwd_remove",
1040 .args_type = "arg1:s,arg2:s?,arg3:s?",
1041 .params = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport",
1042 .help = "remove host-to-guest TCP or UDP redirection",
1043 .mhandler.cmd = net_slirp_hostfwd_remove,
1046 #endif
1047 STEXI
1048 @item hostfwd_remove
1049 @findex hostfwd_remove
1050 Remove host-to-guest TCP or UDP redirection.
1051 ETEXI
1054 .name = "balloon",
1055 .args_type = "value:M",
1056 .params = "target",
1057 .help = "request VM to change its memory allocation (in MB)",
1058 .mhandler.cmd = hmp_balloon,
1061 STEXI
1062 @item balloon @var{value}
1063 @findex balloon
1064 Request VM to change its memory allocation to @var{value} (in MB).
1065 ETEXI
1068 .name = "set_link",
1069 .args_type = "name:s,up:b",
1070 .params = "name on|off",
1071 .help = "change the link status of a network adapter",
1072 .mhandler.cmd = hmp_set_link,
1075 STEXI
1076 @item set_link @var{name} [on|off]
1077 @findex set_link
1078 Switch link @var{name} on (i.e. up) or off (i.e. down).
1079 ETEXI
1082 .name = "watchdog_action",
1083 .args_type = "action:s",
1084 .params = "[reset|shutdown|poweroff|pause|debug|none]",
1085 .help = "change watchdog action",
1086 .mhandler.cmd = do_watchdog_action,
1089 STEXI
1090 @item watchdog_action
1091 @findex watchdog_action
1092 Change watchdog action.
1093 ETEXI
1096 .name = "acl_show",
1097 .args_type = "aclname:s",
1098 .params = "aclname",
1099 .help = "list rules in the access control list",
1100 .mhandler.cmd = do_acl_show,
1103 STEXI
1104 @item acl_show @var{aclname}
1105 @findex acl_show
1106 List all the matching rules in the access control list, and the default
1107 policy. There are currently two named access control lists,
1108 @var{vnc.x509dname} and @var{vnc.username} matching on the x509 client
1109 certificate distinguished name, and SASL username respectively.
1110 ETEXI
1113 .name = "acl_policy",
1114 .args_type = "aclname:s,policy:s",
1115 .params = "aclname allow|deny",
1116 .help = "set default access control list policy",
1117 .mhandler.cmd = do_acl_policy,
1120 STEXI
1121 @item acl_policy @var{aclname} @code{allow|deny}
1122 @findex acl_policy
1123 Set the default access control list policy, used in the event that
1124 none of the explicit rules match. The default policy at startup is
1125 always @code{deny}.
1126 ETEXI
1129 .name = "acl_add",
1130 .args_type = "aclname:s,match:s,policy:s,index:i?",
1131 .params = "aclname match allow|deny [index]",
1132 .help = "add a match rule to the access control list",
1133 .mhandler.cmd = do_acl_add,
1136 STEXI
1137 @item acl_add @var{aclname} @var{match} @code{allow|deny} [@var{index}]
1138 @findex acl_add
1139 Add a match rule to the access control list, allowing or denying access.
1140 The match will normally be an exact username or x509 distinguished name,
1141 but can optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to
1142 allow all users in the @code{EXAMPLE.COM} kerberos realm. The match will
1143 normally be appended to the end of the ACL, but can be inserted
1144 earlier in the list if the optional @var{index} parameter is supplied.
1145 ETEXI
1148 .name = "acl_remove",
1149 .args_type = "aclname:s,match:s",
1150 .params = "aclname match",
1151 .help = "remove a match rule from the access control list",
1152 .mhandler.cmd = do_acl_remove,
1155 STEXI
1156 @item acl_remove @var{aclname} @var{match}
1157 @findex acl_remove
1158 Remove the specified match rule from the access control list.
1159 ETEXI
1162 .name = "acl_reset",
1163 .args_type = "aclname:s",
1164 .params = "aclname",
1165 .help = "reset the access control list",
1166 .mhandler.cmd = do_acl_reset,
1169 STEXI
1170 @item acl_reset @var{aclname}
1171 @findex acl_reset
1172 Remove all matches from the access control list, and set the default
1173 policy back to @code{deny}.
1174 ETEXI
1176 #if defined(TARGET_I386)
1179 .name = "mce",
1180 .args_type = "broadcast:-b,cpu_index:i,bank:i,status:l,mcg_status:l,addr:l,misc:l",
1181 .params = "[-b] cpu bank status mcgstatus addr misc",
1182 .help = "inject a MCE on the given CPU [and broadcast to other CPUs with -b option]",
1183 .mhandler.cmd = do_inject_mce,
1186 #endif
1187 STEXI
1188 @item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc}
1189 @findex mce (x86)
1190 Inject an MCE on the given CPU (x86 only).
1191 ETEXI
1194 .name = "getfd",
1195 .args_type = "fdname:s",
1196 .params = "getfd name",
1197 .help = "receive a file descriptor via SCM rights and assign it a name",
1198 .user_print = monitor_user_noop,
1199 .mhandler.cmd_new = do_getfd,
1202 STEXI
1203 @item getfd @var{fdname}
1204 @findex getfd
1205 If a file descriptor is passed alongside this command using the SCM_RIGHTS
1206 mechanism on unix sockets, it is stored using the name @var{fdname} for
1207 later use by other monitor commands.
1208 ETEXI
1211 .name = "closefd",
1212 .args_type = "fdname:s",
1213 .params = "closefd name",
1214 .help = "close a file descriptor previously passed via SCM rights",
1215 .user_print = monitor_user_noop,
1216 .mhandler.cmd_new = do_closefd,
1219 STEXI
1220 @item closefd @var{fdname}
1221 @findex closefd
1222 Close the file descriptor previously assigned to @var{fdname} using the
1223 @code{getfd} command. This is only needed if the file descriptor was never
1224 used by another monitor command.
1225 ETEXI
1228 .name = "block_passwd",
1229 .args_type = "device:B,password:s",
1230 .params = "block_passwd device password",
1231 .help = "set the password of encrypted block devices",
1232 .mhandler.cmd = hmp_block_passwd,
1235 STEXI
1236 @item block_set_io_throttle @var{device} @var{bps} @var{bps_rd} @var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
1237 @findex block_set_io_throttle
1238 Change I/O throttle limits for a block drive to @var{bps} @var{bps_rd} @var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
1239 ETEXI
1242 .name = "block_set_io_throttle",
1243 .args_type = "device:B,bps:l,bps_rd:l,bps_wr:l,iops:l,iops_rd:l,iops_wr:l",
1244 .params = "device bps bps_rd bps_wr iops iops_rd iops_wr",
1245 .help = "change I/O throttle limits for a block drive",
1246 .mhandler.cmd = hmp_block_set_io_throttle,
1249 STEXI
1250 @item block_passwd @var{device} @var{password}
1251 @findex block_passwd
1252 Set the encrypted device @var{device} password to @var{password}
1253 ETEXI
1256 .name = "set_password",
1257 .args_type = "protocol:s,password:s,connected:s?",
1258 .params = "protocol password action-if-connected",
1259 .help = "set spice/vnc password",
1260 .mhandler.cmd = hmp_set_password,
1263 STEXI
1264 @item set_password [ vnc | spice ] password [ action-if-connected ]
1265 @findex set_password
1267 Change spice/vnc password. Use zero to make the password stay valid
1268 forever. @var{action-if-connected} specifies what should happen in
1269 case a connection is established: @var{fail} makes the password change
1270 fail. @var{disconnect} changes the password and disconnects the
1271 client. @var{keep} changes the password and keeps the connection up.
1272 @var{keep} is the default.
1273 ETEXI
1276 .name = "expire_password",
1277 .args_type = "protocol:s,time:s",
1278 .params = "protocol time",
1279 .help = "set spice/vnc password expire-time",
1280 .mhandler.cmd = hmp_expire_password,
1283 STEXI
1284 @item expire_password [ vnc | spice ] expire-time
1285 @findex expire_password
1287 Specify when a password for spice/vnc becomes
1288 invalid. @var{expire-time} accepts:
1290 @table @var
1291 @item now
1292 Invalidate password instantly.
1294 @item never
1295 Password stays valid forever.
1297 @item +nsec
1298 Password stays valid for @var{nsec} seconds starting now.
1300 @item nsec
1301 Password is invalidated at the given time. @var{nsec} are the seconds
1302 passed since 1970, i.e. unix epoch.
1304 @end table
1305 ETEXI
1308 .name = "info",
1309 .args_type = "item:s?",
1310 .params = "[subcommand]",
1311 .help = "show various information about the system state",
1312 .mhandler.cmd = do_info,
1315 STEXI
1316 @item info @var{subcommand}
1317 @findex info
1318 Show various information about the system state.
1320 @table @option
1321 @item info version
1322 show the version of QEMU
1323 @item info network
1324 show the various VLANs and the associated devices
1325 @item info chardev
1326 show the character devices
1327 @item info block
1328 show the block devices
1329 @item info blockstats
1330 show block device statistics
1331 @item info registers
1332 show the cpu registers
1333 @item info cpus
1334 show infos for each CPU
1335 @item info history
1336 show the command line history
1337 @item info irq
1338 show the interrupts statistics (if available)
1339 @item info pic
1340 show i8259 (PIC) state
1341 @item info pci
1342 show emulated PCI device info
1343 @item info tlb
1344 show virtual to physical memory mappings (i386, SH4, SPARC, and PPC only)
1345 @item info mem
1346 show the active virtual memory mappings (i386 only)
1347 @item info jit
1348 show dynamic compiler info
1349 @item info numa
1350 show NUMA information
1351 @item info kvm
1352 show KVM information
1353 @item info usb
1354 show USB devices plugged on the virtual USB hub
1355 @item info usbhost
1356 show all USB host devices
1357 @item info profile
1358 show profiling information
1359 @item info capture
1360 show information about active capturing
1361 @item info snapshots
1362 show list of VM snapshots
1363 @item info status
1364 show the current VM status (running|paused)
1365 @item info pcmcia
1366 show guest PCMCIA status
1367 @item info mice
1368 show which guest mouse is receiving events
1369 @item info vnc
1370 show the vnc server status
1371 @item info name
1372 show the current VM name
1373 @item info uuid
1374 show the current VM UUID
1375 @item info cpustats
1376 show CPU statistics
1377 @item info usernet
1378 show user network stack connection states
1379 @item info migrate
1380 show migration status
1381 @item info balloon
1382 show balloon information
1383 @item info qtree
1384 show device tree
1385 @item info qdm
1386 show qdev device model list
1387 @item info roms
1388 show roms
1389 @end table
1390 ETEXI
1392 #ifdef CONFIG_TRACE_SIMPLE
1393 STEXI
1394 @item info trace
1395 show contents of trace buffer
1396 ETEXI
1397 #endif
1399 STEXI
1400 @item info trace-events
1401 show available trace events and their state
1402 ETEXI
1404 STEXI
1405 @end table
1406 ETEXI