Go to file
Cole Robinson abbc828b70 VirtualGraphics: Don't lookup local keymap over and over
Triggered with virt-manager: new vm -> customize before install with a
non qemu. Guest.get_xml_config copies each device so it can set defaults
in a non persistent way. Unfortunately VirtualGraphics was copied before
a keymap lookup was ever done. End result was that we called
util.default_keymap over and over which is slow and floods the logs.
2013-04-13 16:18:03 -04:00
.tx Add transifex config, update docs 2011-03-15 15:05:23 -04:00
data Fix icons when running from srcdir 2013-04-03 20:29:47 -04:00
man man: virt-install: Update fedora URL examples 2013-04-04 11:59:28 -04:00
po Fix wrapper scripts 2013-04-10 17:45:13 -04:00
tests tests: Replace 'scriptimports' with a much simpler method 2013-04-13 15:38:53 -04:00
ui IPv6 support v2: update the create network wizard 2013-04-03 21:32:57 -04:00
virtManager virtinst: util: Simplify randomUUID 2013-04-13 15:48:06 -04:00
virtManagerTui virtinst: util: Simplify randomUUID 2013-04-13 15:48:06 -04:00
virtcli Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virtconv Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virtinst VirtualGraphics: Don't lookup local keymap over and over 2013-04-13 16:18:03 -04:00
.gitignore tests: Replace 'scriptimports' with a much simpler method 2013-04-13 15:38:53 -04:00
.mailmap Add .mailmap 2013-04-03 18:13:25 -04:00
AUTHORS IPv6 support v2: update gui python and ui 2013-04-03 21:32:42 -04:00
COPYING Refresh GPL text with latest FSF address & fix spec file license tag 2007-11-20 11:12:20 -05:00
HACKING Merge HACKING from virtinst 2013-04-03 19:42:59 -04:00
INSTALL Update INSTALL for the new world order 2013-04-03 19:40:40 -04:00
MANIFEST.in Simplify MANIFEST 2013-04-13 14:17:28 -04:00
NEWS Prep for release 0.9.5 2013-04-01 07:36:57 -04:00
README Remove autotools, replace with distutils-extra 2013-04-03 18:20:51 -04:00
autobuild.sh make autobuild.sh work 2013-04-10 17:49:18 -04:00
setup.py tests: Replace 'scriptimports' with a much simpler method 2013-04-13 15:38:53 -04:00
todo.txt Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virt-clone Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virt-convert Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virt-image Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virt-install Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virt-manager Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virt-manager-tui Revive pep8 and clean up the code 2013-04-13 15:22:43 -04:00
virt-manager.spec Install virtcli directory 2013-04-10 17:45:12 -04:00

README

 Virtual Machine Manager
 =======================

This application provides a graphical tool for managing virtual machines
via the libvirt library.

The front end of the application uses the PyGTK / Glade libraries for
all user interaction components. The back end uses libvirt for managing
Xen, QEMU & KVM virtual machines. The UI is primarily tested with Xen
and QEMU, but is intended to be portable to any virtualization backend
libvirt supports. So when libvirt is ported to UML / VMware / etc the
UI should not require any significant changes to deal with these drivers.

Terminology
-----------

In prose this app should be referred to as 'Virtual Machine Manager'.
For source / RPM packaging, & the command name, it is called by the
shortened form 'virt-manager'

Pre-requisite software
----------------------

Where versions are noted below these are the versions tested to definitely
work. For some of them you may be able to run with earlier releases, so
please report any success to the mailing lists

 python  >= 2.4
 pygtk2 >= 1.99.12-6
 gnome-python2-gconf >= 1.99.11-7
 libvirt-python >= 0.4.0
 dbus-python >= 0.61
 gnome-keyring >= 0.4.9
 gnome-python-desktop >= 2.15.4
 libxml2-python >= 2.6.23
 vte >= 0.12.2
 gtk-vnc >= 0.0.1
 python-virtinst >= 0.300.0
 PolicyKit >= 0.6

The latter is available from

http://git.fedorahosted.org/git/python-virtinst.git

Contact
-------

All comments / suggestions / patches should be directed to the virt-tools-list
mailing list:

  http://www.redhat.com/mailman/listinfo/virt-tools-list

For bug reporting info, see:

http://virt-manager.org/page/BugReporting

There are further project details on the website:

  http://virt-manager.org/

Submitting patches
------------------

Patches should be submitted either as unified diffs:

   tar zxvf virt-manager-X.Y.Z.tar.gz
   cp -a virt-manager-X.Y.Z virt-manager-X.Y.Z-myfeature
   cd virt-manager-X.Y.Z-myfeature
   ... make some changes ..
   cd ..
   diff -ruN virt-manager-X.Y.Z virt-manager-X.Y.Z-myfeature \
      > myfeature.patch

Alternatively use git and submit a diff against the main source repository:

   git clone git://git.fedorahosted.org/git/virt-manager.git
   cd virt-manager
   ... make your changes ...
   git commit -a -m "Some changelog message"
   git show > my_feature.patch

Then mail the 'my_feature.patch' file to the virt-tools-list@redhat.com list,
with [PATCH] and a brief description in the subject.

Using git format-patch and/or git send-email is also fine.

Related software
----------------

Links which are relevant:

  http://libvirt.org
  http://www.linux-kvm.org
  http://xensource.com/xen/
  http://pygtk.org/
  http://gtk.org/
  http://gtk-vnc.sourceforge.net/

Copyright /  License
--------------------

Unless otherwise noted, all the code for the Virtual Machine Manager
is covered under the GPL, and Copyright (C) Red Hat.

  Notes on translation process
  ============================

The translations for virt-manager are handled via transifex.net.
To pull in the latest translations requires the transifex-client package:

  tx pull
  make update-po

Translators can easily sign up to contribute:

http://help.transifex.net/