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