qemuctl(1)																qemuctl(1)

NAME

       qemuctl - Graphical control for qemu

SYNTAX

       qemuctl [-suspend-dir <dir>] [-suspend-file <filename>] [-qemu <qemu>]  [-nowakeup] qemu-options

DESCRIPTION

       qemuctl	is a gui that controls a qemu process with the built-in monitor of qemu. So you can change devices, suspend machines, save screen-
       shots, ...

       If you suspend a machine it will do the following macro:

       stop
       screendump "suspend-dir/suspend-file.ppm"
       savevm "suspend-dir/suspend-file.vm"
       commit
       quit

       You can afterwards resume the machine with:

       qemuctl -suspend-dir suspend-dir -suspend-file suspend-file your_qemu_options
       the suspend-files will then be deleted
       or
       qemuctl -loadvm suspend-dir/suspend-file.vm your_qemu_options

       Be aware that you can't use the "-monitor" option with qemuctl, because it needs the control over the monitor. The option  "-serial  stdio"
       can't be used, too.

OPTIONS

       -suspend-file <filename>
	      This  option  is	normaly  used by qemuctl to support suspend and wakeup. qemuctl can then find the vm-state-file in its folders and
	      wakeup the virtual machine. If the file is there the qemuctl waes up the virtual machine and deletes the file afterwards. On suspend
	      the  vm-state-file is then stored as the <filename> with the .vm ending and the screenshot is stored as the <filename> with the .ppm
	      ending.
	      Default filename is "suspend".

       -suspend-dir <dir>
	      This is the dir where the suspend files would be stored or expected.
	      Default is current dir.

       -nowakeup
	      Don't wake up even if the vm-file is there. Suspend still works.
	      Default is to wake up using the vm-file if it is there.

       -qemu <qemu>
	      The qemu variation to use. It can be qemu or kvm.
	      Default is qemu.

       qemu-options
	      Use qemu-options for the launch of qemu. See qemu(1) for further details.

FILES

       none

ENVIRONMENT VARIABLES

       none

EXAMPLES

       To use the suspend file 'Debian 3.1' and store/search it in the '/qemu' dir:

       qemuctl -suspend-file "Debian 3.1" -suspend-dir "/qemu" -boot c -hda hda.raw

       Alternativly you can run it with default suspend filenames:

       qemuctl -boot c -hda hda.raw

AUTHORS

       Peter Rustler

SEE ALSO

       qemu(1) qemu-launcher(1)

Peter Rustler							       0.0.1								qemuctl(1)