From nobody Wed Nov 5 05:21:42 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 1532451921082448.1684058082153; Tue, 24 Jul 2018 10:05:21 -0700 (PDT) Received: from localhost ([::1]:41593 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fi0kJ-00023C-Gw for importer@patchew.org; Tue, 24 Jul 2018 13:05:11 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:43192) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fi0iQ-00019T-0y for qemu-devel@nongnu.org; Tue, 24 Jul 2018 13:03:15 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fi0iM-0004w5-O3 for qemu-devel@nongnu.org; Tue, 24 Jul 2018 13:03:14 -0400 Received: from mail-co1nam05on0731.outbound.protection.outlook.com ([2a01:111:f400:fe50::731]:7191 helo=NAM05-CO1-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 1fi0iM-0004rL-Fa; Tue, 24 Jul 2018 13:03:10 -0400 Received: from Jupiter.local (141.226.29.227) by CO2PR07MB2615.namprd07.prod.outlook.com (2603:10b6:102:14::10) 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 17:02:50 +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=6f+/tN1Lt3MuuccllODTrjdSgP62VU2ZpACRNHjQCY8=; b=K3o460HYnViAyKLOXb9W16PBE8LeIZFzNL80Q/pLsNWqfRlftZxNnfp9EXkPj03POucGiT6MbRcF7ccqk2znxnEG99W+vVAHHnmMJXAa46baRqNMU8jqwdNp+zHZ8SIlaCMrdd2RxSfr9RilvjQx2b/1BdOfWbTSvtd1K7+cSSc= 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 20:02:17 +0300 Message-Id: <20180724170217.10247-3-lbloch@janustech.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20180724170217.10247-1-lbloch@janustech.com> References: <20180724170217.10247-1-lbloch@janustech.com> MIME-Version: 1.0 X-Originating-IP: [141.226.29.227] X-ClientProxiedBy: VI1PR0501CA0029.eurprd05.prod.outlook.com (2603:10a6:800:60::15) To CO2PR07MB2615.namprd07.prod.outlook.com (2603:10b6:102:14::10) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 88d59645-7acf-4e50-d011-08d5f1874b23 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:CO2PR07MB2615; X-Microsoft-Exchange-Diagnostics: 1; CO2PR07MB2615; 3:aXD54kpS1OgWZj3szF2eX8BjBgTsK7WSzn7dnyiXV96qy1o++pQOEorzy1SFqfoR4tYKuUs6dt1dtmEHoxaSXpXaX2oMeKbR0ziGTiIFM0xOg8YthEZBYZIk4Q6EhLFLqMxgpKg1MClXrNV3iO2azBC02xIipdlkbeBpY+aaPtk4KogmcgIWCl8Cu7RfvO07W/91H7dDzkPVwwXwkRWkROCagESJjHp0vE3zV5T+Ukb+tMBbJeb4nlpyokiLqJu3; 25:kZheOTHwPL7vnQJhWt3+tpqTyiIwHFVonzMZTh7CBrpp9kr3OJikN7zHMYnfCVqeByIr1mEDkD0cCglZxI6KyI/vnyJEULecE+amTzQdCIGEkKl9ZE5eu9tY2pB33Cn7pkGJaFk5LkGWPSUhJa/uIopXZUXRrz0KUtXPEriGsVygKV7avZ2Xt619svr9ohc619nVmQAkXBZANMx1cX5HUO8i8+ZaT/d/cawWNRXX5tysHLH8AIAnLcpv4CfW7lHn5rFmAQly0WTIl6dQhsmAMPRtl65g5j9zBbw3nXq2ZF6j30CNlqesJ8SOrE8y16OZtkxHv9YoP0XxQ8p/zqUnPQ==; 31:8yjXo9240V1ArXNLcQ9ZLfQ3f96IyUhvMgpjfytTL3UuAftaobvuLr8sauYNm4uOmYX+gMVBL7+Q5BArLCVXYg+GkdVXc7AgzrMbgaaWVAWwaZuC/Dv9sYQ1QqBGbRP8jJaA4dd/yjOAaZ5PMfi3Ldo4rx87kzZA1CGr4nckPmQfHN10hklKAKKAuvb5UnIA5T1Oz4SvjdyD0rqDs99acwr26C+FMtphRxZbiZI/5t8= X-MS-TrafficTypeDiagnostic: CO2PR07MB2615: 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)(3002001)(93006095)(93001095)(3231311)(944501410)(52105095)(149027)(150027)(6041310)(20161123564045)(20161123562045)(20161123558120)(20161123560045)(2016111802025)(6043046)(6072148)(201708071742011)(7699016); SRVR:CO2PR07MB2615; BCL:0; PCL:0; RULEID:; SRVR:CO2PR07MB2615; X-Microsoft-Exchange-Diagnostics: 1; CO2PR07MB2615; 4:hkcImvrAm/5AVBzGH11jtuns7V+lphCo47AloWadzYbvjmlw6MjoE6Yswmaj74mF7Gle4iwDevFaPzEq9Mm2toy+wpXSQKGMH5wF0ezef6kYVwl08klQRJRXc4X/l+2lwrAwDQtXQGQsEZxjEPB8wRk1pYAnhbUgJ12mwPfnKkheUGKBGmGnnw0QjnZ4oDCV1t7G8OZihjR7QhzBXm3XTJx6dChMEoPJbToV/RcXrS0gEJeszX37tyRyJ1SveUIoq2t3e+Ms+BHbk589R75xUA== X-Forefront-PRVS: 0743E8D0A6 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(366004)(136003)(346002)(376002)(39830400003)(396003)(189003)(199004)(50226002)(2616005)(6506007)(68736007)(6666003)(11346002)(446003)(26005)(2361001)(25786009)(8936002)(6916009)(956004)(16586007)(1076002)(107886003)(8676002)(2906002)(81156014)(54906003)(6116002)(3846002)(6512007)(6486002)(5660300001)(476003)(4326008)(486006)(478600001)(81166006)(66066001)(36756003)(16526019)(14444005)(48376002)(47776003)(50466002)(105586002)(316002)(2351001)(97736004)(106356001)(386003)(51416003)(76176011)(53936002)(52116002)(7736002)(305945005)(86362001)(186003); DIR:OUT; SFP:1102; SCL:1; SRVR:CO2PR07MB2615; 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; CO2PR07MB2615; 23:H2nmnUMu4fQGzhKjPMKcL2MtNa3YkqlVqpIA3V/eB?= =?us-ascii?Q?YQj1xNfgQ1AgTkfdxuOOw3IKDlq82MjZYltUvEV/6ZxYfCYcp8gBuQNYv73h?= =?us-ascii?Q?NiCFWDeIFZGvFCCpmHRIcGUzax8rFPle6zCZoFK4IKillAuxwS8LUmQA/ge1?= =?us-ascii?Q?7AbTPYu0o8cXhR7DXn5Azf7gxix+4jgq8GgXLt+2VFI4QlojGvHz9/ysGsf4?= =?us-ascii?Q?sS3hRdFv9WdOaevVwQv1baxxA9TPHCKVSsC9ffCzQtE9hfJ4R4WqBbFuj6tN?= =?us-ascii?Q?ILbQVM/F3DXXzgeUq3TN1qvmraocxkLqN1OhzIlMM5k7j616Rg9DYX76VM9S?= =?us-ascii?Q?tV6ehOUXggvpOwsfq4VAmY4FiZ0bjaqFtulwre6B0LosRC0PuFAO1ji/Tma/?= =?us-ascii?Q?/tFZ+ZM5u6AGE+qaO7wd63+8xTLXFXdPff3137FEO0TaGCoV0qubgJPqji8I?= =?us-ascii?Q?0MJfQ/HU8La/dypSz02nPbWDousNuGsLnk9tFxUM31c4d39mcd8zCO3N5I6I?= =?us-ascii?Q?Iqks70GIGgK45NAcusdQcxpCsTnMoCtaQxmHMq9VdD7P2UCuXs0eGndMn7O8?= =?us-ascii?Q?zm//1/qVlPAebUxacAHoBKcBz71V6WDBqdmsnWU8FbMByp3ZawU6UUkXmc9g?= =?us-ascii?Q?rt4ZETPhm0BTH+XeyJkvAM0rVxBqLcrjJHrU2qOp9xwAJQnfuZfPIJzRBJ50?= =?us-ascii?Q?rfjWMR1nMCLaBAMTo/thqqNaRo5VZaW8HuJwCTfo6msLw1hIHN7hn8gAKSff?= =?us-ascii?Q?NZ/0c/IhKsP7XsBaD/AGQK/2n7jDgrSjHP3SD8KJdDceNMDU6R61185Bf0h6?= =?us-ascii?Q?rQlsUZ7Z2tRAHDunIXmNhKY2ZMJyGzsZUdeKVJld+rilOmG/lEKwye88Fp9f?= =?us-ascii?Q?wfOr2h9pqr9MtMlgZb0az3GwQAVSvlYWJk9iAPYynCEBDsHlbf+gb4qqFydP?= =?us-ascii?Q?LnUoxAHlPrQymYN0r7ocGYQqpO495rS2yJU9aO/xT1XKn6JqDzl44YssMxeI?= =?us-ascii?Q?4iDsn7Dgu8qZf9kER0/K5CWLdDHRmmIcNcb+YQQo5Z2WcBSCeGyhCSSQ31B9?= =?us-ascii?Q?kqi369nt5ZonQZ8daF4G2GiP5ykpJ7SyPkWTI5maD7ZtcSnH7VF8RNweMT8G?= =?us-ascii?Q?YrTKRylIHXOIodNodbwpwHziae+BMHaDQkBOz5s0TH+gh1AsxNBAQr4XzCi7?= =?us-ascii?Q?32hp/gE1j/M7jk9LrWoWC3qvi/wiSHh8BgOgtRu8bpE9TVdoAgpY7peQngxI?= =?us-ascii?Q?/PHZ7Hff/C9wPEmVdW5CWGMhFiEMXAbZGuSbm/xaKIks8Wq1i8CPztwTyfpz?= =?us-ascii?B?QT09?= X-Microsoft-Antispam-Message-Info: CDHrjww9RnW+HEAxAlomorgq8dLOuCt+EkhSN/Lero/wiBg+/uQNaQtmmUtSevo3Cu6EDEP8YDLGZ2pWMA7kODQ7wFZ/GT5dYLptF6xAdzXP7QHghZvrtIMKTj8/9J0m3p3DAYiZq5ISPoVFlE+4UYpSSJVAQVt/JHNPSiOIzcFmCIe3AahrrZA5nwwiV8cdT4cTPqQfe3AqtSilh2UV0SGEosu6qbQZh9u6uM0tsqho1KUcYTkca2vWx5KRmLlaucMQ0/EIQCPhvgq6sYa/g031DbbNSu6kIdZeH24+wEsc7tI3hBlbx4vvPSLrRf6+6I7ErJPKdg5Ph6ymfTIn3RcCiKA6E+wuSmtiV/1APmM= X-Microsoft-Exchange-Diagnostics: 1; CO2PR07MB2615; 6:+/je2V87+sHUEvV7loZv1cznz7fvBICcmMZjpnDiLWK6CWm3gzy3hqIeQLvtLwrI811KQ21oZ8IwfPuNp33QmQDB1XGwl4eWOEJFEMKJxVgR35YDJluSuJP+GJfyEm4u9RQi6IK1zR40eKPaD+TJ/8WRb3vyneIkw3Buq+nfB9o8dOONEX+fmRuvxNNGuyHAdrHr05bnBhMwPGEATX3+VZDKpPdVT/Ffe8tTyXVhQ+gIIPl6xRWEoQ5xfE7A5SRAbYCo3kWh+25nChvWEgaSVYb8U+m82Y9ClUJGeqRA8kiX4Bc7NojlGwTJjzSsZpDsFciunr1yC0CcjdJqqPN1R95C0E4cvjgMRRjb19151oGKjKyXSyJWK8iKZRHj2HWF5DXOuYb5Sn0AwJxezIsf7G+fywZbWg8PzHiQKO8mesb/bX4kBVoSQOdjeavgthqcbH/jyAJ+bkO7cS8xEZpDIw==; 5:W8iRquwRsVSwvkmH1vLllrx5h2/6QhRAuxx38DhTABey6yTUsqP70E1HvpHeFQYApjl9PwaFZT7OsZoBEvirFlwsllK0rdxNhZJIVEiu2HoqhFOAcrni1UXnwwr0A2L1+YxCcm/4rTV80vwPAJ/H4yCk7+CBWQ5ZVr1tITpnUtA=; 7:xk5SXqvj/Iuw+iGpeM5ByKdPJ2vT5PS0jd4faejrabInZoHDoEvGawAkuYcN6lvQoc0AjpwE7Xibe+YL59C6SjJpTxVQaJ5r2Gx93oE2yojYNTu0L4TKq5VL5jryt/OnZIoO1PmUR0+VRx+XFqg5y3hpsJ0MpAJN03Ye3doIvEDLi24Wf7gC7BedjSSk2QmE3EThaEPOS7wibtDjMlpTizdcomvLVrtvOp3m9ei9sNTXirKrXmO74QSaYSLcm6VZ SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: janustech.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jul 2018 17:02:50.3070 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 88d59645-7acf-4e50-d011-08d5f1874b23 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 34eb020e-3cf3-43a1-afeb-f5cf1310628e X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO2PR07MB2615 X-detected-operating-system: by eggs.gnu.org: Windows 7 or 8 [fuzzy] X-Received-From: 2a01:111:f400:fe50::731 Subject: [Qemu-devel] [PATCH v2 2/2] docs: Document the l2-cache-full option 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" This documents the new "l2-cache-full" option, and sharpens the documentation of the related options. Signed-off-by: Leonid Bloch --- docs/qcow2-cache.txt | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/docs/qcow2-cache.txt b/docs/qcow2-cache.txt index 8a09a5cc5f..ea61585a4b 100644 --- a/docs/qcow2-cache.txt +++ b/docs/qcow2-cache.txt @@ -110,11 +110,12 @@ How to configure the cache sizes Cache sizes can be configured using the -drive option in the command-line, or the 'blockdev-add' QMP command. =20 -There are three options available, and all of them take bytes: +There are four options available: =20 -"l2-cache-size": maximum size of the L2 table cache -"refcount-cache-size": maximum size of the refcount block cache -"cache-size": maximum size of both caches combined +"l2-cache-size": maximum size of the L2 table cache (bytes, K, M) +"refcount-cache-size": maximum size of the refcount block cache (bytes, = K, M) +"cache-size": maximum size of both caches combined (bytes, K, M) +"l2-cache-full": make the L2 cache cover the full image (boolean) =20 There are a few things that need to be taken into account: =20 @@ -130,6 +131,15 @@ There are a few things that need to be taken into acco= unt: memory as possible to the L2 cache before increasing the refcount cache size. =20 +- If "l2-cache-full" is specified, QEMU will assign enough memory + to the L2 cache to cover the entire size of the image. + +- "l2-cache-size" and "l2-cache-full" can not be set simultaneously, as + setting "l2-cache-full" already implies a specific size for the L2 cache. + +- 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 --=20 2.14.1