From patchwork Mon Feb 19 19:44:31 2024 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: SeongJae Park X-Patchwork-Id: 203248 Return-Path: Delivered-To: ouuuleilei@gmail.com Received: by 2002:a05:693c:2685:b0:108:e6aa:91d0 with SMTP id mn5csp6927dyc; Mon, 19 Feb 2024 11:49:41 -0800 (PST) X-Forwarded-Encrypted: i=3; AJvYcCVmCoHQVi/zBK0FnjkNSlJNYcEvwdbdwUBVAplVsakVr+nZ8TbCI6EH9UnCS/2FzYkZABhQqQm5H0EsEBCffn8uiIYi3A== X-Google-Smtp-Source: AGHT+IGvmfs4DlFnRD/tN3CNq+kNED5nvL71cwiVBwTEzZuBUP+4gyS+7Eh49/B4VnR+cuLWJ77Z X-Received: by 2002:a05:620a:4483:b0:785:d568:9ce with SMTP id x3-20020a05620a448300b00785d56809cemr16961996qkp.7.1708372181662; Mon, 19 Feb 2024 11:49:41 -0800 (PST) ARC-Seal: i=2; a=rsa-sha256; t=1708372181; cv=pass; d=google.com; s=arc-20160816; b=YOF127sd7AtBzNNA17LW56WE5HqkRZdp3Vmf9r1ZWENGzQZXU5QKwGZP5souTru7CS VI4aRiJvuIIFn+P0hzdgmROzdmAM9ymKG+7wEAYUlVNcFnhABMXomNlUaTnQAXkLzEVf GD9ZL5SCx+yQ096/AZQkPWQ1fht6Al1gchU7ZKR5LwYEjtStQyx8HSsjXYHbDfgc3LCf pkVERVN5AeG0GlpIkXJLHqUg2sCs0bPkKwCDc3jz9B27dVgMit4ufh3MERTJ5zQOFTHn 9C78aGtvmY26bP+gmap/ubly+uEBTeL9Sf1SlDbc0zYAv/2LPPvlH/pLDatB+AnocGSd zKxg== ARC-Message-Signature: i=2; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=content-transfer-encoding:mime-version:list-unsubscribe :list-subscribe:list-id:precedence:references:in-reply-to:message-id :date:subject:cc:to:from:dkim-signature; bh=Y/X+A7MxKLZzEOLxaIOzCd5+qV0ysfi1p0eFECsMYz0=; fh=jKijsxc1Z2CHKVFf4S4lB42jMLcn6gTpewOn4Tq1/VM=; b=AwBM5l0KAesxEvkJKFDtXlCyZ6eX2iNFYE/p3lRbJ3DwEkvB4yy94cH/79QWG3C/FS WD9+8aueYAzUjcjdzutqWg3L+0WXNoOYMRx97LSbqQN40osDg6mB+aZX2ySdM1CY/YOO RLyAWOuSNvgXOErsXX68Ac+WsuagVVmPvtzyWy1lee6aK4vec8UYK8PknqqAMwqVfiIE Zoj6ihDNUEZJC+y1RAOGcREXBdrLi6EdD5plKvZ/4+mGdY+rkcuiwApNuc6AaQbTC3A3 qH/LMqEbRAuZzk/mtNLg/hSL6fTh+XBNBdN8Z6epqYMYT1IKECFUL8RodeOpNXLdvFWI ANDQ==; dara=google.com ARC-Authentication-Results: i=2; mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=KqdSM2r2; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-71902-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-71902-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from ny.mirrors.kernel.org (ny.mirrors.kernel.org. [147.75.199.223]) by mx.google.com with ESMTPS id c25-20020a05620a165900b00785d783fb08si7125222qko.375.2024.02.19.11.49.41 for (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 19 Feb 2024 11:49:41 -0800 (PST) Received-SPF: pass (google.com: domain of linux-kernel+bounces-71902-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) client-ip=147.75.199.223; Authentication-Results: mx.google.com; dkim=pass header.i=@kernel.org header.s=k20201202 header.b=KqdSM2r2; arc=pass (i=1 dkim=pass dkdomain=kernel.org); spf=pass (google.com: domain of linux-kernel+bounces-71902-ouuuleilei=gmail.com@vger.kernel.org designates 147.75.199.223 as permitted sender) smtp.mailfrom="linux-kernel+bounces-71902-ouuuleilei=gmail.com@vger.kernel.org"; dmarc=pass (p=NONE sp=NONE dis=NONE) header.from=kernel.org Received: from smtp.subspace.kernel.org (wormhole.subspace.kernel.org [52.25.139.140]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by ny.mirrors.kernel.org (Postfix) with ESMTPS id 68A3D1C21975 for ; Mon, 19 Feb 2024 19:49:41 +0000 (UTC) Received: from localhost.localdomain (localhost.localdomain [127.0.0.1]) by smtp.subspace.kernel.org (Postfix) with ESMTP id 8ABEE5D486; Mon, 19 Feb 2024 19:44:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="KqdSM2r2" Received: from smtp.kernel.org (aws-us-west-2-korg-mail-1.web.codeaurora.org [10.30.226.201]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id F26015BAE1; Mon, 19 Feb 2024 19:44:50 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=10.30.226.201 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708371891; cv=none; b=UVOjBbWalIEX+LFOUrO/ONFDudk4HA9B5HDFJVCcVyMyuNyqVM5+N4JSSFQPINXH8dnF9p8/cAxv5ZtFH7M3Lk9AWq82APAnQNcOOKlTQO1jT7mmXqag0dkTGtOQPMtsfCP4b4FCpH5YWYDuaBHLwXAfP2ARwiVzn72XBwloOB8= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1708371891; c=relaxed/simple; bh=N9nR7nwUdsukBui32rCfnM5+OryMCusxZ8X3or6m4gs=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=nZixfB0rYYq8AcyKehY0F1SuScN/nMe2x4oLn1gX6KImqKaH4QQqQcOTRF3TAOczurA2uh2DxPkPXBava3JEv+B5g8xWvikndPXIXsCvoBCvrbkb/VEegmMYvsiW5OTzI06WBxRGcw1OM0Mc86y0lqRRArYayXXhRlyP6BBrfow= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=KqdSM2r2; arc=none smtp.client-ip=10.30.226.201 Received: by smtp.kernel.org (Postfix) with ESMTPSA id 5D981C43394; Mon, 19 Feb 2024 19:44:50 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1708371890; bh=N9nR7nwUdsukBui32rCfnM5+OryMCusxZ8X3or6m4gs=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=KqdSM2r2arnrE2pBIUDFF7hZiMjke6At78DYHjdLpERwp7GzGMMfZrZD/XkvVsvoL iZ0gKt+cXZC2/Q6/wDxgAXwR2lScpDLfLDBK0fbWYh8QYEaBEUqQaD8GbSEYU19OnH U++3UpC6Jpa+GOpKK5QyaegBWlVfHsoysde0a5MGIv1cNeG+RjS1KFiSJb8z408nxj LTZLeZw/EPiwFOioMXDWha/73iN4Zoz2vCX2USa/2Djbqs9MMszoIsoedfNOl1FCfS 7RKT1NeXBEKPFeYON6dpCo1wCv301lTmRD+TNX3etwdGvFarVDTz+/bbCnHbR5kJo9 LiI+VOgnX3CPg== 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 20/20] Docs/admin-guide/mm/damon/reclaim: document auto-tuning parameters Date: Mon, 19 Feb 2024 11:44:31 -0800 Message-Id: <20240219194431.159606-21-sj@kernel.org> X-Mailer: git-send-email 2.39.2 In-Reply-To: <20240219194431.159606-1-sj@kernel.org> References: <20240219194431.159606-1-sj@kernel.org> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 X-getmail-retrieved-from-mailbox: INBOX X-GMAIL-THRID: 1791358069097106026 X-GMAIL-MSGID: 1791358069097106026 Update DAMON_RECLAIM usage document for the user/self feedback based auto-tuning of the quota. Signed-off-by: SeongJae Park --- .../admin-guide/mm/damon/reclaim.rst | 27 +++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/Documentation/admin-guide/mm/damon/reclaim.rst b/Documentation/admin-guide/mm/damon/reclaim.rst index 343e25b252f4..af05ae617018 100644 --- a/Documentation/admin-guide/mm/damon/reclaim.rst +++ b/Documentation/admin-guide/mm/damon/reclaim.rst @@ -117,6 +117,33 @@ milliseconds. 1 second by default. +quota_mem_pressure_us +--------------------- + +Desired level of memory pressure-stall time in microseconds. + +While keeping the caps that set by other quotas, DAMON_RECLAIM automatically +increases and decreases the effective level of the quota aiming this level of +memory pressure is incurred. System-wide ``some`` memory PSI in microseconds +per quota reset interval (``quota_reset_interval_ms``) is collected and +compared to this value to see if the aim is satisfied. Value zero means +disabling this auto-tuning feature. + +Disabled by default. + +quota_autotune_feedback +----------------------- + +User-specifiable feedback for auto-tuning of the effective quota. + +While keeping the caps that set by other quotas, DAMON_RECLAIM automatically +increases and decreases the effective level of the quota aiming receiving this +feedback of value ``10,000`` from the user. DAMON_RECLAIM assumes the feedback +value and the quota are positively proportional. Value zero means disabling +this auto-tuning feature. + +Disabled by default. + wmarks_interval ---------------