blob: 30209e3903259f087c3997f4a3f59e75bf4f24aa [file] [log] [blame]
Peter Maydell3c95fde2020-03-06 17:17:44 +00001HXCOMM Use DEFHEADING() to define headings in both help text and rST.
2HXCOMM Text between SRST and ERST is copied to the rST version and
3HXCOMM discarded from C version.
Pavel Butsykinda76ee72015-09-10 18:38:58 +03004HXCOMM DEF(command, args, callback, arg_string, help) is used to construct
5HXCOMM monitor info commands
Peter Maydell3c95fde2020-03-06 17:17:44 +00006HXCOMM HXCOMM can be used for comments, discarded from both rST and C.
Peter Maydella12e74c2020-02-28 15:36:07 +00007HXCOMM
8HXCOMM In this file, generally SRST fragments should have two extra
9HXCOMM spaces of indent, so that the documentation list item for "info foo"
10HXCOMM appears inside the documentation list item for the top level
11HXCOMM "info" documentation entry. The exception is the first SRST
12HXCOMM fragment that defines that top level entry.
Pavel Butsykinda76ee72015-09-10 18:38:58 +030013
Peter Maydella12e74c2020-02-28 15:36:07 +000014SRST
15``info`` *subcommand*
16 Show various information about the system state.
17
18ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +030019
20 {
21 .name = "version",
22 .args_type = "",
23 .params = "",
24 .help = "show the version of QEMU",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +040025 .cmd = hmp_info_version,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +010026 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +030027 },
28
Peter Maydella12e74c2020-02-28 15:36:07 +000029SRST
30 ``info version``
31 Show the version of QEMU.
32ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +030033
34 {
35 .name = "network",
36 .args_type = "",
37 .params = "",
38 .help = "show the network state",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +040039 .cmd = hmp_info_network,
Pavel Butsykinda76ee72015-09-10 18:38:58 +030040 },
41
Peter Maydella12e74c2020-02-28 15:36:07 +000042SRST
43 ``info network``
44 Show the network state.
45ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +030046
47 {
48 .name = "chardev",
49 .args_type = "",
50 .params = "",
51 .help = "show the character devices",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +040052 .cmd = hmp_info_chardev,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +010053 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +030054 },
55
Peter Maydella12e74c2020-02-28 15:36:07 +000056SRST
57 ``info chardev``
58 Show the character devices.
59ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +030060
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)",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +040067 .cmd = hmp_info_block,
Pavel Butsykinda76ee72015-09-10 18:38:58 +030068 },
69
Peter Maydella12e74c2020-02-28 15:36:07 +000070SRST
71 ``info block``
72 Show info of one block device or all block devices.
73ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +030074
75 {
76 .name = "blockstats",
77 .args_type = "",
78 .params = "",
79 .help = "show block device statistics",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +040080 .cmd = hmp_info_blockstats,
Pavel Butsykinda76ee72015-09-10 18:38:58 +030081 },
82
Peter Maydella12e74c2020-02-28 15:36:07 +000083SRST
84 ``info blockstats``
85 Show block device statistics.
86ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +030087
88 {
89 .name = "block-jobs",
90 .args_type = "",
91 .params = "",
92 .help = "show progress of ongoing block device operations",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +040093 .cmd = hmp_info_block_jobs,
Pavel Butsykinda76ee72015-09-10 18:38:58 +030094 },
95
Peter Maydella12e74c2020-02-28 15:36:07 +000096SRST
97 ``info block-jobs``
98 Show progress of ongoing block device operations.
99ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300100
101 {
102 .name = "registers",
Suraj Jitindar Singh18f08282017-06-08 15:41:16 +1000103 .args_type = "cpustate_all:-a",
104 .params = "[-a]",
105 .help = "show the cpu registers (-a: all - show register info for all cpus)",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400106 .cmd = hmp_info_registers,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300107 },
108
Peter Maydella12e74c2020-02-28 15:36:07 +0000109SRST
110 ``info registers``
111 Show the cpu registers.
112ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300113
Pavel Butsykin1f871d42015-09-22 16:18:18 +0300114#if defined(TARGET_I386)
115 {
116 .name = "lapic",
Yi Wang1bef2282017-07-26 02:18:37 -0400117 .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)",
120
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400121 .cmd = hmp_info_local_apic,
Pavel Butsykin1f871d42015-09-22 16:18:18 +0300122 },
123#endif
124
Peter Maydella12e74c2020-02-28 15:36:07 +0000125SRST
126 ``info lapic``
127 Show local APIC state
128ERST
Pavel Butsykin1f871d42015-09-22 16:18:18 +0300129
Pavel Butsykind665d692015-09-22 16:18:20 +0300130#if defined(TARGET_I386)
131 {
132 .name = "ioapic",
133 .args_type = "",
134 .params = "",
135 .help = "show io apic state",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400136 .cmd = hmp_info_io_apic,
Pavel Butsykind665d692015-09-22 16:18:20 +0300137 },
138#endif
139
Peter Maydella12e74c2020-02-28 15:36:07 +0000140SRST
141 ``info ioapic``
142 Show io APIC state
143ERST
Pavel Butsykind665d692015-09-22 16:18:20 +0300144
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300145 {
146 .name = "cpus",
147 .args_type = "",
148 .params = "",
149 .help = "show infos for each CPU",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400150 .cmd = hmp_info_cpus,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300151 },
152
Peter Maydella12e74c2020-02-28 15:36:07 +0000153SRST
154 ``info cpus``
155 Show infos for each CPU.
156ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300157
158 {
159 .name = "history",
160 .args_type = "",
161 .params = "",
162 .help = "show the command line history",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400163 .cmd = hmp_info_history,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +0100164 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300165 },
166
Peter Maydella12e74c2020-02-28 15:36:07 +0000167SRST
168 ``info history``
169 Show the command line history.
170ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300171
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300172 {
173 .name = "irq",
174 .args_type = "",
175 .params = "",
176 .help = "show the interrupts statistics (if available)",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400177 .cmd = hmp_info_irq,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300178 },
179
Peter Maydella12e74c2020-02-28 15:36:07 +0000180SRST
181 ``info irq``
182 Show the interrupts statistics (if available).
183ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300184
185 {
186 .name = "pic",
187 .args_type = "",
188 .params = "",
Hervé Poussineau254316f2016-09-26 22:23:28 +0200189 .help = "show PIC state",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400190 .cmd = hmp_info_pic,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300191 },
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300192
Peter Maydella12e74c2020-02-28 15:36:07 +0000193SRST
194 ``info pic``
195 Show PIC state.
196ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300197
Paolo Bonziniabadcbc2015-09-18 17:18:29 +0200198 {
Yuval Shaiaf4b2c022019-03-11 03:29:09 -0700199 .name = "rdma",
200 .args_type = "",
201 .params = "",
202 .help = "show RDMA state",
203 .cmd = hmp_info_rdma,
204 },
205
Peter Maydella12e74c2020-02-28 15:36:07 +0000206SRST
207 ``info rdma``
208 Show RDMA state.
209ERST
Yuval Shaiaf4b2c022019-03-11 03:29:09 -0700210
211 {
Paolo Bonziniabadcbc2015-09-18 17:18:29 +0200212 .name = "pci",
213 .args_type = "",
214 .params = "",
215 .help = "show PCI info",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400216 .cmd = hmp_info_pci,
Paolo Bonziniabadcbc2015-09-18 17:18:29 +0200217 },
218
Peter Maydella12e74c2020-02-28 15:36:07 +0000219SRST
220 ``info pci``
221 Show PCI information.
222ERST
Paolo Bonziniabadcbc2015-09-18 17:18:29 +0200223
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300224#if defined(TARGET_I386) || defined(TARGET_SH4) || defined(TARGET_SPARC) || \
Laurent Vivier2097dca2018-01-18 20:38:46 +0100225 defined(TARGET_PPC) || defined(TARGET_XTENSA) || defined(TARGET_M68K)
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300226 {
227 .name = "tlb",
228 .args_type = "",
229 .params = "",
230 .help = "show virtual to physical memory mappings",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400231 .cmd = hmp_info_tlb,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300232 },
233#endif
234
Peter Maydella12e74c2020-02-28 15:36:07 +0000235SRST
236 ``info tlb``
237 Show virtual to physical memory mappings.
238ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300239
Bin Mengdf42fdd2019-08-14 08:33:32 -0700240#if defined(TARGET_I386) || defined(TARGET_RISCV)
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300241 {
242 .name = "mem",
243 .args_type = "",
244 .params = "",
245 .help = "show the active virtual memory mappings",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400246 .cmd = hmp_info_mem,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300247 },
248#endif
249
Peter Maydella12e74c2020-02-28 15:36:07 +0000250SRST
251 ``info mem``
252 Show the active virtual memory mappings.
253ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300254
255 {
256 .name = "mtree",
Philippe Mathieu-Daudé2261d392020-05-29 14:53:25 +0200257 .args_type = "flatview:-f,dispatch_tree:-d,owner:-o,disabled:-D",
258 .params = "[-f][-d][-o][-D]",
Alexey Kardashevskiy5e8fd942017-09-21 18:51:06 +1000259 .help = "show memory tree (-f: dump flat view for address spaces;"
Alexey Kardashevskiyfc051ae2018-06-04 13:25:11 +1000260 "-d: dump dispatch tree, valid with -f only);"
Philippe Mathieu-Daudé2261d392020-05-29 14:53:25 +0200261 "-o: dump region owners/parents;"
262 "-D: dump disabled regions",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400263 .cmd = hmp_info_mtree,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300264 },
265
Peter Maydella12e74c2020-02-28 15:36:07 +0000266SRST
267 ``info mtree``
268 Show memory tree.
269ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300270
Paolo Bonzinif0d14a92012-09-17 13:42:41 +0200271#if defined(CONFIG_TCG)
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300272 {
273 .name = "jit",
274 .args_type = "",
275 .params = "",
276 .help = "show dynamic compiler info",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400277 .cmd = hmp_info_jit,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300278 },
Paolo Bonzinif0d14a92012-09-17 13:42:41 +0200279#endif
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300280
Peter Maydella12e74c2020-02-28 15:36:07 +0000281SRST
282 ``info jit``
283 Show dynamic compiler info.
284ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300285
Paolo Bonzinif0d14a92012-09-17 13:42:41 +0200286#if defined(CONFIG_TCG)
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300287 {
288 .name = "opcount",
289 .args_type = "",
290 .params = "",
291 .help = "show dynamic compiler opcode counters",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400292 .cmd = hmp_info_opcount,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300293 },
Paolo Bonzinif0d14a92012-09-17 13:42:41 +0200294#endif
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300295
Peter Maydella12e74c2020-02-28 15:36:07 +0000296SRST
297 ``info opcount``
298 Show dynamic compiler opcode counters
299ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300300
301 {
Emilio G. Cota97bfafe2017-08-08 13:54:42 -0400302 .name = "sync-profile",
303 .args_type = "mean:-m,no_coalesce:-n,max:i?",
304 .params = "[-m] [-n] [max]",
305 .help = "show synchronization profiling info, up to max entries "
306 "(default: 10), sorted by total wait time. (-m: sort by "
307 "mean wait time; -n: do not coalesce objects with the "
308 "same call site)",
309 .cmd = hmp_info_sync_profile,
310 },
311
Peter Maydella12e74c2020-02-28 15:36:07 +0000312SRST
313 ``info sync-profile [-m|-n]`` [*max*]
314 Show synchronization profiling info, up to *max* entries (default: 10),
315 sorted by total wait time.
316
317 ``-m``
318 sort by mean wait time
319 ``-n``
320 do not coalesce objects with the same call site
321
322 When different objects that share the same call site are coalesced,
323 the "Object" field shows---enclosed in brackets---the number of objects
324 being coalesced.
325ERST
Emilio G. Cota97bfafe2017-08-08 13:54:42 -0400326
327 {
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300328 .name = "kvm",
329 .args_type = "",
330 .params = "",
331 .help = "show KVM information",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400332 .cmd = hmp_info_kvm,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300333 },
334
Peter Maydella12e74c2020-02-28 15:36:07 +0000335SRST
336 ``info kvm``
337 Show KVM information.
338ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300339
340 {
341 .name = "numa",
342 .args_type = "",
343 .params = "",
344 .help = "show NUMA information",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400345 .cmd = hmp_info_numa,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300346 },
347
Peter Maydella12e74c2020-02-28 15:36:07 +0000348SRST
349 ``info numa``
350 Show NUMA information.
351ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300352
353 {
354 .name = "usb",
355 .args_type = "",
356 .params = "",
357 .help = "show guest USB devices",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400358 .cmd = hmp_info_usb,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300359 },
360
Peter Maydella12e74c2020-02-28 15:36:07 +0000361SRST
362 ``info usb``
363 Show guest USB devices.
364ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300365
366 {
367 .name = "usbhost",
368 .args_type = "",
369 .params = "",
370 .help = "show host USB devices",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400371 .cmd = hmp_info_usbhost,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300372 },
373
Peter Maydella12e74c2020-02-28 15:36:07 +0000374SRST
375 ``info usbhost``
376 Show host USB devices.
377ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300378
379 {
380 .name = "profile",
381 .args_type = "",
382 .params = "",
383 .help = "show profiling information",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400384 .cmd = hmp_info_profile,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300385 },
386
Peter Maydella12e74c2020-02-28 15:36:07 +0000387SRST
388 ``info profile``
389 Show profiling information.
390ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300391
392 {
393 .name = "capture",
394 .args_type = "",
395 .params = "",
396 .help = "show capture information",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400397 .cmd = hmp_info_capture,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300398 },
399
Peter Maydella12e74c2020-02-28 15:36:07 +0000400SRST
401 ``info capture``
402 Show capture information.
403ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300404
405 {
406 .name = "snapshots",
407 .args_type = "",
408 .params = "",
409 .help = "show the currently saved VM snapshots",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400410 .cmd = hmp_info_snapshots,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300411 },
412
Peter Maydella12e74c2020-02-28 15:36:07 +0000413SRST
414 ``info snapshots``
415 Show the currently saved VM snapshots.
416ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300417
418 {
419 .name = "status",
420 .args_type = "",
421 .params = "",
422 .help = "show the current VM status (running|paused)",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400423 .cmd = hmp_info_status,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +0100424 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300425 },
426
Peter Maydella12e74c2020-02-28 15:36:07 +0000427SRST
428 ``info status``
429 Show the current VM status (running|paused).
430ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300431
432 {
433 .name = "mice",
434 .args_type = "",
435 .params = "",
436 .help = "show which guest mouse is receiving events",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400437 .cmd = hmp_info_mice,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300438 },
439
Peter Maydella12e74c2020-02-28 15:36:07 +0000440SRST
441 ``info mice``
442 Show which guest mouse is receiving events.
443ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300444
Marc-André Lureau05eb4a22018-07-03 17:56:47 +0200445#if defined(CONFIG_VNC)
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300446 {
447 .name = "vnc",
448 .args_type = "",
449 .params = "",
450 .help = "show the vnc server status",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400451 .cmd = hmp_info_vnc,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300452 },
Marc-André Lureau05eb4a22018-07-03 17:56:47 +0200453#endif
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300454
Peter Maydella12e74c2020-02-28 15:36:07 +0000455SRST
456 ``info vnc``
457 Show the vnc server status.
458ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300459
460#if defined(CONFIG_SPICE)
461 {
462 .name = "spice",
463 .args_type = "",
464 .params = "",
465 .help = "show the spice server status",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400466 .cmd = hmp_info_spice,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300467 },
468#endif
469
Peter Maydella12e74c2020-02-28 15:36:07 +0000470SRST
471 ``info spice``
472 Show the spice server status.
473ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300474
475 {
476 .name = "name",
477 .args_type = "",
478 .params = "",
479 .help = "show the current VM name",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400480 .cmd = hmp_info_name,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +0100481 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300482 },
483
Peter Maydella12e74c2020-02-28 15:36:07 +0000484SRST
485 ``info name``
486 Show the current VM name.
487ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300488
489 {
490 .name = "uuid",
491 .args_type = "",
492 .params = "",
493 .help = "show the current VM UUID",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400494 .cmd = hmp_info_uuid,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +0100495 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300496 },
497
Peter Maydella12e74c2020-02-28 15:36:07 +0000498SRST
499 ``info uuid``
500 Show the current VM UUID.
501ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300502
503 {
504 .name = "cpustats",
505 .args_type = "",
506 .params = "",
507 .help = "show CPU statistics",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400508 .cmd = hmp_info_cpustats,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300509 },
510
Peter Maydella12e74c2020-02-28 15:36:07 +0000511SRST
512 ``info cpustats``
513 Show CPU statistics.
514ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300515
516#if defined(CONFIG_SLIRP)
517 {
518 .name = "usernet",
519 .args_type = "",
520 .params = "",
521 .help = "show user network stack connection states",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400522 .cmd = hmp_info_usernet,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300523 },
524#endif
525
Peter Maydella12e74c2020-02-28 15:36:07 +0000526SRST
527 ``info usernet``
528 Show user network stack connection states.
529ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300530
531 {
532 .name = "migrate",
533 .args_type = "",
534 .params = "",
535 .help = "show migration status",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400536 .cmd = hmp_info_migrate,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300537 },
538
Peter Maydella12e74c2020-02-28 15:36:07 +0000539SRST
540 ``info migrate``
541 Show migration status.
542ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300543
544 {
545 .name = "migrate_capabilities",
546 .args_type = "",
547 .params = "",
548 .help = "show current migration capabilities",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400549 .cmd = hmp_info_migrate_capabilities,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300550 },
551
Peter Maydella12e74c2020-02-28 15:36:07 +0000552SRST
553 ``info migrate_capabilities``
554 Show current migration capabilities.
555ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300556
557 {
558 .name = "migrate_parameters",
559 .args_type = "",
560 .params = "",
561 .help = "show current migration parameters",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400562 .cmd = hmp_info_migrate_parameters,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300563 },
564
Peter Maydella12e74c2020-02-28 15:36:07 +0000565SRST
566 ``info migrate_parameters``
567 Show current migration parameters.
568ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300569
570 {
571 .name = "migrate_cache_size",
572 .args_type = "",
573 .params = "",
574 .help = "show current migration xbzrle cache size",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400575 .cmd = hmp_info_migrate_cache_size,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300576 },
577
Peter Maydella12e74c2020-02-28 15:36:07 +0000578SRST
579 ``info migrate_cache_size``
580 Show current migration xbzrle cache size.
581ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300582
583 {
584 .name = "balloon",
585 .args_type = "",
586 .params = "",
587 .help = "show balloon information",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400588 .cmd = hmp_info_balloon,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300589 },
590
Peter Maydella12e74c2020-02-28 15:36:07 +0000591SRST
592 ``info balloon``
593 Show balloon information.
594ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300595
596 {
597 .name = "qtree",
598 .args_type = "",
599 .params = "",
600 .help = "show device tree",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400601 .cmd = hmp_info_qtree,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300602 },
603
Peter Maydella12e74c2020-02-28 15:36:07 +0000604SRST
605 ``info qtree``
606 Show device tree.
607ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300608
609 {
610 .name = "qdm",
611 .args_type = "",
612 .params = "",
613 .help = "show qdev device model list",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400614 .cmd = hmp_info_qdm,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300615 },
616
Peter Maydella12e74c2020-02-28 15:36:07 +0000617SRST
618 ``info qdm``
619 Show qdev device model list.
620ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300621
622 {
623 .name = "qom-tree",
624 .args_type = "path:s?",
625 .params = "[path]",
626 .help = "show QOM composition tree",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400627 .cmd = hmp_info_qom_tree,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +0100628 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300629 },
630
Peter Maydella12e74c2020-02-28 15:36:07 +0000631SRST
632 ``info qom-tree``
633 Show QOM composition tree.
634ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300635
636 {
637 .name = "roms",
638 .args_type = "",
639 .params = "",
640 .help = "show roms",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400641 .cmd = hmp_info_roms,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300642 },
643
Peter Maydella12e74c2020-02-28 15:36:07 +0000644SRST
645 ``info roms``
646 Show roms.
647ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300648
649 {
650 .name = "trace-events",
Lluís Vilanova77e2b172016-07-11 12:53:57 +0200651 .args_type = "name:s?,vcpu:i?",
652 .params = "[name] [vcpu]",
Lluís Vilanovabd712112016-07-11 12:53:51 +0200653 .help = "show available trace-events & their state "
Lluís Vilanova77e2b172016-07-11 12:53:57 +0200654 "(name: event name pattern; vcpu: vCPU to query, default is any)",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400655 .cmd = hmp_info_trace_events,
Lluís Vilanovabd712112016-07-11 12:53:51 +0200656 .command_completion = info_trace_events_completion,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300657 },
658
Peter Maydella12e74c2020-02-28 15:36:07 +0000659SRST
660 ``info trace-events``
661 Show available trace-events & their state.
662ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300663
664 {
665 .name = "tpm",
666 .args_type = "",
667 .params = "",
668 .help = "show the TPM device",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400669 .cmd = hmp_info_tpm,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300670 },
671
Peter Maydella12e74c2020-02-28 15:36:07 +0000672SRST
673 ``info tpm``
674 Show the TPM device.
675ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300676
677 {
678 .name = "memdev",
679 .args_type = "",
680 .params = "",
681 .help = "show memory backends",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400682 .cmd = hmp_info_memdev,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +0100683 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300684 },
685
Peter Maydella12e74c2020-02-28 15:36:07 +0000686SRST
687 ``info memdev``
688 Show memory backends
689ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300690
691 {
692 .name = "memory-devices",
693 .args_type = "",
694 .params = "",
695 .help = "show memory devices",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400696 .cmd = hmp_info_memory_devices,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300697 },
698
Peter Maydella12e74c2020-02-28 15:36:07 +0000699SRST
700 ``info memory-devices``
701 Show memory devices.
702ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300703
704 {
705 .name = "iothreads",
706 .args_type = "",
707 .params = "",
708 .help = "show iothreads",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400709 .cmd = hmp_info_iothreads,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +0100710 .flags = "p",
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300711 },
712
Peter Maydella12e74c2020-02-28 15:36:07 +0000713SRST
714 ``info iothreads``
715 Show iothread's identifiers.
716ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300717
718 {
719 .name = "rocker",
720 .args_type = "name:s",
721 .params = "name",
722 .help = "Show rocker switch",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400723 .cmd = hmp_rocker,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300724 },
725
Peter Maydella12e74c2020-02-28 15:36:07 +0000726SRST
727 ``info rocker`` *name*
728 Show rocker switch.
729ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300730
731 {
732 .name = "rocker-ports",
733 .args_type = "name:s",
734 .params = "name",
735 .help = "Show rocker ports",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400736 .cmd = hmp_rocker_ports,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300737 },
738
Peter Maydella12e74c2020-02-28 15:36:07 +0000739SRST
740 ``info rocker-ports`` *name*-ports
741 Show rocker ports.
742ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300743
744 {
745 .name = "rocker-of-dpa-flows",
746 .args_type = "name:s,tbl_id:i?",
747 .params = "name [tbl_id]",
748 .help = "Show rocker OF-DPA flow tables",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400749 .cmd = hmp_rocker_of_dpa_flows,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300750 },
751
Peter Maydella12e74c2020-02-28 15:36:07 +0000752SRST
753 ``info rocker-of-dpa-flows`` *name* [*tbl_id*]
754 Show rocker OF-DPA flow tables.
755ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300756
757 {
758 .name = "rocker-of-dpa-groups",
759 .args_type = "name:s,type:i?",
760 .params = "name [type]",
761 .help = "Show rocker OF-DPA groups",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400762 .cmd = hmp_rocker_of_dpa_groups,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300763 },
764
Peter Maydella12e74c2020-02-28 15:36:07 +0000765SRST
766 ``info rocker-of-dpa-groups`` *name* [*type*]
767 Show rocker OF-DPA groups.
768ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300769
770#if defined(TARGET_S390X)
771 {
772 .name = "skeys",
773 .args_type = "addr:l",
774 .params = "address",
775 .help = "Display the value of a storage key",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400776 .cmd = hmp_info_skeys,
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300777 },
778#endif
779
Peter Maydella12e74c2020-02-28 15:36:07 +0000780SRST
781 ``info skeys`` *address*
782 Display the value of a storage key (s390 only)
783ERST
Pavel Butsykinda76ee72015-09-10 18:38:58 +0300784
Claudio Imbrendaf860d492016-08-15 18:44:04 +0200785#if defined(TARGET_S390X)
786 {
787 .name = "cmma",
788 .args_type = "addr:l,count:l?",
789 .params = "address [count]",
790 .help = "Display the values of the CMMA storage attributes for a range of pages",
791 .cmd = hmp_info_cmma,
792 },
793#endif
794
Peter Maydella12e74c2020-02-28 15:36:07 +0000795SRST
796 ``info cmma`` *address*
797 Display the values of the CMMA storage attributes for a range of
798 pages (s390 only)
799ERST
Claudio Imbrendaf860d492016-08-15 18:44:04 +0200800
Peter Xu4a6b52d2016-02-18 13:16:55 +0800801 {
802 .name = "dump",
803 .args_type = "",
804 .params = "",
805 .help = "Display the latest dump status",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400806 .cmd = hmp_info_dump,
Peter Xu4a6b52d2016-02-18 13:16:55 +0800807 },
808
Peter Maydella12e74c2020-02-28 15:36:07 +0000809SRST
810 ``info dump``
811 Display the latest dump status.
812ERST
Peter Xu4a6b52d2016-02-18 13:16:55 +0800813
Bharata B Raod2d8d462016-06-10 06:29:07 +0530814 {
Peter Xube9b23c2017-05-12 12:17:41 +0800815 .name = "ramblock",
816 .args_type = "",
817 .params = "",
818 .help = "Display system ramblock information",
819 .cmd = hmp_info_ramblock,
820 },
821
Peter Maydella12e74c2020-02-28 15:36:07 +0000822SRST
823 ``info ramblock``
824 Dump all the ramblocks of the system.
825ERST
Peter Xube9b23c2017-05-12 12:17:41 +0800826
827 {
Bharata B Raod2d8d462016-06-10 06:29:07 +0530828 .name = "hotpluggable-cpus",
829 .args_type = "",
830 .params = "",
831 .help = "Show information about hotpluggable CPUs",
Marc-André Lureau2b9e3572016-09-12 13:19:06 +0400832 .cmd = hmp_hotpluggable_cpus,
Dr. David Alan Gilbert8c7c7ec2018-06-20 16:39:45 +0100833 .flags = "p",
Bharata B Raod2d8d462016-06-10 06:29:07 +0530834 },
835
Peter Maydella12e74c2020-02-28 15:36:07 +0000836SRST
837 ``info hotpluggable-cpus``
838 Show information about hotpluggable CPUs
839ERST
Bharata B Raod2d8d462016-06-10 06:29:07 +0530840
Igor Mammedov39164c12017-02-16 15:15:37 -0800841 {
842 .name = "vm-generation-id",
843 .args_type = "",
844 .params = "",
845 .help = "Show Virtual Machine Generation ID",
846 .cmd = hmp_info_vm_generation_id,
847 },
848
Peter Maydella12e74c2020-02-28 15:36:07 +0000849SRST
850 ``info vm-generation-id``
851 Show Virtual Machine Generation ID
852ERST
Vadim Galitsynd0f63c12017-08-29 17:30:22 +0200853
854 {
855 .name = "memory_size_summary",
856 .args_type = "",
857 .params = "",
858 .help = "show the amount of initially allocated and "
859 "present hotpluggable (if enabled) memory in bytes.",
860 .cmd = hmp_info_memory_size_summary,
861 },
862
Peter Maydella12e74c2020-02-28 15:36:07 +0000863SRST
864 ``info memory_size_summary``
865 Display the amount of initially allocated and present hotpluggable (if
866 enabled) memory in bytes.
867ERST
Markus Armbrustera9272512017-10-02 15:45:37 +0200868
Brijesh Singh63036312018-03-08 06:48:47 -0600869#if defined(TARGET_I386)
870 {
871 .name = "sev",
872 .args_type = "",
873 .params = "",
874 .help = "show SEV information",
875 .cmd = hmp_info_sev,
876 },
877#endif
878
Peter Maydella12e74c2020-02-28 15:36:07 +0000879SRST
880 ``info sev``
881 Show SEV information.
882ERST
Brijesh Singh63036312018-03-08 06:48:47 -0600883
Pavel Butsykin2cd8af22015-09-10 18:39:01 +0300884