| Branch: | Revision:

root / qemu-img.texi @ feature-archipelago

History | View | Annotate | Download (18.8 kB)

# Date Author Comment
136cd19d 01/31/2014 11:05 pm Daniel P. Berrange

Describe flaws in qcow/qcow2 encryption in the docs

The qemu-img.texi / qemu-doc.texi files currently describe the
qcow2/qcow2 encryption thus

"Encryption uses the AES format which is very secure (128 bit
keys). Use a long password (16 characters) to get maximum...
37222900 01/24/2014 05:12 pm Jeff Cody

block: update block commit documentation regarding image truncation

This updates the documentation for commiting snapshot images.
Specifically, this highlights what happens when the base image
is either smaller or larger than the snapshot image being committed....

0e3bd993 01/24/2014 03:33 pm Kevin Wolf

Documentation: qemu-img: Mention SIGUSR1 progress report

Document the SIGUSR1 behaviour of qemu-img. Also, added compare to the
list of subcommands that support -p.

Signed-off-by: Kevin Wolf <>
Reviewed-by: Benoit Canet <>

7fa9e1f9 01/22/2014 01:07 pm Stefan Hajnoczi

docs: qcow2 compat=1.1 is now the default

Commit 9117b47717ad208b12786ce88eacb013f9b3dd1c ("qcow2: Change default
for new images to compat=1.1") changed the default qcow2 image format
version but forgot to update qemu-doc.texi and qemu-img.texi.

Signed-off-by: Stefan Hajnoczi <>...

8282db1b 12/20/2013 10:11 am Jeff Cody

docs: updated qemu-img man page and qemu-doc to reflect VHDX support.

The man page for qemu-img, and the qemu-doc, did not mention VHDX
as a supported format. This adds in reference to VHDX in those

[Stefan Weil <> suggested s/Block Size/Block size/ for...

ef80654d 12/04/2013 04:19 pm Wenchao Xia

qemu-img: add -l for snapshot in convert

Now qemu-img convert have similar options as qemu-nbd for internal

Signed-off-by: Wenchao Xia <>
Signed-off-by: Stefan Hajnoczi <>

11b6699a 11/28/2013 11:30 am Peter Lieven

qemu-img: add support for fully allocated images

Signed-off-by: Peter Lieven <>
Signed-off-by: Stefan Hajnoczi <>

6f176b48 09/12/2013 11:12 am Max Reitz

block: Image file option amendment

This patch adds the "amend" option to qemu-img which allows changing
image options on existing image files. It also adds the generic bdrv
implementation which is basically just a wrapper for the image format
specific function....

facd6e2b 09/06/2013 04:25 pm Paolo Bonzini

docs, qapi: document qemu-img map

Eric Blake also requested including the output in qapi-schema.json,
so that it is published through the introspection mechanism.

Signed-off-by: Paolo Bonzini <>
Signed-off-by: Stefan Hajnoczi <>

b2e10493 09/06/2013 04:25 pm Alexandre Derumier

add qemu-img convert -n option (skip target volume creation)

Add a -n option to skip volume creation on qemu-img convert.
This is useful for targets such as rbd / ceph, where the
target volume may already exist; we cannot always rely on
qemu-img convert to create the image, as dependent on the...

d14ed18c 02/22/2013 10:21 pm Miroslav Rezanina

qemu-img: Add compare subcommand

This patch adds new qemu-img subcommand that compares content of two disk

Signed-off-by: Miroslav Rezanina <>
Reviewed-by: Kevin Wolf <>
Signed-off-by: Stefan Hajnoczi <>

f382d43a 02/22/2013 10:21 pm Miroslav Rezanina

qemu-img: Add "Quiet mode" option

There can be a need to turn output to stdout off. This patch adds a -q option
that enable "Quiet mode". In Quiet mode, only errors are printed out.

Signed-off-by: Miroslav Rezanina <>
Reviewed-by: Kevin Wolf <>...

8599ea4c 02/22/2013 10:21 pm Federico Simoncelli

qemu-img: add json output option to the check command

This option --output=[human|json] makes qemu-img check output a human
or JSON representation at the choice of the user.

Signed-off-by: Federico Simoncelli <>
Reviewed-by: Eric Blake <>...

d3067b02 11/30/2012 12:33 pm Kevin Wolf

Documentation: Update image format information

Document new and yet undocumented options and image formats. The
qemu-img man page contains information only for raw and qcow2 now and
references the HTML documentation for a more detailed description of
other formats....

e5357560 10/24/2012 11:26 am Kashyap Chamarthy

qemu-img: document 'info --backing-chain'

Signed-off-by: Kashyap Chamarthy <>
Reviewed-by: Stefan Hajnoczi <>
Signed-off-by: Kevin Wolf <>

a616673d 10/24/2012 11:26 am Alex Bligh

qemu-img rebase: use empty string to rebase without backing file

This patch allows an empty filename to be passed as the new base image name
for qemu-img rebase to mean base the image on no backing file (i.e.
independent of any backing file). According to Eric Blake, qemu-img rebase...

109820df 09/17/2012 06:23 pm Anthony Liguori

Merge remote-tracking branch 'kwolf/for-anthony' into staging

  • kwolf/for-anthony:
    block: Don't forget to delete temporary file
    Don't require encryption password for 'qemu-img info' command
    qemu-img: Add json output option to the info command.
    qapi: Add SnapshotInfo and ImageInfo....
0546b8c2 09/14/2012 10:21 am Stefan Weil

Spelling fixes in comments and documentation

These wrong spellings were detected by codespell:

  • successully -> successfully
  • alot -> a lot
  • wanna -> want to
  • infomation -> information
  • occured -> occurred

["also is" -> "is also" and "ressources" -> "resources" suggested by...

c054b3fd 09/12/2012 04:50 pm Benoît Canet

qemu-img: Add json output option to the info command.

This option --output=[human|json] make qemu-img info output on
human or JSON representation at the choice of the user.

example: {
"snapshots": [ {
"vm-clock-nsec": 637102488,
"name": "vm-20120821145509",...

48467328 08/17/2012 10:29 pm Kevin Wolf

Documentation: Warn against qemu-img on active image

People have repeatedly expected that you can do things like snapshotting
an image with qemu-img while a qemu instance is running. Maybe we need
to consider locking the files while they are in use, but having a...

f085800e 06/15/2012 03:03 pm Stefan Hajnoczi

qemu-img: document qed format on qemu-img man page

The qemu-img.1 man page is missing the qed format from its list of
supported formats. Document the image creation options for qed.

Suggested-by: Michael Tokarev <>
Signed-off-by: Stefan Hajnoczi <>...

4534ff54 06/15/2012 03:03 pm Kevin Wolf

qemu-img check -r for repairing images

The QED block driver already provides the functionality to not only
detect inconsistencies in images, but also fix them. However, this
functionality cannot be manually invoked with qemu-img, but the
check happens only automatically during bdrv_open()....

9fda6ab1 05/25/2012 07:12 pm Richard W.M. Jones

qemu-img: Explain how rebase operation can be used to perform a 'diff' operation.

Signed-off-by: Richard W.M. Jones <>
Signed-off-by: Kevin Wolf <>

3763f26f 12/15/2011 01:40 pm Kevin Wolf

Documentation: Add qemu-img -t parameter in man page

Signed-off-by: Kevin Wolf <>
Reviewed-by: Stefan Hajnoczi <>

a22f123c 08/29/2011 03:42 pm Kevin Wolf

qemu-img: Require larger zero areas for sparse handling

By default, require 4k of consecutive zero bytes for qemu-img to make the
output file sparse by not issuing a write request for the zeroed parts. Add an
-S option to allow users to tune this setting....

aaf55b47 07/20/2011 12:13 pm Jes Sorensen

Add missing documentation for qemu-img -p

Signed-off-by: Jes Sorensen <>
Signed-off-by: Kevin Wolf <>

02854532 07/05/2011 12:23 pm Kevin Wolf

Documentation: Remove outdated host_device note

People shouldn't explicitly specify host_device any more. raw is doing the
Right Thing.

Signed-off-by: Kevin Wolf <>

e6184690 01/24/2011 05:41 pm Kevin Wolf

Documentation: Add qemu-img check/rebase

Signed-off-by: Kevin Wolf <>

51ef6727 10/22/2010 03:49 pm edison

Copy snapshots out of QCOW2 disk

In order to backup snapshots, created from QCOW2 iamge, we want to copy snapshots out of QCOW2 disk to a seperate storage.
The following patch adds a new option in "qemu-img": qemu-img convert -f qcow2 -O qcow2 -s snapshot_name src_img bck_img....

ae6b0ed6 05/03/2010 11:07 am Stefan Hajnoczi

qemu-img: Add 'resize' command to grow/shrink disk images

This patch adds a 'resize' command to grow/shrink disk images. This
allows changing the size of disk images without copying to a new image
file. Currently only raw files support resize.

Signed-off-by: Stefan Hajnoczi <>...

f932c040 11/09/2009 04:43 pm Kevin Wolf

Documentation: Move image format descriptions to own section

The description of the image formats is too long to be a subitem of a parameter
description. It will become even longer when we include the options provided by
the respective format.

Signed-off-by: Kevin Wolf <>...

8063d0fe 11/09/2009 04:43 pm Kevin Wolf

Documentation: Don't mention old qemu-img options

The old options are still supported for compatibility, but they are
inconsistent (for example create -b vs. convert -B for backing files) and
incomplete (-F only exists for create) which tends to confuse people. Remove...

3e032364 11/09/2009 04:43 pm Kevin Wolf

Documentation: Add options to image format descriptions

Explain the existing format specific options that can be used with qemu-img
create/convert -o ...

Signed-off-by: Kevin Wolf <>
Signed-off-by: Anthony Liguori <>

a6af8e5f 10/06/2009 10:36 pm Adrian Bridgett

add host_device format description to qemu-img manpage

Converting files using "qemu-img convert" onto logical volumes (or any
block device) you need to use the currently undocumented "host_device"
format. This patch adds the required documentation to the manpage....

9aebd98a 08/10/2009 09:05 pm Stefan Weil

Add new block driver for the VDI format (only aio supported)

This is a new block driver written from scratch
to support the VDI format in QEMU.

VDI is the native format used by Innotek / SUN VirtualBox.

Latest changes:

  • stripped down version
    (code for synchronous operations and experimental code removed)...
153859be 06/07/2009 09:59 am Stuart Brady

Use hxtool for qemu-img command list

Use hxtool to generate the 'command syntax' section of qemu-img's help
message, and the corresponding section of the texinfo documentation.

This has the side-effect of adding 'check' to this list of commands in
the texinfo documentation....

eff44266 06/06/2009 06:39 pm Kevin Wolf

Document changes in qemu-img interface

Update the documentation to reflect the introduction of format specific options
with -o. Don't advertise -e or -6 any more, they exist only for compatibility
reasons and can be replaced by the corresponding -o options....

9230eaf6 03/28/2009 07:55 pm aliguori

qemu-img: adding a "-F base_fmt" option to "qemu-img create -b" (Uri Lublin)

If the user specifies the backing file format,
then when opening the backing file, there is no need
to probe the (backing file) image to figure out its format.

This follows my previous patches implementing bdrv_create2...

d2c639d6 01/24/2009 08:19 pm blueswir1

Synch code, help and docs

Rearrange code, help printout and docs so that they are in the same
(hopefully more logical) order for easier maintenance.

Add help and docs for undocumented options.

Reformat slightly for more consistent help output.

Add comments to encourage better synchronization in the future....

f58c7b35 06/06/2008 12:53 am ths

New qemu-img convert -B option, by Marc Bevand.

git-svn-id: svn:// c046a42c-6fe2-441c-8c8c-71466251a162

ff7ab59f 06/06/2008 12:00 am ths

Update documentation for qemu-img convert options, by Marc Bevand.

git-svn-id: svn:// c046a42c-6fe2-441c-8c8c-71466251a162

ec36ba14 09/17/2007 12:59 am ths

vmdk compatibility level 6 images, by Soren Hansen.

git-svn-id: svn:// c046a42c-6fe2-441c-8c8c-71466251a162

5fafdf24 09/17/2007 12:08 am ths

find -type f | xargs sed -i 's/[\t ]$//g' # on most files

git-svn-id: svn:// c046a42c-6fe2-441c-8c8c-71466251a162

4be456f1 06/03/2007 04:41 pm ths

Documentation spelling fixes, by Mark Glines.

git-svn-id: svn:// c046a42c-6fe2-441c-8c8c-71466251a162

19d36792 08/08/2006 12:34 am bellard


git-svn-id: svn:// c046a42c-6fe2-441c-8c8c-71466251a162

e5d80f94 07/23/2005 08:43 pm bellard


git-svn-id: svn:// c046a42c-6fe2-441c-8c8c-71466251a162

acd935ef 11/16/2004 12:57 am bellard

doc update - added qemu-img manual page

git-svn-id: svn:// c046a42c-6fe2-441c-8c8c-71466251a162