Linux list a KVM vm guest using virsh command nixCraft

How do I list a KVM vm guest using virsh command on a Linux based hypervisor?

A hypervisor is nothing but Linux kernel module that isolates operating systems and applications from the underlying server. KVM turn Linux operating system into a hypervisor. This post shows how to list an installed KVM guest VM using virsh command line option.

How to: Linux list a KVM vm guest using virsh command

The syntax is:
virsh list
virsh list --all
virsh list [options]


Let us see some command examples.

Just list domains / KVM VM guest

Simply type the command:
virsh list
virsh list --all
Linux list a KVM vm guest using virsh command
Name is the name of the domain (KVM VM guest name). ID the domain numeric id. State is the run state as follows:

  1. running – The domain is currently running on a CPU.
  2. idle – The domain is idle, and not running or runnable. This can be caused because the domain is waiting on IO (a traditional wait state) or has gone to sleep because there was nothing else for it to do.
  3. paused – The domain has been paused, usually occurring through the administrator running virsh suspend. When in a paused state the domain will still consume allocated resources like memory, but will not be eligible for scheduling by the hypervisor.
  4. in shutdown – The domain is in the process of shutting down, i.e. the guest operating system has been notified and should be in the process of stopping its operations gracefully.
  5. shut off – The domain is not running. Usually this indicates the domain has been shut down completely, or has not been started.
  6. crashed – The domain has crashed, which is always a violent ending. Usually this state can only occur if the domain has been configured not to restart on crash.
  7. pmsuspended – The domain has been suspended by guest power management, e.g. entered into s3 state.

To list domains with autostart enabled

virsh list --autostart
Sample outputs:

 Id Name State
---------------------------------------------------- 1 openbsd62 running 2 freebsd11-nixcraft running 3 fedora28-nixcraft running 4 rhel7 running 5 centos7-nixcraft running 6 sles12sp3 running

Getting help

Linux list a KVM vm guest using virsh command with the following options:
virsh list --help
Sample outputs:

 NAME list - list domains SYNOPSIS list [--inactive] [--all] [--transient] [--persistent] [--with-snapshot] [--without-snapshot] [--state-running] [--state-paused] [--state-shutoff] [--state-other] [--autostart] [--no-autostart] [--with-managed-save] [--without-managed-save] [--uuid] [--name] [--table] [--managed-save] [--title] DESCRIPTION Returns list of domains.

virsh list command options

--inactivelist inactive domains
--alllist inactive & active domains
--transientlist transient domains
--persistentlist persistent domains
--with-snapshotlist domains with existing snapshot
--without-snapshotlist domains without a snapshot
--state-runninglist domains in running state
--state-pausedlist domains in paused state
--state-shutofflist domains in shutoff state
--state-otherlist domains in other states
--autostartlist domains with autostart enabled
--no-autostartlist domains with autostart disabled
--with-managed-savelist domains with managed save state
--without-managed-savelist domains without managed save
--uuidlist uuid’s only
--namelist domain names only
--tablelist table (default)
--managed-savemark inactive domains with managed save state
--titleshow domain title


And there you have it, you know how to get list of KVM VM/domains using the virsh command. For more info see this page or read man page by typing the following man command:
man virsh

Get 15% off on Linux Foundation certified SysAdmin, Progamming, Kubernetes/Containers and Open Stack certification & course. Use “SPLASH15” coupon code. Offer expires on August 27, 2018

Posted by: Vivek Gite

The author is the creator of nixCraft and a seasoned sysadmin, DevOps engineer, and a trainer for the Linux operating system/Unix shell scripting. Get the latest tutorials on SysAdmin, Linux/Unix and open source topics via RSS/XML feed or weekly email newsletter.

Facebook Comments

More Stuff

Don’t be fooled by Pass4Sure Today I received an enquiry sent via my contact page, offering me US$175 if I place some advertising on my site in a certain way. Here’s the full text...
Debian Linux 7 Long Term Support reached end-of-life nixCraft The Debian Linux version 7 (codenamed “Wheezy”) support ended on 31st May 2018. It was initial release on May 4, 2013. Each LTS ( initial release on M...
Installing ImageMagick 6.3.8 on a cPanel Server This tutorial will give you a little step by step manual of how to upgrade and properly install ImageMagick on you cPanel server without having to man...
Updating the WordPress plugin repository with SVN on Mac Having recently switched my development platform from Windows to Mac, and being a published WordPress plugin author, I needed to find a Mac-based repl...
Spread the love

Posted by News Monkey