Commit 64c7580c authored by Stefano Garzarella's avatar Stefano Garzarella Committed by Markus Armbruster
Browse files

qapi/block-core: update documentation of preallocation parameter 



Add default and available values in the documentation block of
each block device or protocol that supports the 'preallocation'
parameter during the image creation.

Suggested-by: default avatarMarkus Armbruster <armbru@redhat.com>
Signed-off-by: default avatarStefano Garzarella <sgarzare@redhat.com>
Reviewed-by: default avatarMarkus Armbruster <armbru@redhat.com>
Message-Id: <20190524075848.23781-2-sgarzare@redhat.com>
Signed-off-by: default avatarMarkus Armbruster <armbru@redhat.com>
parent 4d209102

qapi/block-core.json

+14 −6
Original line number Diff line number Diff line
@@ -4121,7 +4121,10 @@ 
#

# @filename         Filename for the new image file

# @size             Size of the virtual disk in bytes

# @preallocation    Preallocation mode for the new image (default: off)

# @preallocation    Preallocation mode for the new image (default: off;

#                   allowed values: off,

#                   falloc (if defined CONFIG_POSIX_FALLOCATE),

#                   full (if defined CONFIG_POSIX))

# @nocow            Turn off copy-on-write (valid only on btrfs; default: off)

#

# Since: 2.12
@@ -4139,7 +4142,10 @@ 
#

# @location         Where to store the new image file

# @size             Size of the virtual disk in bytes

# @preallocation    Preallocation mode for the new image (default: off)

# @preallocation    Preallocation mode for the new image (default: off;

#                   allowed values: off,

#                   falloc (if defined CONFIG_GLUSTERFS_FALLOCATE),

#                   full (if defined CONFIG_GLUSTERFS_ZEROFILL))

#

# Since: 2.12

##
@@ -4243,7 +4249,8 @@ 
# @backing-fmt      Name of the block driver to use for the backing file

# @encrypt          Encryption options if the image should be encrypted

# @cluster-size     qcow2 cluster size in bytes (default: 65536)

# @preallocation    Preallocation mode for the new image (default: off)

# @preallocation    Preallocation mode for the new image (default: off;

#                   allowed values: off, falloc, full, metadata)

# @lazy-refcounts   True if refcounts may be updated lazily (default: off)

# @refcount-bits    Width of reference counts in bits (default: 16)

#
@@ -4426,7 +4433,8 @@ 
# @location         Where to store the new image file

# @size             Size of the virtual disk in bytes

# @backing-file     File name of a base image

# @preallocation    Preallocation mode (allowed values: off, full)

# @preallocation    Preallocation mode for the new image (default: off;

#                   allowed values: off, full)

# @redundancy       Redundancy of the image

# @object-size      Object size of the image

#
@@ -4461,8 +4469,8 @@ 
#

# @file             Node to create the image format on

# @size             Size of the virtual disk in bytes

# @preallocation    Preallocation mode for the new image (allowed values: off,

#                   metadata; default: off)

# @preallocation    Preallocation mode for the new image (default: off;

#                   allowed values: off, metadata)

#

# Since: 2.12

##