.\" Automatically generated by Pandoc 2.17.1.1
.\"
.\" Define V font for inline verbatim, using C font in formats
.\" that render this, and otherwise B font.
.ie "\f[CB]x\f[]"x" \{\
. ftr V B
. ftr VI BI
. ftr VB B
. ftr VBI BI
.\}
.el \{\
. ftr V CR
. ftr VI CI
. ftr VB CB
. ftr VBI CBI
.\}
.TH "QWDCTL" "1" "April 2021" "" ""
.hy
.SH NAME
.PP
qwdctl - Control qemu-web-desktop
.SH SYNOPSIS
.PP
\f[B]qwdctl\f[R] \f[I]keyword\f[R]
.SH DESCRIPTION
.PP
\f[B]qwdctl\f[R] is a simple script that downloads virtual machine
images for use with \f[B]qemu-web-desktop\f[R] and/or refreshes the list
of available images so that \f[B]qemu-web-desktop\f[R] can display it in
its web interface.
.PP
Each entry in the configuration file
\f[V]/etc/qemu-web-desktop/machines.conf\f[R] spans on 3 lines:
.IP \[bu] 2
[name.ext]
.IP \[bu] 2
url=[URL to ISO, QCOW2, VDI, VMDK, RAW virtual machine disk, optional]
.IP \[bu] 2
description=[description to be shown in the service page]
.PP
Images listed in the configuration file without a \f[V]url=\f[R]
parameter are expected to be downloaded by hand and installed into
\f[V]/var/lib/qemu-web-desktop/machines\f[R] by the local administrator.
Then, just specify the [name.ext] and description.
.SH SUBCOMMANDS
.TP
\f[B]download\f[R]
Downloads virtual machine images referenced in the
\f[V]/etc/qemu-web-desktop/machines.conf\f[R] file.
A \f[B]refresh\f[R] is automatically launched afterwards.
.TP
\f[B]refresh\f[R]
Regenerates the list of available images based on the
\f[V]/etc/qemu-web-desktop/machines.conf\f[R] file.
The generated file is
e.g.\ \f[V]/var/lib/qemu-web-desktop/machines.html\f[R] which should be
linked into \f[V]/usr/share/qemu-web-desktop/html/desktop/\f[R].
.SH FILES
.IP \[bu] 2
/etc/qemu-web-desktop/machines.conf
.IP \[bu] 2
/var/lib/qemu-web-desktop/machines.html
.IP \[bu] 2
/var/lib/qemu-web-desktop/machines
.IP \[bu] 2
/usr/share/qemu-web-desktop/html/desktop
.SH AUTHORS
Roland Mas.