The man page is not up to date for now.
A new man page for 0.3.0 and up has not been written.

qemuctl

 

NAME

qemuctl - Graphical control for qemu  

SYNTAX

qemuctl [-suspend-dir <dir>] [-suspend-file <filename>] [-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 screenshots, ...

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-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)


 

Index

NAME
SYNTAX
DESCRIPTION
OPTIONS
FILES
ENVIRONMENT VARIABLES
EXAMPLES
AUTHORS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 02:50:18 GMT, January 19, 2006