virt-qemu-run(1)

1VIRT-QEMU-RUN(1)            Virtualization Support            VIRT-QEMU-RUN(1)
2
3
4

NAME

6       virt-qemu-run - Run a standalone QEMU guest
7

SYNOPSIS

9       virt-qemu-run [OPTIONS...] [GUEST-XML]
10

DESCRIPTION

12       This tool provides a way to run a standalone QEMU guest such that it is
13       completely independent of libvirtd. It makes use of the  embedded  QEMU
14       driver  support to run the VM placing files under an isolated directory
15       tree. When the guest is run with this tool it is invisible to  libvirtd
16       and thus also invisible to other libvirt tools such as virsh.
17
18       The  virt-qemu-run  program will run the QEMU virtual machine, and then
19       block until the guest OS shuts down, at which point it will exit.
20
21       If the virt-qemu-run program is interrupted (eg Ctrl-C) it will immedi‐
22       ately  terminate  the  virtual  machine without giving the guest OS any
23       opportunity to gracefully shutdown.
24
25       NOTE: this tool is currently considered experimental. Its usage and be‐
26       haviour is still subject to change in future libvirt releases. For fur‐
27       ther information on its usage consult the QEMU driver documentation.
28

OPTIONS

30       GUEST-XML
31
32       The full path to the XML file describing the guest virtual  machine  to
33       be booted.
34
35       -h, --help
36
37       Display the command line help
38
39       -v, --verbose
40
41       Display verbose information about startup
42
43       -r DIR, --root=DIR
44
45       Specify the root directory to use for storing state associated with the
46       virtual machine. The caller is responsible for deleting this  directory
47       when it is no longer required.
48
49       If this parameter is omitted, then a random temporary directory will be
50       created, and its contents be automaticlaly deleted at VM shutdown.
51
52       -s XML-FILE,VALUE-FILE, --secret=XML-FILE,VALUE-FILE
53
54       Specify a secret to be loaded into the secret driver. The XML-FILE is a
55       path  to  the  XML description of the secret, whose UUID should match a
56       secret referenced in the guest domain XML. The  VALUE-FILE  is  a  path
57       containing the raw value of the secret.
58

EXIT STATUS

60       Upon successful shutdown, an exit status of 0 will be set. Upon failure
61       a non-zero status will be set.
62

AUTHOR

64       Daniel P. Berrangé
65

BUGS

67       Please report all bugs you discover.  This should be done via either:
68
69       1. the mailing list
70
71          https://libvirt.org/contact.html
72
73       2. the bug tracker
74
75          https://libvirt.org/bugs.html
76
77       Alternatively, you may report bugs to your software distributor /  ven‐
78       dor.
79

COPYRIGHT

81       Copyright (C) 2019 by Red Hat, Inc.
82

LICENSE

84       virt-run-qemu is distributed under the terms of the GNU LGPL v2+.  This
85       is free software; see the source for copying conditions.  There  is  NO
86       warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PUR‐
87       POSE
88