Red Hat Training
A Red Hat training course is available for Red Hat Enterprise Linux
20.5. Displaying Information about a Guest Virtual Machine and the Hypervisor
The
virsh list
command will list guest virtual machines connected to your hypervisor that fit the search parameter requested. The output of the command has 3 columns in a table. Each guest virtual machine is listed with its ID, name, and state.
A wide variety of search parameters is available for
virsh list
. These options are available on the man page, by running man virsh
or by running the virsh list --help
command.
Note
Note that this if this command only displays guest virtual machines created by the root user. If it does not display a virtual machine you know you have created, it is probable you did not create the virtual machine as root.
Guests created using the virt-manager interface are by default created by root.
Example 20.1. How to list all locally connected virtual machines
The following example lists all the virtual machines your hypervisor is connected to. Note that this command lists both persistent and transient virtual machines.
# virsh list --all
Id Name State
------------------------------------------------
8 guest1 running
22 guest2 paused
35 guest3 shut off
38 guest4 shut off
Example 20.2. How to list the inactive guest virtual machines
The following example lists guests that are currently inactive, or not running. Note that the list only contains persistent virtual machines.
# virsh list --inactive
Id Name State
------------------------------------------------
35 guest3 shut off
38 guest4 shut off
In addition, the following commands can also be used to display basic information about the hypervisor:
- #
virsh hostname
- displays the hypervisor's host name, for example:#
virsh hostname
dhcp-2-157.eus.myhost.com - #
virsh sysinfo
- displays the XML representation of the hypervisor's system information, if available, for example:#
virsh sysinfo
<sysinfo type='smbios'> <bios> <entry name='vendor'>LENOVO</entry> <entry name='version'>GJET71WW (2.21 )</entry> [...]