* [RFC PATCH 0/4] mm/damon/reclaim: enable auto-tuning features by default
@ 2026-11-20 6:07 SJ Park
2026-11-20 6:07 ` [RFC PATCH 4/4] Docs/admin-guide/mm/damon/reclaim: update for changed default parameters SJ Park
0 siblings, 1 reply; 2+ messages in thread
From: SJ Park @ 2026-11-20 6:07 UTC (permalink / raw)
Cc: SJ Park, Andrew Morton, Jonathan Corbet, Randy Dunlap, Shuah Khan,
damon, linux-doc, linux-mm
The initial version of DAMON_RECLAIM was supposed to be used after
manual tuning of its parameters. Among the parameters, the monitoring
intervals (sample_interval and aggr_interval) and the coldness threshold
(min_age) are particularly important to be optimally tuned. The optimum
values for the parameters tend to be highly dependent on the workload
and the system. Hence no small amount of tuning efforts are required to
each DAMON_RECLAIM use case.
To reduce the tuning efforts, we recently introduced two auto-tuning
features. Intervals auto-tuning (autotune_monitoring_intervals)
automatically tunes monitoring intervals to provide practical and
efficient monitoring results. PSI-driven quota auto-tuning
(quota_autotune_feedback) automatically tunes the coldness threshold.
Because the auto-tuning features were introduced after the initial
version, the features are disabled by default. That is to keep the
default behaviors unchanged. However, enabling the auto-tuning features
is only expected to provide more benefit to the users. Disabling those
by default only makes the adoption of the features slow. Also, it is
difficult to imagine real users who use DAMON_RECLAIM with its default
parameter values.
Enable the auto-tuning features by default. For PSI-driven coldness
threshold auto-tuning, set 0.05% memory pressure ratio as the target.
Free memory ratio based reclaim watermarks were introduced as a safe
guard for unoptimized coldness threshold. Because it is now reasonably
auto-tuned, disable the watermark feature by default.
Enable the monitoring intervals auto-tuning and PSI-driven coldness
threshold auto-tuning via patches 1 and 2, respectively. Disable the
free memory ratio based watermarks via patch 3. Finally update the user
document to reflect the changed default values, via patch 4.
SJ Park (4):
mm/damon/reclaim: enable monitoring intervals auto-tune by default
mm/damon/reclaim: set memory PSI 0.05% as default quota goal
mm/damon/reclaim: disable watermarks by default
Docs/admin-guide/mm/damon/reclaim: update for changed default
parameters
Documentation/admin-guide/mm/damon/reclaim.rst | 7 ++++---
mm/damon/reclaim.c | 15 ++++++++-------
2 files changed, 12 insertions(+), 10 deletions(-)
base-commit: 0ec5c1c237bdf91ae93b3efe32767aad9a670f8a
--
2.47.3
^ permalink raw reply [flat|nested] 2+ messages in thread* [RFC PATCH 4/4] Docs/admin-guide/mm/damon/reclaim: update for changed default parameters
2026-11-20 6:07 [RFC PATCH 0/4] mm/damon/reclaim: enable auto-tuning features by default SJ Park
@ 2026-11-20 6:07 ` SJ Park
0 siblings, 0 replies; 2+ messages in thread
From: SJ Park @ 2026-11-20 6:07 UTC (permalink / raw)
Cc: SJ Park, Jonathan Corbet, Randy Dunlap, Shuah Khan, damon,
linux-doc, linux-mm
Update DAMON_RECLAIM user documentation to reflect the changed default
parameter values. Intervals and PSI-driven coldness threshold
auto-tuning features are enabled by default. The free memory ratio
based watermarks feature is disabled by default.
Signed-off-by: SJ Park <sj@kernel.org>
---
Documentation/admin-guide/mm/damon/reclaim.rst | 7 ++++---
1 file changed, 4 insertions(+), 3 deletions(-)
diff --git a/Documentation/admin-guide/mm/damon/reclaim.rst b/Documentation/admin-guide/mm/damon/reclaim.rst
index 0ef784df98680..79d24e3819cea 100644
--- a/Documentation/admin-guide/mm/damon/reclaim.rst
+++ b/Documentation/admin-guide/mm/damon/reclaim.rst
@@ -95,7 +95,7 @@ amount of access events in each DAMON-snapshot, while keeping the sampling
interval 5 milliseconds in minimum, and 10 seconds in maximum. Setting this to
``N`` disables the auto-tuning.
-Disabled by default.
+Enabled by default.
quota_ms
--------
@@ -145,7 +145,7 @@ 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.
+500 microseconds (0.05 percent of default quota reset interval) by default.
quota_autotune_feedback
-----------------------
@@ -196,7 +196,8 @@ granularity reclamation logic.
To keep DAMON_RECLAIM always active regardless of the free memory rate, set
``wmarks_high``, ``wmarks_mid`` and ``wmarks_low`` to ``1000``, ``1000`` and
-``0``, respectively.
+``0``, respectively. Use of watermarks is not recommended and therefore
+disabled by default.
sample_interval
---------------
--
2.47.3
^ permalink raw reply related [flat|nested] 2+ messages in thread
end of thread, other threads:[~2026-11-20 6:07 UTC | newest]
Thread overview: 2+ messages (download: mbox.gz follow: Atom feed
-- links below jump to the message on this page --
2026-11-20 6:07 [RFC PATCH 0/4] mm/damon/reclaim: enable auto-tuning features by default SJ Park
2026-11-20 6:07 ` [RFC PATCH 4/4] Docs/admin-guide/mm/damon/reclaim: update for changed default parameters SJ Park
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox