]> git.proxmox.com Git - mirror_qemu.git/blame - hmp-commands.hx
qemu-iotests: Filter NFS paths
[mirror_qemu.git] / hmp-commands.hx
CommitLineData
2313086a
BS
1HXCOMM 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
d7f9b689
LC
12 {
13 .name = "help|?",
129be006 14 .args_type = "name:S?",
d7f9b689
LC
15 .params = "[cmd]",
16 .help = "show the help",
2b9e3576 17 .cmd = do_help_cmd,
d7f9b689
LC
18 },
19
2313086a
BS
20STEXI
21@item help or ? [@var{cmd}]
70fcbbe7 22@findex help
2313086a
BS
23Show the help for all commands or just for command @var{cmd}.
24ETEXI
25
d7f9b689
LC
26 {
27 .name = "commit",
28 .args_type = "device:B",
d7f9b689
LC
29 .params = "device|all",
30 .help = "commit changes to the disk images (if -snapshot is used) or backing files",
2b9e3576 31 .cmd = hmp_commit,
d7f9b689
LC
32 },
33
2313086a
BS
34STEXI
35@item commit
70fcbbe7 36@findex commit
2313086a 37Commit changes to the disk images (if -snapshot is used) or backing files.
37222900
JC
38If the backing file is smaller than the snapshot, then the backing file will be
39resized to be the same size as the snapshot. If the snapshot is smaller than
40the backing file, the backing file will not be truncated. If you want the
41backing file to match the size of the smaller snapshot, you can safely truncate
42it yourself once the commit operation successfully completes.
2313086a
BS
43ETEXI
44
d7f9b689
LC
45 {
46 .name = "q|quit",
47 .args_type = "",
d7f9b689
LC
48 .params = "",
49 .help = "quit the emulator",
2b9e3576 50 .cmd = hmp_quit,
d7f9b689
LC
51 },
52
2313086a
BS
53STEXI
54@item q or quit
70fcbbe7 55@findex quit
2313086a
BS
56Quit the emulator.
57ETEXI
58
6d4a2b3a
CH
59 {
60 .name = "block_resize",
61 .args_type = "device:B,size:o",
62 .params = "device size",
63 .help = "resize a block image",
2b9e3576 64 .cmd = hmp_block_resize,
6d4a2b3a
CH
65 },
66
67STEXI
68@item block_resize
69@findex block_resize
70Resize a block image while a guest is running. Usually requires guest
71action to see the updated size. Resize to a lower size is supported,
72but should be used with extreme caution. Note that this command only
73resizes image files, it can not resize block devices like LVM volumes.
74ETEXI
75
12bd451f
SH
76 {
77 .name = "block_stream",
c83c66c3
SH
78 .args_type = "device:B,speed:o?,base:s?",
79 .params = "device [speed [base]]",
12bd451f 80 .help = "copy data from a backing file into a block device",
2b9e3576 81 .cmd = hmp_block_stream,
12bd451f
SH
82 },
83
84STEXI
85@item block_stream
86@findex block_stream
87Copy data from a backing file into a block device.
2d47c6e9
SH
88ETEXI
89
90 {
91 .name = "block_job_set_speed",
882ec7ce
SH
92 .args_type = "device:B,speed:o",
93 .params = "device speed",
2d47c6e9 94 .help = "set maximum speed for a background block operation",
2b9e3576 95 .cmd = hmp_block_job_set_speed,
2d47c6e9
SH
96 },
97
98STEXI
4451b799
PB
99@item block_job_set_speed
100@findex block_job_set_speed
2d47c6e9 101Set maximum speed for a background block operation.
370521a1
SH
102ETEXI
103
104 {
105 .name = "block_job_cancel",
6e37fb81
PB
106 .args_type = "force:-f,device:B",
107 .params = "[-f] device",
108 .help = "stop an active background block operation (use -f"
b76e4458
LL
109 "\n\t\t\t if you want to abort the operation immediately"
110 "\n\t\t\t instead of keep running until data is in sync)",
2b9e3576 111 .cmd = hmp_block_job_cancel,
370521a1
SH
112 },
113
114STEXI
115@item block_job_cancel
116@findex block_job_cancel
aeae883b
PB
117Stop an active background block operation (streaming, mirroring).
118ETEXI
119
120 {
121 .name = "block_job_complete",
122 .args_type = "device:B",
123 .params = "device",
124 .help = "stop an active background block operation",
2b9e3576 125 .cmd = hmp_block_job_complete,
aeae883b
PB
126 },
127
128STEXI
129@item block_job_complete
130@findex block_job_complete
131Manually trigger completion of an active background block operation.
132For mirroring, this will switch the device to the destination path.
6e37fb81
PB
133ETEXI
134
135 {
136 .name = "block_job_pause",
137 .args_type = "device:B",
138 .params = "device",
139 .help = "pause an active background block operation",
2b9e3576 140 .cmd = hmp_block_job_pause,
6e37fb81
PB
141 },
142
143STEXI
144@item block_job_pause
145@findex block_job_pause
146Pause an active block streaming operation.
147ETEXI
148
149 {
150 .name = "block_job_resume",
151 .args_type = "device:B",
152 .params = "device",
153 .help = "resume a paused background block operation",
2b9e3576 154 .cmd = hmp_block_job_resume,
6e37fb81
PB
155 },
156
157STEXI
158@item block_job_resume
159@findex block_job_resume
160Resume a paused block streaming operation.
12bd451f 161ETEXI
6d4a2b3a 162
d7f9b689
LC
163 {
164 .name = "eject",
78d714e0 165 .args_type = "force:-f,device:B",
d7f9b689
LC
166 .params = "[-f] device",
167 .help = "eject a removable medium (use -f to force it)",
2b9e3576 168 .cmd = hmp_eject,
d7f9b689
LC
169 },
170
2313086a
BS
171STEXI
172@item eject [-f] @var{device}
70fcbbe7 173@findex eject
2313086a 174Eject a removable medium (use -f to force it).
9063f814
RH
175ETEXI
176
177 {
178 .name = "drive_del",
f7bdc41a 179 .args_type = "id:B",
9063f814
RH
180 .params = "device",
181 .help = "remove host block device",
2b9e3576 182 .cmd = hmp_drive_del,
9063f814
RH
183 },
184
185STEXI
186@item drive_del @var{device}
187@findex drive_del
188Remove host block device. The result is that guest generated IO is no longer
189submitted against the host device underlying the disk. Once a drive has
190been deleted, the QEMU Block layer returns -EIO which results in IO
191errors in the guest for applications that are reading/writing to the device.
293c51a6
SH
192These errors are always reported to the guest, regardless of the drive's error
193actions (drive options rerror, werror).
2313086a
BS
194ETEXI
195
d7f9b689
LC
196 {
197 .name = "change",
baead0ab
HR
198 .args_type = "device:B,target:F,arg:s?,read-only-mode:s?",
199 .params = "device filename [format [read-only-mode]]",
d7f9b689 200 .help = "change a removable medium, optional format",
2b9e3576 201 .cmd = hmp_change,
d7f9b689
LC
202 },
203
2313086a
BS
204STEXI
205@item change @var{device} @var{setting}
70fcbbe7 206@findex change
2313086a
BS
207Change the configuration of a device.
208
209@table @option
baead0ab 210@item change @var{diskdevice} @var{filename} [@var{format} [@var{read-only-mode}]]
2313086a
BS
211Change the medium for a removable disk device to point to @var{filename}. eg
212
213@example
214(qemu) change ide1-cd0 /path/to/some.iso
215@end example
216
217@var{format} is optional.
218
baead0ab
HR
219@var{read-only-mode} may be used to change the read-only status of the device.
220It accepts the following values:
221
222@table @var
223@item retain
224Retains the current status; this is the default.
225
226@item read-only
227Makes the device read-only.
228
229@item read-write
230Makes the device writable.
231@end table
232
2313086a
BS
233@item change vnc @var{display},@var{options}
234Change the configuration of the VNC server. The valid syntax for @var{display}
235and @var{options} are described at @ref{sec_invocation}. eg
236
237@example
238(qemu) change vnc localhost:1
239@end example
240
241@item change vnc password [@var{password}]
242
243Change the password associated with the VNC server. If the new password is not
244supplied, the monitor will prompt for it to be entered. VNC passwords are only
245significant up to 8 letters. eg
246
247@example
248(qemu) change vnc password
249Password: ********
250@end example
251
252@end table
253ETEXI
254
d7f9b689
LC
255 {
256 .name = "screendump",
f771c544
TH
257 .args_type = "filename:F,device:s?,head:i?",
258 .params = "filename [device [head]]",
259 .help = "save screen from head 'head' of display device 'device' "
260 "into PPM image 'filename'",
2b9e3576 261 .cmd = hmp_screendump,
d7f9b689
LC
262 },
263
2313086a
BS
264STEXI
265@item screendump @var{filename}
70fcbbe7 266@findex screendump
2313086a
BS
267Save screen into PPM image @var{filename}.
268ETEXI
269
d7f9b689
LC
270 {
271 .name = "logfile",
272 .args_type = "filename:F",
d7f9b689
LC
273 .params = "filename",
274 .help = "output logs to 'filename'",
2b9e3576 275 .cmd = hmp_logfile,
d7f9b689
LC
276 },
277
2313086a
BS
278STEXI
279@item logfile @var{filename}
70fcbbe7 280@findex logfile
2313086a
BS
281Output logs to @var{filename}.
282ETEXI
283
22890ab5
PS
284 {
285 .name = "trace-event",
77e2b172
LV
286 .args_type = "name:s,option:b,vcpu:i?",
287 .params = "name on|off [vcpu]",
288 .help = "changes status of a specific trace event "
289 "(vcpu: vCPU to set, default is all)",
2b9e3576 290 .cmd = hmp_trace_event,
987bd270 291 .command_completion = trace_event_completion,
22890ab5
PS
292 },
293
294STEXI
295@item trace-event
296@findex trace-event
297changes status of a trace event
c5ceb523
SH
298ETEXI
299
c45a8168 300#if defined(CONFIG_TRACE_SIMPLE)
c5ceb523
SH
301 {
302 .name = "trace-file",
303 .args_type = "op:s?,arg:F?",
304 .params = "on|off|flush|set [arg]",
305 .help = "open, close, or flush trace file, or set a new file name",
2b9e3576 306 .cmd = hmp_trace_file,
c5ceb523
SH
307 },
308
309STEXI
310@item trace-file on|off|flush
311@findex trace-file
312Open, close, or flush the trace file. If no argument is given, the status of the trace file is displayed.
22890ab5
PS
313ETEXI
314#endif
315
d7f9b689
LC
316 {
317 .name = "log",
318 .args_type = "items:s",
d7f9b689 319 .params = "item1[,...]",
989b697d 320 .help = "activate logging of the specified items",
2b9e3576 321 .cmd = hmp_log,
d7f9b689
LC
322 },
323
2313086a
BS
324STEXI
325@item log @var{item1}[,...]
70fcbbe7 326@findex log
989b697d 327Activate logging of the specified items.
2313086a
BS
328ETEXI
329
d7f9b689
LC
330 {
331 .name = "savevm",
332 .args_type = "name:s?",
d7f9b689
LC
333 .params = "[tag|id]",
334 .help = "save a VM snapshot. If no tag or id are provided, a new snapshot is created",
2b9e3576 335 .cmd = hmp_savevm,
d7f9b689
LC
336 },
337
2313086a
BS
338STEXI
339@item savevm [@var{tag}|@var{id}]
70fcbbe7 340@findex savevm
2313086a
BS
341Create a snapshot of the whole virtual machine. If @var{tag} is
342provided, it is used as human readable identifier. If there is already
343a snapshot with the same tag or ID, it is replaced. More info at
344@ref{vm_snapshots}.
345ETEXI
346
d7f9b689
LC
347 {
348 .name = "loadvm",
349 .args_type = "name:s",
d7f9b689
LC
350 .params = "tag|id",
351 .help = "restore a VM snapshot from its tag or id",
2b9e3576 352 .cmd = hmp_loadvm,
b21631f3 353 .command_completion = loadvm_completion,
d7f9b689
LC
354 },
355
2313086a
BS
356STEXI
357@item loadvm @var{tag}|@var{id}
70fcbbe7 358@findex loadvm
2313086a
BS
359Set the whole virtual machine to the snapshot identified by the tag
360@var{tag} or the unique snapshot ID @var{id}.
361ETEXI
362
d7f9b689
LC
363 {
364 .name = "delvm",
365 .args_type = "name:s",
d7f9b689
LC
366 .params = "tag|id",
367 .help = "delete a VM snapshot from its tag or id",
2b9e3576 368 .cmd = hmp_delvm,
b21631f3 369 .command_completion = delvm_completion,
d7f9b689
LC
370 },
371
2313086a
BS
372STEXI
373@item delvm @var{tag}|@var{id}
70fcbbe7 374@findex delvm
2313086a
BS
375Delete the snapshot identified by @var{tag} or @var{id}.
376ETEXI
377
d7f9b689
LC
378 {
379 .name = "singlestep",
380 .args_type = "option:s?",
d7f9b689
LC
381 .params = "[on|off]",
382 .help = "run emulation in singlestep mode or switch to normal mode",
2b9e3576 383 .cmd = hmp_singlestep,
d7f9b689
LC
384 },
385
2313086a
BS
386STEXI
387@item singlestep [off]
70fcbbe7 388@findex singlestep
2313086a
BS
389Run the emulation in single step mode.
390If called with option off, the emulation returns to normal mode.
391ETEXI
392
d7f9b689
LC
393 {
394 .name = "stop",
395 .args_type = "",
d7f9b689
LC
396 .params = "",
397 .help = "stop emulation",
2b9e3576 398 .cmd = hmp_stop,
d7f9b689
LC
399 },
400
2313086a
BS
401STEXI
402@item stop
70fcbbe7 403@findex stop
2313086a
BS
404Stop emulation.
405ETEXI
406
d7f9b689
LC
407 {
408 .name = "c|cont",
409 .args_type = "",
d7f9b689
LC
410 .params = "",
411 .help = "resume emulation",
2b9e3576 412 .cmd = hmp_cont,
d7f9b689
LC
413 },
414
2313086a
BS
415STEXI
416@item c or cont
70fcbbe7 417@findex cont
2313086a 418Resume emulation.
9b9df25a
GH
419ETEXI
420
421 {
422 .name = "system_wakeup",
423 .args_type = "",
424 .params = "",
425 .help = "wakeup guest from suspend",
2b9e3576 426 .cmd = hmp_system_wakeup,
9b9df25a
GH
427 },
428
429STEXI
430@item system_wakeup
431@findex system_wakeup
432Wakeup guest from suspend.
2313086a
BS
433ETEXI
434
d7f9b689
LC
435 {
436 .name = "gdbserver",
437 .args_type = "device:s?",
d7f9b689
LC
438 .params = "[device]",
439 .help = "start gdbserver on given device (default 'tcp::1234'), stop with 'none'",
2b9e3576 440 .cmd = hmp_gdbserver,
d7f9b689
LC
441 },
442
2313086a
BS
443STEXI
444@item gdbserver [@var{port}]
70fcbbe7 445@findex gdbserver
2313086a
BS
446Start gdbserver session (default @var{port}=1234)
447ETEXI
448
d7f9b689
LC
449 {
450 .name = "x",
451 .args_type = "fmt:/,addr:l",
d7f9b689
LC
452 .params = "/fmt addr",
453 .help = "virtual memory dump starting at 'addr'",
2b9e3576 454 .cmd = hmp_memory_dump,
d7f9b689
LC
455 },
456
2313086a
BS
457STEXI
458@item x/fmt @var{addr}
70fcbbe7 459@findex x
2313086a
BS
460Virtual memory dump starting at @var{addr}.
461ETEXI
462
d7f9b689
LC
463 {
464 .name = "xp",
465 .args_type = "fmt:/,addr:l",
d7f9b689
LC
466 .params = "/fmt addr",
467 .help = "physical memory dump starting at 'addr'",
2b9e3576 468 .cmd = hmp_physical_memory_dump,
d7f9b689
LC
469 },
470
2313086a
BS
471STEXI
472@item xp /@var{fmt} @var{addr}
70fcbbe7 473@findex xp
2313086a
BS
474Physical memory dump starting at @var{addr}.
475
476@var{fmt} is a format which tells the command how to format the
477data. Its syntax is: @option{/@{count@}@{format@}@{size@}}
478
479@table @var
480@item count
481is the number of items to be dumped.
482
483@item format
484can be x (hex), d (signed decimal), u (unsigned decimal), o (octal),
485c (char) or i (asm instruction).
486
487@item size
488can be b (8 bits), h (16 bits), w (32 bits) or g (64 bits). On x86,
489@code{h} or @code{w} can be specified with the @code{i} format to
490respectively select 16 or 32 bit code instruction size.
491
492@end table
493
494Examples:
495@itemize
496@item
497Dump 10 instructions at the current instruction pointer:
498@example
499(qemu) x/10i $eip
5000x90107063: ret
5010x90107064: sti
5020x90107065: lea 0x0(%esi,1),%esi
5030x90107069: lea 0x0(%edi,1),%edi
5040x90107070: ret
5050x90107071: jmp 0x90107080
5060x90107073: nop
5070x90107074: nop
5080x90107075: nop
5090x90107076: nop
510@end example
511
512@item
513Dump 80 16 bit values at the start of the video memory.
514@smallexample
515(qemu) xp/80hx 0xb8000
5160x000b8000: 0x0b50 0x0b6c 0x0b65 0x0b78 0x0b38 0x0b36 0x0b2f 0x0b42
5170x000b8010: 0x0b6f 0x0b63 0x0b68 0x0b73 0x0b20 0x0b56 0x0b47 0x0b41
5180x000b8020: 0x0b42 0x0b69 0x0b6f 0x0b73 0x0b20 0x0b63 0x0b75 0x0b72
5190x000b8030: 0x0b72 0x0b65 0x0b6e 0x0b74 0x0b2d 0x0b63 0x0b76 0x0b73
5200x000b8040: 0x0b20 0x0b30 0x0b35 0x0b20 0x0b4e 0x0b6f 0x0b76 0x0b20
5210x000b8050: 0x0b32 0x0b30 0x0b30 0x0b33 0x0720 0x0720 0x0720 0x0720
5220x000b8060: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
5230x000b8070: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
5240x000b8080: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
5250x000b8090: 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720 0x0720
526@end smallexample
527@end itemize
e9628441
PB
528ETEXI
529
530 {
531 .name = "gpa2hva",
532 .args_type = "addr:l",
533 .params = "addr",
534 .help = "print the host virtual address corresponding to a guest physical address",
535 .cmd = hmp_gpa2hva,
536 },
537
538STEXI
539@item gpa2hva @var{addr}
540@findex gpa2hva
541Print the host virtual address at which the guest's physical address @var{addr}
542is mapped.
543ETEXI
544
545#ifdef CONFIG_LINUX
546 {
547 .name = "gpa2hpa",
548 .args_type = "addr:l",
549 .params = "addr",
550 .help = "print the host physical address corresponding to a guest physical address",
551 .cmd = hmp_gpa2hpa,
552 },
553#endif
554
555STEXI
556@item gpa2hpa @var{addr}
557@findex gpa2hpa
558Print the host physical address at which the guest's physical address @var{addr}
559is mapped.
2313086a
BS
560ETEXI
561
d7f9b689
LC
562 {
563 .name = "p|print",
564 .args_type = "fmt:/,val:l",
d7f9b689
LC
565 .params = "/fmt expr",
566 .help = "print expression value (use $reg for CPU register access)",
2b9e3576 567 .cmd = do_print,
d7f9b689
LC
568 },
569
2313086a
BS
570STEXI
571@item p or print/@var{fmt} @var{expr}
70fcbbe7 572@findex print
2313086a
BS
573Print expression value. Only the @var{format} part of @var{fmt} is
574used.
575ETEXI
576
d7f9b689
LC
577 {
578 .name = "i",
579 .args_type = "fmt:/,addr:i,index:i.",
d7f9b689
LC
580 .params = "/fmt addr",
581 .help = "I/O port read",
2b9e3576 582 .cmd = hmp_ioport_read,
d7f9b689
LC
583 },
584
2313086a 585STEXI
b76d799e
MA
586@item i/@var{fmt} @var{addr} [.@var{index}]
587@findex i
2313086a
BS
588Read I/O port.
589ETEXI
590
d7f9b689
LC
591 {
592 .name = "o",
593 .args_type = "fmt:/,addr:i,val:i",
d7f9b689
LC
594 .params = "/fmt addr value",
595 .help = "I/O port write",
2b9e3576 596 .cmd = hmp_ioport_write,
d7f9b689
LC
597 },
598
f114784f 599STEXI
b76d799e
MA
600@item o/@var{fmt} @var{addr} @var{val}
601@findex o
f114784f
JK
602Write to I/O port.
603ETEXI
2313086a 604
d7f9b689
LC
605 {
606 .name = "sendkey",
2ef20c15 607 .args_type = "keys:s,hold-time:i?",
d7f9b689
LC
608 .params = "keys [hold_ms]",
609 .help = "send keys to the VM (e.g. 'sendkey ctrl-alt-f1', default hold time=100 ms)",
2b9e3576 610 .cmd = hmp_sendkey,
29136cd8 611 .command_completion = sendkey_completion,
d7f9b689
LC
612 },
613
2313086a
BS
614STEXI
615@item sendkey @var{keys}
70fcbbe7 616@findex sendkey
886cc706
AK
617Send @var{keys} to the guest. @var{keys} could be the name of the
618key or the raw value in hexadecimal format. Use @code{-} to press
619several keys simultaneously. Example:
2313086a
BS
620@example
621sendkey ctrl-alt-f1
622@end example
623
624This command is useful to send keys that your graphical user interface
625intercepts at low level, such as @code{ctrl-alt-f1} in X Window.
626ETEXI
627
d7f9b689
LC
628 {
629 .name = "system_reset",
630 .args_type = "",
d7f9b689
LC
631 .params = "",
632 .help = "reset the system",
2b9e3576 633 .cmd = hmp_system_reset,
d7f9b689
LC
634 },
635
2313086a
BS
636STEXI
637@item system_reset
70fcbbe7 638@findex system_reset
2313086a
BS
639Reset the system.
640ETEXI
641
d7f9b689
LC
642 {
643 .name = "system_powerdown",
644 .args_type = "",
d7f9b689
LC
645 .params = "",
646 .help = "send system power down event",
2b9e3576 647 .cmd = hmp_system_powerdown,
d7f9b689
LC
648 },
649
2313086a
BS
650STEXI
651@item system_powerdown
70fcbbe7 652@findex system_powerdown
2313086a
BS
653Power down the system (if supported).
654ETEXI
655
d7f9b689
LC
656 {
657 .name = "sum",
658 .args_type = "start:i,size:i",
d7f9b689
LC
659 .params = "addr size",
660 .help = "compute the checksum of a memory region",
2b9e3576 661 .cmd = hmp_sum,
d7f9b689
LC
662 },
663
2313086a
BS
664STEXI
665@item sum @var{addr} @var{size}
70fcbbe7 666@findex sum
2313086a 667Compute the checksum of a memory region.
2313086a
BS
668ETEXI
669
d7f9b689
LC
670 {
671 .name = "device_add",
c7e4e8ce
MA
672 .args_type = "device:O",
673 .params = "driver[,prop=value][,...]",
d7f9b689 674 .help = "add device, like -device on the command line",
2b9e3576 675 .cmd = hmp_device_add,
2da1b3ab 676 .command_completion = device_add_completion,
d7f9b689
LC
677 },
678
3418bd25
GH
679STEXI
680@item device_add @var{config}
70fcbbe7 681@findex device_add
3418bd25
GH
682Add device.
683ETEXI
684
d7f9b689
LC
685 {
686 .name = "device_del",
687 .args_type = "id:s",
d7f9b689
LC
688 .params = "device",
689 .help = "remove device",
2b9e3576 690 .cmd = hmp_device_del,
2da1b3ab 691 .command_completion = device_del_completion,
d7f9b689
LC
692 },
693
3418bd25
GH
694STEXI
695@item device_del @var{id}
70fcbbe7 696@findex device_del
6287d827
DB
697Remove device @var{id}. @var{id} may be a short ID
698or a QOM object path.
3418bd25
GH
699ETEXI
700
d7f9b689
LC
701 {
702 .name = "cpu",
703 .args_type = "index:i",
d7f9b689
LC
704 .params = "index",
705 .help = "set the default CPU",
2b9e3576 706 .cmd = hmp_cpu,
d7f9b689 707 },
3418bd25 708
2313086a 709STEXI
c427ea9c
MA
710@item cpu @var{index}
711@findex cpu
2313086a
BS
712Set the default CPU.
713ETEXI
714
d7f9b689
LC
715 {
716 .name = "mouse_move",
717 .args_type = "dx_str:s,dy_str:s,dz_str:s?",
d7f9b689
LC
718 .params = "dx dy [dz]",
719 .help = "send mouse move events",
2b9e3576 720 .cmd = hmp_mouse_move,
d7f9b689
LC
721 },
722
2313086a
BS
723STEXI
724@item mouse_move @var{dx} @var{dy} [@var{dz}]
70fcbbe7 725@findex mouse_move
2313086a
BS
726Move the active mouse to the specified coordinates @var{dx} @var{dy}
727with optional scroll axis @var{dz}.
728ETEXI
729
d7f9b689
LC
730 {
731 .name = "mouse_button",
732 .args_type = "button_state:i",
d7f9b689
LC
733 .params = "state",
734 .help = "change mouse button state (1=L, 2=M, 4=R)",
2b9e3576 735 .cmd = hmp_mouse_button,
d7f9b689
LC
736 },
737
2313086a
BS
738STEXI
739@item mouse_button @var{val}
70fcbbe7 740@findex mouse_button
2313086a
BS
741Change the active mouse button state @var{val} (1=L, 2=M, 4=R).
742ETEXI
743
d7f9b689
LC
744 {
745 .name = "mouse_set",
746 .args_type = "index:i",
d7f9b689
LC
747 .params = "index",
748 .help = "set which mouse device receives events",
2b9e3576 749 .cmd = hmp_mouse_set,
d7f9b689
LC
750 },
751
2313086a
BS
752STEXI
753@item mouse_set @var{index}
70fcbbe7 754@findex mouse_set
2313086a
BS
755Set which mouse device receives events at given @var{index}, index
756can be obtained with
757@example
758info mice
759@end example
760ETEXI
761
d7f9b689
LC
762 {
763 .name = "wavcapture",
764 .args_type = "path:F,freq:i?,bits:i?,nchannels:i?",
d7f9b689
LC
765 .params = "path [frequency [bits [channels]]]",
766 .help = "capture audio to a wave file (default frequency=44100 bits=16 channels=2)",
2b9e3576 767 .cmd = hmp_wavcapture,
d7f9b689 768 },
2313086a
BS
769STEXI
770@item wavcapture @var{filename} [@var{frequency} [@var{bits} [@var{channels}]]]
70fcbbe7 771@findex wavcapture
2313086a
BS
772Capture audio into @var{filename}. Using sample rate @var{frequency}
773bits per sample @var{bits} and number of channels @var{channels}.
774
775Defaults:
776@itemize @minus
777@item Sample rate = 44100 Hz - CD quality
778@item Bits = 16
779@item Number of channels = 2 - Stereo
780@end itemize
781ETEXI
782
d7f9b689
LC
783 {
784 .name = "stopcapture",
785 .args_type = "n:i",
d7f9b689
LC
786 .params = "capture index",
787 .help = "stop capture",
2b9e3576 788 .cmd = hmp_stopcapture,
d7f9b689 789 },
2313086a
BS
790STEXI
791@item stopcapture @var{index}
70fcbbe7 792@findex stopcapture
2313086a
BS
793Stop capture with a given @var{index}, index can be obtained with
794@example
795info capture
796@end example
797ETEXI
798
d7f9b689
LC
799 {
800 .name = "memsave",
801 .args_type = "val:l,size:i,filename:s",
d7f9b689
LC
802 .params = "addr size file",
803 .help = "save to disk virtual memory dump starting at 'addr' of size 'size'",
2b9e3576 804 .cmd = hmp_memsave,
d7f9b689
LC
805 },
806
2313086a
BS
807STEXI
808@item memsave @var{addr} @var{size} @var{file}
70fcbbe7 809@findex memsave
2313086a
BS
810save to disk virtual memory dump starting at @var{addr} of size @var{size}.
811ETEXI
812
d7f9b689
LC
813 {
814 .name = "pmemsave",
815 .args_type = "val:l,size:i,filename:s",
d7f9b689
LC
816 .params = "addr size file",
817 .help = "save to disk physical memory dump starting at 'addr' of size 'size'",
2b9e3576 818 .cmd = hmp_pmemsave,
d7f9b689
LC
819 },
820
2313086a
BS
821STEXI
822@item pmemsave @var{addr} @var{size} @var{file}
70fcbbe7 823@findex pmemsave
2313086a
BS
824save to disk physical memory dump starting at @var{addr} of size @var{size}.
825ETEXI
826
d7f9b689
LC
827 {
828 .name = "boot_set",
829 .args_type = "bootdevice:s",
d7f9b689
LC
830 .params = "bootdevice",
831 .help = "define new values for the boot device list",
2b9e3576 832 .cmd = hmp_boot_set,
d7f9b689
LC
833 },
834
2313086a
BS
835STEXI
836@item boot_set @var{bootdevicelist}
70fcbbe7 837@findex boot_set
2313086a
BS
838Define new values for the boot device list. Those values will override
839the values specified on the command line through the @code{-boot} option.
840
841The values that can be specified here depend on the machine type, but are
842the same that can be specified in the @code{-boot} command line option.
843ETEXI
844
d7f9b689
LC
845 {
846 .name = "nmi",
e9b4b432
LC
847 .args_type = "",
848 .params = "",
9cb805fd 849 .help = "inject an NMI",
2b9e3576 850 .cmd = hmp_nmi,
d7f9b689 851 },
2313086a
BS
852STEXI
853@item nmi @var{cpu}
70fcbbe7 854@findex nmi
9cb805fd 855Inject an NMI on the default CPU (x86/s390) or all CPUs (ppc64).
1f590cf9
LL
856
857ETEXI
858
859 {
3949e594 860 .name = "ringbuf_write",
1f590cf9
LL
861 .args_type = "device:s,data:s",
862 .params = "device data",
3949e594 863 .help = "Write to a ring buffer character device",
2b9e3576 864 .cmd = hmp_ringbuf_write,
8e597779 865 .command_completion = ringbuf_write_completion,
1f590cf9
LL
866 },
867
868STEXI
3949e594
MA
869@item ringbuf_write @var{device} @var{data}
870@findex ringbuf_write
871Write @var{data} to ring buffer character device @var{device}.
872@var{data} must be a UTF-8 string.
1f590cf9 873
49b6d722
LL
874ETEXI
875
876 {
3949e594 877 .name = "ringbuf_read",
49b6d722
LL
878 .args_type = "device:s,size:i",
879 .params = "device size",
3949e594 880 .help = "Read from a ring buffer character device",
2b9e3576 881 .cmd = hmp_ringbuf_read,
8e597779 882 .command_completion = ringbuf_write_completion,
49b6d722
LL
883 },
884
885STEXI
3949e594
MA
886@item ringbuf_read @var{device}
887@findex ringbuf_read
888Read and print up to @var{size} bytes from ring buffer character
889device @var{device}.
543f3412
MA
890Certain non-printable characters are printed \uXXXX, where XXXX is the
891character code in hexadecimal. Character \ is printed \\.
3949e594
MA
892Bug: can screw up when the buffer contains invalid UTF-8 sequences,
893NUL characters, after the ring buffer lost data, and when reading
894stops because the size limit is reached.
49b6d722 895
2313086a
BS
896ETEXI
897
d7f9b689
LC
898 {
899 .name = "migrate",
7a4da28b
PX
900 .args_type = "detach:-d,blk:-b,inc:-i,resume:-r,uri:s",
901 .params = "[-d] [-b] [-i] [-r] uri",
fbc3d96c
LS
902 .help = "migrate to URI (using -d to not wait for completion)"
903 "\n\t\t\t -b for migration without shared storage with"
904 " full copy of disk\n\t\t\t -i for migration without "
905 "shared storage with incremental copy of disk "
7a4da28b
PX
906 "(base image shared between src and destination)"
907 "\n\t\t\t -r to resume a paused migration",
2b9e3576 908 .cmd = hmp_migrate,
d7f9b689
LC
909 },
910
fbc3d96c 911
2313086a 912STEXI
fbc3d96c 913@item migrate [-d] [-b] [-i] @var{uri}
70fcbbe7 914@findex migrate
2313086a 915Migrate to @var{uri} (using -d to not wait for completion).
fbc3d96c
LS
916 -b for migration with full copy of disk
917 -i for migration with incremental copy of disk (base image is shared)
2313086a
BS
918ETEXI
919
d7f9b689
LC
920 {
921 .name = "migrate_cancel",
922 .args_type = "",
d7f9b689
LC
923 .params = "",
924 .help = "cancel the current VM migration",
2b9e3576 925 .cmd = hmp_migrate_cancel,
d7f9b689
LC
926 },
927
2313086a
BS
928STEXI
929@item migrate_cancel
70fcbbe7 930@findex migrate_cancel
2313086a 931Cancel the current VM migration.
94ae12cb 932ETEXI
9e1ba4cc 933
94ae12cb
DDAG
934 {
935 .name = "migrate_continue",
936 .args_type = "state:s",
937 .params = "state",
938 .help = "Continue migration from the given paused state",
939 .cmd = hmp_migrate_continue,
940 },
941STEXI
942@item migrate_continue @var{state}
943@findex migrate_continue
944Continue migration from the paused state @var{state}
bf1ae1f4
DDAG
945ETEXI
946
947 {
948 .name = "migrate_incoming",
949 .args_type = "uri:s",
950 .params = "uri",
951 .help = "Continue an incoming migration from an -incoming defer",
2b9e3576 952 .cmd = hmp_migrate_incoming,
bf1ae1f4
DDAG
953 },
954
955STEXI
956@item migrate_incoming @var{uri}
957@findex migrate_incoming
958Continue an incoming migration using the @var{uri} (that has the same syntax
959as the -incoming option).
3b563c4b 960ETEXI
bf1ae1f4 961
3b563c4b
PX
962 {
963 .name = "migrate_recover",
964 .args_type = "uri:s",
965 .params = "uri",
966 .help = "Continue a paused incoming postcopy migration",
967 .cmd = hmp_migrate_recover,
968 },
969
970STEXI
971@item migrate_recover @var{uri}
972@findex migrate_recover
973Continue a paused incoming postcopy migration using the @var{uri}.
d37297dc
PX
974ETEXI
975
976 {
977 .name = "migrate_pause",
978 .args_type = "",
979 .params = "",
980 .help = "Pause an ongoing migration (postcopy-only)",
981 .cmd = hmp_migrate_pause,
982 },
983
984STEXI
985@item migrate_pause
986@findex migrate_pause
987Pause an ongoing migration. Currently it only supports postcopy.
9e1ba4cc
OW
988ETEXI
989
990 {
991 .name = "migrate_set_cache_size",
992 .args_type = "value:o",
993 .params = "value",
994 .help = "set cache size (in bytes) for XBZRLE migrations,"
995 "the cache size will be rounded down to the nearest "
996 "power of 2.\n"
997 "The cache size affects the number of cache misses."
998 "In case of a high cache miss ratio you need to increase"
999 " the cache size",
2b9e3576 1000 .cmd = hmp_migrate_set_cache_size,
9e1ba4cc
OW
1001 },
1002
1003STEXI
1004@item migrate_set_cache_size @var{value}
1005@findex migrate_set_cache_size
1006Set cache size to @var{value} (in bytes) for xbzrle migrations.
2313086a
BS
1007ETEXI
1008
d7f9b689
LC
1009 {
1010 .name = "migrate_set_speed",
ed3d4a80 1011 .args_type = "value:o",
d7f9b689 1012 .params = "value",
ed3d4a80
JS
1013 .help = "set maximum speed (in bytes) for migrations. "
1014 "Defaults to MB if no size suffix is specified, ie. B/K/M/G/T",
2b9e3576 1015 .cmd = hmp_migrate_set_speed,
d7f9b689
LC
1016 },
1017
2313086a
BS
1018STEXI
1019@item migrate_set_speed @var{value}
70fcbbe7 1020@findex migrate_set_speed
2313086a 1021Set maximum speed to @var{value} (in bytes) for migrations.
2ea42952
GC
1022ETEXI
1023
d7f9b689
LC
1024 {
1025 .name = "migrate_set_downtime",
b0fbf7d3 1026 .args_type = "value:T",
d7f9b689
LC
1027 .params = "value",
1028 .help = "set maximum tolerated downtime (in seconds) for migrations",
2b9e3576 1029 .cmd = hmp_migrate_set_downtime,
d7f9b689 1030 },
2ea42952
GC
1031
1032STEXI
1033@item migrate_set_downtime @var{second}
70fcbbe7 1034@findex migrate_set_downtime
2ea42952 1035Set maximum tolerated downtime (in seconds) for migration.
00458433
OW
1036ETEXI
1037
1038 {
1039 .name = "migrate_set_capability",
1040 .args_type = "capability:s,state:b",
1041 .params = "capability state",
1042 .help = "Enable/Disable the usage of a capability for migration",
2b9e3576 1043 .cmd = hmp_migrate_set_capability,
c68a0409 1044 .command_completion = migrate_set_capability_completion,
00458433
OW
1045 },
1046
1047STEXI
1048@item migrate_set_capability @var{capability} @var{state}
1049@findex migrate_set_capability
1050Enable/Disable the usage of a capability @var{capability} for migration.
50e9a629
LL
1051ETEXI
1052
1053 {
1054 .name = "migrate_set_parameter",
69ef1f36 1055 .args_type = "parameter:s,value:s",
50e9a629
LL
1056 .params = "parameter value",
1057 .help = "Set the parameter for migration",
2b9e3576 1058 .cmd = hmp_migrate_set_parameter,
50e9a629
LL
1059 .command_completion = migrate_set_parameter_completion,
1060 },
1061
1062STEXI
1063@item migrate_set_parameter @var{parameter} @var{value}
1064@findex migrate_set_parameter
1065Set the parameter @var{parameter} for migration.
4886a1bc
DDAG
1066ETEXI
1067
1068 {
1069 .name = "migrate_start_postcopy",
1070 .args_type = "",
1071 .params = "",
a54d340b 1072 .help = "Followup to a migration command to switch the migration"
32c3db5b 1073 " to postcopy mode. The postcopy-ram capability must "
c2eb7f21
GK
1074 "be set on both source and destination before the "
1075 "original migration command .",
2b9e3576 1076 .cmd = hmp_migrate_start_postcopy,
4886a1bc
DDAG
1077 },
1078
1079STEXI
1080@item migrate_start_postcopy
1081@findex migrate_start_postcopy
1082Switch in-progress migration to postcopy mode. Ignored after the end of
1083migration (or once already in postcopy).
d89e666e
HZ
1084ETEXI
1085
1086 {
1087 .name = "x_colo_lost_heartbeat",
1088 .args_type = "",
1089 .params = "",
1090 .help = "Tell COLO that heartbeat is lost,\n\t\t\t"
1091 "a failover or takeover is needed.",
1092 .cmd = hmp_x_colo_lost_heartbeat,
1093 },
1094
1095STEXI
1096@item x_colo_lost_heartbeat
1097@findex x_colo_lost_heartbeat
1098Tell COLO that heartbeat is lost, a failover or takeover is needed.
f8882568
JS
1099ETEXI
1100
1101 {
2ea720db
JS
1102 .name = "client_migrate_info",
1103 .args_type = "protocol:s,hostname:s,port:i?,tls-port:i?,cert-subject:s?",
1104 .params = "protocol hostname port tls-port cert-subject",
13cadefb 1105 .help = "set migration information for remote display",
2b9e3576 1106 .cmd = hmp_client_migrate_info,
f8882568
JS
1107 },
1108
e866e239
GH
1109STEXI
1110@item client_migrate_info @var{protocol} @var{hostname} @var{port} @var{tls-port} @var{cert-subject}
1111@findex client_migrate_info
13cadefb
MA
1112Set migration information for remote display. This makes the server
1113ask the client to automatically reconnect using the new parameters
1114once migration finished successfully. Only implemented for SPICE.
e866e239
GH
1115ETEXI
1116
783e9b48
WC
1117 {
1118 .name = "dump-guest-memory",
228de9cf
PX
1119 .args_type = "paging:-p,detach:-d,zlib:-z,lzo:-l,snappy:-s,filename:F,begin:i?,length:i?",
1120 .params = "[-p] [-d] [-z|-l|-s] filename [begin length]",
c20499d9
QN
1121 .help = "dump guest memory into file 'filename'.\n\t\t\t"
1122 "-p: do paging to get guest's memory mapping.\n\t\t\t"
228de9cf 1123 "-d: return immediately (do not wait for completion).\n\t\t\t"
1b7a0f75
QN
1124 "-z: dump in kdump-compressed format, with zlib compression.\n\t\t\t"
1125 "-l: dump in kdump-compressed format, with lzo compression.\n\t\t\t"
1126 "-s: dump in kdump-compressed format, with snappy compression.\n\t\t\t"
c20499d9
QN
1127 "begin: the starting physical address.\n\t\t\t"
1128 "length: the memory size, in bytes.",
2b9e3576 1129 .cmd = hmp_dump_guest_memory,
783e9b48
WC
1130 },
1131
1132
1133STEXI
c20499d9 1134@item dump-guest-memory [-p] @var{filename} @var{begin} @var{length}
1b7a0f75 1135@item dump-guest-memory [-z|-l|-s] @var{filename}
783e9b48
WC
1136@findex dump-guest-memory
1137Dump guest memory to @var{protocol}. The file can be processed with crash or
1b7a0f75 1138gdb. Without -z|-l|-s, the dump format is ELF.
c20499d9 1139 -p: do paging to get guest's memory mapping.
1b7a0f75
QN
1140 -z: dump in kdump-compressed format, with zlib compression.
1141 -l: dump in kdump-compressed format, with lzo compression.
1142 -s: dump in kdump-compressed format, with snappy compression.
c20499d9 1143 filename: dump file name.
783e9b48 1144 begin: the starting physical address. It's optional, and should be
c20499d9 1145 specified together with length.
783e9b48 1146 length: the memory size, in bytes. It's optional, and should be specified
c20499d9 1147 together with begin.
783e9b48 1148ETEXI
783e9b48 1149
a4538a5c
JH
1150#if defined(TARGET_S390X)
1151 {
1152 .name = "dump-skeys",
1153 .args_type = "filename:F",
1154 .params = "",
1155 .help = "Save guest storage keys into file 'filename'.\n",
2b9e3576 1156 .cmd = hmp_dump_skeys,
a4538a5c
JH
1157 },
1158#endif
1159
1160STEXI
1161@item dump-skeys @var{filename}
1162@findex dump-skeys
1163Save guest storage keys to a file.
f860d497
CI
1164ETEXI
1165
1166#if defined(TARGET_S390X)
1167 {
1168 .name = "migration_mode",
1169 .args_type = "mode:i",
1170 .params = "mode",
1171 .help = "Enables or disables migration mode\n",
1172 .cmd = hmp_migrationmode,
1173 },
1174#endif
1175
1176STEXI
1177@item migration_mode @var{mode}
1178@findex migration_mode
1179Enables or disables migration mode.
a4538a5c
JH
1180ETEXI
1181
e866e239 1182 {
2ea720db 1183 .name = "snapshot_blkdev",
6cc2a415
PB
1184 .args_type = "reuse:-n,device:B,snapshot-file:s?,format:s?",
1185 .params = "[-n] device [new-image-file] [format]",
2ea720db
JS
1186 .help = "initiates a live snapshot\n\t\t\t"
1187 "of device. If a new image file is specified, the\n\t\t\t"
1188 "new image file will become the new root image.\n\t\t\t"
1189 "If format is specified, the snapshot file will\n\t\t\t"
775ca88e 1190 "be created in that format.\n\t\t\t"
6cc2a415
PB
1191 "The default format is qcow2. The -n flag requests QEMU\n\t\t\t"
1192 "to reuse the image found in new-image-file, instead of\n\t\t\t"
1193 "recreating it from scratch.",
2b9e3576 1194 .cmd = hmp_snapshot_blkdev,
e866e239
GH
1195 },
1196
f8882568
JS
1197STEXI
1198@item snapshot_blkdev
1199@findex snapshot_blkdev
1200Snapshot device, using snapshot file as target if provided
775ca88e
WX
1201ETEXI
1202
1203 {
1204 .name = "snapshot_blkdev_internal",
1205 .args_type = "device:B,name:s",
1206 .params = "device name",
1207 .help = "take an internal snapshot of device.\n\t\t\t"
1208 "The format of the image used by device must\n\t\t\t"
1209 "support it, such as qcow2.\n\t\t\t",
2b9e3576 1210 .cmd = hmp_snapshot_blkdev_internal,
775ca88e
WX
1211 },
1212
1213STEXI
1214@item snapshot_blkdev_internal
1215@findex snapshot_blkdev_internal
1216Take an internal snapshot on device if it support
7a4ed2ee
WX
1217ETEXI
1218
1219 {
1220 .name = "snapshot_delete_blkdev_internal",
1221 .args_type = "device:B,name:s,id:s?",
1222 .params = "device name [id]",
1223 .help = "delete an internal snapshot of device.\n\t\t\t"
1224 "If id is specified, qemu will try delete\n\t\t\t"
1225 "the snapshot matching both id and name.\n\t\t\t"
1226 "The format of the image used by device must\n\t\t\t"
1227 "support it, such as qcow2.\n\t\t\t",
2b9e3576 1228 .cmd = hmp_snapshot_delete_blkdev_internal,
7a4ed2ee
WX
1229 },
1230
1231STEXI
1232@item snapshot_delete_blkdev_internal
1233@findex snapshot_delete_blkdev_internal
1234Delete an internal snapshot on device if it support
d9b902db
PB
1235ETEXI
1236
1237 {
1238 .name = "drive_mirror",
1239 .args_type = "reuse:-n,full:-f,device:B,target:s,format:s?",
1240 .params = "[-n] [-f] device target [format]",
1241 .help = "initiates live storage\n\t\t\t"
1242 "migration for a device. The device's contents are\n\t\t\t"
1243 "copied to the new image file, including data that\n\t\t\t"
1244 "is written after the command is started.\n\t\t\t"
1245 "The -n flag requests QEMU to reuse the image found\n\t\t\t"
1246 "in new-image-file, instead of recreating it from scratch.\n\t\t\t"
1247 "The -f flag requests QEMU to copy the whole disk,\n\t\t\t"
1248 "so that the result does not need a backing file.\n\t\t\t",
2b9e3576 1249 .cmd = hmp_drive_mirror,
d9b902db
PB
1250 },
1251STEXI
1252@item drive_mirror
1253@findex drive_mirror
1254Start mirroring a block device's writes to a new destination,
1255using the specified target.
de90930a
SH
1256ETEXI
1257
1258 {
1259 .name = "drive_backup",
13b9414b
PB
1260 .args_type = "reuse:-n,full:-f,compress:-c,device:B,target:s,format:s?",
1261 .params = "[-n] [-f] [-c] device target [format]",
de90930a
SH
1262 .help = "initiates a point-in-time\n\t\t\t"
1263 "copy for a device. The device's contents are\n\t\t\t"
1264 "copied to the new image file, excluding data that\n\t\t\t"
1265 "is written after the command is started.\n\t\t\t"
1266 "The -n flag requests QEMU to reuse the image found\n\t\t\t"
1267 "in new-image-file, instead of recreating it from scratch.\n\t\t\t"
1268 "The -f flag requests QEMU to copy the whole disk,\n\t\t\t"
13b9414b
PB
1269 "so that the result does not need a backing file.\n\t\t\t"
1270 "The -c flag requests QEMU to compress backup data\n\t\t\t"
1271 "(if the target format supports it).\n\t\t\t",
2b9e3576 1272 .cmd = hmp_drive_backup,
de90930a
SH
1273 },
1274STEXI
1275@item drive_backup
1276@findex drive_backup
1277Start a point-in-time copy of a block device to a specificed target.
2313086a
BS
1278ETEXI
1279
d7f9b689
LC
1280 {
1281 .name = "drive_add",
abb21ac3
KW
1282 .args_type = "node:-n,pci_addr:s,opts:s",
1283 .params = "[-n] [[<domain>:]<bus>:]<slot>\n"
d7f9b689 1284 "[file=file][,if=type][,bus=n]\n"
fb0490f6 1285 "[,unit=m][,media=d][,index=i]\n"
d7f9b689 1286 "[,cyls=c,heads=h,secs=s[,trans=t]]\n"
fb0490f6
SH
1287 "[,snapshot=on|off][,cache=on|off]\n"
1288 "[,readonly=on|off][,copy-on-read=on|off]",
d7f9b689 1289 .help = "add drive to PCI storage controller",
2b9e3576 1290 .cmd = hmp_drive_add,
d7f9b689 1291 },
d7f9b689 1292
2313086a
BS
1293STEXI
1294@item drive_add
70fcbbe7 1295@findex drive_add
2313086a 1296Add drive to PCI storage controller.
2ae63bda
IY
1297ETEXI
1298
1299 {
1300 .name = "pcie_aer_inject_error",
1301 .args_type = "advisory_non_fatal:-a,correctable:-c,"
1302 "id:s,error_status:s,"
1303 "header0:i?,header1:i?,header2:i?,header3:i?,"
1304 "prefix0:i?,prefix1:i?,prefix2:i?,prefix3:i?",
1305 .params = "[-a] [-c] id "
1306 "<error_status> [<tlp header> [<tlp header prefix>]]",
1307 .help = "inject pcie aer error\n\t\t\t"
1308 " -a for advisory non fatal error\n\t\t\t"
1309 " -c for correctable error\n\t\t\t"
1310 "<id> = qdev device id\n\t\t\t"
1311 "<error_status> = error string or 32bit\n\t\t\t"
1312 "<tlb header> = 32bit x 4\n\t\t\t"
1313 "<tlb header prefix> = 32bit x 4",
2b9e3576 1314 .cmd = hmp_pcie_aer_inject_error,
2ae63bda
IY
1315 },
1316
1317STEXI
1318@item pcie_aer_inject_error
1319@findex pcie_aer_inject_error
1320Inject PCIe AER error
ae82d324
MA
1321ETEXI
1322
1323 {
1324 .name = "netdev_add",
1325 .args_type = "netdev:O",
03ce5744 1326 .params = "[user|tap|socket|vde|bridge|hubport|netmap|vhost-user],id=str[,prop=value][,...]",
ae82d324 1327 .help = "add host network device",
2b9e3576 1328 .cmd = hmp_netdev_add,
b162b49a 1329 .command_completion = netdev_add_completion,
ae82d324
MA
1330 },
1331
1332STEXI
1333@item netdev_add
1334@findex netdev_add
1335Add host network device.
1336ETEXI
1337
1338 {
1339 .name = "netdev_del",
1340 .args_type = "id:s",
1341 .params = "id",
1342 .help = "remove host network device",
2b9e3576 1343 .cmd = hmp_netdev_del,
11b389f2 1344 .command_completion = netdev_del_completion,
ae82d324
MA
1345 },
1346
1347STEXI
1348@item netdev_del
1349@findex netdev_del
1350Remove host network device.
cff8b2c6
PB
1351ETEXI
1352
1353 {
1354 .name = "object_add",
1355 .args_type = "object:O",
1356 .params = "[qom-type=]type,id=str[,prop=value][,...]",
1357 .help = "create QOM object",
2b9e3576 1358 .cmd = hmp_object_add,
bfa40f77 1359 .command_completion = object_add_completion,
cff8b2c6
PB
1360 },
1361
1362STEXI
1363@item object_add
1364@findex object_add
1365Create QOM object.
ab2d0531
PB
1366ETEXI
1367
1368 {
1369 .name = "object_del",
1370 .args_type = "id:s",
1371 .params = "id",
1372 .help = "destroy QOM object",
2b9e3576 1373 .cmd = hmp_object_del,
bfa40f77 1374 .command_completion = object_del_completion,
ab2d0531
PB
1375 },
1376
1377STEXI
1378@item object_del
1379@findex object_del
1380Destroy QOM object.
2313086a
BS
1381ETEXI
1382
1383#ifdef CONFIG_SLIRP
d7f9b689
LC
1384 {
1385 .name = "hostfwd_add",
1386 .args_type = "arg1:s,arg2:s?,arg3:s?",
93653066 1387 .params = "[hub_id name]|[netdev_id] [tcp|udp]:[hostaddr]:hostport-[guestaddr]:guestport",
d7f9b689 1388 .help = "redirect TCP or UDP connections from host to guest (requires -net user)",
2b9e3576 1389 .cmd = hmp_hostfwd_add,
d7f9b689 1390 },
21413d68
MA
1391#endif
1392STEXI
1393@item hostfwd_add
1394@findex hostfwd_add
1395Redirect TCP or UDP connections from host to guest (requires -net user).
1396ETEXI
d7f9b689 1397
21413d68 1398#ifdef CONFIG_SLIRP
d7f9b689
LC
1399 {
1400 .name = "hostfwd_remove",
1401 .args_type = "arg1:s,arg2:s?,arg3:s?",
93653066 1402 .params = "[hub_id name]|[netdev_id] [tcp|udp]:[hostaddr]:hostport",
d7f9b689 1403 .help = "remove host-to-guest TCP or UDP redirection",
2b9e3576 1404 .cmd = hmp_hostfwd_remove,
d7f9b689
LC
1405 },
1406
2313086a
BS
1407#endif
1408STEXI
21413d68
MA
1409@item hostfwd_remove
1410@findex hostfwd_remove
1411Remove host-to-guest TCP or UDP redirection.
2313086a
BS
1412ETEXI
1413
d7f9b689
LC
1414 {
1415 .name = "balloon",
3b0bd6ec 1416 .args_type = "value:M",
d7f9b689 1417 .params = "target",
3c05613a 1418 .help = "request VM to change its memory allocation (in MB)",
2b9e3576 1419 .cmd = hmp_balloon,
d7f9b689
LC
1420 },
1421
2313086a
BS
1422STEXI
1423@item balloon @var{value}
70fcbbe7 1424@findex balloon
2313086a
BS
1425Request VM to change its memory allocation to @var{value} (in MB).
1426ETEXI
1427
d7f9b689
LC
1428 {
1429 .name = "set_link",
c9b26a4c
MA
1430 .args_type = "name:s,up:b",
1431 .params = "name on|off",
d7f9b689 1432 .help = "change the link status of a network adapter",
2b9e3576 1433 .cmd = hmp_set_link,
40d19394 1434 .command_completion = set_link_completion,
d7f9b689
LC
1435 },
1436
2313086a 1437STEXI
c9b26a4c 1438@item set_link @var{name} [on|off]
70fcbbe7 1439@findex set_link
c9b26a4c 1440Switch link @var{name} on (i.e. up) or off (i.e. down).
2313086a
BS
1441ETEXI
1442
d7f9b689
LC
1443 {
1444 .name = "watchdog_action",
1445 .args_type = "action:s",
d7f9b689
LC
1446 .params = "[reset|shutdown|poweroff|pause|debug|none]",
1447 .help = "change watchdog action",
2b9e3576 1448 .cmd = hmp_watchdog_action,
d0ece345 1449 .command_completion = watchdog_action_completion,
d7f9b689
LC
1450 },
1451
2313086a
BS
1452STEXI
1453@item watchdog_action
70fcbbe7 1454@findex watchdog_action
2313086a
BS
1455Change watchdog action.
1456ETEXI
1457
d7f9b689
LC
1458 {
1459 .name = "acl_show",
1460 .args_type = "aclname:s",
d7f9b689
LC
1461 .params = "aclname",
1462 .help = "list rules in the access control list",
2b9e3576 1463 .cmd = hmp_acl_show,
d7f9b689
LC
1464 },
1465
2313086a 1466STEXI
15dfcd45 1467@item acl_show @var{aclname}
70fcbbe7 1468@findex acl_show
15dfcd45
JK
1469List all the matching rules in the access control list, and the default
1470policy. There are currently two named access control lists,
1471@var{vnc.x509dname} and @var{vnc.username} matching on the x509 client
1472certificate distinguished name, and SASL username respectively.
1473ETEXI
2313086a 1474
d7f9b689
LC
1475 {
1476 .name = "acl_policy",
1477 .args_type = "aclname:s,policy:s",
d7f9b689
LC
1478 .params = "aclname allow|deny",
1479 .help = "set default access control list policy",
2b9e3576 1480 .cmd = hmp_acl_policy,
d7f9b689
LC
1481 },
1482
15dfcd45 1483STEXI
cbbfacc6 1484@item acl_policy @var{aclname} @code{allow|deny}
70fcbbe7 1485@findex acl_policy
15dfcd45 1486Set the default access control list policy, used in the event that
2313086a 1487none of the explicit rules match. The default policy at startup is
15dfcd45
JK
1488always @code{deny}.
1489ETEXI
1490
d7f9b689
LC
1491 {
1492 .name = "acl_add",
1493 .args_type = "aclname:s,match:s,policy:s,index:i?",
d7f9b689
LC
1494 .params = "aclname match allow|deny [index]",
1495 .help = "add a match rule to the access control list",
2b9e3576 1496 .cmd = hmp_acl_add,
d7f9b689
LC
1497 },
1498
15dfcd45 1499STEXI
0e4aec98
MA
1500@item acl_add @var{aclname} @var{match} @code{allow|deny} [@var{index}]
1501@findex acl_add
15dfcd45
JK
1502Add a match rule to the access control list, allowing or denying access.
1503The match will normally be an exact username or x509 distinguished name,
1504but can optionally include wildcard globs. eg @code{*@@EXAMPLE.COM} to
1505allow all users in the @code{EXAMPLE.COM} kerberos realm. The match will
2313086a 1506normally be appended to the end of the ACL, but can be inserted
15dfcd45
JK
1507earlier in the list if the optional @var{index} parameter is supplied.
1508ETEXI
1509
d7f9b689
LC
1510 {
1511 .name = "acl_remove",
1512 .args_type = "aclname:s,match:s",
d7f9b689
LC
1513 .params = "aclname match",
1514 .help = "remove a match rule from the access control list",
2b9e3576 1515 .cmd = hmp_acl_remove,
d7f9b689
LC
1516 },
1517
15dfcd45
JK
1518STEXI
1519@item acl_remove @var{aclname} @var{match}
70fcbbe7 1520@findex acl_remove
15dfcd45
JK
1521Remove the specified match rule from the access control list.
1522ETEXI
1523
d7f9b689
LC
1524 {
1525 .name = "acl_reset",
1526 .args_type = "aclname:s",
d7f9b689
LC
1527 .params = "aclname",
1528 .help = "reset the access control list",
2b9e3576 1529 .cmd = hmp_acl_reset,
d7f9b689
LC
1530 },
1531
15dfcd45 1532STEXI
0e4aec98
MA
1533@item acl_reset @var{aclname}
1534@findex acl_reset
15dfcd45 1535Remove all matches from the access control list, and set the default
2313086a 1536policy back to @code{deny}.
2313086a
BS
1537ETEXI
1538
4057725f
PB
1539 {
1540 .name = "nbd_server_start",
1541 .args_type = "all:-a,writable:-w,uri:s",
1542 .params = "nbd_server_start [-a] [-w] host:port",
1543 .help = "serve block devices on the given host and port",
2b9e3576 1544 .cmd = hmp_nbd_server_start,
4057725f
PB
1545 },
1546STEXI
1547@item nbd_server_start @var{host}:@var{port}
1548@findex nbd_server_start
1549Start an NBD server on the given host and/or port. If the @option{-a}
1550option is included, all of the virtual machine's block devices that
1551have an inserted media on them are automatically exported; in this case,
1552the @option{-w} option makes the devices writable too.
1553ETEXI
1554
1555 {
1556 .name = "nbd_server_add",
dba49323
EB
1557 .args_type = "writable:-w,device:B,name:s?",
1558 .params = "nbd_server_add [-w] device [name]",
4057725f 1559 .help = "export a block device via NBD",
2b9e3576 1560 .cmd = hmp_nbd_server_add,
4057725f
PB
1561 },
1562STEXI
dba49323 1563@item nbd_server_add @var{device} [ @var{name} ]
4057725f
PB
1564@findex nbd_server_add
1565Export a block device through QEMU's NBD server, which must be started
1566beforehand with @command{nbd_server_start}. The @option{-w} option makes the
dba49323
EB
1567exported device writable too. The export name is controlled by @var{name},
1568defaulting to @var{device}.
08fb10a7
EB
1569ETEXI
1570
1571 {
1572 .name = "nbd_server_remove",
1573 .args_type = "force:-f,name:s",
1574 .params = "nbd_server_remove [-f] name",
1575 .help = "remove an export previously exposed via NBD",
1576 .cmd = hmp_nbd_server_remove,
1577 },
1578STEXI
1579@item nbd_server_remove [-f] @var{name}
1580@findex nbd_server_remove
1581Stop exporting a block device through QEMU's NBD server, which was
1582previously started with @command{nbd_server_add}. The @option{-f}
1583option forces the server to drop the export immediately even if
1584clients are connected; otherwise the command fails unless there are no
1585clients.
4057725f
PB
1586ETEXI
1587
1588 {
1589 .name = "nbd_server_stop",
1590 .args_type = "",
1591 .params = "nbd_server_stop",
1592 .help = "stop serving block devices using the NBD protocol",
2b9e3576 1593 .cmd = hmp_nbd_server_stop,
4057725f
PB
1594 },
1595STEXI
1596@item nbd_server_stop
1597@findex nbd_server_stop
1598Stop the QEMU embedded NBD server.
1599ETEXI
1600
1601
79c4f6b0 1602#if defined(TARGET_I386)
d7f9b689
LC
1603
1604 {
1605 .name = "mce",
31ce5e0c
JD
1606 .args_type = "broadcast:-b,cpu_index:i,bank:i,status:l,mcg_status:l,addr:l,misc:l",
1607 .params = "[-b] cpu bank status mcgstatus addr misc",
1608 .help = "inject a MCE on the given CPU [and broadcast to other CPUs with -b option]",
2b9e3576 1609 .cmd = hmp_mce,
d7f9b689
LC
1610 },
1611
79c4f6b0
HY
1612#endif
1613STEXI
1614@item mce @var{cpu} @var{bank} @var{status} @var{mcgstatus} @var{addr} @var{misc}
70fcbbe7 1615@findex mce (x86)
79c4f6b0 1616Inject an MCE on the given CPU (x86 only).
f07918fd
MM
1617ETEXI
1618
d7f9b689
LC
1619 {
1620 .name = "getfd",
1621 .args_type = "fdname:s",
d7f9b689
LC
1622 .params = "getfd name",
1623 .help = "receive a file descriptor via SCM rights and assign it a name",
2b9e3576 1624 .cmd = hmp_getfd,
d7f9b689
LC
1625 },
1626
f07918fd
MM
1627STEXI
1628@item getfd @var{fdname}
70fcbbe7 1629@findex getfd
f07918fd
MM
1630If a file descriptor is passed alongside this command using the SCM_RIGHTS
1631mechanism on unix sockets, it is stored using the name @var{fdname} for
1632later use by other monitor commands.
1633ETEXI
1634
d7f9b689
LC
1635 {
1636 .name = "closefd",
1637 .args_type = "fdname:s",
d7f9b689
LC
1638 .params = "closefd name",
1639 .help = "close a file descriptor previously passed via SCM rights",
2b9e3576 1640 .cmd = hmp_closefd,
d7f9b689
LC
1641 },
1642
f07918fd
MM
1643STEXI
1644@item closefd @var{fdname}
70fcbbe7 1645@findex closefd
f07918fd
MM
1646Close the file descriptor previously assigned to @var{fdname} using the
1647@code{getfd} command. This is only needed if the file descriptor was never
1648used by another monitor command.
a3a55a2e
LC
1649ETEXI
1650
1651 {
1652 .name = "block_passwd",
1653 .args_type = "device:B,password:s",
1654 .params = "block_passwd device password",
1655 .help = "set the password of encrypted block devices",
2b9e3576 1656 .cmd = hmp_block_passwd,
a3a55a2e
LC
1657 },
1658
727f005e 1659STEXI
b76d799e
MA
1660@item block_passwd @var{device} @var{password}
1661@findex block_passwd
1662Set the encrypted device @var{device} password to @var{password}
c01c214b
DB
1663
1664This command is now obsolete and will always return an error since 2.10
727f005e
ZYW
1665ETEXI
1666
1667 {
1668 .name = "block_set_io_throttle",
1669 .args_type = "device:B,bps:l,bps_rd:l,bps_wr:l,iops:l,iops_rd:l,iops_wr:l",
1670 .params = "device bps bps_rd bps_wr iops iops_rd iops_wr",
1671 .help = "change I/O throttle limits for a block drive",
2b9e3576 1672 .cmd = hmp_block_set_io_throttle,
727f005e
ZYW
1673 },
1674
a3a55a2e 1675STEXI
b76d799e
MA
1676@item block_set_io_throttle @var{device} @var{bps} @var{bps_rd} @var{bps_wr} @var{iops} @var{iops_rd} @var{iops_wr}
1677@findex block_set_io_throttle
83592184
AG
1678Change 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}.
1679@var{device} can be a block device name, a qdev ID or a QOM path.
7572150c
GH
1680ETEXI
1681
1682 {
1683 .name = "set_password",
1684 .args_type = "protocol:s,password:s,connected:s?",
1685 .params = "protocol password action-if-connected",
1686 .help = "set spice/vnc password",
2b9e3576 1687 .cmd = hmp_set_password,
7572150c
GH
1688 },
1689
1690STEXI
1691@item set_password [ vnc | spice ] password [ action-if-connected ]
1692@findex set_password
7572150c
GH
1693Change spice/vnc password. Use zero to make the password stay valid
1694forever. @var{action-if-connected} specifies what should happen in
1695case a connection is established: @var{fail} makes the password change
1696fail. @var{disconnect} changes the password and disconnects the
1697client. @var{keep} changes the password and keeps the connection up.
1698@var{keep} is the default.
1699ETEXI
1700
1701 {
1702 .name = "expire_password",
1703 .args_type = "protocol:s,time:s",
1704 .params = "protocol time",
1705 .help = "set spice/vnc password expire-time",
2b9e3576 1706 .cmd = hmp_expire_password,
7572150c
GH
1707 },
1708
1709STEXI
1710@item expire_password [ vnc | spice ] expire-time
1711@findex expire_password
7572150c
GH
1712Specify when a password for spice/vnc becomes
1713invalid. @var{expire-time} accepts:
1714
1715@table @var
1716@item now
1717Invalidate password instantly.
1718
1719@item never
1720Password stays valid forever.
1721
1722@item +nsec
1723Password stays valid for @var{nsec} seconds starting now.
1724
1725@item nsec
1726Password is invalidated at the given time. @var{nsec} are the seconds
1727passed since 1970, i.e. unix epoch.
1728
1729@end table
f1088908
GH
1730ETEXI
1731
46920825
GH
1732 {
1733 .name = "chardev-add",
1734 .args_type = "args:s",
1735 .params = "args",
1736 .help = "add chardev",
2b9e3576 1737 .cmd = hmp_chardev_add,
13e315da 1738 .command_completion = chardev_add_completion,
46920825
GH
1739 },
1740
1741STEXI
b76d799e
MA
1742@item chardev-add args
1743@findex chardev-add
75b60160
AN
1744chardev-add accepts the same parameters as the -chardev command line switch.
1745
1746ETEXI
1747
1748 {
1749 .name = "chardev-change",
1750 .args_type = "id:s,args:s",
1751 .params = "id args",
1752 .help = "change chardev",
1753 .cmd = hmp_chardev_change,
1754 },
1755
1756STEXI
1757@item chardev-change args
1758@findex chardev-change
1759chardev-change accepts existing chardev @var{id} and then the same arguments
1760as the -chardev command line switch (except for "id").
46920825
GH
1761
1762ETEXI
1763
1764 {
1765 .name = "chardev-remove",
1766 .args_type = "id:s",
1767 .params = "id",
1768 .help = "remove chardev",
2b9e3576 1769 .cmd = hmp_chardev_remove,
6297d9a2 1770 .command_completion = chardev_remove_completion,
46920825
GH
1771 },
1772
1773STEXI
b76d799e
MA
1774@item chardev-remove id
1775@findex chardev-remove
46920825
GH
1776Removes the chardev @var{id}.
1777
bd1d5ad9
SF
1778ETEXI
1779
1780 {
1781 .name = "chardev-send-break",
1782 .args_type = "id:s",
1783 .params = "id",
1784 .help = "send a break on chardev",
1785 .cmd = hmp_chardev_send_break,
1786 .command_completion = chardev_remove_completion,
1787 },
1788
1789STEXI
1790@item chardev-send-break id
1791@findex chardev-send-break
1792Send a break on the chardev @var{id}.
1793
587da2c3
KW
1794ETEXI
1795
1796 {
1797 .name = "qemu-io",
1798 .args_type = "device:B,command:s",
1799 .params = "[device] \"[command]\"",
1800 .help = "run a qemu-io command on a block device",
2b9e3576 1801 .cmd = hmp_qemu_io,
587da2c3
KW
1802 },
1803
1804STEXI
1805@item qemu-io @var{device} @var{command}
1806@findex qemu-io
587da2c3
KW
1807Executes a qemu-io command on the given block device.
1808
abf23329
JH
1809ETEXI
1810
1811 {
1812 .name = "cpu-add",
1813 .args_type = "id:i",
1814 .params = "id",
1815 .help = "add cpu",
2b9e3576 1816 .cmd = hmp_cpu_add,
abf23329
JH
1817 },
1818
1819STEXI
1820@item cpu-add @var{id}
b76d799e 1821@findex cpu-add
abf23329 1822Add CPU with id @var{id}
89d7fa9e
AF
1823ETEXI
1824
1825 {
1826 .name = "qom-list",
1827 .args_type = "path:s?",
1828 .params = "path",
1829 .help = "list QOM properties",
2b9e3576 1830 .cmd = hmp_qom_list,
89d7fa9e
AF
1831 },
1832
1833STEXI
1834@item qom-list [@var{path}]
1835Print QOM properties of object at location @var{path}
c0e6ee9e
AF
1836ETEXI
1837
1838 {
1839 .name = "qom-set",
1840 .args_type = "path:s,property:s,value:s",
1841 .params = "path property value",
1842 .help = "set QOM property",
2b9e3576 1843 .cmd = hmp_qom_set,
c0e6ee9e
AF
1844 },
1845
1846STEXI
1847@item qom-set @var{path} @var{property} @var{value}
1848Set QOM property @var{property} of object at location @var{path} to value @var{value}
46920825 1849ETEXI
b40292e7 1850
33572ece
JK
1851 {
1852 .name = "info",
1853 .args_type = "item:s?",
1854 .params = "[subcommand]",
1855 .help = "show various information about the system state",
2b9e3576
MAL
1856 .cmd = hmp_info_help,
1857 .sub_table = info_cmds,
33572ece
JK
1858 },
1859
70703344
PB
1860STEXI
1861@end table
1862ETEXI