]> git.proxmox.com Git - mirror_qemu.git/blobdiff - hmp-commands-info.hx
hw/intc/arm_gicv3_its: Correct handling of MAPI
[mirror_qemu.git] / hmp-commands-info.hx
index 1730f866cdeff55fc1d1abbbf9aff64563012672..407a1da800cfc19376dc48e1941de9346462e7f7 100644 (file)
@@ -1,9 +1,9 @@
-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"
@@ -11,13 +11,6 @@ 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.
@@ -33,11 +26,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info version
-@findex info version
-Show the version of QEMU.
-ETEXI
 SRST
   ``info version``
     Show the version of QEMU.
@@ -51,11 +39,6 @@ ERST
         .cmd        = hmp_info_network,
     },
 
-STEXI
-@item info network
-@findex info network
-Show the network state.
-ETEXI
 SRST
   ``info network``
     Show the network state.
@@ -70,11 +53,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info chardev
-@findex info chardev
-Show the character devices.
-ETEXI
 SRST
   ``info chardev``
     Show the character devices.
@@ -89,11 +67,6 @@ ERST
         .cmd        = hmp_info_block,
     },
 
-STEXI
-@item info block
-@findex info 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.
@@ -107,11 +80,6 @@ ERST
         .cmd        = hmp_info_blockstats,
     },
 
-STEXI
-@item info blockstats
-@findex info blockstats
-Show block device statistics.
-ETEXI
 SRST
   ``info blockstats``
     Show block device statistics.
@@ -125,11 +93,6 @@ ERST
         .cmd        = hmp_info_block_jobs,
     },
 
-STEXI
-@item info block-jobs
-@findex info block-jobs
-Show progress of ongoing block device operations.
-ETEXI
 SRST
   ``info block-jobs``
     Show progress of ongoing block device operations.
@@ -143,11 +106,6 @@ ERST
         .cmd        = hmp_info_registers,
     },
 
-STEXI
-@item info registers
-@findex info registers
-Show the cpu registers.
-ETEXI
 SRST
   ``info registers``
     Show the cpu registers.
@@ -164,36 +122,11 @@ ERST
     },
 #endif
 
-STEXI
-@item info lapic
-@findex info lapic
-Show local APIC state
-ETEXI
 SRST
   ``info lapic``
     Show local APIC state
 ERST
 
-#if defined(TARGET_I386)
-    {
-        .name       = "ioapic",
-        .args_type  = "",
-        .params     = "",
-        .help       = "show io apic state",
-        .cmd        = hmp_info_io_apic,
-    },
-#endif
-
-STEXI
-@item info ioapic
-@findex info ioapic
-Show io APIC state
-ETEXI
-SRST
-  ``info ioapic``
-    Show io APIC state
-ERST
-
     {
         .name       = "cpus",
         .args_type  = "",
@@ -202,11 +135,6 @@ ERST
         .cmd        = hmp_info_cpus,
     },
 
-STEXI
-@item info cpus
-@findex info cpus
-Show infos for each CPU.
-ETEXI
 SRST
   ``info cpus``
     Show infos for each CPU.
@@ -221,11 +149,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info history
-@findex info history
-Show the command line history.
-ETEXI
 SRST
   ``info history``
     Show the command line history.
@@ -236,14 +159,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show the interrupts statistics (if available)",
-        .cmd        = hmp_info_irq,
+        .cmd_info_hrt = qmp_x_query_irq,
     },
 
-STEXI
-@item info irq
-@findex info irq
-Show the interrupts statistics (if available).
-ETEXI
 SRST
   ``info irq``
     Show the interrupts statistics (if available).
@@ -257,11 +175,6 @@ ERST
         .cmd        = hmp_info_pic,
     },
 
-STEXI
-@item info pic
-@findex info pic
-Show PIC state.
-ETEXI
 SRST
   ``info pic``
     Show PIC state.
@@ -272,14 +185,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show RDMA state",
-        .cmd        = hmp_info_rdma,
+        .cmd_info_hrt = qmp_x_query_rdma,
     },
 
-STEXI
-@item info rdma
-@findex info rdma
-Show RDMA state.
-ETEXI
 SRST
   ``info rdma``
     Show RDMA state.
@@ -293,11 +201,6 @@ ERST
         .cmd        = hmp_info_pci,
     },
 
-STEXI
-@item info pci
-@findex info pci
-Show PCI information.
-ETEXI
 SRST
   ``info pci``
     Show PCI information.
@@ -314,11 +217,6 @@ ERST
     },
 #endif
 
