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: 171699 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a59:bcd1:0:b0:403:3b70:6f57 with SMTP id r17csp113851vqy; Wed, 29 Nov 2023 18:38:31 -0800 (PST) X-Google-Smtp-Source: AGHT+IHPQi5Sgs1PGtEWXQKeGk2q4tgzwjMw45OEbgDjZdNp2jVl8iUCWPI5bDqipe6AoZBmlTK7 X-Received: by 2002:a05:6358:7e84:b0:16b:fa51:4862 with SMTP id o4-20020a0563587e8400b0016bfa514862mr19303387rwn.29.1701311911711; Wed, 29 Nov 2023 18:38:31 -0800 (PST) ARC-Seal: i=1; a=rsa-sha256; t=1701311911; cv=none; d=google.com; s=arc-20160816; b=TIufNBRDS3UFr/ObVWiZXS4cJ0C+0iT5guHrG6RGnYwNl9ozI8njLO9VTkEcajiyOe GVyWsL8g6YjzeZd2Joqxr9Tk0T4vLjJUQtjHalHlmTuORCXDeyy4MNjJaygC3p/xdMzc U1K4Me/oCfOlhpOMhS5i3H5cLHVlFc9E2Y1nfFSp8Dyft0u5vdyQLliosk5huR3RVRJJ hpMxZGrqmArh+XTeCr2vMURu18P+JmbanEmDKg8CTuH07ENVXlilFyrg8Esl3pBQAtgL ihTjShSQf8UuO6VELGcnHapg88PoGybYN2ys7QfaDQDwkDYBhXYbh0sP6G1N5ckkJy4c 5/HQ== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=list-id:precedence:content-transfer-encoding:mime-version :references:in-reply-to:message-id:date:subject:cc:to:from :dkim-signature; bh=podQ7MdCYMOQEFat7IduJyxXomRDnVDa8W1EdQ9KzZg=; fh=jKijsxc1Z2CHKVFf4S4lB42jMLcn6gTpewOn4Tq1/VM=; b=kTCAcsjYaVuCdTUuLMf/cJx321YruFAKoZmt2fS1u4B712YWPummMpGNpH06oWC9XC JmghYbztk1V7HJNGQ3TVlZOATsNz5SDAdVUgXSRQLSqcf5bAAzpy4at64JL0tqSih4vg NSgiULlZOQSLWYGpDBEYbfMMfYHdNlGpJC1aJE5xIqqHTy+uDkp6PVPz0sDM0cn3J4MW 0lw1I555BSVWKiTzWC4fnn29v+ZQrY2KNgbMmDrb1NRWzTDiBAYkqif0xshxV1uE+rGg Mf5kQy5/8/btCyl25E0vVUpUqjEDOkuG8ZLQe4h3v1Fi4xHY6buoEfFLTN1g7iFeJZwP 8Eeg== ARC-Authentication-Results: i=1; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=ab3KL1CA; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from snail.vger.email (snail.vger.email. [2620:137:e000::3:7]) by mx.google.com with ESMTPS id r17-20020a632b11000000b005b96c4292basi274428pgr.29.2023.11.29.18.38.30 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Wed, 29 Nov 2023 18:38:31 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) client-ip=2620:137:e000::3:7; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=ab3KL1CA; spf=pass (google.com: domain of linux-kernel-owner@vger.kernel.org designates 2620:137:e000::3:7 as permitted sender) smtp.mailfrom=linux-kernel-owner@vger.kernel.org; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from out1.vger.email (depot.vger.email [IPv6:2620:137:e000::3:0]) by snail.vger.email (Postfix) with ESMTP id 3C1B8806E4FF; Wed, 29 Nov 2023 18:38:30 -0800 (PST) X-Virus-Status: Clean X-Virus-Scanned: clamav-milter 0.103.11 at snail.vger.email Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1344207AbjK3CiO (ORCPT + 99 others); Wed, 29 Nov 2023 21:38:14 -0500 Received: from lindbergh.monkeyblade.net ([23.128.96.19]:35928 "EHLO lindbergh.monkeyblade.net" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S234938AbjK3CiB (ORCPT ); Wed, 29 Nov 2023 21:38:01 -0500 Received: from smtp.kernel.org (relay.kernel.org [52.25.139.140]) by lindbergh.monkeyblade.net (Postfix) with ESMTPS id 526DC171F for ; Wed, 29 Nov 2023 18:37:37 -0800 (PST) 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-Spam-Status: No, score=-2.1 required=5.0 tests=BAYES_00,DKIMWL_WL_HIGH, DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF, RCVD_IN_DNSWL_BLOCKED,SPF_HELO_NONE,SPF_PASS,T_SCC_BODY_TEXT_LINE autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on lindbergh.monkeyblade.net Precedence: bulk List-ID: X-Mailing-List: linux-kernel@vger.kernel.org X-Greylist: Sender passed SPF test, not delayed by milter-greylist-4.6.4 (snail.vger.email [0.0.0.0]); Wed, 29 Nov 2023 18:38:30 -0800 (PST) X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1783954838880195221 X-GMAIL-MSGID: 1783954838880195221 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