mirror of
https://gitlab.com/libvirt/libvirt.git
synced 2024-08-27 19:11:16 +00:00
Specifically: * use the correct notation and markup for commands, options and arguments; * rename arguments meta-variables to be more descriptive; * sort options so that the most common ones come first; * use consistent vertical spacing; * fix a typo. Signed-off-by: Andrea Bolognani <abologna@redhat.com> Reviewed-by: Ján Tomko <jtomko@redhat.com>
128 lines
3.0 KiB
ReStructuredText
128 lines
3.0 KiB
ReStructuredText
=============
|
|
virt-qemu-run
|
|
=============
|
|
|
|
---------------------------
|
|
Run a standalone QEMU guest
|
|
---------------------------
|
|
|
|
:Manual section: 1
|
|
:Manual group: Virtualization Support
|
|
|
|
.. contents::
|
|
|
|
|
|
SYNOPSIS
|
|
========
|
|
|
|
``virt-qemu-run`` [*OPTION*]... *GUEST-XML-FILE*
|
|
|
|
|
|
DESCRIPTION
|
|
===========
|
|
|
|
This tool provides a way to run a standalone QEMU guest such that it
|
|
is completely independent of libvirtd. It makes use of the embedded
|
|
QEMU driver support to run the VM placing files under an isolated
|
|
directory tree. When the guest is run with this tool it is invisible
|
|
to libvirtd and thus also invisible to other libvirt tools such as
|
|
virsh.
|
|
|
|
The ``virt-qemu-run`` program will run the QEMU virtual machine, and
|
|
then block until the guest OS shuts down, at which point it will
|
|
exit.
|
|
|
|
If the ``virt-qemu-run`` program is interrupted (eg Ctrl-C) it will
|
|
immediately terminate the virtual machine without giving the guest OS
|
|
any opportunity to gracefully shutdown.
|
|
|
|
**NOTE: this tool is currently considered experimental.** Its
|
|
usage and behaviour is still subject to change in future libvirt
|
|
releases. For further information on its usage consult the
|
|
`QEMU driver documentation <https://libvirt.org/drvqemu.html#embedded-driver>`_.
|
|
|
|
|
|
OPTIONS
|
|
=======
|
|
|
|
*GUEST-XML-FILE*
|
|
|
|
The full path to the XML file describing the guest virtual machine
|
|
to be booted.
|
|
|
|
``-r`` *DIR*, ``--root``\ =\ *DIR*
|
|
|
|
Specify the root directory to use for storing state associated with
|
|
the virtual machine. The caller is responsible for deleting this
|
|
directory when it is no longer required.
|
|
|
|
If this parameter is omitted, then a random temporary directory
|
|
will be created, and its contents be automatically deleted at
|
|
VM shutdown.
|
|
|
|
``-s`` *SECRET-XML-FILE*\ ,\ *SECRET-VALUE-FILE*,
|
|
``--secret``\ =\ *SECRET-XML-FILE*\ ,\ *SECRET-VALUE-FILE*
|
|
|
|
Specify a secret to be loaded into the secret driver.
|
|
*SECRET-XML-FILE* is a path to the XML description of the secret,
|
|
whose UUID should match a secret referenced in the guest domain XML.
|
|
*SECRET-VALUE-FILE* is a path containing the raw value of the secret.
|
|
|
|
``-v``, ``--verbose``
|
|
|
|
Display verbose information about startup.
|
|
|
|
``-h``, ``--help``
|
|
|
|
Display the command line help.
|
|
|
|
|
|
EXIT STATUS
|
|
===========
|
|
|
|
Upon successful shutdown, an exit status of 0 will be set. Upon
|
|
failure a non-zero status will be set.
|
|
|
|
|
|
AUTHOR
|
|
======
|
|
|
|
Daniel P. Berrangé
|
|
|
|
|
|
BUGS
|
|
====
|
|
|
|
Please report all bugs you discover. This should be done via either:
|
|
|
|
#. the mailing list
|
|
|
|
`https://libvirt.org/contact.html <https://libvirt.org/contact.html>`_
|
|
|
|
#. the bug tracker
|
|
|
|
`https://libvirt.org/bugs.html <https://libvirt.org/bugs.html>`_
|
|
|
|
Alternatively, you may report bugs to your software distributor / vendor.
|
|
|
|
|
|
COPYRIGHT
|
|
=========
|
|
|
|
Copyright (C) 2019 by Red Hat, Inc.
|
|
|
|
|
|
LICENSE
|
|
=======
|
|
|
|
``virt-run-qemu`` is distributed under the terms of the GNU LGPL v2+.
|
|
This is free software; see the source for copying conditions. There
|
|
is NO warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR
|
|
PURPOSE
|
|
|
|
|
|
SEE ALSO
|
|
========
|
|
|
|
virsh(1), `https://libvirt.org/ <https://libvirt.org/>`_
|