blob: 4355a6f1e4c18bca7c6cbd69205997c34e8e4811 [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 Capitulino6cdedb02011-11-27 22:54:09 -0200774 .mhandler.cmd = hmp_migrate_cancel,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300775 },
776
Blue Swirl23130862009-06-06 08:22:04 +0000777STEXI
778@item migrate_cancel
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100779@findex migrate_cancel
Blue Swirl23130862009-06-06 08:22:04 +0000780Cancel the current VM migration.
781ETEXI
782
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300783 {
784 .name = "migrate_set_speed",
Jes Sorensened3d4a82010-10-21 17:15:48 +0200785 .args_type = "value:o",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300786 .params = "value",
Jes Sorensened3d4a82010-10-21 17:15:48 +0200787 .help = "set maximum speed (in bytes) for migrations. "
788 "Defaults to MB if no size suffix is specified, ie. B/K/M/G/T",
Luiz Capitulino3dc85382011-11-28 11:59:37 -0200789 .mhandler.cmd = hmp_migrate_set_speed,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300790 },
791
Blue Swirl23130862009-06-06 08:22:04 +0000792STEXI
793@item migrate_set_speed @var{value}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100794@findex migrate_set_speed
Blue Swirl23130862009-06-06 08:22:04 +0000795Set maximum speed to @var{value} (in bytes) for migrations.
796ETEXI
797
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300798 {
799 .name = "migrate_set_downtime",
Markus Armbrusterb0fbf7d2010-01-25 14:23:07 +0100800 .args_type = "value:T",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300801 .params = "value",
802 .help = "set maximum tolerated downtime (in seconds) for migrations",
Luiz Capitulino4f0a9932011-11-27 23:18:01 -0200803 .mhandler.cmd = hmp_migrate_set_downtime,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300804 },
Glauber Costa2ea42952009-05-28 15:22:58 -0400805
806STEXI
807@item migrate_set_downtime @var{second}
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100808@findex migrate_set_downtime
Glauber Costa2ea42952009-05-28 15:22:58 -0400809Set maximum tolerated downtime (in seconds) for migration.
810ETEXI
811
Jes Sorensenf8882562010-12-16 13:52:16 +0100812 {
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100813 .name = "client_migrate_info",
814 .args_type = "protocol:s,hostname:s,port:i?,tls-port:i?,cert-subject:s?",
815 .params = "protocol hostname port tls-port cert-subject",
816 .help = "send migration info to spice/vnc client",
817 .user_print = monitor_user_noop,
Yonit Halperinedc5cb12011-10-17 10:03:18 +0200818 .mhandler.cmd_async = client_migrate_info,
819 .flags = MONITOR_CMD_ASYNC,
Jes Sorensenf8882562010-12-16 13:52:16 +0100820 },
821
822STEXI
Gerd Hoffmanne866e232010-04-23 13:28:21 +0200823@item client_migrate_info @var{protocol} @var{hostname} @var{port} @var{tls-port} @var{cert-subject}
824@findex client_migrate_info
825Set the spice/vnc connection info for the migration target. The spice/vnc
826server will ask the spice/vnc client to automatically reconnect using the
827new parameters (if specified) once the vm migration finished successfully.
828ETEXI
829
830 {
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100831 .name = "snapshot_blkdev",
Jes Sorensend967b2f2011-07-11 20:01:09 +0200832 .args_type = "device:B,snapshot-file:s?,format:s?",
Jes Sorensen2ea720d2011-03-09 16:54:34 +0100833 .params = "device [new-image-file] [format]",
834 .help = "initiates a live snapshot\n\t\t\t"
835 "of device. If a new image file is specified, the\n\t\t\t"
836 "new image file will become the new root image.\n\t\t\t"
837 "If format is specified, the snapshot file will\n\t\t\t"
838 "be created in that format. Otherwise the\n\t\t\t"
839 "snapshot will be internal! (currently unsupported)",
Luiz Capitulino6106e242011-11-25 16:15:19 -0200840 .mhandler.cmd = hmp_snapshot_blkdev,
Gerd Hoffmanne866e232010-04-23 13:28:21 +0200841 },
842
843STEXI
Jes Sorensenf8882562010-12-16 13:52:16 +0100844@item snapshot_blkdev
845@findex snapshot_blkdev
846Snapshot device, using snapshot file as target if provided
847ETEXI
848
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300849 {
850 .name = "drive_add",
851 .args_type = "pci_addr:s,opts:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300852 .params = "[[<domain>:]<bus>:]<slot>\n"
853 "[file=file][,if=type][,bus=n]\n"
Stefan Hajnoczifb0490f2011-11-17 13:40:32 +0000854 "[,unit=m][,media=d][,index=i]\n"
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300855 "[,cyls=c,heads=h,secs=s[,trans=t]]\n"
Stefan Hajnoczifb0490f2011-11-17 13:40:32 +0000856 "[,snapshot=on|off][,cache=on|off]\n"
857 "[,readonly=on|off][,copy-on-read=on|off]",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300858 .help = "add drive to PCI storage controller",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300859 .mhandler.cmd = drive_hot_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300860 },
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300861
Blue Swirl23130862009-06-06 08:22:04 +0000862STEXI
863@item drive_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100864@findex drive_add
Blue Swirl23130862009-06-06 08:22:04 +0000865Add drive to PCI storage controller.
866ETEXI
867
868#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300869 {
870 .name = "pci_add",
871 .args_type = "pci_addr:s,type:s,opts:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300872 .params = "auto|[[<domain>:]<bus>:]<slot> nic|storage [[vlan=n][,macaddr=addr][,model=type]] [file=file][,if=type][,bus=nr]...",
873 .help = "hot-add PCI device",
Markus Armbruster6c6a58a2010-05-12 10:53:00 +0200874 .mhandler.cmd = pci_device_hot_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300875 },
Blue Swirl23130862009-06-06 08:22:04 +0000876#endif
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300877
Blue Swirl23130862009-06-06 08:22:04 +0000878STEXI
879@item pci_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100880@findex pci_add
Blue Swirl23130862009-06-06 08:22:04 +0000881Hot-add PCI device.
882ETEXI
883
884#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300885 {
886 .name = "pci_del",
887 .args_type = "pci_addr:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300888 .params = "[[<domain>:]<bus>:]<slot>",
889 .help = "hot remove PCI device",
Markus Armbrusterb752daf2010-05-12 10:53:01 +0200890 .mhandler.cmd = do_pci_device_hot_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300891 },
Blue Swirl23130862009-06-06 08:22:04 +0000892#endif
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300893
Blue Swirl23130862009-06-06 08:22:04 +0000894STEXI
895@item pci_del
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100896@findex pci_del
Blue Swirl23130862009-06-06 08:22:04 +0000897Hot remove PCI device.
898ETEXI
899
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300900 {
Isaku Yamahata2ae63bd2010-12-24 12:14:14 +0900901 .name = "pcie_aer_inject_error",
902 .args_type = "advisory_non_fatal:-a,correctable:-c,"
903 "id:s,error_status:s,"
904 "header0:i?,header1:i?,header2:i?,header3:i?,"
905 "prefix0:i?,prefix1:i?,prefix2:i?,prefix3:i?",
906 .params = "[-a] [-c] id "
907 "<error_status> [<tlp header> [<tlp header prefix>]]",
908 .help = "inject pcie aer error\n\t\t\t"
909 " -a for advisory non fatal error\n\t\t\t"
910 " -c for correctable error\n\t\t\t"
911 "<id> = qdev device id\n\t\t\t"
912 "<error_status> = error string or 32bit\n\t\t\t"
913 "<tlb header> = 32bit x 4\n\t\t\t"
914 "<tlb header prefix> = 32bit x 4",
915 .user_print = pcie_aer_inject_error_print,
Zhi Yong Wu1f3392b2011-11-30 12:39:47 +0800916 .mhandler.cmd_new = do_pcie_aer_inject_error,
Isaku Yamahata2ae63bd2010-12-24 12:14:14 +0900917 },
918
919STEXI
920@item pcie_aer_inject_error
921@findex pcie_aer_inject_error
922Inject PCIe AER error
923ETEXI
924
925 {
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300926 .name = "host_net_add",
927 .args_type = "device:s,opts:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300928 .params = "tap|user|socket|vde|dump [options]",
929 .help = "add host VLAN client",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300930 .mhandler.cmd = net_host_device_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300931 },
932
Blue Swirl23130862009-06-06 08:22:04 +0000933STEXI
934@item host_net_add
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100935@findex host_net_add
Blue Swirl23130862009-06-06 08:22:04 +0000936Add host VLAN client.
937ETEXI
938
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300939 {
940 .name = "host_net_remove",
941 .args_type = "vlan_id:i,device:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300942 .params = "vlan_id name",
943 .help = "remove host VLAN client",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300944 .mhandler.cmd = net_host_device_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300945 },
946
Blue Swirl23130862009-06-06 08:22:04 +0000947STEXI
948@item host_net_remove
Stefan Weil70fcbbe2010-02-05 23:52:04 +0100949@findex host_net_remove
Blue Swirl23130862009-06-06 08:22:04 +0000950Remove host VLAN client.
951ETEXI
952
Markus Armbrusterae82d322010-03-25 17:22:40 +0100953 {
954 .name = "netdev_add",
955 .args_type = "netdev:O",
956 .params = "[user|tap|socket],id=str[,prop=value][,...]",
957 .help = "add host network device",
958 .user_print = monitor_user_noop,
959 .mhandler.cmd_new = do_netdev_add,
960 },
961
962STEXI
963@item netdev_add
964@findex netdev_add
965Add host network device.
966ETEXI
967
968 {
969 .name = "netdev_del",
970 .args_type = "id:s",
971 .params = "id",
972 .help = "remove host network device",
973 .user_print = monitor_user_noop,
974 .mhandler.cmd_new = do_netdev_del,
975 },
976
977STEXI
978@item netdev_del
979@findex netdev_del
980Remove host network device.
981ETEXI
982
Blue Swirl23130862009-06-06 08:22:04 +0000983#ifdef CONFIG_SLIRP
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300984 {
985 .name = "hostfwd_add",
986 .args_type = "arg1:s,arg2:s?,arg3:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300987 .params = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport",
988 .help = "redirect TCP or UDP connections from host to guest (requires -net user)",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -0300989 .mhandler.cmd = net_slirp_hostfwd_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300990 },
Markus Armbruster21413d62010-05-04 13:20:30 +0200991#endif
992STEXI
993@item hostfwd_add
994@findex hostfwd_add
995Redirect TCP or UDP connections from host to guest (requires -net user).
996ETEXI
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300997
Markus Armbruster21413d62010-05-04 13:20:30 +0200998#ifdef CONFIG_SLIRP
Luiz Capitulinod7f9b682009-10-07 13:41:50 -0300999 {
1000 .name = "hostfwd_remove",
1001 .args_type = "arg1:s,arg2:s?,arg3:s?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001002 .params = "[vlan_id name] [tcp|udp]:[hostaddr]:hostport",
1003 .help = "remove host-to-guest TCP or UDP redirection",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001004 .mhandler.cmd = net_slirp_hostfwd_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001005 },
1006
Blue Swirl23130862009-06-06 08:22:04 +00001007#endif
1008STEXI
Markus Armbruster21413d62010-05-04 13:20:30 +02001009@item hostfwd_remove
1010@findex hostfwd_remove
1011Remove host-to-guest TCP or UDP redirection.
Blue Swirl23130862009-06-06 08:22:04 +00001012ETEXI
1013
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001014 {
1015 .name = "balloon",
Luiz Capitulino3b0bd6e2009-12-18 13:25:05 -02001016 .args_type = "value:M",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001017 .params = "target",
Riccardo Magliocchetti3c056132010-05-19 18:49:28 +02001018 .help = "request VM to change its memory allocation (in MB)",
Luiz Capitulinod72f3262011-11-25 14:38:09 -02001019 .mhandler.cmd = hmp_balloon,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001020 },
1021
Blue Swirl23130862009-06-06 08:22:04 +00001022STEXI
1023@item balloon @var{value}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001024@findex balloon
Blue Swirl23130862009-06-06 08:22:04 +00001025Request VM to change its memory allocation to @var{value} (in MB).
1026ETEXI
1027
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001028 {
1029 .name = "set_link",
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001030 .args_type = "name:s,up:b",
1031 .params = "name on|off",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001032 .help = "change the link status of a network adapter",
Luiz Capitulino4b371562011-11-23 13:11:55 -02001033 .mhandler.cmd = hmp_set_link,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001034 },
1035
Blue Swirl23130862009-06-06 08:22:04 +00001036STEXI
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001037@item set_link @var{name} [on|off]
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001038@findex set_link
Markus Armbrusterc9b26a42010-03-26 09:07:10 +01001039Switch link @var{name} on (i.e. up) or off (i.e. down).
Blue Swirl23130862009-06-06 08:22:04 +00001040ETEXI
1041
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001042 {
1043 .name = "watchdog_action",
1044 .args_type = "action:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001045 .params = "[reset|shutdown|poweroff|pause|debug|none]",
1046 .help = "change watchdog action",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001047 .mhandler.cmd = do_watchdog_action,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001048 },
1049
Blue Swirl23130862009-06-06 08:22:04 +00001050STEXI
1051@item watchdog_action
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001052@findex watchdog_action
Blue Swirl23130862009-06-06 08:22:04 +00001053Change watchdog action.
1054ETEXI
1055
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001056 {
1057 .name = "acl_show",
1058 .args_type = "aclname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001059 .params = "aclname",
1060 .help = "list rules in the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001061 .mhandler.cmd = do_acl_show,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001062 },
1063
Blue Swirl23130862009-06-06 08:22:04 +00001064STEXI
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001065@item acl_show @var{aclname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001066@findex acl_show
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001067List all the matching rules in the access control list, and the default
1068policy. There are currently two named access control lists,
1069@var{vnc.x509dname} and @var{vnc.username} matching on the x509 client
1070certificate distinguished name, and SASL username respectively.
1071ETEXI
Blue Swirl23130862009-06-06 08:22:04 +00001072
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001073 {
1074 .name = "acl_policy",
1075 .args_type = "aclname:s,policy:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001076 .params = "aclname allow|deny",
1077 .help = "set default access control list policy",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001078 .mhandler.cmd = do_acl_policy,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001079 },
1080
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001081STEXI
Jan Kiszkacbbfacc2009-07-03 08:46:05 +02001082@item acl_policy @var{aclname} @code{allow|deny}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001083@findex acl_policy
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001084Set the default access control list policy, used in the event that
Blue Swirl23130862009-06-06 08:22:04 +00001085none of the explicit rules match. The default policy at startup is
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001086always @code{deny}.
1087ETEXI
1088
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001089 {
1090 .name = "acl_add",
1091 .args_type = "aclname:s,match:s,policy:s,index:i?",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001092 .params = "aclname match allow|deny [index]",
1093 .help = "add a match rule to the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001094 .mhandler.cmd = do_acl_add,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001095 },
1096
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001097STEXI
Markus Armbruster0e4aec92010-05-04 13:20:31 +02001098@item acl_add @var{aclname} @var{match} @code{allow|deny} [@var{index}]
1099@findex acl_add
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001100Add a match rule to the access control list, allowing or denying access.
1101The match will normally be an exact username or x509 distinguished name,
1102but can optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to
1103allow all users in the @code{EXAMPLE.COM} kerberos realm. The match will
Blue Swirl23130862009-06-06 08:22:04 +00001104normally be appended to the end of the ACL, but can be inserted
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001105earlier in the list if the optional @var{index} parameter is supplied.
1106ETEXI
1107
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001108 {
1109 .name = "acl_remove",
1110 .args_type = "aclname:s,match:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001111 .params = "aclname match",
1112 .help = "remove a match rule from the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001113 .mhandler.cmd = do_acl_remove,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001114 },
1115
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001116STEXI
1117@item acl_remove @var{aclname} @var{match}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001118@findex acl_remove
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001119Remove the specified match rule from the access control list.
1120ETEXI
1121
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001122 {
1123 .name = "acl_reset",
1124 .args_type = "aclname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001125 .params = "aclname",
1126 .help = "reset the access control list",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001127 .mhandler.cmd = do_acl_reset,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001128 },
1129
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001130STEXI
Markus Armbruster0e4aec92010-05-04 13:20:31 +02001131@item acl_reset @var{aclname}
1132@findex acl_reset
Jan Kiszka15dfcd42009-06-25 08:22:08 +02001133Remove all matches from the access control list, and set the default
Blue Swirl23130862009-06-06 08:22:04 +00001134policy back to @code{deny}.
Blue Swirl23130862009-06-06 08:22:04 +00001135ETEXI
1136
Huang Ying79c4f6b2009-06-23 10:05:14 +08001137#if defined(TARGET_I386)
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001138
1139 {
1140 .name = "mce",
Jin Dongming31ce5e02010-12-10 17:21:02 +09001141 .args_type = "broadcast:-b,cpu_index:i,bank:i,status:l,mcg_status:l,addr:l,misc:l",
1142 .params = "[-b] cpu bank status mcgstatus addr misc",
1143 .help = "inject a MCE on the given CPU [and broadcast to other CPUs with -b option]",
Luiz Capitulinoaf4ce882009-10-07 13:41:52 -03001144 .mhandler.cmd = do_inject_mce,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001145 },
1146
Huang Ying79c4f6b2009-06-23 10:05:14 +08001147#endif
1148STEXI
1149@item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001150@findex mce (x86)
Huang Ying79c4f6b2009-06-23 10:05:14 +08001151Inject an MCE on the given CPU (x86 only).
1152ETEXI
1153
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001154 {
1155 .name = "getfd",
1156 .args_type = "fdname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001157 .params = "getfd name",
1158 .help = "receive a file descriptor via SCM rights and assign it a name",
Luiz Capitulinof0d60002009-10-16 12:23:50 -03001159 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -02001160 .mhandler.cmd_new = do_getfd,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001161 },
1162
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001163STEXI
1164@item getfd @var{fdname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001165@findex getfd
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001166If a file descriptor is passed alongside this command using the SCM_RIGHTS
1167mechanism on unix sockets, it is stored using the name @var{fdname} for
1168later use by other monitor commands.
1169ETEXI
1170
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001171 {
1172 .name = "closefd",
1173 .args_type = "fdname:s",
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001174 .params = "closefd name",
1175 .help = "close a file descriptor previously passed via SCM rights",
Luiz Capitulino18f3a512009-10-16 12:23:51 -03001176 .user_print = monitor_user_noop,
Luiz Capitulino261394d2010-02-10 23:50:02 -02001177 .mhandler.cmd_new = do_closefd,
Luiz Capitulinod7f9b682009-10-07 13:41:50 -03001178 },
1179
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001180STEXI
1181@item closefd @var{fdname}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001182@findex closefd
Mark McLoughlinf07918f2009-07-22 09:11:40 +01001183Close the file descriptor previously assigned to @var{fdname} using the
1184@code{getfd} command. This is only needed if the file descriptor was never
1185used by another monitor command.
1186ETEXI
1187
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001188 {
1189 .name = "block_passwd",
1190 .args_type = "device:B,password:s",
1191 .params = "block_passwd device password",
1192 .help = "set the password of encrypted block devices",
Luiz Capitulinoa4dea8a2011-11-23 13:28:21 -02001193 .mhandler.cmd = hmp_block_passwd,
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001194 },
1195
1196STEXI
Zhi Yong Wu727f0052011-11-08 13:00:31 +08001197@item block_set_io_throttle @var{device} @var{bps} @var{bps_rd} @var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
1198@findex block_set_io_throttle
1199Change 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}
1200ETEXI
1201
1202 {
1203 .name = "block_set_io_throttle",
1204 .args_type = "device:B,bps:l,bps_rd:l,bps_wr:l,iops:l,iops_rd:l,iops_wr:l",
1205 .params = "device bps bps_rd bps_wr iops iops_rd iops_wr",
1206 .help = "change I/O throttle limits for a block drive",
1207 .user_print = monitor_user_noop,
1208 .mhandler.cmd_new = do_block_set_io_throttle,
1209 },
1210
1211STEXI
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001212@item block_passwd @var{device} @var{password}
Stefan Weil70fcbbe2010-02-05 23:52:04 +01001213@findex block_passwd
Luiz Capitulinoa3a55a22009-12-04 15:24:09 -02001214Set the encrypted device @var{device} password to @var{password}
1215ETEXI
Jan Kiszkab40292e2010-05-31 14:43:31 -03001216
Jan Kiszka33572ec2010-05-31 14:43:30 -03001217 {
Gerd Hoffmann75721502010-10-07 12:22:54 +02001218 .name = "set_password",
1219 .args_type = "protocol:s,password:s,connected:s?",
1220 .params = "protocol password action-if-connected",
1221 .help = "set spice/vnc password",
Luiz Capitulinofbf796f2011-12-07 11:17:51 -02001222 .mhandler.cmd = hmp_set_password,
Gerd Hoffmann75721502010-10-07 12:22:54 +02001223 },
1224
1225STEXI
1226@item set_password [ vnc | spice ] password [ action-if-connected ]
1227@findex set_password
1228
1229Change spice/vnc password. Use zero to make the password stay valid
1230forever. @var{action-if-connected} specifies what should happen in
1231case a connection is established: @var{fail} makes the password change
1232fail. @var{disconnect} changes the password and disconnects the
1233client. @var{keep} changes the password and keeps the connection up.
1234@var{keep} is the default.
1235ETEXI
1236
1237 {
1238 .name = "expire_password",
1239 .args_type = "protocol:s,time:s",
1240 .params = "protocol time",
1241 .help = "set spice/vnc password expire-time",
1242 .user_print = monitor_user_noop,
1243 .mhandler.cmd_new = expire_password,
1244 },
1245
1246STEXI
1247@item expire_password [ vnc | spice ] expire-time
1248@findex expire_password
1249
1250Specify when a password for spice/vnc becomes
1251invalid. @var{expire-time} accepts:
1252
1253@table @var
1254@item now
1255Invalidate password instantly.
1256
1257@item never
1258Password stays valid forever.
1259
1260@item +nsec
1261Password stays valid for @var{nsec} seconds starting now.
1262
1263@item nsec
1264Password is invalidated at the given time. @var{nsec} are the seconds
1265passed since 1970, i.e. unix epoch.
1266
1267@end table
1268ETEXI
1269
1270 {
Jan Kiszka33572ec2010-05-31 14:43:30 -03001271 .name = "info",
1272 .args_type = "item:s?",
1273 .params = "[subcommand]",
1274 .help = "show various information about the system state",
Luiz Capitulino1162daa2010-09-13 12:15:26 -03001275 .mhandler.cmd = do_info,
Jan Kiszka33572ec2010-05-31 14:43:30 -03001276 },
1277
1278STEXI
1279@item info @var{subcommand}
1280@findex info
1281Show various information about the system state.
1282
1283@table @option
1284@item info version
1285show the version of QEMU
Jan Kiszka33572ec2010-05-31 14:43:30 -03001286@item info network
1287show the various VLANs and the associated devices
1288@item info chardev
1289show the character devices
1290@item info block
1291show the block devices
1292@item info blockstats
1293show block device statistics
1294@item info registers
1295show the cpu registers
1296@item info cpus
1297show infos for each CPU
1298@item info history
1299show the command line history
1300@item info irq
1301show the interrupts statistics (if available)
1302@item info pic
1303show i8259 (PIC) state
1304@item info pci
1305show emulated PCI device info
1306@item info tlb
Scott Woodbebabbc2011-08-18 10:38:42 +00001307show virtual to physical memory mappings (i386, SH4, SPARC, and PPC only)
Jan Kiszka33572ec2010-05-31 14:43:30 -03001308@item info mem
1309show the active virtual memory mappings (i386 only)
Jan Kiszka33572ec2010-05-31 14:43:30 -03001310@item info jit
1311show dynamic compiler info
Jan Kiszka33572ec2010-05-31 14:43:30 -03001312@item info numa
1313show NUMA information
Jan Kiszkab40292e2010-05-31 14:43:31 -03001314@item info kvm
1315show KVM information
Jan Kiszka33572ec2010-05-31 14:43:30 -03001316@item info usb
1317show USB devices plugged on the virtual USB hub
1318@item info usbhost
1319show all USB host devices
1320@item info profile
1321show profiling information
1322@item info capture
1323show information about active capturing
1324@item info snapshots
1325show list of VM snapshots
1326@item info status
1327show the current VM status (running|paused)
1328@item info pcmcia
1329show guest PCMCIA status
1330@item info mice
1331show which guest mouse is receiving events
1332@item info vnc
1333show the vnc server status
1334@item info name
1335show the current VM name
1336@item info uuid
1337show the current VM UUID
1338@item info cpustats
1339show CPU statistics
1340@item info usernet
1341show user network stack connection states
1342@item info migrate
1343show migration status
1344@item info balloon
1345show balloon information
1346@item info qtree
1347show device tree
1348@item info qdm
1349show qdev device model list
1350@item info roms
1351show roms
1352@end table
1353ETEXI
1354
Lluís6d8a7642011-08-31 20:30:43 +02001355#ifdef CONFIG_TRACE_SIMPLE
Prerna Saxena22890ab2010-06-24 17:04:53 +05301356STEXI
1357@item info trace
1358show contents of trace buffer
Lluís31965ae2011-08-31 20:31:24 +02001359ETEXI
1360#endif
1361
1362STEXI
Prerna Saxena22890ab2010-06-24 17:04:53 +05301363@item info trace-events
1364show available trace events and their state
1365ETEXI
Prerna Saxena22890ab2010-06-24 17:04:53 +05301366
Blue Swirl23130862009-06-06 08:22:04 +00001367STEXI
1368@end table
1369ETEXI