NAME

       qwdctl - Control qemu-web-desktop

SYNOPSIS

       qwdctl keyword

DESCRIPTION

       qwdctl  is  a  simple  script  that downloads virtual machine images for use with qemu-web-desktop and/or
       refreshes the list of available images so that qemu-web-desktop can display  it  in  its  web  interface.
       Additionally,   mount  points  can  be  made  available  for  the  guests  via  the  `9p'  protocol  (see
       https://wiki.qemu.org/Documentation/9psetup).

       Each entry in the configuration file /etc/qemu-web-desktop/machines.conf spans on 3 lines:

       • [name.ext]

       • url=[URL to ISO, QCOW2, VDI, VMDK, RAW virtual machine disk, optional]

       • description=[description to be shown in the service page]

       Images listed in the configuration file without a url= parameter are expected to be  downloaded  by  hand
       and installed into /var/lib/qemu-web-desktop/machines by the local administrator.  Then, just specify the
       [name.ext] and description.

       You may as well define mounts from the host into the guest with:

       • [/path/to/mount/in/server]

       • mount=[name of mount to appear in the service page]

       The last word of the path defines a `9p' tag `host_[lastword]' mountable in the guest.  Then, mount it in
       the guest with e.g.: - mount -t 9p -o trans=virtio,access=client host_[lastword] [mount point]

SUBCOMMANDS

       download
              Downloads  virtual  machine  images referenced in the /etc/qemu-web-desktop/machines.conf file.  A
              refresh is automatically launched afterwards.

       refresh
              Regenerates  the  list  of   available   images   and   mounts   based   on   the   /etc/qemu-web-
              desktop/machines.conf  file.   The generated file is e.g. /var/lib/qemu-web-desktop/machines.html.
              The mount points are stored in /var/lib/qemu-web-desktop/mounts.html.  Both files should be linked
              as `/usr/share/qemu-web-desktop/html/desktop/

FILES

       • /etc/qemu-web-desktop/machines.conf

       • /var/lib/qemu-web-desktop/machines.html

       • /var/lib/qemu-web-desktop/mount.html

       • /var/lib/qemu-web-desktop/machines

       • /usr/share/qemu-web-desktop/html/desktop

AUTHORS

       Roland Mas.

                                                   April 2021                                          QWDCTL(1)