1 HXCOMM Use DEFHEADING() to define headings in both help text and rST.
2 HXCOMM Text between SRST and ERST is copied to the rST version and
3 HXCOMM discarded from C version.
4 HXCOMM DEF(command, args, callback, arg_string, help) is used to construct
5 HXCOMM monitor info commands
6 HXCOMM HXCOMM can be used for comments, discarded from both rST and C.
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.
16 Show various information about the system state.
24 .help = "show the version of QEMU",
25 .cmd = hmp_info_version,
31 Show the version of QEMU.
38 .help = "show the network state",
39 .cmd = hmp_info_network,
44 Show the network state.
51 .help = "show the character devices",
52 .cmd = hmp_info_chardev,
58 Show the character devices.
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,
72 Show info of one block device or all block devices.
79 .help = "show block device statistics",
80 .cmd = hmp_info_blockstats,
85 Show block device statistics.
92 .help = "show progress of ongoing block device operations",
93 .cmd = hmp_info_block_jobs,
98 Show progress of ongoing block device operations.
103 .args_type = "cpustate_all:-a",
105 .help = "show the cpu registers (-a: all - show register info for all cpus)",
106 .cmd = hmp_info_registers,
111 Show the cpu registers.
114 #if defined(TARGET_I386)
117 .args_type = "apic-id:i?",
118 .params = "[apic-id]",
119 .help = "show local apic state (apic-id: local apic to read, default is which of current CPU)",
121 .cmd = hmp_info_local_apic,
127 Show local APIC state
130 #if defined(TARGET_I386)
135 .help = "show io apic state",
136 .cmd = hmp_info_io_apic,
149 .help = "show infos for each CPU",
150 .cmd = hmp_info_cpus,
155 Show infos for each CPU.
162 .help = "show the command line history",
163 .cmd = hmp_info_history,
169 Show the command line history.
176 .help = "show the interrupts statistics (if available)",
182 Show the interrupts statistics (if available).
189 .help = "show PIC state",
202 .help = "show RDMA state",
203 .cmd = hmp_info_rdma,
215 .help = "show PCI info",
221 Show PCI information.
224 #if defined(TARGET_I386) || defined(TARGET_SH4) || defined(TARGET_SPARC) || \
225 defined(TARGET_PPC) || defined(TARGET_XTENSA) || defined(TARGET_M68K)
230 .help = "show virtual to physical memory mappings",
237 Show virtual to physical memory mappings.
240 #if defined(TARGET_I386) || defined(TARGET_RISCV)
245 .help = "show the active virtual memory mappings",
252 Show the active virtual memory mappings.
257 .args_type = "flatview:-f,dispatch_tree:-d,owner:-o",
258 .params = "[-f][-d][-o]",
259 .help = "show memory tree (-f: dump flat view for address spaces;"
260 "-d: dump dispatch tree, valid with -f only);"
261 "-o: dump region owners/parents",
262 .cmd = hmp_info_mtree,
270 #if defined(CONFIG_TCG)
275 .help = "show dynamic compiler info",
282 Show dynamic compiler info.
285 #if defined(CONFIG_TCG)
290 .help = "show dynamic compiler opcode counters",
291 .cmd = hmp_info_opcount,
297 Show dynamic compiler opcode counters
301 .name = "sync-profile",
302 .args_type = "mean:-m,no_coalesce:-n,max:i?",
303 .params = "[-m] [-n] [max]",
304 .help = "show synchronization profiling info, up to max entries "
305 "(default: 10), sorted by total wait time. (-m: sort by "
306 "mean wait time; -n: do not coalesce objects with the "
308 .cmd = hmp_info_sync_profile,
312 ``info sync-profile [-m|-n]`` [*max*]
313 Show synchronization profiling info, up to *max* entries (default: 10),
314 sorted by total wait time.
317 sort by mean wait time
319 do not coalesce objects with the same call site
321 When different objects that share the same call site are coalesced,
322 the "Object" field shows---enclosed in brackets---the number of objects
330 .help = "show KVM information",
336 Show KVM information.
343 .help = "show NUMA information",
344 .cmd = hmp_info_numa,
349 Show NUMA information.
356 .help = "show guest USB devices",
362 Show guest USB devices.
369 .help = "show host USB devices",
370 .cmd = hmp_info_usbhost,
375 Show host USB devices.
382 .help = "show profiling information",
383 .cmd = hmp_info_profile,
388 Show profiling information.
395 .help = "show capture information",
396 .cmd = hmp_info_capture,
401 Show capture information.
408 .help = "show the currently saved VM snapshots",
409 .cmd = hmp_info_snapshots,
414 Show the currently saved VM snapshots.
421 .help = "show the current VM status (running|paused)",
422 .cmd = hmp_info_status,
428 Show the current VM status (running|paused).
435 .help = "show which guest mouse is receiving events",
436 .cmd = hmp_info_mice,
441 Show which guest mouse is receiving events.
444 #if defined(CONFIG_VNC)
449 .help = "show the vnc server status",
456 Show the vnc server status.
459 #if defined(CONFIG_SPICE)
464 .help = "show the spice server status",
465 .cmd = hmp_info_spice,
471 Show the spice server status.
478 .help = "show the current VM name",
479 .cmd = hmp_info_name,
485 Show the current VM name.
492 .help = "show the current VM UUID",
493 .cmd = hmp_info_uuid,
499 Show the current VM UUID.
506 .help = "show CPU statistics",
507 .cmd = hmp_info_cpustats,
515 #if defined(CONFIG_SLIRP)
520 .help = "show user network stack connection states",
521 .cmd = hmp_info_usernet,
527 Show user network stack connection states.
534 .help = "show migration status",
535 .cmd = hmp_info_migrate,
540 Show migration status.
544 .name = "migrate_capabilities",
547 .help = "show current migration capabilities",
548 .cmd = hmp_info_migrate_capabilities,
552 ``info migrate_capabilities``
553 Show current migration capabilities.
557 .name = "migrate_parameters",
560 .help = "show current migration parameters",
561 .cmd = hmp_info_migrate_parameters,
565 ``info migrate_parameters``
566 Show current migration parameters.
570 .name = "migrate_cache_size",
573 .help = "show current migration xbzrle cache size",
574 .cmd = hmp_info_migrate_cache_size,
578 ``info migrate_cache_size``
579 Show current migration xbzrle cache size.
586 .help = "show balloon information",
587 .cmd = hmp_info_balloon,
592 Show balloon information.
599 .help = "show device tree",
600 .cmd = hmp_info_qtree,
612 .help = "show qdev device model list",
618 Show qdev device model list.
623 .args_type = "path:s?",
625 .help = "show QOM composition tree",
626 .cmd = hmp_info_qom_tree,
632 Show QOM composition tree.
640 .cmd = hmp_info_roms,
649 .name = "trace-events",
650 .args_type = "name:s?,vcpu:i?",
651 .params = "[name] [vcpu]",
652 .help = "show available trace-events & their state "
653 "(name: event name pattern; vcpu: vCPU to query, default is any)",
654 .cmd = hmp_info_trace_events,
655 .command_completion = info_trace_events_completion,
659 ``info trace-events``
660 Show available trace-events & their state.
667 .help = "show the TPM device",
680 .help = "show memory backends",
681 .cmd = hmp_info_memdev,
691 .name = "memory-devices",
694 .help = "show memory devices",
695 .cmd = hmp_info_memory_devices,
699 ``info memory-devices``
707 .help = "show iothreads",
708 .cmd = hmp_info_iothreads,
714 Show iothread's identifiers.
719 .args_type = "name:s",
721 .help = "Show rocker switch",
726 ``info rocker`` *name*
731 .name = "rocker-ports",
732 .args_type = "name:s",
734 .help = "Show rocker ports",
735 .cmd = hmp_rocker_ports,
739 ``info rocker-ports`` *name*-ports
744 .name = "rocker-of-dpa-flows",
745 .args_type = "name:s,tbl_id:i?",
746 .params = "name [tbl_id]",
747 .help = "Show rocker OF-DPA flow tables",
748 .cmd = hmp_rocker_of_dpa_flows,
752 ``info rocker-of-dpa-flows`` *name* [*tbl_id*]
753 Show rocker OF-DPA flow tables.
757 .name = "rocker-of-dpa-groups",
758 .args_type = "name:s,type:i?",
759 .params = "name [type]",
760 .help = "Show rocker OF-DPA groups",
761 .cmd = hmp_rocker_of_dpa_groups,
765 ``info rocker-of-dpa-groups`` *name* [*type*]
766 Show rocker OF-DPA groups.
769 #if defined(TARGET_S390X)
772 .args_type = "addr:l",
774 .help = "Display the value of a storage key",
775 .cmd = hmp_info_skeys,
780 ``info skeys`` *address*
781 Display the value of a storage key (s390 only)
784 #if defined(TARGET_S390X)
787 .args_type = "addr:l,count:l?",
788 .params = "address [count]",
789 .help = "Display the values of the CMMA storage attributes for a range of pages",
790 .cmd = hmp_info_cmma,
795 ``info cmma`` *address*
796 Display the values of the CMMA storage attributes for a range of
804 .help = "Display the latest dump status",
805 .cmd = hmp_info_dump,
810 Display the latest dump status.
817 .help = "Display system ramblock information",
818 .cmd = hmp_info_ramblock,
823 Dump all the ramblocks of the system.
827 .name = "hotpluggable-cpus",
830 .help = "Show information about hotpluggable CPUs",
831 .cmd = hmp_hotpluggable_cpus,
836 ``info hotpluggable-cpus``
837 Show information about hotpluggable CPUs
841 .name = "vm-generation-id",
844 .help = "Show Virtual Machine Generation ID",
845 .cmd = hmp_info_vm_generation_id,
849 ``info vm-generation-id``
850 Show Virtual Machine Generation ID
854 .name = "memory_size_summary",
857 .help = "show the amount of initially allocated and "
858 "present hotpluggable (if enabled) memory in bytes.",
859 .cmd = hmp_info_memory_size_summary,
863 ``info memory_size_summary``
864 Display the amount of initially allocated and present hotpluggable (if
865 enabled) memory in bytes.
868 #if defined(TARGET_I386)
873 .help = "show SEV information",
880 Show SEV information.