xref: /qemu/hmp-commands-info.hx (revision 2c533c54) 
1HXCOMM Use DEFHEADING() to define headings in both help text and texi
2HXCOMM Text between STEXI and ETEXI are copied to texi version and
3HXCOMM discarded from C version
4HXCOMM DEF(command, args, callback, arg_string, help) is used to construct
5HXCOMM monitor info commands
6HXCOMM HXCOMM can be used for comments, discarded from both texi and C
7
8STEXI
9@table @option
10@item info @var{subcommand}
11@findex info
12Show various information about the system state.
13@table @option
14ETEXI
15
16    {
17        .name       = "version",
18        .args_type  = "",
19        .params     = "",
20        .help       = "show the version of QEMU",
21        .mhandler.cmd = hmp_info_version,
22    },
23
24STEXI
25@item info version
26@findex version
27Show the version of QEMU.
28ETEXI
29
30    {
31        .name       = "network",
32        .args_type  = "",
33        .params     = "",
34        .help       = "show the network state",
35        .mhandler.cmd = hmp_info_network,
36    },
37
38STEXI
39@item info network
40@findex network
41Show the network state.
42ETEXI
43
44    {
45        .name       = "chardev",
46        .args_type  = "",
47        .params     = "",
48        .help       = "show the character devices",
49        .mhandler.cmd = hmp_info_chardev,
50    },
51
52STEXI
53@item info chardev
54@findex chardev
55Show the character devices.
56ETEXI
57
58    {
59        .name       = "block",
60        .args_type  = "nodes:-n,verbose:-v,device:B?",
61        .params     = "[-n] [-v] [device]",
62        .help       = "show info of one block device or all block devices "
63                      "(-n: show named nodes; -v: show details)",
64        .mhandler.cmd = hmp_info_block,
65    },
66
67STEXI
68@item info block
69@findex block
70Show info of one block device or all block devices.
71ETEXI
72
73    {
74        .name       = "blockstats",
75        .args_type  = "",
76        .params     = "",
77        .help       = "show block device statistics",
78        .mhandler.cmd = hmp_info_blockstats,
79    },
80
81STEXI
82@item info blockstats
83@findex blockstats
84Show block device statistics.
85ETEXI
86
87    {
88        .name       = "block-jobs",
89        .args_type  = "",
90        .params     = "",
91        .help       = "show progress of ongoing block device operations",
92        .mhandler.cmd = hmp_info_block_jobs,
93    },
94
95STEXI
96@item info block-jobs
97@findex block-jobs
98Show progress of ongoing block device operations.
99ETEXI
100
101    {
102        .name       = "registers",
103        .args_type  = "",
104        .params     = "",
105        .help       = "show the cpu registers",
106        .mhandler.cmd = hmp_info_registers,
107    },
108
109STEXI
110@item info registers
111@findex registers
112Show the cpu registers.
113ETEXI
114
115#if defined(TARGET_I386)
116    {
117        .name       = "lapic",
118        .args_type  = "",
119        .params     = "",
120        .help       = "show local apic state",
121        .mhandler.cmd = hmp_info_local_apic,
122    },
123#endif
124
125STEXI
126@item info lapic
127@findex lapic
128Show local APIC state
129ETEXI
130
131#if defined(TARGET_I386)
132    {
133        .name       = "ioapic",
134        .args_type  = "",
135        .params     = "",
136        .help       = "show io apic state",
137        .mhandler.cmd = hmp_info_io_apic,
138    },
139#endif
140
141STEXI
142@item info ioapic
143@findex ioapic
144Show io APIC state
145ETEXI
146
147    {
148        .name       = "cpus",
149        .args_type  = "",
150        .params     = "",
151        .help       = "show infos for each CPU",
152        .mhandler.cmd = hmp_info_cpus,
153    },
154
155STEXI
156@item info cpus
157@findex cpus
158Show infos for each CPU.
159ETEXI
160
161    {
162        .name       = "history",
163        .args_type  = "",
164        .params     = "",
165        .help       = "show the command line history",
166        .mhandler.cmd = hmp_info_history,
167    },
168
169STEXI
170@item info history
171@findex history
172Show the command line history.
173ETEXI
174
175#if defined(TARGET_I386) || defined(TARGET_PPC) || defined(TARGET_MIPS) || \
176    defined(TARGET_LM32) || (defined(TARGET_SPARC) && !defined(TARGET_SPARC64))
177    {
178        .name       = "irq",
179        .args_type  = "",
180        .params     = "",
181        .help       = "show the interrupts statistics (if available)",
182#ifdef TARGET_SPARC
183        .mhandler.cmd = sun4m_hmp_info_irq,
184#elif defined(TARGET_LM32)
185        .mhandler.cmd = lm32_hmp_info_irq,
186#else
187        .mhandler.cmd = hmp_info_irq,
188#endif
189    },
190
191STEXI
192@item info irq
193@findex irq
194Show the interrupts statistics (if available).
195ETEXI
196
197    {
198        .name       = "pic",
199        .args_type  = "",
200        .params     = "",
201        .help       = "show i8259 (PIC) state",
202#ifdef TARGET_SPARC
203        .mhandler.cmd = sun4m_hmp_info_pic,
204#elif defined(TARGET_LM32)
205        .mhandler.cmd = lm32_hmp_info_pic,
206#else
207        .mhandler.cmd = hmp_info_pic,
208#endif
209    },
210#endif
211
212STEXI
213@item info pic
214@findex pic
215Show i8259 (PIC) state.
216ETEXI
217
218    {
219        .name       = "pci",
220        .args_type  = "",
221        .params     = "",
222        .help       = "show PCI info",
223        .mhandler.cmd = hmp_info_pci,
224    },
225
226STEXI
227@item info pci
228@findex pci
229Show PCI information.
230ETEXI
231
232#if defined(TARGET_I386) || defined(TARGET_SH4) || defined(TARGET_SPARC) || \
233    defined(TARGET_PPC) || defined(TARGET_XTENSA)
234    {
235        .name       = "tlb",
236        .args_type  = "",
237        .params     = "",
238        .help       = "show virtual to physical memory mappings",
239        .mhandler.cmd = hmp_info_tlb,
240    },
241#endif
242
243STEXI
244@item info tlb
245@findex tlb
246Show virtual to physical memory mappings.
247ETEXI
248
249#if defined(TARGET_I386)
250    {
251        .name       = "mem",
252        .args_type  = "",
253        .params     = "",
254        .help       = "show the active virtual memory mappings",
255        .mhandler.cmd = hmp_info_mem,
256    },
257#endif
258
259STEXI
260@item info mem
261@findex mem
262Show the active virtual memory mappings.
263ETEXI
264
265    {
266        .name       = "mtree",
267        .args_type  = "",
268        .params     = "",
269        .help       = "show memory tree",
270        .mhandler.cmd = hmp_info_mtree,
271    },
272
273STEXI
274@item info mtree
275@findex mtree
276Show memory tree.
277ETEXI
278
279    {
280        .name       = "jit",
281        .args_type  = "",
282        .params     = "",
283        .help       = "show dynamic compiler info",
284        .mhandler.cmd = hmp_info_jit,
285    },
286
287STEXI
288@item info jit
289@findex jit
290Show dynamic compiler info.
291ETEXI
292
293    {
294        .name       = "opcount",
295        .args_type  = "",
296        .params     = "",
297        .help       = "show dynamic compiler opcode counters",
298        .mhandler.cmd = hmp_info_opcount,
299    },
300
301STEXI
302@item info opcount
303@findex opcount
304Show dynamic compiler opcode counters
305ETEXI
306
307    {
308        .name       = "kvm",
309        .args_type  = "",
310        .params     = "",
311        .help       = "show KVM information",
312        .mhandler.cmd = hmp_info_kvm,
313    },
314
315STEXI
316@item info kvm
317@findex kvm
318Show KVM information.
319ETEXI
320
321    {
322        .name       = "numa",
323        .args_type  = "",
324        .params     = "",
325        .help       = "show NUMA information",
326        .mhandler.cmd = hmp_info_numa,
327    },
328
329STEXI
330@item info numa
331@findex numa
332Show NUMA information.
333ETEXI
334
335    {
336        .name       = "usb",
337        .args_type  = "",
338        .params     = "",
339        .help       = "show guest USB devices",
340        .mhandler.cmd = hmp_info_usb,
341    },
342
343STEXI
344@item info usb
345@findex usb
346Show guest USB devices.
347ETEXI
348
349    {
350        .name       = "usbhost",
351        .args_type  = "",
352        .params     = "",
353        .help       = "show host USB devices",
354        .mhandler.cmd = hmp_info_usbhost,
355    },
356
357STEXI
358@item info usbhost
359@findex usbhost
360Show host USB devices.
361ETEXI
362
363    {
364        .name       = "profile",
365        .args_type  = "",
366        .params     = "",
367        .help       = "show profiling information",
368        .mhandler.cmd = hmp_info_profile,
369    },
370
371STEXI
372@item info profile
373@findex profile
374Show profiling information.
375ETEXI
376
377    {
378        .name       = "capture",
379        .args_type  = "",
380        .params     = "",
381        .help       = "show capture information",
382        .mhandler.cmd = hmp_info_capture,
383    },
384
385STEXI
386@item info capture
387@findex capture
388Show capture information.
389ETEXI
390
391    {
392        .name       = "snapshots",
393        .args_type  = "",
394        .params     = "",
395        .help       = "show the currently saved VM snapshots",
396        .mhandler.cmd = hmp_info_snapshots,
397    },
398
399STEXI
400@item info snapshots
401@findex snapshots
402Show the currently saved VM snapshots.
403ETEXI
404
405    {
406        .name       = "status",
407        .args_type  = "",
408        .params     = "",
409        .help       = "show the current VM status (running|paused)",
410        .mhandler.cmd = hmp_info_status,
411    },
412
413STEXI
414@item info status
415@findex status
416Show the current VM status (running|paused).
417ETEXI
418
419    {
420        .name       = "mice",
421        .args_type  = "",
422        .params     = "",
423        .help       = "show which guest mouse is receiving events",
424        .mhandler.cmd = hmp_info_mice,
425    },
426
427STEXI
428@item info mice
429@findex mice
430Show which guest mouse is receiving events.
431ETEXI
432
433    {
434        .name       = "vnc",
435        .args_type  = "",
436        .params     = "",
437        .help       = "show the vnc server status",
438        .mhandler.cmd = hmp_info_vnc,
439    },
440
441STEXI
442@item info vnc
443@findex vnc
444Show the vnc server status.
445ETEXI
446
447#if defined(CONFIG_SPICE)
448    {
449        .name       = "spice",
450        .args_type  = "",
451        .params     = "",
452        .help       = "show the spice server status",
453        .mhandler.cmd = hmp_info_spice,
454    },
455#endif
456
457STEXI
458@item info spice
459@findex spice
460Show the spice server status.
461ETEXI
462
463    {
464        .name       = "name",
465        .args_type  = "",
466        .params     = "",
467        .help       = "show the current VM name",
468        .mhandler.cmd = hmp_info_name,
469    },
470
471STEXI
472@item info name
473@findex name
474Show the current VM name.
475ETEXI
476
477    {
478        .name       = "uuid",
479        .args_type  = "",
480        .params     = "",
481        .help       = "show the current VM UUID",
482        .mhandler.cmd = hmp_info_uuid,
483    },
484
485STEXI
486@item info uuid
487@findex uuid
488Show the current VM UUID.
489ETEXI
490
491    {
492        .name       = "cpustats",
493        .args_type  = "",
494        .params     = "",
495        .help       = "show CPU statistics",
496        .mhandler.cmd = hmp_info_cpustats,
497    },
498
499STEXI
500@item info cpustats
501@findex cpustats
502Show CPU statistics.
503ETEXI
504
505#if defined(CONFIG_SLIRP)
506    {
507        .name       = "usernet",
508        .args_type  = "",
509        .params     = "",
510        .help       = "show user network stack connection states",
511        .mhandler.cmd = hmp_info_usernet,
512    },
513#endif
514
515STEXI
516@item info usernet
517@findex usernet
518Show user network stack connection states.
519ETEXI
520
521    {
522        .name       = "migrate",
523        .args_type  = "",
524        .params     = "",
525        .help       = "show migration status",
526        .mhandler.cmd = hmp_info_migrate,
527    },
528
529STEXI
530@item info migrate
531@findex migrate
532Show migration status.
533ETEXI
534
535    {
536        .name       = "migrate_capabilities",
537        .args_type  = "",
538        .params     = "",
539        .help       = "show current migration capabilities",
540        .mhandler.cmd = hmp_info_migrate_capabilities,
541    },
542
543STEXI
544@item info migrate_capabilities
545@findex migrate_capabilities
546Show current migration capabilities.
547ETEXI
548
549    {
550        .name       = "migrate_parameters",
551        .args_type  = "",
552        .params     = "",
553        .help       = "show current migration parameters",
554        .mhandler.cmd = hmp_info_migrate_parameters,
555    },
556
557STEXI
558@item info migrate_parameters
559@findex migrate_parameters
560Show current migration parameters.
561ETEXI
562
563    {
564        .name       = "migrate_cache_size",
565        .args_type  = "",
566        .params     = "",
567        .help       = "show current migration xbzrle cache size",
568        .mhandler.cmd = hmp_info_migrate_cache_size,
569    },
570
571STEXI
572@item info migrate_cache_size
573@findex migrate_cache_size
574Show current migration xbzrle cache size.
575ETEXI
576
577    {
578        .name       = "balloon",
579        .args_type  = "",
580        .params     = "",
581        .help       = "show balloon information",
582        .mhandler.cmd = hmp_info_balloon,
583    },
584
585STEXI
586@item info balloon
587@findex balloon
588Show balloon information.
589ETEXI
590
591    {
592        .name       = "qtree",
593        .args_type  = "",
594        .params     = "",
595        .help       = "show device tree",
596        .mhandler.cmd = hmp_info_qtree,
597    },
598
599STEXI
600@item info qtree
601@findex qtree
602Show device tree.
603ETEXI
604
605    {
606        .name       = "qdm",
607        .args_type  = "",
608        .params     = "",
609        .help       = "show qdev device model list",
610        .mhandler.cmd = hmp_info_qdm,
611    },
612
613STEXI
614@item info qdm
615@findex qdm
616Show qdev device model list.
617ETEXI
618
619    {
620        .name       = "qom-tree",
621        .args_type  = "path:s?",
622        .params     = "[path]",
623        .help       = "show QOM composition tree",
624        .mhandler.cmd = hmp_info_qom_tree,
625    },
626
627STEXI
628@item info qom-tree
629@findex qom-tree
630Show QOM composition tree.
631ETEXI
632
633    {
634        .name       = "roms",
635        .args_type  = "",
636        .params     = "",
637        .help       = "show roms",
638        .mhandler.cmd = hmp_info_roms,
639    },
640
641STEXI
642@item info roms
643@findex roms
644Show roms.
645ETEXI
646
647    {
648        .name       = "trace-events",
649        .args_type  = "name:s?,vcpu:i?",
650        .params     = "[name] [vcpu]",
651        .help       = "show available trace-events & their state "
652                      "(name: event name pattern; vcpu: vCPU to query, default is any)",
653        .mhandler.cmd = hmp_info_trace_events,
654        .command_completion = info_trace_events_completion,
655    },
656
657STEXI
658@item info trace-events
659@findex trace-events
660Show available trace-events & their state.
661ETEXI
662
663    {
664        .name       = "tpm",
665        .args_type  = "",
666        .params     = "",
667        .help       = "show the TPM device",
668        .mhandler.cmd = hmp_info_tpm,
669    },
670
671STEXI
672@item info tpm
673@findex tpm
674Show the TPM device.
675ETEXI
676
677    {
678        .name       = "memdev",
679        .args_type  = "",
680        .params     = "",
681        .help       = "show memory backends",
682        .mhandler.cmd = hmp_info_memdev,
683    },
684
685STEXI
686@item info memdev
687@findex memdev
688Show memory backends
689ETEXI
690
691    {
692        .name       = "memory-devices",
693        .args_type  = "",
694        .params     = "",
695        .help       = "show memory devices",
696        .mhandler.cmd = hmp_info_memory_devices,
697    },
698
699STEXI
700@item info memory-devices
701@findex memory-devices
702Show memory devices.
703ETEXI
704
705    {
706        .name       = "iothreads",
707        .args_type  = "",
708        .params     = "",
709        .help       = "show iothreads",
710        .mhandler.cmd = hmp_info_iothreads,
711    },
712
713STEXI
714@item info iothreads
715@findex iothreads
716Show iothread's identifiers.
717ETEXI
718
719    {
720        .name       = "rocker",
721        .args_type  = "name:s",
722        .params     = "name",
723        .help       = "Show rocker switch",
724        .mhandler.cmd = hmp_rocker,
725    },
726
727STEXI
728@item info rocker @var{name}
729@findex rocker
730Show rocker switch.
731ETEXI
732
733    {
734        .name       = "rocker-ports",
735        .args_type  = "name:s",
736        .params     = "name",
737        .help       = "Show rocker ports",
738        .mhandler.cmd = hmp_rocker_ports,
739    },
740
741STEXI
742@item info rocker_ports @var{name}-ports
743@findex ocker-ports
744Show rocker ports.
745ETEXI
746
747    {
748        .name       = "rocker-of-dpa-flows",
749        .args_type  = "name:s,tbl_id:i?",
750        .params     = "name [tbl_id]",
751        .help       = "Show rocker OF-DPA flow tables",
752        .mhandler.cmd = hmp_rocker_of_dpa_flows,
753    },
754
755STEXI
756@item info rocker_of_dpa_flows @var{name} [@var{tbl_id}]
757@findex rocker-of-dpa-flows
758Show rocker OF-DPA flow tables.
759ETEXI
760
761    {
762        .name       = "rocker-of-dpa-groups",
763        .args_type  = "name:s,type:i?",
764        .params     = "name [type]",
765        .help       = "Show rocker OF-DPA groups",
766        .mhandler.cmd = hmp_rocker_of_dpa_groups,
767    },
768
769STEXI
770@item info rocker-of-dpa-groups @var{name} [@var{type}]
771@findex rocker-of-dpa-groups
772Show rocker OF-DPA groups.
773ETEXI
774
775#if defined(TARGET_S390X)
776    {
777        .name       = "skeys",
778        .args_type  = "addr:l",
779        .params     = "address",
780        .help       = "Display the value of a storage key",
781        .mhandler.cmd = hmp_info_skeys,
782    },
783#endif
784
785STEXI
786@item info skeys @var{address}
787@findex skeys
788Display the value of a storage key (s390 only)
789ETEXI
790
791    {
792        .name       = "dump",
793        .args_type  = "",
794        .params     = "",
795        .help       = "Display the latest dump status",
796        .mhandler.cmd = hmp_info_dump,
797    },
798
799STEXI
800@item info dump
801@findex dump
802Display the latest dump status.
803ETEXI
804
805    {
806        .name       = "hotpluggable-cpus",
807        .args_type  = "",
808        .params     = "",
809        .help       = "Show information about hotpluggable CPUs",
810        .mhandler.cmd = hmp_hotpluggable_cpus,
811    },
812
813STEXI
814@item info hotpluggable-cpus
815@findex hotpluggable-cpus
816Show information about hotpluggable CPUs
817ETEXI
818
819STEXI
820@end table
821ETEXI
822
823STEXI
824@end table
825ETEXI
826