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 9926CC369D1 for ; Sun, 20 Apr 2025 19:40:51 +0000 (UTC) Received: by kanga.kvack.org (Postfix) id C94486B0022; Sun, 20 Apr 2025 15:40:43 -0400 (EDT) Received: by kanga.kvack.org (Postfix, from userid 40) id C42496B0023; Sun, 20 Apr 2025 15:40:43 -0400 (EDT) X-Delivered-To: int-list-linux-mm@kvack.org Received: by kanga.kvack.org (Postfix, from userid 63042) id B0E6A6B0024; Sun, 20 Apr 2025 15:40:43 -0400 (EDT) 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 9596F6B0022 for ; Sun, 20 Apr 2025 15:40:43 -0400 (EDT) Received: from smtpin15.hostedemail.com (a10.router.float.18 [10.200.18.1]) by unirelay02.hostedemail.com (Postfix) with ESMTP id A910612076E for ; Sun, 20 Apr 2025 19:40:43 +0000 (UTC) X-FDA: 83355439566.15.3CCF56E Received: from sea.source.kernel.org (sea.source.kernel.org [172.234.252.31]) by imf05.hostedemail.com (Postfix) with ESMTP id 02067100003 for ; Sun, 20 Apr 2025 19:40:41 +0000 (UTC) Authentication-Results: imf05.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=m+66FnMg; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf05.hostedemail.com: domain of sj@kernel.org designates 172.234.252.31 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Seal: i=1; s=arc-20220608; d=hostedemail.com; t=1745178042; a=rsa-sha256; cv=none; b=W/Gnp+umTNiK1diDRPDAUvLwi2fX9f2qkU8LubvoFO9NYsITlte0DaqSjDLhhXPRESUvVM tLu/2Usn72n76OwxAJVBqWSHyTIgtkpyeJx/ejTbPIrghBtJj/KTMazEPK9IQF6ABYKD4Y 3Wbd0p3XLlEg2iIaOzfTcCbuCghQd8o= ARC-Authentication-Results: i=1; imf05.hostedemail.com; dkim=pass header.d=kernel.org header.s=k20201202 header.b=m+66FnMg; dmarc=pass (policy=quarantine) header.from=kernel.org; spf=pass (imf05.hostedemail.com: domain of sj@kernel.org designates 172.234.252.31 as permitted sender) smtp.mailfrom=sj@kernel.org ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=hostedemail.com; s=arc-20220608; t=1745178042; 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=lVD5i/qZuM6vficX1ICsBaglwBClwlij8OaNHdlvHv0=; b=drHJqHA9Stl+OD43RHDlRfL/KjMGXMDTgPLlR4JtiVkz30m57aFGCMb0DmlvR4wJ4V9ve8 2MDl/BHpcin9fopuDi6qs7eNXL437K3GbTVUhOfjnLWUddZRHbgVbstoh9pKD4ZjcgI04R waTPv6kH8SHsSBV+bXj4imH9vtIN0m0= Received: from smtp.kernel.org (transwarp.subspace.kernel.org [100.75.92.58]) by sea.source.kernel.org (Postfix) with ESMTP id B6E1A4A6EF; Sun, 20 Apr 2025 19:40:39 +0000 (UTC) Received: by smtp.kernel.org (Postfix) with ESMTPSA id CC032C4CEE9; Sun, 20 Apr 2025 19:40:40 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=kernel.org; s=k20201202; t=1745178041; bh=O2QyPpvrJel3yg5xTV6SbG3aWvJ/8ntEB2kQvqlcRMA=; h=From:To:Cc:Subject:Date:In-Reply-To:References:From; b=m+66FnMgcD+CJtwBxR5WWy1A5UzEWfX0UVpz9MTQlFUQtBjjb0kE0LMjLqhXjDAwY xCk831yNZdJ44WsB3Tor6plm2LGP2tQc4X4QOX4DLNGsm7zpMOxT7aw7YC41MD8Kk+ aoe4pE7NV+bfUUBsNb/mY8jt9KGUR9Am923cYTBe4ksldXmntuCPlNu3xJSOo2teZB FpI0W5IG1dkcILs0AdPkuoYHs4xfecxIekA5k16TbejzF8K2G0puvqrp6+/AEDQ65P OtoEF8hXDk1qbsP0hSf9L2V/AgEPLNRmvbOM0h0qxhjoZY84WfJrhPtA3CDnrR5wAV tcMuU96DYhH2w== From: SeongJae Park To: Andrew Morton Cc: SeongJae Park , 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: [PATCH 4/7] Docs/mm/damon/design: document node_mem_{used,free}_bp Date: Sun, 20 Apr 2025 12:40:27 -0700 Message-Id: <20250420194030.75838-5-sj@kernel.org> X-Mailer: git-send-email 2.39.5 In-Reply-To: <20250420194030.75838-1-sj@kernel.org> References: <20250420194030.75838-1-sj@kernel.org> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Rspamd-Queue-Id: 02067100003 X-Rspam-User: X-Rspamd-Server: rspam07 X-Stat-Signature: cjunxkkunbq3u4m5jtcabidmh7dmcs47 X-HE-Tag: 1745178041-676583 X-HE-Meta: U2FsdGVkX19ohUtX2nJHVBuGthKwuG0asM0wiND9op8moWLtD2ejzQGYNyHMke6VuGs2VySyC83uY+cEAuWKm09LZWbBOMWnOLMSp5Bj5JCPZXD8eC0/MyGE6vWr5lFNZZ4kFdFNBelB8bfi2uLptvAsal7UfznTv5GLSzvo290ZlCcbplaqy8ivAHlmG1/8SWy7OTIFsMz/S6Bl3geaM5nFyP+O4TZNGZ+sEt4CJzaQRTJddx9oPw/rr6gLUbi8lItcDxzc+pnDx6qz6WXDudnAEkDRQ1BUR0ClfCU6Fu+mJgn2JSDJbrefoFxZrVCbBoVL+6UX/9tR+pCFAHqi1L3s3OEbCYLe4+6SHnmH1TnL7gzLy/FAammgynukFW/SfuY5m9gjuF3ma7NrPH+5E46mYu1K91lBxlK3z/0LVmEo1dwhAG4t8xaHchvPEPZvA1YXrUcLQbxIoKRCNVM+LpZbYm38hIXrFWW/9k7kmtXwSr/jvEWbBPrCVF3PYQTi8wNvdOyUWC5xV+tH9owaUg8L6lPBQHeR7cQciAxW01mf7oeJfdc+eFwLAKufdwn8FfB17pPQUfMKPyvpflhJWU5f5+C8VvRsCAQrI9V4nUMyibfJYFIcX6YAq+WlAcccoFKSKvzQrwB/8vhRh83pi5yDbtBeBQgulS27MZHa1kiB0I3kF01VBO88G9dLHfaX/KDx9a2Rb7pksPImEGJcl5fwYI8vjFn8xCP36R9kLbz7PSdXEhJg05qLuxxfH0XgOs9a0b6YAR//G1m+xwJNZ+ANxWer1vSQS5KwlyZqbu/uTM0Vfh2tYbubgZasAInk3v9K84T6MrPMcSEruOvruqc2VmKTxVN0az8GXDgGWAXYJF7NVt5Dp8yE3CvtQE7xxSOuHRtjsv53JEattPsNlHDe22iMzzfVjVisTw5NFK4/rlDy6LtFfmNITKMMm5E2stX2gA8aeO7foEp5zqz ck/KVL8d DpVkuq1LPNUBw++Quu0XBQ7zqVyj7F4EnXww7PPeyMbHaroLQJUYCE60rThm8LNxdKUWUs6/0FeYsjaqL2Ytb3I7d2p/OzWTHwmvaBgKZRjrS3hco3Rq0oDNOqvoYhUgV3Bt3VFBA/CCi7rz6PPNHaDO5q1W7U8tN7Gd7xQUvn/0fK00j4+eVk8biBn7C+a/M89xLCPHtn5XkddjX/7GYaGFSjNoR2Sg2rGY9z/XlSxErVQbd/XMWqhFVFw77Q30wc1kVed10g4wn8pOAFVFS4yoo+A== 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: Add description of DAMOS quota goal metrics for NUMA node utilization on the DAMON deesign document. Signed-off-by: SeongJae Park --- Documentation/mm/damon/design.rst | 13 +++++++++---- 1 file changed, 9 insertions(+), 4 deletions(-) diff --git a/Documentation/mm/damon/design.rst b/Documentation/mm/damon/design.rst index f12d33749329..728bf5754343 100644 --- a/Documentation/mm/damon/design.rst +++ b/Documentation/mm/damon/design.rst @@ -550,10 +550,10 @@ 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 three parameters, namely ``target_metric``, -``target_value``, and ``current_value``. The auto-tuning mechanism tries to -make ``current_value`` of ``target_metric`` be same to ``target_value``. -Currently, two ``target_metric`` are provided. +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 +``target_value``. - ``user_input``: User-provided value. Users could use any metric that they has interest in for the value. Use space main workload's latency or @@ -565,6 +565,11 @@ Currently, two ``target_metric`` are provided. in microseconds that measured from last quota reset to next quota reset. DAMOS does the measurement on its own, so only ``target_value`` need to be 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). + +``nid`` is optionally required for only ``node_mem_used_bp`` and +``node_mem_free_bp`` to point the specific NUMA node. 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