From nobody Mon Feb 9 05:38:45 2026 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 67B331D5ADC; Sun, 20 Apr 2025 19:40:41 +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=1745178041; cv=none; b=aBrwRVcIsHY95uxPZ9UR39mH9Vnj4Rta/IKcU/VYg5ShurcgNI19Ojn0QsTO7EGht0dTzt6NTVughc8nM9B1F2rrP8j57TvMCQLpNMQuWxeEWeT4WSX7POpztwxhXkxbElFL/3G88LKZqogBhs7f/kdq5uHlWJP2L2B3seuULFg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1745178041; c=relaxed/simple; bh=O2QyPpvrJel3yg5xTV6SbG3aWvJ/8ntEB2kQvqlcRMA=; h=From:To:Cc:Subject:Date:Message-Id:In-Reply-To:References: MIME-Version; b=Q+tpN41jdswfKxAJYcYM9y9lC4VlEL4tzQWANEbVWG8dPA4qD2zSAhLd7fudsqzLmlcHzDe6bfcwKeOQjRt1TZ1IT8e9tItdwpPTW5Q8+WaB5CnMbYZNql8Hos01O7vQryV0SIUIMeRQfncUBpkqehNy1NxQedWiezAndIU/pB4= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b=m+66FnMg; arc=none smtp.client-ip=10.30.226.201 Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=kernel.org header.i=@kernel.org header.b="m+66FnMg" 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> Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" 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/des= ign.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 schem= e. 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. =20 -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``. =20 - ``user_input``: User-provided value. Users could use any metric that th= ey 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-feedb= ack. +- ``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. =20 To know how user-space can set the tuning goal metric, the target value, a= nd/or the current value via :ref:`DAMON sysfs interface `, refe= r to --=20 2.39.5