From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mailman by lists.gnu.org with tmda-scanned (Exim 4.43) id 1N3730-0005iv-1W for qemu-devel@nongnu.org; Wed, 28 Oct 2009 07:50:38 -0400 Received: from exim by lists.gnu.org with spam-scanned (Exim 4.43) id 1N372r-0005ca-B9 for qemu-devel@nongnu.org; Wed, 28 Oct 2009 07:50:33 -0400 Received: from [199.232.76.173] (port=47415 helo=monty-python.gnu.org) by lists.gnu.org with esmtp (Exim 4.43) id 1N372q-0005bX-Bc for qemu-devel@nongnu.org; Wed, 28 Oct 2009 07:50:28 -0400 Received: from mx1.redhat.com ([209.132.183.28]:13493) by monty-python.gnu.org with esmtp (Exim 4.60) (envelope-from ) id 1N372p-0006uE-G3 for qemu-devel@nongnu.org; Wed, 28 Oct 2009 07:50:27 -0400 Received: from int-mx08.intmail.prod.int.phx2.redhat.com (int-mx08.intmail.prod.int.phx2.redhat.com [10.5.11.21]) by mx1.redhat.com (8.13.8/8.13.8) with ESMTP id n9SBoQMc016639 for ; Wed, 28 Oct 2009 07:50:26 -0400 From: Kevin Wolf Date: Wed, 28 Oct 2009 12:49:17 +0100 Message-Id: <1256730557-15892-4-git-send-email-kwolf@redhat.com> In-Reply-To: <1256730557-15892-1-git-send-email-kwolf@redhat.com> References: <1256730557-15892-1-git-send-email-kwolf@redhat.com> Subject: [Qemu-devel] [PATCH 3/3] Documentation: Add options to image format descriptions List-Id: qemu-devel.nongnu.org List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , To: qemu-devel@nongnu.org Cc: Kevin Wolf Explain the existing format specific options that can be used with qemu-img create/convert -o ... Signed-off-by: Kevin Wolf --- qemu-img.texi | 46 +++++++++++++++++++++++++++++++++++++++++++++- 1 files changed, 45 insertions(+), 1 deletions(-) diff --git a/qemu-img.texi b/qemu-img.texi index 2d0106b..ac97854 100644 --- a/qemu-img.texi +++ b/qemu-img.texi @@ -31,7 +31,7 @@ is the destination disk image filename @item options is a comma separated list of format specific options in a name=value format. Use @code{-o ?} for an overview of the options supported -by the used format +by the used format or see the format descriptions below for details. @item -c @@ -132,10 +132,42 @@ images (useful if your filesystem does not supports holes, for example on Windows), optional AES encryption, zlib based compression and support of multiple VM snapshots. +Supported options: +@table @code +@item backing_file +File name of a base image (see @option{create} subcommand) +@item backing_fmt +Image format of the base image +@item encryption +If this option is set to @code{on}, the image is encrypted. + Encryption uses the AES format which is very secure (128 bit keys). Use a long password (16 characters) to get maximum protection. + +@item cluster_size +Changes the qcow2 cluster size (must be between 512 and 2M). Smaller cluster +sizes can improve the image file size whereas larger cluster sizes generally +provide better performance. + +@item preallocation +Preallocation mode (allowed values: off, metadata). An image with preallocated +metadata is initially larger but can improve performance when the image needs +to grow. + +@end table + + @item qcow Old QEMU image format. Left for compatibility. + +Supported options: +@table @code +@item backing_file +File name of a base image (see @option{create} subcommand) +@item encryption +If this option is set to @code{on}, the image is encrypted. +@end table + @item cow User Mode Linux Copy On Write image format. Used to be the only growable image format in QEMU. It is supported only for compatibility with @@ -144,6 +176,18 @@ previous versions. It does not work on win32. VirtualBox 1.1 compatible image format. @item vmdk VMware 3 and 4 compatible image format. + +Supported options: +@table @code +@item backing_fmt +Image format of the base image +@item compat6 +Create a VMDK version 6 image (instead of version 4) +@end table + +@item vpc +VirtualPC compatible image format (VHD). + @item cloop Linux Compressed Loop image, useful only to reuse directly compressed CD-ROM images present for example in the Knoppix CD-ROMs. -- 1.6.2.5