From mboxrd@z Thu Jan 1 00:00:00 1970 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 BCA77C7115B for ; Thu, 19 Jun 2025 22:01:12 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id 504716B0099; Thu, 19 Jun 2025 18:00:38 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id 4E1F56B009C; Thu, 19 Jun 2025 18:00:38 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id 3CA366B009A; Thu, 19 Jun 2025 18:00:38 -0400 (EDT) X-Delivered-To: linux-mm@kvack.org Received: from relay.hostedemail.com (smtprelay0017.hostedemail.com [216.40.44.17]) by kanga.kvack.org (Postfix) with ESMTP id 162466B009C for ; Thu, 19 Jun 2025 18:00:38 -0400 (EDT) Received: from smtpin03.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id D0FBA120D49 for ; Thu, 19 Jun 2025 22:00:37 +0000 (UTC) X-FDA: 83573520114.03.BC0F285 Received: from tor.source.kernel.org (tor.source.kernel.org [172.105.4.254]) by imf22.hostedemail.com (Postfix) with ESMTP id 390EAC0004 for ; Thu, 19 Jun 2025 22:00:35 +0000 (UTC) Authentication-Results: imf22.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=cakvDxr1; spf=pass (imf22.hostedemail.com: domain of sj@kernel.org designates 172.105.4.254 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1750370436; a=rsa-sha256; cv=none; b=qRiqv/eR+8+WG3S9pOrHsd3yx6ldvb5RbvbuYVgOrDzcRRdYd+8CxhtsfowBdybBFGMMex Q0Td64ftgYtjuQnTXhJjGkv8ra+JuCUofskBecj4DT3nI4j6yMiUrmXRL4j3HhVPZo8lwn /AfXWhlRY2JQ6/x/nya/iFGF31Mqm4s= ARC-Authentication-Results: i=1; imf22.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=cakvDxr1; spf=pass (imf22.hostedemail.com: domain of sj@kernel.org designates 172.105.4.254 as permitted sender) smtp.mailfrom=sj@kernel.org; dmarc=pass (policy=quarantine) header.from=kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1750370436; 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=xHoH6sHqo24BacHEoDq0K0RaNyYMvSvKo7S2xMZo/oc=; b=NthKXYV/zt1FlpoqXM+VUxtKv8UK8otdn65y9+/SG19p7hOYlKSEBHXXCm7vhLEnxfDB08 1qtMsT/3McJe/FGtFkN8RO4DqAiiibxUT2tbhTl8x4ldIswXj4LUseGGcdJv40A6l2A+RL 2sPi6UKqT8sLbHQlWBbMjCeMMOti6LA= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by tor.source.kernel.org (Postfix) with ESMTP id A302060051; Thu, 19 Jun 2025 22:00:35 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id 4A362C4CEF1; Thu, 19 Jun 2025 22:00:35 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1750370435; bh=mKWAyXf0fhqfpjFolQB3dWnDHH2ABS2xQxltFWbhL9Y=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=cakvDxr1OyYgAtKoMJIZscdHNiK6lfpkPs8Cg2Z+zf54e+TuOPWXYQW4b/s8kmFJ6 CY5lhuiXnvghjEbIDaDHBSHTSnmj5q6I2nutSdl2LrOrfklBMDf+z0HeusEQE9g+Bj P9QWTUz7K+WbpDIkbfNkxAIaXJbsL47EroH1MdUvqpd4+j6wAbp/+0NTnw5egaaYn9 Fy1NsdPrt2RumgOeNINGGO8ywv22HTyQ1/J+iZ0TvksQDCou1LAhToJ5gP3VFWG+oj th2BSMgshRLEkZateM7dsNZcrN5fgQ6IzbxUI1Z9tQ5eon287c+ATPLdnfEoH7acuX Kd0nk8cATvkCw== From: SeongJae Park To: Cc: SeongJae Park , Andrew Morton , Jonathan Corbet , damon@lists.linux.dev, kernel-team@meta.com, linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, linux-mm@kvack.org Subject: [RFC PATCH 06/11] Docs/mm/damon/design: document DAMOS_QUOTA_NODE_MEMCG_USED_BP Date: Thu, 19 Jun 2025 15:00:18 -0700 Message-Id: <20250619220023.24023-7-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250619220023.24023-1-sj@kernel.org> References: <20250619220023.24023-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Server: rspam05 X-Rspamd-Queue-Id: 390EAC0004 X-Stat-Signature: n7u5x1cuib9chmhhhzxgmrxt46de3hoa X-Rspam-User: X-HE-Tag: 1750370435-167762 X-HE-Meta: U2FsdGVkX18qebbi54uZKbEBwEgiB0ckaZz60uu4ZqTH68+rM/uHmS1xO/WsCAx32xd8/1Iy4uXSmJlR/i9yI3THJUQ+5C26MkXxNiG1fcdg+KUmrcG58mllj7d6F4pwkYVbWDUCmwWRlGdpSVhR55wdcKzwHHnesVAdG/8bUmyoPoIbTceKwXpL6clqlLeBqVsWV1oMjoRzLSx294Zy9Sb5r5QMHqsmdsIL0aHFXc8YkcJMSU96EMbnNqGd1qgDsTZkqwStgl4FhdCDMLWHez8cudt3I2WXf7a3O02r0w+WI84KLpiNrQtVLVjpJhNclrQQTX6O+BAaHW4O0PXMH4gshp4hLWH/B3y+i6LXvYw9gUd61Hz5129FcUUBtkG6T5in91PAC1wmnVmCOMJ1uB8JbIhGW1RxRuMGU0URRywZNX2T6zTbA9Zk2S3cRMAkXSoFLEnE4WoBt10AWQTaYKN6G5J7HJJwhaKIu1cOl4amp8s1lYEPuG22CTIP7oEs886SbFkTo92sAt5dhuy6UBQXfYmMOj8cuk/WYy4JpSIxE2dsNd3fqaX2H+h5xpUSJc5dMXg9eHYdxTzqerdJdPWp4IjzRufkU4tvpMFFRaO3blgRMjehk/ogYBWU59/b/tAL37q6fwK7P70X8+/3AEpYDxbNUg70PsBvo3hPOsH3A4Z0kU4pOpd6VPTMyykDbfjgxWHxm+5+iKd/UftihUVmgg7CDmiBhInV6If1VZxOCnSYEJpIfEraKSsfevbF0XVM3YrKdxrfS/kEYhZQUbbjLMvBGJH4Bt43+Sou5d/Wb7JC0Fme306RHPgqbXiKrLPYwNj5LMGbGTCAbhunZeShxmGWDgMjSwhJvvYVpwy8MmdBi/XnnV1zYUbaySctfmyx8oBNzRCtlMk9zStVc+ZrGqC86AxrdVhDq+ljeRt4w668WCqkJnkymwPGH96caNmETGFDLe954vRuwvA w9hUbON1 WmuB47nmFxZdK6i9TzDIE0tTpKq0kiorxmhn2K59O4MLm+oUhxzn+zDBbQVC2GOGFdry531X/pxSdtdr+tlfhBQDD46Az3lSFJ1ABCn5ISRWeJMzMUhT4v2P38zUV3MZ0ygGP/NAaRSmlQlUlC074rf+opc8IKpnzeepdfMboma6oi1Smzp4RP+KZjMdC38xdnjhgttMUN4HP5ie9ch1LaNLiL3lixR9dT4MuSHjKOqtgVXt5qHD4z7oUcSAXijXaWEHIRq/ln4cRD//ucqxCMQowEA== X-Bogosity: Ham, tests=bogofilter, spamicity=0.000000, version=1.2.4 Sender: owner-linux-mm@kvack.org Precedence: bulk X-Loop: owner-majordomo@kvack.org List-ID: List-Subscribe: List-Unsubscribe: Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index 2290ebefc648..eb6d3b7d0643 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -553,9 +553,9 @@ 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. -The goal can be specified with four parameters, namely ``target_metric``, -``target_value``, ``current_value`` and ``nid``. The auto-tuning mechanism -tries to make ``current_value`` of ``target_metric`` be same to +The goal can be specified with five parameters, namely ``target_metric``, +``target_value``, ``current_value``, ``nid`` and ``path``. The auto-tuning +mechanism tries to make ``current_value`` of ``target_metric`` be same to ``target_value``. - ``user_input``: User-provided value. Users could use any metric that they @@ -570,9 +570,16 @@ tries to make ``current_value`` of ``target_metric`` be same to set by users at the initial time. In other words, DAMOS does self-feedback. - ``node_mem_used_bp``: Specific NUMA node's used memory ratio in bp (1/10,000). - ``node_mem_free_bp``: Specific NUMA node's free memory ratio in bp (1/10,000). +- ``node_memcg_used_bp``: Specific cgroup's node used memory ratio for a + specific NUMA node, in bp (1/10,000). -``nid`` is optionally required for only ``node_mem_used_bp`` and -``node_mem_free_bp`` to point the specific NUMA node. +``nid`` is optionally required for only ``node_mem_used_bp``, +``node_mem_free_bp`` and ``node_memcg_used_bp`` to point the specific NUMA +node. + +``path`` is optionally required for only ``node_memcg_used_bp`` to point the +path to the cgroup. The value should be the path of the memory cgroup from the +cgroups mount point. To know how user-space can set the tuning goal metric, the target value, and/or the current value via :ref:`DAMON sysfs interface `, refer to -- 2.39.5