]> git.proxmox.com Git - mirror_qemu.git/blob - hmp-commands-info.hx
20a9835ea8d63279506afdedecc905201505f6be
[mirror_qemu.git] / hmp-commands-info.hx
1 HXCOMM See docs/devel/docs.rst for the format of this file.
2 HXCOMM
3 HXCOMM This file defines the contents of an array of HMPCommand structs
4 HXCOMM which specify the name, behaviour and help text for HMP commands.
5 HXCOMM Text between SRST and ERST is rST format documentation.
6 HXCOMM HXCOMM can be used for comments, discarded from both rST and C.
7 HXCOMM
8 HXCOMM In this file, generally SRST fragments should have two extra
9 HXCOMM spaces of indent, so that the documentation list item for "info foo"
10 HXCOMM appears inside the documentation list item for the top level
11 HXCOMM "info" documentation entry. The exception is the first SRST
12 HXCOMM fragment that defines that top level entry.
13
14 SRST
15 ``info`` *subcommand*
16 Show various information about the system state.
17
18 ERST
19
20 {
21 .name = "version",
22 .args_type = "",
23 .params = "",
24 .help = "show the version of QEMU",
25 .cmd = hmp_info_version,
26 .flags = "p",
27 },
28
29 SRST
30 ``info version``
31 Show the version of QEMU.
32 ERST
33
34 {
35 .name = "network",
36 .args_type = "",
37 .params = "",
38 .help = "show the network state",
39 .cmd = hmp_info_network,
40 },
41
42 SRST
43 ``info network``
44 Show the network state.
45 ERST
46
47 {
48 .name = "chardev",
49 .args_type = "",
50 .params = "",
51 .help = "show the character devices",
52 .cmd = hmp_info_chardev,
53 .flags = "p",
54 },
55
56 SRST
57 ``info chardev``
58 Show the character devices.
59 ERST
60
61 {
62 .name = "block",
63 .args_type = "nodes:-n,verbose:-v,device:B?",
64 .params = "[-n] [-v] [device]",
65 .help = "show info of one block device or all block devices "
66 "(-n: show named nodes; -v: show details)",
67 .cmd = hmp_info_block,
68 },
69
70 SRST
71 ``info block``
72 Show info of one block device or all block devices.
73 ERST
74
75 {
76 .name = "blockstats",
77 .args_type = "",
78 .params = "",
79 .help = "show block device statistics",
80 .cmd = hmp_info_blockstats,
81 },
82
83 SRST
84 ``info blockstats``
85 Show block device statistics.
86 ERST
87
88 {
89 .name = "block-jobs",
90 .args_type = "",
91 .params = "",
92 .help = "show progress of ongoing block device operations",
93 .cmd = hmp_info_block_jobs,
94 },
95
96 SRST
97 ``info block-jobs``
98 Show progress of ongoing block device operations.
99 ERST
100
101 {
102 .name = "registers",
103 .args_type = "cpustate_all:-a,vcpu:i?",
104 .params = "[-a|vcpu]",
105 .help = "show the cpu registers (-a: show register info for all cpus;"
106 " vcpu: specific vCPU to query; show the current CPU's registers if"
107 " no argument is specified)",
108 .cmd = hmp_info_registers,
109 },
110
111 SRST
112 ``info registers``
113 Show the cpu registers.
114 ERST
115
116 #if defined(TARGET_I386)
117 {
118 .name = "lapic",
119 .args_type = "apic-id:i?",
120 .params = "[apic-id]",
121 .help = "show local apic state (apic-id: local apic to read, default is which of current CPU)",
122
123 .cmd = hmp_info_local_apic,
124 },
125 #endif
126
127 SRST
128 ``info lapic``
129 Show local APIC state
130 ERST
131
132 {
133 .name = "cpus",
134 .args_type = "",
135 .params = "",
136 .help = "show infos for each CPU",
137 .cmd = hmp_info_cpus,
138 },
139
140 SRST
141 ``info cpus``
142 Show infos for each CPU.
143 ERST
144
145 {
146 .name = "history",
147 .args_type = "",
148 .params = "",
149 .help = "show the command line history",
150 .cmd = hmp_info_history,
151 .flags = "p",
152 },
153
154 SRST
155 ``info history``
156 Show the command line history.
157 ERST
158
159 {
160 .name = "irq",
161 .args_type = "",
162 .params = "",
163 .help = "show the interrupts statistics (if available)",
164 .cmd_info_hrt = qmp_x_query_irq,
165 },
166
167 SRST
168 ``info irq``
169 Show the interrupts statistics (if available).
170 ERST
171
172 {
173 .name = "pic",
174 .args_type = "",
175 .params = "",
176 .help = "show PIC state",
177 .cmd = hmp_info_pic,
178 },
179
180 SRST
181 ``info pic``
182 Show PIC state.
183 ERST
184
185 {
186 .name = "pci",
187 .args_type = "",
188 .params = "",
189 .help = "show PCI info",
190 .cmd = hmp_info_pci,
191 },
192
193 SRST
194 ``info pci``
195 Show PCI information.
196 ERST
197
198 #if defined(TARGET_I386) || defined(TARGET_SH4) || defined(TARGET_SPARC) || \
199 defined(TARGET_PPC) || defined(TARGET_XTENSA) || defined(TARGET_M68K)
200 {
201 .name = "tlb",
202 .args_type = "",
203 .params = "",
204 .help = "show virtual to physical memory mappings",
205 .cmd = hmp_info_tlb,
206 },
207 #endif
208
209 SRST
210 ``info tlb``
211 Show virtual to physical memory mappings.
212 ERST
213
214 #if defined(TARGET_I386) || defined(TARGET_RISCV)
215 {
216 .name = "mem",
217 .args_type = "",
218 .params = "",
219 .help = "show the active virtual memory mappings",
220 .cmd = hmp_info_mem,
221 },
222 #endif
223
224 SRST
225 ``info mem``
226 Show the active virtual memory mappings.
227 ERST
228
229 {
230 .name = "mtree",
231 .args_type = "flatview:-f,dispatch_tree:-d,owner:-o,disabled:-D",
232 .params = "[-f][-d][-o][-D]",
233 .help = "show memory tree (-f: dump flat view for address spaces;"
234 "-d: dump dispatch tree, valid with -f only);"
235 "-o: dump region owners/parents;"
236 "-D: dump disabled regions",
237 .cmd = hmp_info_mtree,
238 },
239
240 SRST
241 ``info mtree``
242 Show memory tree.
243 ERST
244
245 #if defined(CONFIG_TCG)
246 {
247 .name = "jit",
248 .args_type = "",
249 .params = "",
250 .help = "show dynamic compiler info",
251 },
252 #endif
253
254 SRST
255 ``info jit``
256 Show dynamic compiler info.
257 ERST
258
259 #if defined(CONFIG_TCG)
260 {
261 .name = "opcount",
262 .args_type = "",
263 .params = "",
264 .help = "show dynamic compiler opcode counters",
265 },
266 #endif
267
268 SRST
269 ``info opcount``
270 Show dynamic compiler opcode counters
271 ERST
272
273 {
274 .name = "sync-profile",
275 .args_type = "mean:-m,no_coalesce:-n,max:i?",
276 .params = "[-m] [-n] [max]",
277 .help = "show synchronization profiling info, up to max entries "
278 "(default: 10), sorted by total wait time. (-m: sort by "
279 "mean wait time; -n: do not coalesce objects with the "
280 "same call site)",
281 .cmd = hmp_info_sync_profile,
282 },
283
284 SRST
285 ``info sync-profile [-m|-n]`` [*max*]
286 Show synchronization profiling info, up to *max* entries (default: 10),
287 sorted by total wait time.
288
289 ``-m``
290 sort by mean wait time
291 ``-n``
292 do not coalesce objects with the same call site
293
294 When different objects that share the same call site are coalesced,
295 the "Object" field shows---enclosed in brackets---the number of objects
296 being coalesced.
297 ERST
298
299 {
300 .name = "kvm",
301 .args_type = "",
302 .params = "",
303 .help = "show KVM information",
304 .cmd = hmp_info_kvm,
305 },
306
307 SRST
308 ``info kvm``
309 Show KVM information.
310 ERST
311
312 {
313 .name = "numa",
314 .args_type = "",
315 .params = "",
316 .help = "show NUMA information",
317 .cmd_info_hrt = qmp_x_query_numa,
318 },
319
320 SRST
321 ``info numa``
322 Show NUMA information.
323 ERST
324
325 {
326 .name = "usb",
327 .args_type = "",
328 .params = "",
329 .help = "show guest USB devices",
330 .cmd_info_hrt = qmp_x_query_usb,
331 },
332
333 SRST
334 ``info usb``
335 Show guest USB devices.
336 ERST
337
338 {
339 .name = "usbhost",
340 .args_type = "",
341 .params = "",
342 .help = "show host USB devices",
343 },
344
345 SRST
346 ``info usbhost``
347 Show host USB devices.
348 ERST
349
350 {
351 .name = "capture",
352 .args_type = "",
353 .params = "",
354 .help = "show capture information",
355 .cmd = hmp_info_capture,
356 },
357
358 SRST
359 ``info capture``
360 Show capture information.
361 ERST
362
363 {
364 .name = "snapshots",
365 .args_type = "",
366 .params = "",
367 .help = "show the currently saved VM snapshots",
368 .cmd = hmp_info_snapshots,
369 },
370
371 SRST
372 ``info snapshots``
373 Show the currently saved VM snapshots.
374 ERST
375
376 {
377 .name = "status",
378 .args_type = "",
379 .params = "",
380 .help = "show the current VM status (running|paused)",
381 .cmd = hmp_info_status,
382 .flags = "p",
383 },
384
385 SRST
386 ``info status``
387 Show the current VM status (running|paused).
388 ERST
389
390 {
391 .name = "mice",
392 .args_type = "",
393 .params = "",
394 .help = "show which guest mouse is receiving events",
395 .cmd = hmp_info_mice,
396 },
397
398 SRST
399 ``info mice``
400 Show which guest mouse is receiving events.
401 ERST
402
403 #if defined(CONFIG_VNC)
404 {
405 .name = "vnc",
406 .args_type = "",
407 .params = "",
408 .help = "show the vnc server status",
409 .cmd = hmp_info_vnc,
410 },
411 #endif
412
413 SRST
414 ``info vnc``
415 Show the vnc server status.
416 ERST
417
418 #if defined(CONFIG_SPICE)
419 {
420 .name = "spice",
421 .args_type = "",
422 .params = "",
423 .help = "show the spice server status",
424 .cmd = hmp_info_spice,
425 },
426 #endif
427
428 SRST
429 ``info spice``
430 Show the spice server status.
431 ERST
432
433 {
434 .name = "name",
435 .args_type = "",
436 .params = "",
437 .help = "show the current VM name",
438 .cmd = hmp_info_name,
439 .flags = "p",
440 },
441
442 SRST
443 ``info name``
444 Show the current VM name.
445 ERST
446
447 {
448 .name = "uuid",
449 .args_type = "",
450 .params = "",
451 .help = "show the current VM UUID",
452 .cmd = hmp_info_uuid,
453 .flags = "p",
454 },
455
456 SRST
457 ``info uuid``
458 Show the current VM UUID.
459 ERST
460
461 #if defined(CONFIG_SLIRP)
462 {
463 .name = "usernet",
464 .args_type = "",
465 .params = "",
466 .help = "show user network stack connection states",
467 .cmd = hmp_info_usernet,
468 },
469 #endif
470
471 SRST
472 ``info usernet``
473 Show user network stack connection states.
474 ERST
475
476 {
477 .name = "migrate",
478 .args_type = "",
479 .params = "",
480 .help = "show migration status",
481 .cmd = hmp_info_migrate,
482 },
483
484 SRST
485 ``info migrate``
486 Show migration status.
487 ERST
488
489 {
490 .name = "migrate_capabilities",
491 .args_type = "",
492 .params = "",
493 .help = "show current migration capabilities",
494 .cmd = hmp_info_migrate_capabilities,
495 },
496
497 SRST
498 ``info migrate_capabilities``
499 Show current migration capabilities.
500 ERST
501
502 {
503 .name = "migrate_parameters",
504 .args_type = "",
505 .params = "",
506 .help = "show current migration parameters",
507 .cmd = hmp_info_migrate_parameters,
508 },
509
510 SRST
511 ``info migrate_parameters``
512 Show current migration parameters.
513 ERST
514
515 {
516 .name = "balloon",
517 .args_type = "",
518 .params = "",
519 .help = "show balloon information",
520 .cmd = hmp_info_balloon,
521 },
522
523 SRST
524 ``info balloon``
525 Show balloon information.
526 ERST
527
528 {
529 .name = "qtree",
530 .args_type = "brief:-b",
531 .params = "[-b]",
532 .help = "show device tree (-b: brief, omit properties)",
533 .cmd = hmp_info_qtree,
534 },
535
536 SRST
537 ``info qtree``
538 Show device tree.
539 ERST
540
541 {
542 .name = "qdm",
543 .args_type = "",
544 .params = "",
545 .help = "show qdev device model list",
546 .cmd = hmp_info_qdm,
547 },
548
549 SRST
550 ``info qdm``
551 Show qdev device model list.
552 ERST
553
554 {
555 .name = "qom-tree",
556 .args_type = "path:s?",
557 .params = "[path]",
558 .help = "show QOM composition tree",
559 .cmd = hmp_info_qom_tree,
560 .flags = "p",
561 },
562
563 SRST
564 ``info qom-tree``
565 Show QOM composition tree.
566 ERST
567
568 {
569 .name = "roms",
570 .args_type = "",
571 .params = "",
572 .help = "show roms",
573 .cmd_info_hrt = qmp_x_query_roms,
574 },
575
576 SRST
577 ``info roms``
578 Show roms.
579 ERST
580
581 {
582 .name = "trace-events",
583 .args_type = "name:s?,vcpu:i?",
584 .params = "[name] [vcpu]",
585 .help = "show available trace-events & their state "
586 "(name: event name pattern; vcpu: vCPU to query, default is any)",
587 .cmd = hmp_info_trace_events,
588 .command_completion = info_trace_events_completion,
589 },
590
591 SRST
592 ``info trace-events``
593 Show available trace-events & their state.
594 ERST
595
596 {
597 .name = "tpm",
598 .args_type = "",
599 .params = "",
600 .help = "show the TPM device",
601 .cmd = hmp_info_tpm,
602 },
603
604 SRST
605 ``info tpm``
606 Show the TPM device.
607 ERST
608
609 {
610 .name = "memdev",
611 .args_type = "",
612 .params = "",
613 .help = "show memory backends",
614 .cmd = hmp_info_memdev,
615 .flags = "p",
616 },
617
618 SRST
619 ``info memdev``
620 Show memory backends
621 ERST
622
623 {
624 .name = "memory-devices",
625 .args_type = "",
626 .params = "",
627 .help = "show memory devices",
628 .cmd = hmp_info_memory_devices,
629 },
630
631 SRST
632 ``info memory-devices``
633 Show memory devices.
634 ERST
635
636 {
637 .name = "iothreads",
638 .args_type = "",
639 .params = "",
640 .help = "show iothreads",
641 .cmd = hmp_info_iothreads,
642 .flags = "p",
643 },
644
645 SRST
646 ``info iothreads``
647 Show iothread's identifiers.
648 ERST
649
650 {
651 .name = "rocker",
652 .args_type = "name:s",
653 .params = "name",
654 .help = "Show rocker switch",
655 .cmd = hmp_rocker,
656 },
657
658 SRST
659 ``info rocker`` *name*
660 Show rocker switch.
661 ERST
662
663 {
664 .name = "rocker-ports",
665 .args_type = "name:s",
666 .params = "name",
667 .help = "Show rocker ports",
668 .cmd = hmp_rocker_ports,
669 },
670
671 SRST
672 ``info rocker-ports`` *name*-ports
673 Show rocker ports.
674 ERST
675
676 {
677 .name = "rocker-of-dpa-flows",
678 .args_type = "name:s,tbl_id:i?",
679 .params = "name [tbl_id]",
680 .help = "Show rocker OF-DPA flow tables",
681 .cmd = hmp_rocker_of_dpa_flows,
682 },
683
684 SRST
685 ``info rocker-of-dpa-flows`` *name* [*tbl_id*]
686 Show rocker OF-DPA flow tables.
687 ERST
688
689 {
690 .name = "rocker-of-dpa-groups",
691 .args_type = "name:s,type:i?",
692 .params = "name [type]",
693 .help = "Show rocker OF-DPA groups",
694 .cmd = hmp_rocker_of_dpa_groups,
695 },
696
697 SRST
698 ``info rocker-of-dpa-groups`` *name* [*type*]
699 Show rocker OF-DPA groups.
700 ERST
701
702 #if defined(TARGET_S390X)
703 {
704 .name = "skeys",
705 .args_type = "addr:l",
706 .params = "address",
707 .help = "Display the value of a storage key",
708 .cmd = hmp_info_skeys,
709 },
710 #endif
711
712 SRST
713 ``info skeys`` *address*
714 Display the value of a storage key (s390 only)
715 ERST
716
717 #if defined(TARGET_S390X)
718 {
719 .name = "cmma",
720 .args_type = "addr:l,count:l?",
721 .params = "address [count]",
722 .help = "Display the values of the CMMA storage attributes for a range of pages",
723 .cmd = hmp_info_cmma,
724 },
725 #endif
726
727 SRST
728 ``info cmma`` *address*
729 Display the values of the CMMA storage attributes for a range of
730 pages (s390 only)
731 ERST
732
733 {
734 .name = "dump",
735 .args_type = "",
736 .params = "",
737 .help = "Display the latest dump status",
738 .cmd = hmp_info_dump,
739 },
740
741 SRST
742 ``info dump``
743 Display the latest dump status.
744 ERST
745
746 {
747 .name = "ramblock",
748 .args_type = "",
749 .params = "",
750 .help = "Display system ramblock information",
751 .cmd_info_hrt = qmp_x_query_ramblock,
752 },
753
754 SRST
755 ``info ramblock``
756 Dump all the ramblocks of the system.
757 ERST
758
759 {
760 .name = "hotpluggable-cpus",
761 .args_type = "",
762 .params = "",
763 .help = "Show information about hotpluggable CPUs",
764 .cmd = hmp_hotpluggable_cpus,
765 .flags = "p",
766 },
767
768 SRST
769 ``info hotpluggable-cpus``
770 Show information about hotpluggable CPUs
771 ERST
772
773 {
774 .name = "vm-generation-id",
775 .args_type = "",
776 .params = "",
777 .help = "Show Virtual Machine Generation ID",
778 .cmd = hmp_info_vm_generation_id,
779 },
780
781 SRST
782 ``info vm-generation-id``
783 Show Virtual Machine Generation ID
784 ERST
785
786 {
787 .name = "memory_size_summary",
788 .args_type = "",
789 .params = "",
790 .help = "show the amount of initially allocated and "
791 "present hotpluggable (if enabled) memory in bytes.",
792 .cmd = hmp_info_memory_size_summary,
793 },
794
795 SRST
796 ``info memory_size_summary``
797 Display the amount of initially allocated and present hotpluggable (if
798 enabled) memory in bytes.
799 ERST
800
801 #if defined(TARGET_I386)
802 {
803 .name = "sev",
804 .args_type = "",
805 .params = "",
806 .help = "show SEV information",
807 .cmd = hmp_info_sev,
808 },
809 #endif
810
811 SRST
812 ``info sev``
813 Show SEV information.
814 ERST
815
816 {
817 .name = "replay",
818 .args_type = "",
819 .params = "",
820 .help = "show record/replay information",
821 .cmd = hmp_info_replay,
822 },
823
824 SRST
825 ``info replay``
826 Display the record/replay information: mode and the current icount.
827 ERST
828
829 {
830 .name = "dirty_rate",
831 .args_type = "",
832 .params = "",
833 .help = "show dirty rate information",
834 .cmd = hmp_info_dirty_rate,
835 },
836
837 SRST
838 ``info dirty_rate``
839 Display the vcpu dirty rate information.
840 ERST
841
842 {
843 .name = "vcpu_dirty_limit",
844 .args_type = "",
845 .params = "",
846 .help = "show dirty page limit information of all vCPU",
847 .cmd = hmp_info_vcpu_dirty_limit,
848 },
849
850 SRST
851 ``info vcpu_dirty_limit``
852 Display the vcpu dirty page limit information.
853 ERST
854
855 #if defined(TARGET_I386)
856 {
857 .name = "sgx",
858 .args_type = "",
859 .params = "",
860 .help = "show intel SGX information",
861 .cmd = hmp_info_sgx,
862 },
863 #endif
864
865 SRST
866 ``info sgx``
867 Show intel SGX information.
868 ERST
869
870 #if defined(CONFIG_MOS6522)
871 {
872 .name = "via",
873 .args_type = "",
874 .params = "",
875 .help = "show guest mos6522 VIA devices",
876 .cmd = hmp_info_via,
877 },
878 #endif
879
880 SRST
881 ``info via``
882 Show guest mos6522 VIA devices.
883 ERST
884
885 {
886 .name = "stats",
887 .args_type = "target:s,names:s?,provider:s?",
888 .params = "target [names] [provider]",
889 .help = "show statistics for the given target (vm or vcpu); optionally filter by"
890 "name (comma-separated list, or * for all) and provider",
891 .cmd = hmp_info_stats,
892 },
893
894 SRST
895 ``stats``
896 Show runtime-collected statistics
897 ERST
898
899 {
900 .name = "virtio",
901 .args_type = "",
902 .params = "",
903 .help = "List all available virtio devices",
904 .cmd = hmp_virtio_query,
905 .flags = "p",
906 },
907
908 SRST
909 ``info virtio``
910 List all available virtio devices
911 ERST
912
913 {
914 .name = "virtio-status",
915 .args_type = "path:s",
916 .params = "path",
917 .help = "Display status of a given virtio device",
918 .cmd = hmp_virtio_status,
919 .flags = "p",
920 },
921
922 SRST
923 ``info virtio-status`` *path*
924 Display status of a given virtio device
925 ERST
926
927 {
928 .name = "virtio-queue-status",
929 .args_type = "path:s,queue:i",
930 .params = "path queue",
931 .help = "Display status of a given virtio queue",
932 .cmd = hmp_virtio_queue_status,
933 .flags = "p",
934 },
935
936 SRST
937 ``info virtio-queue-status`` *path* *queue*
938 Display status of a given virtio queue
939 ERST
940
941 {
942 .name = "virtio-vhost-queue-status",
943 .args_type = "path:s,queue:i",
944 .params = "path queue",
945 .help = "Display status of a given vhost queue",
946 .cmd = hmp_vhost_queue_status,
947 .flags = "p",
948 },
949
950 SRST
951 ``info virtio-vhost-queue-status`` *path* *queue*
952 Display status of a given vhost queue
953 ERST
954
955 {
956 .name = "virtio-queue-element",
957 .args_type = "path:s,queue:i,index:i?",
958 .params = "path queue [index]",
959 .help = "Display element of a given virtio queue",
960 .cmd = hmp_virtio_queue_element,
961 .flags = "p",
962 },
963
964 SRST
965 ``info virtio-queue-element`` *path* *queue* [*index*]
966 Display element of a given virtio queue
967 ERST
968
969 {
970 .name = "cryptodev",
971 .args_type = "",
972 .params = "",
973 .help = "show the crypto devices",
974 .cmd = hmp_info_cryptodev,
975 .flags = "p",
976 },
977
978 SRST
979 ``info cryptodev``
980 Show the crypto devices.
981 ERST