-HXCOMM Use DEFHEADING() to define headings in both help text and texi
-HXCOMM Text between STEXI and ETEXI are copied to texi version and
-HXCOMM discarded from C version
+HXCOMM Use DEFHEADING() to define headings in both help text and rST.
+HXCOMM Text between SRST and ERST is copied to the rST version and
+HXCOMM discarded from C version.
HXCOMM DEF(command, args, callback, arg_string, help) is used to construct
HXCOMM monitor info commands
-HXCOMM HXCOMM can be used for comments, discarded from both texi and C
+HXCOMM HXCOMM can be used for comments, discarded from both rST and C.
+HXCOMM
+HXCOMM In this file, generally SRST fragments should have two extra
+HXCOMM spaces of indent, so that the documentation list item for "info foo"
+HXCOMM appears inside the documentation list item for the top level
+HXCOMM "info" documentation entry. The exception is the first SRST
+HXCOMM fragment that defines that top level entry.
-STEXI
-@table @option
-@item info @var{subcommand}
-@findex info
-Show various information about the system state.
-@table @option
-ETEXI
+SRST
+``info`` *subcommand*
+ Show various information about the system state.
+
+ERST
{
.name = "version",
.params = "",
.help = "show the version of QEMU",
.cmd = hmp_info_version,
+ .flags = "p",
},
-STEXI
-@item info version
-@findex version
-Show the version of QEMU.
-ETEXI
+SRST
+ ``info version``
+ Show the version of QEMU.
+ERST
{
.name = "network",
.cmd = hmp_info_network,
},
-STEXI
-@item info network
-@findex network
-Show the network state.
-ETEXI
+SRST
+ ``info network``
+ Show the network state.
+ERST
{
.name = "chardev",
.params = "",
.help = "show the character devices",
.cmd = hmp_info_chardev,
+ .flags = "p",
},
-STEXI
-@item info chardev
-@findex chardev
-Show the character devices.
-ETEXI
+SRST
+ ``info chardev``
+ Show the character devices.
+ERST
{
.name = "block",
.cmd = hmp_info_block,
},
-STEXI
-@item info block
-@findex block
-Show info of one block device or all block devices.
-ETEXI
+SRST
+ ``info block``
+ Show info of one block device or all block devices.
+ERST
{
.name = "blockstats",
.cmd = hmp_info_blockstats,
},
-STEXI
-@item info blockstats
-@findex blockstats
-Show block device statistics.
-ETEXI
+SRST
+ ``info blockstats``
+ Show block device statistics.
+ERST
{
.name = "block-jobs",
.cmd = hmp_info_block_jobs,
},
-STEXI
-@item info block-jobs
-@findex block-jobs
-Show progress of ongoing block device operations.
-ETEXI
+SRST
+ ``info block-jobs``
+ Show progress of ongoing block device operations.
+ERST
{
.name = "registers",
.cmd = hmp_info_registers,
},
-STEXI
-@item info registers
-@findex registers
-Show the cpu registers.
-ETEXI
+SRST
+ ``info registers``
+ Show the cpu registers.
+ERST
#if defined(TARGET_I386)
{
},
#endif
-STEXI
-@item info lapic
-@findex lapic
-Show local APIC state
-ETEXI
+SRST
+ ``info lapic``
+ Show local APIC state
+ERST
#if defined(TARGET_I386)
{
},
#endif
-STEXI
-@item info ioapic
-@findex ioapic
-Show io APIC state
-ETEXI
+SRST
+ ``info ioapic``
+ Show io APIC state
+ERST
{
.name = "cpus",
.cmd = hmp_info_cpus,
},
-STEXI
-@item info cpus
-@findex cpus
-Show infos for each CPU.
-ETEXI
+SRST
+ ``info cpus``
+ Show infos for each CPU.
+ERST
{
.name = "history",
.params = "",
.help = "show the command line history",
.cmd = hmp_info_history,
+ .flags = "p",
},
-STEXI
-@item info history
-@findex history
-Show the command line history.
-ETEXI
+SRST
+ ``info history``
+ Show the command line history.
+ERST
{
.name = "irq",
.cmd = hmp_info_irq,
},
-STEXI
-@item info irq
-@findex irq
-Show the interrupts statistics (if available).
-ETEXI
+SRST
+ ``info irq``
+ Show the interrupts statistics (if available).
+ERST
{
.name = "pic",
.cmd = hmp_info_pic,
},
-STEXI
-@item info pic
-@findex pic
-Show i8259 (PIC) state.
-ETEXI
+SRST
+ ``info pic``
+ Show PIC state.
+ERST
+
+ {
+ .name = "rdma",
+ .args_type = "",
+ .params = "",
+ .help = "show RDMA state",
+ .cmd = hmp_info_rdma,
+ },
+
+SRST
+ ``info rdma``
+ Show RDMA state.
+ERST
{
.name = "pci",
.cmd = hmp_info_pci,
},
-STEXI
-@item info pci
-@findex pci
-Show PCI information.
-ETEXI
+SRST
+ ``info pci``
+ Show PCI information.
+ERST
#if defined(TARGET_I386) || defined(TARGET_SH4) || defined(TARGET_SPARC) || \
- defined(TARGET_PPC) || defined(TARGET_XTENSA)
+ defined(TARGET_PPC) || defined(TARGET_XTENSA) || defined(TARGET_M68K)
{
.name = "tlb",
.args_type = "",
},
#endif
-STEXI
-@item info tlb
-@findex tlb
-Show virtual to physical memory mappings.
-ETEXI
+SRST
+ ``info tlb``
+ Show virtual to physical memory mappings.
+ERST
-#if defined(TARGET_I386)
+#if defined(TARGET_I386) || defined(TARGET_RISCV)
{
.name = "mem",
.args_type = "",
},
#endif
-STEXI
-@item info mem
-@findex mem
-Show the active virtual memory mappings.
-ETEXI
+SRST
+ ``info mem``
+ Show the active virtual memory mappings.
+ERST
{
.name = "mtree",
- .args_type = "flatview:-f,dispatch_tree:-d",
- .params = "[-f][-d]",
+ .args_type = "flatview:-f,dispatch_tree:-d,owner:-o,disabled:-D",
+ .params = "[-f][-d][-o][-D]",
.help = "show memory tree (-f: dump flat view for address spaces;"
- "-d: dump dispatch tree, valid with -f only)",
+ "-d: dump dispatch tree, valid with -f only);"
+ "-o: dump region owners/parents;"
+ "-D: dump disabled regions",
.cmd = hmp_info_mtree,
},
-STEXI
-@item info mtree
-@findex mtree
-Show memory tree.
-ETEXI
+SRST
+ ``info mtree``
+ Show memory tree.
+ERST
#if defined(CONFIG_TCG)
{
.args_type = "",
.params = "",
.help = "show dynamic compiler info",
- .cmd = hmp_info_jit,
},
#endif
-STEXI
-@item info jit
-@findex jit
-Show dynamic compiler info.
-ETEXI
+SRST
+ ``info jit``
+ Show dynamic compiler info.
+ERST
#if defined(CONFIG_TCG)
{
.args_type = "",
.params = "",
.help = "show dynamic compiler opcode counters",
- .cmd = hmp_info_opcount,
},
#endif
-STEXI
-@item info opcount
-@findex opcount
-Show dynamic compiler opcode counters
-ETEXI
+SRST
+ ``info opcount``
+ Show dynamic compiler opcode counters
+ERST
+
+ {
+ .name = "sync-profile",
+ .args_type = "mean:-m,no_coalesce:-n,max:i?",
+ .params = "[-m] [-n] [max]",
+ .help = "show synchronization profiling info, up to max entries "
+ "(default: 10), sorted by total wait time. (-m: sort by "
+ "mean wait time; -n: do not coalesce objects with the "
+ "same call site)",
+ .cmd = hmp_info_sync_profile,
+ },
+
+SRST
+ ``info sync-profile [-m|-n]`` [*max*]
+ Show synchronization profiling info, up to *max* entries (default: 10),
+ sorted by total wait time.
+
+ ``-m``
+ sort by mean wait time
+ ``-n``
+ do not coalesce objects with the same call site
+
+ When different objects that share the same call site are coalesced,
+ the "Object" field shows---enclosed in brackets---the number of objects
+ being coalesced.
+ERST
{
.name = "kvm",
.cmd = hmp_info_kvm,
},
-STEXI
-@item info kvm
-@findex kvm
-Show KVM information.
-ETEXI
+SRST
+ ``info kvm``
+ Show KVM information.
+ERST
{
.name = "numa",
.cmd = hmp_info_numa,
},
-STEXI
-@item info numa
-@findex numa
-Show NUMA information.
-ETEXI
+SRST
+ ``info numa``
+ Show NUMA information.
+ERST
{
.name = "usb",
.cmd = hmp_info_usb,
},
-STEXI
-@item info usb
-@findex usb
-Show guest USB devices.
-ETEXI
+SRST
+ ``info usb``
+ Show guest USB devices.
+ERST
{
.name = "usbhost",
.args_type = "",
.params = "",
.help = "show host USB devices",
- .cmd = hmp_info_usbhost,
},
-STEXI
-@item info usbhost
-@findex usbhost
-Show host USB devices.
-ETEXI
+SRST
+ ``info usbhost``
+ Show host USB devices.
+ERST
{
.name = "profile",
.cmd = hmp_info_profile,
},
-STEXI
-@item info profile
-@findex profile
-Show profiling information.
-ETEXI
+SRST
+ ``info profile``
+ Show profiling information.
+ERST
{
.name = "capture",
.cmd = hmp_info_capture,
},
-STEXI
-@item info capture
-@findex capture
-Show capture information.
-ETEXI
+SRST
+ ``info capture``
+ Show capture information.
+ERST
{
.name = "snapshots",
.cmd = hmp_info_snapshots,
},
-STEXI
-@item info snapshots
-@findex snapshots
-Show the currently saved VM snapshots.
-ETEXI
+SRST
+ ``info snapshots``
+ Show the currently saved VM snapshots.
+ERST
{
.name = "status",
.params = "",
.help = "show the current VM status (running|paused)",
.cmd = hmp_info_status,
+ .flags = "p",
},
-STEXI
-@item info status
-@findex status
-Show the current VM status (running|paused).
-ETEXI
+SRST
+ ``info status``
+ Show the current VM status (running|paused).
+ERST
{
.name = "mice",
.cmd = hmp_info_mice,
},
-STEXI
-@item info mice
-@findex mice
-Show which guest mouse is receiving events.
-ETEXI
+SRST
+ ``info mice``
+ Show which guest mouse is receiving events.
+ERST
+#if defined(CONFIG_VNC)
{
.name = "vnc",
.args_type = "",
.help = "show the vnc server status",
.cmd = hmp_info_vnc,
},
+#endif
-STEXI
-@item info vnc
-@findex vnc
-Show the vnc server status.
-ETEXI
+SRST
+ ``info vnc``
+ Show the vnc server status.
+ERST
#if defined(CONFIG_SPICE)
{
},
#endif
-STEXI
-@item info spice
-@findex spice
-Show the spice server status.
-ETEXI
+SRST
+ ``info spice``
+ Show the spice server status.
+ERST
{
.name = "name",
.params = "",
.help = "show the current VM name",
.cmd = hmp_info_name,
+ .flags = "p",
},
-STEXI
-@item info name
-@findex name
-Show the current VM name.
-ETEXI
+SRST
+ ``info name``
+ Show the current VM name.
+ERST
{
.name = "uuid",
.params = "",
.help = "show the current VM UUID",
.cmd = hmp_info_uuid,
+ .flags = "p",
},
-STEXI
-@item info uuid
-@findex uuid
-Show the current VM UUID.
-ETEXI
-
- {
- .name = "cpustats",
- .args_type = "",
- .params = "",
- .help = "show CPU statistics",
- .cmd = hmp_info_cpustats,
- },
-
-STEXI
-@item info cpustats
-@findex cpustats
-Show CPU statistics.
-ETEXI
+SRST
+ ``info uuid``
+ Show the current VM UUID.
+ERST
#if defined(CONFIG_SLIRP)
{
},
#endif
-STEXI
-@item info usernet
-@findex usernet
-Show user network stack connection states.
-ETEXI
+SRST
+ ``info usernet``
+ Show user network stack connection states.
+ERST
{
.name = "migrate",
.cmd = hmp_info_migrate,
},
-STEXI
-@item info migrate
-@findex migrate
-Show migration status.
-ETEXI
+SRST
+ ``info migrate``
+ Show migration status.
+ERST
{
.name = "migrate_capabilities",
.cmd = hmp_info_migrate_capabilities,
},
-STEXI
-@item info migrate_capabilities
-@findex migrate_capabilities
-Show current migration capabilities.
-ETEXI
+SRST
+ ``info migrate_capabilities``
+ Show current migration capabilities.
+ERST
{
.name = "migrate_parameters",
.cmd = hmp_info_migrate_parameters,
},
-STEXI
-@item info migrate_parameters
-@findex migrate_parameters
-Show current migration parameters.
-ETEXI
-
- {
- .name = "migrate_cache_size",
- .args_type = "",
- .params = "",
- .help = "show current migration xbzrle cache size",
- .cmd = hmp_info_migrate_cache_size,
- },
-
-STEXI
-@item info migrate_cache_size
-@findex migrate_cache_size
-Show current migration xbzrle cache size.
-ETEXI
+SRST
+ ``info migrate_parameters``
+ Show current migration parameters.
+ERST
{
.name = "balloon",
.cmd = hmp_info_balloon,
},
-STEXI
-@item info balloon
-@findex balloon
-Show balloon information.
-ETEXI
+SRST
+ ``info balloon``
+ Show balloon information.
+ERST
{
.name = "qtree",
.cmd = hmp_info_qtree,
},
-STEXI
-@item info qtree
-@findex qtree
-Show device tree.
-ETEXI
+SRST
+ ``info qtree``
+ Show device tree.
+ERST
{
.name = "qdm",
.cmd = hmp_info_qdm,
},
-STEXI
-@item info qdm
-@findex qdm
-Show qdev device model list.
-ETEXI
+SRST
+ ``info qdm``
+ Show qdev device model list.
+ERST
{
.name = "qom-tree",
.params = "[path]",
.help = "show QOM composition tree",
.cmd = hmp_info_qom_tree,
+ .flags = "p",
},
-STEXI
-@item info qom-tree
-@findex qom-tree
-Show QOM composition tree.
-ETEXI
+SRST
+ ``info qom-tree``
+ Show QOM composition tree.
+ERST
{
.name = "roms",
.cmd = hmp_info_roms,
},
-STEXI
-@item info roms
-@findex roms
-Show roms.
-ETEXI
+SRST
+ ``info roms``
+ Show roms.
+ERST
{
.name = "trace-events",
.command_completion = info_trace_events_completion,
},
-STEXI
-@item info trace-events
-@findex trace-events
-Show available trace-events & their state.
-ETEXI
+SRST
+ ``info trace-events``
+ Show available trace-events & their state.
+ERST
{
.name = "tpm",
.cmd = hmp_info_tpm,
},
-STEXI
-@item info tpm
-@findex tpm
-Show the TPM device.
-ETEXI
+SRST
+ ``info tpm``
+ Show the TPM device.
+ERST
{
.name = "memdev",
.params = "",
.help = "show memory backends",
.cmd = hmp_info_memdev,
+ .flags = "p",
},
-STEXI
-@item info memdev
-@findex memdev
-Show memory backends
-ETEXI
+SRST
+ ``info memdev``
+ Show memory backends
+ERST
{
.name = "memory-devices",
.cmd = hmp_info_memory_devices,
},
-STEXI
-@item info memory-devices
-@findex memory-devices
-Show memory devices.
-ETEXI
+SRST
+ ``info memory-devices``
+ Show memory devices.
+ERST
{
.name = "iothreads",
.params = "",
.help = "show iothreads",
.cmd = hmp_info_iothreads,
+ .flags = "p",
},
-STEXI
-@item info iothreads
-@findex iothreads
-Show iothread's identifiers.
-ETEXI
+SRST
+ ``info iothreads``
+ Show iothread's identifiers.
+ERST
{
.name = "rocker",
.cmd = hmp_rocker,
},
-STEXI
-@item info rocker @var{name}
-@findex rocker
-Show rocker switch.
-ETEXI
+SRST
+ ``info rocker`` *name*
+ Show rocker switch.
+ERST
{
.name = "rocker-ports",
.cmd = hmp_rocker_ports,
},
-STEXI
-@item info rocker_ports @var{name}-ports
-@findex ocker-ports
-Show rocker ports.
-ETEXI
+SRST
+ ``info rocker-ports`` *name*-ports
+ Show rocker ports.
+ERST
{
.name = "rocker-of-dpa-flows",
.cmd = hmp_rocker_of_dpa_flows,
},
-STEXI
-@item info rocker_of_dpa_flows @var{name} [@var{tbl_id}]
-@findex rocker-of-dpa-flows
-Show rocker OF-DPA flow tables.
-ETEXI
+SRST
+ ``info rocker-of-dpa-flows`` *name* [*tbl_id*]
+ Show rocker OF-DPA flow tables.
+ERST
{
.name = "rocker-of-dpa-groups",
.cmd = hmp_rocker_of_dpa_groups,
},
-STEXI
-@item info rocker-of-dpa-groups @var{name} [@var{type}]
-@findex rocker-of-dpa-groups
-Show rocker OF-DPA groups.
-ETEXI
+SRST
+ ``info rocker-of-dpa-groups`` *name* [*type*]
+ Show rocker OF-DPA groups.
+ERST
#if defined(TARGET_S390X)
{
},
#endif
-STEXI
-@item info skeys @var{address}
-@findex skeys
-Display the value of a storage key (s390 only)
-ETEXI
+SRST
+ ``info skeys`` *address*
+ Display the value of a storage key (s390 only)
+ERST
#if defined(TARGET_S390X)
{
},
#endif
-STEXI
-@item info cmma @var{address}
-@findex cmma
-Display the values of the CMMA storage attributes for a range of pages (s390 only)
-ETEXI
+SRST
+ ``info cmma`` *address*
+ Display the values of the CMMA storage attributes for a range of
+ pages (s390 only)
+ERST
{
.name = "dump",
.cmd = hmp_info_dump,
},
-STEXI
-@item info dump
-@findex dump
-Display the latest dump status.
-ETEXI
+SRST
+ ``info dump``
+ Display the latest dump status.
+ERST
{
.name = "ramblock",
.cmd = hmp_info_ramblock,
},
-STEXI
-@item info ramblock
-@findex ramblock
-Dump all the ramblocks of the system.
-ETEXI
+SRST
+ ``info ramblock``
+ Dump all the ramblocks of the system.
+ERST
{
.name = "hotpluggable-cpus",
.params = "",
.help = "Show information about hotpluggable CPUs",
.cmd = hmp_hotpluggable_cpus,
+ .flags = "p",
},
-STEXI
-@item info hotpluggable-cpus
-@findex hotpluggable-cpus
-Show information about hotpluggable CPUs
-ETEXI
-
-STEXI
-@item info vm-generation-id
-@findex vm-generation-id
-Show Virtual Machine Generation ID
-ETEXI
+SRST
+ ``info hotpluggable-cpus``
+ Show information about hotpluggable CPUs
+ERST
{
.name = "vm-generation-id",
.cmd = hmp_info_vm_generation_id,
},
-STEXI
-@item info memory_size_summary
-@findex memory_size_summary
-Display the amount of initially allocated and present hotpluggable (if
-enabled) memory in bytes.
-ETEXI
+SRST
+ ``info vm-generation-id``
+ Show Virtual Machine Generation ID
+ERST
{
.name = "memory_size_summary",
.cmd = hmp_info_memory_size_summary,
},
-STEXI
-@end table
-ETEXI
+SRST
+ ``info memory_size_summary``
+ Display the amount of initially allocated and present hotpluggable (if
+ enabled) memory in bytes.
+ERST
+
+#if defined(TARGET_I386)
+ {
+ .name = "sev",
+ .args_type = "",
+ .params = "",
+ .help = "show SEV information",
+ .cmd = hmp_info_sev,
+ },
+#endif
+
+SRST
+ ``info sev``
+ Show SEV information.
+ERST
+
+ {
+ .name = "replay",
+ .args_type = "",
+ .params = "",
+ .help = "show record/replay information",
+ .cmd = hmp_info_replay,
+ },
+
+SRST
+ ``info replay``
+ Display the record/replay information: mode and the current icount.
+ERST
+
+ {
+ .name = "dirty_rate",
+ .args_type = "",
+ .params = "",
+ .help = "show dirty rate information",
+ .cmd = hmp_info_dirty_rate,
+ },
+
+SRST
+ ``info dirty_rate``
+ Display the vcpu dirty rate information.
+ERST
+
+#if defined(TARGET_I386)
+ {
+ .name = "sgx",
+ .args_type = "",
+ .params = "",
+ .help = "show intel SGX information",
+ .cmd = hmp_info_sgx,
+ },
+#endif
-STEXI
-@end table
-ETEXI
+SRST
+ ``info sgx``
+ Show intel SGX information.
+ERST