[RFC PATCH 2/2] Docs/ABI/damon: mark schemes//filters/ deprecated

SeongJae Park
2026-04-21T04:49:46Z

Now the 'filters/' directory is deprecated. Update ABI document to also
announce the fact. Also update the descriptions of the files to be
based on 'core_filter/' directory, to make the old descriptions ready to
be removed when the time arrives.

Signed-off-by: SeongJae Park <sj@kernel.org>
---
.../ABI/testing/sysfs-kernel-mm-damon | 62 ++++++++++---------
1 file changed, 34 insertions(+), 28 deletions(-)

diff --git a/Documentation/ABI/testing/sysfs-kernel-mm-damon b/Documentation/ABI/testing/sysfs-kernel-mm-damon
index 971c22e34e722..ee29d4e204ffa 100644
--- a/Documentation/ABI/testing/sysfs-kernel-mm-damon
+++ b/Documentation/ABI/testing/sysfs-kernel-mm-damon
@@ -396,15 +396,20 @@ Contact: SeongJae Park <sj@kernel.org>
Description: Writing to and reading from this file sets and gets the low
watermark of the scheme in permil.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/nr_filters
-Date: Dec 2022
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters
+Date: Feb 2025
+Contact: SeongJae Park <sj@kernel.org>
+Description: Directory for DAMON core layer-handled DAMOS filters.
+
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/nr_filters
+Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: Writing a number 'N' to this file creates the number of
directories for setting filters of the scheme named '0' to
- 'N-1' under the filters/ directory.
+ 'N-1' under the core_filters/ directory.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/type
-Date: Dec 2022
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/type
+Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: Writing to and reading from this file sets and gets the type of
the memory of the interest. 'anon' for anonymous pages,
@@ -412,77 +417,78 @@ Description: Writing to and reading from this file sets and gets the type of
'addr' for address range (an open-ended interval), or 'target'
for DAMON monitoring target can be written and read.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/memcg_path
-Date: Dec 2022
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/memcg_path
+Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: If 'memcg' is written to the 'type' file, writing to and
reading from this file sets and gets the path to the memory
cgroup of the interest.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/addr_start
-Date: Jul 2023
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/addr_start
+Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: If 'addr' is written to the 'type' file, writing to or reading
from this file sets or gets the start address of the address
range for the filter.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/addr_end
-Date: Jul 2023
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/addr_end
+Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: If 'addr' is written to the 'type' file, writing to or reading
from this file sets or gets the end address of the address
range for the filter.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/min
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/min
Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: If 'hugepage_size' is written to the 'type' file, writing to
or reading from this file sets or gets the minimum size of the
hugepage for the filter.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/max
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/max
Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: If 'hugepage_size' is written to the 'type' file, writing to
or reading from this file sets or gets the maximum size of the
hugepage for the filter.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/target_idx
-Date: Dec 2022
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/target_idx
+Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: If 'target' is written to the 'type' file, writing to or
reading from this file sets or gets the index of the DAMON
monitoring target of the interest.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/matching
-Date: Dec 2022
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/matching
+Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: Writing 'Y' or 'N' to this file sets whether the filter is for
the memory of the 'type', or all except the 'type'.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters/<F>/allow
-Date: Jan 2025
+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters/<F>/allow
+Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: Writing 'Y' or 'N' to this file sets whether to allow or reject
applying the scheme's action to the memory that satisfies the
'type' and the 'matching' of the directory.

-What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters
-Date: Feb 2025
-Contact: SeongJae Park <sj@kernel.org>
-Description: Directory for DAMON core layer-handled DAMOS filters. Files
- under this directory works same to those of
- /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters
- directory.
-
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//ops_filters
Date: Feb 2025
Contact: SeongJae Park <sj@kernel.org>
Description: Directory for DAMON operations set layer-handled DAMOS filters.
Files under this directory works same to those of
- /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters
+ /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//core_filters
directory.

+What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//filters
+Date: Dec 2022
+Contact: SeongJae Park <sj@kernel.org>
+Description: Directory for DAMOS filters. Files under this directory works
+ same to those of
+ /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//{core,ops}_filters
+ directory. This is deprecated. Use the core_filters and
+ ops_filters instead.
+
What: /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes//dests/nr_dests
Date: Jul 2025
Contact: SeongJae Park <sj@kernel.org>
--
2.47.3