From nobody Wed Nov 5 05:10:24 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 1532462787010480.8793063911952; Tue, 24 Jul 2018 13:06:27 -0700 (PDT) Received: from localhost ([::1]:42423 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fi3Ze-0000OV-34 for importer@patchew.org; Tue, 24 Jul 2018 16:06:22 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:46154) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fi3Xk-0006yY-8N for qemu-devel@nongnu.org; Tue, 24 Jul 2018 16:04:26 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fi3Xh-0007oO-5h for qemu-devel@nongnu.org; Tue, 24 Jul 2018 16:04:24 -0400 Received: from mail-eopbgr730106.outbound.protection.outlook.com ([40.107.73.106]:59968 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 1fi3Xg-0007nm-Tg; Tue, 24 Jul 2018 16:04:21 -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:17 +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=b3SqkQUgnRo+O0q3FlLOQBVicXua1MxJY+C2uFylObs=; b=ACb3ymQNtungtMKhRyEGp2pU36CoC3Py+UyfbAVdZgg/coy2cWeAniwCPWe2wkxnEgQEZw+GEpRH6z2d4juqHk9YBAGl8dv4WsVMR3ZKjF1yO9djAGVZVluoNQdiz1TwTKfwNMLtXMzbBFKO2lBKXdvuoX20f/o9HZHqhMYGewI= 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:43 +0300 Message-Id: <20180724200343.13733-6-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: e32fa97d-34f0-47ec-e4ef-08d5f1a0a42b 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:CCcxcPQkgk/wP5UlXNKrsaySnxX3EnRQdECy7O9asKU7H2HlZCsVRuzQ8mMbOLrNLXVB5xdOzLq0id9Zjh5GBF0iM3Ui5NZhoP9d/m9y8iFDW2Y33/VT2VxSl9VJZlfXyjj7xf8NN2SHvvlJmEqtQTcst1Alep6vchLla1TEn7/tiJzyzwghiuh4ICvLvk+Awwf7wNvHkknPkMW3sx9vXm9S9GR9r1jlNDBpz8/5NeGyQ5hNFFKPEpUTPsl4v7Jh; 25:I3DRDJmoTyWRfDQUeF3lPI+ziWOMAFnkJJfA8VXq3Sj2N5TDp7qrIK1npOeicChQ+xTEu+tPzzoiAPONXNfI1aRrEj62jFymTjN2rL7hvEs/kbb3ykAgKMC1ql4HGuVwnnIwgCWcNpqoyA8i7ftL0IcxcwfgbO/+Jk7QlnHn4CQdlDth4Fu3Vs5Kt91twv7KXE/ooxQce4c3L9Qw5GHlUtqAUJ4GMBLY6yDFvlPCij7+z488+NnFOSBCzxfD41PmiiJ1X9HvZLusixy20acwCX90pG4Zt1FWE+izu5/jtxj5uVV01dfGpirObh605ytfkiztOEzKZwqoWwJQ6kQ5yg==; 31:lzlIwfXOHYtA5kowlCsJ4w4ifvu9+09RogwWsiKZNkp492Rt3LgTTVNuFJaU8VU1bzlrNqrkIDFnsJxHW8nORDeqDY7ohWPkuzyhwvyz+Vr5umDYShWo/hwB4Q7kUC0Aj0lGbngD4GaHnDK8b1Y0d1Jdt5ETXHdA6DbWIghZIJtu+MlbEy6dFfrs+FJGmA6F0v698YpWb0OwNyHidJTDGQE+o05EI1BSORKOUrlGMVE= 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:3FCp3AAtGTWDUzHgUVThZsjes6EwkdJfxajHPmm2p4r3UvD7pWOU83cBRfEXe3vdIv0ZTpQdr4yeDXYosNt8Ipq737b5oMrz6ak90QiqymBq7hizCP9Plxwv2knOYuM7FWuS7Kpb8Gk3NGw41SjNpMJIAzbFzBfuXi1nO4kpWy1ONSzDs3cp21Ds4SopO+ZzWGKbpc6VvaW1v+PIylRHAf/4ukgkK/OPscrAAajmksTSV8U54EuB0s3EkeEA8skKADejjIbtoC3+s7OiVAj89Q== 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)(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:g80M3vh6OX57YgqwqpTpM2jwUdX6DURJhNY25xTFu?= =?us-ascii?Q?TDgPZobE81KwkpA0q8F/6aF24jLqR54wBdRxr14LMkCVGsJXKR5UGsfGDDhI?= =?us-ascii?Q?7ZmOnAwfdARcNtFg4MSWZ0YfDd9qt6G7dERUibncishjsG70AyJzYzkQ8Y7g?= =?us-ascii?Q?W2Q2KtzwVRV6r36NfAIa8KeL2m2Nhjdmg7EcMJ23Jv0xM8z757/s6AfvTT4Y?= =?us-ascii?Q?thCbQ4nyI8IKHYQ3g2HAhq7JK6CNdhRtcah11yviecLRy0pZ+d0slUCue1bk?= =?us-ascii?Q?tU6Dj37WTChb//I0GmbUBV5B2WuV3MFt11h+/QKy+VWPB11oiZCVN9lOy6yP?= =?us-ascii?Q?2dfmFk/32FFyxZHQduP/6fNyGP6VKNZIwhnaFTyxj8yFNckoZq91NlkMAMML?= =?us-ascii?Q?qZH4Lb06aYpHP+JU6az4afUvr367yGwQj/9BiVlUqOtv8S7IGxkUFtoesdO3?= =?us-ascii?Q?ISnx2XKEiinRiJUnP3bI0SC+1f4eXHCVMV0h8+I1rOPV7JDwDPEf+5SblAzU?= =?us-ascii?Q?yRFFVb2H9DVWy47p3Dz19aCSxVrzY57Sf4rkHMMiIJbageKihEYpToaxxLma?= =?us-ascii?Q?+zAvkG5t6wJ27fgqA1F61s2gH3uiTkJuv8OG8YbmFKqbYugpDgq90tZ7xPdW?= =?us-ascii?Q?woDlG4sjPfC7QvJmxSd1cg27sPODwM9OkYgukTOQhlH0T7qNUgTis3JCJHp1?= =?us-ascii?Q?FmFfdmAdh4+xe4sFXsP/ntU0xwbOJbRrE4Jq86Um4UPLZOeaPtTqQgoemIFk?= =?us-ascii?Q?bW7ublrGx8XD5NutWUNwknSVHaJ1oebwjfLl8WMN9LHPqQoYr9o2+zr26OVa?= =?us-ascii?Q?e6jLQyKyiGhotK5t4Aak+Yd6q3TzfLxxYQM+fnxFyxJ7U6tGXxsbtIbjNdeW?= =?us-ascii?Q?oWpucWAVtBAsQL7xhQPab+c4F6o5T9TTCMhxdnQ+9oqw2BHax0N4JwlwPbKt?= =?us-ascii?Q?F4uHyY+DLhJGUe8pPfvUfT4GVHyUNt76pTNDXtZtC+pywSN4ESoZghtZZ0rP?= =?us-ascii?Q?d/6nbqy4FFUNK69G2alfk2NNm+WTYjj4TQ2zDSHdZWxRzzy/Mi8Afl9kl1AP?= =?us-ascii?Q?hFMinndYe0R8NhHRcYQmDQxZflgRJ4jQ9LkKboUuqajXxYt6FiL9ErkB7049?= =?us-ascii?Q?unTeGAheRIdnz8RliKLg88c48Dj4w6iZEyqmG1flErHk1ZO7qTCYDOnLN4Up?= =?us-ascii?Q?ne75xAgp1fH2prDKMPSo9leGoN/2CQ8ED2sDKVi9hgv0fEBoywTlXv+r0KVS?= =?us-ascii?Q?8RA2TvP4ronIwqzltoFPJj+Ap6yqkKP4rRNwyNRhUBRluIR/7d1RVyPImgt1?= =?us-ascii?B?dz09?= X-Microsoft-Antispam-Message-Info: gCfDhNJeFyszw6H/VB1f9it255ya1A0MauOMvu/A1nCCDCb5zu30r+c0a/ifoHN1etzrtYwWu46N8CsG0QcGkutWt/3p7/nA8XnDlrKI8wPeGgRUWNrg0aeaUDW/4V0wfw7G4cmhjy3OwIciNVvvtpqquDjxlxtj24s+kdgIMkSMUSQZeUmZ0MH7A2yM8EiQR54uhT05CMHzdssXuSK93bChve06Un4ZAh9Nq9w14Jsqmf8gC7CrmdRYBM1nuBAA8AbtVZ3d6kVFeply1SWLMXci9fg7dNsNKBOhfkVmrTjYRCmLP+tO4sQ9X6nf9gAG0FspgVZVDY+NC6WuZ0HsPifWhc0rdhNuu2+jEA945/Q= X-Microsoft-Exchange-Diagnostics: 1; BN3PR07MB2611; 6:kpMsc++TnVO3wob/pFA4QMCooAqsVuB/fqpEiD1bBKcNwUvKR6cEChPPnaqSRkyrAJ6ecBYDQQ11CJ2iCDIzVGzBs5SUlNcNxgK4LdXP20XUqAvAG6D+RJnjqAklZ+NBohb7hNIauNjCR01v0Kftsa9nvNZEIqIeCRZ5sle5J2mKrpYT7XZlq57O9MaOvJCd8ipLoCdxOtzmzh08Dg8et7h9TmYHti5BEs+kZsF+NZJeh8ZZ4EGFHoqIj2+5ey5Y93y3tb8JeUqWHQzqRW1bXtu7W8Mp7hg4d0Re0mICMRnGe3GBE3ZjFMzSlM5bBVE7LXuOrMLLo+PNqV5HADmVeHxDliXWMoD9qfdULb8eV/tQ5UhN4fOAUidQdeu5aL6RNIvq6GYlcQgy8umCOa/LOZUNFoyPXbmqWd+E6iW/BMgWdfOr8D5RZ5WbrPeNFRrrxcEtVgDJUA5FnS7XTad1DA==; 5:r2wuQD9tGNeA1+pvuvY2BWrhRY2xA9LPMLm3tI13NpP3amflRnQ6+pT82PuiXq8KyoYkpeDaKN0cSfUToBVB04XD2pC/H8ByPFMAPyafJihYAV68MEh23Mvuf7HaAo1Z+6N+ttX65qNn0mWLT8LOlSfoDkDH3j6uiNdBItReCMw=; 7:a0lwzCu4pVtlcDsn2VE42ycubH0qYaR+71w79Qoi/SF+1MgjTFIPMeVqbNFJQU3d/0ADh+uoMicOv68mEepV2ifbgNX6Z12ago7nkpB9Eik4nLR+umXBefDVwhyZf2ycHs2ohRrpXjs8w543Q8DfiEetBRK+oK8+iKtY4JHgxkcuD0s2na9svqroED4ZX/JKannDNq+ZFVMD2UKycthvMVDxHeywdAqs6DEb2e+riXuZSAGQlYC/jY08GM32C+Gd SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: janustech.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jul 2018 20:04:17.8331 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: e32fa97d-34f0-47ec-e4ef-08d5f1a0a42b 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.106 Subject: [Qemu-devel] [PATCH v3 5/5] 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" Signed-off-by: Leonid Bloch --- docs/qcow2-cache.txt | 15 +++++++++++---- 1 file changed, 11 insertions(+), 4 deletions(-) diff --git a/docs/qcow2-cache.txt b/docs/qcow2-cache.txt index 9d261b7da9..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,12 @@ 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. =20 --=20 2.14.1