From patchwork Tue Jul 24 12:17:52 2018 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Leonid Bloch X-Patchwork-Id: 10542189 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 25D0714BC for ; Tue, 24 Jul 2018 13:43:04 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 150DC21FAC for ; Tue, 24 Jul 2018 13:43:04 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 0895A2858B; Tue, 24 Jul 2018 13:43:04 +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=-7.8 required=2.0 tests=BAD_ENC_HEADER,BAYES_00, DKIM_SIGNED,MAILING_LIST_MULTI,RCVD_IN_DNSWL_HI,T_DKIM_INVALID 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 8AE7D2858D for ; Tue, 24 Jul 2018 13:43:03 +0000 (UTC) Received: from localhost ([::1]:40613 helo=lists.gnu.org) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fhxag-00033O-KI for patchwork-qemu-devel@patchwork.kernel.org; Tue, 24 Jul 2018 09:43:02 -0400 Received: from eggs.gnu.org ([2001:4830:134:3::10]:35787) by lists.gnu.org with esmtp (Exim 4.71) (envelope-from ) id 1fhwH0-00056A-6o for qemu-devel@nongnu.org; Tue, 24 Jul 2018 08:18:39 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1fhwGx-0006JB-20 for qemu-devel@nongnu.org; Tue, 24 Jul 2018 08:18:38 -0400 Received: from mail-eopbgr690103.outbound.protection.outlook.com ([40.107.69.103]:55477 helo=NAM04-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 1fhwGw-0006Hz-NF; Tue, 24 Jul 2018 08:18:34 -0400 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=s75tDprshF3lQg3qyqpn3Tga/o6TrP52+C9ySnZOyrg=; b=WeD4caOSFxZjjdm5f0xgLOIxQsF9JWjm+74GLEdvZsGA8jgzBF29XfF2QP7xYjsTEQNySMrxccYjTCszRuyRR6iA/FUnVzmTl+wIJnSpqC7rwf9I+50x7XKo+JlpIZJ9kCZ7JrSYgVRqLJG4nGC/837NHEk52nl6HIFGWlMlyPQ= Authentication-Results: spf=none (sender IP is ) smtp.mailfrom=lbloch@janustech.com; Received: from Jupiter.local (141.226.29.227) by CO2PR07MB2614.namprd07.prod.outlook.com (2603:10b6:102:14::9) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384) id 15.20.973.20; Tue, 24 Jul 2018 12:18:30 +0000 From: Leonid Bloch To: qemu-devel@nongnu.org Date: Tue, 24 Jul 2018 15:17:52 +0300 Message-Id: <20180724121753.5753-4-lbloch@janustech.com> X-Mailer: git-send-email 2.14.1 In-Reply-To: <20180724121753.5753-1-lbloch@janustech.com> References: <20180724121753.5753-1-lbloch@janustech.com> MIME-Version: 1.0 X-Originating-IP: [141.226.29.227] X-ClientProxiedBy: DB6PR0202CA0009.eurprd02.prod.outlook.com (2603:10a6:4:29::19) To CO2PR07MB2614.namprd07.prod.outlook.com (2603:10b6:102:14::9) X-MS-PublicTrafficType: Email X-MS-Office365-Filtering-Correlation-Id: 71c30d17-a4ec-4434-8dca-08d5f15f92a4 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:CO2PR07MB2614; X-Microsoft-Exchange-Diagnostics: 1; CO2PR07MB2614; 3:/OpwPeGGL80SVxkBGONTfkd2uLhJb2HgKSedOB53XQisDUOhnIJui/A3X0OAvUcyuIJOmP385Xi1K+B1kUFLuPdQaCdgkAFeLE5yJJeIFnOigh9i5aVWqFLooFEABZ6Ey44DA+LzQCTUFan9lI4OzEZL8H1kD0y5LliJQHJyJoJie97qcKtX8gBLUlPU+mgSbpCNXgtreA0//4qw/Re2x+q37PcNobTC/tKNvbqon+4BpTAbJQJqEnrY4Uus42ov; 25:qWdG8PsPzzrhjl1+EeNTvmGKdVG587FoS364yMXYkrhvC0qa+xTRy6YHAIiJS3Bmr4VMVSxKGZtc/BmxqJs5qSl13SRzS6zQG5adH6H2HT3N3Itne9RiV2Zsr4pAfjnbM7OyPhRXrJTWzOL9llP1c3QfQLUlGN8F+jejOFCqtewRLOfM6CVPeL1d5ARTQvd8J8bCorQIIWVM5TpPvYa70YNyIqLpkPXD1cvxfv44G3nGwE4kNWUcoKcoReyd++s8a/Xn8OjYKDVHo4AGWex4pPPKw5BUae+OyTOoHEUzcOpaRYQY1fkJbMuiZ7USugxXK8AWOpX2CcYOaPuvfSkx5Q==; 31:k11iS6rPadUFx0YetMtZaL+nbuLNnDp/g37EX3M72dudoBWb1XxxLlkOH0K9XikQoqXyttvF2xxbTGtbV5Og6zrQJcOeRTbFQ+Ce0AQda0yLuhSZP1tFEgbrY+cxM/ybHy67M9Yo2EmNhSRBghxPq81RSYhEq/xCkjdF9KLZ3LKCBmCVKLU/iZvEiWGPJVRTuOwWTEQeNKGTOyjWWCw6fM1N4ht5u9AVIQT9UjtgiLI= X-MS-TrafficTypeDiagnostic: CO2PR07MB2614: 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)(20161123562045)(20161123558120)(20161123564045)(20161123560045)(2016111802025)(6072148)(6043046)(201708071742011)(7699016); SRVR:CO2PR07MB2614; BCL:0; PCL:0; RULEID:; SRVR:CO2PR07MB2614; X-Microsoft-Exchange-Diagnostics: 1; CO2PR07MB2614; 4:RjKsYIm7j45AeCsVtJ8Ju6ELBMN0lKyGvhhQVCVHV9RHSGUN3sSyKE1rz/fqtBfrqzZHd6Mo2tFBw34i4vodbY9kio49Wo0EptoNC3v6i6Wr2Hx7gEdzHesGVZxVExjuZw2LD46hGH3fgr/c0/IpC3SD4xE/3wvEHP49+oSt7CDhE6mG20WWZkhhgq9PAJiSTihv5bZPR0nohyet3D6rmm5gc+8eD9VCEfd11TVg0P62woX+eUTaZQc37pm4UhUzcYbFq1Qu7Uu7BPG+YDfnUw== X-Forefront-PRVS: 0743E8D0A6 X-Forefront-Antispam-Report: SFV:NSPM; SFS:(10019020)(136003)(366004)(376002)(346002)(396003)(39830400003)(199004)(189003)(6506007)(66066001)(6116002)(6666003)(86362001)(6916009)(2616005)(476003)(956004)(52116002)(47776003)(2351001)(3846002)(6512007)(478600001)(2361001)(5660300001)(316002)(106356001)(76176011)(16586007)(105586002)(50226002)(25786009)(4326008)(11346002)(54906003)(446003)(68736007)(51416003)(1076002)(7736002)(36756003)(48376002)(575784001)(53936002)(305945005)(16526019)(2906002)(186003)(8936002)(50466002)(6486002)(97736004)(26005)(14444005)(81156014)(81166006)(8676002)(486006)(386003); DIR:OUT; SFP:1102; SCL:1; SRVR:CO2PR07MB2614; H:Jupiter.local; FPR:; SPF:None; LANG:en; PTR:InfoNoRecords; A:1; MX:1; Received-SPF: None (protection.outlook.com: janustech.com does not designate permitted sender hosts) X-Microsoft-Exchange-Diagnostics: =?us-ascii?Q?1; CO2PR07MB2614; 23:jKwfTTlS9TTY8e+dK5uzHzKWNZvv3J0yVEoGX+Ae0?= 5VVBXYmoySN0llilQUiMa6T1yvNFrrxfMGCsOgMww7nBq7cIbpm0hSm5NSp13jsDzbR/Yl98Dqlcjwx1gdCiQbetCmY7PdfPjB0seY+LNmbi2lA/AuV7BjdhUmQNSDt9rQNQoEO+DjtAg0p1u+VO6aNmyF18TA//3C2e+HqM/8cVwa/HWtFl6m2Iiw4cJW40wo+QrL0JEjgxG8B+rUFIOx2JX/RTZ3+3Mf4qTxPlZaPOLqRNYpKwy6vAJh0o2AeiwalydwIscIjuLXyLpTYSGz8nQyg4Gdfdh7TTmkxYU0HnyigIQVfXLGhFjyBxxc0xY7f4Shz0fGYmm5R2FoXoPX0k5HMyCC6O3PA6xpd+r49nmUodfyFYZVArD/YkHGfXy3nAn1a89dofPzAOEoYAdMkbGKlQBsIwcArNjsJdmTgRkkKcG3Bnkdd6wIJ9s96SGg57elMy/UV/lUE4e4XCmiMKGDKyfungVVj0X+zRf/XurAT7Qj0gqAjiZpUodeARsBta3IjbpkXtMPr8r07HwIgFN8UNNeNXT/re481y+UrKuxo4pOkfsXE7DNUvQxuPv2KeD6RZooygSksprY10gFVgsVNCRMURwGK3IHMhWUsm5Wor88jI4KVr9QGRxTWo92WqCwbzOdWEXNpS5r9EqDdMSW8joXZPiKG8vKqYTqzrCYGnO0TMRwKw8B8GlbsH2Qrt4azz8fnOhYNQibupBaFDKsn7cegMRZ9Om5Kh2y+Sm/mJ2uX4PQYLVzqJFhc798fv5cABELMGjCNygWl2Ukm6uyKf+3ddx2mThOf242jHqtBYbVlUi4Hb1Wrs0qc6wkfRiMEL+Yu1T0bDFkbKnhEO0MdNd8goI1m8wUHYV12yYvaQ/vKa6A9MAotNbM8JkxY7mO2VdQ5xs+9xrYeTQaDXZxIeUXaB8uPdo78X2M3ruE4l7d+C3FTjz+/TD+NDkC9lPResYfXrdLW5jnhOa3CtfzI5GOFTyxG4+ghMCw/Y7ri+1kvd9AphjJaslzISfQijwVl3N8m8gw1/A4PMl5W9uun5LaNsG8VJ5NFpF01UBXsKIK+3TligDU1Rvp3W+LdwkVjaCDx/c8afcFt3pyrzAg5yutMPs1xBiSQ6CQ1URjYJRuWvakcqFNnZQaIlJ40sugOuF+HSdAoZEiYYSZTLgC41Wx85B+73ED33o9JoNtKRtf7AobLxqXGEseW8YvpQJ4vsMaMqJx6aNJhewl4BbOAZppLgQjUfr9UHPz/xg== X-Microsoft-Antispam-Message-Info: nhSSyHKQx2qPV4PSYGKpSNPf+xLFbps4uwoaEL8fw6kIRUcQBKG5bNxZHlEeKPoZingWQoGWbrBibSjnh2aoJC5w2mTq2WCRHsk94hewhycryM3+BCmPwNSkpiNTc3kCPvGsIFWyAWvE+G1r10gSB5WuZp45aw0yHcLuyWXgJbfFT4VsEW2Jx7/OwdF/cNeBmTmh9IVS8Kx/6b+Lp0nk7y8dMnO7RYEYrHX7qxBIRyJbogiCOn0o7KTM8wYYmSOpEWqeTJQ9mhdTKDrbmD7iqjMXsdKU9zYNEmrryn/f6xUynL7poWrPSgNXKW5MOWjpU/7oaGuSuNTjgLjDZAzD53XqdAZkkdLODI2kTe+hzyo= X-Microsoft-Exchange-Diagnostics: 1; CO2PR07MB2614; 6:H3ocgVHAEoU44DkFKyFJH6XxSe0cY61TP2JFnUc14SjS3gmS59snNaGMpImA0DXPxfpeEXkhrFXz9PLCgRnGUsuwEn6Y1p49YfcrjxfYxABRUOA4iJGDBoBEbkoLVzC2mIiUJwtqlgAcFqurrbhSRsnrOKALKK2xaTi48qXwWpRx9A8nL0bYMPWNkuJ3C6/VG6iD/DxxIagHSAlsuJNcvbQAYGolwHgaCBsMDHO/e9I7K96jNhKb7j2/YP4UXV+3utxmlm+Ya74oRp4VLQhjxCmwHTPWhMEPqu+UeqhF4l3hGL/zrjykxevW1kQCaXygA3/15gpxX8Vat/FD8bc6Rh/pCiglyLs6QpJ5jmIXuYqPX+VKBMkD+x56JvH5xm7xAGxnGHuaNJkSLDf18FfNYIN/jB9HRji0cZvGOHSPRKipTlOtfs8SYtMuYagRZSr4QoMeZtOlCyqd6WP7BUJGmw==; 5:/TZyMKs1Bl02X8a+PiAe99RXwgFmPxPF9S3Ykj5BllY20CYbjp8w2JtjL7jIYCjGZWNg1QnoAmpuZQeDlmQJnC5xAtQ9OdkGJuR1TgwARymJf2AJudaYjUteqNIkSOLq1N7Eoxe3IR9HQimLXiPuaLVUMcbuXKxdleI4wR3hszY=; 7:dmhubMzdrIrimcjp/Z8KVsRoqNEbLXkLx4E9tRGBAxmBQI1pD/N8xpuAPrPYLpsurpyvjmZgaLGVoo/ySxMpAxNGqhTl0B7c6lzWfowlwFWsETSogMTJ4wbAz8Z9jZp4phSsFwy0he7czwgCGwcGQSOOIKWtJn+xb8Cxp/eEEUIvzbK4m/RAdQn3VQGCvqoh1nQAyEoUddewbtkk+/YdCXg7o9ykho3RnveqbwCgX2xtZaMYHp15Yqn3v9l+5XKN SpamDiagnosticOutput: 1:99 SpamDiagnosticMetadata: NSPM X-OriginatorOrg: janustech.com X-MS-Exchange-CrossTenant-OriginalArrivalTime: 24 Jul 2018 12:18:30.9425 (UTC) X-MS-Exchange-CrossTenant-Network-Message-Id: 71c30d17-a4ec-4434-8dca-08d5f15f92a4 X-MS-Exchange-CrossTenant-FromEntityHeader: Hosted X-MS-Exchange-CrossTenant-Id: 34eb020e-3cf3-43a1-afeb-f5cf1310628e X-MS-Exchange-Transport-CrossTenantHeadersStamped: CO2PR07MB2614 X-detected-operating-system: by eggs.gnu.org: Windows 7 or 8 [fuzzy] X-Received-From: 40.107.69.103 X-Mailman-Approved-At: Tue, 24 Jul 2018 09:40:43 -0400 Subject: [Qemu-devel] [PATCH 3/4] 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 , qemu-block@nongnu.org, Max Reitz 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: Leonid Bloch --- docs/qcow2-cache.txt | 12 ++++++++---- 1 file changed, 8 insertions(+), 4 deletions(-) diff --git a/docs/qcow2-cache.txt b/docs/qcow2-cache.txt index a0a1267482..43c0faaddb 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. -There are three options available, and all of them take bytes: +There are four options available: -"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) There are a few things that need to be taken into account: @@ -130,6 +131,9 @@ There are a few things that need to be taken into account: memory as possible to the L2 cache before increasing the refcount cache size. +- If "l2-cache-full" is specified, QEMU will assign enough memory + to the L2 cache to cover the entire size of the image. + 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