blob: 131b21cd1c51cfadd6f646e8a7c2682b2f13eb0a [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",
Luiz Capitulino5e7caac2011-11-25 14:57:10 -020060 .mhandler.cmd = hmp_block_resize,
Christoph Hellwig6d4a2b32011-01-24 13:32:33 +010061 },
62
63STEXI
64@item block_resize
65@findex block_resize
66Resize a block image while a guest is running. Usually requires guest
67action to see the updated size. Resize to a lower size is supported,
68but should be used with extreme caution. Note that this command only
69resizes image files, it can not resize block devices like LVM volumes.
70ETEXI
71
72
73 {
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030074 .name = "eject",
Luiz Capitulino78d714e2009-12-14 18:53:21 -020075 .args_type = "force:-f,device:B",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030076 .params = "[-f] device",
77 .help = "eject a removable medium (use -f to force it)",
Luiz Capitulinoe1c923a2009-10-16 12:23:49 -030078 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -020079 .mhandler.cmd_new = do_eject,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030080 },
81
Blue Swirl23130862009-06-06 08:22:04 +000082STEXI
83@item eject [-f] @var{device}
Stefan Weil70fcbbe2010-02-05 23:52:04 +010084@findex eject
Blue Swirl23130862009-06-06 08:22:04 +000085Eject a removable medium (use -f to force it).
86ETEXI
87
Luiz Capitulinod7f9b682009-10-07 13:41:50 -030088 {
Ryan Harper9063f812010-11-12 11:07:13 -060089 .name = "drive_del",
90 .args_type = "id:s",
91 .params = "device",
92 .help = "remove host block device",
93 .user_print = monitor_user_noop,
94 .mhandler.cmd_new = do_drive_del,
95 },
96
97STEXI
98@item drive_del @var{device}
99@findex drive_del
100Remove host block device. The result is that guest generated IO is no longer
101submitted against the host device underlying the disk. Once a drive has
102been deleted, the QEMU Block layer returns -EIO which results in IO
103errors in the guest for applications that are reading/writing to the device.
104ETEXI
105
106 {
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300107 .name = "change",
108 .args_type = "device:B,target:F,arg:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300109 .params = "device filename [format]",
110 .help = "change a removable medium, optional format",
Markus Armbrusterec3b82a2009-12-07 21:37:09 +0100111 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200112 .mhandler.cmd_new = do_change,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300113 },
114
Blue Swirl23130862009-06-06 08:22:04 +0000115STEXI
116@item change @var{device} @var{setting}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100117@findex change
Blue Swirl23130862009-06-06 08:22:04 +0000118
119Change the configuration of a device.
120
121@table @option
122@item change @var{diskdevice} @var{filename} [@var{format}]
123Change the medium for a removable disk device to point to @var{filename}. eg
124
125@example
126(qemu) change ide1-cd0 /path/to/some.iso
127@end example
128
129@var{format} is optional.
130
131@item change vnc @var{display},@var{options}
132Change the configuration of the VNC server. The valid syntax for @var{display}
133and @var{options} are described at @ref{sec_invocation}. eg
134
135@example
136(qemu) change vnc localhost:1
137@end example
138
139@item change vnc password [@var{password}]
140
141Change the password associated with the VNC server. If the new password is not
142supplied, the monitor will prompt for it to be entered. VNC passwords are only
143significant up to 8 letters. eg
144
145@example
146(qemu) change vnc password
147Password: ********
148@end example
149
150@end table
151ETEXI
152
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300153 {
154 .name = "screendump",
155 .args_type = "filename:F",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300156 .params = "filename",
157 .help = "save screen into PPM image 'filename'",
Luiz Capitulinof1dc58e2010-03-31 15:21:49 -0300158 .user_print = monitor_user_noop,
159 .mhandler.cmd_new = do_screen_dump,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300160 },
161
Blue Swirl23130862009-06-06 08:22:04 +0000162STEXI
163@item screendump @var{filename}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100164@findex screendump
Blue Swirl23130862009-06-06 08:22:04 +0000165Save screen into PPM image @var{filename}.
166ETEXI
167
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300168 {
169 .name = "logfile",
170 .args_type = "filename:F",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300171 .params = "filename",
172 .help = "output logs to 'filename'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300173 .mhandler.cmd = do_logfile,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300174 },
175
Blue Swirl23130862009-06-06 08:22:04 +0000176STEXI
177@item logfile @var{filename}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100178@findex logfile
Blue Swirl23130862009-06-06 08:22:04 +0000179Output logs to @var{filename}.
180ETEXI
181
Prerna Saxena22890ab2010-06-24 17:04:53 +0530182 {
183 .name = "trace-event",
184 .args_type = "name:s,option:b",
185 .params = "name on|off",
186 .help = "changes status of a specific trace event",
Lluísfc764102011-08-31 20:31:18 +0200187 .mhandler.cmd = do_trace_event_set_state,
Prerna Saxena22890ab2010-06-24 17:04:53 +0530188 },
189
190STEXI
191@item trace-event
192@findex trace-event
193changes status of a trace event
194ETEXI
Stefan Hajnoczic5ceb522010-07-13 09:26:33 +0100195
Michael Rothc45a8162011-10-02 08:44:37 -0500196#if defined(CONFIG_TRACE_SIMPLE)
Stefan Hajnoczic5ceb522010-07-13 09:26:33 +0100197 {
198 .name = "trace-file",
199 .args_type = "op:s?,arg:F?",
200 .params = "on|off|flush|set [arg]",
201 .help = "open, close, or flush trace file, or set a new file name",
202 .mhandler.cmd = do_trace_file,
203 },
204
205STEXI
206@item trace-file on|off|flush
207@findex trace-file
208Open, close, or flush the trace file. If no argument is given, the status of the trace file is displayed.
209ETEXI
Prerna Saxena22890ab2010-06-24 17:04:53 +0530210#endif
211
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300212 {
213 .name = "log",
214 .args_type = "items:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300215 .params = "item1[,...]",
216 .help = "activate logging of the specified items to '/tmp/qemu.log'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300217 .mhandler.cmd = do_log,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300218 },
219
Blue Swirl23130862009-06-06 08:22:04 +0000220STEXI
221@item log @var{item1}[,...]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100222@findex log
Blue Swirl23130862009-06-06 08:22:04 +0000223Activate logging of the specified items to @file{/tmp/qemu.log}.
224ETEXI
225
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300226 {
227 .name = "savevm",
228 .args_type = "name:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300229 .params = "[tag|id]",
230 .help = "save a VM snapshot. If no tag or id are provided, a new snapshot is created",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300231 .mhandler.cmd = do_savevm,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300232 },
233
Blue Swirl23130862009-06-06 08:22:04 +0000234STEXI
235@item savevm [@var{tag}|@var{id}]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100236@findex savevm
Blue Swirl23130862009-06-06 08:22:04 +0000237Create a snapshot of the whole virtual machine. If @var{tag} is
238provided, it is used as human readable identifier. If there is already
239a snapshot with the same tag or ID, it is replaced. More info at
240@ref{vm_snapshots}.
241ETEXI
242
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300243 {
244 .name = "loadvm",
245 .args_type = "name:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300246 .params = "tag|id",
247 .help = "restore a VM snapshot from its tag or id",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300248 .mhandler.cmd = do_loadvm,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300249 },
250
Blue Swirl23130862009-06-06 08:22:04 +0000251STEXI
252@item loadvm @var{tag}|@var{id}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100253@findex loadvm
Blue Swirl23130862009-06-06 08:22:04 +0000254Set the whole virtual machine to the snapshot identified by the tag
255@var{tag} or the unique snapshot ID @var{id}.
256ETEXI
257
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300258 {
259 .name = "delvm",
260 .args_type = "name:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300261 .params = "tag|id",
262 .help = "delete a VM snapshot from its tag or id",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300263 .mhandler.cmd = do_delvm,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300264 },
265
Blue Swirl23130862009-06-06 08:22:04 +0000266STEXI
267@item delvm @var{tag}|@var{id}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100268@findex delvm
Blue Swirl23130862009-06-06 08:22:04 +0000269Delete the snapshot identified by @var{tag} or @var{id}.
270ETEXI
271
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300272 {
273 .name = "singlestep",
274 .args_type = "option:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300275 .params = "[on|off]",
276 .help = "run emulation in singlestep mode or switch to normal mode",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300277 .mhandler.cmd = do_singlestep,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300278 },
279
Blue Swirl23130862009-06-06 08:22:04 +0000280STEXI
281@item singlestep [off]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100282@findex singlestep
Blue Swirl23130862009-06-06 08:22:04 +0000283Run the emulation in single step mode.
284If called with option off, the emulation returns to normal mode.
285ETEXI
286
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300287 {
288 .name = "stop",
289 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300290 .params = "",
291 .help = "stop emulation",
Luiz Capitulino5f158f22011-09-15 14:34:39 -0300292 .mhandler.cmd = hmp_stop,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300293 },
294
Blue Swirl23130862009-06-06 08:22:04 +0000295STEXI
296@item stop
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100297@findex stop
Blue Swirl23130862009-06-06 08:22:04 +0000298Stop emulation.
299ETEXI
300
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300301 {
302 .name = "c|cont",
303 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300304 .params = "",
305 .help = "resume emulation",
Luiz Capitulinoe42e8182011-11-22 17:58:31 -0200306 .mhandler.cmd = hmp_cont,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300307 },
308
Blue Swirl23130862009-06-06 08:22:04 +0000309STEXI
310@item c or cont
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100311@findex cont
Blue Swirl23130862009-06-06 08:22:04 +0000312Resume emulation.
313ETEXI
314
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300315 {
316 .name = "gdbserver",
317 .args_type = "device:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300318 .params = "[device]",
319 .help = "start gdbserver on given device (default 'tcp::1234'), stop with 'none'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300320 .mhandler.cmd = do_gdbserver,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300321 },
322
Blue Swirl23130862009-06-06 08:22:04 +0000323STEXI
324@item gdbserver [@var{port}]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100325@findex gdbserver
Blue Swirl23130862009-06-06 08:22:04 +0000326Start gdbserver session (default @var{port}=1234)
327ETEXI
328
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300329 {
330 .name = "x",
331 .args_type = "fmt:/,addr:l",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300332 .params = "/fmt addr",
333 .help = "virtual memory dump starting at 'addr'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300334 .mhandler.cmd = do_memory_dump,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300335 },
336
Blue Swirl23130862009-06-06 08:22:04 +0000337STEXI
338@item x/fmt @var{addr}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100339@findex x
Blue Swirl23130862009-06-06 08:22:04 +0000340Virtual memory dump starting at @var{addr}.
341ETEXI
342
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300343 {
344 .name = "xp",
345 .args_type = "fmt:/,addr:l",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300346 .params = "/fmt addr",
347 .help = "physical memory dump starting at 'addr'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300348 .mhandler.cmd = do_physical_memory_dump,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300349 },
350
Blue Swirl23130862009-06-06 08:22:04 +0000351STEXI
352@item xp /@var{fmt} @var{addr}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100353@findex xp
Blue Swirl23130862009-06-06 08:22:04 +0000354Physical memory dump starting at @var{addr}.
355
356@var{fmt} is a format which tells the command how to format the
357data. Its syntax is: @option{/@{count@}@{format@}@{size@}}
358
359@table @var
360@item count
361is the number of items to be dumped.
362
363@item format
364can be x (hex), d (signed decimal), u (unsigned decimal), o (octal),
365c (char) or i (asm instruction).
366
367@item size
368can be b (8 bits), h (16 bits), w (32 bits) or g (64 bits). On x86,
369@code{h} or @code{w} can be specified with the @code{i} format to
370respectively select 16 or 32 bit code instruction size.
371
372@end table
373
374Examples:
375@itemize
376@item
377Dump 10 instructions at the current instruction pointer:
378@example
379(qemu) x/10i $eip
3800x90107063: ret
3810x90107064: sti
3820x90107065: lea 0x0(%esi,1),%esi
3830x90107069: lea 0x0(%edi,1),%edi
3840x90107070: ret
3850x90107071: jmp 0x90107080
3860x90107073: nop
3870x90107074: nop
3880x90107075: nop
3890x90107076: nop
390@end example
391
392@item
393Dump 80 16 bit values at the start of the video memory.
394@smallexample
395(qemu) xp/80hx 0xb8000
3960x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42
3970x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41
3980x000b8020: 0x0b42 0x0b69 0x0b6f 0x0b73 0x0b20 0x0b63 0x0b75 0x0b72
3990x000b8030: 0x0b72 0x0b65 0x0b6e 0x0b74 0x0b2d 0x0b63 0x0b76 0x0b73
4000x000b8040: 0x0b20 0x0b30 0x0b35 0x0b20 0x0b4e 0x0b6f 0x0b76 0x0b20
4010x000b8050: 0x0b32 0x0b30 0x0b30 0x0b33 0x0720 0x0720 0x0720 0x0720
4020x000b8060: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
4030x000b8070: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
4040x000b8080: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
4050x000b8090: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
406@end smallexample
407@end itemize
408ETEXI
409
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300410 {
411 .name = "p|print",
412 .args_type = "fmt:/,val:l",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300413 .params = "/fmt expr",
414 .help = "print expression value (use $reg for CPU register access)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300415 .mhandler.cmd = do_print,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300416 },
417
Blue Swirl23130862009-06-06 08:22:04 +0000418STEXI
419@item p or print/@var{fmt} @var{expr}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100420@findex print
Blue Swirl23130862009-06-06 08:22:04 +0000421
422Print expression value. Only the @var{format} part of @var{fmt} is
423used.
424ETEXI
425
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300426 {
427 .name = "i",
428 .args_type = "fmt:/,addr:i,index:i.",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300429 .params = "/fmt addr",
430 .help = "I/O port read",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300431 .mhandler.cmd = do_ioport_read,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300432 },
433
Blue Swirl23130862009-06-06 08:22:04 +0000434STEXI
435Read I/O port.
436ETEXI
437
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300438 {
439 .name = "o",
440 .args_type = "fmt:/,addr:i,val:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300441 .params = "/fmt addr value",
442 .help = "I/O port write",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300443 .mhandler.cmd = do_ioport_write,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300444 },
445
Jan Kiszkaf1147842009-07-14 10:20:11 +0200446STEXI
447Write to I/O port.
448ETEXI
Blue Swirl23130862009-06-06 08:22:04 +0000449
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300450 {
451 .name = "sendkey",
452 .args_type = "string:s,hold_time:i?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300453 .params = "keys [hold_ms]",
454 .help = "send keys to the VM (e.g. 'sendkey ctrl-alt-f1', default hold time=100 ms)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300455 .mhandler.cmd = do_sendkey,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300456 },
457
Blue Swirl23130862009-06-06 08:22:04 +0000458STEXI
459@item sendkey @var{keys}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100460@findex sendkey
Blue Swirl23130862009-06-06 08:22:04 +0000461
462Send @var{keys} to the emulator. @var{keys} could be the name of the
463key or @code{#} followed by the raw value in either decimal or hexadecimal
464format. Use @code{-} to press several keys simultaneously. Example:
465@example
466sendkey ctrl-alt-f1
467@end example
468
469This command is useful to send keys that your graphical user interface
470intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
471ETEXI
472
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300473 {
474 .name = "system_reset",
475 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300476 .params = "",
477 .help = "reset the system",
Luiz Capitulino38d22652011-09-15 14:41:46 -0300478 .mhandler.cmd = hmp_system_reset,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300479 },
480
Blue Swirl23130862009-06-06 08:22:04 +0000481STEXI
482@item system_reset
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100483@findex system_reset
Blue Swirl23130862009-06-06 08:22:04 +0000484
485Reset the system.
486ETEXI
487
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300488 {
489 .name = "system_powerdown",
490 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300491 .params = "",
492 .help = "send system power down event",
Luiz Capitulino5bc465e2011-09-28 11:06:15 -0300493 .mhandler.cmd = hmp_system_powerdown,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300494 },
495
Blue Swirl23130862009-06-06 08:22:04 +0000496STEXI
497@item system_powerdown
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100498@findex system_powerdown
Blue Swirl23130862009-06-06 08:22:04 +0000499
500Power down the system (if supported).
501ETEXI
502
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300503 {
504 .name = "sum",
505 .args_type = "start:i,size:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300506 .params = "addr size",
507 .help = "compute the checksum of a memory region",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300508 .mhandler.cmd = do_sum,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300509 },
510
Blue Swirl23130862009-06-06 08:22:04 +0000511STEXI
512@item sum @var{addr} @var{size}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100513@findex sum
Blue Swirl23130862009-06-06 08:22:04 +0000514
515Compute the checksum of a memory region.
516ETEXI
517
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300518 {
519 .name = "usb_add",
520 .args_type = "devname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300521 .params = "device",
522 .help = "add USB device (e.g. 'host:bus.addr' or 'host:vendor_id:product_id')",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300523 .mhandler.cmd = do_usb_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300524 },
525
Blue Swirl23130862009-06-06 08:22:04 +0000526STEXI
527@item usb_add @var{devname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100528@findex usb_add
Blue Swirl23130862009-06-06 08:22:04 +0000529
530Add the USB device @var{devname}. For details of available devices see
531@ref{usb_devices}
532ETEXI
533
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300534 {
535 .name = "usb_del",
536 .args_type = "devname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300537 .params = "device",
538 .help = "remove USB device 'bus.addr'",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300539 .mhandler.cmd = do_usb_del,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300540 },
541
Blue Swirl23130862009-06-06 08:22:04 +0000542STEXI
543@item usb_del @var{devname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100544@findex usb_del
Blue Swirl23130862009-06-06 08:22:04 +0000545
546Remove the USB device @var{devname} from the QEMU virtual USB
547hub. @var{devname} has the syntax @code{bus.addr}. Use the monitor
548command @code{info usb} to see the devices you can remove.
549ETEXI
550
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300551 {
552 .name = "device_add",
Markus Armbrusterc7e4e8c2010-02-10 20:47:28 +0100553 .args_type = "device:O",
554 .params = "driver[,prop=value][,...]",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300555 .help = "add device, like -device on the command line",
Markus Armbruster8bc27242010-02-10 20:52:01 +0100556 .user_print = monitor_user_noop,
557 .mhandler.cmd_new = do_device_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300558 },
559
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200560STEXI
561@item device_add @var{config}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100562@findex device_add
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200563
564Add device.
565ETEXI
566
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300567 {
568 .name = "device_del",
569 .args_type = "id:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300570 .params = "device",
571 .help = "remove device",
Markus Armbruster17a38ea2010-03-22 11:38:14 +0100572 .user_print = monitor_user_noop,
573 .mhandler.cmd_new = do_device_del,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300574 },
575
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200576STEXI
577@item device_del @var{id}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100578@findex device_del
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200579
580Remove device @var{id}.
581ETEXI
582
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300583 {
584 .name = "cpu",
585 .args_type = "index:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300586 .params = "index",
587 .help = "set the default CPU",
Luiz Capitulino755f1962011-10-06 14:31:39 -0300588 .mhandler.cmd = hmp_cpu,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300589 },
Gerd Hoffmann3418bd22009-09-25 21:42:41 +0200590
Blue Swirl23130862009-06-06 08:22:04 +0000591STEXI
Markus Armbrusterc427ea92010-05-04 13:20:32 +0200592@item cpu @var{index}
593@findex cpu
Blue Swirl23130862009-06-06 08:22:04 +0000594Set the default CPU.
595ETEXI
596
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300597 {
598 .name = "mouse_move",
599 .args_type = "dx_str:s,dy_str:s,dz_str:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300600 .params = "dx dy [dz]",
601 .help = "send mouse move events",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300602 .mhandler.cmd = do_mouse_move,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300603 },
604
Blue Swirl23130862009-06-06 08:22:04 +0000605STEXI
606@item mouse_move @var{dx} @var{dy} [@var{dz}]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100607@findex mouse_move
Blue Swirl23130862009-06-06 08:22:04 +0000608Move the active mouse to the specified coordinates @var{dx} @var{dy}
609with optional scroll axis @var{dz}.
610ETEXI
611
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300612 {
613 .name = "mouse_button",
614 .args_type = "button_state:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300615 .params = "state",
616 .help = "change mouse button state (1=L, 2=M, 4=R)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300617 .mhandler.cmd = do_mouse_button,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300618 },
619
Blue Swirl23130862009-06-06 08:22:04 +0000620STEXI
621@item mouse_button @var{val}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100622@findex mouse_button
Blue Swirl23130862009-06-06 08:22:04 +0000623Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
624ETEXI
625
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300626 {
627 .name = "mouse_set",
628 .args_type = "index:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300629 .params = "index",
630 .help = "set which mouse device receives events",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300631 .mhandler.cmd = do_mouse_set,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300632 },
633
Blue Swirl23130862009-06-06 08:22:04 +0000634STEXI
635@item mouse_set @var{index}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100636@findex mouse_set
Blue Swirl23130862009-06-06 08:22:04 +0000637Set which mouse device receives events at given @var{index}, index
638can be obtained with
639@example
640info mice
641@end example
642ETEXI
643
644#ifdef HAS_AUDIO
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300645 {
646 .name = "wavcapture",
647 .args_type = "path:F,freq:i?,bits:i?,nchannels:i?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300648 .params = "path [frequency [bits [channels]]]",
649 .help = "capture audio to a wave file (default frequency=44100 bits=16 channels=2)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300650 .mhandler.cmd = do_wav_capture,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300651 },
Blue Swirl23130862009-06-06 08:22:04 +0000652#endif
653STEXI
654@item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100655@findex wavcapture
Blue Swirl23130862009-06-06 08:22:04 +0000656Capture audio into @var{filename}. Using sample rate @var{frequency}
657bits per sample @var{bits} and number of channels @var{channels}.
658
659Defaults:
660@itemize @minus
661@item Sample rate = 44100 Hz - CD quality
662@item Bits = 16
663@item Number of channels = 2 - Stereo
664@end itemize
665ETEXI
666
667#ifdef HAS_AUDIO
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300668 {
669 .name = "stopcapture",
670 .args_type = "n:i",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300671 .params = "capture index",
672 .help = "stop capture",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300673 .mhandler.cmd = do_stop_capture,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300674 },
Blue Swirl23130862009-06-06 08:22:04 +0000675#endif
676STEXI
677@item stopcapture @var{index}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100678@findex stopcapture
Blue Swirl23130862009-06-06 08:22:04 +0000679Stop capture with a given @var{index}, index can be obtained with
680@example
681info capture
682@end example
683ETEXI
684
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300685 {
686 .name = "memsave",
687 .args_type = "val:l,size:i,filename:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300688 .params = "addr size file",
689 .help = "save to disk virtual memory dump starting at 'addr' of size 'size'",
Luiz Capitulino0cfd6a92011-11-22 16:32:37 -0200690 .mhandler.cmd = hmp_memsave,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300691 },
692
Blue Swirl23130862009-06-06 08:22:04 +0000693STEXI
694@item memsave @var{addr} @var{size} @var{file}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100695@findex memsave
Blue Swirl23130862009-06-06 08:22:04 +0000696save to disk virtual memory dump starting at @var{addr} of size @var{size}.
697ETEXI
698
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300699 {
700 .name = "pmemsave",
701 .args_type = "val:l,size:i,filename:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300702 .params = "addr size file",
703 .help = "save to disk physical memory dump starting at 'addr' of size 'size'",
Luiz Capitulino6d3962b2011-11-22 17:26:46 -0200704 .mhandler.cmd = hmp_pmemsave,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300705 },
706
Blue Swirl23130862009-06-06 08:22:04 +0000707STEXI
708@item pmemsave @var{addr} @var{size} @var{file}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100709@findex pmemsave
Blue Swirl23130862009-06-06 08:22:04 +0000710save to disk physical memory dump starting at @var{addr} of size @var{size}.
711ETEXI
712
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300713 {
714 .name = "boot_set",
715 .args_type = "bootdevice:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300716 .params = "bootdevice",
717 .help = "define new values for the boot device list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300718 .mhandler.cmd = do_boot_set,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300719 },
720
Blue Swirl23130862009-06-06 08:22:04 +0000721STEXI
722@item boot_set @var{bootdevicelist}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100723@findex boot_set
Blue Swirl23130862009-06-06 08:22:04 +0000724
725Define new values for the boot device list. Those values will override
726the values specified on the command line through the @code{-boot} option.
727
728The values that can be specified here depend on the machine type, but are
729the same that can be specified in the @code{-boot} command line option.
730ETEXI
731
732#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300733 {
734 .name = "nmi",
Luiz Capitulinoe9b4b432011-04-29 12:11:50 -0300735 .args_type = "",
736 .params = "",
737 .help = "inject an NMI on all guest's CPUs",
Luiz Capitulinoab49ab52011-11-23 12:55:53 -0200738 .mhandler.cmd = hmp_inject_nmi,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300739 },
Blue Swirl23130862009-06-06 08:22:04 +0000740#endif
741STEXI
742@item nmi @var{cpu}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100743@findex nmi
Blue Swirl23130862009-06-06 08:22:04 +0000744Inject an NMI on the given CPU (x86 only).
745ETEXI
746
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300747 {
748 .name = "migrate",
lirans@il.ibm.comfbc3d962009-11-02 15:41:13 +0200749 .args_type = "detach:-d,blk:-b,inc:-i,uri:s",
750 .params = "[-d] [-b] [-i] uri",
751 .help = "migrate to URI (using -d to not wait for completion)"
752 "\n\t\t\t -b for migration without shared storage with"
753 " full copy of disk\n\t\t\t -i for migration without "
754 "shared storage with incremental copy of disk "
755 "(base image shared between src and destination)",
756 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200757 .mhandler.cmd_new = do_migrate,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300758 },
759
lirans@il.ibm.comfbc3d962009-11-02 15:41:13 +0200760
Blue Swirl23130862009-06-06 08:22:04 +0000761STEXI
lirans@il.ibm.comfbc3d962009-11-02 15:41:13 +0200762@item migrate [-d] [-b] [-i] @var{uri}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100763@findex migrate
Blue Swirl23130862009-06-06 08:22:04 +0000764Migrate to @var{uri} (using -d to not wait for completion).
lirans@il.ibm.comfbc3d962009-11-02 15:41:13 +0200765 -b for migration with full copy of disk
766 -i for migration with incremental copy of disk (base image is shared)
Blue Swirl23130862009-06-06 08:22:04 +0000767ETEXI
768
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300769 {
770 .name = "migrate_cancel",
771 .args_type = "",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300772 .params = "",
773 .help = "cancel the current VM migration",
Luiz Capitulino911d2962009-10-16 12:23:47 -0300774 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200775 .mhandler.cmd_new = do_migrate_cancel,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300776 },
777
Blue Swirl23130862009-06-06 08:22:04 +0000778STEXI
779@item migrate_cancel
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100780@findex migrate_cancel
Blue Swirl23130862009-06-06 08:22:04 +0000781Cancel the current VM migration.
782ETEXI
783
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300784 {
785 .name = "migrate_set_speed",
Jes Sorensened3d4a82010-10-21 17:15:48 +0200786 .args_type = "value:o",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300787 .params = "value",
Jes Sorensened3d4a82010-10-21 17:15:48 +0200788 .help = "set maximum speed (in bytes) for migrations. "
789 "Defaults to MB if no size suffix is specified, ie. B/K/M/G/T",
Markus Armbruster5fd90832010-01-25 14:23:05 +0100790 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200791 .mhandler.cmd_new = do_migrate_set_speed,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300792 },
793
Blue Swirl23130862009-06-06 08:22:04 +0000794STEXI
795@item migrate_set_speed @var{value}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100796@findex migrate_set_speed
Blue Swirl23130862009-06-06 08:22:04 +0000797Set maximum speed to @var{value} (in bytes) for migrations.
798ETEXI
799
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300800 {
801 .name = "migrate_set_downtime",
Markus Armbrusterb0fbf7d2010-01-25 14:23:07 +0100802 .args_type = "value:T",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300803 .params = "value",
804 .help = "set maximum tolerated downtime (in seconds) for migrations",
Markus Armbrusterc6027f52010-01-25 14:23:08 +0100805 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -0200806 .mhandler.cmd_new = do_migrate_set_downtime,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300807 },
Glauber Costa2ea42952009-05-28 15:22:58 -0400808
809STEXI
810@item migrate_set_downtime @var{second}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100811@findex migrate_set_downtime
Glauber Costa2ea42952009-05-28 15:22:58 -0400812Set maximum tolerated downtime (in seconds) for migration.
813ETEXI
814
Jes Sorensenf8882562010-12-16 13:52:16 +0100815 {
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100816 .name = "client_migrate_info",
817 .args_type = "protocol:s,hostname:s,port:i?,tls-port:i?,cert-subject:s?",
818 .params = "protocol hostname port tls-port cert-subject",
819 .help = "send migration info to spice/vnc client",
820 .user_print = monitor_user_noop,
Yonit Halperinedc5cb12011-10-17 10:03:18 +0200821 .mhandler.cmd_async = client_migrate_info,
822 .flags = MONITOR_CMD_ASYNC,
Jes Sorensenf8882562010-12-16 13:52:16 +0100823 },
824
825STEXI
Gerd Hoffmanne866e232010-04-23 13:28:21 +0200826@item client_migrate_info @var{protocol} @var{hostname} @var{port} @var{tls-port} @var{cert-subject}
827@findex client_migrate_info
828Set the spice/vnc connection info for the migration target. The spice/vnc
829server will ask the spice/vnc client to automatically reconnect using the
830new parameters (if specified) once the vm migration finished successfully.
831ETEXI
832
833 {
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100834 .name = "snapshot_blkdev",
Jes Sorensend967b2f2011-07-11 20:01:09 +0200835 .args_type = "device:B,snapshot-file:s?,format:s?",
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100836 .params = "device [new-image-file] [format]",
837 .help = "initiates a live snapshot\n\t\t\t"
838 "of device. If a new image file is specified, the\n\t\t\t"
839 "new image file will become the new root image.\n\t\t\t"
840 "If format is specified, the snapshot file will\n\t\t\t"
841 "be created in that format. Otherwise the\n\t\t\t"
842 "snapshot will be internal! (currently unsupported)",
Luiz Capitulino6106e242011-11-25 16:15:19 -0200843 .mhandler.cmd = hmp_snapshot_blkdev,
Gerd Hoffmanne866e232010-04-23 13:28:21 +0200844 },
845
846STEXI
Jes Sorensenf8882562010-12-16 13:52:16 +0100847@item snapshot_blkdev
848@findex snapshot_blkdev
849Snapshot device, using snapshot file as target if provided
850ETEXI
851
Blue Swirl23130862009-06-06 08:22:04 +0000852#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300853 {
854 .name = "drive_add",
855 .args_type = "pci_addr:s,opts:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300856 .params = "[[<domain>:]<bus>:]<slot>\n"
857 "[file=file][,if=type][,bus=n]\n"
Stefan Hajnoczifb0490f2011-11-17 13:40:32 +0000858 "[,unit=m][,media=d][,index=i]\n"
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300859 "[,cyls=c,heads=h,secs=s[,trans=t]]\n"
Stefan Hajnoczifb0490f2011-11-17 13:40:32 +0000860 "[,snapshot=on|off][,cache=on|off]\n"
861 "[,readonly=on|off][,copy-on-read=on|off]",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300862 .help = "add drive to PCI storage controller",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300863 .mhandler.cmd = drive_hot_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300864 },
Blue Swirl23130862009-06-06 08:22:04 +0000865#endif
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300866
Blue Swirl23130862009-06-06 08:22:04 +0000867STEXI
868@item drive_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100869@findex drive_add
Blue Swirl23130862009-06-06 08:22:04 +0000870Add drive to PCI storage controller.
871ETEXI
872
873#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300874 {
875 .name = "pci_add",
876 .args_type = "pci_addr:s,type:s,opts:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300877 .params = "auto|[[<domain>:]<bus>:]<slot> nic|storage [[vlan=n][,macaddr=addr][,model=type]] [file=file][,if=type][,bus=nr]...",
878 .help = "hot-add PCI device",
Markus Armbruster6c6a58a2010-05-12 10:53:00 +0200879 .mhandler.cmd = pci_device_hot_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300880 },
Blue Swirl23130862009-06-06 08:22:04 +0000881#endif
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300882
Blue Swirl23130862009-06-06 08:22:04 +0000883STEXI
884@item pci_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100885@findex pci_add
Blue Swirl23130862009-06-06 08:22:04 +0000886Hot-add PCI device.
887ETEXI
888
889#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300890 {
891 .name = "pci_del",
892 .args_type = "pci_addr:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300893 .params = "[[<domain>:]<bus>:]<slot>",
894 .help = "hot remove PCI device",
Markus Armbrusterb752daf2010-05-12 10:53:01 +0200895 .mhandler.cmd = do_pci_device_hot_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300896 },
Blue Swirl23130862009-06-06 08:22:04 +0000897#endif
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300898
Blue Swirl23130862009-06-06 08:22:04 +0000899STEXI
900@item pci_del
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100901@findex pci_del
Blue Swirl23130862009-06-06 08:22:04 +0000902Hot remove PCI device.
903ETEXI
904
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300905 {
Isaku Yamahata2ae63bd2010-12-24 12:14:14 +0900906 .name = "pcie_aer_inject_error",
907 .args_type = "advisory_non_fatal:-a,correctable:-c,"
908 "id:s,error_status:s,"
909 "header0:i?,header1:i?,header2:i?,header3:i?,"
910 "prefix0:i?,prefix1:i?,prefix2:i?,prefix3:i?",
911 .params = "[-a] [-c] id "
912 "<error_status> [<tlp header> [<tlp header prefix>]]",
913 .help = "inject pcie aer error\n\t\t\t"
914 " -a for advisory non fatal error\n\t\t\t"
915 " -c for correctable error\n\t\t\t"
916 "<id> = qdev device id\n\t\t\t"
917 "<error_status> = error string or 32bit\n\t\t\t"
918 "<tlb header> = 32bit x 4\n\t\t\t"
919 "<tlb header prefix> = 32bit x 4",
920 .user_print = pcie_aer_inject_error_print,
921 .mhandler.cmd_new = do_pcie_aer_inejct_error,
922 },
923
924STEXI
925@item pcie_aer_inject_error
926@findex pcie_aer_inject_error
927Inject PCIe AER error
928ETEXI
929
930 {
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300931 .name = "host_net_add",
932 .args_type = "device:s,opts:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300933 .params = "tap|user|socket|vde|dump [options]",
934 .help = "add host VLAN client",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300935 .mhandler.cmd = net_host_device_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300936 },
937
Blue Swirl23130862009-06-06 08:22:04 +0000938STEXI
939@item host_net_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100940@findex host_net_add
Blue Swirl23130862009-06-06 08:22:04 +0000941Add host VLAN client.
942ETEXI
943
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300944 {
945 .name = "host_net_remove",
946 .args_type = "vlan_id:i,device:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300947 .params = "vlan_id name",
948 .help = "remove host VLAN client",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300949 .mhandler.cmd = net_host_device_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300950 },
951
Blue Swirl23130862009-06-06 08:22:04 +0000952STEXI
953@item host_net_remove
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100954@findex host_net_remove
Blue Swirl23130862009-06-06 08:22:04 +0000955Remove host VLAN client.
956ETEXI
957
Markus Armbrusterae82d322010-03-25 17:22:40 +0100958 {
959 .name = "netdev_add",
960 .args_type = "netdev:O",
961 .params = "[user|tap|socket],id=str[,prop=value][,...]",
962 .help = "add host network device",
963 .user_print = monitor_user_noop,
964 .mhandler.cmd_new = do_netdev_add,
965 },
966
967STEXI
968@item netdev_add
969@findex netdev_add
970Add host network device.
971ETEXI
972
973 {
974 .name = "netdev_del",
975 .args_type = "id:s",
976 .params = "id",
977 .help = "remove host network device",
978 .user_print = monitor_user_noop,
979 .mhandler.cmd_new = do_netdev_del,
980 },
981
982STEXI
983@item netdev_del
984@findex netdev_del
985Remove host network device.
986ETEXI
987
Blue Swirl23130862009-06-06 08:22:04 +0000988#ifdef CONFIG_SLIRP
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300989 {
990 .name = "hostfwd_add",
991 .args_type = "arg1:s,arg2:s?,arg3:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300992 .params = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport",
993 .help = "redirect TCP or UDP connections from host to guest (requires -net user)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300994 .mhandler.cmd = net_slirp_hostfwd_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300995 },
Markus Armbruster21413d62010-05-04 13:20:30 +0200996#endif
997STEXI
998@item hostfwd_add
999@findex hostfwd_add
1000Redirect TCP or UDP connections from host to guest (requires -net user).
1001ETEXI
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001002
Markus Armbruster21413d62010-05-04 13:20:30 +02001003#ifdef CONFIG_SLIRP
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001004 {
1005 .name = "hostfwd_remove",
1006 .args_type = "arg1:s,arg2:s?,arg3:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001007 .params = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport",
1008 .help = "remove host-to-guest TCP or UDP redirection",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001009 .mhandler.cmd = net_slirp_hostfwd_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001010 },
1011
Blue Swirl23130862009-06-06 08:22:04 +00001012#endif
1013STEXI
Markus Armbruster21413d62010-05-04 13:20:30 +02001014@item hostfwd_remove
1015@findex hostfwd_remove
1016Remove host-to-guest TCP or UDP redirection.
Blue Swirl23130862009-06-06 08:22:04 +00001017ETEXI
1018
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001019 {
1020 .name = "balloon",
Luiz Capitulino3b0bd6e2009-12-18 13:25:05 -02001021 .args_type = "value:M",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001022 .params = "target",
Riccardo Magliocchetti3c056132010-05-19 18:49:28 +02001023 .help = "request VM to change its memory allocation (in MB)",
Luiz Capitulinod72f3262011-11-25 14:38:09 -02001024 .mhandler.cmd = hmp_balloon,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001025 },
1026
Blue Swirl23130862009-06-06 08:22:04 +00001027STEXI
1028@item balloon @var{value}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001029@findex balloon
Blue Swirl23130862009-06-06 08:22:04 +00001030Request VM to change its memory allocation to @var{value} (in MB).
1031ETEXI
1032
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001033 {
1034 .name = "set_link",
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001035 .args_type = "name:s,up:b",
1036 .params = "name on|off",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001037 .help = "change the link status of a network adapter",
Luiz Capitulino4b371562011-11-23 13:11:55 -02001038 .mhandler.cmd = hmp_set_link,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001039 },
1040
Blue Swirl23130862009-06-06 08:22:04 +00001041STEXI
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001042@item set_link @var{name} [on|off]
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001043@findex set_link
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001044Switch link @var{name} on (i.e. up) or off (i.e. down).
Blue Swirl23130862009-06-06 08:22:04 +00001045ETEXI
1046
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001047 {
1048 .name = "watchdog_action",
1049 .args_type = "action:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001050 .params = "[reset|shutdown|poweroff|pause|debug|none]",
1051 .help = "change watchdog action",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001052 .mhandler.cmd = do_watchdog_action,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001053 },
1054
Blue Swirl23130862009-06-06 08:22:04 +00001055STEXI
1056@item watchdog_action
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001057@findex watchdog_action
Blue Swirl23130862009-06-06 08:22:04 +00001058Change watchdog action.
1059ETEXI
1060
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001061 {
1062 .name = "acl_show",
1063 .args_type = "aclname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001064 .params = "aclname",
1065 .help = "list rules in the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001066 .mhandler.cmd = do_acl_show,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001067 },
1068
Blue Swirl23130862009-06-06 08:22:04 +00001069STEXI
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001070@item acl_show @var{aclname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001071@findex acl_show
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001072List all the matching rules in the access control list, and the default
1073policy. There are currently two named access control lists,
1074@var{vnc.x509dname} and @var{vnc.username} matching on the x509 client
1075certificate distinguished name, and SASL username respectively.
1076ETEXI
Blue Swirl23130862009-06-06 08:22:04 +00001077
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001078 {
1079 .name = "acl_policy",
1080 .args_type = "aclname:s,policy:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001081 .params = "aclname allow|deny",
1082 .help = "set default access control list policy",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001083 .mhandler.cmd = do_acl_policy,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001084 },
1085
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001086STEXI
Jan Kiszkacbbfacc2009-07-03 08:46:05 +02001087@item acl_policy @var{aclname} @code{allow|deny}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001088@findex acl_policy
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001089Set the default access control list policy, used in the event that
Blue Swirl23130862009-06-06 08:22:04 +00001090none of the explicit rules match. The default policy at startup is
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001091always @code{deny}.
1092ETEXI
1093
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001094 {
1095 .name = "acl_add",
1096 .args_type = "aclname:s,match:s,policy:s,index:i?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001097 .params = "aclname match allow|deny [index]",
1098 .help = "add a match rule to the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001099 .mhandler.cmd = do_acl_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001100 },
1101
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001102STEXI
Markus Armbruster0e4aec92010-05-04 13:20:31 +02001103@item acl_add @var{aclname} @var{match} @code{allow|deny} [@var{index}]
1104@findex acl_add
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001105Add a match rule to the access control list, allowing or denying access.
1106The match will normally be an exact username or x509 distinguished name,
1107but can optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to
1108allow all users in the @code{EXAMPLE.COM} kerberos realm. The match will
Blue Swirl23130862009-06-06 08:22:04 +00001109normally be appended to the end of the ACL, but can be inserted
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001110earlier in the list if the optional @var{index} parameter is supplied.
1111ETEXI
1112
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001113 {
1114 .name = "acl_remove",
1115 .args_type = "aclname:s,match:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001116 .params = "aclname match",
1117 .help = "remove a match rule from the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001118 .mhandler.cmd = do_acl_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001119 },
1120
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001121STEXI
1122@item acl_remove @var{aclname} @var{match}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001123@findex acl_remove
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001124Remove the specified match rule from the access control list.
1125ETEXI
1126
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001127 {
1128 .name = "acl_reset",
1129 .args_type = "aclname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001130 .params = "aclname",
1131 .help = "reset the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001132 .mhandler.cmd = do_acl_reset,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001133 },
1134
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001135STEXI
Markus Armbruster0e4aec92010-05-04 13:20:31 +02001136@item acl_reset @var{aclname}
1137@findex acl_reset
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001138Remove all matches from the access control list, and set the default
Blue Swirl23130862009-06-06 08:22:04 +00001139policy back to @code{deny}.
Blue Swirl23130862009-06-06 08:22:04 +00001140ETEXI
1141
Huang Ying79c4f6b2009-06-23 10:05:14 +08001142#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001143
1144 {
1145 .name = "mce",
Jin Dongming31ce5e02010-12-10 17:21:02 +09001146 .args_type = "broadcast:-b,cpu_index:i,bank:i,status:l,mcg_status:l,addr:l,misc:l",
1147 .params = "[-b] cpu bank status mcgstatus addr misc",
1148 .help = "inject a MCE on the given CPU [and broadcast to other CPUs with -b option]",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001149 .mhandler.cmd = do_inject_mce,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001150 },
1151
Huang Ying79c4f6b2009-06-23 10:05:14 +08001152#endif
1153STEXI
1154@item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001155@findex mce (x86)
Huang Ying79c4f6b2009-06-23 10:05:14 +08001156Inject an MCE on the given CPU (x86 only).
1157ETEXI
1158
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001159 {
1160 .name = "getfd",
1161 .args_type = "fdname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001162 .params = "getfd name",
1163 .help = "receive a file descriptor via SCM rights and assign it a name",
Luiz Capitulinof0d60002009-10-16 12:23:50 -03001164 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -02001165 .mhandler.cmd_new = do_getfd,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001166 },
1167
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001168STEXI
1169@item getfd @var{fdname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001170@findex getfd
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001171If a file descriptor is passed alongside this command using the SCM_RIGHTS
1172mechanism on unix sockets, it is stored using the name @var{fdname} for
1173later use by other monitor commands.
1174ETEXI
1175
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001176 {
1177 .name = "closefd",
1178 .args_type = "fdname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001179 .params = "closefd name",
1180 .help = "close a file descriptor previously passed via SCM rights",
Luiz Capitulino18f3a512009-10-16 12:23:51 -03001181 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -02001182 .mhandler.cmd_new = do_closefd,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001183 },
1184
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001185STEXI
1186@item closefd @var{fdname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001187@findex closefd
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001188Close the file descriptor previously assigned to @var{fdname} using the
1189@code{getfd} command. This is only needed if the file descriptor was never
1190used by another monitor command.
1191ETEXI
1192
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001193 {
1194 .name = "block_passwd",
1195 .args_type = "device:B,password:s",
1196 .params = "block_passwd device password",
1197 .help = "set the password of encrypted block devices",
Luiz Capitulinoa4dea8a2011-11-23 13:28:21 -02001198 .mhandler.cmd = hmp_block_passwd,
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001199 },
1200
1201STEXI
Zhi Yong Wu727f0052011-11-08 13:00:31 +08001202@item block_set_io_throttle @var{device} @var{bps} @var{bps_rd} @var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
1203@findex block_set_io_throttle
1204Change 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}
1205ETEXI
1206
1207 {
1208 .name = "block_set_io_throttle",
1209 .args_type = "device:B,bps:l,bps_rd:l,bps_wr:l,iops:l,iops_rd:l,iops_wr:l",
1210 .params = "device bps bps_rd bps_wr iops iops_rd iops_wr",
1211 .help = "change I/O throttle limits for a block drive",
1212 .user_print = monitor_user_noop,
1213 .mhandler.cmd_new = do_block_set_io_throttle,
1214 },
1215
1216STEXI
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001217@item block_passwd @var{device} @var{password}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001218@findex block_passwd
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001219Set the encrypted device @var{device} password to @var{password}
1220ETEXI
Jan Kiszkab40292e2010-05-31 14:43:31 -03001221
Jan Kiszka33572ec2010-05-31 14:43:30 -03001222 {
Gerd Hoffmann75721502010-10-07 12:22:54 +02001223 .name = "set_password",
1224 .args_type = "protocol:s,password:s,connected:s?",
1225 .params = "protocol password action-if-connected",
1226 .help = "set spice/vnc password",
1227 .user_print = monitor_user_noop,
1228 .mhandler.cmd_new = set_password,
1229 },
1230
1231STEXI
1232@item set_password [ vnc | spice ] password [ action-if-connected ]
1233@findex set_password
1234
1235Change spice/vnc password. Use zero to make the password stay valid
1236forever. @var{action-if-connected} specifies what should happen in
1237case a connection is established: @var{fail} makes the password change
1238fail. @var{disconnect} changes the password and disconnects the
1239client. @var{keep} changes the password and keeps the connection up.
1240@var{keep} is the default.
1241ETEXI
1242
1243 {
1244 .name = "expire_password",
1245 .args_type = "protocol:s,time:s",
1246 .params = "protocol time",
1247 .help = "set spice/vnc password expire-time",
1248 .user_print = monitor_user_noop,
1249 .mhandler.cmd_new = expire_password,
1250 },
1251
1252STEXI
1253@item expire_password [ vnc | spice ] expire-time
1254@findex expire_password
1255
1256Specify when a password for spice/vnc becomes
1257invalid. @var{expire-time} accepts:
1258
1259@table @var
1260@item now
1261Invalidate password instantly.
1262
1263@item never
1264Password stays valid forever.
1265
1266@item +nsec
1267Password stays valid for @var{nsec} seconds starting now.
1268
1269@item nsec
1270Password is invalidated at the given time. @var{nsec} are the seconds
1271passed since 1970, i.e. unix epoch.
1272
1273@end table
1274ETEXI
1275
1276 {
Jan Kiszka33572ec2010-05-31 14:43:30 -03001277 .name = "info",
1278 .args_type = "item:s?",
1279 .params = "[subcommand]",
1280 .help = "show various information about the system state",
Luiz Capitulino1162daa2010-09-13 12:15:26 -03001281 .mhandler.cmd = do_info,
Jan Kiszka33572ec2010-05-31 14:43:30 -03001282 },
1283
1284STEXI
1285@item info @var{subcommand}
1286@findex info
1287Show various information about the system state.
1288
1289@table @option
1290@item info version
1291show the version of QEMU
Jan Kiszka33572ec2010-05-31 14:43:30 -03001292@item info network
1293show the various VLANs and the associated devices
1294@item info chardev
1295show the character devices
1296@item info block
1297show the block devices
1298@item info blockstats
1299show block device statistics
1300@item info registers
1301show the cpu registers
1302@item info cpus
1303show infos for each CPU
1304@item info history
1305show the command line history
1306@item info irq
1307show the interrupts statistics (if available)
1308@item info pic
1309show i8259 (PIC) state
1310@item info pci
1311show emulated PCI device info
1312@item info tlb
Scott Woodbebabbc2011-08-18 10:38:42 +00001313show virtual to physical memory mappings (i386, SH4, SPARC, and PPC only)
Jan Kiszka33572ec2010-05-31 14:43:30 -03001314@item info mem
1315show the active virtual memory mappings (i386 only)
Jan Kiszka33572ec2010-05-31 14:43:30 -03001316@item info jit
1317show dynamic compiler info
Jan Kiszka33572ec2010-05-31 14:43:30 -03001318@item info numa
1319show NUMA information
Jan Kiszkab40292e2010-05-31 14:43:31 -03001320@item info kvm
1321show KVM information
Jan Kiszka33572ec2010-05-31 14:43:30 -03001322@item info usb
1323show USB devices plugged on the virtual USB hub
1324@item info usbhost
1325show all USB host devices
1326@item info profile
1327show profiling information
1328@item info capture
1329show information about active capturing
1330@item info snapshots
1331show list of VM snapshots
1332@item info status
1333show the current VM status (running|paused)
1334@item info pcmcia
1335show guest PCMCIA status
1336@item info mice
1337show which guest mouse is receiving events
1338@item info vnc
1339show the vnc server status
1340@item info name
1341show the current VM name
1342@item info uuid
1343show the current VM UUID
1344@item info cpustats
1345show CPU statistics
1346@item info usernet
1347show user network stack connection states
1348@item info migrate
1349show migration status
1350@item info balloon
1351show balloon information
1352@item info qtree
1353show device tree
1354@item info qdm
1355show qdev device model list
1356@item info roms
1357show roms
1358@end table
1359ETEXI
1360
Lluís6d8a7642011-08-31 20:30:43 +02001361#ifdef CONFIG_TRACE_SIMPLE
Prerna Saxena22890ab2010-06-24 17:04:53 +05301362STEXI
1363@item info trace
1364show contents of trace buffer
Lluís31965ae2011-08-31 20:31:24 +02001365ETEXI
1366#endif
1367
1368STEXI
Prerna Saxena22890ab2010-06-24 17:04:53 +05301369@item info trace-events
1370show available trace events and their state
1371ETEXI
Prerna Saxena22890ab2010-06-24 17:04:53 +05301372
Blue Swirl23130862009-06-06 08:22:04 +00001373STEXI
1374@end table
1375ETEXI