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 = "", 650 .params = "", 651 .help = "show available trace-events & their state", 652 .mhandler.cmd = hmp_info_trace_events, 653 }, 654 655STEXI 656@item info trace-events 657@findex trace-events 658Show available trace-events & their state. 659ETEXI 660 661 { 662 .name = "tpm", 663 .args_type = "", 664 .params = "", 665 .help = "show the TPM device", 666 .mhandler.cmd = hmp_info_tpm, 667 }, 668 669STEXI 670@item info tpm 671@findex tpm 672Show the TPM device. 673ETEXI 674 675 { 676 .name = "memdev", 677 .args_type = "", 678 .params = "", 679 .help = "show memory backends", 680 .mhandler.cmd = hmp_info_memdev, 681 }, 682 683STEXI 684@item info memdev 685@findex memdev 686Show memory backends 687ETEXI 688 689 { 690 .name = "memory-devices", 691 .args_type = "", 692 .params = "", 693 .help = "show memory devices", 694 .mhandler.cmd = hmp_info_memory_devices, 695 }, 696 697STEXI 698@item info memory-devices 699@findex memory-devices 700Show memory devices. 701ETEXI 702 703 { 704 .name = "iothreads", 705 .args_type = "", 706 .params = "", 707 .help = "show iothreads", 708 .mhandler.cmd = hmp_info_iothreads, 709 }, 710 711STEXI 712@item info iothreads 713@findex iothreads 714Show iothread's identifiers. 715ETEXI 716 717 { 718 .name = "rocker", 719 .args_type = "name:s", 720 .params = "name", 721 .help = "Show rocker switch", 722 .mhandler.cmd = hmp_rocker, 723 }, 724 725STEXI 726@item info rocker @var{name} 727@findex rocker 728Show rocker switch. 729ETEXI 730 731 { 732 .name = "rocker-ports", 733 .args_type = "name:s", 734 .params = "name", 735 .help = "Show rocker ports", 736 .mhandler.cmd = hmp_rocker_ports, 737 }, 738 739STEXI 740@item info rocker_ports @var{name}-ports 741@findex ocker-ports 742Show rocker ports. 743ETEXI 744 745 { 746 .name = "rocker-of-dpa-flows", 747 .args_type = "name:s,tbl_id:i?", 748 .params = "name [tbl_id]", 749 .help = "Show rocker OF-DPA flow tables", 750 .mhandler.cmd = hmp_rocker_of_dpa_flows, 751 }, 752 753STEXI 754@item info rocker_of_dpa_flows @var{name} [@var{tbl_id}] 755@findex rocker-of-dpa-flows 756Show rocker OF-DPA flow tables. 757ETEXI 758 759 { 760 .name = "rocker-of-dpa-groups", 761 .args_type = "name:s,type:i?", 762 .params = "name [type]", 763 .help = "Show rocker OF-DPA groups", 764 .mhandler.cmd = hmp_rocker_of_dpa_groups, 765 }, 766 767STEXI 768@item info rocker-of-dpa-groups @var{name} [@var{type}] 769@findex rocker-of-dpa-groups 770Show rocker OF-DPA groups. 771ETEXI 772 773#if defined(TARGET_S390X) 774 { 775 .name = "skeys", 776 .args_type = "addr:l", 777 .params = "address", 778 .help = "Display the value of a storage key", 779 .mhandler.cmd = hmp_info_skeys, 780 }, 781#endif 782 783STEXI 784@item info skeys @var{address} 785@findex skeys 786Display the value of a storage key (s390 only) 787ETEXI 788 789 { 790 .name = "dump", 791 .args_type = "", 792 .params = "", 793 .help = "Display the latest dump status", 794 .mhandler.cmd = hmp_info_dump, 795 }, 796 797STEXI 798@item info dump 799@findex dump 800Display the latest dump status. 801ETEXI 802 803STEXI 804@end table 805ETEXI 806 807STEXI 808@end table 809ETEXI 810