2cd8af2d44
It will be easier if you need to add info-commands to edit only hmp-commands-info.hx, before this had to edit monitor.c and hmp-commands.hx. From the build point of view all documentation is saved into qemu-monitor-info.texi which from now on is used for all user documentation building. Signed-off-by: Pavel Butsykin <pbutsykin@virtuozzo.com> Signed-off-by: Denis V. Lunev <den@openvz.org> CC: Paolo Bonzini <pbonzini@redhat.com> CC: Peter Maydell <peter.maydell@linaro.org> Message-Id: <1441899541-1856-5-git-send-email-den@openvz.org> Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>
750 lines
15 KiB
Haxe
750 lines
15 KiB
Haxe
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 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
|
|
|
|
STEXI
|
|
@table @option
|
|
@item info @var{subcommand}
|
|
@findex info
|
|
Show various information about the system state.
|
|
@table @option
|
|
ETEXI
|
|
|
|
{
|
|
.name = "version",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the version of QEMU",
|
|
.mhandler.cmd = hmp_info_version,
|
|
},
|
|
|
|
STEXI
|
|
@item info version
|
|
@findex version
|
|
Show the version of QEMU.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "network",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the network state",
|
|
.mhandler.cmd = hmp_info_network,
|
|
},
|
|
|
|
STEXI
|
|
@item info network
|
|
@findex network
|
|
Show the network state.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "chardev",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the character devices",
|
|
.mhandler.cmd = hmp_info_chardev,
|
|
},
|
|
|
|
STEXI
|
|
@item info chardev
|
|
@findex chardev
|
|
Show the character devices.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "block",
|
|
.args_type = "nodes:-n,verbose:-v,device:B?",
|
|
.params = "[-n] [-v] [device]",
|
|
.help = "show info of one block device or all block devices "
|
|
"(-n: show named nodes; -v: show details)",
|
|
.mhandler.cmd = hmp_info_block,
|
|
},
|
|
|
|
STEXI
|
|
@item info block
|
|
@findex block
|
|
Show info of one block device or all block devices.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "blockstats",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show block device statistics",
|
|
.mhandler.cmd = hmp_info_blockstats,
|
|
},
|
|
|
|
STEXI
|
|
@item info blockstats
|
|
@findex blockstats
|
|
Show block device statistics.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "block-jobs",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show progress of ongoing block device operations",
|
|
.mhandler.cmd = hmp_info_block_jobs,
|
|
},
|
|
|
|
STEXI
|
|
@item info block-jobs
|
|
@findex block-jobs
|
|
Show progress of ongoing block device operations.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "registers",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the cpu registers",
|
|
.mhandler.cmd = hmp_info_registers,
|
|
},
|
|
|
|
STEXI
|
|
@item info registers
|
|
@findex registers
|
|
Show the cpu registers.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "cpus",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show infos for each CPU",
|
|
.mhandler.cmd = hmp_info_cpus,
|
|
},
|
|
|
|
STEXI
|
|
@item info cpus
|
|
@findex cpus
|
|
Show infos for each CPU.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "history",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the command line history",
|
|
.mhandler.cmd = hmp_info_history,
|
|
},
|
|
|
|
STEXI
|
|
@item info history
|
|
@findex history
|
|
Show the command line history.
|
|
ETEXI
|
|
|
|
#if defined(TARGET_I386) || defined(TARGET_PPC) || defined(TARGET_MIPS) || \
|
|
defined(TARGET_LM32) || (defined(TARGET_SPARC) && !defined(TARGET_SPARC64))
|
|
{
|
|
.name = "irq",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the interrupts statistics (if available)",
|
|
#ifdef TARGET_SPARC
|
|
.mhandler.cmd = sun4m_hmp_info_irq,
|
|
#elif defined(TARGET_LM32)
|
|
.mhandler.cmd = lm32_hmp_info_irq,
|
|
#else
|
|
.mhandler.cmd = hmp_info_irq,
|
|
#endif
|
|
},
|
|
|
|
STEXI
|
|
@item info irq
|
|
@findex irq
|
|
Show the interrupts statistics (if available).
|
|
ETEXI
|
|
|
|
{
|
|
.name = "pic",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show i8259 (PIC) state",
|
|
#ifdef TARGET_SPARC
|
|
.mhandler.cmd = sun4m_hmp_info_pic,
|
|
#elif defined(TARGET_LM32)
|
|
.mhandler.cmd = lm32_hmp_info_pic,
|
|
#else
|
|
.mhandler.cmd = hmp_info_pic,
|
|
#endif
|
|
},
|
|
#endif
|
|
|
|
STEXI
|
|
@item info pic
|
|
@findex pic
|
|
Show i8259 (PIC) state.
|
|
ETEXI
|
|
|
|
#if defined(TARGET_I386) || defined(TARGET_SH4) || defined(TARGET_SPARC) || \
|
|
defined(TARGET_PPC) || defined(TARGET_XTENSA)
|
|
{
|
|
.name = "tlb",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show virtual to physical memory mappings",
|
|
.mhandler.cmd = hmp_info_tlb,
|
|
},
|
|
#endif
|
|
|
|
STEXI
|
|
@item info tlb
|
|
@findex tlb
|
|
Show virtual to physical memory mappings.
|
|
ETEXI
|
|
|
|
#if defined(TARGET_I386)
|
|
{
|
|
.name = "mem",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the active virtual memory mappings",
|
|
.mhandler.cmd = hmp_info_mem,
|
|
},
|
|
#endif
|
|
|
|
STEXI
|
|
@item info mem
|
|
@findex mem
|
|
Show the active virtual memory mappings.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "mtree",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show memory tree",
|
|
.mhandler.cmd = hmp_info_mtree,
|
|
},
|
|
|
|
STEXI
|
|
@item info mtree
|
|
@findex mtree
|
|
Show memory tree.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "jit",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show dynamic compiler info",
|
|
.mhandler.cmd = hmp_info_jit,
|
|
},
|
|
|
|
STEXI
|
|
@item info jit
|
|
@findex jit
|
|
Show dynamic compiler info.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "opcount",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show dynamic compiler opcode counters",
|
|
.mhandler.cmd = hmp_info_opcount,
|
|
},
|
|
|
|
STEXI
|
|
@item info opcount
|
|
@findex opcount
|
|
Show dynamic compiler opcode counters
|
|
ETEXI
|
|
|
|
{
|
|
.name = "kvm",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show KVM information",
|
|
.mhandler.cmd = hmp_info_kvm,
|
|
},
|
|
|
|
STEXI
|
|
@item info kvm
|
|
@findex kvm
|
|
Show KVM information.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "numa",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show NUMA information",
|
|
.mhandler.cmd = hmp_info_numa,
|
|
},
|
|
|
|
STEXI
|
|
@item info numa
|
|
@findex numa
|
|
Show NUMA information.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "usb",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show guest USB devices",
|
|
.mhandler.cmd = hmp_info_usb,
|
|
},
|
|
|
|
STEXI
|
|
@item info usb
|
|
@findex usb
|
|
Show guest USB devices.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "usbhost",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show host USB devices",
|
|
.mhandler.cmd = hmp_info_usbhost,
|
|
},
|
|
|
|
STEXI
|
|
@item info usbhost
|
|
@findex usbhost
|
|
Show host USB devices.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "profile",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show profiling information",
|
|
.mhandler.cmd = hmp_info_profile,
|
|
},
|
|
|
|
STEXI
|
|
@item info profile
|
|
@findex profile
|
|
Show profiling information.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "capture",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show capture information",
|
|
.mhandler.cmd = hmp_info_capture,
|
|
},
|
|
|
|
STEXI
|
|
@item info capture
|
|
@findex capture
|
|
Show capture information.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "snapshots",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the currently saved VM snapshots",
|
|
.mhandler.cmd = hmp_info_snapshots,
|
|
},
|
|
|
|
STEXI
|
|
@item info snapshots
|
|
@findex snapshots
|
|
Show the currently saved VM snapshots.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "status",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the current VM status (running|paused)",
|
|
.mhandler.cmd = hmp_info_status,
|
|
},
|
|
|
|
STEXI
|
|
@item info status
|
|
@findex status
|
|
Show the current VM status (running|paused).
|
|
ETEXI
|
|
|
|
{
|
|
.name = "mice",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show which guest mouse is receiving events",
|
|
.mhandler.cmd = hmp_info_mice,
|
|
},
|
|
|
|
STEXI
|
|
@item info mice
|
|
@findex mice
|
|
Show which guest mouse is receiving events.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "vnc",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the vnc server status",
|
|
.mhandler.cmd = hmp_info_vnc,
|
|
},
|
|
|
|
STEXI
|
|
@item info vnc
|
|
@findex vnc
|
|
Show the vnc server status.
|
|
ETEXI
|
|
|
|
#if defined(CONFIG_SPICE)
|
|
{
|
|
.name = "spice",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the spice server status",
|
|
.mhandler.cmd = hmp_info_spice,
|
|
},
|
|
#endif
|
|
|
|
STEXI
|
|
@item info spice
|
|
@findex spice
|
|
Show the spice server status.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "name",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the current VM name",
|
|
.mhandler.cmd = hmp_info_name,
|
|
},
|
|
|
|
STEXI
|
|
@item info name
|
|
@findex name
|
|
Show the current VM name.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "uuid",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the current VM UUID",
|
|
.mhandler.cmd = hmp_info_uuid,
|
|
},
|
|
|
|
STEXI
|
|
@item info uuid
|
|
@findex uuid
|
|
Show the current VM UUID.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "cpustats",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show CPU statistics",
|
|
.mhandler.cmd = hmp_info_cpustats,
|
|
},
|
|
|
|
STEXI
|
|
@item info cpustats
|
|
@findex cpustats
|
|
Show CPU statistics.
|
|
ETEXI
|
|
|
|
#if defined(CONFIG_SLIRP)
|
|
{
|
|
.name = "usernet",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show user network stack connection states",
|
|
.mhandler.cmd = hmp_info_usernet,
|
|
},
|
|
#endif
|
|
|
|
STEXI
|
|
@item info usernet
|
|
@findex usernet
|
|
Show user network stack connection states.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "migrate",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show migration status",
|
|
.mhandler.cmd = hmp_info_migrate,
|
|
},
|
|
|
|
STEXI
|
|
@item info migrate
|
|
@findex migrate
|
|
Show migration status.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "migrate_capabilities",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show current migration capabilities",
|
|
.mhandler.cmd = hmp_info_migrate_capabilities,
|
|
},
|
|
|
|
STEXI
|
|
@item info migrate_capabilities
|
|
@findex migrate_capabilities
|
|
Show current migration capabilities.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "migrate_parameters",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show current migration parameters",
|
|
.mhandler.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",
|
|
.mhandler.cmd = hmp_info_migrate_cache_size,
|
|
},
|
|
|
|
STEXI
|
|
@item info migrate_cache_size
|
|
@findex migrate_cache_size
|
|
Show current migration xbzrle cache size.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "balloon",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show balloon information",
|
|
.mhandler.cmd = hmp_info_balloon,
|
|
},
|
|
|
|
STEXI
|
|
@item info balloon
|
|
@findex balloon
|
|
Show balloon information.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "qtree",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show device tree",
|
|
.mhandler.cmd = hmp_info_qtree,
|
|
},
|
|
|
|
STEXI
|
|
@item info qtree
|
|
@findex qtree
|
|
Show device tree.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "qdm",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show qdev device model list",
|
|
.mhandler.cmd = hmp_info_qdm,
|
|
},
|
|
|
|
STEXI
|
|
@item info qdm
|
|
@findex qdm
|
|
Show qdev device model list.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "qom-tree",
|
|
.args_type = "path:s?",
|
|
.params = "[path]",
|
|
.help = "show QOM composition tree",
|
|
.mhandler.cmd = hmp_info_qom_tree,
|
|
},
|
|
|
|
STEXI
|
|
@item info qom-tree
|
|
@findex qom-tree
|
|
Show QOM composition tree.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "roms",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show roms",
|
|
.mhandler.cmd = hmp_info_roms,
|
|
},
|
|
|
|
STEXI
|
|
@item info roms
|
|
@findex roms
|
|
Show roms.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "trace-events",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show available trace-events & their state",
|
|
.mhandler.cmd = hmp_info_trace_events,
|
|
},
|
|
|
|
STEXI
|
|
@item info trace-events
|
|
@findex trace-events
|
|
Show available trace-events & their state.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "tpm",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show the TPM device",
|
|
.mhandler.cmd = hmp_info_tpm,
|
|
},
|
|
|
|
STEXI
|
|
@item info tpm
|
|
@findex tpm
|
|
Show the TPM device.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "memdev",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show memory backends",
|
|
.mhandler.cmd = hmp_info_memdev,
|
|
},
|
|
|
|
STEXI
|
|
@item info memdev
|
|
@findex memdev
|
|
Show memory backends
|
|
ETEXI
|
|
|
|
{
|
|
.name = "memory-devices",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show memory devices",
|
|
.mhandler.cmd = hmp_info_memory_devices,
|
|
},
|
|
|
|
STEXI
|
|
@item info memory-devices
|
|
@findex memory-devices
|
|
Show memory devices.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "iothreads",
|
|
.args_type = "",
|
|
.params = "",
|
|
.help = "show iothreads",
|
|
.mhandler.cmd = hmp_info_iothreads,
|
|
},
|
|
|
|
STEXI
|
|
@item info iothreads
|
|
@findex iothreads
|
|
Show iothread's identifiers.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "rocker",
|
|
.args_type = "name:s",
|
|
.params = "name",
|
|
.help = "Show rocker switch",
|
|
.mhandler.cmd = hmp_rocker,
|
|
},
|
|
|
|
STEXI
|
|
@item info rocker @var{name}
|
|
@findex rocker
|
|
Show rocker switch.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "rocker-ports",
|
|
.args_type = "name:s",
|
|
.params = "name",
|
|
.help = "Show rocker ports",
|
|
.mhandler.cmd = hmp_rocker_ports,
|
|
},
|
|
|
|
STEXI
|
|
@item info rocker_ports @var{name}-ports
|
|
@findex ocker-ports
|
|
Show rocker ports.
|
|
ETEXI
|
|
|
|
{
|
|
.name = "rocker-of-dpa-flows",
|
|
.args_type = "name:s,tbl_id:i?",
|
|
.params = "name [tbl_id]",
|
|
.help = "Show rocker OF-DPA flow tables",
|
|
.mhandler.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
|
|
|
|
{
|
|
.name = "rocker-of-dpa-groups",
|
|
.args_type = "name:s,type:i?",
|
|
.params = "name [type]",
|
|
.help = "Show rocker OF-DPA groups",
|
|
.mhandler.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
|
|
|
|
#if defined(TARGET_S390X)
|
|
{
|
|
.name = "skeys",
|
|
.args_type = "addr:l",
|
|
.params = "address",
|
|
.help = "Display the value of a storage key",
|
|
.mhandler.cmd = hmp_info_skeys,
|
|
},
|
|
#endif
|
|
|
|
STEXI
|
|
@item info skeys @var{address}
|
|
@findex skeys
|
|
Display the value of a storage key (s390 only)
|
|
ETEXI
|
|
|
|
STEXI
|
|
@end table
|
|
ETEXI
|
|
|
|
STEXI
|
|
@end table
|
|
ETEXI
|