From patchwork Thu Nov 30 02:36:50 2023 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 13473981 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from kanga.kvack.org (kanga.kvack.org [205.233.56.17]) by smtp.lore.kernel.org (Postfix) with ESMTP id E72A4C4167B for ; Thu, 30 Nov 2023 02:37:19 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 1FAB56B03DE; Wed, 29 Nov 2023 21:37:08 -0500 (EST) Received: by kanga.kvack.org (Postfix, from userid 40) id 1AA666B03F3; Wed, 29 Nov 2023 21:37:08 -0500 (EST) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id D43CB6B03F9; Wed, 29 Nov 2023 21:37:07 -0500 (EST) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0016.hostedemail.com [216.40.44.16]) by kanga.kvack.org (Postfix) with ESMTP id A7A476B03DE for ; Wed, 29 Nov 2023 21:37:07 -0500 (EST) Received: from smtpin10.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay07.hostedemail.com (Postfix) with ESMTP id 7BF0F1606B2 for ; Thu, 30 Nov 2023 02:37:07 +0000 (UTC) X-FDA: 81513058494.10.8893825 Received: from ams.source.kernel.org (ams.source.kernel.org [145.40.68.75]) by imf29.hostedemail.com (Postfix) with ESMTP id C4D7F12000A for ; Thu, 30 Nov 2023 02:37:05 +0000 (UTC) Authentication-Results: imf29.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ab3KL1CA; spf=pass (imf29.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1701311825; h=from:from:sender:reply-to:subject:subject:date:date: message-id:message-id:to:to:cc:cc:mime-version:mime-version: content-type:content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references:dkim-signature; bh=podQ7MdCYMOQEFat7IduJyxXomRDnVDa8W1EdQ9KzZg=; b=2hqN2qdAzoOnMpVCAVLjR2AN8wL9AarLa8+hOdfMWdFRmcqYxxZ0d+5fx07oAzOLVDpwp/ h6KtHLu7mS77qhE8hr35fqqn8Bs08h7ZO5TZfCX7Gt91Rlh8u5qnxHUeMeZ6kQVw2MPypJ Cl5wElZWNhMzggB79P5bA/8uqrYPJHI= ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1701311825; a=rsa-sha256; cv=none; b=53Hq7WrSe+O1e50GWas6n4JUc1x0t8IgD6cQZqzpEFcoVebN0HruphamCkNsZ+UReT16Pj hN5Q1XeBFHnmq1eQJ7qKmlMOPI7kWGRkQBz0jp5te8XqAM5DMzEO8bppVCUlAByd/1kv4f kL5oJMFcEG4DNo2Ur3jPaD96kP3LjcE= ARC-Authentication-Results: i=1; imf29.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=ab3KL1CA; spf=pass (imf29.hostedemail.com: domain of sj@kernel.org designates 145.40.68.75 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=none) header.from=kernel.org Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by ams.source.kernel.org (Postfix) with ESMTP id 63986B8414B; Thu, 30 Nov 2023 02:37:04 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 95400C433CB; Thu, 30 Nov 2023 02:37:03 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1701311824; bh=aVQYYR7Wa2j5FcEbEqZY4GpoX0ij3ZW/t2YkLOpkPDs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=ab3KL1CA/Q1LdHqbROyoGrBYbAzm+vS90RXg2E8BXqXKEg5WEjZojHnxDn9nYqvD3 F1f4Im4M6vU9+o7l3V1SvkvjkldXXrKbk03T1no8M0JuRDCfSx/Iy8YOPKdDINT6FS ISWn3NNg2kx3/5L0ud8yO5DiDbbsFVb4sZYKvK+PPVjRqXcqDYrl9PDurGehZAeban sPc/85by17P4PosFwLVgg3428nwiR3rQRMv29Ggy/BIrzH3ZwJinZk99qOHsE3XUAg eXbFr3YYNbMNjrS+iX50I9+vg6aZId9yd3e0qppFUtYx8tISAFwq9gnrCu7zl70r82 fbwlXVVYwoYjg== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , Jonathan Corbet , damon@lists.linux.dev, linux-mm@kvack.org, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org Subject: [PATCH 7/9] Docs/mm/damon/design: document DAMOS quota auto tuning Date: Thu, 30 Nov 2023 02:36:50 +0000 Message-Id: <20231130023652.50284-8-sj@kernel.org> X-Mailer: git-send-email 2.34.1 In-Reply-To: <20231130023652.50284-1-sj@kernel.org> References: <20231130023652.50284-1-sj@kernel.org> MIME-Version: 1.0 X-Rspamd-Queue-Id: C4D7F12000A X-Rspam-User: X-Rspamd-Server: rspam11 X-Stat-Signature: bo5caiakqtbcszpa5q5deg4j5osx5e71 X-HE-Tag: 1701311825-274686 X-HE-Meta: U2FsdGVkX18JSqUrbRAO/BTGkPgjZureOKPT+wMv5N9cuhfqmmOgWy4w0ayATuV21/3HZFVXB2dK3wv1YhYjF54zEMEx97J8Yteo4/OHeJ7eWXE8gPzTLoISF/74cXKfkPLgFajbVTrI/M8iocR4qpt8Y1nOugXrwZYU+F8AM7BPc55sg/HOnTSyPZlbTShhlpZqsGCofuYn+B19Pzvg7+YB+/4PoFF1cPuL6blsGdhWFaa+jSYXX6QFabbbOxDUJuxpe5daJenW5bgPv7NJFuvGqprbkU0Wp/4EFiDj2SlHA4IjHRRfAtxf5+kv7cWBATFqj77b30fSwTheoF9up0ZF2ySEHmbSnDiwt7/sW/1mVsougpNZp76o/j/xKki+ZHLZ/75fPybf6g6HJWHzU1++9Dbyc/iUtzbGVrPUJbcsH3moNb8V+sm4KbNly01RJf+xzYtW7TcQtylqSjgq66DhSkKvuX3OGnsl6AM4X96ia1iMpIp/8+9Cz8tupSkLWrbQP+N+io/37G/Qj5N754xvodMO0TvTnDO6rgDpuYwnfqklZTaPHKOaFIpL9Kd4rNhR2Ulqd+/LbSKxL/GMpN0zb74OKLHC2k91RwYNlbvFRonw78dT4SdAVpiHAgHqZXYquFeSFSAohsOgW/B0D2l4vDRAGVTKtC3IK+vXsYmDGc0ONLXxXqKrZVBod8tSfJ9phV9g8qbYKsCMJkedcrV4TmtXiBS3rqHEgDVeoNb0xec812lHjlCHf70RCGYlmHZ7LztU8Y1XY/WTc9xuu4oGe40RTPLfYMBVqVn79CZ8dSHpRCCMhFdrxbaHJwknLRDnDxct50NeVghW3VQKlVF9TlnCMdbkQSJ1eAvnmBkEPxzH3QNT5FqhS401RFG0M1wZJ1gJLKYLQcsWWhTNc0oQRiF/Zlie8oDEcuaEIQchQrpNFI8TD+lfUEmU8IE4kcpe/Azig7xbyksJduG rJwTQIeb UnhyXow6GoR2oJh8aRiK4TqMCbeHjDOCIUQru9hniiGT3lP+uvCfbF42LWvXc8p75d5q6s8GMS4UGjgG1KZUGNrNrfL8h2nBBs3Ac0zQoEfKCyR4hLEQ8zUCWCx7vSWJXstUJge4SpvPbq7nZasL54muylpTZJqyhZ6qZJvVlI7g7fgmAz3uIwHPrniYzh1VSgPIqDxNWZcSxaRcONSdAVkKSdaZMXUQWVTNDtfPHm2bzpvU= X-Bogosity: Ham, tests=bogofilter, spamicity=0.000224, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: Document the DAMOS quota auto tuning feature on the design document. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 1f7e0586b5fa..947c9df6cd33 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -346,6 +346,17 @@ the weight will be respected are up to the underlying prioritization mechanism implementation. +Aim-oriented Feedback-driven Auto-tuning +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +Automatic feedback-driven quota tuning. Instead of setting the absolute quota +value, users can repeatedly provide numbers representing how much of their goal +for the scheme is achieved as feedback. DAMOS then automatically tunes the +aggressiveness (the quota) of the corresponding scheme. For example, if DAMOS +is under achieving the goal, DAMOS automatically increases the quota. If DAMOS +is over achieving the goal, it decreases the quota. + + .. _damon_design_damos_watermarks: Watermarks