Re: [Qemu-devel] [PATCH] Add backing file option to qemu-img create help.

[Eric Blake <eblake@redhat.com>]

[-- Attachment #1: Type: text/plain, Size: 1184 bytes --]

On 05/12/2014 09:36 AM, Mike Day wrote:
> On Mon, May 12, 2014 at 11:20 AM, Eric Blake <eblake@redhat.com> wrote:
>> Online where?  In 'qemu-img --help', or on some web page (at what URL)?
> 
> http://qemu.weilnetz.de/qemu-doc.html#vm_005fsnapshots

Not an official qemu reference; nothing we can do about out-of-date
third-party references.

> 
> -o backing file is not documented in the help command.

Ah, but it is:

$ qemu-img create -f qcow2 -o help
Supported options:
size             Virtual disk size
compat           Compatibility level (0.10 or 1.1)
backing_file     File name of a base image
backing_fmt      Image format of the base image
encryption       Encrypt the image
cluster_size     qcow2 cluster size
preallocation    Preallocation mode (allowed values: off, metadata)
lazy_refcounts   Postpone refcount updates

and more importantly, it only appears in the help output of -f modes
that actually support a backing file.  Contrast:

$ qemu-img create -f raw -o help
Supported options:
size             Virtual disk size


-- 
Eric Blake   eblake redhat com    +1-919-301-3266
Libvirt virtualization library http://libvirt.org


[-- Attachment #2: OpenPGP digital signature --]
[-- Type: application/pgp-signature, Size: 604 bytes --]