]> git.proxmox.com Git - mirror_qemu.git/blame - hmp-commands-info.hx
block/curl: Check protocol prefix
[mirror_qemu.git] / hmp-commands-info.hx
CommitLineData
da76ee76
PB
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 info commands
6HXCOMM HXCOMM can be used for comments, discarded from both texi and C
7
8STEXI
9@table @option
2cd8af2d
PB
10@item info @var{subcommand}
11@findex info
12Show various information about the system state.
13@table @option
da76ee76
PB
14ETEXI
15
16 {
17 .name = "version",
18 .args_type = "",
19 .params = "",
20 .help = "show the version of QEMU",
2b9e3576 21 .cmd = hmp_info_version,
da76ee76
PB
22 },
23
24STEXI
25@item info version
26@findex version
27Show the version of QEMU.
28ETEXI
29
30 {
31 .name = "network",
32 .args_type = "",
33 .params = "",
34 .help = "show the network state",
2b9e3576 35 .cmd = hmp_info_network,
da76ee76
PB
36 },
37
38STEXI
39@item info network
40@findex network
41Show the network state.
42ETEXI
43
44 {
45 .name = "chardev",
46 .args_type = "",
47 .params = "",
48 .help = "show the character devices",
2b9e3576 49 .cmd = hmp_info_chardev,
da76ee76
PB
50 },
51
52STEXI
53@item info chardev
54@findex chardev
55Show the character devices.
56ETEXI
57
58 {
59 .name = "block",
60 .args_type = "nodes:-n,verbose:-v,device:B?",
61 .params = "[-n] [-v] [device]",
62 .help = "show info of one block device or all block devices "
63 "(-n: show named nodes; -v: show details)",
2b9e3576 64 .cmd = hmp_info_block,
da76ee76
PB
65 },
66
67STEXI
68@item info block
69@findex block
70Show info of one block device or all block devices.
71ETEXI
72
73 {
74 .name = "blockstats",
75 .args_type = "",
76 .params = "",
77 .help = "show block device statistics",
2b9e3576 78 .cmd = hmp_info_blockstats,
da76ee76
PB
79 },
80
81STEXI
82@item info blockstats
83@findex blockstats
84Show block device statistics.
85ETEXI
86
87 {
88 .name = "block-jobs",
89 .args_type = "",
90 .params = "",
91 .help = "show progress of ongoing block device operations",
2b9e3576 92 .cmd = hmp_info_block_jobs,
da76ee76
PB
93 },
94
95STEXI
96@item info block-jobs
97@findex block-jobs
98Show progress of ongoing block device operations.
99ETEXI
100
101 {
102 .name = "registers",
103 .args_type = "",
104 .params = "",
105 .help = "show the cpu registers",
2b9e3576 106 .cmd = hmp_info_registers,
da76ee76
PB
107 },
108
109STEXI
110@item info registers
111@findex registers
112Show the cpu registers.
1f871d49
PB
113ETEXI
114
115#if defined(TARGET_I386)
116 {
117 .name = "lapic",
118 .args_type = "",
119 .params = "",
120 .help = "show local apic state",
2b9e3576 121 .cmd = hmp_info_local_apic,
1f871d49
PB
122 },
123#endif
124
125STEXI
126@item info lapic
127@findex lapic
128Show local APIC state
d665d696
PB
129ETEXI
130
131#if defined(TARGET_I386)
132 {
133 .name = "ioapic",
134 .args_type = "",
135 .params = "",
136 .help = "show io apic state",
2b9e3576 137 .cmd = hmp_info_io_apic,
d665d696
PB
138 },
139#endif
140
141STEXI
142@item info ioapic
143@findex ioapic
144Show io APIC state
da76ee76
PB
145ETEXI
146
147 {
148 .name = "cpus",
149 .args_type = "",
150 .params = "",
151 .help = "show infos for each CPU",
2b9e3576 152 .cmd = hmp_info_cpus,
da76ee76
PB
153 },
154
155STEXI
156@item info cpus
157@findex cpus
158Show infos for each CPU.
159ETEXI
160
161 {
162 .name = "history",
163 .args_type = "",
164 .params = "",
165 .help = "show the command line history",
2b9e3576 166 .cmd = hmp_info_history,
da76ee76
PB
167 },
168
169STEXI
170@item info history
171@findex history
172Show the command line history.
173ETEXI
174
da76ee76
PB
175 {
176 .name = "irq",
177 .args_type = "",
178 .params = "",
179 .help = "show the interrupts statistics (if available)",
2b9e3576 180 .cmd = hmp_info_irq,
da76ee76
PB
181 },
182
183STEXI
184@item info irq
185@findex irq
186Show the interrupts statistics (if available).
187ETEXI
188
189 {
190 .name = "pic",
191 .args_type = "",
192 .params = "",
254316fa 193 .help = "show PIC state",
2b9e3576 194 .cmd = hmp_info_pic,
da76ee76 195 },
da76ee76
PB
196
197STEXI
198@item info pic
199@findex pic
200Show i8259 (PIC) state.
abadcbc8
PB
201ETEXI
202
203 {
204 .name = "pci",
205 .args_type = "",
206 .params = "",
207 .help = "show PCI info",
2b9e3576 208 .cmd = hmp_info_pci,
abadcbc8
PB
209 },
210
211STEXI
212@item info pci
213@findex pci
214Show PCI information.
da76ee76
PB
215ETEXI
216
217#if defined(TARGET_I386) || defined(TARGET_SH4) || defined(TARGET_SPARC) || \
218 defined(TARGET_PPC) || defined(TARGET_XTENSA)
219 {
220 .name = "tlb",
221 .args_type = "",
222 .params = "",
223 .help = "show virtual to physical memory mappings",
2b9e3576 224 .cmd = hmp_info_tlb,
da76ee76
PB
225 },
226#endif
227
228STEXI
229@item info tlb
230@findex tlb
231Show virtual to physical memory mappings.
232ETEXI
233
234#if defined(TARGET_I386)
235 {
236 .name = "mem",
237 .args_type = "",
238 .params = "",
239 .help = "show the active virtual memory mappings",
2b9e3576 240 .cmd = hmp_info_mem,
da76ee76
PB
241 },
242#endif
243
244STEXI
245@item info mem
246@findex mem
247Show the active virtual memory mappings.
248ETEXI
249
250 {
251 .name = "mtree",
57bb40c9
PX
252 .args_type = "flatview:-f",
253 .params = "[-f]",
254 .help = "show memory tree (-f: dump flat view for address spaces)",
2b9e3576 255 .cmd = hmp_info_mtree,
da76ee76
PB
256 },
257
258STEXI
259@item info mtree
260@findex mtree
261Show memory tree.
262ETEXI
263
264 {
265 .name = "jit",
266 .args_type = "",
267 .params = "",
268 .help = "show dynamic compiler info",
2b9e3576 269 .cmd = hmp_info_jit,
da76ee76
PB
270 },
271
272STEXI
273@item info jit
274@findex jit
275Show dynamic compiler info.
276ETEXI
277
278 {
279 .name = "opcount",
280 .args_type = "",
281 .params = "",
282 .help = "show dynamic compiler opcode counters",
2b9e3576 283 .cmd = hmp_info_opcount,
da76ee76
PB
284 },
285
286STEXI
287@item info opcount
288@findex opcount
289Show dynamic compiler opcode counters
290ETEXI
291
292 {
293 .name = "kvm",
294 .args_type = "",
295 .params = "",
296 .help = "show KVM information",
2b9e3576 297 .cmd = hmp_info_kvm,
da76ee76
PB
298 },
299
300STEXI
301@item info kvm
302@findex kvm
303Show KVM information.
304ETEXI
305
306 {
307 .name = "numa",
308 .args_type = "",
309 .params = "",
310 .help = "show NUMA information",
2b9e3576 311 .cmd = hmp_info_numa,
da76ee76
PB
312 },
313
314STEXI
315@item info numa
316@findex numa
317Show NUMA information.
318ETEXI
319
320 {
321 .name = "usb",
322 .args_type = "",
323 .params = "",
324 .help = "show guest USB devices",
2b9e3576 325 .cmd = hmp_info_usb,
da76ee76
PB
326 },
327
328STEXI
329@item info usb
330@findex usb
331Show guest USB devices.
332ETEXI
333
334 {
335 .name = "usbhost",
336 .args_type = "",
337 .params = "",
338 .help = "show host USB devices",
2b9e3576 339 .cmd = hmp_info_usbhost,
da76ee76
PB
340 },
341
342STEXI
343@item info usbhost
344@findex usbhost
345Show host USB devices.
346ETEXI
347
348 {
349 .name = "profile",
350 .args_type = "",
351 .params = "",
352 .help = "show profiling information",
2b9e3576 353 .cmd = hmp_info_profile,
da76ee76
PB
354 },
355
356STEXI
357@item info profile
358@findex profile
359Show profiling information.
360ETEXI
361
362 {
363 .name = "capture",
364 .args_type = "",
365 .params = "",
366 .help = "show capture information",
2b9e3576 367 .cmd = hmp_info_capture,
da76ee76
PB
368 },
369
370STEXI
371@item info capture
372@findex capture
373Show capture information.
374ETEXI
375
376 {
377 .name = "snapshots",
378 .args_type = "",
379 .params = "",
380 .help = "show the currently saved VM snapshots",
2b9e3576 381 .cmd = hmp_info_snapshots,
da76ee76
PB
382 },
383
384STEXI
385@item info snapshots
386@findex snapshots
387Show the currently saved VM snapshots.
388ETEXI
389
390 {
391 .name = "status",
392 .args_type = "",
393 .params = "",
394 .help = "show the current VM status (running|paused)",
2b9e3576 395 .cmd = hmp_info_status,
da76ee76
PB
396 },
397
398STEXI
399@item info status
400@findex status
401Show the current VM status (running|paused).
402ETEXI
403
404 {
405 .name = "mice",
406 .args_type = "",
407 .params = "",
408 .help = "show which guest mouse is receiving events",
2b9e3576 409 .cmd = hmp_info_mice,
da76ee76
PB
410 },
411
412STEXI
413@item info mice
414@findex mice
415Show which guest mouse is receiving events.
416ETEXI
417
418 {
419 .name = "vnc",
420 .args_type = "",
421 .params = "",
422 .help = "show the vnc server status",
2b9e3576 423 .cmd = hmp_info_vnc,
da76ee76
PB
424 },
425
426STEXI
427@item info vnc
428@findex vnc
429Show the vnc server status.
430ETEXI
431
432#if defined(CONFIG_SPICE)
433 {
434 .name = "spice",
435 .args_type = "",
436 .params = "",
437 .help = "show the spice server status",
2b9e3576 438 .cmd = hmp_info_spice,
da76ee76
PB
439 },
440#endif
441
442STEXI
443@item info spice
444@findex spice
445Show the spice server status.
446ETEXI
447
448 {
449 .name = "name",
450 .args_type = "",
451 .params = "",
452 .help = "show the current VM name",
2b9e3576 453 .cmd = hmp_info_name,
da76ee76
PB
454 },
455
456STEXI
457@item info name
458@findex name
459Show the current VM name.
460ETEXI
461
462 {
463 .name = "uuid",
464 .args_type = "",
465 .params = "",
466 .help = "show the current VM UUID",
2b9e3576 467 .cmd = hmp_info_uuid,
da76ee76
PB
468 },
469
470STEXI
471@item info uuid
472@findex uuid
473Show the current VM UUID.
474ETEXI
475
476 {
477 .name = "cpustats",
478 .args_type = "",
479 .params = "",
480 .help = "show CPU statistics",
2b9e3576 481 .cmd = hmp_info_cpustats,
da76ee76
PB
482 },
483
484STEXI
485@item info cpustats
486@findex cpustats
487Show CPU statistics.
488ETEXI
489
490#if defined(CONFIG_SLIRP)
491 {
492 .name = "usernet",
493 .args_type = "",
494 .params = "",
495 .help = "show user network stack connection states",
2b9e3576 496 .cmd = hmp_info_usernet,
da76ee76
PB
497 },
498#endif
499
500STEXI
501@item info usernet
502@findex usernet
503Show user network stack connection states.
504ETEXI
505
506 {
507 .name = "migrate",
508 .args_type = "",
509 .params = "",
510 .help = "show migration status",
2b9e3576 511 .cmd = hmp_info_migrate,
da76ee76
PB
512 },
513
514STEXI
515@item info migrate
516@findex migrate
517Show migration status.
518ETEXI
519
520 {
521 .name = "migrate_capabilities",
522 .args_type = "",
523 .params = "",
524 .help = "show current migration capabilities",
2b9e3576 525 .cmd = hmp_info_migrate_capabilities,
da76ee76
PB
526 },
527
528STEXI
529@item info migrate_capabilities
530@findex migrate_capabilities
531Show current migration capabilities.
532ETEXI
533
534 {
535 .name = "migrate_parameters",
536 .args_type = "",
537 .params = "",
538 .help = "show current migration parameters",
2b9e3576 539 .cmd = hmp_info_migrate_parameters,
da76ee76
PB
540 },
541
542STEXI
543@item info migrate_parameters
544@findex migrate_parameters
545Show current migration parameters.
546ETEXI
547
548 {
549 .name = "migrate_cache_size",
550 .args_type = "",
551 .params = "",
552 .help = "show current migration xbzrle cache size",
2b9e3576 553 .cmd = hmp_info_migrate_cache_size,
da76ee76
PB
554 },
555
556STEXI
557@item info migrate_cache_size
558@findex migrate_cache_size
559Show current migration xbzrle cache size.
560ETEXI
561
562 {
563 .name = "balloon",
564 .args_type = "",
565 .params = "",
566 .help = "show balloon information",
2b9e3576 567 .cmd = hmp_info_balloon,
da76ee76
PB
568 },
569
570STEXI
571@item info balloon
572@findex balloon
573Show balloon information.
574ETEXI
575
576 {
577 .name = "qtree",
578 .args_type = "",
579 .params = "",
580 .help = "show device tree",
2b9e3576 581 .cmd = hmp_info_qtree,
da76ee76
PB
582 },
583
584STEXI
585@item info qtree
586@findex qtree
587Show device tree.
588ETEXI
589
590 {
591 .name = "qdm",
592 .args_type = "",
593 .params = "",
594 .help = "show qdev device model list",
2b9e3576 595 .cmd = hmp_info_qdm,
da76ee76
PB
596 },
597
598STEXI
599@item info qdm
600@findex qdm
601Show qdev device model list.
602ETEXI
603
604 {
605 .name = "qom-tree",
606 .args_type = "path:s?",
607 .params = "[path]",
608 .help = "show QOM composition tree",
2b9e3576 609 .cmd = hmp_info_qom_tree,
da76ee76
PB
610 },
611
612STEXI
613@item info qom-tree
614@findex qom-tree
615Show QOM composition tree.
616ETEXI
617
618 {
619 .name = "roms",
620 .args_type = "",
621 .params = "",
622 .help = "show roms",
2b9e3576 623 .cmd = hmp_info_roms,
da76ee76
PB
624 },
625
626STEXI
627@item info roms
628@findex roms
629Show roms.
630ETEXI
631
632 {
633 .name = "trace-events",
77e2b172
LV
634 .args_type = "name:s?,vcpu:i?",
635 .params = "[name] [vcpu]",
bd71211d 636 .help = "show available trace-events & their state "
77e2b172 637 "(name: event name pattern; vcpu: vCPU to query, default is any)",
2b9e3576 638 .cmd = hmp_info_trace_events,
bd71211d 639 .command_completion = info_trace_events_completion,
da76ee76
PB
640 },
641
642STEXI
643@item info trace-events
644@findex trace-events
645Show available trace-events & their state.
646ETEXI
647
648 {
649 .name = "tpm",
650 .args_type = "",
651 .params = "",
652 .help = "show the TPM device",
2b9e3576 653 .cmd = hmp_info_tpm,
da76ee76
PB
654 },
655
656STEXI
657@item info tpm
658@findex tpm
659Show the TPM device.
660ETEXI
661
662 {
663 .name = "memdev",
664 .args_type = "",
665 .params = "",
666 .help = "show memory backends",
2b9e3576 667 .cmd = hmp_info_memdev,
da76ee76
PB
668 },
669
670STEXI
671@item info memdev
672@findex memdev
673Show memory backends
674ETEXI
675
676 {
677 .name = "memory-devices",
678 .args_type = "",
679 .params = "",
680 .help = "show memory devices",
2b9e3576 681 .cmd = hmp_info_memory_devices,
da76ee76
PB
682 },
683
684STEXI
685@item info memory-devices
686@findex memory-devices
687Show memory devices.
688ETEXI
689
690 {
691 .name = "iothreads",
692 .args_type = "",
693 .params = "",
694 .help = "show iothreads",
2b9e3576 695 .cmd = hmp_info_iothreads,
da76ee76
PB
696 },
697
698STEXI
699@item info iothreads
700@findex iothreads
701Show iothread's identifiers.
702ETEXI
703
704 {
705 .name = "rocker",
706 .args_type = "name:s",
707 .params = "name",
708 .help = "Show rocker switch",
2b9e3576 709 .cmd = hmp_rocker,
da76ee76
PB
710 },
711
712STEXI
713@item info rocker @var{name}
714@findex rocker
715Show rocker switch.
716ETEXI
717
718 {
719 .name = "rocker-ports",
720 .args_type = "name:s",
721 .params = "name",
722 .help = "Show rocker ports",
2b9e3576 723 .cmd = hmp_rocker_ports,
da76ee76
PB
724 },
725
726STEXI
727@item info rocker_ports @var{name}-ports
728@findex ocker-ports
729Show rocker ports.
730ETEXI
731
732 {
733 .name = "rocker-of-dpa-flows",
734 .args_type = "name:s,tbl_id:i?",
735 .params = "name [tbl_id]",
736 .help = "Show rocker OF-DPA flow tables",
2b9e3576 737 .cmd = hmp_rocker_of_dpa_flows,
da76ee76
PB
738 },
739
740STEXI
741@item info rocker_of_dpa_flows @var{name} [@var{tbl_id}]
742@findex rocker-of-dpa-flows
743Show rocker OF-DPA flow tables.
744ETEXI
745
746 {
747 .name = "rocker-of-dpa-groups",
748 .args_type = "name:s,type:i?",
749 .params = "name [type]",
750 .help = "Show rocker OF-DPA groups",
2b9e3576 751 .cmd = hmp_rocker_of_dpa_groups,
da76ee76
PB
752 },
753
754STEXI
755@item info rocker-of-dpa-groups @var{name} [@var{type}]
756@findex rocker-of-dpa-groups
757Show rocker OF-DPA groups.
758ETEXI
759
760#if defined(TARGET_S390X)
761 {
762 .name = "skeys",
763 .args_type = "addr:l",
764 .params = "address",
765 .help = "Display the value of a storage key",
2b9e3576 766 .cmd = hmp_info_skeys,
da76ee76
PB
767 },
768#endif
769
770STEXI
771@item info skeys @var{address}
772@findex skeys
773Display the value of a storage key (s390 only)
4a6b52d6
PX
774ETEXI
775
776 {
777 .name = "dump",
778 .args_type = "",
779 .params = "",
780 .help = "Display the latest dump status",
2b9e3576 781 .cmd = hmp_info_dump,
4a6b52d6
PX
782 },
783
784STEXI
785@item info dump
786@findex dump
787Display the latest dump status.
d2d8d46f
BR
788ETEXI
789
790 {
791 .name = "hotpluggable-cpus",
792 .args_type = "",
793 .params = "",
794 .help = "Show information about hotpluggable CPUs",
2b9e3576 795 .cmd = hmp_hotpluggable_cpus,
d2d8d46f
BR
796 },
797
798STEXI
799@item info hotpluggable-cpus
800@findex hotpluggable-cpus
801Show information about hotpluggable CPUs
da76ee76
PB
802ETEXI
803
39164c13
IM
804STEXI
805@item info vm-generation-id
806@findex vm-generation-id
807Show Virtual Machine Generation ID
808ETEXI
809
810 {
811 .name = "vm-generation-id",
812 .args_type = "",
813 .params = "",
814 .help = "Show Virtual Machine Generation ID",
815 .cmd = hmp_info_vm_generation_id,
816 },
817
da76ee76
PB
818STEXI
819@end table
820ETEXI
2cd8af2d
PB
821
822STEXI
823@end table
824ETEXI