-STEXI
-@item info tlb
-@findex info tlb
-Show virtual to physical memory mappings.
-ETEXI
 SRST
   ``info tlb``
     Show virtual to physical memory mappings.
@@ -334,11 +232,6 @@ ERST
     },
 #endif
 
-STEXI
-@item info mem
-@findex info mem
-Show the active virtual memory mappings.
-ETEXI
 SRST
   ``info mem``
     Show the active virtual memory mappings.
@@ -346,19 +239,15 @@ ERST
 
     {
         .name       = "mtree",
-        .args_type  = "flatview:-f,dispatch_tree:-d,owner:-o",
-        .params     = "[-f][-d][-o]",
+        .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);"
-                      "-o: dump region owners/parents",
+                      "-o: dump region owners/parents;"
+                      "-D: dump disabled regions",
         .cmd        = hmp_info_mtree,
     },
 
-STEXI
-@item info mtree
-@findex info mtree
-Show memory tree.
-ETEXI
 SRST
   ``info mtree``
     Show memory tree.
@@ -370,15 +259,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show dynamic compiler info",
-        .cmd        = hmp_info_jit,
     },
 #endif
 
-STEXI
-@item info jit
-@findex info jit
-Show dynamic compiler info.
-ETEXI
 SRST
   ``info jit``
     Show dynamic compiler info.
@@ -390,15 +273,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show dynamic compiler opcode counters",
-        .cmd        = hmp_info_opcount,
     },
 #endif
 
-STEXI
-@item info opcount
-@findex info opcount
-Show dynamic compiler opcode counters
-ETEXI
 SRST
   ``info opcount``
     Show dynamic compiler opcode counters
@@ -415,16 +292,6 @@ ERST
         .cmd        = hmp_info_sync_profile,
     },
 
-STEXI
-@item info sync-profile [-m|-n] [@var{max}]
-@findex info sync-profile
-Show synchronization profiling info, up to @var{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.
-ETEXI
 SRST
   ``info sync-profile [-m|-n]`` [*max*]
     Show synchronization profiling info, up to *max* entries (default: 10),
@@ -448,11 +315,6 @@ ERST
         .cmd        = hmp_info_kvm,
     },
 
-STEXI
-@item info kvm
-@findex info kvm
-Show KVM information.
-ETEXI
 SRST
   ``info kvm``
     Show KVM information.
@@ -463,14 +325,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show NUMA information",
-        .cmd        = hmp_info_numa,
+        .cmd_info_hrt = qmp_x_query_numa,
     },
 
-STEXI
-@item info numa
-@findex info numa
-Show NUMA information.
-ETEXI
 SRST
   ``info numa``
     Show NUMA information.
@@ -481,14 +338,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show guest USB devices",
-        .cmd        = hmp_info_usb,
+        .cmd_info_hrt = qmp_x_query_usb,
     },
 
-STEXI
-@item info usb
-@findex info usb
-Show guest USB devices.
-ETEXI
 SRST
   ``info usb``
     Show guest USB devices.
@@ -499,14 +351,8 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show host USB devices",
-        .cmd        = hmp_info_usbhost,
     },
 
-STEXI
-@item info usbhost
-@findex info usbhost
-Show host USB devices.
-ETEXI
 SRST
   ``info usbhost``
     Show host USB devices.
@@ -517,14 +363,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show profiling information",
-        .cmd        = hmp_info_profile,
+        .cmd_info_hrt = qmp_x_query_profile,
     },
 
-STEXI
-@item info profile
-@findex info profile
-Show profiling information.
-ETEXI
 SRST
   ``info profile``
     Show profiling information.
@@ -538,11 +379,6 @@ ERST
         .cmd        = hmp_info_capture,
     },
 
-STEXI
-@item info capture
-@findex info capture
-Show capture information.
-ETEXI
 SRST
   ``info capture``
     Show capture information.
@@ -556,11 +392,6 @@ ERST
         .cmd        = hmp_info_snapshots,
     },
 
-STEXI
-@item info snapshots
-@findex info snapshots
-Show the currently saved VM snapshots.
-ETEXI
 SRST
   ``info snapshots``
     Show the currently saved VM snapshots.
@@ -575,11 +406,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info status
-@findex info status
-Show the current VM status (running|paused).
-ETEXI
 SRST
   ``info status``
     Show the current VM status (running|paused).
@@ -593,11 +419,6 @@ ERST
         .cmd        = hmp_info_mice,
     },
 
-STEXI
-@item info mice
-@findex info mice
-Show which guest mouse is receiving events.
-ETEXI
 SRST
   ``info mice``
     Show which guest mouse is receiving events.
@@ -613,11 +434,6 @@ ERST
     },
 #endif
 
