Blame 0024-Documentation-Add-qemu-img-t-parameter-in-man-page.patch

Justin M. Forbes 45e84a
From 8afe984ef7aa25cb2f8af51da021fdc8a242884d Mon Sep 17 00:00:00 2001
Justin M. Forbes 45e84a
From: Kevin Wolf <kwolf@redhat.com>
Justin M. Forbes 45e84a
Date: Wed, 7 Dec 2011 13:57:13 +0100
Justin M. Forbes 45e84a
Subject: [PATCH 24/25] Documentation: Add qemu-img -t parameter in man page
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
Signed-off-by: Kevin Wolf <kwolf@redhat.com>
Justin M. Forbes 45e84a
Reviewed-by: Stefan Hajnoczi <stefanha@linux.vnet.ibm.com>
Justin M. Forbes 45e84a
---
Justin M. Forbes 45e84a
 qemu-img-cmds.hx |    6 +++---
Justin M. Forbes 45e84a
 qemu-img.texi    |   10 +++++++---
Justin M. Forbes 45e84a
 2 files changed, 10 insertions(+), 6 deletions(-)
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
diff --git a/qemu-img-cmds.hx b/qemu-img-cmds.hx
Justin M. Forbes 45e84a
index 4be00a5..49dce7c 100644
Justin M. Forbes 45e84a
--- a/qemu-img-cmds.hx
Justin M. Forbes 45e84a
+++ b/qemu-img-cmds.hx
Justin M. Forbes 45e84a
@@ -24,13 +24,13 @@ ETEXI
Justin M. Forbes 45e84a
 DEF("commit", img_commit,
Justin M. Forbes 45e84a
     "commit [-f fmt] [-t cache] filename")
Justin M. Forbes 45e84a
 STEXI
Justin M. Forbes 45e84a
-@item commit [-f @var{fmt}] @var{filename}
Justin M. Forbes 45e84a
+@item commit [-f @var{fmt}] [-t @var{cache}] @var{filename}
Justin M. Forbes 45e84a
 ETEXI
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
 DEF("convert", img_convert,
Justin M. Forbes 45e84a
     "convert [-c] [-p] [-f fmt] [-t cache] [-O output_fmt] [-o options] [-s snapshot_name] [-S sparse_size] filename [filename2 [...]] output_filename")
Justin M. Forbes 45e84a
 STEXI
Justin M. Forbes 45e84a
-@item convert [-c] [-p] [-f @var{fmt}] [-O @var{output_fmt}] [-o @var{options}] [-s @var{snapshot_name}] [-S @var{sparse_size}] @var{filename} [@var{filename2} [...]] @var{output_filename}
Justin M. Forbes 45e84a
+@item convert [-c] [-p] [-f @var{fmt}] [-t @var{cache}] [-O @var{output_fmt}] [-o @var{options}] [-s @var{snapshot_name}] [-S @var{sparse_size}] @var{filename} [@var{filename2} [...]] @var{output_filename}
Justin M. Forbes 45e84a
 ETEXI
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
 DEF("info", img_info,
Justin M. Forbes 45e84a
@@ -48,7 +48,7 @@ ETEXI
Justin M. Forbes 45e84a
 DEF("rebase", img_rebase,
Justin M. Forbes 45e84a
     "rebase [-f fmt] [-t cache] [-p] [-u] -b backing_file [-F backing_fmt] filename")
Justin M. Forbes 45e84a
 STEXI
Justin M. Forbes 45e84a
-@item rebase [-f @var{fmt}] [-p] [-u] -b @var{backing_file} [-F @var{backing_fmt}] @var{filename}
Justin M. Forbes 45e84a
+@item rebase [-f @var{fmt}] [-t @var{cache}] [-p] [-u] -b @var{backing_file} [-F @var{backing_fmt}] @var{filename}
Justin M. Forbes 45e84a
 ETEXI
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
 DEF("resize", img_resize,
Justin M. Forbes 45e84a
diff --git a/qemu-img.texi b/qemu-img.texi
Justin M. Forbes 45e84a
index 70fa321..b2ca3a5 100644
Justin M. Forbes 45e84a
--- a/qemu-img.texi
Justin M. Forbes 45e84a
+++ b/qemu-img.texi
Justin M. Forbes 45e84a
@@ -45,6 +45,10 @@ indicates the consecutive number of bytes that must contain only zeros
Justin M. Forbes 45e84a
 for qemu-img to create a sparse image during conversion. This value is rounded
Justin M. Forbes 45e84a
 down to the nearest 512 bytes. You may use the common size suffixes like
Justin M. Forbes 45e84a
 @code{k} for kilobytes.
Justin M. Forbes 45e84a
+@item -t @var{cache}
Justin M. Forbes 45e84a
+specifies the cache mode that should be used with the (destination) file. See
Justin M. Forbes 45e84a
+the documentation of the emulator's @code{-drive cache=...} option for allowed
Justin M. Forbes 45e84a
+values.
Justin M. Forbes 45e84a
 @end table
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
 Parameters to snapshot subcommand:
Justin M. Forbes 45e84a
@@ -87,11 +91,11 @@ this case. @var{backing_file} will never be modified unless you use the
Justin M. Forbes 45e84a
 The size can also be specified using the @var{size} option with @code{-o},
Justin M. Forbes 45e84a
 it doesn't need to be specified separately in this case.
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
-@item commit [-f @var{fmt}] @var{filename}
Justin M. Forbes 45e84a
+@item commit [-f @var{fmt}] [-t @var{cache}] @var{filename}
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
 Commit the changes recorded in @var{filename} in its base image.
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
-@item convert [-c] [-p] [-f @var{fmt}] [-O @var{output_fmt}] [-o @var{options}] [-s @var{snapshot_name}] [-S @var{sparse_size}] @var{filename} [@var{filename2} [...]] @var{output_filename}
Justin M. Forbes 45e84a
+@item convert [-c] [-p] [-f @var{fmt}] [-t @var{cache}] [-O @var{output_fmt}] [-o @var{options}] [-s @var{snapshot_name}] [-S @var{sparse_size}] @var{filename} [@var{filename2} [...]] @var{output_filename}
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
 Convert the disk image @var{filename} or a snapshot @var{snapshot_name} to disk image @var{output_filename}
Justin M. Forbes 45e84a
 using format @var{output_fmt}. It can be optionally compressed (@code{-c}
Justin M. Forbes 45e84a
@@ -121,7 +125,7 @@ they are displayed too.
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
 List, apply, create or delete snapshots in image @var{filename}.
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
-@item rebase [-f @var{fmt}] [-p] [-u] -b @var{backing_file} [-F @var{backing_fmt}] @var{filename}
Justin M. Forbes 45e84a
+@item rebase [-f @var{fmt}] [-t @var{cache}] [-p] [-u] -b @var{backing_file} [-F @var{backing_fmt}] @var{filename}
Justin M. Forbes 45e84a
Justin M. Forbes 45e84a
 Changes the backing file of an image. Only the formats @code{qcow2} and
Justin M. Forbes 45e84a
 @code{qed} support changing the backing file.
Justin M. Forbes 45e84a
-- 
Justin M. Forbes 45e84a
1.7.7.5
Justin M. Forbes 45e84a