openkylin
/
virt-manager
mirror of https://gitee.com/openkylin/virt-manager.git
9
0
Fork 0
Code Issues Projects Releases Wiki Activity
2,462 Commits 7 Branches 6 Tags 91 MiB
Python 99.9%
Go to file
Cole Robinson 13dd371e48 Don't let media polling block app if a connection goes down 
If we unplug a remote machine we are connected to, doing the media
timeout with a gobject timeout means running it in the main thread,
which if it's blocking on the remote connection will freeze the whole
app.
 		2012-02-08 14:15:15 -05:00
.tx Add transifex config, update docs 2011-03-15 15:05:23 -04:00
docs Add transifex config, update docs 2011-03-15 15:05:23 -04:00
help help: Use a valid category 2010-05-13 11:26:07 -04:00
icons Add new app icon and massively reorg our icon folder 2011-07-12 14:35:33 -04:00
m4 Hooked up David Malcolm's 'sparkline' widget for CPU display 2006-06-26 17:17:45 -04:00
man Don't show 'perl' in man page 2009-12-14 17:19:52 -05:00
po Update translations (and make em work with gtkbuilder) 2012-02-02 17:40:33 -05:00
src Don't let media polling block app if a connection goes down 2012-02-08 14:15:15 -05:00
tests Fix pylint detection, and clean up the fallout 2012-01-31 19:07:32 -05:00
.gitignore Add new app icon and massively reorg our icon folder 2011-07-12 14:35:33 -04:00
ABOUT-NLS Major rework of i18n build integration to deal with bz 229324 2007-05-18 12:14:33 -04:00
AUTHORS createnet: Allow networks smaller than 16 addresses 2012-01-29 19:50:23 -05:00
COPYING Refresh GPL text with latest FSF address & fix spec file license tag 2007-11-20 11:12:20 -05:00
COPYING-DOCS Initial cut at help infrastructure. Help builds and displays, but says nothing. Now we can start filling in content. 2007-03-02 16:24:35 -05:00
ChangeLog Empty the 'ChangeLog', point to gitweb 2011-03-15 11:47:12 -04:00
HACKING HACKING: Mention pep8 dep 2011-07-18 14:10:29 -04:00
INSTALL Update repo links and crufty docs 2011-03-15 11:47:12 -04:00
INSTALL.autotools Add simple INSTALL instructions 2010-11-30 10:29:42 -05:00
Makefile.am Add new app icon and massively reorg our icon folder 2011-07-12 14:35:33 -04:00
NEWS Prep for release 2012-01-31 20:23:23 -05:00
README Small tweak for contribute instructions 2011-03-15 12:20:57 -04:00
TODO Update repo links and crufty docs 2011-03-15 11:47:12 -04:00
autobuild.sh Add simple INSTALL instructions 2010-11-30 10:29:42 -05:00
autogen.sh autogen: Don't fail when config.status doesn't exist 2010-10-20 17:29:17 +03:00
configure.ac Prep for release 2012-01-31 20:23:23 -05:00
omf.make Update omf.make and xmldocs.make to fix distcheck 2010-03-15 13:28:55 -04:00
virt-manager.spec.in Build system changes for UI move 2012-02-02 17:09:20 -05:00
xmldocs.make Update omf.make and xmldocs.make to fix distcheck 2010-03-15 13:28:55 -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.

-- End of broadcast!