From nobody Wed Nov 5 05:08:43 2025 Delivered-To: importer@patchew.org Authentication-Results: mx.zohomail.com; dkim=fail; spf=pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) smtp.mailfrom=qemu-devel-bounces+importer=patchew.org@nongnu.org Return-Path: Received: from lists.gnu.org (lists.gnu.org [208.118.235.17]) by mx.zohomail.com with SMTPS id 1532462903039929.0133198669183; Tue, 24 Jul 2018 13:08:23 -0700 (PDT) Received: from localhost ([::1]:42433 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fi3bZ-0001mF-U4 for importer@patchew.org; Tue, 24 Jul 2018 16:08:21 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:46017) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fi3Xe-0006wJ-3B for qemu-devel@nongnu.org; Tue, 24 Jul 2018 16:04:21 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fi3Xa-0007hS-VE for qemu-devel@nongnu.org; Tue, 24 Jul 2018 16:04:18 -0400 Received: from mail-eopbgr730114.outbound.protection.outlook.com ([40.107.73.114]:31360 helo=NAM05-DM3-obe.outbound.protection.outlook.com) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_256_CBC_SHA1:32) (Exim 4.71) (envelope-from ) id 1fi3Xa-0007gE-MW; Tue, 24 Jul 2018 16:04:14 -0400 Received: from Jupiter.local (141.226.29.227) by BN3PR07MB2611.namprd07.prod.outlook.com (2a01:111:e400:c5f0::15) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.973.21; Tue, 24 Jul 2018 20:04:11 +0000 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=janustech.onmicrosoft.com; s=selector1-janustech-com; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version:X-MS-Exchange-SenderADCheck; bh=28SjQ34LlAiLZ9C22aoKcizj58nle6yEI0+SKkPNZns=; b=PUy9mom2NKcsA5PpEOf/eB5sKMNhgw4BEn7ZTXsqEpglXu7i6fqEa1IMXxjED5lWssVahUG6JiXjY+4kFPdIsY82oSnXvYqBFv0qsrPy0SoQnOvjSbC7ULZCjmmkdinQaOUXaarV6b6xRx997a14HBvKnEBTKGpoD6DA+8Fu8A0= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=lbloch@janustech.com; From: Leonid Bloch To: qemu-devel@nongnu.org Date: Tue, 24 Jul 2018 23:03:40 +0300 Message-Id: <20180724200343.13733-3-lbloch@janustech.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20180724200343.13733-1-lbloch@janustech.com> References: <20180724200343.13733-1-lbloch@janustech.com> MIME-Version: 1.0 X-Originating-IP: [141.226.29.227] X-ClientProxiedBy: AM4PR0101CA0066.eurprd01.prod.exchangelabs.com (2603:10a6:200:41::34) To BN3PR07MB2611.namprd07.prod.outlook.com (2a01:111:e400:c5f0::15) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: e6226e2e-e9e3-475b-c7fd-08d5f1a0a03f X-Microsoft-Antispam: BCL:0; PCL:0; RULEID:(7020095)(4652040)(7021125)(8989117)(5600073)(711020)(4534165)(7022125)(4603075)(4627221)(201702281549075)(8990107)(7048125)(7024125)(7027125)(7028125)(7023125)(2017052603328)(7153060)(7193020); SRVR:BN3PR07MB2611; X-Microsoft-Exchange-Diagnostics: 1; BN3PR07MB2611; 3:pbPLreSMtH/TNeMsKiKeglIcJ9aiJ6ppaM7wy97SLNKEEaIswS2JpNmB5734OZX4QNXqgLRF26NZuqfULFwpDX9PM6LHaQ8FSS76X5a/bbjm4OZgX7vjUU18cfLvTYcORWKHuUK+UxXYKMMB7elPJNXCL+amFOoHUC6qo0cOLNMQd32OmbKfLVsCRM18Enjk3V6e7kpb8kKoui7L74Cy29YcNah5vVSTHmPpKzk4AgJWz2/amfiRoyPqZE5HpSsX; 25:xyyiKsrxdbwYM6GdN5mN33DzidoaHQqmCRAK7BzjyfobU5FW6+MQBCHL6uiw5l8NGsUv2L3k6hxK7V1KYI3Sh0XZvPMr/8oU1cn7ZisODHnXs3TPLFd1AHRd4mVFjadML/1c+j5HaVx1QPcCJjn9Orv/9mOJECqHeClpP7ImBY5OEno1SpsDHLN7pxGGQDx/yqy/xIiMG8MxxA3pGNQnYBQLTPLHh670ejkntPi/ilqcRJmAQdouv/1CL7WgNz7r5xxKz823t5aViU4vyoCY8O4zo+scGrgMhMMOo6HUPxQehGr0kaPsiV7uT4NRSUNPQiBas23oZ4KWNQPFJKsZFg==; 31:vUJIZZDEfnF5Dc6YwvQ6epJJvlyCqVHuEtcAuWU9L6stbCf+Tghv5A64qiLSwHBhyznT5rNRWgDLFmBJ+ysZT7q20XnGBnhddUX/Am15ZO6YV2R/ukm1fVmynz3Gnp+boUvSV65jwNcvsJ/nnwHlESarq+O7JG1wV34tFXKSXrNmX97rGLtPLhMgZ+cEmnUuubUSY64fEYwHa9QnhxOpbWnmBZZIOPcVk0vt8Bikv/4= X-MS-TrafficTypeDiagnostic: BN3PR07MB2611: X-Microsoft-Antispam-PRVS: X-Exchange-Antispam-Report-Test: UriScan:; X-MS-Exchange-SenderADCheck: 1 X-Exchange-Antispam-Report-CFA-Test: BCL:0; PCL:0; RULEID:(6040522)(2401047)(5005006)(8121501046)(10201501046)(93006095)(93001095)(3231311)(944501410)(52105095)(3002001)(149027)(150027)(6041310)(20161123562045)(20161123558120)(20161123564045)(20161123560045)(2016111802025)(6072148)(6043046)(201708071742011)(7699016); SRVR:BN3PR07MB2611; BCL:0; PCL:0; RULEID:; SRVR:BN3PR07MB2611; X-Microsoft-Exchange-Diagnostics: 1; BN3PR07MB2611; 4:TJ58UWIHATRZrKwDgiFddHQrTWimpw6qWska4K56b7N7+glK5IUii1EUmq5m62okUZkEyu/lgn+ijofjCJzl3kLabziOHh6S5hcCLYxNHtvKkKjK2kE9J4Py40DsXtVNxzU1VqqRhlIFe6rrvIwSFgJFXc4Ew2FLqW9omjTgmaDAjPmgWw9WADoWKXGVEB3kyNlUxPse7Pd1Fs/7uTxDL7QjxGnq8A6edGNOaEJzV0+GJDhOKjmoi+mNfQn/xoDZbxSX9JWO40D2aaCZ7+noXw== X-Forefront-PRVS: 0743E8D0A6 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(346002)(366004)(376002)(39830400003)(136003)(396003)(189003)(199004)(486006)(2351001)(50466002)(48376002)(6486002)(107886003)(6512007)(4326008)(53936002)(25786009)(476003)(956004)(11346002)(2616005)(68736007)(6666003)(5660300001)(16526019)(105586002)(446003)(106356001)(97736004)(2906002)(305945005)(386003)(6506007)(76176011)(36756003)(8676002)(81166006)(81156014)(26005)(316002)(478600001)(52116002)(51416003)(1076002)(54906003)(50226002)(8936002)(47776003)(6916009)(3846002)(2361001)(575784001)(6116002)(186003)(7736002)(86362001)(16586007)(14444005)(66066001); DIR:OUT; SFP:1102; SCL:1; SRVR:BN3PR07MB2611; H:Jupiter.local; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; MX:1; A:1; Received-SPF: pass (zoho.com: domain of gnu.org designates 208.118.235.17 as permitted sender) client-ip=208.118.235.17; envelope-from=qemu-devel-bounces+importer=patchew.org@nongnu.org; helo=lists.gnu.org; Received-SPF: None (protection.outlook.com: janustech.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; BN3PR07MB2611; 23:ljT9okF/yHmA/zcESVrBDTZkhKeeC1d8CnzTuALBq?= =?us-ascii?Q?KN2Z6yioO1H6XHAWuLYnInf/kwgl75sI/Vcf9uHUvqiedXHL/iLK1ed8jZ18?= =?us-ascii?Q?zuVkdpqPYHZc0O9qsMV4P4V/yW/Y7IW/nVs+H72tkhJ+jzCnVefdsQWP7hyb?= =?us-ascii?Q?QlU45mc5nUGNdPyU4OfVc0I3O/mvl+g/3Tgw1l+uYpCU/UQIqrDyXx54ywps?= =?us-ascii?Q?E1Vif6lbKdCkDHPX+qIpiZc5FvC4AB1J0PrYpx8pvct0kqoIboI5bcoio672?= =?us-ascii?Q?CM/iYy06gIYxOvcmweR1JqzL+EJk6bQvBtJP25jm70ALMJok5xoiVKAoKGhc?= =?us-ascii?Q?2IPLcsOGf4qi6EeooTiURtrK7Mrj575gt+7OXmJtvHQYq+CRv4Dt/GqBaS4s?= =?us-ascii?Q?qh28qXImqhBlHOMpELANMq5I/9oO7nwighSxE7Dl3oW0tf1ETBBfWMcex/9i?= =?us-ascii?Q?4E156f1MhhTD1EA8LqT89/y8ScP6+BVcPPtZdU91wdZp+fIZKwTbxLtk+nwk?= =?us-ascii?Q?2bsqXEsLeZ51zjNAojgTIZFtQBF/mA348suaHhctLPMfgzJ7qqXeO+/CKmvB?= =?us-ascii?Q?Pv2YyikJwdgWcjolubUoOSDDPoIjEajdf4BeLnkdm17uB70Yf1p3gBtt8Wlw?= =?us-ascii?Q?qVQcrZnJMHD6aK0nJW1rxNk8YsLV7sTXCECtzlKvBUB9d39CznxFC97+hYIp?= =?us-ascii?Q?iTGLoblMLN+2mbSqWalQ2WJZllROFci0msrGGfIDJiJWy7fJ1G0rj/L/wgDW?= =?us-ascii?Q?4eiC01I7fUUWmIBlvFkNq2WQsbXqb/ADJI1E/Eke048++hqZ8qN5N0ewGSxu?= =?us-ascii?Q?YQ+6b4YGlmfAb7jzuMUH/SVSmb4y3NGdtG1INVhq2vB0QiYhOhEHvidG+U4H?= =?us-ascii?Q?oubBF0LiAdtQUl4iQfb+Xls9bH5lxmNVvG3+6MXdF9Jnn5hdG2BJ6YLQ9Eg+?= =?us-ascii?Q?l3szauirTwFroLa1f1OVTMfdFYVdMeekZQ7z9OkzdTazN3t8ohYDS92DcUqL?= =?us-ascii?Q?TZin7oHtms+KIbpr0WZL11CA4twZ/3p8q3tXIu2ZJAzCRxFSSE///4nP65fv?= =?us-ascii?Q?o3GM3jDh4xo8lLQKn73tGrrXOLwzKywNzeSx6kvLWdCUI+aDvcT92Y3tBE05?= =?us-ascii?Q?QGvvms6lBNoXZR1IqZd0eZYhfe1HNPVZj8Q6YEkJtE4Za5Xi1SO/DtNyqSsa?= =?us-ascii?Q?fWLbhbqAcsew09lwZgc4NPrDjnFRCzmU9Gm0JIQpz+5EY0yP4xbYe0Sic3d+?= =?us-ascii?Q?fPeSb/l83NXUXS3CAtB1SxyHDDPFpaldyYBzbwRolJE25lWER4s7W2QDJTCu?= =?us-ascii?Q?8dd0+I+9nuCvmflN+phw2Q=3D?= X-Microsoft-Antispam-Message-Info: U6voG12Elw6kGy8Opr8VuDzDZLUKakNVapjCIraLNeWI0t8y8o4aVAUik4C+ieUOjQgxQO8usUgXxXg7hS7lnNzs5xJvbSOeYEP7nx4EbZhlX6FvJt5/aeT65Cc8CbTsZKswuxW3RfQH+eqpMOO+x4LkhfiTd9Vvl7WPchmMzgt6lbKhkcjbC31rzBxhsnNK5YOw9eQ3HlNco9gEjuQ0gVx3C0IGV7BtAgTHMGzQGTMxkg1mC6yTYKHFYSFBDlK2F+fy6P2obqnbIkDkQL0XEUJOswdZDNxchMtHRYZTLFtAa0MXtAGd/QM2b4tiGlPrVEiuuZgGiC4dbVHjJZCXUTiadhhMRA556oTPnCO7FjE= X-Microsoft-Exchange-Diagnostics: 1; BN3PR07MB2611; 6:2gv55+IJX4RzhPvpryf4UMhqMxUPK6iQJloRvOD3H2x7iUt2yfaPVfvsTBikEgWcHMCRjoa2IX6Vj4BNKwrQ8FgSmdEEEUm2fo3MEdIcf7OLoFM6U79ayhyDVGS1uB5xlyLrcGgcQCRRhY5Q18XjBv4YOU3L5p7ppIgu6vrQl/ZrAazfxUs0eipqdlmYuiX39AhfUTtMfaXn3Rz1/AxcdxcpeIQWxKy1r9IRM0OSPmxrifuRMSA5Xsx9W4rEzA0RaKgv56OMVtItIwKep5yFewD15nWMKNMsRTC4vwEMOQ2vpf1le3PepAeUk/oNhlPt/6oWdpOQZsCmyRo7TVNZ84ewbv/42nvlOqAqWIzaCNUodmL6ZoGrReYC40A35V+KfPzVgyhNj2A6sOWR5ZZQ3S4jGh3a1WCYzbMDkNO8YgyW3/MWVGqTh6Pz8MYSQUbiXLmtMUG/SyjpGWjwKX8QRA==; 5:dZKZ75hwHkhdoybRfT6HCOHKjvxoc5VPgZgIsccVxsegMWB3iDOUebZ26rIJMM+DQFP9KcKtftp2h4JHO8R7lOZUNetSMNz4Y8Pmr6q2ETLF2IBL3WUyswPuTruU2eHqsr8tErkta8IHdo22hdmUJTrEMJFVh67c7myI4baMqdE=; 7:GXRZkM/zMuMOPTsUCbQKSA1GhXvfVcQXVniEtRiLrmyqn1bTZTTpPR33t+eIcXizOYlSZ95ZuXG3z95rSt34mdiFleMCljvcn27m9DmRuU0OMpcRNYB3aNol2k/HxZeK7XfPNnFFWLb/dE5v2sgiVDxkiDx5dGm0HB0Ouuk79LmS99dFaafc11nX8Y47q+zNLsCesHxqa+tRZkxcJqi3dG8HpxQwX5mGr33xW0iJHENN8SOX8cF1eaywhJXXNFps SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: janustech.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jul 2018 20:04:11.2465 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e6226e2e-e9e3-475b-c7fd-08d5f1a0a03f X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 34eb020e-3cf3-43a1-afeb-f5cf1310628e X-MS-Exchange-Transport-CrossTenantHeadersStamped: BN3PR07MB2611 X-detected-operating-system: by eggs.gnu.org: Windows 7 or 8 [fuzzy] X-Received-From: 40.107.73.114 Subject: [Qemu-devel] [PATCH v3 2/5 for-3.0] qcow2: Options' documentation fixes 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: Kevin Wolf , Leonid Bloch , qemu-block@nongnu.org, Max Reitz Errors-To: qemu-devel-bounces+importer=patchew.org@nongnu.org Sender: "Qemu-devel" X-ZohoMail-DKIM: fail (Header signature does not verify) X-ZohoMail: RDKM_2 RSF_0 Z_629925259 SPT_0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Signed-off-by: Leonid Bloch --- docs/qcow2-cache.txt | 3 +++ qemu-options.hx | 15 +++++++++++---- 2 files changed, 14 insertions(+), 4 deletions(-) diff --git a/docs/qcow2-cache.txt b/docs/qcow2-cache.txt index 8a09a5cc5f..9d261b7da9 100644 --- a/docs/qcow2-cache.txt +++ b/docs/qcow2-cache.txt @@ -130,6 +130,9 @@ There are a few things that need to be taken into accou= nt: memory as possible to the L2 cache before increasing the refcount cache size. =20 +- All three "l2-cache-size", "refcount-cache-size", and "cache-size" optio= ns + can not be set simultaneously. + Unlike L2 tables, refcount blocks are not used during normal I/O but only during allocations and internal snapshots. In most cases they are accessed sequentially (even during random guest I/O) so increasing the diff --git a/qemu-options.hx b/qemu-options.hx index b1bf0f485f..ef0706c359 100644 --- a/qemu-options.hx +++ b/qemu-options.hx @@ -752,15 +752,22 @@ image file) =20 @item cache-size The maximum total size of the L2 table and refcount block caches in bytes -(default: 1048576 bytes or 8 clusters, whichever is larger) =20 @item l2-cache-size -The maximum size of the L2 table cache in bytes -(default: 4/5 of the total cache size) +The maximum size of the L2 table cache. +(default: if cache-size is not defined - 1048576 bytes or 8 clusters, +whichever is larger; if cache-size is defined and is large enough to +accommodate enough L2 cache to cover the entire virtual size of the image = plus +the minimal amount of refcount cache - enough to cover the entire image; +if cache-size is defined and is not large enough - as much as possible whi= le +leaving space for the needed refcount cache) =20 @item refcount-cache-size The maximum size of the refcount block cache in bytes -(default: 1/5 of the total cache size) +(default: 4 times the cluster size, or if cache-size is defined and is lar= ge +enough to accommodate enough L2 cache to cover the entire virtual size of = the +image plus the minimal amount of refcount cache - the part of cache-size w= hich +is left after allocating the full L2 cache) =20 @item cache-clean-interval Clean unused entries in the L2 and refcount caches. The interval is in sec= onds. --=20 2.14.1