From patchwork Thu Jul 20 14:20:35 2017 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Peter Lieven X-Patchwork-Id: 9855071 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 056BF601C8 for ; Thu, 20 Jul 2017 14:22:26 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id EAC8528756 for ; Thu, 20 Jul 2017 14:22:25 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id DF93A28789; Thu, 20 Jul 2017 14:22:25 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by mail.wl.linuxfoundation.org (Postfix) with ESMTPS id 0AF9428756 for ; Thu, 20 Jul 2017 14:22:24 +0000 (UTC) Received: from localhost ([::1]:38273 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dYCLP-0008CX-HS for patchwork-qemu-devel@patchwork.kernel.org; Thu, 20 Jul 2017 10:22:23 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:41051) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1dYCK0-0008BZ-Kq for qemu-devel@nongnu.org; Thu, 20 Jul 2017 10:20:57 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1dYCJx-0007u3-Qw for qemu-devel@nongnu.org; Thu, 20 Jul 2017 10:20:56 -0400 Received: from mx-v6.kamp.de ([2a02:248:0:51::16]:35333 helo=mx01.kamp.de) by eggs.gnu.org with esmtps (TLS1.0:DHE_RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1dYCJx-0007t2-Hc for qemu-devel@nongnu.org; Thu, 20 Jul 2017 10:20:53 -0400 Received: (qmail 14925 invoked by uid 89); 20 Jul 2017 14:20:51 -0000 Received: from [195.62.97.28] by client-16-kamp (envelope-from , uid 89) with qmail-scanner-2010/03/19-MF (clamdscan: 0.99.2/23580. avast: 1.2.2/17010300. spamassassin: 3.4.1. Clear:RC:1(195.62.97.28):. Processed in 0.246545 secs); 20 Jul 2017 14:20:51 -0000 Received: from smtp.kamp.de (HELO submission.kamp.de) ([195.62.97.28]) by mx01.kamp.de with ESMTPS (DHE-RSA-AES256-GCM-SHA384 encrypted); 20 Jul 2017 14:20:48 -0000 X-GL_Whitelist: yes Received: (qmail 5138 invoked from network); 20 Jul 2017 14:20:43 -0000 Received: from lieven-pc.kamp-intra.net (HELO lieven-pc) (relay@kamp.de@::ffff:172.21.12.60) by submission.kamp.de with ESMTPS (DHE-RSA-AES256-GCM-SHA384 encrypted) ESMTPA; 20 Jul 2017 14:20:43 -0000 Received: by lieven-pc (Postfix, from userid 1000) id 22B7B26C3A; Thu, 20 Jul 2017 16:20:43 +0200 (CEST) From: Peter Lieven To: qemu-block@nongnu.org Date: Thu, 20 Jul 2017 16:20:35 +0200 Message-Id: <1500560441-5670-5-git-send-email-pl@kamp.de> X-Mailer: git-send-email 1.9.1 In-Reply-To: <1500560441-5670-1-git-send-email-pl@kamp.de> References: <1500560441-5670-1-git-send-email-pl@kamp.de> X-detected-operating-system: by eggs.gnu.org: GNU/Linux 2.2.x-3.x [generic] X-Received-From: 2a02:248:0:51::16 Subject: [Qemu-devel] [PATCH V4 04/10] qemu-img: add documentation for compress settings X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.21 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: kwolf@redhat.com, Peter Lieven , qemu-devel@nongnu.org, mreitz@redhat.com, den@openvz.org, lersek@redhat.com Errors-To: qemu-devel-bounces+patchwork-qemu-devel=patchwork.kernel.org@nongnu.org Sender: "Qemu-devel" X-Virus-Scanned: ClamAV using ClamSMTP Signed-off-by: Peter Lieven --- qemu-img.texi | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/qemu-img.texi b/qemu-img.texi index 72dabd6..fcc4c1d 100644 --- a/qemu-img.texi +++ b/qemu-img.texi @@ -676,6 +676,26 @@ file which is COW and has data blocks already, it couldn't be changed to NOCOW by setting @code{nocow=on}. One can issue @code{lsattr filename} to check if the NOCOW flag is set or not (Capital 'C' is NOCOW flag). +@item compress.format +Defines which compression algorithm is should be used for compressed clusters. +The following options are available if support for the respective libraries +has been enabled at compile time: + + zlib Uses standard zlib compression + +The compression algorithm can only be defined at image create time and cannot +be changed later. + +Note: defining a compression format will result in the compression format + extension being written to the Qcow2 image. Versions of QEMU before 2.10 + will not be able to open images with this extension. + +@item compress.level +Valid for compress.format=zlib defines the compression level to use for +selected compression format. The default of @code{compress.level=0} will use +the default compression level for the format. Alternate values range from 1 for +fastest compression to 9 for the best compression. + @end table @item Other