Man Linux: Main Page and Category List

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