about qemu-gtk
==============

This is a simple gtk-based gui for qemu.  It is designed to run
independant from the qemu process, so you can stop and restart the gui
without disturbing your virtual machines.

qemu-gtk doesn't support starting a new virtual machines.  It can only
connect to a already running qemu process.

qemu-gtk-run is a perl script for starting virtual machines.  Gets the
vm configuration from libvirt.

Both tools come with a manual page for documentation.


qemu-gtk quickstart
-------------------

qemu-gtk connects to the qemu monitor using tcp or unix sockets and to
the built-in vnc server.  Thus you must enable the monitor and vnc
when starting qemu.  The monitor should be in non-blocking server mode.

i.e. you'll start qemu like this:

  "qemu -monitor unix:/tmp/monitor,server,nowait -vnc :1 <more-args>"

then the gui like this:

  "qemu-gtk unix:/tmp/monitor"

qemu-gtk will figure automatically where the vnc display is, using the
monitor.


qemu-gtk-run quickstart
-----------------------

qemu-gtk-run fetches the configuration from libvirt (via virsh dumpxml
$name), assembles a qemu command line from that, then starts qemu
directly (i.e. *not* using libvirt for management).  It also starts
qemu-gtk.  Just "qemu-gtk-run $name" starts your VM.


Have fun,
  Gerd

--
Gerd Hoffmann <kraxel@redhat.com>