From Fedora Project Wiki

< Features

Revision as of 12:51, 11 July 2011 by Rjones (talk | contribs) (Release Notes)

Virt-manager Guest Inspection


Virt-manager displays the operating system and applications within a guest, and allows the filesystems and Windows Registry of a guest to be browsed (read-only).


  • Email:,

Current status

  • Targeted release: Fedora 16
  • Last updated: 2011-07-05
  • Percentage of completion: 10%

Detailed Description

We are adding several related features to virt-manager, all revolving around what we call guest inspection.

The first is that virt-manager will display operating system icons next to each guest in the main window. Screenshot Resolution of legal issues

The second is that in the virt-manager "details" window we display extra details. In particular the name of the installed operating system and the list of applications. Screenshot

The third is that there will be a button in virt-manager which will let you open up the guest filesystem and browse it graphically. For graphical browsing, this will be read-only. Screenshot

The fourth is that you will be able to browse (read-only) into Windows Registry entries. Screenshot

Benefit to Fedora

This is as far as we know a completely unique feature, that even other KVM-based Linux distros won't have for a while, and certainly no other hypervisor has.


This change is isolated to the components affected, which are:

  • virt-manager
  • libguestfs >= 1.12.0 (future stable release)

How To Test

No special hardware is required to test this.

Users will need to have compatible KVM virtual machines installed, and be using libvirt. Almost any Linux or Windows guest should be compatible. FreeBSD, Solaris, etc. guests cannot be inspected at this time, although their presence should not affect inspection of other guests.

The user will simply need to run virt-manager. After a short period of time, icons will appear in the main window, and when clicking into the "details" window, the other features will be seen.

User Experience

Users will have a richer experience in virt-manager.



Contingency Plan

We will revert back to the earlier version of virt-manager, or we will disable the inspection code before release.


Patches are posted and discussed on the virt-tools mailing list.

Release Notes

virt-manager can now examine a virtual machine to determine the version of the operating system and what applications are installed.

Comments and Discussion