From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from eggs.gnu.org ([208.118.235.92]:37059) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SeSgJ-0001XQ-Ha for qemu-devel@nongnu.org; Tue, 12 Jun 2012 11:07:16 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1SeSg1-0006aN-T0 for qemu-devel@nongnu.org; Tue, 12 Jun 2012 11:06:55 -0400 Received: from e06smtp11.uk.ibm.com ([195.75.94.107]:37998) by eggs.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1SeSg1-0006XF-KN for qemu-devel@nongnu.org; Tue, 12 Jun 2012 11:06:37 -0400 Received: from /spool/local by e06smtp11.uk.ibm.com with IBM ESMTP SMTP Gateway: Authorized Use Only! Violators will be prosecuted for from ; Tue, 12 Jun 2012 16:06:32 +0100 Received: from d06av09.portsmouth.uk.ibm.com (d06av09.portsmouth.uk.ibm.com [9.149.37.250]) by d06nrmr1307.portsmouth.uk.ibm.com (8.13.8/8.13.8/NCO v10.0) with ESMTP id q5CF6Dh61810610 for ; Tue, 12 Jun 2012 16:06:13 +0100 Received: from d06av09.portsmouth.uk.ibm.com (loopback [127.0.0.1]) by d06av09.portsmouth.uk.ibm.com (8.14.4/8.13.1/NCO v10.0 AVout) with ESMTP id q5CF5okT016775 for ; Tue, 12 Jun 2012 09:05:50 -0600 From: Stefan Hajnoczi Date: Tue, 12 Jun 2012 16:05:46 +0100 Message-Id: <1339513546-17538-1-git-send-email-stefanha@linux.vnet.ibm.com> Subject: [Qemu-devel] [PATCH] qemu-img: document qed format on qemu-img man page List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: Kevin Wolf Cc: Michael Tokarev , qemu-devel@nongnu.org, Stefan Hajnoczi 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 --- When the qcow2 QED mode is merged we can update this again to reflect good cache=writethrough performance in qcow2v3 /w QED mode. qemu-img.texi | 22 ++++++++++++++++++++++ 1 file changed, 22 insertions(+) diff --git a/qemu-img.texi b/qemu-img.texi index 6fc3c28..78640a9 100644 --- a/qemu-img.texi +++ b/qemu-img.texi @@ -232,6 +232,28 @@ to grow. @end table +@item qed +Image format with support for backing files and compact image files (when your +filesystem or transport medium does not support holes). Good performance due +to less metadata than the more featureful qcow2 format, especially with +cache=writethrough. + +Supported options: +@table @code +@item backing_file +File name of a base image (see @option{create} subcommand). +@item backing_fmt +Image file format of backing file (optional). Useful if the format cannot be +autodetected because it has no header, like some vhd/vpc files. +@item cluster_size +Changes the cluster size (must be power-of-2 between 4K and 64K). Smaller +cluster sizes can improve the image file size whereas larger cluster sizes +generally provide better performance. +@item table_size +Changes the number of clusters per L1/L2 table (must be power-of-2 between 1 +and 16). There is normally no need to change this value but this option can be +used for performance benchmarking. +@end table @item qcow Old QEMU image format. Left for compatibility. -- 1.7.10