aboutsummaryrefslogtreecommitdiff
path: root/docs/tools/qemu-img.rst
diff options
context:
space:
mode:
authorEyal Moscovici <eyal.moscovici@oracle.com>2020-05-13 16:36:29 +0300
committerEric Blake <eblake@redhat.com>2020-05-18 11:02:05 -0500
commitc0469496b32910a6a092d5b614efbf4088b13a29 (patch)
tree99e8482168bbb8ec2448c338db2bebe08780c2a9 /docs/tools/qemu-img.rst
parente46c0b18cfd02195a0d527ca73f3ed9f3ce5eacb (diff)
downloadqemu-c0469496b32910a6a092d5b614efbf4088b13a29.zip
qemu-c0469496b32910a6a092d5b614efbf4088b13a29.tar.gz
qemu-c0469496b32910a6a092d5b614efbf4088b13a29.tar.bz2
qemu-img: Add --start-offset and --max-length to map
The mapping operation of large disks especially ones stored over a long chain of QCOW2 files can take a long time to finish. Additionally when mapping fails there was no way recover by restarting the mapping from the failed location. The new options, --start-offset and --max-length allows the user to divide these type of map operations into shorter independent tasks. Reviewed-by: Eric Blake <eblake@redhat.com> Acked-by: Mark Kanda <mark.kanda@oracle.com> Co-developed-by: Yoav Elnekave <yoav.elnekave@oracle.com> Signed-off-by: Yoav Elnekave <yoav.elnekave@oracle.com> Signed-off-by: Eyal Moscovici <eyal.moscovici@oracle.com> Message-Id: <20200513133629.18508-5-eyal.moscovici@oracle.com> Signed-off-by: Eric Blake <eblake@redhat.com>
Diffstat (limited to 'docs/tools/qemu-img.rst')
-rw-r--r--docs/tools/qemu-img.rst2
1 files changed, 1 insertions, 1 deletions
diff --git a/docs/tools/qemu-img.rst b/docs/tools/qemu-img.rst
index 0080f83..f4ffe52 100644
--- a/docs/tools/qemu-img.rst
+++ b/docs/tools/qemu-img.rst
@@ -519,7 +519,7 @@ Command description:
``ImageInfoSpecific*`` QAPI object (e.g. ``ImageInfoSpecificQCow2``
for qcow2 images).
-.. option:: map [--object OBJECTDEF] [--image-opts] [-f FMT] [--output=OFMT] [-U] FILENAME
+.. option:: map [--object OBJECTDEF] [--image-opts] [-f FMT] [--start-offset=OFFSET] [--max-length=LEN] [--output=OFMT] [-U] FILENAME
Dump the metadata of image *FILENAME* and its backing file chain.
In particular, this commands dumps the allocation state of every sector