blob: 0bf88961b7714014a3ce9684e60bab1b29f2cdd6 [file] [log] [blame]
Blue Swirl23130862009-06-06 08:22:04 +00001HXCOMM Use DEFHEADING() to define headings in both help text and texi
2HXCOMM Text between STEXI and ETEXI are copied to texi version and
3HXCOMM discarded from C version
4HXCOMM DEF(command, args, callback, arg_string, help) is used to construct
5HXCOMM monitor commands
6HXCOMM HXCOMM can be used for comments, discarded from both texi and C
7
8STEXI
9@table @option
10ETEXI
11
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030012 {
13 .name = "help|?",
14 .args_type = "name:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030015 .params = "[cmd]",
16 .help = "show the help",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -030017 .mhandler.cmd = do_help_cmd,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030018 },
19
Blue Swirl23130862009-06-06 08:22:04 +000020STEXI
21@item help or ? [@var{cmd}]
Stefan Weil70fcbbe2010-02-05 23:52:04 +010022@findex help
Blue Swirl23130862009-06-06 08:22:04 +000023Show the help for all commands or just for command @var{cmd}.
24ETEXI
25
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030026 {
27 .name = "commit",
28 .args_type = "device:B",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030029 .params = "device|all",
30 .help = "commit changes to the disk images (if -snapshot is used) or backing files",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -030031 .mhandler.cmd = do_commit,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030032 },
33
Blue Swirl23130862009-06-06 08:22:04 +000034STEXI
35@item commit
Stefan Weil70fcbbe2010-02-05 23:52:04 +010036@findex commit
Blue Swirl23130862009-06-06 08:22:04 +000037Commit changes to the disk images (if -snapshot is used) or backing files.
38ETEXI
39
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030040 {
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030041 .name = "q|quit",
42 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030043 .params = "",
44 .help = "quit the emulator",
Luiz Capitulinob223f352009-10-07 13:41:56 -030045 .user_print = monitor_user_noop,
Luiz Capitulino7a7f3252011-09-15 14:20:28 -030046 .mhandler.cmd = hmp_quit,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030047 },
48
Blue Swirl23130862009-06-06 08:22:04 +000049STEXI
50@item q or quit
Stefan Weil70fcbbe2010-02-05 23:52:04 +010051@findex quit
Blue Swirl23130862009-06-06 08:22:04 +000052Quit the emulator.
53ETEXI
54
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030055 {
Christoph Hellwig6d4a2b32011-01-24 13:32:33 +010056 .name = "block_resize",
57 .args_type = "device:B,size:o",
58 .params = "device size",
59 .help = "resize a block image",
60 .user_print = monitor_user_noop,
61 .mhandler.cmd_new = do_block_resize,
62 },
63
64STEXI
65@item block_resize
66@findex block_resize
67Resize a block image while a guest is running. Usually requires guest
68action to see the updated size. Resize to a lower size is supported,
69but should be used with extreme caution. Note that this command only
70resizes image files, it can not resize block devices like LVM volumes.
71ETEXI
72
73
74 {
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030075 .name = "eject",
Luiz Capitulino78d714e2009-12-14 18:53:21 -020076 .args_type = "force:-f,device:B",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030077 .params = "[-f] device",
78 .help = "eject a removable medium (use -f to force it)",
Luiz Capitulinoe1c923a2009-10-16 12:23:49 -030079 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -020080 .mhandler.cmd_new = do_eject,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030081 },
82
Blue Swirl23130862009-06-06 08:22:04 +000083STEXI
84@item eject [-f] @var{device}
Stefan Weil70fcbbe2010-02-05 23:52:04 +010085@findex eject
Blue Swirl23130862009-06-06 08:22:04 +000086Eject a removable medium (use -f to force it).
87ETEXI
88
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030089 {
Ryan Harper9063f812010-11-12 11:07:13 -060090 .name = "drive_del",
91 .args_type = "id:s",
92 .params = "device",
93 .help = "remove host block device",
94 .user_print = monitor_user_noop,
95 .mhandler.cmd_new = do_drive_del,
96 },
97
98STEXI
99@item drive_del @var{device}
100@findex drive_del
101Remove host block device. The result is that guest generated IO is no longer
102submitted against the host device underlying the disk. Once a drive has
103been deleted, the QEMU Block layer returns -EIO which results in IO
104errors in the guest for applications that are reading/writing to the device.
105ETEXI
106
107 {
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300108 .name = "change",
109 .args_type = "device:B,target:F,arg:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300110 .params = "device filename [format]",
111 .help = "change a removable medium, optional format",
Markus Armbrusterec3b82a2009-12-07 21:37:09 +0100112 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200113 .mhandler.cmd_new = do_change,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300114 },
115
Blue Swirl23130862009-06-06 08:22:04 +0000116STEXI
117@item change @var{device} @var{setting}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100118@findex change
Blue Swirl23130862009-06-06 08:22:04 +0000119
120Change the configuration of a device.
121
122@table @option
123@item change @var{diskdevice} @var{filename} [@var{format}]
124Change the medium for a removable disk device to point to @var{filename}. eg
125
126@example
127(qemu) change ide1-cd0 /path/to/some.iso
128@end example
129
130@var{format} is optional.
131
132@item change vnc @var{display},@var{options}
133Change the configuration of the VNC server. The valid syntax for @var{display}
134and @var{options} are described at @ref{sec_invocation}. eg
135
136@example
137(qemu) change vnc localhost:1
138@end example
139
140@item change vnc password [@var{password}]
141
142Change the password associated with the VNC server. If the new password is not
143supplied, the monitor will prompt for it to be entered. VNC passwords are only
144significant up to 8 letters. eg
145
146@example
147(qemu) change vnc password
148Password: ********
149@end example
150
151@end table
152ETEXI
153
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300154 {
155 .name = "screendump",
156 .args_type = "filename:F",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300157 .params = "filename",
158 .help = "save screen into PPM image 'filename'",
Luiz Capitulinof1dc58e2010-03-31 15:21:49 -0300159 .user_print = monitor_user_noop,
160 .mhandler.cmd_new = do_screen_dump,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300161 },
162
Blue Swirl23130862009-06-06 08:22:04 +0000163STEXI
164@item screendump @var{filename}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100165@findex screendump
Blue Swirl23130862009-06-06 08:22:04 +0000166Save screen into PPM image @var{filename}.
167ETEXI
168
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300169 {
170 .name = "logfile",
171 .args_type = "filename:F",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300172 .params = "filename",
173 .help = "output logs to 'filename'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300174 .mhandler.cmd = do_logfile,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300175 },
176
Blue Swirl23130862009-06-06 08:22:04 +0000177STEXI
178@item logfile @var{filename}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100179@findex logfile
Blue Swirl23130862009-06-06 08:22:04 +0000180Output logs to @var{filename}.
181ETEXI
182
Prerna Saxena22890ab2010-06-24 17:04:53 +0530183 {
184 .name = "trace-event",
185 .args_type = "name:s,option:b",
186 .params = "name on|off",
187 .help = "changes status of a specific trace event",
Lluísfc764102011-08-31 20:31:18 +0200188 .mhandler.cmd = do_trace_event_set_state,
Prerna Saxena22890ab2010-06-24 17:04:53 +0530189 },
190
191STEXI
192@item trace-event
193@findex trace-event
194changes status of a trace event
195ETEXI
Stefan Hajnoczic5ceb522010-07-13 09:26:33 +0100196
Michael Rothc45a8162011-10-02 08:44:37 -0500197#if defined(CONFIG_TRACE_SIMPLE)
Stefan Hajnoczic5ceb522010-07-13 09:26:33 +0100198 {
199 .name = "trace-file",
200 .args_type = "op:s?,arg:F?",
201 .params = "on|off|flush|set [arg]",
202 .help = "open, close, or flush trace file, or set a new file name",
203 .mhandler.cmd = do_trace_file,
204 },
205
206STEXI
207@item trace-file on|off|flush
208@findex trace-file
209Open, close, or flush the trace file. If no argument is given, the status of the trace file is displayed.
210ETEXI
Prerna Saxena22890ab2010-06-24 17:04:53 +0530211#endif
212
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300213 {
214 .name = "log",
215 .args_type = "items:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300216 .params = "item1[,...]",
217 .help = "activate logging of the specified items to '/tmp/qemu.log'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300218 .mhandler.cmd = do_log,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300219 },
220
Blue Swirl23130862009-06-06 08:22:04 +0000221STEXI
222@item log @var{item1}[,...]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100223@findex log
Blue Swirl23130862009-06-06 08:22:04 +0000224Activate logging of the specified items to @file{/tmp/qemu.log}.
225ETEXI
226
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300227 {
228 .name = "savevm",
229 .args_type = "name:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300230 .params = "[tag|id]",
231 .help = "save a VM snapshot. If no tag or id are provided, a new snapshot is created",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300232 .mhandler.cmd = do_savevm,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300233 },
234
Blue Swirl23130862009-06-06 08:22:04 +0000235STEXI
236@item savevm [@var{tag}|@var{id}]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100237@findex savevm
Blue Swirl23130862009-06-06 08:22:04 +0000238Create a snapshot of the whole virtual machine. If @var{tag} is
239provided, it is used as human readable identifier. If there is already
240a snapshot with the same tag or ID, it is replaced. More info at
241@ref{vm_snapshots}.
242ETEXI
243
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300244 {
245 .name = "loadvm",
246 .args_type = "name:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300247 .params = "tag|id",
248 .help = "restore a VM snapshot from its tag or id",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300249 .mhandler.cmd = do_loadvm,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300250 },
251
Blue Swirl23130862009-06-06 08:22:04 +0000252STEXI
253@item loadvm @var{tag}|@var{id}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100254@findex loadvm
Blue Swirl23130862009-06-06 08:22:04 +0000255Set the whole virtual machine to the snapshot identified by the tag
256@var{tag} or the unique snapshot ID @var{id}.
257ETEXI
258
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300259 {
260 .name = "delvm",
261 .args_type = "name:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300262 .params = "tag|id",
263 .help = "delete a VM snapshot from its tag or id",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300264 .mhandler.cmd = do_delvm,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300265 },
266
Blue Swirl23130862009-06-06 08:22:04 +0000267STEXI
268@item delvm @var{tag}|@var{id}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100269@findex delvm
Blue Swirl23130862009-06-06 08:22:04 +0000270Delete the snapshot identified by @var{tag} or @var{id}.
271ETEXI
272
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300273 {
274 .name = "singlestep",
275 .args_type = "option:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300276 .params = "[on|off]",
277 .help = "run emulation in singlestep mode or switch to normal mode",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300278 .mhandler.cmd = do_singlestep,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300279 },
280
Blue Swirl23130862009-06-06 08:22:04 +0000281STEXI
282@item singlestep [off]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100283@findex singlestep
Blue Swirl23130862009-06-06 08:22:04 +0000284Run the emulation in single step mode.
285If called with option off, the emulation returns to normal mode.
286ETEXI
287
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300288 {
289 .name = "stop",
290 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300291 .params = "",
292 .help = "stop emulation",
Luiz Capitulino5f158f22011-09-15 14:34:39 -0300293 .mhandler.cmd = hmp_stop,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300294 },
295
Blue Swirl23130862009-06-06 08:22:04 +0000296STEXI
297@item stop
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100298@findex stop
Blue Swirl23130862009-06-06 08:22:04 +0000299Stop emulation.
300ETEXI
301
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300302 {
303 .name = "c|cont",
304 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300305 .params = "",
306 .help = "resume emulation",
Luiz Capitulinoe42e8182011-11-22 17:58:31 -0200307 .mhandler.cmd = hmp_cont,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300308 },
309
Blue Swirl23130862009-06-06 08:22:04 +0000310STEXI
311@item c or cont
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100312@findex cont
Blue Swirl23130862009-06-06 08:22:04 +0000313Resume emulation.
314ETEXI
315
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300316 {
317 .name = "gdbserver",
318 .args_type = "device:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300319 .params = "[device]",
320 .help = "start gdbserver on given device (default 'tcp::1234'), stop with 'none'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300321 .mhandler.cmd = do_gdbserver,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300322 },
323
Blue Swirl23130862009-06-06 08:22:04 +0000324STEXI
325@item gdbserver [@var{port}]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100326@findex gdbserver
Blue Swirl23130862009-06-06 08:22:04 +0000327Start gdbserver session (default @var{port}=1234)
328ETEXI
329
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300330 {
331 .name = "x",
332 .args_type = "fmt:/,addr:l",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300333 .params = "/fmt addr",
334 .help = "virtual memory dump starting at 'addr'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300335 .mhandler.cmd = do_memory_dump,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300336 },
337
Blue Swirl23130862009-06-06 08:22:04 +0000338STEXI
339@item x/fmt @var{addr}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100340@findex x
Blue Swirl23130862009-06-06 08:22:04 +0000341Virtual memory dump starting at @var{addr}.
342ETEXI
343
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300344 {
345 .name = "xp",
346 .args_type = "fmt:/,addr:l",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300347 .params = "/fmt addr",
348 .help = "physical memory dump starting at 'addr'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300349 .mhandler.cmd = do_physical_memory_dump,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300350 },
351
Blue Swirl23130862009-06-06 08:22:04 +0000352STEXI
353@item xp /@var{fmt} @var{addr}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100354@findex xp
Blue Swirl23130862009-06-06 08:22:04 +0000355Physical memory dump starting at @var{addr}.
356
357@var{fmt} is a format which tells the command how to format the
358data. Its syntax is: @option{/@{count@}@{format@}@{size@}}
359
360@table @var
361@item count
362is the number of items to be dumped.
363
364@item format
365can be x (hex), d (signed decimal), u (unsigned decimal), o (octal),
366c (char) or i (asm instruction).
367
368@item size
369can be b (8 bits), h (16 bits), w (32 bits) or g (64 bits). On x86,
370@code{h} or @code{w} can be specified with the @code{i} format to
371respectively select 16 or 32 bit code instruction size.
372
373@end table
374
375Examples:
376@itemize
377@item
378Dump 10 instructions at the current instruction pointer:
379@example
380(qemu) x/10i $eip
3810x90107063: ret
3820x90107064: sti
3830x90107065: lea 0x0(%esi,1),%esi
3840x90107069: lea 0x0(%edi,1),%edi
3850x90107070: ret
3860x90107071: jmp 0x90107080
3870x90107073: nop
3880x90107074: nop
3890x90107075: nop
3900x90107076: nop
391@end example
392
393@item
394Dump 80 16 bit values at the start of the video memory.
395@smallexample
396(qemu) xp/80hx 0xb8000
3970x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42
3980x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41
3990x000b8020: 0x0b42 0x0b69 0x0b6f 0x0b73 0x0b20 0x0b63 0x0b75 0x0b72
4000x000b8030: 0x0b72 0x0b65 0x0b6e 0x0b74 0x0b2d 0x0b63 0x0b76 0x0b73
4010x000b8040: 0x0b20 0x0b30 0x0b35 0x0b20 0x0b4e 0x0b6f 0x0b76 0x0b20
4020x000b8050: 0x0b32 0x0b30 0x0b30 0x0b33 0x0720 0x0720 0x0720 0x0720
4030x000b8060: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
4040x000b8070: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
4050x000b8080: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
4060x000b8090: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
407@end smallexample
408@end itemize
409ETEXI
410
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300411 {
412 .name = "p|print",
413 .args_type = "fmt:/,val:l",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300414 .params = "/fmt expr",
415 .help = "print expression value (use $reg for CPU register access)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300416 .mhandler.cmd = do_print,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300417 },
418
Blue Swirl23130862009-06-06 08:22:04 +0000419STEXI
420@item p or print/@var{fmt} @var{expr}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100421@findex print
Blue Swirl23130862009-06-06 08:22:04 +0000422
423Print expression value. Only the @var{format} part of @var{fmt} is
424used.
425ETEXI
426
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300427 {
428 .name = "i",
429 .args_type = "fmt:/,addr:i,index:i.",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300430 .params = "/fmt addr",
431 .help = "I/O port read",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300432 .mhandler.cmd = do_ioport_read,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300433 },
434
Blue Swirl23130862009-06-06 08:22:04 +0000435STEXI
436Read I/O port.
437ETEXI
438
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300439 {
440 .name = "o",
441 .args_type = "fmt:/,addr:i,val:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300442 .params = "/fmt addr value",
443 .help = "I/O port write",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300444 .mhandler.cmd = do_ioport_write,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300445 },
446
Jan Kiszkaf1147842009-07-14 10:20:11 +0200447STEXI
448Write to I/O port.
449ETEXI
Blue Swirl23130862009-06-06 08:22:04 +0000450
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300451 {
452 .name = "sendkey",
453 .args_type = "string:s,hold_time:i?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300454 .params = "keys [hold_ms]",
455 .help = "send keys to the VM (e.g. 'sendkey ctrl-alt-f1', default hold time=100 ms)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300456 .mhandler.cmd = do_sendkey,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300457 },
458
Blue Swirl23130862009-06-06 08:22:04 +0000459STEXI
460@item sendkey @var{keys}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100461@findex sendkey
Blue Swirl23130862009-06-06 08:22:04 +0000462
463Send @var{keys} to the emulator. @var{keys} could be the name of the
464key or @code{#} followed by the raw value in either decimal or hexadecimal
465format. Use @code{-} to press several keys simultaneously. Example:
466@example
467sendkey ctrl-alt-f1
468@end example
469
470This command is useful to send keys that your graphical user interface
471intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
472ETEXI
473
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300474 {
475 .name = "system_reset",
476 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300477 .params = "",
478 .help = "reset the system",
Luiz Capitulino38d22652011-09-15 14:41:46 -0300479 .mhandler.cmd = hmp_system_reset,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300480 },
481
Blue Swirl23130862009-06-06 08:22:04 +0000482STEXI
483@item system_reset
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100484@findex system_reset
Blue Swirl23130862009-06-06 08:22:04 +0000485
486Reset the system.
487ETEXI
488
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300489 {
490 .name = "system_powerdown",
491 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300492 .params = "",
493 .help = "send system power down event",
Luiz Capitulino5bc465e2011-09-28 11:06:15 -0300494 .mhandler.cmd = hmp_system_powerdown,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300495 },
496
Blue Swirl23130862009-06-06 08:22:04 +0000497STEXI
498@item system_powerdown
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100499@findex system_powerdown
Blue Swirl23130862009-06-06 08:22:04 +0000500
501Power down the system (if supported).
502ETEXI
503
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300504 {
505 .name = "sum",
506 .args_type = "start:i,size:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300507 .params = "addr size",
508 .help = "compute the checksum of a memory region",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300509 .mhandler.cmd = do_sum,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300510 },
511
Blue Swirl23130862009-06-06 08:22:04 +0000512STEXI
513@item sum @var{addr} @var{size}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100514@findex sum
Blue Swirl23130862009-06-06 08:22:04 +0000515
516Compute the checksum of a memory region.
517ETEXI
518
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300519 {
520 .name = "usb_add",
521 .args_type = "devname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300522 .params = "device",
523 .help = "add USB device (e.g. 'host:bus.addr' or 'host:vendor_id:product_id')",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300524 .mhandler.cmd = do_usb_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300525 },
526
Blue Swirl23130862009-06-06 08:22:04 +0000527STEXI
528@item usb_add @var{devname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100529@findex usb_add
Blue Swirl23130862009-06-06 08:22:04 +0000530
531Add the USB device @var{devname}. For details of available devices see
532@ref{usb_devices}
533ETEXI
534
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300535 {
536 .name = "usb_del",
537 .args_type = "devname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300538 .params = "device",
539 .help = "remove USB device 'bus.addr'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300540 .mhandler.cmd = do_usb_del,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300541 },
542
Blue Swirl23130862009-06-06 08:22:04 +0000543STEXI
544@item usb_del @var{devname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100545@findex usb_del
Blue Swirl23130862009-06-06 08:22:04 +0000546
547Remove the USB device @var{devname} from the QEMU virtual USB
548hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor
549command @code{info usb} to see the devices you can remove.
550ETEXI
551
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300552 {
553 .name = "device_add",
Markus Armbrusterc7e4e8c2010-02-10 20:47:28 +0100554 .args_type = "device:O",
555 .params = "driver[,prop=value][,...]",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300556 .help = "add device, like -device on the command line",
Markus Armbruster8bc27242010-02-10 20:52:01 +0100557 .user_print = monitor_user_noop,
558 .mhandler.cmd_new = do_device_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300559 },
560
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200561STEXI
562@item device_add @var{config}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100563@findex device_add
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200564
565Add device.
566ETEXI
567
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300568 {
569 .name = "device_del",
570 .args_type = "id:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300571 .params = "device",
572 .help = "remove device",
Markus Armbruster17a38ea2010-03-22 11:38:14 +0100573 .user_print = monitor_user_noop,
574 .mhandler.cmd_new = do_device_del,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300575 },
576
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200577STEXI
578@item device_del @var{id}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100579@findex device_del
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200580
581Remove device @var{id}.
582ETEXI
583
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300584 {
585 .name = "cpu",
586 .args_type = "index:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300587 .params = "index",
588 .help = "set the default CPU",
Luiz Capitulino755f1962011-10-06 14:31:39 -0300589 .mhandler.cmd = hmp_cpu,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300590 },
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200591
Blue Swirl23130862009-06-06 08:22:04 +0000592STEXI
Markus Armbrusterc427ea92010-05-04 13:20:32 +0200593@item cpu @var{index}
594@findex cpu
Blue Swirl23130862009-06-06 08:22:04 +0000595Set the default CPU.
596ETEXI
597
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300598 {
599 .name = "mouse_move",
600 .args_type = "dx_str:s,dy_str:s,dz_str:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300601 .params = "dx dy [dz]",
602 .help = "send mouse move events",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300603 .mhandler.cmd = do_mouse_move,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300604 },
605
Blue Swirl23130862009-06-06 08:22:04 +0000606STEXI
607@item mouse_move @var{dx} @var{dy} [@var{dz}]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100608@findex mouse_move
Blue Swirl23130862009-06-06 08:22:04 +0000609Move the active mouse to the specified coordinates @var{dx} @var{dy}
610with optional scroll axis @var{dz}.
611ETEXI
612
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300613 {
614 .name = "mouse_button",
615 .args_type = "button_state:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300616 .params = "state",
617 .help = "change mouse button state (1=L, 2=M, 4=R)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300618 .mhandler.cmd = do_mouse_button,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300619 },
620
Blue Swirl23130862009-06-06 08:22:04 +0000621STEXI
622@item mouse_button @var{val}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100623@findex mouse_button
Blue Swirl23130862009-06-06 08:22:04 +0000624Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
625ETEXI
626
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300627 {
628 .name = "mouse_set",
629 .args_type = "index:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300630 .params = "index",
631 .help = "set which mouse device receives events",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300632 .mhandler.cmd = do_mouse_set,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300633 },
634
Blue Swirl23130862009-06-06 08:22:04 +0000635STEXI
636@item mouse_set @var{index}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100637@findex mouse_set
Blue Swirl23130862009-06-06 08:22:04 +0000638Set which mouse device receives events at given @var{index}, index
639can be obtained with
640@example
641info mice
642@end example
643ETEXI
644
645#ifdef HAS_AUDIO
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300646 {
647 .name = "wavcapture",
648 .args_type = "path:F,freq:i?,bits:i?,nchannels:i?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300649 .params = "path [frequency [bits [channels]]]",
650 .help = "capture audio to a wave file (default frequency=44100 bits=16 channels=2)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300651 .mhandler.cmd = do_wav_capture,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300652 },
Blue Swirl23130862009-06-06 08:22:04 +0000653#endif
654STEXI
655@item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100656@findex wavcapture
Blue Swirl23130862009-06-06 08:22:04 +0000657Capture audio into @var{filename}. Using sample rate @var{frequency}
658bits per sample @var{bits} and number of channels @var{channels}.
659
660Defaults:
661@itemize @minus
662@item Sample rate = 44100 Hz - CD quality
663@item Bits = 16
664@item Number of channels = 2 - Stereo
665@end itemize
666ETEXI
667
668#ifdef HAS_AUDIO
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300669 {
670 .name = "stopcapture",
671 .args_type = "n:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300672 .params = "capture index",
673 .help = "stop capture",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300674 .mhandler.cmd = do_stop_capture,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300675 },
Blue Swirl23130862009-06-06 08:22:04 +0000676#endif
677STEXI
678@item stopcapture @var{index}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100679@findex stopcapture
Blue Swirl23130862009-06-06 08:22:04 +0000680Stop capture with a given @var{index}, index can be obtained with
681@example
682info capture
683@end example
684ETEXI
685
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300686 {
687 .name = "memsave",
688 .args_type = "val:l,size:i,filename:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300689 .params = "addr size file",
690 .help = "save to disk virtual memory dump starting at 'addr' of size 'size'",
Luiz Capitulino0cfd6a92011-11-22 16:32:37 -0200691 .mhandler.cmd = hmp_memsave,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300692 },
693
Blue Swirl23130862009-06-06 08:22:04 +0000694STEXI
695@item memsave @var{addr} @var{size} @var{file}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100696@findex memsave
Blue Swirl23130862009-06-06 08:22:04 +0000697save to disk virtual memory dump starting at @var{addr} of size @var{size}.
698ETEXI
699
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300700 {
701 .name = "pmemsave",
702 .args_type = "val:l,size:i,filename:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300703 .params = "addr size file",
704 .help = "save to disk physical memory dump starting at 'addr' of size 'size'",
Luiz Capitulino6d3962b2011-11-22 17:26:46 -0200705 .mhandler.cmd = hmp_pmemsave,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300706 },
707
Blue Swirl23130862009-06-06 08:22:04 +0000708STEXI
709@item pmemsave @var{addr} @var{size} @var{file}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100710@findex pmemsave
Blue Swirl23130862009-06-06 08:22:04 +0000711save to disk physical memory dump starting at @var{addr} of size @var{size}.
712ETEXI
713
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300714 {
715 .name = "boot_set",
716 .args_type = "bootdevice:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300717 .params = "bootdevice",
718 .help = "define new values for the boot device list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300719 .mhandler.cmd = do_boot_set,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300720 },
721
Blue Swirl23130862009-06-06 08:22:04 +0000722STEXI
723@item boot_set @var{bootdevicelist}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100724@findex boot_set
Blue Swirl23130862009-06-06 08:22:04 +0000725
726Define new values for the boot device list. Those values will override
727the values specified on the command line through the @code{-boot} option.
728
729The values that can be specified here depend on the machine type, but are
730the same that can be specified in the @code{-boot} command line option.
731ETEXI
732
733#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300734 {
735 .name = "nmi",
Luiz Capitulinoe9b4b432011-04-29 12:11:50 -0300736 .args_type = "",
737 .params = "",
738 .help = "inject an NMI on all guest's CPUs",
Luiz Capitulinoab49ab52011-11-23 12:55:53 -0200739 .mhandler.cmd = hmp_inject_nmi,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300740 },
Blue Swirl23130862009-06-06 08:22:04 +0000741#endif
742STEXI
743@item nmi @var{cpu}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100744@findex nmi
Blue Swirl23130862009-06-06 08:22:04 +0000745Inject an NMI on the given CPU (x86 only).
746ETEXI
747
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300748 {
749 .name = "migrate",
lirans@il.ibm.comfbc3d962009-11-02 15:41:13 +0200750 .args_type = "detach:-d,blk:-b,inc:-i,uri:s",
751 .params = "[-d] [-b] [-i] uri",
752 .help = "migrate to URI (using -d to not wait for completion)"
753 "\n\t\t\t -b for migration without shared storage with"
754 " full copy of disk\n\t\t\t -i for migration without "
755 "shared storage with incremental copy of disk "
756 "(base image shared between src and destination)",
757 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200758 .mhandler.cmd_new = do_migrate,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300759 },
760
lirans@il.ibm.comfbc3d962009-11-02 15:41:13 +0200761
Blue Swirl23130862009-06-06 08:22:04 +0000762STEXI
lirans@il.ibm.comfbc3d962009-11-02 15:41:13 +0200763@item migrate [-d] [-b] [-i] @var{uri}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100764@findex migrate
Blue Swirl23130862009-06-06 08:22:04 +0000765Migrate to @var{uri} (using -d to not wait for completion).
lirans@il.ibm.comfbc3d962009-11-02 15:41:13 +0200766 -b for migration with full copy of disk
767 -i for migration with incremental copy of disk (base image is shared)
Blue Swirl23130862009-06-06 08:22:04 +0000768ETEXI
769
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300770 {
771 .name = "migrate_cancel",
772 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300773 .params = "",
774 .help = "cancel the current VM migration",
Luiz Capitulino911d2962009-10-16 12:23:47 -0300775 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200776 .mhandler.cmd_new = do_migrate_cancel,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300777 },
778
Blue Swirl23130862009-06-06 08:22:04 +0000779STEXI
780@item migrate_cancel
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100781@findex migrate_cancel
Blue Swirl23130862009-06-06 08:22:04 +0000782Cancel the current VM migration.
783ETEXI
784
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300785 {
786 .name = "migrate_set_speed",
Jes Sorensened3d4a82010-10-21 17:15:48 +0200787 .args_type = "value:o",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300788 .params = "value",
Jes Sorensened3d4a82010-10-21 17:15:48 +0200789 .help = "set maximum speed (in bytes) for migrations. "
790 "Defaults to MB if no size suffix is specified, ie. B/K/M/G/T",
Markus Armbruster5fd90832010-01-25 14:23:05 +0100791 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200792 .mhandler.cmd_new = do_migrate_set_speed,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300793 },
794
Blue Swirl23130862009-06-06 08:22:04 +0000795STEXI
796@item migrate_set_speed @var{value}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100797@findex migrate_set_speed
Blue Swirl23130862009-06-06 08:22:04 +0000798Set maximum speed to @var{value} (in bytes) for migrations.
799ETEXI
800
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300801 {
802 .name = "migrate_set_downtime",
Markus Armbrusterb0fbf7d2010-01-25 14:23:07 +0100803 .args_type = "value:T",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300804 .params = "value",
805 .help = "set maximum tolerated downtime (in seconds) for migrations",
Markus Armbrusterc6027f52010-01-25 14:23:08 +0100806 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200807 .mhandler.cmd_new = do_migrate_set_downtime,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300808 },
Glauber Costa2ea42952009-05-28 15:22:58 -0400809
810STEXI
811@item migrate_set_downtime @var{second}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100812@findex migrate_set_downtime
Glauber Costa2ea42952009-05-28 15:22:58 -0400813Set maximum tolerated downtime (in seconds) for migration.
814ETEXI
815
Jes Sorensenf8882562010-12-16 13:52:16 +0100816 {
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100817 .name = "client_migrate_info",
818 .args_type = "protocol:s,hostname:s,port:i?,tls-port:i?,cert-subject:s?",
819 .params = "protocol hostname port tls-port cert-subject",
820 .help = "send migration info to spice/vnc client",
821 .user_print = monitor_user_noop,
Yonit Halperinedc5cb12011-10-17 10:03:18 +0200822 .mhandler.cmd_async = client_migrate_info,
823 .flags = MONITOR_CMD_ASYNC,
Jes Sorensenf8882562010-12-16 13:52:16 +0100824 },
825
826STEXI
Gerd Hoffmanne866e232010-04-23 13:28:21 +0200827@item client_migrate_info @var{protocol} @var{hostname} @var{port} @var{tls-port} @var{cert-subject}
828@findex client_migrate_info
829Set the spice/vnc connection info for the migration target. The spice/vnc
830server will ask the spice/vnc client to automatically reconnect using the
831new parameters (if specified) once the vm migration finished successfully.
832ETEXI
833
834 {
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100835 .name = "snapshot_blkdev",
Jes Sorensend967b2f2011-07-11 20:01:09 +0200836 .args_type = "device:B,snapshot-file:s?,format:s?",
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100837 .params = "device [new-image-file] [format]",
838 .help = "initiates a live snapshot\n\t\t\t"
839 "of device. If a new image file is specified, the\n\t\t\t"
840 "new image file will become the new root image.\n\t\t\t"
841 "If format is specified, the snapshot file will\n\t\t\t"
842 "be created in that format. Otherwise the\n\t\t\t"
843 "snapshot will be internal! (currently unsupported)",
844 .mhandler.cmd_new = do_snapshot_blkdev,
Gerd Hoffmanne866e232010-04-23 13:28:21 +0200845 },
846
847STEXI
Jes Sorensenf8882562010-12-16 13:52:16 +0100848@item snapshot_blkdev
849@findex snapshot_blkdev
850Snapshot device, using snapshot file as target if provided
851ETEXI
852
Blue Swirl23130862009-06-06 08:22:04 +0000853#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300854 {
855 .name = "drive_add",
856 .args_type = "pci_addr:s,opts:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300857 .params = "[[<domain>:]<bus>:]<slot>\n"
858 "[file=file][,if=type][,bus=n]\n"
Stefan Hajnoczifb0490f2011-11-17 13:40:32 +0000859 "[,unit=m][,media=d][,index=i]\n"
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300860 "[,cyls=c,heads=h,secs=s[,trans=t]]\n"
Stefan Hajnoczifb0490f2011-11-17 13:40:32 +0000861 "[,snapshot=on|off][,cache=on|off]\n"
862 "[,readonly=on|off][,copy-on-read=on|off]",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300863 .help = "add drive to PCI storage controller",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300864 .mhandler.cmd = drive_hot_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300865 },
Blue Swirl23130862009-06-06 08:22:04 +0000866#endif
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300867
Blue Swirl23130862009-06-06 08:22:04 +0000868STEXI
869@item drive_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100870@findex drive_add
Blue Swirl23130862009-06-06 08:22:04 +0000871Add drive to PCI storage controller.
872ETEXI
873
874#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300875 {
876 .name = "pci_add",
877 .args_type = "pci_addr:s,type:s,opts:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300878 .params = "auto|[[<domain>:]<bus>:]<slot> nic|storage [[vlan=n][,macaddr=addr][,model=type]] [file=file][,if=type][,bus=nr]...",
879 .help = "hot-add PCI device",
Markus Armbruster6c6a58a2010-05-12 10:53:00 +0200880 .mhandler.cmd = pci_device_hot_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300881 },
Blue Swirl23130862009-06-06 08:22:04 +0000882#endif
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300883
Blue Swirl23130862009-06-06 08:22:04 +0000884STEXI
885@item pci_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100886@findex pci_add
Blue Swirl23130862009-06-06 08:22:04 +0000887Hot-add PCI device.
888ETEXI
889
890#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300891 {
892 .name = "pci_del",
893 .args_type = "pci_addr:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300894 .params = "[[<domain>:]<bus>:]<slot>",
895 .help = "hot remove PCI device",
Markus Armbrusterb752daf2010-05-12 10:53:01 +0200896 .mhandler.cmd = do_pci_device_hot_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300897 },
Blue Swirl23130862009-06-06 08:22:04 +0000898#endif
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300899
Blue Swirl23130862009-06-06 08:22:04 +0000900STEXI
901@item pci_del
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100902@findex pci_del
Blue Swirl23130862009-06-06 08:22:04 +0000903Hot remove PCI device.
904ETEXI
905
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300906 {
Isaku Yamahata2ae63bd2010-12-24 12:14:14 +0900907 .name = "pcie_aer_inject_error",
908 .args_type = "advisory_non_fatal:-a,correctable:-c,"
909 "id:s,error_status:s,"
910 "header0:i?,header1:i?,header2:i?,header3:i?,"
911 "prefix0:i?,prefix1:i?,prefix2:i?,prefix3:i?",
912 .params = "[-a] [-c] id "
913 "<error_status> [<tlp header> [<tlp header prefix>]]",
914 .help = "inject pcie aer error\n\t\t\t"
915 " -a for advisory non fatal error\n\t\t\t"
916 " -c for correctable error\n\t\t\t"
917 "<id> = qdev device id\n\t\t\t"
918 "<error_status> = error string or 32bit\n\t\t\t"
919 "<tlb header> = 32bit x 4\n\t\t\t"
920 "<tlb header prefix> = 32bit x 4",
921 .user_print = pcie_aer_inject_error_print,
922 .mhandler.cmd_new = do_pcie_aer_inejct_error,
923 },
924
925STEXI
926@item pcie_aer_inject_error
927@findex pcie_aer_inject_error
928Inject PCIe AER error
929ETEXI
930
931 {
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300932 .name = "host_net_add",
933 .args_type = "device:s,opts:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300934 .params = "tap|user|socket|vde|dump [options]",
935 .help = "add host VLAN client",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300936 .mhandler.cmd = net_host_device_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300937 },
938
Blue Swirl23130862009-06-06 08:22:04 +0000939STEXI
940@item host_net_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100941@findex host_net_add
Blue Swirl23130862009-06-06 08:22:04 +0000942Add host VLAN client.
943ETEXI
944
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300945 {
946 .name = "host_net_remove",
947 .args_type = "vlan_id:i,device:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300948 .params = "vlan_id name",
949 .help = "remove host VLAN client",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300950 .mhandler.cmd = net_host_device_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300951 },
952
Blue Swirl23130862009-06-06 08:22:04 +0000953STEXI
954@item host_net_remove
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100955@findex host_net_remove
Blue Swirl23130862009-06-06 08:22:04 +0000956Remove host VLAN client.
957ETEXI
958
Markus Armbrusterae82d322010-03-25 17:22:40 +0100959 {
960 .name = "netdev_add",
961 .args_type = "netdev:O",
962 .params = "[user|tap|socket],id=str[,prop=value][,...]",
963 .help = "add host network device",
964 .user_print = monitor_user_noop,
965 .mhandler.cmd_new = do_netdev_add,
966 },
967
968STEXI
969@item netdev_add
970@findex netdev_add
971Add host network device.
972ETEXI
973
974 {
975 .name = "netdev_del",
976 .args_type = "id:s",
977 .params = "id",
978 .help = "remove host network device",
979 .user_print = monitor_user_noop,
980 .mhandler.cmd_new = do_netdev_del,
981 },
982
983STEXI
984@item netdev_del
985@findex netdev_del
986Remove host network device.
987ETEXI
988
Blue Swirl23130862009-06-06 08:22:04 +0000989#ifdef CONFIG_SLIRP
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300990 {
991 .name = "hostfwd_add",
992 .args_type = "arg1:s,arg2:s?,arg3:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300993 .params = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport",
994 .help = "redirect TCP or UDP connections from host to guest (requires -net user)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300995 .mhandler.cmd = net_slirp_hostfwd_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300996 },
Markus Armbruster21413d62010-05-04 13:20:30 +0200997#endif
998STEXI
999@item hostfwd_add
1000@findex hostfwd_add
1001Redirect TCP or UDP connections from host to guest (requires -net user).
1002ETEXI
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001003
Markus Armbruster21413d62010-05-04 13:20:30 +02001004#ifdef CONFIG_SLIRP
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001005 {
1006 .name = "hostfwd_remove",
1007 .args_type = "arg1:s,arg2:s?,arg3:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001008 .params = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport",
1009 .help = "remove host-to-guest TCP or UDP redirection",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001010 .mhandler.cmd = net_slirp_hostfwd_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001011 },
1012
Blue Swirl23130862009-06-06 08:22:04 +00001013#endif
1014STEXI
Markus Armbruster21413d62010-05-04 13:20:30 +02001015@item hostfwd_remove
1016@findex hostfwd_remove
1017Remove host-to-guest TCP or UDP redirection.
Blue Swirl23130862009-06-06 08:22:04 +00001018ETEXI
1019
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001020 {
1021 .name = "balloon",
Luiz Capitulino3b0bd6e2009-12-18 13:25:05 -02001022 .args_type = "value:M",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001023 .params = "target",
Riccardo Magliocchetti3c056132010-05-19 18:49:28 +02001024 .help = "request VM to change its memory allocation (in MB)",
Luiz Capitulino83fb1de2009-10-07 13:42:01 -03001025 .user_print = monitor_user_noop,
Adam Litke625a5be2010-01-26 14:17:35 -06001026 .mhandler.cmd_async = do_balloon,
Jan Kiszka8ac470c2010-06-16 00:38:39 +02001027 .flags = MONITOR_CMD_ASYNC,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001028 },
1029
Blue Swirl23130862009-06-06 08:22:04 +00001030STEXI
1031@item balloon @var{value}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001032@findex balloon
Blue Swirl23130862009-06-06 08:22:04 +00001033Request VM to change its memory allocation to @var{value} (in MB).
1034ETEXI
1035
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001036 {
1037 .name = "set_link",
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001038 .args_type = "name:s,up:b",
1039 .params = "name on|off",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001040 .help = "change the link status of a network adapter",
Luiz Capitulino4b371562011-11-23 13:11:55 -02001041 .mhandler.cmd = hmp_set_link,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001042 },
1043
Blue Swirl23130862009-06-06 08:22:04 +00001044STEXI
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001045@item set_link @var{name} [on|off]
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001046@findex set_link
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001047Switch link @var{name} on (i.e. up) or off (i.e. down).
Blue Swirl23130862009-06-06 08:22:04 +00001048ETEXI
1049
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001050 {
1051 .name = "watchdog_action",
1052 .args_type = "action:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001053 .params = "[reset|shutdown|poweroff|pause|debug|none]",
1054 .help = "change watchdog action",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001055 .mhandler.cmd = do_watchdog_action,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001056 },
1057
Blue Swirl23130862009-06-06 08:22:04 +00001058STEXI
1059@item watchdog_action
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001060@findex watchdog_action
Blue Swirl23130862009-06-06 08:22:04 +00001061Change watchdog action.
1062ETEXI
1063
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001064 {
1065 .name = "acl_show",
1066 .args_type = "aclname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001067 .params = "aclname",
1068 .help = "list rules in the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001069 .mhandler.cmd = do_acl_show,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001070 },
1071
Blue Swirl23130862009-06-06 08:22:04 +00001072STEXI
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001073@item acl_show @var{aclname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001074@findex acl_show
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001075List all the matching rules in the access control list, and the default
1076policy. There are currently two named access control lists,
1077@var{vnc.x509dname} and @var{vnc.username} matching on the x509 client
1078certificate distinguished name, and SASL username respectively.
1079ETEXI
Blue Swirl23130862009-06-06 08:22:04 +00001080
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001081 {
1082 .name = "acl_policy",
1083 .args_type = "aclname:s,policy:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001084 .params = "aclname allow|deny",
1085 .help = "set default access control list policy",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001086 .mhandler.cmd = do_acl_policy,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001087 },
1088
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001089STEXI
Jan Kiszkacbbfacc2009-07-03 08:46:05 +02001090@item acl_policy @var{aclname} @code{allow|deny}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001091@findex acl_policy
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001092Set the default access control list policy, used in the event that
Blue Swirl23130862009-06-06 08:22:04 +00001093none of the explicit rules match. The default policy at startup is
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001094always @code{deny}.
1095ETEXI
1096
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001097 {
1098 .name = "acl_add",
1099 .args_type = "aclname:s,match:s,policy:s,index:i?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001100 .params = "aclname match allow|deny [index]",
1101 .help = "add a match rule to the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001102 .mhandler.cmd = do_acl_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001103 },
1104
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001105STEXI
Markus Armbruster0e4aec92010-05-04 13:20:31 +02001106@item acl_add @var{aclname} @var{match} @code{allow|deny} [@var{index}]
1107@findex acl_add
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001108Add a match rule to the access control list, allowing or denying access.
1109The match will normally be an exact username or x509 distinguished name,
1110but can optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to
1111allow all users in the @code{EXAMPLE.COM} kerberos realm. The match will
Blue Swirl23130862009-06-06 08:22:04 +00001112normally be appended to the end of the ACL, but can be inserted
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001113earlier in the list if the optional @var{index} parameter is supplied.
1114ETEXI
1115
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001116 {
1117 .name = "acl_remove",
1118 .args_type = "aclname:s,match:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001119 .params = "aclname match",
1120 .help = "remove a match rule from the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001121 .mhandler.cmd = do_acl_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001122 },
1123
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001124STEXI
1125@item acl_remove @var{aclname} @var{match}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001126@findex acl_remove
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001127Remove the specified match rule from the access control list.
1128ETEXI
1129
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001130 {
1131 .name = "acl_reset",
1132 .args_type = "aclname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001133 .params = "aclname",
1134 .help = "reset the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001135 .mhandler.cmd = do_acl_reset,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001136 },
1137
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001138STEXI
Markus Armbruster0e4aec92010-05-04 13:20:31 +02001139@item acl_reset @var{aclname}
1140@findex acl_reset
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001141Remove all matches from the access control list, and set the default
Blue Swirl23130862009-06-06 08:22:04 +00001142policy back to @code{deny}.
Blue Swirl23130862009-06-06 08:22:04 +00001143ETEXI
1144
Huang Ying79c4f6b2009-06-23 10:05:14 +08001145#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001146
1147 {
1148 .name = "mce",
Jin Dongming31ce5e02010-12-10 17:21:02 +09001149 .args_type = "broadcast:-b,cpu_index:i,bank:i,status:l,mcg_status:l,addr:l,misc:l",
1150 .params = "[-b] cpu bank status mcgstatus addr misc",
1151 .help = "inject a MCE on the given CPU [and broadcast to other CPUs with -b option]",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001152 .mhandler.cmd = do_inject_mce,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001153 },
1154
Huang Ying79c4f6b2009-06-23 10:05:14 +08001155#endif
1156STEXI
1157@item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001158@findex mce (x86)
Huang Ying79c4f6b2009-06-23 10:05:14 +08001159Inject an MCE on the given CPU (x86 only).
1160ETEXI
1161
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001162 {
1163 .name = "getfd",
1164 .args_type = "fdname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001165 .params = "getfd name",
1166 .help = "receive a file descriptor via SCM rights and assign it a name",
Luiz Capitulinof0d60002009-10-16 12:23:50 -03001167 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -02001168 .mhandler.cmd_new = do_getfd,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001169 },
1170
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001171STEXI
1172@item getfd @var{fdname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001173@findex getfd
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001174If a file descriptor is passed alongside this command using the SCM_RIGHTS
1175mechanism on unix sockets, it is stored using the name @var{fdname} for
1176later use by other monitor commands.
1177ETEXI
1178
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001179 {
1180 .name = "closefd",
1181 .args_type = "fdname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001182 .params = "closefd name",
1183 .help = "close a file descriptor previously passed via SCM rights",
Luiz Capitulino18f3a512009-10-16 12:23:51 -03001184 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -02001185 .mhandler.cmd_new = do_closefd,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001186 },
1187
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001188STEXI
1189@item closefd @var{fdname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001190@findex closefd
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001191Close the file descriptor previously assigned to @var{fdname} using the
1192@code{getfd} command. This is only needed if the file descriptor was never
1193used by another monitor command.
1194ETEXI
1195
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001196 {
1197 .name = "block_passwd",
1198 .args_type = "device:B,password:s",
1199 .params = "block_passwd device password",
1200 .help = "set the password of encrypted block devices",
Luiz Capitulinoa4dea8a2011-11-23 13:28:21 -02001201 .mhandler.cmd = hmp_block_passwd,
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001202 },
1203
1204STEXI
Zhi Yong Wu727f0052011-11-08 13:00:31 +08001205@item block_set_io_throttle @var{device} @var{bps} @var{bps_rd} @var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
1206@findex block_set_io_throttle
1207Change 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}
1208ETEXI
1209
1210 {
1211 .name = "block_set_io_throttle",
1212 .args_type = "device:B,bps:l,bps_rd:l,bps_wr:l,iops:l,iops_rd:l,iops_wr:l",
1213 .params = "device bps bps_rd bps_wr iops iops_rd iops_wr",
1214 .help = "change I/O throttle limits for a block drive",
1215 .user_print = monitor_user_noop,
1216 .mhandler.cmd_new = do_block_set_io_throttle,
1217 },
1218
1219STEXI
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001220@item block_passwd @var{device} @var{password}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001221@findex block_passwd
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001222Set the encrypted device @var{device} password to @var{password}
1223ETEXI
Jan Kiszkab40292e2010-05-31 14:43:31 -03001224
Jan Kiszka33572ec2010-05-31 14:43:30 -03001225 {
Gerd Hoffmann75721502010-10-07 12:22:54 +02001226 .name = "set_password",
1227 .args_type = "protocol:s,password:s,connected:s?",
1228 .params = "protocol password action-if-connected",
1229 .help = "set spice/vnc password",
1230 .user_print = monitor_user_noop,
1231 .mhandler.cmd_new = set_password,
1232 },
1233
1234STEXI
1235@item set_password [ vnc | spice ] password [ action-if-connected ]
1236@findex set_password
1237
1238Change spice/vnc password. Use zero to make the password stay valid
1239forever. @var{action-if-connected} specifies what should happen in
1240case a connection is established: @var{fail} makes the password change
1241fail. @var{disconnect} changes the password and disconnects the
1242client. @var{keep} changes the password and keeps the connection up.
1243@var{keep} is the default.
1244ETEXI
1245
1246 {
1247 .name = "expire_password",
1248 .args_type = "protocol:s,time:s",
1249 .params = "protocol time",
1250 .help = "set spice/vnc password expire-time",
1251 .user_print = monitor_user_noop,
1252 .mhandler.cmd_new = expire_password,
1253 },
1254
1255STEXI
1256@item expire_password [ vnc | spice ] expire-time
1257@findex expire_password
1258
1259Specify when a password for spice/vnc becomes
1260invalid. @var{expire-time} accepts:
1261
1262@table @var
1263@item now
1264Invalidate password instantly.
1265
1266@item never
1267Password stays valid forever.
1268
1269@item +nsec
1270Password stays valid for @var{nsec} seconds starting now.
1271
1272@item nsec
1273Password is invalidated at the given time. @var{nsec} are the seconds
1274passed since 1970, i.e. unix epoch.
1275
1276@end table
1277ETEXI
1278
1279 {
Jan Kiszka33572ec2010-05-31 14:43:30 -03001280 .name = "info",
1281 .args_type = "item:s?",
1282 .params = "[subcommand]",
1283 .help = "show various information about the system state",
Luiz Capitulino1162daa2010-09-13 12:15:26 -03001284 .mhandler.cmd = do_info,
Jan Kiszka33572ec2010-05-31 14:43:30 -03001285 },
1286
1287STEXI
1288@item info @var{subcommand}
1289@findex info
1290Show various information about the system state.
1291
1292@table @option
1293@item info version
1294show the version of QEMU
Jan Kiszka33572ec2010-05-31 14:43:30 -03001295@item info network
1296show the various VLANs and the associated devices
1297@item info chardev
1298show the character devices
1299@item info block
1300show the block devices
1301@item info blockstats
1302show block device statistics
1303@item info registers
1304show the cpu registers
1305@item info cpus
1306show infos for each CPU
1307@item info history
1308show the command line history
1309@item info irq
1310show the interrupts statistics (if available)
1311@item info pic
1312show i8259 (PIC) state
1313@item info pci
1314show emulated PCI device info
1315@item info tlb
Scott Woodbebabbc2011-08-18 10:38:42 +00001316show virtual to physical memory mappings (i386, SH4, SPARC, and PPC only)
Jan Kiszka33572ec2010-05-31 14:43:30 -03001317@item info mem
1318show the active virtual memory mappings (i386 only)
Jan Kiszka33572ec2010-05-31 14:43:30 -03001319@item info jit
1320show dynamic compiler info
Jan Kiszka33572ec2010-05-31 14:43:30 -03001321@item info numa
1322show NUMA information
Jan Kiszkab40292e2010-05-31 14:43:31 -03001323@item info kvm
1324show KVM information
Jan Kiszka33572ec2010-05-31 14:43:30 -03001325@item info usb
1326show USB devices plugged on the virtual USB hub
1327@item info usbhost
1328show all USB host devices
1329@item info profile
1330show profiling information
1331@item info capture
1332show information about active capturing
1333@item info snapshots
1334show list of VM snapshots
1335@item info status
1336show the current VM status (running|paused)
1337@item info pcmcia
1338show guest PCMCIA status
1339@item info mice
1340show which guest mouse is receiving events
1341@item info vnc
1342show the vnc server status
1343@item info name
1344show the current VM name
1345@item info uuid
1346show the current VM UUID
1347@item info cpustats
1348show CPU statistics
1349@item info usernet
1350show user network stack connection states
1351@item info migrate
1352show migration status
1353@item info balloon
1354show balloon information
1355@item info qtree
1356show device tree
1357@item info qdm
1358show qdev device model list
1359@item info roms
1360show roms
1361@end table
1362ETEXI
1363
Lluís6d8a7642011-08-31 20:30:43 +02001364#ifdef CONFIG_TRACE_SIMPLE
Prerna Saxena22890ab2010-06-24 17:04:53 +05301365STEXI
1366@item info trace
1367show contents of trace buffer
Lluís31965ae2011-08-31 20:31:24 +02001368ETEXI
1369#endif
1370
1371STEXI
Prerna Saxena22890ab2010-06-24 17:04:53 +05301372@item info trace-events
1373show available trace events and their state
1374ETEXI
Prerna Saxena22890ab2010-06-24 17:04:53 +05301375
Blue Swirl23130862009-06-06 08:22:04 +00001376STEXI
1377@end table
1378ETEXI