Docs/ABI/damon: document intervals auto-tuning ABI

Document the DAMON user-space ABI for DAMON sampling and aggregation
intervals auto-tuning.

Link: https://lkml.kernel.org/r/20250303221726.484227-8-sj@kernel.org
Signed-off-by: SeongJae Park <sj@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Signed-off-by: Andrew Morton <akpm@linux-foundation.org>

diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon
index ccd13ca668c8fe2ba7a5fdc1eb8af2e3ab1087f5..76da77d7f7b6c920c19ed440b5b1c2f14a2b1e76 100644 (file)
--- a/Documentation/ABI/testing/sysfs-kernel-mm-damon
+++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon
@@ -91,6 +91,36 @@ Description: Writing a value to this file sets the update interval of the
                DAMON context in microseconds as the value.  Reading this file
                returns the value.
 
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/access_bp
+Date:          Feb 2025
+Contact:       SeongJae Park <sj@kernel.org>
+Description:   Writing a value to this file sets the monitoring intervals
+               auto-tuning target DAMON-observed access events ratio within
+               the given time interval (aggrs in same directory), in bp
+               (1/10,000).  Reading this file returns the value.
+
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/aggrs
+Date:          Feb 2025
+Contact:       SeongJae Park <sj@kernel.org>
+Description:   Writing a value to this file sets the time interval to achieve
+               the monitoring intervals auto-tuning target DAMON-observed
+               access events ratio (access_bp in same directory) within.
+               Reading this file returns the value.
+
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/min_sample_us
+Date:          Feb 2025
+Contact:       SeongJae Park <sj@kernel.org>
+Description:   Writing a value to this file sets the minimum value of
+               auto-tuned sampling interval in microseconds.  Reading this
+               file returns the value.
+
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intrvals_goal/max_sample_us
+Date:          Feb 2025
+Contact:       SeongJae Park <sj@kernel.org>
+Description:   Writing a value to this file sets the maximum value of
+               auto-tuned sampling interval in microseconds.  Reading this
+               file returns the value.
+
 What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/min
 
 WDate:         Mar 2022