-STEXI
-@item info vnc
-@findex info vnc
-Show the vnc server status.
-ETEXI
 SRST
   ``info vnc``
     Show the vnc server status.
@@ -633,11 +449,6 @@ ERST
     },
 #endif
 
-STEXI
-@item info spice
-@findex info spice
-Show the spice server status.
-ETEXI
 SRST
   ``info spice``
     Show the spice server status.
@@ -652,11 +463,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info name
-@findex info name
-Show the current VM name.
-ETEXI
 SRST
   ``info name``
     Show the current VM name.
@@ -671,34 +477,11 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info uuid
-@findex info uuid
-Show the current VM UUID.
-ETEXI
 SRST
   ``info uuid``
     Show the current VM UUID.
 ERST
 
-    {
-        .name       = "cpustats",
-        .args_type  = "",
-        .params     = "",
-        .help       = "show CPU statistics",
-        .cmd        = hmp_info_cpustats,
-    },
-
-STEXI
-@item info cpustats
-@findex info cpustats
-Show CPU statistics.
-ETEXI
-SRST
-  ``info cpustats``
-    Show CPU statistics.
-ERST
-
 #if defined(CONFIG_SLIRP)
     {
         .name       = "usernet",
@@ -709,11 +492,6 @@ ERST
     },
 #endif
 
-STEXI
-@item info usernet
-@findex info usernet
-Show user network stack connection states.
-ETEXI
 SRST
   ``info usernet``
     Show user network stack connection states.
@@ -727,11 +505,6 @@ ERST
         .cmd        = hmp_info_migrate,
     },
 
-STEXI
-@item info migrate
-@findex info migrate
-Show migration status.
-ETEXI
 SRST
   ``info migrate``
     Show migration status.
@@ -745,11 +518,6 @@ ERST
         .cmd        = hmp_info_migrate_capabilities,
     },
 
-STEXI
-@item info migrate_capabilities
-@findex info migrate_capabilities
-Show current migration capabilities.
-ETEXI
 SRST
   ``info migrate_capabilities``
     Show current migration capabilities.
@@ -763,34 +531,11 @@ ERST
         .cmd        = hmp_info_migrate_parameters,
     },
 
-STEXI
-@item info migrate_parameters
-@findex info migrate_parameters
-Show current migration parameters.
-ETEXI
 SRST
   ``info migrate_parameters``
     Show current migration parameters.
 ERST
 
-    {
-        .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 info migrate_cache_size
-Show current migration xbzrle cache size.
-ETEXI
-SRST
-  ``info migrate_cache_size``
-    Show current migration xbzrle cache size.
-ERST
-
     {
         .name       = "balloon",
         .args_type  = "",
@@ -799,11 +544,6 @@ ERST
         .cmd        = hmp_info_balloon,
     },
 
-STEXI
-@item info balloon
-@findex info balloon
-Show balloon information.
-ETEXI
 SRST
   ``info balloon``
     Show balloon information.
@@ -817,11 +557,6 @@ ERST
         .cmd        = hmp_info_qtree,
     },
 
-STEXI
-@item info qtree
-@findex info qtree
-Show device tree.
-ETEXI
 SRST
   ``info qtree``
     Show device tree.
@@ -835,11 +570,6 @@ ERST
         .cmd        = hmp_info_qdm,
     },
 
-STEXI
-@item info qdm
-@findex info qdm
-Show qdev device model list.
-ETEXI
 SRST
   ``info qdm``
     Show qdev device model list.
@@ -854,11 +584,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info qom-tree
-@findex info qom-tree
-Show QOM composition tree.
-ETEXI
 SRST
   ``info qom-tree``
     Show QOM composition tree.
@@ -869,14 +594,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "show roms",
-        .cmd        = hmp_info_roms,
+        .cmd_info_hrt = qmp_x_query_roms,
     },
 
-STEXI
-@item info roms
-@findex info roms
-Show roms.
-ETEXI
 SRST
   ``info roms``
     Show roms.
@@ -892,11 +612,6 @@ ERST
         .command_completion = info_trace_events_completion,
     },
 
-STEXI
-@item info trace-events
-@findex info trace-events
-Show available trace-events & their state.
-ETEXI
 SRST
   ``info trace-events``
     Show available trace-events & their state.
@@ -910,11 +625,6 @@ ERST
         .cmd        = hmp_info_tpm,
     },
 
-STEXI
-@item info tpm
-@findex info tpm
-Show the TPM device.
-ETEXI
 SRST
   ``info tpm``
     Show the TPM device.
@@ -929,11 +639,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info memdev
-@findex info memdev
-Show memory backends
-ETEXI
 SRST
   ``info memdev``
     Show memory backends
@@ -947,11 +652,6 @@ ERST
         .cmd        = hmp_info_memory_devices,
     },
 
-STEXI
-@item info memory-devices
-@findex info memory-devices
-Show memory devices.
-ETEXI
 SRST
   ``info memory-devices``
     Show memory devices.
@@ -966,11 +666,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info iothreads
-@findex info iothreads
-Show iothread's identifiers.
-ETEXI
 SRST
   ``info iothreads``
     Show iothread's identifiers.
@@ -984,11 +679,6 @@ ERST
         .cmd        = hmp_rocker,
     },
 
-STEXI
-@item info rocker @var{name}
-@findex info rocker
-Show rocker switch.
-ETEXI
 SRST
   ``info rocker`` *name*
     Show rocker switch.
@@ -1002,11 +692,6 @@ ERST
         .cmd        = hmp_rocker_ports,
     },
 
-STEXI
-@item info rocker-ports @var{name}-ports
-@findex info rocker-ports
-Show rocker ports.
-ETEXI
 SRST
   ``info rocker-ports`` *name*-ports
     Show rocker ports.
@@ -1020,11 +705,6 @@ ERST
         .cmd        = hmp_rocker_of_dpa_flows,
     },
 
-STEXI
-@item info rocker-of-dpa-flows @var{name} [@var{tbl_id}]
-@findex info 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.
@@ -1038,11 +718,6 @@ ERST
         .cmd        = hmp_rocker_of_dpa_groups,
     },
 
-STEXI
-@item info rocker-of-dpa-groups @var{name} [@var{type}]
-@findex info rocker-of-dpa-groups
-Show rocker OF-DPA groups.
-ETEXI
 SRST
   ``info rocker-of-dpa-groups`` *name* [*type*]
     Show rocker OF-DPA groups.
@@ -1058,11 +733,6 @@ ERST
     },
 #endif
 
-STEXI
-@item info skeys @var{address}
-@findex info skeys
-Display the value of a storage key (s390 only)
-ETEXI
 SRST
   ``info skeys`` *address*
     Display the value of a storage key (s390 only)
@@ -1078,11 +748,6 @@ ERST
     },
 #endif
 
-STEXI
-@item info cmma @var{address}
-@findex info 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
@@ -1097,11 +762,6 @@ ERST
         .cmd        = hmp_info_dump,
     },
 
-STEXI
-@item info dump
-@findex info dump
-Display the latest dump status.
-ETEXI
 SRST
   ``info dump``
     Display the latest dump status.
@@ -1112,14 +772,9 @@ ERST
         .args_type  = "",
         .params     = "",
         .help       = "Display system ramblock information",
-        .cmd        = hmp_info_ramblock,
+        .cmd_info_hrt = qmp_x_query_ramblock,
     },
 
-STEXI
-@item info ramblock
-@findex info ramblock
-Dump all the ramblocks of the system.
-ETEXI
 SRST
   ``info ramblock``
     Dump all the ramblocks of the system.
@@ -1134,11 +789,6 @@ ERST
         .flags      = "p",
     },
 
-STEXI
-@item info hotpluggable-cpus
-@findex info hotpluggable-cpus
-Show information about hotpluggable CPUs
-ETEXI
 SRST
   ``info hotpluggable-cpus``
     Show information about hotpluggable CPUs
@@ -1152,11 +802,6 @@ ERST
         .cmd = hmp_info_vm_generation_id,
     },
 
-STEXI
-@item info vm-generation-id
-@findex info vm-generation-id
-Show Virtual Machine Generation ID
-ETEXI
 SRST
   ``info vm-generation-id``
     Show Virtual Machine Generation ID
@@ -1171,12 +816,6 @@ ERST
         .cmd        = hmp_info_memory_size_summary,
     },
 
-STEXI
-@item info memory_size_summary
-@findex info memory_size_summary
-Display the amount of initially allocated and present hotpluggable (if
-enabled) memory in bytes.
-ETEXI
 SRST
   ``info memory_size_summary``
     Display the amount of initially allocated and present hotpluggable (if
@@ -1193,20 +832,48 @@ ERST
     },
 #endif
 
-STEXI
-@item info sev
-@findex info sev
-Show SEV information.
-ETEXI
 SRST
   ``info sev``
     Show SEV information.
 ERST
 
-STEXI
-@end table
-ETEXI
+    {
+        .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,
+    },
 
-STEXI
-@end table
-ETEXI
+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
+
+SRST
+  ``info sgx``
+    Show intel SGX information.
+ERST