docs/tools/qemu-img.rst

8 **qemu-img** [*standard options*] *command* [*command options*]
13 qemu-img allows you to create, convert and modify images offline. It can handle
16 **Warning:** Never use qemu-img to modify images in use by a running virtual
24 .. program:: qemu-img
42 .. hxtool-doc:: qemu-img-cmds.hx
70 .. program:: qemu-img-common-opts
95   If specified, ``qemu-img`` will open the image in shared mode, allowing
134   for ``qemu-img`` to create a sparse image during conversion. This value is
152 .. program:: qemu-img-compare
168 .. program:: qemu-img-convert
215 .. program:: qemu-img-dd
239 .. program:: qemu-img-snapshot
263 .. program:: qemu-img-commands
272   instead be performed with ``qemu-img rebase``.
326   To see what bitmaps are present in an image, use ``qemu-img info``.
334   If ``-r`` is specified, qemu-img tries to repair any inconsistencies found
438   that must contain only zeros for ``qemu-img`` to create a sparse image during
454   be supplied through ``qemu-img``.
479   ``commit`` monitor command (or ``qemu-img commit``).
526     qemu-img info --backing-chain snap2.qcow2
584   throughout the chain.  ``qemu-img`` output will identify a file
637   using ``qemu-img create``.  If *FILENAME* is given then act as if
638   converting an existing image file using ``qemu-img convert``.  The format
691     new backing file may differ from the old one and ``qemu-img rebase``
706     ``qemu-img`` uses the unsafe mode if ``-u`` is specified. In this
722   Say that ``base.img`` has been cloned as ``modified.img`` by
723   copying it, and that the ``modified.img`` guest has run so there
724   are now some changes compared to ``base.img``.  To construct a thin
729     qemu-img create -f qcow2 -b modified.img diff.qcow2
730     qemu-img rebase -b base.img diff.qcow2
732   At this point, ``modified.img`` can be discarded, since
733   ``base.img + diff.qcow2`` contains the same information.
744   ``qemu-img`` that the user acknowledges all loss of data beyond the truncated
769   space. Use ``qemu-img info`` to know the real size used by the
807     used with the ``-c`` option of ``qemu-img convert``, but can also be used
872     ``qemu-img check -r all`` is required, which may take some time.
901     using this option with ``qemu-img create`` since ``qemu-img`` will create
904     ``qemu-img amend``.
932   of supported formats see ``qemu-img --help``.  For a more detailed