Docs/ABI/damon: mark schemes/<S>/filters/ deprecated

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.

Link: https://lore.kernel.org/20260429150309.82282-3-sj@kernel.org
Signed-off-by: SeongJae Park <sj@kernel.org>
Cc: David Hildenbrand <david@kernel.org>
Cc: Jonathan Corbet <corbet@lwn.net>
Cc: Liam R. Howlett <liam@infradead.org>
Cc: Lorenzo Stoakes <ljs@kernel.org>
Cc: Michal Hocko <mhocko@suse.com>
Cc: Mike Rapoport <rppt@kernel.org>
Cc: Suren Baghdasaryan <surenb@google.com>
Cc: Vlastimil Babka <vbabka@kernel.org>
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 971c22e34e7226f46d85f673b4d9091eb51130a8..ee29d4e204ffa7ad900cf4a895b03c16cb6dd0e8 100644 (file)
--- 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/<S>/filters/nr_filters
-Date:          Dec 2022
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/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/<S>/filters/<F>/type
-Date:          Dec 2022
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters/<F>/memcg_path
-Date:          Dec 2022
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters/<F>/addr_start
-Date:          Jul 2023
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters/<F>/addr_end
-Date:          Jul 2023
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters/<F>/min
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters/<F>/max
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters/<F>/target_idx
-Date:          Dec 2022
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters/<F>/matching
-Date:          Dec 2022
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters/<F>/allow
-Date:          Jan 2025
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/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/<S>/filters
-               directory.
-
 What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/filters
+               /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/core_filters
                directory.
 
+What:          /sys/kernel/mm/damon/admin/kdamonds/<K>/contexts/<C>/schemes/<S>/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/<S>/{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/<S>/dests/nr_dests
 Date:          Jul 2025
 Contact:       SeongJae Park <sj@kernel.org>