* [PATCH v2 1/4] Docs/ABI/damon: fix typo in intervals_goal sysfs path
2026-07-14 14:01 [PATCH v2 0/4] Docs/ABI/damon: sysfs ABI document fixes and additions SJ Park
@ 2026-07-14 14:01 ` SJ Park
2026-07-14 14:01 ` [PATCH v2 2/4] Docs/ABI/damon: fix typos SJ Park
` (2 subsequent siblings)
3 siblings, 0 replies; 5+ messages in thread
From: SJ Park @ 2026-07-14 14:01 UTC (permalink / raw)
To: Andrew Morton
Cc: Song Hu, Liam R. Howlett, David Hildenbrand, Lorenzo Stoakes,
Michal Hocko, Mike Rapoport, SJ Park, Suren Baghdasaryan,
Vlastimil Babka, damon, linux-kernel, linux-mm, stable
From: Song Hu <husong@kylinos.cn>
The ABI document spells the DAMON sysfs directory as "intrvals_goal"
(missing 'e') in four What: entries, but the kernel creates it as
"intervals_goal" (mm/damon/sysfs.c). Following the documented path
therefore yields a non-existent directory.
Fixes: e2b23dc62369 ("Docs/ABI/damon: document intervals auto-tuning ABI")
Cc: stable@vger.kernel.org
Signed-off-by: Song Hu <husong@kylinos.cn>
Reviewed-by: SJ Park <sj@kernel.org>
Signed-off-by: SJ Park <sj@kernel.org>
---
Documentation/ABI/testing/sysfs-kernel-mm-damon | 8 ++++----
1 file changed, 4 insertions(+), 4 deletions(-)
diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon
index 907a504fb64c5..a8269123b4231 100644
--- a/Documentation/ABI/testing/sysfs-kernel-mm-damon
+++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon
@@ -112,7 +112,7 @@ 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
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intervals_goal/access_bp
Date: Feb 2025
Contact: SJ Park <sj@kernel.org>
Description: Writing a value to this file sets the monitoring intervals
@@ -120,7 +120,7 @@ Description: Writing a value to this file sets the monitoring intervals
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
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intervals_goal/aggrs
Date: Feb 2025
Contact: SJ Park <sj@kernel.org>
Description: Writing a value to this file sets the time interval to achieve
@@ -128,14 +128,14 @@ Description: Writing a value to this file sets the time interval to achieve
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
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intervals_goal/min_sample_us
Date: Feb 2025
Contact: SJ 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
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/intervals/intervals_goal/max_sample_us
Date: Feb 2025
Contact: SJ Park <sj@kernel.org>
Description: Writing a value to this file sets the maximum value of
--
2.47.3
^ permalink raw reply related [flat|nested] 5+ messages in thread* [PATCH v2 2/4] Docs/ABI/damon: fix typos
2026-07-14 14:01 [PATCH v2 0/4] Docs/ABI/damon: sysfs ABI document fixes and additions SJ Park
2026-07-14 14:01 ` [PATCH v2 1/4] Docs/ABI/damon: fix typo in intervals_goal sysfs path SJ Park
@ 2026-07-14 14:01 ` SJ Park
2026-07-14 14:01 ` [PATCH v2 3/4] Docs/ABI/damon: document update_tuned_intervals state command SJ Park
2026-07-14 14:01 ` [PATCH v2 4/4] Docs/ABI/damon: document tried_regions probe hits SJ Park
3 siblings, 0 replies; 5+ messages in thread
From: SJ Park @ 2026-07-14 14:01 UTC (permalink / raw)
To: Andrew Morton
Cc: Song Hu, Liam R. Howlett, David Hildenbrand, Lorenzo Stoakes,
Michal Hocko, Mike Rapoport, SJ Park, Suren Baghdasaryan,
Vlastimil Babka, damon, linux-kernel, linux-mm
From: Song Hu <husong@kylinos.cn>
Fix two typos in the DAMON sysfs ABI document:
- "WDate:" -> "Date:" on the nr_regions/min entry
- "manimum" -> "minimum" in the nr_accesses/min description
Signed-off-by: Song Hu <husong@kylinos.cn>
Reviewed-by: SJ Park <sj@kernel.org>
Signed-off-by: SJ Park <sj@kernel.org>
---
Documentation/ABI/testing/sysfs-kernel-mm-damon | 4 ++--
1 file changed, 2 insertions(+), 2 deletions(-)
diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon
index a8269123b4231..f3c99c79b0f57 100644
--- a/Documentation/ABI/testing/sysfs-kernel-mm-damon
+++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon
@@ -144,7 +144,7 @@ Description: Writing a value to this file sets the maximum value of
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/monitoring_attrs/nr_regions/min
-WDate: Mar 2022
+Date: Mar 2022
Contact: SJ Park <sj@kernel.org>
Description: Writing a value to this file sets the minimum number of
monitoring regions of the DAMON context as the value. Reading
@@ -287,7 +287,7 @@ Description: Writing to and reading from this file sets and gets the maximum
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/min
Date: Mar 2022
Contact: SJ Park <sj@kernel.org>
-Description: Writing to and reading from this file sets and gets the manimum
+Description: Writing to and reading from this file sets and gets the minimum
'nr_accesses' of the scheme's target regions.
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/access_pattern/nr_accesses/max
--
2.47.3
^ permalink raw reply related [flat|nested] 5+ messages in thread
* [PATCH v2 3/4] Docs/ABI/damon: document update_tuned_intervals state command
2026-07-14 14:01 [PATCH v2 0/4] Docs/ABI/damon: sysfs ABI document fixes and additions SJ Park
2026-07-14 14:01 ` [PATCH v2 1/4] Docs/ABI/damon: fix typo in intervals_goal sysfs path SJ Park
2026-07-14 14:01 ` [PATCH v2 2/4] Docs/ABI/damon: fix typos SJ Park
@ 2026-07-14 14:01 ` SJ Park
2026-07-14 14:01 ` [PATCH v2 4/4] Docs/ABI/damon: document tried_regions probe hits SJ Park
3 siblings, 0 replies; 5+ messages in thread
From: SJ Park @ 2026-07-14 14:01 UTC (permalink / raw)
To: Andrew Morton
Cc: Song Hu, Liam R. Howlett, David Hildenbrand, Lorenzo Stoakes,
Michal Hocko, Mike Rapoport, SJ Park, Suren Baghdasaryan,
Vlastimil Babka, damon, linux-kernel, linux-mm
From: Song Hu <husong@kylinos.cn>
The 'update_tuned_intervals' command of the 'state' file, added in
commit 1077605396b4 ("mm/damon/sysfs: implement a command to update
auto-tuned monitoring intervals"), is described in usage.rst but
missing from the canonical ABI document. Add it.
Signed-off-by: Song Hu <husong@kylinos.cn>
Reviewed-by: SJ Park <sj@kernel.org>
Signed-off-by: SJ Park <sj@kernel.org>
---
Documentation/ABI/testing/sysfs-kernel-mm-damon | 5 ++++-
1 file changed, 4 insertions(+), 1 deletion(-)
diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon
index f3c99c79b0f57..1507e63ab1711 100644
--- a/Documentation/ABI/testing/sysfs-kernel-mm-damon
+++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon
@@ -36,7 +36,10 @@ Description: Writing 'on' or 'off' to this file makes the kdamond starts or
kdamond. Writing 'clear_schemes_tried_regions' to the file
removes contents of the 'tried_regions' directory. Writing
'update_schemes_effective_quotas' to the file updates
- '.../quotas/effective_bytes' files of this kdamond.
+ '.../quotas/effective_bytes' files of this kdamond. Writing
+ 'update_tuned_intervals' to the file updates 'sample_us' and
+ 'aggr_us' files under 'monitoring_attrs/intervals' with the
+ auto-tuned sampling and aggregation intervals.
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/pid
Date: Mar 2022
--
2.47.3
^ permalink raw reply related [flat|nested] 5+ messages in thread* [PATCH v2 4/4] Docs/ABI/damon: document tried_regions probe hits
2026-07-14 14:01 [PATCH v2 0/4] Docs/ABI/damon: sysfs ABI document fixes and additions SJ Park
` (2 preceding siblings ...)
2026-07-14 14:01 ` [PATCH v2 3/4] Docs/ABI/damon: document update_tuned_intervals state command SJ Park
@ 2026-07-14 14:01 ` SJ Park
3 siblings, 0 replies; 5+ messages in thread
From: SJ Park @ 2026-07-14 14:01 UTC (permalink / raw)
To: Andrew Morton
Cc: Song Hu, Liam R. Howlett, David Hildenbrand, Lorenzo Stoakes,
Michal Hocko, Mike Rapoport, SJ Park, Suren Baghdasaryan,
Vlastimil Babka, damon, linux-kernel, linux-mm
From: Song Hu <husong@kylinos.cn>
The 'tried_regions/<R>/probes/<P>/hits' file, added in commit
5b0de1bc3325 ("mm/damon/sysfs-schemes: implement probe/hits file"),
is described in usage.rst but missing from the canonical ABI document.
Document the 'probes/' directory and the 'probes/<P>/hits' file.
Signed-off-by: Song Hu <husong@kylinos.cn>
Reviewed-by: SJ Park <sj@kernel.org>
Signed-off-by: SJ Park <sj@kernel.org>
---
Documentation/ABI/testing/sysfs-kernel-mm-damon | 12 ++++++++++++
1 file changed, 12 insertions(+)
diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon
index 1507e63ab1711..e675a57145e36 100644
--- a/Documentation/ABI/testing/sysfs-kernel-mm-damon
+++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon
@@ -650,3 +650,15 @@ Contact: SJ Park <sj@kernel.org>
Description: Reading this file returns the size of the memory in the region
that passed DAMON operations layer-handled filters of the
scheme in bytes.
+
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/probes/
+Date: May 2026
+Contact: SJ Park <sj@kernel.org>
+Description: Directory for DAMON data-attribute monitoring probes of the
+ region.
+
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/tried_regions/<R>/probes/<P>/hits
+Date: May 2026
+Contact: SJ Park <sj@kernel.org>
+Description: Reading this file returns the number of data-attribute
+ monitoring probe-hit positive samples of the region.
--
2.47.3
^ permalink raw reply related [flat|nested] 5+ messages in thread